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

main
ts 294 lines 9.82 KB
Raw
1 import * as cci from "@distilled.cloud/gcp/contactcenterinsights_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 * as Stream from "effect/Stream";
9 import { GcpEnvironment } from "../Environment.ts";
10 import { createInternalLabels } from "../Labels.ts";
11 import type { Providers } from "../Providers.ts";
12 import {
13 encodeOwnershipLine,
14 hasOwnershipMarker,
15 jsonEqual,
16 lastSegment,
17 locationOf,
18 locationParent,
19 ownedByAlchemy,
20 parentOf,
21 parseOwnership,
22 sameText,
23 toResourceId,
24 updateMaskOf,
25 } from "./ownership.ts";
26
27 export type QaAnswerLabel = {
28 /** Matches `QaQuestion.AnswerChoice.key`. */
29 key?: string;
30 /** String answer. */
31 strValue?: string;
32 /** Numeric answer. */
33 numValue?: number;
34 /** Boolean answer. */
35 boolValue?: boolean;
36 /** Not-applicable answer. Should only be `true`. */
37 naValue?: boolean;
38 /** Skip this question. Should only be `true`. */
39 skipValue?: boolean;
40 };
41
42 export type AuthorizedViewSetsAuthorizedViewsConversationsFeedbackLabelProps = {
43 /**
44 * Parent conversation under an AuthorizedView
45 * (`{authorizedView}/conversations/{conversation}`). Immutable —
46 * changing it replaces the label.
47 */
48 parent: string;
49 /**
50 * Feedback label id (the `{feedback_label}` segment). If omitted, a
51 * unique id is generated. Immutable — changing it replaces the label.
52 */
53 feedbackLabelId?: string;
54 /**
55 * String label used for topic modeling. Feedback labels have no labels
56 * map, so Alchemy ownership is stored in a `[alchemy …]` prefix and
57 * stripped from attributes.
58 */
59 label?: string;
60 /**
61 * Resource being labeled (QA question, issue model, or generator).
62 */
63 labeledResource?: string;
64 /**
65 * QA answer label used for Quality AI example conversations.
66 */
67 qaAnswerLabel?: QaAnswerLabel;
68 };
69
70 export type AuthorizedViewSetsAuthorizedViewsConversationsFeedbackLabel = Resource<
71 "GCP.ContactCenterInsights.AuthorizedViewSetsAuthorizedViewsConversationsFeedbackLabel",
72 AuthorizedViewSetsAuthorizedViewsConversationsFeedbackLabelProps,
73 {
74 /** Full resource name. */
75 name: string;
76 /** Feedback label id (last path segment). */
77 feedbackLabelId: string;
78 /** Parent conversation under the AuthorizedView. */
79 parent: string;
80 /** Location id. */
81 location: string;
82 /** Project id. */
83 project: string;
84 /** User label with the Alchemy ownership prefix stripped. */
85 label: string | undefined;
86 /** Labeled resource name. */
87 labeledResource: string | undefined;
88 /** QA answer label. */
89 qaAnswerLabel: QaAnswerLabel | undefined;
90 /** RFC3339 creation timestamp. */
91 createTime: string | undefined;
92 /** RFC3339 last-update timestamp. */
93 updateTime: string | undefined;
94 },
95 never,
96 Providers
97 >;
98
99 /**
100 * A Contact Center AI Insights feedback label on a conversation, created
101 * through an AuthorizedView.
102 *
103 * Feedback labels have no labels map — Alchemy stamps ownership into the
104 * string `label`. Parent conversation and id are immutable. Label text,
105 * labeled resource, and QA answer update in place.
106 *
107 * ### Creating a Feedback Label
108 * **Example:** Topic-modeling label
109 * ```typescript
110 * const feedback =
111 * yield* GCP.ContactCenterInsights.AuthorizedViewSetsAuthorizedViewsConversationsFeedbackLabel(
112 * "Topic",
113 * {
114 * parent: `${view.name}/conversations/${conversation.conversationId}`,
115 * label: "billing",
116 * },
117 * );
118 * ```
119 *
120 * @resource
121 * @category ContactCenterInsights
122 */
123 export const AuthorizedViewSetsAuthorizedViewsConversationsFeedbackLabel =
124 Resource<AuthorizedViewSetsAuthorizedViewsConversationsFeedbackLabel>(
125 "GCP.ContactCenterInsights.AuthorizedViewSetsAuthorizedViewsConversationsFeedbackLabel",
126 );
127
128 export class AuthorizedViewSetsAuthorizedViewsConversationsFeedbackLabelNotResolved extends Data.TaggedError(
129 "GCP.ContactCenterInsights.AuthorizedViewSetsAuthorizedViewsConversationsFeedbackLabelNotResolved",
130 )<{
131 resourceName: string;
132 }> {}
133
134 const qaOf = (
135 value: cci.GoogleCloudContactcenterinsightsV1QaAnswerAnswerValue | undefined,
136 ): QaAnswerLabel | undefined => {
137 if (value === undefined) return undefined;
138 return {
139 key: value.key,
140 strValue: value.strValue,
141 numValue: value.numValue,
142 boolValue: value.boolValue,
143 naValue: value.naValue,
144 skipValue: value.skipValue,
145 };
146 };
147
148 const toAttrs = (label: cci.GoogleCloudContactcenterinsightsV1FeedbackLabel, project: string) => {
149 const name = label.name ?? "";
150 const parsed = parseOwnership(label.label);
151 return {
152 name,
153 feedbackLabelId: lastSegment(name),
154 parent: parentOf(name),
155 location: locationOf(name),
156 project,
157 label: parsed.text,
158 labeledResource: label.labeledResource,
159 qaAnswerLabel: qaOf(label.qaAnswerLabel),
160 createTime: label.createTime,
161 updateTime: label.updateTime,
162 };
163 };
164
165 const getByName = (name: string) =>
166 name.length === 0
167 ? Effect.undefined
168 : cci
169 .getProjectsLocationsAuthorizedViewSetsAuthorizedViewsConversationsFeedbackLabels({ name })
170 .pipe(Effect.catchTag("NotFound", () => Effect.undefined));
171
172 const listAllAt = (parent: string, project: string) =>
173 cci.listAllFeedbackLabelsProjectsLocations.pages({ parent, pageSize: 100 }).pipe(
174 Stream.flatMap((page) => Stream.fromIterable(page.feedbackLabels ?? [])),
175 Stream.filter((label) => hasOwnershipMarker(label.label)),
176 Stream.map((label) => toAttrs(label, project)),
177 Stream.runCollect,
178 Effect.map((chunk) => Array.from(chunk)),
179 Effect.catchTag("NotFound", () => Effect.succeed([])),
180 );
181
182 export const AuthorizedViewSetsAuthorizedViewsConversationsFeedbackLabelProvider = () =>
183 Provider.succeed(AuthorizedViewSetsAuthorizedViewsConversationsFeedbackLabel, {
184 stables: ["name", "feedbackLabelId", "parent", "location", "project", "createTime"],
185
186 diff: Effect.fn(function* ({ news, olds, output }) {
187 if (!isResolved(news)) return undefined;
188 const previousParent = olds?.parent ?? output?.parent;
189 if (previousParent !== undefined && news.parent !== previousParent) {
190 return { action: "replace" as const, deleteFirst: false };
191 }
192 const previousId = olds?.feedbackLabelId ?? output?.feedbackLabelId;
193 if (
194 previousId !== undefined &&
195 news.feedbackLabelId !== undefined &&
196 news.feedbackLabelId !== previousId
197 ) {
198 return { action: "replace" as const, deleteFirst: false };
199 }
200 return undefined;
201 }),
202
203 read: Effect.fn(function* ({ id, olds, output }) {
204 const env = yield* GcpEnvironment.current;
205 const feedbackLabelId = yield* toResourceId(
206 id,
207 olds?.feedbackLabelId,
208 output?.feedbackLabelId,
209 );
210 const name =
211 output?.name ??
212 (olds?.parent !== undefined ? `${olds.parent}/feedbackLabels/${feedbackLabelId}` : "");
213 const existing = yield* getByName(name);
214 if (existing === undefined) return undefined;
215 const attrs = toAttrs(existing, env.project);
216 return (yield* ownedByAlchemy(id, existing.label)) ? attrs : Unowned(attrs);
217 }),
218
219 list: () =>
220 Effect.gen(function* () {
221 const env = yield* GcpEnvironment.current;
222 return yield* listAllAt(locationParent(env.project, env.region), env.project);
223 }),
224
225 reconcile: Effect.fn(function* ({ id, news, output }) {
226 const env = yield* GcpEnvironment.current;
227 const feedbackLabelId = yield* toResourceId(
228 id,
229 news.feedbackLabelId,
230 output?.feedbackLabelId,
231 );
232 const name = `${news.parent}/feedbackLabels/${feedbackLabelId}`;
233 const ownership = yield* createInternalLabels(id);
234 const label = encodeOwnershipLine(ownership, news.label);
235
236 let current = yield* getByName(output?.name ?? name);
237
238 if (current === undefined) {
239 const created = yield* cci
240 .createProjectsLocationsAuthorizedViewSetsAuthorizedViewsConversationsFeedbackLabels({
241 parent: news.parent,
242 feedbackLabelId,
243 body: {
244 label,
245 labeledResource: news.labeledResource,
246 qaAnswerLabel: news.qaAnswerLabel,
247 },
248 })
249 .pipe(Effect.catchTag("Conflict", () => getByName(name)));
250 current = created ?? undefined;
251 }
252
253 if (current === undefined) {
254 return yield* new AuthorizedViewSetsAuthorizedViewsConversationsFeedbackLabelNotResolved({
255 resourceName: name,
256 });
257 }
258
259 const currentName = current.name ?? name;
260 const labelChanged = (current.label ?? "") !== label;
261 const resourceChanged = !sameText(current.labeledResource, news.labeledResource);
262 const qaChanged = !jsonEqual(qaOf(current.qaAnswerLabel), news.qaAnswerLabel);
263
264 if (labelChanged || resourceChanged || qaChanged) {
265 current =
266 yield* cci.patchProjectsLocationsAuthorizedViewSetsAuthorizedViewsConversationsFeedbackLabels(
267 {
268 name: currentName,
269 updateMask: updateMaskOf(
270 labelChanged ? "label" : undefined,
271 resourceChanged ? "labeled_resource" : undefined,
272 qaChanged ? "qa_answer_label" : undefined,
273 ),
274 body: {
275 name: currentName,
276 label,
277 labeledResource: news.labeledResource,
278 qaAnswerLabel: news.qaAnswerLabel,
279 },
280 },
281 );
282 }
283
284 return toAttrs(current, env.project);
285 }),
286
287 delete: Effect.fn(function* ({ output }) {
288 yield* cci
289 .deleteProjectsLocationsAuthorizedViewSetsAuthorizedViewsConversationsFeedbackLabels({
290 name: output.name,
291 })
292 .pipe(Effect.catchTag("NotFound", () => Effect.void));
293 }),
294 });