The best way to control Claude Code, Codex and more from any computer or phone

main
ts 265 lines 8.6 KB
Raw
1 import * as discoveryengine from "@distilled.cloud/gcp/discoveryengine_v1";
2 import { Unowned } from "alchemy/AdoptPolicy";
3 import { isResolved } from "alchemy/Diff";
4 import * as Provider from "alchemy/Provider";
5 import { Resource } from "alchemy/Resource";
6 import * as Data from "effect/Data";
7 import * as Effect from "effect/Effect";
8 import { GcpEnvironment } from "../Environment.ts";
9 import type { Providers } from "../Providers.ts";
10 import { parentBefore, parseResourceName, sameStringList, toResourceId } from "./internal.ts";
11
12 export type CollectionsEnginesSessionProps = {
13 /**
14 * Parent Engine resource name
15 * `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}`.
16 * Immutable — changing it replaces the session.
17 */
18 engine: string;
19 /**
20 * Session id. If omitted, a unique id is generated. Immutable —
21 * changing it replaces the session.
22 */
23 sessionId?: string;
24 /**
25 * User-facing display name.
26 */
27 displayName?: string;
28 /**
29 * User tracking id.
30 */
31 userPseudoId?: string;
32 /**
33 * Session state.
34 */
35 state?: discoveryengine.GoogleCloudDiscoveryengineV1SessionStateEnum;
36 /**
37 * Pin the session to the top of the session list.
38 * @default false
39 */
40 isPinned?: boolean;
41 /**
42 * Free-form session labels.
43 */
44 labels?: string[];
45 };
46
47 export type CollectionsEnginesSession = Resource<
48 "GCP.DiscoveryEngine.CollectionsEnginesSession",
49 CollectionsEnginesSessionProps,
50 {
51 /** Full resource name. */
52 name: string;
53 /** Session id (last path segment). */
54 sessionId: string;
55 /** Parent engine resource name. */
56 engine: string;
57 /** Project id. */
58 project: string;
59 /** Location id. */
60 location: string;
61 /** Collection id. */
62 collectionId: string;
63 /** Display name. */
64 displayName: string | undefined;
65 /** User tracking id. */
66 userPseudoId: string | undefined;
67 /** Session state. */
68 state: string | undefined;
69 /** Whether the session is pinned. */
70 isPinned: boolean;
71 /** Labels. */
72 labels: string[];
73 /** RFC3339 start timestamp. */
74 startTime: string | undefined;
75 /** RFC3339 end timestamp. */
76 endTime: string | undefined;
77 },
78 never,
79 Providers
80 >;
81
82 /**
83 * A Discovery Engine Session on a collection Engine.
84 *
85 * Without labels, ownership rests on the deterministic id: `read` reports a
86 * resource it finds without prior state as unowned (adopt it with `--adopt`).
87 * Parent engine and session id are immutable; display name, pin, and labels
88 * update in place.
89 *
90 * ### Creating a Session
91 * **Example:** Named session
92 * ```typescript
93 * const session = yield* GCP.DiscoveryEngine.CollectionsEnginesSession(
94 * "Chat",
95 * {
96 * engine: engine.name,
97 * displayName: "support",
98 * },
99 * );
100 * ```
101 *
102 * ### Updating a Session
103 * **Example:** Pin and rename
104 * ```typescript
105 * // Same logical id as before; only the changed props differ.
106 * const session = yield* GCP.DiscoveryEngine.CollectionsEnginesSession(
107 * "Chat",
108 * {
109 * engine: engine.name,
110 * displayName: "support-prod",
111 * isPinned: true,
112 * },
113 * );
114 * ```
115 *
116 * @resource
117 * @category DiscoveryEngine
118 */
119 export const CollectionsEnginesSession = Resource<CollectionsEnginesSession>(
120 "GCP.DiscoveryEngine.CollectionsEnginesSession",
121 );
122
123 export class CollectionsEnginesSessionNotResolved extends Data.TaggedError(
124 "GCP.DiscoveryEngine.CollectionsEnginesSessionNotResolved",
125 )<{
126 resourceName: string;
127 }> {}
128
129 const resourceName = (engine: string, sessionId: string) => `${engine}/sessions/${sessionId}`;
130
131 const getByName = (name: string) =>
132 discoveryengine
133 .getProjectsLocationsCollectionsEnginesSessions({ name })
134 .pipe(Effect.catchTag("NotFound", () => Effect.undefined));
135
136 const userLabels = (labels: readonly string[] | undefined) => [...(labels ?? [])];
137
138 const toAttrs = (session: discoveryengine.GoogleCloudDiscoveryengineV1Session, project: string) => {
139 const name = session.name ?? "";
140 const parsed = parseResourceName(name, "sessions");
141 return {
142 name,
143 sessionId: parsed.id,
144 engine: parentBefore(name, "sessions"),
145 project: parsed.project || project,
146 location: parsed.location,
147 collectionId: parsed.collectionId,
148 displayName: session.displayName,
149 userPseudoId: session.userPseudoId,
150 state: session.state,
151 isPinned: session.isPinned === true,
152 labels: userLabels(session.labels),
153 startTime: session.startTime,
154 endTime: session.endTime,
155 };
156 };
157
158 export const CollectionsEnginesSessionProvider = () =>
159 Provider.succeed(CollectionsEnginesSession, {
160 stables: ["name", "sessionId", "engine", "project", "location", "collectionId", "startTime"],
161
162 diff: Effect.fn(function* ({ news, olds, output }) {
163 if (!isResolved(news)) return undefined;
164 const previousEngine = olds?.engine ?? output?.engine;
165 const previousId = olds?.sessionId ?? output?.sessionId;
166 const nextId = news.sessionId ?? previousId;
167 if (
168 (previousEngine !== undefined && news.engine !== previousEngine) ||
169 (previousId !== undefined && nextId !== undefined && nextId !== previousId)
170 ) {
171 return { action: "replace" as const, deleteFirst: false };
172 }
173 return undefined;
174 }),
175
176 read: Effect.fn(function* ({ id, olds, output }) {
177 const env = yield* GcpEnvironment.current;
178 const parent = olds?.engine ?? output?.engine;
179 const childId = yield* toResourceId(id, olds?.sessionId, output?.sessionId);
180 const name =
181 output?.name ?? (parent !== undefined ? resourceName(parent, childId) : undefined);
182 if (name === undefined) return undefined;
183 const existing = yield* getByName(name);
184 if (existing === undefined) return undefined;
185 const attrs = toAttrs(existing, env.project);
186 // No labels field: without prior state it may not be ours.
187 return output !== undefined ? attrs : Unowned(attrs);
188 }),
189
190 reconcile: Effect.fn(function* ({ id, news, output }) {
191 const env = yield* GcpEnvironment.current;
192 const sessionId = yield* toResourceId(id, news.sessionId, output?.sessionId);
193 const displayName = news.displayName;
194 const isPinned = news.isPinned === true;
195 const labels = news.labels;
196 const fallbackName = output?.name ?? resourceName(news.engine, sessionId);
197
198 let current = yield* getByName(fallbackName);
199
200 if (current === undefined) {
201 const created = yield* discoveryengine
202 .createProjectsLocationsCollectionsEnginesSessions({
203 parent: news.engine,
204 sessionId,
205 body: {
206 displayName,
207 userPseudoId: news.userPseudoId,
208 state: news.state,
209 isPinned: isPinned ? true : undefined,
210 labels,
211 },
212 })
213 .pipe(Effect.catchTag("Conflict", () => getByName(fallbackName)));
214 current = created ?? undefined;
215 }
216
217 if (current === undefined) {
218 return yield* new CollectionsEnginesSessionNotResolved({
219 resourceName: fallbackName,
220 });
221 }
222
223 const name = current.name ?? fallbackName;
224 const displayNameChanged = (current.displayName ?? "") !== (displayName ?? "");
225 const userChanged = (current.userPseudoId ?? "") !== (news.userPseudoId ?? "");
226 const stateChanged = (current.state ?? "") !== (news.state ?? "");
227 const pinnedChanged = (current.isPinned === true) !== isPinned;
228 const labelsChanged = !sameStringList(userLabels(current.labels), labels);
229
230 if (displayNameChanged || userChanged || stateChanged || pinnedChanged || labelsChanged) {
231 current = yield* discoveryengine.patchProjectsLocationsCollectionsEnginesSessions({
232 name,
233 updateMask: [
234 displayNameChanged ? "display_name" : undefined,
235 userChanged ? "user_pseudo_id" : undefined,
236 stateChanged ? "state" : undefined,
237 pinnedChanged ? "is_pinned" : undefined,
238 labelsChanged ? "labels" : undefined,
239 ]
240 .filter((field): field is string => field !== undefined)
241 .join(","),
242 body: {
243 name,
244 displayName,
245 userPseudoId: news.userPseudoId,
246 state: news.state,
247 isPinned,
248 labels,
249 },
250 });
251 }
252
253 return toAttrs(current, env.project);
254 }),
255
256 delete: Effect.fn(function* ({ output }) {
257 const existing = yield* getByName(output.name);
258 if (existing === undefined) return;
259 yield* discoveryengine
260 .deleteProjectsLocationsCollectionsEnginesSessions({
261 name: output.name,
262 })
263 .pipe(Effect.catchTag("NotFound", () => Effect.void));
264 }),
265 });