managed-deepagents 0.0.3-dev.46 → 0.0.3-dev.48
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/connectors/langsmith.d.ts +255 -4
- package/dist/connectors/langsmith.d.ts.map +1 -1
- package/dist/connectors/langsmith.js +167 -4
- package/dist/connectors/langsmith.js.map +1 -1
- package/dist/identity/index.d.ts +88 -0
- package/dist/identity/index.d.ts.map +1 -0
- package/dist/{identity.js → identity/index.js} +6 -125
- package/dist/identity/index.js.map +1 -0
- package/dist/identity/supabase.d.ts +48 -0
- package/dist/identity/supabase.d.ts.map +1 -0
- package/dist/identity/supabase.js +139 -0
- package/dist/identity/supabase.js.map +1 -0
- package/dist/{identity.d.ts → identity/types.d.ts} +4 -111
- package/dist/identity/types.d.ts.map +1 -0
- package/dist/identity/types.js +8 -0
- package/dist/identity/types.js.map +1 -0
- package/dist/index.d.ts +2 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/dist/runtime/auth.d.ts +1 -1
- package/dist/runtime/auth.d.ts.map +1 -1
- package/dist/runtime/connector.d.ts +1 -1
- package/dist/runtime/connector.d.ts.map +1 -1
- package/dist/runtime/credentials.d.ts +1 -1
- package/dist/runtime/credentials.d.ts.map +1 -1
- package/dist/runtime/identity-http.d.ts +1 -1
- package/dist/runtime/identity-http.d.ts.map +1 -1
- package/dist/runtime/identity-runtime.d.ts +1 -1
- package/dist/runtime/identity-runtime.d.ts.map +1 -1
- package/dist/runtime/index.d.ts.map +1 -1
- package/dist/runtime/index.js +41 -67
- package/dist/runtime/index.js.map +1 -1
- package/dist/runtime/langsmith-connector.d.ts +124 -12
- package/dist/runtime/langsmith-connector.d.ts.map +1 -1
- package/dist/runtime/langsmith-connector.js +497 -41
- package/dist/runtime/langsmith-connector.js.map +1 -1
- package/dist/runtime/managed-middleware.d.ts +1 -1
- package/dist/runtime/managed-middleware.d.ts.map +1 -1
- package/dist/runtime/managed-tools.d.ts +1 -1
- package/dist/runtime/managed-tools.d.ts.map +1 -1
- package/dist/runtime/sandbox-manager.d.ts +3 -2
- package/dist/runtime/sandbox-manager.d.ts.map +1 -1
- package/dist/runtime/sandbox-manager.js.map +1 -1
- package/dist/runtime/setup-script.d.ts +4 -7
- package/dist/runtime/setup-script.d.ts.map +1 -1
- package/dist/runtime/setup-script.js.map +1 -1
- package/dist/runtime/types.d.ts +1 -15
- package/dist/runtime/types.d.ts.map +1 -1
- package/dist/runtime/validated-token.d.ts +20 -3
- package/dist/runtime/validated-token.d.ts.map +1 -1
- package/dist/runtime/validated-token.js +71 -20
- package/dist/runtime/validated-token.js.map +1 -1
- package/dist/types.d.ts +1 -1
- package/dist/types.d.ts.map +1 -1
- package/package.json +7 -7
- package/dist/identity.d.ts.map +0 -1
- package/dist/identity.js.map +0 -1
|
@@ -41,78 +41,329 @@ export interface LangSmithCapability {
|
|
|
41
41
|
export interface LangSmithConnectorConfig {
|
|
42
42
|
capabilities: LangSmithCapability[];
|
|
43
43
|
}
|
|
44
|
+
/**
|
|
45
|
+
* Options for a {@link runs} capability grant.
|
|
46
|
+
*
|
|
47
|
+
* Default response shaping (when `include` / `redact` are omitted):
|
|
48
|
+
* include `id`, `status`, `start_time`, `end_time`, `url`, `metadata`;
|
|
49
|
+
* redact `inputs`, `outputs`, `events`.
|
|
50
|
+
*/
|
|
44
51
|
export interface RunsCapabilityOptions {
|
|
52
|
+
/** Stable capability id used in `POST .../capabilities/{id}`. */
|
|
45
53
|
id: string;
|
|
54
|
+
/** Caller surfaces allowed to invoke this grant. */
|
|
46
55
|
exposeTo: LangSmithCallerSurface[];
|
|
56
|
+
/** Allowed run operations. */
|
|
47
57
|
actions: Array<"read" | "share">;
|
|
58
|
+
/** Ownership boundary proven from `runtime.identity` before the call. */
|
|
48
59
|
scope: LangSmithCapabilityScope;
|
|
60
|
+
/** Response field allowlist (defaults to the browser-safe runs profile). */
|
|
49
61
|
include?: string[];
|
|
62
|
+
/** Fields stripped even if listed in `include` (defaults to sensitive runs fields). */
|
|
50
63
|
redact?: string[];
|
|
64
|
+
/**
|
|
65
|
+
* Explicit opt-in required to include sensitive run fields (`inputs`,
|
|
66
|
+
* `outputs`, `events`) when `exposeTo` includes `browser`.
|
|
67
|
+
*/
|
|
51
68
|
allowSensitive?: string[];
|
|
52
69
|
}
|
|
70
|
+
/**
|
|
71
|
+
* Build a `runs` capability grant (`read` / `share`).
|
|
72
|
+
*
|
|
73
|
+
* Use for redacted trace summaries and share links. Prefer {@link traceViewer}
|
|
74
|
+
* when the default browser surface is enough.
|
|
75
|
+
*
|
|
76
|
+
* @param options - Grant id, surfaces, actions, scope, and optional response shaping.
|
|
77
|
+
* @returns A compiled {@link LangSmithCapability} for the `runs` resource.
|
|
78
|
+
*
|
|
79
|
+
* @example
|
|
80
|
+
* ```ts
|
|
81
|
+
* langsmith.runs({
|
|
82
|
+
* id: "app:run-summary",
|
|
83
|
+
* exposeTo: ["browser"],
|
|
84
|
+
* actions: ["read", "share"],
|
|
85
|
+
* scope: "thread",
|
|
86
|
+
* })
|
|
87
|
+
* ```
|
|
88
|
+
*/
|
|
53
89
|
export declare function runs(options: RunsCapabilityOptions): LangSmithCapability;
|
|
90
|
+
/**
|
|
91
|
+
* Options for a {@link feedback} capability grant.
|
|
92
|
+
*
|
|
93
|
+
* Default response include (when omitted): `id`, `run_id`, `key`, `score`,
|
|
94
|
+
* `created_at`. Default scope: `run`.
|
|
95
|
+
*/
|
|
54
96
|
export interface FeedbackCapabilityOptions {
|
|
97
|
+
/** Stable capability id used in `POST .../capabilities/{id}`. */
|
|
55
98
|
id: string;
|
|
99
|
+
/** Caller surfaces allowed to invoke this grant. */
|
|
56
100
|
exposeTo: LangSmithCallerSurface[];
|
|
101
|
+
/** Allowed feedback operations. */
|
|
57
102
|
actions: Array<"create" | "update" | "delete">;
|
|
103
|
+
/** Ownership boundary; defaults to `run`. */
|
|
58
104
|
scope?: LangSmithCapabilityScope;
|
|
105
|
+
/** Allowlisted feedback keys (e.g. `user_score`). Required. */
|
|
59
106
|
keys: string[];
|
|
107
|
+
/** Allowlisted score/value labels when feedback is categorical. */
|
|
60
108
|
scores?: string[];
|
|
109
|
+
/** Maximum comment length in characters. */
|
|
61
110
|
maxCommentChars?: number;
|
|
111
|
+
/** When true, each actor may submit at most one feedback row per run. */
|
|
62
112
|
onePerActor?: boolean;
|
|
113
|
+
/** Response field allowlist (defaults to the browser-safe feedback profile). */
|
|
63
114
|
include?: string[];
|
|
64
115
|
}
|
|
116
|
+
/**
|
|
117
|
+
* Build a `feedback` capability grant (`create` / `update` / `delete`).
|
|
118
|
+
*
|
|
119
|
+
* Constrains keys, optional categorical scores, comment length, and
|
|
120
|
+
* per-actor uniqueness. Prefer {@link chatFeedback} for the common browser
|
|
121
|
+
* thumbs-up/down + dataset capture surface.
|
|
122
|
+
*
|
|
123
|
+
* @param options - Grant id, surfaces, actions, key/score constraints, and shaping.
|
|
124
|
+
* @returns A compiled {@link LangSmithCapability} for the `feedback` resource.
|
|
125
|
+
*
|
|
126
|
+
* @example
|
|
127
|
+
* ```ts
|
|
128
|
+
* langsmith.feedback({
|
|
129
|
+
* id: "app:user-score",
|
|
130
|
+
* exposeTo: ["browser"],
|
|
131
|
+
* actions: ["create", "update", "delete"],
|
|
132
|
+
* scope: "run",
|
|
133
|
+
* keys: ["user_score"],
|
|
134
|
+
* scores: ["positive", "negative"],
|
|
135
|
+
* onePerActor: true,
|
|
136
|
+
* })
|
|
137
|
+
* ```
|
|
138
|
+
*/
|
|
65
139
|
export declare function feedback(options: FeedbackCapabilityOptions): LangSmithCapability;
|
|
140
|
+
/**
|
|
141
|
+
* Options for an {@link examples} capability grant.
|
|
142
|
+
*
|
|
143
|
+
* Default response include (when omitted): `id`, `dataset_id`, `created_at`.
|
|
144
|
+
* Default scope: `thread`.
|
|
145
|
+
*/
|
|
66
146
|
export interface ExamplesCapabilityOptions {
|
|
147
|
+
/** Stable capability id used in `POST .../capabilities/{id}`. */
|
|
67
148
|
id: string;
|
|
149
|
+
/** Caller surfaces allowed to invoke this grant. */
|
|
68
150
|
exposeTo: LangSmithCallerSurface[];
|
|
151
|
+
/** Allowed example operations (currently `create` only). */
|
|
69
152
|
actions: Array<"create">;
|
|
153
|
+
/** Ownership boundary; defaults to `thread`. */
|
|
70
154
|
scope?: LangSmithCapabilityScope;
|
|
155
|
+
/** Target LangSmith dataset name (server-side; not chosen by the client). */
|
|
71
156
|
dataset: string;
|
|
157
|
+
/** Allowlisted top-level fields the client may send on create. */
|
|
72
158
|
allowedFields?: string[];
|
|
159
|
+
/** Cap on examples created per thread for this grant. */
|
|
73
160
|
maxExamplesPerThread?: number;
|
|
161
|
+
/** Response field allowlist (defaults to the browser-safe examples profile). */
|
|
74
162
|
include?: string[];
|
|
75
163
|
}
|
|
164
|
+
/**
|
|
165
|
+
* Build an `examples` capability grant (`create` into a fixed dataset).
|
|
166
|
+
*
|
|
167
|
+
* The dataset name is fixed in the grant so callers cannot write to arbitrary
|
|
168
|
+
* datasets. Prefer {@link chatFeedback} when pairing with run feedback.
|
|
169
|
+
*
|
|
170
|
+
* @param options - Grant id, surfaces, dataset, and optional field/thread caps.
|
|
171
|
+
* @returns A compiled {@link LangSmithCapability} for the `examples` resource.
|
|
172
|
+
*
|
|
173
|
+
* @example
|
|
174
|
+
* ```ts
|
|
175
|
+
* langsmith.examples({
|
|
176
|
+
* id: "app:capture-thread",
|
|
177
|
+
* exposeTo: ["browser"],
|
|
178
|
+
* actions: ["create"],
|
|
179
|
+
* scope: "thread",
|
|
180
|
+
* dataset: "public-feedback",
|
|
181
|
+
* allowedFields: ["messages", "answer", "feedback", "source"],
|
|
182
|
+
* })
|
|
183
|
+
* ```
|
|
184
|
+
*/
|
|
76
185
|
export declare function examples(options: ExamplesCapabilityOptions): LangSmithCapability;
|
|
186
|
+
/**
|
|
187
|
+
* Options for an {@link annotationQueues} capability grant.
|
|
188
|
+
*
|
|
189
|
+
* Enqueue is a write with no readable body; the response include is fixed to
|
|
190
|
+
* `["id"]`. Default scope: `run`.
|
|
191
|
+
*/
|
|
77
192
|
export interface AnnotationQueuesCapabilityOptions {
|
|
193
|
+
/** Stable capability id used in `POST .../capabilities/{id}`. */
|
|
78
194
|
id: string;
|
|
195
|
+
/** Caller surfaces allowed to invoke this grant. */
|
|
79
196
|
exposeTo: LangSmithCallerSurface[];
|
|
197
|
+
/** Allowed queue operations (currently `enqueue_run` only). */
|
|
80
198
|
actions: Array<"enqueue_run">;
|
|
199
|
+
/** Ownership boundary; defaults to `run`. */
|
|
81
200
|
scope?: LangSmithCapabilityScope;
|
|
201
|
+
/** Target annotation queue id/name (server-side; not chosen by the client). */
|
|
82
202
|
queue: string;
|
|
203
|
+
/** Allowlisted priority labels when the client may set priority. */
|
|
83
204
|
allowedPriorities?: string[];
|
|
205
|
+
/** Maximum note length in characters. */
|
|
84
206
|
maxNoteChars?: number;
|
|
85
207
|
}
|
|
208
|
+
/**
|
|
209
|
+
* Build an `annotation_queues` capability grant (`enqueue_run` into a fixed queue).
|
|
210
|
+
*
|
|
211
|
+
* The queue is fixed in the grant so callers cannot enqueue into arbitrary
|
|
212
|
+
* queues.
|
|
213
|
+
*
|
|
214
|
+
* @param options - Grant id, surfaces, queue, and optional priority/note limits.
|
|
215
|
+
* @returns A compiled {@link LangSmithCapability} for the `annotation_queues` resource.
|
|
216
|
+
*
|
|
217
|
+
* @example
|
|
218
|
+
* ```ts
|
|
219
|
+
* langsmith.annotationQueues({
|
|
220
|
+
* id: "app:enqueue-review",
|
|
221
|
+
* exposeTo: ["trusted_backend"],
|
|
222
|
+
* actions: ["enqueue_run"],
|
|
223
|
+
* scope: "run",
|
|
224
|
+
* queue: "human-review",
|
|
225
|
+
* })
|
|
226
|
+
* ```
|
|
227
|
+
*/
|
|
86
228
|
export declare function annotationQueues(options: AnnotationQueuesCapabilityOptions): LangSmithCapability;
|
|
229
|
+
/**
|
|
230
|
+
* Options for a {@link prompts} capability grant.
|
|
231
|
+
*
|
|
232
|
+
* Default response shaping (when omitted): include `name`, `commit_hash`,
|
|
233
|
+
* `updated_at`; redact `content`, `messages`. Default scope: `agent`.
|
|
234
|
+
*/
|
|
87
235
|
export interface PromptsCapabilityOptions {
|
|
236
|
+
/** Stable capability id used in `POST .../capabilities/{id}`. */
|
|
88
237
|
id: string;
|
|
238
|
+
/** Caller surfaces allowed to invoke this grant. */
|
|
89
239
|
exposeTo: LangSmithCallerSurface[];
|
|
240
|
+
/** Allowed prompt operations (currently `read_metadata` only). */
|
|
90
241
|
actions: Array<"read_metadata">;
|
|
242
|
+
/** Ownership boundary; defaults to `agent`. */
|
|
91
243
|
scope?: LangSmithCapabilityScope;
|
|
244
|
+
/** Response field allowlist (defaults to the browser-safe prompts profile). */
|
|
92
245
|
include?: string[];
|
|
246
|
+
/** Fields stripped even if listed in `include` (defaults to prompt content). */
|
|
93
247
|
redact?: string[];
|
|
94
248
|
}
|
|
249
|
+
/**
|
|
250
|
+
* Build a `prompts` capability grant (`read_metadata`).
|
|
251
|
+
*
|
|
252
|
+
* Returns prompt metadata only by default; prompt body fields stay redacted.
|
|
253
|
+
*
|
|
254
|
+
* @param options - Grant id, surfaces, and optional response shaping.
|
|
255
|
+
* @returns A compiled {@link LangSmithCapability} for the `prompts` resource.
|
|
256
|
+
*
|
|
257
|
+
* @example
|
|
258
|
+
* ```ts
|
|
259
|
+
* langsmith.prompts({
|
|
260
|
+
* id: "app:prompt-meta",
|
|
261
|
+
* exposeTo: ["browser"],
|
|
262
|
+
* actions: ["read_metadata"],
|
|
263
|
+
* scope: "agent",
|
|
264
|
+
* })
|
|
265
|
+
* ```
|
|
266
|
+
*/
|
|
95
267
|
export declare function prompts(options: PromptsCapabilityOptions): LangSmithCapability;
|
|
268
|
+
/**
|
|
269
|
+
* Options for a {@link threads} capability grant.
|
|
270
|
+
*
|
|
271
|
+
* Default response shaping (when omitted): include `thread_id`, `created_at`,
|
|
272
|
+
* `metadata.title`; redact `messages`, `values`. Default scope: `actor`.
|
|
273
|
+
*/
|
|
96
274
|
export interface ThreadsCapabilityOptions {
|
|
275
|
+
/** Stable capability id used in `POST .../capabilities/{id}`. */
|
|
97
276
|
id: string;
|
|
277
|
+
/** Caller surfaces allowed to invoke this grant. */
|
|
98
278
|
exposeTo: LangSmithCallerSurface[];
|
|
279
|
+
/** Allowed thread operations. */
|
|
99
280
|
actions: Array<"read" | "update_metadata">;
|
|
281
|
+
/** Ownership boundary; defaults to `actor`. */
|
|
100
282
|
scope?: LangSmithCapabilityScope;
|
|
283
|
+
/** Allowlisted metadata keys the client may read or update. */
|
|
101
284
|
metadataKeys?: string[];
|
|
285
|
+
/** Maximum title length when updating thread metadata. */
|
|
102
286
|
maxTitleChars?: number;
|
|
287
|
+
/** Response field allowlist (defaults to the browser-safe threads profile). */
|
|
103
288
|
include?: string[];
|
|
289
|
+
/**
|
|
290
|
+
* Explicit opt-in required to include sensitive thread fields (`messages`,
|
|
291
|
+
* `values`) when `exposeTo` includes `browser`.
|
|
292
|
+
*/
|
|
104
293
|
allowSensitive?: string[];
|
|
105
294
|
}
|
|
295
|
+
/**
|
|
296
|
+
* Build a `threads` capability grant (`read` / `update_metadata`).
|
|
297
|
+
*
|
|
298
|
+
* Thread message bodies stay redacted unless `allowSensitive` acknowledges
|
|
299
|
+
* them for a browser surface.
|
|
300
|
+
*
|
|
301
|
+
* @param options - Grant id, surfaces, actions, metadata constraints, and shaping.
|
|
302
|
+
* @returns A compiled {@link LangSmithCapability} for the `threads` resource.
|
|
303
|
+
*
|
|
304
|
+
* @example
|
|
305
|
+
* ```ts
|
|
306
|
+
* langsmith.threads({
|
|
307
|
+
* id: "app:thread-title",
|
|
308
|
+
* exposeTo: ["browser"],
|
|
309
|
+
* actions: ["read", "update_metadata"],
|
|
310
|
+
* scope: "actor",
|
|
311
|
+
* metadataKeys: ["title"],
|
|
312
|
+
* maxTitleChars: 120,
|
|
313
|
+
* })
|
|
314
|
+
* ```
|
|
315
|
+
*/
|
|
106
316
|
export declare function threads(options: ThreadsCapabilityOptions): LangSmithCapability;
|
|
107
317
|
/**
|
|
108
|
-
*
|
|
109
|
-
*
|
|
110
|
-
*
|
|
318
|
+
* Browser chat feedback preset: thumbs up/down on a run, plus optional dataset
|
|
319
|
+
* capture of the conversation.
|
|
320
|
+
*
|
|
321
|
+
* Expands to two grants with stable capability ids (safe to hard-code in
|
|
322
|
+
* clients):
|
|
323
|
+
*
|
|
324
|
+
* - `langsmith:chat-feedback` — run-scoped {@link feedback} for browsers.
|
|
325
|
+
* Key `user_score`, scores `positive`/`negative`, comments ≤ 2000 chars,
|
|
326
|
+
* `onePerActor: true`.
|
|
327
|
+
* - `langsmith:chat-feedback-examples` — thread-scoped {@link examples} create
|
|
328
|
+
* into `dataset`, allowing fields `messages`, `answer`, `feedback`, `source`.
|
|
329
|
+
*
|
|
330
|
+
* Pass the returned array (or spread it) into {@link connector}.
|
|
331
|
+
*
|
|
332
|
+
* @param options.dataset - LangSmith dataset name for the examples capability.
|
|
333
|
+
* @returns Capability grants for feedback + example capture.
|
|
334
|
+
*
|
|
335
|
+
* @example
|
|
336
|
+
* ```ts
|
|
337
|
+
* export default langsmith.connector(
|
|
338
|
+
* langsmith.chatFeedback({ dataset: "public-feedback" }),
|
|
339
|
+
* );
|
|
340
|
+
* // POST /connectors/langsmith/capabilities/langsmith:chat-feedback
|
|
341
|
+
* ```
|
|
111
342
|
*/
|
|
112
343
|
export declare function chatFeedback(options: {
|
|
113
344
|
dataset: string;
|
|
114
345
|
}): LangSmithCapability[];
|
|
115
|
-
/**
|
|
346
|
+
/**
|
|
347
|
+
* Browser trace viewer preset: read a redacted run summary and create a share
|
|
348
|
+
* link for the caller's thread.
|
|
349
|
+
*
|
|
350
|
+
* Expands to one grant with a stable capability id:
|
|
351
|
+
*
|
|
352
|
+
* - `langsmith:trace-viewer` — thread-scoped {@link runs} with actions
|
|
353
|
+
* `read` and `share`, exposed to `browser`. Responses include
|
|
354
|
+
* `id` / `status` / `start_time` / `end_time` / `url` / `metadata` and redact
|
|
355
|
+
* `inputs` / `outputs` / `events` by default.
|
|
356
|
+
*
|
|
357
|
+
* Pass the returned array (or spread it) into {@link connector}.
|
|
358
|
+
*
|
|
359
|
+
* @returns Capability grant for redacted run read/share.
|
|
360
|
+
*
|
|
361
|
+
* @example
|
|
362
|
+
* ```ts
|
|
363
|
+
* export default langsmith.connector(langsmith.traceViewer());
|
|
364
|
+
* // POST /connectors/langsmith/capabilities/langsmith:trace-viewer
|
|
365
|
+
* ```
|
|
366
|
+
*/
|
|
116
367
|
export declare function traceViewer(): LangSmithCapability[];
|
|
117
368
|
/**
|
|
118
369
|
* Fail-closed authoring checks that do not require the identity config. The
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"langsmith.d.ts","sourceRoot":"","sources":["../../src/connectors/langsmith.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"langsmith.d.ts","sourceRoot":"","sources":["../../src/connectors/langsmith.ts"],"names":[],"mappings":"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"}
|
|
@@ -41,6 +41,25 @@ const ALLOWED_CONSTRAINT_KEYS = {
|
|
|
41
41
|
function omitUndefined(value) {
|
|
42
42
|
return Object.fromEntries(Object.entries(value).filter(([, v]) => v !== undefined));
|
|
43
43
|
}
|
|
44
|
+
/**
|
|
45
|
+
* Build a `runs` capability grant (`read` / `share`).
|
|
46
|
+
*
|
|
47
|
+
* Use for redacted trace summaries and share links. Prefer {@link traceViewer}
|
|
48
|
+
* when the default browser surface is enough.
|
|
49
|
+
*
|
|
50
|
+
* @param options - Grant id, surfaces, actions, scope, and optional response shaping.
|
|
51
|
+
* @returns A compiled {@link LangSmithCapability} for the `runs` resource.
|
|
52
|
+
*
|
|
53
|
+
* @example
|
|
54
|
+
* ```ts
|
|
55
|
+
* langsmith.runs({
|
|
56
|
+
* id: "app:run-summary",
|
|
57
|
+
* exposeTo: ["browser"],
|
|
58
|
+
* actions: ["read", "share"],
|
|
59
|
+
* scope: "thread",
|
|
60
|
+
* })
|
|
61
|
+
* ```
|
|
62
|
+
*/
|
|
44
63
|
export function runs(options) {
|
|
45
64
|
return {
|
|
46
65
|
id: options.id,
|
|
@@ -57,6 +76,29 @@ export function runs(options) {
|
|
|
57
76
|
: {}),
|
|
58
77
|
};
|
|
59
78
|
}
|
|
79
|
+
/**
|
|
80
|
+
* Build a `feedback` capability grant (`create` / `update` / `delete`).
|
|
81
|
+
*
|
|
82
|
+
* Constrains keys, optional categorical scores, comment length, and
|
|
83
|
+
* per-actor uniqueness. Prefer {@link chatFeedback} for the common browser
|
|
84
|
+
* thumbs-up/down + dataset capture surface.
|
|
85
|
+
*
|
|
86
|
+
* @param options - Grant id, surfaces, actions, key/score constraints, and shaping.
|
|
87
|
+
* @returns A compiled {@link LangSmithCapability} for the `feedback` resource.
|
|
88
|
+
*
|
|
89
|
+
* @example
|
|
90
|
+
* ```ts
|
|
91
|
+
* langsmith.feedback({
|
|
92
|
+
* id: "app:user-score",
|
|
93
|
+
* exposeTo: ["browser"],
|
|
94
|
+
* actions: ["create", "update", "delete"],
|
|
95
|
+
* scope: "run",
|
|
96
|
+
* keys: ["user_score"],
|
|
97
|
+
* scores: ["positive", "negative"],
|
|
98
|
+
* onePerActor: true,
|
|
99
|
+
* })
|
|
100
|
+
* ```
|
|
101
|
+
*/
|
|
60
102
|
export function feedback(options) {
|
|
61
103
|
return {
|
|
62
104
|
id: options.id,
|
|
@@ -73,6 +115,27 @@ export function feedback(options) {
|
|
|
73
115
|
response: { include: options.include ?? DEFAULT_INCLUDE.feedback },
|
|
74
116
|
};
|
|
75
117
|
}
|
|
118
|
+
/**
|
|
119
|
+
* Build an `examples` capability grant (`create` into a fixed dataset).
|
|
120
|
+
*
|
|
121
|
+
* The dataset name is fixed in the grant so callers cannot write to arbitrary
|
|
122
|
+
* datasets. Prefer {@link chatFeedback} when pairing with run feedback.
|
|
123
|
+
*
|
|
124
|
+
* @param options - Grant id, surfaces, dataset, and optional field/thread caps.
|
|
125
|
+
* @returns A compiled {@link LangSmithCapability} for the `examples` resource.
|
|
126
|
+
*
|
|
127
|
+
* @example
|
|
128
|
+
* ```ts
|
|
129
|
+
* langsmith.examples({
|
|
130
|
+
* id: "app:capture-thread",
|
|
131
|
+
* exposeTo: ["browser"],
|
|
132
|
+
* actions: ["create"],
|
|
133
|
+
* scope: "thread",
|
|
134
|
+
* dataset: "public-feedback",
|
|
135
|
+
* allowedFields: ["messages", "answer", "feedback", "source"],
|
|
136
|
+
* })
|
|
137
|
+
* ```
|
|
138
|
+
*/
|
|
76
139
|
export function examples(options) {
|
|
77
140
|
return {
|
|
78
141
|
id: options.id,
|
|
@@ -88,6 +151,26 @@ export function examples(options) {
|
|
|
88
151
|
response: { include: options.include ?? DEFAULT_INCLUDE.examples },
|
|
89
152
|
};
|
|
90
153
|
}
|
|
154
|
+
/**
|
|
155
|
+
* Build an `annotation_queues` capability grant (`enqueue_run` into a fixed queue).
|
|
156
|
+
*
|
|
157
|
+
* The queue is fixed in the grant so callers cannot enqueue into arbitrary
|
|
158
|
+
* queues.
|
|
159
|
+
*
|
|
160
|
+
* @param options - Grant id, surfaces, queue, and optional priority/note limits.
|
|
161
|
+
* @returns A compiled {@link LangSmithCapability} for the `annotation_queues` resource.
|
|
162
|
+
*
|
|
163
|
+
* @example
|
|
164
|
+
* ```ts
|
|
165
|
+
* langsmith.annotationQueues({
|
|
166
|
+
* id: "app:enqueue-review",
|
|
167
|
+
* exposeTo: ["trusted_backend"],
|
|
168
|
+
* actions: ["enqueue_run"],
|
|
169
|
+
* scope: "run",
|
|
170
|
+
* queue: "human-review",
|
|
171
|
+
* })
|
|
172
|
+
* ```
|
|
173
|
+
*/
|
|
91
174
|
export function annotationQueues(options) {
|
|
92
175
|
return {
|
|
93
176
|
id: options.id,
|
|
@@ -104,6 +187,24 @@ export function annotationQueues(options) {
|
|
|
104
187
|
response: { include: ["id"] },
|
|
105
188
|
};
|
|
106
189
|
}
|
|
190
|
+
/**
|
|
191
|
+
* Build a `prompts` capability grant (`read_metadata`).
|
|
192
|
+
*
|
|
193
|
+
* Returns prompt metadata only by default; prompt body fields stay redacted.
|
|
194
|
+
*
|
|
195
|
+
* @param options - Grant id, surfaces, and optional response shaping.
|
|
196
|
+
* @returns A compiled {@link LangSmithCapability} for the `prompts` resource.
|
|
197
|
+
*
|
|
198
|
+
* @example
|
|
199
|
+
* ```ts
|
|
200
|
+
* langsmith.prompts({
|
|
201
|
+
* id: "app:prompt-meta",
|
|
202
|
+
* exposeTo: ["browser"],
|
|
203
|
+
* actions: ["read_metadata"],
|
|
204
|
+
* scope: "agent",
|
|
205
|
+
* })
|
|
206
|
+
* ```
|
|
207
|
+
*/
|
|
107
208
|
export function prompts(options) {
|
|
108
209
|
return {
|
|
109
210
|
id: options.id,
|
|
@@ -117,6 +218,27 @@ export function prompts(options) {
|
|
|
117
218
|
},
|
|
118
219
|
};
|
|
119
220
|
}
|
|
221
|
+
/**
|
|
222
|
+
* Build a `threads` capability grant (`read` / `update_metadata`).
|
|
223
|
+
*
|
|
224
|
+
* Thread message bodies stay redacted unless `allowSensitive` acknowledges
|
|
225
|
+
* them for a browser surface.
|
|
226
|
+
*
|
|
227
|
+
* @param options - Grant id, surfaces, actions, metadata constraints, and shaping.
|
|
228
|
+
* @returns A compiled {@link LangSmithCapability} for the `threads` resource.
|
|
229
|
+
*
|
|
230
|
+
* @example
|
|
231
|
+
* ```ts
|
|
232
|
+
* langsmith.threads({
|
|
233
|
+
* id: "app:thread-title",
|
|
234
|
+
* exposeTo: ["browser"],
|
|
235
|
+
* actions: ["read", "update_metadata"],
|
|
236
|
+
* scope: "actor",
|
|
237
|
+
* metadataKeys: ["title"],
|
|
238
|
+
* maxTitleChars: 120,
|
|
239
|
+
* })
|
|
240
|
+
* ```
|
|
241
|
+
*/
|
|
120
242
|
export function threads(options) {
|
|
121
243
|
return {
|
|
122
244
|
id: options.id,
|
|
@@ -139,9 +261,30 @@ export function threads(options) {
|
|
|
139
261
|
}
|
|
140
262
|
// --- Presets ---------------------------------------------------------------
|
|
141
263
|
/**
|
|
142
|
-
*
|
|
143
|
-
*
|
|
144
|
-
*
|
|
264
|
+
* Browser chat feedback preset: thumbs up/down on a run, plus optional dataset
|
|
265
|
+
* capture of the conversation.
|
|
266
|
+
*
|
|
267
|
+
* Expands to two grants with stable capability ids (safe to hard-code in
|
|
268
|
+
* clients):
|
|
269
|
+
*
|
|
270
|
+
* - `langsmith:chat-feedback` — run-scoped {@link feedback} for browsers.
|
|
271
|
+
* Key `user_score`, scores `positive`/`negative`, comments ≤ 2000 chars,
|
|
272
|
+
* `onePerActor: true`.
|
|
273
|
+
* - `langsmith:chat-feedback-examples` — thread-scoped {@link examples} create
|
|
274
|
+
* into `dataset`, allowing fields `messages`, `answer`, `feedback`, `source`.
|
|
275
|
+
*
|
|
276
|
+
* Pass the returned array (or spread it) into {@link connector}.
|
|
277
|
+
*
|
|
278
|
+
* @param options.dataset - LangSmith dataset name for the examples capability.
|
|
279
|
+
* @returns Capability grants for feedback + example capture.
|
|
280
|
+
*
|
|
281
|
+
* @example
|
|
282
|
+
* ```ts
|
|
283
|
+
* export default langsmith.connector(
|
|
284
|
+
* langsmith.chatFeedback({ dataset: "public-feedback" }),
|
|
285
|
+
* );
|
|
286
|
+
* // POST /connectors/langsmith/capabilities/langsmith:chat-feedback
|
|
287
|
+
* ```
|
|
145
288
|
*/
|
|
146
289
|
export function chatFeedback(options) {
|
|
147
290
|
return [
|
|
@@ -165,7 +308,27 @@ export function chatFeedback(options) {
|
|
|
165
308
|
}),
|
|
166
309
|
];
|
|
167
310
|
}
|
|
168
|
-
/**
|
|
311
|
+
/**
|
|
312
|
+
* Browser trace viewer preset: read a redacted run summary and create a share
|
|
313
|
+
* link for the caller's thread.
|
|
314
|
+
*
|
|
315
|
+
* Expands to one grant with a stable capability id:
|
|
316
|
+
*
|
|
317
|
+
* - `langsmith:trace-viewer` — thread-scoped {@link runs} with actions
|
|
318
|
+
* `read` and `share`, exposed to `browser`. Responses include
|
|
319
|
+
* `id` / `status` / `start_time` / `end_time` / `url` / `metadata` and redact
|
|
320
|
+
* `inputs` / `outputs` / `events` by default.
|
|
321
|
+
*
|
|
322
|
+
* Pass the returned array (or spread it) into {@link connector}.
|
|
323
|
+
*
|
|
324
|
+
* @returns Capability grant for redacted run read/share.
|
|
325
|
+
*
|
|
326
|
+
* @example
|
|
327
|
+
* ```ts
|
|
328
|
+
* export default langsmith.connector(langsmith.traceViewer());
|
|
329
|
+
* // POST /connectors/langsmith/capabilities/langsmith:trace-viewer
|
|
330
|
+
* ```
|
|
331
|
+
*/
|
|
169
332
|
export function traceViewer() {
|
|
170
333
|
return [
|
|
171
334
|
runs({
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"langsmith.js","sourceRoot":"","sources":["../../src/connectors/langsmith.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,eAAe,GAGhB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAsDzE,6EAA6E;AAC7E,MAAM,eAAe,GAAiD;IACpE,IAAI,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,CAAC;IACnE,QAAQ,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,CAAC;IACxD,QAAQ,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,YAAY,CAAC;IAC5C,OAAO,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,YAAY,CAAC;IAC9C,OAAO,EAAE,CAAC,WAAW,EAAE,YAAY,EAAE,gBAAgB,CAAC;CACvD,CAAC;AAEF,kFAAkF;AAClF,MAAM,gBAAgB,GAAiD;IACrE,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC;IACrC,OAAO,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC;IAChC,OAAO,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;CAChC,CAAC;AAEF,+EAA+E;AAC/E,MAAM,uBAAuB,GAAiD;IAC5E,IAAI,EAAE,EAAE;IACR,QAAQ,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,iBAAiB,EAAE,aAAa,CAAC;IAC9D,QAAQ,EAAE,CAAC,SAAS,EAAE,eAAe,EAAE,sBAAsB,CAAC;IAC9D,iBAAiB,EAAE,CAAC,OAAO,EAAE,mBAAmB,EAAE,cAAc,CAAC;IACjE,OAAO,EAAE,EAAE;IACX,OAAO,EAAE,CAAC,cAAc,EAAE,eAAe,CAAC;CAC3C,CAAC;AAEF,SAAS,aAAa,CAAoC,KAAQ;IAChE,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CACpD,CAAC;AACT,CAAC;
|
|
1
|
+
{"version":3,"file":"langsmith.js","sourceRoot":"","sources":["../../src/connectors/langsmith.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,eAAe,GAGhB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAsDzE,6EAA6E;AAC7E,MAAM,eAAe,GAAiD;IACpE,IAAI,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,CAAC;IACnE,QAAQ,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,CAAC;IACxD,QAAQ,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,YAAY,CAAC;IAC5C,OAAO,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,YAAY,CAAC;IAC9C,OAAO,EAAE,CAAC,WAAW,EAAE,YAAY,EAAE,gBAAgB,CAAC;CACvD,CAAC;AAEF,kFAAkF;AAClF,MAAM,gBAAgB,GAAiD;IACrE,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC;IACrC,OAAO,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC;IAChC,OAAO,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;CAChC,CAAC;AAEF,+EAA+E;AAC/E,MAAM,uBAAuB,GAAiD;IAC5E,IAAI,EAAE,EAAE;IACR,QAAQ,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,iBAAiB,EAAE,aAAa,CAAC;IAC9D,QAAQ,EAAE,CAAC,SAAS,EAAE,eAAe,EAAE,sBAAsB,CAAC;IAC9D,iBAAiB,EAAE,CAAC,OAAO,EAAE,mBAAmB,EAAE,cAAc,CAAC;IACjE,OAAO,EAAE,EAAE;IACX,OAAO,EAAE,CAAC,cAAc,EAAE,eAAe,CAAC;CAC3C,CAAC;AAEF,SAAS,aAAa,CAAoC,KAAQ;IAChE,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CACpD,CAAC;AACT,CAAC;AA+BD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,IAAI,CAAC,OAA8B;IACjD,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,QAAQ,EAAE,MAAM;QAChB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,QAAQ,EAAE;YACR,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,eAAe,CAAC,IAAI;YAChD,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,gBAAgB,CAAC,IAAI;SAChD;QACD,GAAG,CAAC,OAAO,CAAC,cAAc;YACxB,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE;YAC5C,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC;AA6BD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,QAAQ,CACtB,OAAkC;IAElC,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,QAAQ,EAAE,UAAU;QACpB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,KAAK;QAC7B,WAAW,EAAE,aAAa,CAAC;YACzB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,eAAe,EAAE,OAAO,CAAC,eAAe;YACxC,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAC;QACF,QAAQ,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,eAAe,CAAC,QAAQ,EAAE;KACnE,CAAC;AACJ,CAAC;AA2BD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,QAAQ,CACtB,OAAkC;IAElC,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,QAAQ,EAAE,UAAU;QACpB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,QAAQ;QAChC,WAAW,EAAE,aAAa,CAAC;YACzB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;SACnD,CAAC;QACF,QAAQ,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,eAAe,CAAC,QAAQ,EAAE;KACnE,CAAC;AACJ,CAAC;AAyBD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAA0C;IAE1C,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,QAAQ,EAAE,mBAAmB;QAC7B,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,KAAK;QAC7B,WAAW,EAAE,aAAa,CAAC;YACzB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;YAC5C,YAAY,EAAE,OAAO,CAAC,YAAY;SACnC,CAAC;QACF,mEAAmE;QACnE,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE;KAC9B,CAAC;AACJ,CAAC;AAuBD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,OAAO,CACrB,OAAiC;IAEjC,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,QAAQ,EAAE,SAAS;QACnB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,OAAO;QAC/B,QAAQ,EAAE;YACR,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,eAAe,CAAC,OAAO;YACnD,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,gBAAgB,CAAC,OAAO;SACnD;KACF,CAAC;AACJ,CAAC;AA8BD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,OAAO,CACrB,OAAiC;IAEjC,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,QAAQ,EAAE,SAAS;QACnB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,OAAO;QAC/B,WAAW,EAAE,aAAa,CAAC;YACzB,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,aAAa,EAAE,OAAO,CAAC,aAAa;SACrC,CAAC;QACF,QAAQ,EAAE;YACR,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,eAAe,CAAC,OAAO;YACnD,MAAM,EAAE,gBAAgB,CAAC,OAAO;SACjC;QACD,GAAG,CAAC,OAAO,CAAC,cAAc;YACxB,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE;YAC5C,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC;AAED,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,YAAY,CAAC,OAE5B;IACC,OAAO;QACL,QAAQ,CAAC;YACP,EAAE,EAAE,yBAAyB;YAC7B,QAAQ,EAAE,CAAC,SAAS,CAAC;YACrB,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;YACvC,KAAK,EAAE,KAAK;YACZ,IAAI,EAAE,CAAC,YAAY,CAAC;YACpB,MAAM,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC;YAChC,eAAe,EAAE,IAAI;YACrB,WAAW,EAAE,IAAI;SAClB,CAAC;QACF,QAAQ,CAAC;YACP,EAAE,EAAE,kCAAkC;YACtC,QAAQ,EAAE,CAAC,SAAS,CAAC;YACrB,OAAO,EAAE,CAAC,QAAQ,CAAC;YACnB,KAAK,EAAE,QAAQ;YACf,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,aAAa,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC;SAC5D,CAAC;KACH,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO;QACL,IAAI,CAAC;YACH,EAAE,EAAE,wBAAwB;YAC5B,QAAQ,EAAE,CAAC,SAAS,CAAC;YACrB,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;YAC1B,KAAK,EAAE,QAAQ;SAChB,CAAC;KACH,CAAC;AACJ,CAAC;AAED,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CACxC,YAAmC;IAEnC,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,4DAA4D,CAC7D,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,UAAU,IAAI,YAAY,EAAE,CAAC;QACtC,kBAAkB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACvC,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CACzB,UAA+B,EAC/B,IAAiB;IAEjB,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,uCAAuC,UAAU,CAAC,EAAE,IAAI,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IAExB,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CACb,yBAAyB,UAAU,CAAC,EAAE,+CAA+C,CACtF,CAAC;IACJ,CAAC;IACD,IAAI,UAAU,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CACb,yBAAyB,UAAU,CAAC,EAAE,qCAAqC,CAC5E,CAAC;IACJ,CAAC;IAED,oEAAoE;IACpE,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC7C,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CACb,yBAAyB,UAAU,CAAC,EAAE,8BAA8B;YAClE,4CAA4C,CAC/C,CAAC;IACJ,CAAC;IAED,oBAAoB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC1C,yBAAyB,CAAC,UAAU,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,oBAAoB,CAC3B,UAA+B,EAC/B,OAAiB;IAEjB,MAAM,SAAS,GAAG,gBAAgB,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC9D,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC;IAC9D,MAAM,cAAc,GAAG,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC/D,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO;IACT,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC;QAC1C,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACxD,MAAM,IAAI,KAAK,CACb,yBAAyB,UAAU,CAAC,EAAE,6BAA6B;gBACjE,IAAI,IAAI,kDAAkD,IAAI,QAAQ;gBACtE,0BAA0B,CAC7B,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,yBAAyB,CAAC,UAA+B;IAChE,MAAM,OAAO,GAAG,uBAAuB,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC7D,IAAI,CAAC,UAAU,CAAC,WAAW,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QACrD,OAAO;IACT,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QACtD,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CACb,yBAAyB,UAAU,CAAC,EAAE,2BAA2B;gBAC/D,IAAI,GAAG,mBAAmB,UAAU,CAAC,QAAQ,IAAI,CACpD,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAUD;;;;GAIG;AACH,MAAM,UAAU,SAAS,CACvB,GAAG,YAAgE;IAEnE,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC;IACjC,0BAA0B,CAAC,IAAI,CAAC,CAAC;IAEjC,MAAM,QAAQ,GAAG;QACf,CAAC,eAAe,CAAC,EAAE,IAAa;QAChC,IAAI,EAAE,WAAoB;QAC1B,YAAY,EAAE,IAAI;QAClB;;;;WAIG;QACH,IAAI,CAAC,GAAgB;YACnB,oBAAoB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAClC,CAAC;KACF,CAAC;IACF,OAAO,QAAQ,CAAC;AAClB,CAAC"}
|