@runtypelabs/sdk 9.3.0 → 9.3.2
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/CHANGELOG.md +3457 -0
- package/dist/index.cjs +28 -85
- package/dist/index.d.cts +130 -631
- package/dist/index.d.ts +130 -631
- package/dist/index.mjs +28 -85
- package/package.json +1 -1
package/dist/index.d.ts
CHANGED
|
@@ -228,6 +228,12 @@ interface paths {
|
|
|
228
228
|
requestBody?: {
|
|
229
229
|
content: {
|
|
230
230
|
"application/json": {
|
|
231
|
+
/**
|
|
232
|
+
* @description Use overwrite only after confirming replacement of a code-managed agent.
|
|
233
|
+
* @default error
|
|
234
|
+
* @enum {string}
|
|
235
|
+
*/
|
|
236
|
+
onConflict?: "error" | "overwrite";
|
|
231
237
|
versionId: string;
|
|
232
238
|
};
|
|
233
239
|
};
|
|
@@ -241,9 +247,15 @@ interface paths {
|
|
|
241
247
|
content: {
|
|
242
248
|
"application/json": {
|
|
243
249
|
agentId: string;
|
|
250
|
+
applied: {
|
|
251
|
+
[key: string]: boolean;
|
|
252
|
+
};
|
|
253
|
+
/** @enum {string} */
|
|
254
|
+
lastModifiedSource: "dashboard" | "api" | "mcp";
|
|
244
255
|
message: string;
|
|
245
256
|
success: boolean;
|
|
246
257
|
versionId: string;
|
|
258
|
+
warnings: string[];
|
|
247
259
|
};
|
|
248
260
|
};
|
|
249
261
|
};
|
|
@@ -285,6 +297,20 @@ interface paths {
|
|
|
285
297
|
"application/json": components["schemas"]["Error"];
|
|
286
298
|
};
|
|
287
299
|
};
|
|
300
|
+
/** @description Publishing would overwrite a definition managed by code */
|
|
301
|
+
409: {
|
|
302
|
+
headers: {
|
|
303
|
+
[name: string]: unknown;
|
|
304
|
+
};
|
|
305
|
+
content: {
|
|
306
|
+
"application/json": components["schemas"]["Error"] & {
|
|
307
|
+
/** @enum {string} */
|
|
308
|
+
code: "managed_by_code_conflict";
|
|
309
|
+
/** @enum {string} */
|
|
310
|
+
lastModifiedSource: "sdk" | "terraform";
|
|
311
|
+
};
|
|
312
|
+
};
|
|
313
|
+
};
|
|
288
314
|
/** @description Internal server error */
|
|
289
315
|
500: {
|
|
290
316
|
headers: {
|
|
@@ -713,6 +739,7 @@ interface paths {
|
|
|
713
739
|
maxCost?: number;
|
|
714
740
|
maxTurns?: number;
|
|
715
741
|
reflectionInterval?: number;
|
|
742
|
+
treatLengthCutoffAsFailure?: boolean;
|
|
716
743
|
};
|
|
717
744
|
maxTokens?: number;
|
|
718
745
|
memory?: {
|
|
@@ -1143,6 +1170,7 @@ interface paths {
|
|
|
1143
1170
|
maxCost?: number;
|
|
1144
1171
|
maxTurns?: number;
|
|
1145
1172
|
reflectionInterval?: number;
|
|
1173
|
+
treatLengthCutoffAsFailure?: boolean;
|
|
1146
1174
|
};
|
|
1147
1175
|
maxTokens?: number;
|
|
1148
1176
|
memory?: {
|
|
@@ -1841,6 +1869,7 @@ interface paths {
|
|
|
1841
1869
|
maxCost?: number;
|
|
1842
1870
|
maxTurns?: number;
|
|
1843
1871
|
reflectionInterval?: number;
|
|
1872
|
+
treatLengthCutoffAsFailure?: boolean;
|
|
1844
1873
|
};
|
|
1845
1874
|
maxTokens?: number;
|
|
1846
1875
|
memory?: {
|
|
@@ -10897,6 +10926,7 @@ interface paths {
|
|
|
10897
10926
|
maxCost?: number;
|
|
10898
10927
|
maxTurns?: number;
|
|
10899
10928
|
reflectionInterval?: number;
|
|
10929
|
+
treatLengthCutoffAsFailure?: boolean;
|
|
10900
10930
|
};
|
|
10901
10931
|
maxTokens?: number;
|
|
10902
10932
|
memory?: {
|
|
@@ -11190,7 +11220,7 @@ interface paths {
|
|
|
11190
11220
|
/** @default true */
|
|
11191
11221
|
createVersionOnChange?: boolean;
|
|
11192
11222
|
};
|
|
11193
|
-
/** @description Execution-lane selector. `false` is
|
|
11223
|
+
/** @description Execution-lane selector. `false` is RETIRED on AGENT dispatches: the legacy agent engine it selected has been deleted, so it is rejected with 400 LEGACY_AGENT_LANE_RETIRED (still carrying the RFC 9745 `Deprecation` + `X-API-Deprecation-Warning` response headers). Omitted and `true` are now IDENTICAL for agents: both run an eligible agent on the @runtypelabs/runtime lane, and both answer a definition the lane cannot execute faithfully with 400 RUNTIME_AGENT_PARITY_FOLD_UNSUPPORTED rather than degrading it. For FLOW dispatches the field is accepted but ignored: eligible flows always use the runtime lane, while ineligible flows still fold to legacy silently. */
|
|
11194
11224
|
useRuntimePackage?: boolean;
|
|
11195
11225
|
versionLabel?: string;
|
|
11196
11226
|
versionNotes?: string;
|
|
@@ -11206,7 +11236,7 @@ interface paths {
|
|
|
11206
11236
|
ownerId?: string;
|
|
11207
11237
|
type?: string;
|
|
11208
11238
|
};
|
|
11209
|
-
/** @description Retired. A NON-EMPTY map on an agent dispatch is rejected with 400 RUNTIME_AGENT_TRANSIENT_SECRETS_UNSUPPORTED
|
|
11239
|
+
/** @description Retired. A NON-EMPTY map on an agent dispatch is rejected with 400 RUNTIME_AGENT_TRANSIENT_SECRETS_UNSUPPORTED. There is no longer an exception: the legacy engine that honored it for single-turn agents behind `options.useRuntimePackage: false` has been removed, and that opt-out is itself a 400 now. An empty map is accepted and does nothing. Ignored on flow dispatches. Store credentials as managed secrets and reference them as {{secret:NAME}}. The field is kept on the wire for compatibility only. */
|
|
11210
11240
|
secrets?: {
|
|
11211
11241
|
[key: string]: string;
|
|
11212
11242
|
};
|
|
@@ -11272,6 +11302,7 @@ interface paths {
|
|
|
11272
11302
|
maxCost?: number;
|
|
11273
11303
|
maxTurns?: number;
|
|
11274
11304
|
reflectionInterval?: number;
|
|
11305
|
+
treatLengthCutoffAsFailure?: boolean;
|
|
11275
11306
|
};
|
|
11276
11307
|
maxTokens?: number;
|
|
11277
11308
|
memory?: {
|
|
@@ -11565,7 +11596,7 @@ interface paths {
|
|
|
11565
11596
|
/** @default true */
|
|
11566
11597
|
createVersionOnChange?: boolean;
|
|
11567
11598
|
};
|
|
11568
|
-
/** @description Execution-lane selector. `false` is
|
|
11599
|
+
/** @description Execution-lane selector. `false` is RETIRED on AGENT dispatches: the legacy agent engine it selected has been deleted, so it is rejected with 400 LEGACY_AGENT_LANE_RETIRED (still carrying the RFC 9745 `Deprecation` + `X-API-Deprecation-Warning` response headers). Omitted and `true` are now IDENTICAL for agents: both run an eligible agent on the @runtypelabs/runtime lane, and both answer a definition the lane cannot execute faithfully with 400 RUNTIME_AGENT_PARITY_FOLD_UNSUPPORTED rather than degrading it. For FLOW dispatches the field is accepted but ignored: eligible flows always use the runtime lane, while ineligible flows still fold to legacy silently. */
|
|
11569
11600
|
useRuntimePackage?: boolean;
|
|
11570
11601
|
versionLabel?: string;
|
|
11571
11602
|
versionNotes?: string;
|
|
@@ -11581,7 +11612,7 @@ interface paths {
|
|
|
11581
11612
|
ownerId?: string;
|
|
11582
11613
|
type?: string;
|
|
11583
11614
|
};
|
|
11584
|
-
/** @description Retired. A NON-EMPTY map on an agent dispatch is rejected with 400 RUNTIME_AGENT_TRANSIENT_SECRETS_UNSUPPORTED
|
|
11615
|
+
/** @description Retired. A NON-EMPTY map on an agent dispatch is rejected with 400 RUNTIME_AGENT_TRANSIENT_SECRETS_UNSUPPORTED. There is no longer an exception: the legacy engine that honored it for single-turn agents behind `options.useRuntimePackage: false` has been removed, and that opt-out is itself a 400 now. An empty map is accepted and does nothing. Ignored on flow dispatches. Store credentials as managed secrets and reference them as {{secret:NAME}}. The field is kept on the wire for compatibility only. */
|
|
11585
11616
|
secrets?: {
|
|
11586
11617
|
[key: string]: string;
|
|
11587
11618
|
};
|
|
@@ -16667,6 +16698,12 @@ interface paths {
|
|
|
16667
16698
|
requestBody?: {
|
|
16668
16699
|
content: {
|
|
16669
16700
|
"application/json": {
|
|
16701
|
+
/**
|
|
16702
|
+
* @description Use overwrite only after confirming replacement of a code-managed flow.
|
|
16703
|
+
* @default error
|
|
16704
|
+
* @enum {string}
|
|
16705
|
+
*/
|
|
16706
|
+
onConflict?: "error" | "overwrite";
|
|
16670
16707
|
versionId: string;
|
|
16671
16708
|
};
|
|
16672
16709
|
};
|
|
@@ -16679,10 +16716,16 @@ interface paths {
|
|
|
16679
16716
|
};
|
|
16680
16717
|
content: {
|
|
16681
16718
|
"application/json": {
|
|
16719
|
+
applied: {
|
|
16720
|
+
[key: string]: boolean;
|
|
16721
|
+
};
|
|
16682
16722
|
flowId: string;
|
|
16723
|
+
/** @enum {string} */
|
|
16724
|
+
lastModifiedSource: "dashboard" | "api" | "mcp";
|
|
16683
16725
|
message: string;
|
|
16684
16726
|
success: boolean;
|
|
16685
16727
|
versionId: string;
|
|
16728
|
+
warnings: string[];
|
|
16686
16729
|
};
|
|
16687
16730
|
};
|
|
16688
16731
|
};
|
|
@@ -16724,6 +16767,20 @@ interface paths {
|
|
|
16724
16767
|
"application/json": components["schemas"]["Error"];
|
|
16725
16768
|
};
|
|
16726
16769
|
};
|
|
16770
|
+
/** @description Publishing would overwrite a definition managed by code */
|
|
16771
|
+
409: {
|
|
16772
|
+
headers: {
|
|
16773
|
+
[name: string]: unknown;
|
|
16774
|
+
};
|
|
16775
|
+
content: {
|
|
16776
|
+
"application/json": components["schemas"]["Error"] & {
|
|
16777
|
+
/** @enum {string} */
|
|
16778
|
+
code: "managed_by_code_conflict";
|
|
16779
|
+
/** @enum {string} */
|
|
16780
|
+
lastModifiedSource: "sdk" | "terraform";
|
|
16781
|
+
};
|
|
16782
|
+
};
|
|
16783
|
+
};
|
|
16727
16784
|
/** @description Internal server error */
|
|
16728
16785
|
500: {
|
|
16729
16786
|
headers: {
|
|
@@ -44817,6 +44874,7 @@ interface components {
|
|
|
44817
44874
|
maxCost?: number;
|
|
44818
44875
|
maxTurns?: number;
|
|
44819
44876
|
reflectionInterval?: number;
|
|
44877
|
+
treatLengthCutoffAsFailure?: boolean;
|
|
44820
44878
|
};
|
|
44821
44879
|
maxTokens?: number;
|
|
44822
44880
|
memory?: {
|
|
@@ -45744,9 +45802,11 @@ interface components {
|
|
|
45744
45802
|
message: string;
|
|
45745
45803
|
};
|
|
45746
45804
|
executionId: string;
|
|
45805
|
+
finalOutput?: string;
|
|
45747
45806
|
/** @enum {string} */
|
|
45748
45807
|
kind: "agent" | "flow";
|
|
45749
45808
|
seq: number;
|
|
45809
|
+
stopReason?: string;
|
|
45750
45810
|
/** @enum {string} */
|
|
45751
45811
|
type: "execution_error";
|
|
45752
45812
|
upgradeUrl?: string;
|
|
@@ -46969,13 +47029,6 @@ type StreamEventOf<U, T extends string> = Extract<U, {
|
|
|
46969
47029
|
type: T;
|
|
46970
47030
|
}>;
|
|
46971
47031
|
|
|
46972
|
-
/**
|
|
46973
|
-
* SSE Stream Utilities for FlowBuilder
|
|
46974
|
-
*
|
|
46975
|
-
* Provides utilities for parsing Server-Sent Events (SSE) streams
|
|
46976
|
-
* from the Runtype API dispatch endpoint.
|
|
46977
|
-
*/
|
|
46978
|
-
|
|
46979
47032
|
/**
|
|
46980
47033
|
* Options for the flow stream consumers.
|
|
46981
47034
|
*
|
|
@@ -47037,13 +47090,6 @@ declare function processStream(response: Response, callbacks?: StreamCallbacks,
|
|
|
47037
47090
|
*/
|
|
47038
47091
|
declare function streamEvents(response: Response, _options?: StreamConsumeOptions): AsyncGenerator<StreamEvent>;
|
|
47039
47092
|
|
|
47040
|
-
/**
|
|
47041
|
-
* FlowResult - Wrapper for streaming flow execution responses
|
|
47042
|
-
*
|
|
47043
|
-
* Provides convenient methods for processing streaming responses
|
|
47044
|
-
* from the Runtype API dispatch endpoint.
|
|
47045
|
-
*/
|
|
47046
|
-
|
|
47047
47093
|
/**
|
|
47048
47094
|
* Result wrapper for flow execution
|
|
47049
47095
|
*
|
|
@@ -47158,26 +47204,6 @@ declare class FlowResult {
|
|
|
47158
47204
|
private ensureNotConsumed;
|
|
47159
47205
|
}
|
|
47160
47206
|
|
|
47161
|
-
/**
|
|
47162
|
-
* FlowBuilder - Fluent builder for constructing dispatch configurations
|
|
47163
|
-
*
|
|
47164
|
-
* Provides a chainable API for building flows with steps, making flow
|
|
47165
|
-
* construction more readable and type-safe.
|
|
47166
|
-
*
|
|
47167
|
-
* @example
|
|
47168
|
-
* ```typescript
|
|
47169
|
-
* import { FlowBuilder } from '@runtypelabs/sdk'
|
|
47170
|
-
*
|
|
47171
|
-
* const config = new FlowBuilder()
|
|
47172
|
-
* .createFlow({ name: "My Flow" })
|
|
47173
|
-
* .withRecord({ name: "Record", type: "data", metadata: { key: "value" } })
|
|
47174
|
-
* .fetchUrl({ name: "Fetch", url: "https://api.example.com", outputVariable: "data" })
|
|
47175
|
-
* .prompt({ name: "Process", model: "gpt-4", userPrompt: "Analyze: {{data}}" })
|
|
47176
|
-
* .withOptions({ streamResponse: true, flowMode: "virtual" })
|
|
47177
|
-
* .build()
|
|
47178
|
-
* ```
|
|
47179
|
-
*/
|
|
47180
|
-
|
|
47181
47207
|
interface PromptStepConfig$1 {
|
|
47182
47208
|
name: string;
|
|
47183
47209
|
model: string;
|
|
@@ -47653,10 +47679,11 @@ interface DispatchOptions$1 {
|
|
|
47653
47679
|
loggingPolicy?: 'default' | 'on' | 'off';
|
|
47654
47680
|
/**
|
|
47655
47681
|
* Ignored for flows (runtime eligibility selects the engine). For agents,
|
|
47656
|
-
* `false` is
|
|
47657
|
-
*
|
|
47658
|
-
*
|
|
47659
|
-
*
|
|
47682
|
+
* `false` is RETIRED: the legacy agent engine it selected has been deleted,
|
|
47683
|
+
* so it is rejected with 400 `LEGACY_AGENT_LANE_RETIRED` (the response still
|
|
47684
|
+
* carries `Deprecation` headers). Omit the field, or send `true` — for agents
|
|
47685
|
+
* the two are now identical, and both answer a definition the runtime lane
|
|
47686
|
+
* cannot execute faithfully with a 400 rather than degrading it.
|
|
47660
47687
|
*/
|
|
47661
47688
|
useRuntimePackage?: boolean;
|
|
47662
47689
|
localInference?: {
|
|
@@ -48863,10 +48890,9 @@ interface FlowToolConfig {
|
|
|
48863
48890
|
flowId?: string;
|
|
48864
48891
|
toolId?: string;
|
|
48865
48892
|
/**
|
|
48866
|
-
* Inline flow definition.
|
|
48867
|
-
*
|
|
48868
|
-
*
|
|
48869
|
-
* reference.
|
|
48893
|
+
* Inline flow definition. Agent dispatches support this — every eligible
|
|
48894
|
+
* agent runs on the runtime lane, which resolves an inline flow — while
|
|
48895
|
+
* hosted flow definitions currently require a `flowId`/`toolId` reference.
|
|
48870
48896
|
*/
|
|
48871
48897
|
flow?: Record<string, unknown>;
|
|
48872
48898
|
/** Registered-flow name key for the runtime lane (`flowName ?? flowId`). */
|
|
@@ -49014,10 +49040,9 @@ interface RuntimeFlowToolConfig {
|
|
|
49014
49040
|
flowId?: string;
|
|
49015
49041
|
toolId?: string;
|
|
49016
49042
|
/**
|
|
49017
|
-
* Inline flow definition.
|
|
49018
|
-
*
|
|
49019
|
-
*
|
|
49020
|
-
* reference.
|
|
49043
|
+
* Inline flow definition. Agent dispatches support this — every eligible
|
|
49044
|
+
* agent runs on the runtime lane, which resolves an inline flow — while
|
|
49045
|
+
* hosted flow definitions currently require a `flowId`/`toolId` reference.
|
|
49021
49046
|
*/
|
|
49022
49047
|
flow?: Record<string, unknown>;
|
|
49023
49048
|
/** Registered-flow name key for the runtime lane (`flowName ?? flowId`). */
|
|
@@ -49390,6 +49415,12 @@ interface AgentVersionPublishResponse {
|
|
|
49390
49415
|
message: string;
|
|
49391
49416
|
agentId: string;
|
|
49392
49417
|
versionId: string;
|
|
49418
|
+
applied: Record<string, boolean>;
|
|
49419
|
+
warnings: string[];
|
|
49420
|
+
lastModifiedSource: 'dashboard' | 'api' | 'mcp';
|
|
49421
|
+
}
|
|
49422
|
+
interface VersionPublishOptions {
|
|
49423
|
+
onConflict?: 'error' | 'overwrite';
|
|
49393
49424
|
}
|
|
49394
49425
|
interface FlowVersionListItem {
|
|
49395
49426
|
id: string;
|
|
@@ -49412,6 +49443,9 @@ interface FlowVersionPublishResponse {
|
|
|
49412
49443
|
message: string;
|
|
49413
49444
|
flowId: string;
|
|
49414
49445
|
versionId: string;
|
|
49446
|
+
applied: Record<string, boolean>;
|
|
49447
|
+
warnings: string[];
|
|
49448
|
+
lastModifiedSource: 'dashboard' | 'api' | 'mcp';
|
|
49415
49449
|
}
|
|
49416
49450
|
type VersionType = 'published' | 'draft' | 'test' | 'virtual';
|
|
49417
49451
|
type Integration = paths['/v1/integrations']['get']['responses'][200]['content']['application/json']['integrations'][number];
|
|
@@ -49585,32 +49619,6 @@ interface BillingSpendAnalyticsParams {
|
|
|
49585
49619
|
period?: 'billing_period' | 'current_month' | 'last_7_days' | 'last_30_days' | 'last_90_days';
|
|
49586
49620
|
}
|
|
49587
49621
|
|
|
49588
|
-
/**
|
|
49589
|
-
* Eval config-as-code: `defineEval` + the grader builders.
|
|
49590
|
-
*
|
|
49591
|
-
* The authoring layer for code-colocated evals — define the evals for a flow or
|
|
49592
|
-
* agent right next to its `defineFlow` / `flows.ensure` definition. This module
|
|
49593
|
-
* is PURE and local (no I/O), the exact analog of `defineFlow` in
|
|
49594
|
-
* `flows-ensure.ts`: it validates and normalizes a loose `DefineEvalInput` into
|
|
49595
|
-
* a canonical `EvalDefinition` (target + cases + per-case graders) and computes
|
|
49596
|
-
* a content hash for hash-first convergence. The converge motion
|
|
49597
|
-
* (`client.evals.ensure` → `POST /eval/ensure`) and the `runtype eval` CLI build
|
|
49598
|
-
* on this contract in later increments.
|
|
49599
|
-
*
|
|
49600
|
-
* Grader types are MIRRORED INLINE from `@runtypelabs/shared`'s
|
|
49601
|
-
* `grader-types.ts` (the SDK is dependency-free by convention — see the same
|
|
49602
|
-
* pattern in `flows-ensure.ts`). The wire shapes must stay byte-identical to the
|
|
49603
|
-
* shared discriminated union so an eval authored here scores through the existing
|
|
49604
|
-
* `EvalScoringService` unchanged.
|
|
49605
|
-
*
|
|
49606
|
-
* Scope: the output + AI-judge union plus the trace graders (`called_tool` /
|
|
49607
|
-
* `tool_order` / `ran_step` / `completed` / `cost` / …), each scored server-side
|
|
49608
|
-
* by the same pure `runCheck` engine over the run's captured execution trace.
|
|
49609
|
-
* Severity (`.gate()` / `.soft()`) is deliberately NOT emitted here — it lands
|
|
49610
|
-
* with its own grader-engine extension. See
|
|
49611
|
-
* `docs/features/planning/2026-06-24-code-colocated-evals.md`.
|
|
49612
|
-
*/
|
|
49613
|
-
|
|
49614
49622
|
/**
|
|
49615
49623
|
* Per-grader severity (mirror of `@runtypelabs/shared`'s `GraderSeverity`). A
|
|
49616
49624
|
* `gate` miss always fails the case; a `soft` miss is tracked-but-not-failing
|
|
@@ -50151,44 +50159,6 @@ declare function pullEval(client: RuntypeClient$1, name: string): Promise<EvalPu
|
|
|
50151
50159
|
*/
|
|
50152
50160
|
declare function runEvalSuite(client: RuntypeClient$1, input: RunEvalInput): Promise<RunEvalResult>;
|
|
50153
50161
|
|
|
50154
|
-
/**
|
|
50155
|
-
* Flow config-as-code: `defineFlow`, `flows.ensure`, `flows.pull`.
|
|
50156
|
-
*
|
|
50157
|
-
* The non-executing sibling of `flows.upsert()` — `upsert` is the
|
|
50158
|
-
* dispatch-coupled save-and-run motion (it saves the flow AND executes it in
|
|
50159
|
-
* one request); `ensure` is the deploy-time convergence postcondition: "make
|
|
50160
|
-
* the platform's definition of this flow match this object; no-op if it
|
|
50161
|
-
* already does." Identity is name + account scope (the API key's org, else
|
|
50162
|
-
* personal); environment is whichever API the client points at. `ensure`
|
|
50163
|
-
* never deletes, and renaming a definition orphans the old flow and creates a
|
|
50164
|
-
* new one.
|
|
50165
|
-
*
|
|
50166
|
-
* Wire protocol (POST /v1/flows/ensure — APQ-shaped, both APQ scars fixed):
|
|
50167
|
-
* 1. Hash-only probe `{ name, contentHash }`. A match is
|
|
50168
|
-
* `{ result: 'unchanged' }`; a miss is a NORMAL 200
|
|
50169
|
-
* `{ result: 'definitionRequired' }`, never an error.
|
|
50170
|
-
* 2. On a miss, retry with the full `definition`. The server recomputes the
|
|
50171
|
-
* canonical hash itself and returns it on every response — this SDK
|
|
50172
|
-
* echoes the server's hash (memoized per client instance) rather than
|
|
50173
|
-
* trusting its own serialization.
|
|
50174
|
-
*
|
|
50175
|
-
* The content hash is the SAME steps-only hash the flow upsert protocol uses
|
|
50176
|
-
* (`computeFlowContentHash` — mirrored from
|
|
50177
|
-
* `packages/shared/src/utils/flow-content-hash.ts`; this package is
|
|
50178
|
-
* dependency-free by convention), so ensure and upsert interoperate on the
|
|
50179
|
-
* same flow. The flow definition surface is `{ name, steps }` — description
|
|
50180
|
-
* is not part of the v1 ensure surface (the shared hash covers steps only).
|
|
50181
|
-
*
|
|
50182
|
-
* A `defineFlow` may also carry inline `evals` — eval suites to converge
|
|
50183
|
-
* alongside the flow. These are SDK-orchestrated: they are NOT part of the
|
|
50184
|
-
* flow content hash and NEVER ride the `/flows/ensure` wire (its server schema
|
|
50185
|
-
* is `.strict()` `{ name, steps }`). After the flow converges, `ensureFlow`
|
|
50186
|
-
* converges each inline suite through the existing `/eval/ensure` endpoint
|
|
50187
|
-
* (`ensureEval`), so eval semantics stay confined to the eval endpoints.
|
|
50188
|
-
*
|
|
50189
|
-
* See docs/adr/0003-agent-config-as-code-ensure.md for the design rationale.
|
|
50190
|
-
*/
|
|
50191
|
-
|
|
50192
50162
|
/** SHA-256 (hex) over the canonical normalized step list (steps only). */
|
|
50193
50163
|
declare function computeFlowContentHash(steps: unknown[]): Promise<string>;
|
|
50194
50164
|
/**
|
|
@@ -50340,15 +50310,6 @@ declare class FlowDriftError extends Error {
|
|
|
50340
50310
|
constructor(plan: EnsureFlowPlan);
|
|
50341
50311
|
}
|
|
50342
50312
|
|
|
50343
|
-
/**
|
|
50344
|
-
* FlowsNamespace - Static namespace for flow operations
|
|
50345
|
-
*
|
|
50346
|
-
* Provides factory methods for creating flow builders with different modes:
|
|
50347
|
-
* - upsert: Create or update a flow by name
|
|
50348
|
-
* - virtual: One-off execution without saving
|
|
50349
|
-
* - use: Execute an existing flow by ID
|
|
50350
|
-
*/
|
|
50351
|
-
|
|
50352
50313
|
interface LocalToolsOptions {
|
|
50353
50314
|
localTools?: Record<string, (args: unknown) => Promise<unknown>>;
|
|
50354
50315
|
}
|
|
@@ -50726,13 +50687,6 @@ declare class RuntypeFlowBuilder {
|
|
|
50726
50687
|
private addStep;
|
|
50727
50688
|
}
|
|
50728
50689
|
|
|
50729
|
-
/**
|
|
50730
|
-
* BatchesNamespace - Static namespace for batch operations
|
|
50731
|
-
*
|
|
50732
|
-
* Provides direct methods for scheduling and managing batch operations.
|
|
50733
|
-
* Batches are always asynchronous - they don't return results immediately.
|
|
50734
|
-
*/
|
|
50735
|
-
|
|
50736
50690
|
interface BatchScheduleConfig {
|
|
50737
50691
|
/** Flow ID to execute for each record */
|
|
50738
50692
|
flowId: string;
|
|
@@ -50858,17 +50812,6 @@ declare class BatchesNamespace {
|
|
|
50858
50812
|
}>;
|
|
50859
50813
|
}
|
|
50860
50814
|
|
|
50861
|
-
/**
|
|
50862
|
-
* Eval-suite CRUD + case management + run — the SDK surface for the
|
|
50863
|
-
* `/v1/eval/suites` REST family (Beginner-First Evals).
|
|
50864
|
-
*
|
|
50865
|
-
* This is the imperative, id-addressed counterpart of the config-as-code
|
|
50866
|
-
* surface in `evals-ensure.ts` (`defineEval` / `ensure` / `pull`): use ensure
|
|
50867
|
-
* to converge a repo-authored suite on deploy, and this namespace to inspect
|
|
50868
|
-
* or manage suites, edit test cases (server-authoritative data), and start
|
|
50869
|
-
* runs. Exposed as `client.evals.suites.*`.
|
|
50870
|
-
*/
|
|
50871
|
-
|
|
50872
50815
|
/** The most recent run of a suite, with its score once graded. */
|
|
50873
50816
|
interface EvalSuiteLatestRun {
|
|
50874
50817
|
runId: string;
|
|
@@ -51257,13 +51200,6 @@ declare class EvalSuitesNamespace {
|
|
|
51257
51200
|
getCoverage(suiteId: string): Promise<EvalSuiteCoverage>;
|
|
51258
51201
|
}
|
|
51259
51202
|
|
|
51260
|
-
/**
|
|
51261
|
-
* EvalsNamespace - Static namespace for evaluation operations
|
|
51262
|
-
*
|
|
51263
|
-
* Provides methods for running evaluations and comparing model performance.
|
|
51264
|
-
* Evals can be streamed for real-time results or submitted as batch jobs.
|
|
51265
|
-
*/
|
|
51266
|
-
|
|
51267
51203
|
interface ModelOverride$1 {
|
|
51268
51204
|
/** Name of the step to override */
|
|
51269
51205
|
stepName: string;
|
|
@@ -51581,13 +51517,6 @@ declare class EvalsNamespace {
|
|
|
51581
51517
|
}>;
|
|
51582
51518
|
}
|
|
51583
51519
|
|
|
51584
|
-
/**
|
|
51585
|
-
* PromptsNamespace - Static namespace for prompt operations
|
|
51586
|
-
*
|
|
51587
|
-
* Provides CRUD operations for prompts and execution methods
|
|
51588
|
-
* with streaming and non-streaming options.
|
|
51589
|
-
*/
|
|
51590
|
-
|
|
51591
51520
|
interface CreatePromptData {
|
|
51592
51521
|
/** Prompt name */
|
|
51593
51522
|
name: string;
|
|
@@ -51749,39 +51678,6 @@ declare class PromptsNamespace {
|
|
|
51749
51678
|
delete(promptId: string): Promise<void>;
|
|
51750
51679
|
}
|
|
51751
51680
|
|
|
51752
|
-
/**
|
|
51753
|
-
* Skill config-as-code: `defineSkill`, `skills.ensure`, `skills.pull`.
|
|
51754
|
-
*
|
|
51755
|
-
* The deploy-time convergence postcondition for Agent Skills: "make the
|
|
51756
|
-
* platform's definition of this skill match this manifest; no-op if it already
|
|
51757
|
-
* does." Identity is name + account scope (the API key's org, else personal);
|
|
51758
|
-
* environment is whichever API the client points at. `ensure` never deletes,
|
|
51759
|
-
* and renaming a manifest orphans the old skill and creates a new one.
|
|
51760
|
-
*
|
|
51761
|
-
* This is the admin/control-plane converge — API scopes only, no review queue.
|
|
51762
|
-
* It is NOT the deployed-agent `propose_skill` data plane.
|
|
51763
|
-
*
|
|
51764
|
-
* Wire protocol (POST /v1/skills/ensure — APQ-shaped, both APQ scars fixed):
|
|
51765
|
-
* 1. Hash-only probe `{ name, contentHash }`. A match is
|
|
51766
|
-
* `{ result: 'unchanged' }`; a miss is a NORMAL 200
|
|
51767
|
-
* `{ result: 'definitionRequired' }`, never an error.
|
|
51768
|
-
* 2. On a miss, retry with the full `definition`. The server recomputes the
|
|
51769
|
-
* canonical hash itself and returns it on every response — this SDK echoes
|
|
51770
|
-
* the server's hash (memoized per client instance) rather than trusting its
|
|
51771
|
-
* own serialization.
|
|
51772
|
-
*
|
|
51773
|
-
* Like agents/flows (and unlike tools), skills HAVE version snapshots: every
|
|
51774
|
-
* change appends an immutable version, the result carries a `versionId`, and
|
|
51775
|
-
* `release: 'publish'` re-aims the published-version pointer.
|
|
51776
|
-
*
|
|
51777
|
-
* The content hash is the canonical skill hash (`computeSkillContentHash` —
|
|
51778
|
-
* mirrored from `packages/shared/src/utils/skill-content-hash.ts`; this package
|
|
51779
|
-
* is dependency-free by convention) over the manifest `{ frontmatter (name
|
|
51780
|
-
* excluded), runtype, body }`. `name` is identity, not content.
|
|
51781
|
-
*
|
|
51782
|
-
* See docs/adr/0003-agent-config-as-code-ensure.md for the design rationale.
|
|
51783
|
-
*/
|
|
51784
|
-
|
|
51785
51681
|
interface SkillContentInput {
|
|
51786
51682
|
/** Identity — excluded from the hash. */
|
|
51787
51683
|
name: string;
|
|
@@ -51887,22 +51783,6 @@ declare class SkillDriftError extends Error {
|
|
|
51887
51783
|
constructor(plan: EnsureSkillPlan);
|
|
51888
51784
|
}
|
|
51889
51785
|
|
|
51890
|
-
/**
|
|
51891
|
-
* SkillsNamespace — admin/control-plane operations for Agent Skills.
|
|
51892
|
-
*
|
|
51893
|
-
* Skills are loadable context bundles (SKILL.md + capability bindings) for
|
|
51894
|
-
* deployed Runtype agents. This namespace wraps the admin REST surface
|
|
51895
|
-
* (`/v1/skills`, `/v1/skill-proposals`) — governed by API scopes only, no
|
|
51896
|
-
* review queue. The deployed-agent data plane (the `propose_skill` runtime
|
|
51897
|
-
* tool) is intentionally NOT exposed here; authoring a skill via the SDK is
|
|
51898
|
-
* authoring, and lands published when you ask it to.
|
|
51899
|
-
*
|
|
51900
|
-
* Types here mirror the canonical definitions in `@runtypelabs/shared`
|
|
51901
|
-
* (`skill-manifest-types.ts`) and the `skills` / `skill_versions` /
|
|
51902
|
-
* `agent_skill_bindings` / `skill_proposals` tables. Per SDK convention they
|
|
51903
|
-
* are defined inline rather than imported, to keep the package dependency-free.
|
|
51904
|
-
*/
|
|
51905
|
-
|
|
51906
51786
|
/** Lifecycle status of a skill. */
|
|
51907
51787
|
type SkillStatus = 'draft' | 'active' | 'archived';
|
|
51908
51788
|
/** Trust level recorded on a skill (governs UI warnings). */
|
|
@@ -52299,35 +52179,6 @@ declare class SkillsNamespace {
|
|
|
52299
52179
|
pull(name: string): Promise<SkillPullResult>;
|
|
52300
52180
|
}
|
|
52301
52181
|
|
|
52302
|
-
/**
|
|
52303
|
-
* AgentsNamespace — agent config-as-code: `defineAgent`, `ensure`, `pull`.
|
|
52304
|
-
*
|
|
52305
|
-
* `ensure` is a convergence postcondition, not a save button: "make the
|
|
52306
|
-
* platform's definition of this agent match this object; no-op if it already
|
|
52307
|
-
* does." Identity is name + account scope (the API key's org, else personal);
|
|
52308
|
-
* environment is whichever API the client points at. `ensure` never deletes,
|
|
52309
|
-
* and renaming a definition orphans the old agent and creates a new one.
|
|
52310
|
-
*
|
|
52311
|
-
* Wire protocol (POST /v1/agents/ensure — APQ-shaped, both APQ scars fixed):
|
|
52312
|
-
* 1. Hash-only probe `{ name, contentHash }`. A match is
|
|
52313
|
-
* `{ result: 'unchanged' }`; a miss is a NORMAL 200
|
|
52314
|
-
* `{ result: 'definitionRequired' }`, never an error.
|
|
52315
|
-
* 2. On a miss, retry with the full `definition`. The server recomputes the
|
|
52316
|
-
* canonical hash itself and returns it on every response — this SDK
|
|
52317
|
-
* echoes the server's hash (memoized per client instance) rather than
|
|
52318
|
-
* trusting its own serialization.
|
|
52319
|
-
*
|
|
52320
|
-
* The content-hash implementation below is an INLINED COPY of
|
|
52321
|
-
* `packages/shared/src/utils/agent-content-hash.ts` (this package is
|
|
52322
|
-
* dependency-free by convention, mirroring the flow content hash in
|
|
52323
|
-
* flows-namespace.ts). Parity is pinned by the shared fixture corpus in
|
|
52324
|
-
* `packages/shared/test-fixtures/agent-content-hash/cases.json`, asserted by
|
|
52325
|
-
* both packages' test suites. Change both copies (and regenerate the corpus)
|
|
52326
|
-
* in the same PR.
|
|
52327
|
-
*
|
|
52328
|
-
* See docs/adr/0003-agent-config-as-code-ensure.md for the design rationale.
|
|
52329
|
-
*/
|
|
52330
|
-
|
|
52331
52182
|
/** Canonical normalized form — must stay byte-identical to the shared impl. */
|
|
52332
52183
|
declare function normalizeAgentDefinition(definition: {
|
|
52333
52184
|
name: string;
|
|
@@ -52567,36 +52418,6 @@ declare class ExecutionsNamespace {
|
|
|
52567
52418
|
getStatus(executionId: string): Promise<AsyncExecutionStatus>;
|
|
52568
52419
|
}
|
|
52569
52420
|
|
|
52570
|
-
/**
|
|
52571
|
-
* Tool config-as-code: `defineTool`, `tools.ensure`, `tools.pull`.
|
|
52572
|
-
*
|
|
52573
|
-
* The deploy-time convergence postcondition for saved tools: "make the
|
|
52574
|
-
* platform's definition of this tool match this object; no-op if it already
|
|
52575
|
-
* does." Identity is name + account scope (the API key's org, else personal);
|
|
52576
|
-
* environment is whichever API the client points at. `ensure` never deletes,
|
|
52577
|
-
* and renaming a definition orphans the old tool and creates a new one.
|
|
52578
|
-
*
|
|
52579
|
-
* Wire protocol (POST /v1/tools/ensure — APQ-shaped, both APQ scars fixed):
|
|
52580
|
-
* 1. Hash-only probe `{ name, contentHash }`. A match is
|
|
52581
|
-
* `{ result: 'unchanged' }`; a miss is a NORMAL 200
|
|
52582
|
-
* `{ result: 'definitionRequired' }`, never an error.
|
|
52583
|
-
* 2. On a miss, retry with the full `definition`. The server recomputes the
|
|
52584
|
-
* canonical hash itself and returns it on every response — this SDK
|
|
52585
|
-
* echoes the server's hash (memoized per client instance) rather than
|
|
52586
|
-
* trusting its own serialization.
|
|
52587
|
-
*
|
|
52588
|
-
* Unlike agents/flows, tools have NO version snapshots: there is no
|
|
52589
|
-
* `release: 'publish'` option and no `versionId` on the result.
|
|
52590
|
-
*
|
|
52591
|
-
* The content hash is the canonical tool hash (`computeToolContentHash` —
|
|
52592
|
-
* mirrored from `packages/shared/src/utils/tool-content-hash.ts`; this package
|
|
52593
|
-
* is dependency-free by convention) over `{ toolType, description,
|
|
52594
|
-
* parametersSchema, config }`. `name` is identity, not content, so it is
|
|
52595
|
-
* excluded from the hash.
|
|
52596
|
-
*
|
|
52597
|
-
* See docs/adr/0003-agent-config-as-code-ensure.md for the design rationale.
|
|
52598
|
-
*/
|
|
52599
|
-
|
|
52600
52421
|
/** Canonical normalized form of a tool definition (name excluded — identity). */
|
|
52601
52422
|
declare function normalizeToolDefinition(definition: ToolContentInput): {
|
|
52602
52423
|
toolType: string;
|
|
@@ -52710,14 +52531,6 @@ declare class ToolDriftError extends Error {
|
|
|
52710
52531
|
constructor(plan: EnsureToolPlan);
|
|
52711
52532
|
}
|
|
52712
52533
|
|
|
52713
|
-
/**
|
|
52714
|
-
* ToolsNamespace — config-as-code operations for saved tools.
|
|
52715
|
-
*
|
|
52716
|
-
* `tools.ensure` is the deploy-time, non-executing converge (create-or-update a
|
|
52717
|
-
* tool by name + account scope); `tools.pull` is the absorb-drift direction.
|
|
52718
|
-
* Both delegate to the implementation in `tools-ensure.ts`.
|
|
52719
|
-
*/
|
|
52720
|
-
|
|
52721
52534
|
declare class ToolsNamespace {
|
|
52722
52535
|
private getClient;
|
|
52723
52536
|
constructor(getClient: () => RuntypeClient$1);
|
|
@@ -52751,42 +52564,6 @@ declare class ToolsNamespace {
|
|
|
52751
52564
|
pull(name: string): Promise<ToolPullResult>;
|
|
52752
52565
|
}
|
|
52753
52566
|
|
|
52754
|
-
/**
|
|
52755
|
-
* Product config-as-code: `defineProduct`, `products.ensure`, `products.pull`.
|
|
52756
|
-
*
|
|
52757
|
-
* The deploy-time convergence postcondition for the top-level product record:
|
|
52758
|
-
* "make the platform's definition of this product match this object; no-op if
|
|
52759
|
-
* it already does." Identity is name + account scope (the API key's org, else
|
|
52760
|
-
* personal); environment is whichever API the client points at. `ensure` never
|
|
52761
|
-
* deletes, and renaming a definition orphans the old product and creates a new
|
|
52762
|
-
* one.
|
|
52763
|
-
*
|
|
52764
|
-
* SCOPE (v1): the converge covers the TOP-LEVEL product record only — name
|
|
52765
|
-
* (identity), description, icon, and the `spec` (ProductSpec). It does NOT
|
|
52766
|
-
* converge nested capabilities/surfaces/tools/records/schedules, and it does
|
|
52767
|
-
* NOT converge `canvas` (architecture-viewer UI layout state).
|
|
52768
|
-
*
|
|
52769
|
-
* Wire protocol (POST /v1/products/ensure — APQ-shaped, both APQ scars fixed):
|
|
52770
|
-
* 1. Hash-only probe `{ name, contentHash }`. A match is
|
|
52771
|
-
* `{ result: 'unchanged' }`; a miss is a NORMAL 200
|
|
52772
|
-
* `{ result: 'definitionRequired' }`, never an error.
|
|
52773
|
-
* 2. On a miss, retry with the full `definition`. The server recomputes the
|
|
52774
|
-
* canonical hash itself and returns it on every response — this SDK
|
|
52775
|
-
* echoes the server's hash (memoized per client instance) rather than
|
|
52776
|
-
* trusting its own serialization.
|
|
52777
|
-
*
|
|
52778
|
-
* Unlike agents/flows, products have NO version snapshots: there is no
|
|
52779
|
-
* `release: 'publish'` option and no `versionId` on the result.
|
|
52780
|
-
*
|
|
52781
|
-
* The content hash is the canonical product hash (`computeProductContentHash` —
|
|
52782
|
-
* mirrored from `packages/shared/src/utils/product-content-hash.ts`; this
|
|
52783
|
-
* package is dependency-free by convention) over `{ description, icon, spec }`.
|
|
52784
|
-
* `name` is identity, not content, so it is excluded from the hash; `canvas` is
|
|
52785
|
-
* UI state and is excluded too.
|
|
52786
|
-
*
|
|
52787
|
-
* See docs/adr/0003-agent-config-as-code-ensure.md for the design rationale.
|
|
52788
|
-
*/
|
|
52789
|
-
|
|
52790
52567
|
/** Canonical normalized form of a product definition (name + canvas excluded). */
|
|
52791
52568
|
declare function normalizeProductDefinition(definition: ProductContentInput): {
|
|
52792
52569
|
description?: string;
|
|
@@ -52888,25 +52665,6 @@ declare class ProductDriftError extends Error {
|
|
|
52888
52665
|
constructor(plan: EnsureProductPlan);
|
|
52889
52666
|
}
|
|
52890
52667
|
|
|
52891
|
-
/**
|
|
52892
|
-
* SDK config-as-code converge for an entire Full Product Object (FPO).
|
|
52893
|
-
*
|
|
52894
|
-
* `products.ensureFpo` converges the whole nested product graph in one request
|
|
52895
|
-
* by POSTing the FPO to `POST /v1/products/ensure-fpo`, where the server fans
|
|
52896
|
-
* out to the per-entity ensure services. Unlike `products.ensure` (top-level
|
|
52897
|
-
* record only), there is no hash-only probe in this release: the full FPO is
|
|
52898
|
-
* always shipped and the server returns the canonical whole-FPO hash + a
|
|
52899
|
-
* per-entity report. (The hash-only fast-probe lands once the server persists a
|
|
52900
|
-
* per-product FPO hash — see the plan's PR3.)
|
|
52901
|
-
*
|
|
52902
|
-
* `computeFpoContentHash` is inlined here (the SDK avoids a `@runtypelabs/shared`
|
|
52903
|
-
* dependency) and pinned byte-for-byte against the canonical implementation by
|
|
52904
|
-
* the shared fixture corpus (`packages/shared/test-fixtures/fpo-content-hash/`)
|
|
52905
|
-
* asserted from BOTH packages. A normalization change in
|
|
52906
|
-
* `packages/shared/src/utils/fpo-content-hash.ts` MUST be mirrored here in the
|
|
52907
|
-
* same PR.
|
|
52908
|
-
*/
|
|
52909
|
-
|
|
52910
52668
|
/** An FPO for hashing/sending. Permissive — the server validates the rich contract. */
|
|
52911
52669
|
type FpoInput = Record<string, unknown>;
|
|
52912
52670
|
/**
|
|
@@ -52981,18 +52739,6 @@ declare function ensureFpo(client: RuntypeClient$1, fpo: FpoInput, options?: Ens
|
|
|
52981
52739
|
*/
|
|
52982
52740
|
declare function pullFpo(client: RuntypeClient$1, name: string): Promise<PullFpoResult>;
|
|
52983
52741
|
|
|
52984
|
-
/**
|
|
52985
|
-
* ProductsNamespace — config-as-code operations for products.
|
|
52986
|
-
*
|
|
52987
|
-
* `products.ensure` is the deploy-time, non-executing converge (create-or-update
|
|
52988
|
-
* a product by name + account scope); `products.pull` is the absorb-drift
|
|
52989
|
-
* direction. Both delegate to the implementation in `products-ensure.ts`.
|
|
52990
|
-
*
|
|
52991
|
-
* SCOPE (v1): the converge covers the top-level product record only
|
|
52992
|
-
* (description, icon, spec). Nested capabilities/surfaces/tools and the
|
|
52993
|
-
* `canvas` UI layout state are not converged.
|
|
52994
|
-
*/
|
|
52995
|
-
|
|
52996
52742
|
declare class ProductsNamespace {
|
|
52997
52743
|
private getClient;
|
|
52998
52744
|
constructor(getClient: () => RuntypeClient$1);
|
|
@@ -53059,38 +52805,6 @@ declare class ProductsNamespace {
|
|
|
53059
52805
|
pullFpo(name: string): Promise<PullFpoResult>;
|
|
53060
52806
|
}
|
|
53061
52807
|
|
|
53062
|
-
/**
|
|
53063
|
-
* Surface config-as-code: `defineSurface`, `surfaces.ensure`, `surfaces.pull`.
|
|
53064
|
-
*
|
|
53065
|
-
* The deploy-time convergence postcondition for product surfaces: "make the
|
|
53066
|
-
* platform's definition of this surface match this object; no-op if it already
|
|
53067
|
-
* does." Surfaces are PRODUCT-scoped: identity is (productId, name) — NOT
|
|
53068
|
-
* account scope. `ensure` never deletes, and renaming a definition orphans the
|
|
53069
|
-
* old surface and creates a new one.
|
|
53070
|
-
*
|
|
53071
|
-
* Wire protocol (POST /v1/products/{id}/surfaces/ensure — APQ-shaped, both APQ
|
|
53072
|
-
* scars fixed):
|
|
53073
|
-
* 1. Hash-only probe `{ name, contentHash }`. A match is
|
|
53074
|
-
* `{ result: 'unchanged' }`; a miss is a NORMAL 200
|
|
53075
|
-
* `{ result: 'definitionRequired' }`, never an error.
|
|
53076
|
-
* 2. On a miss, retry with the full `definition`. The server recomputes the
|
|
53077
|
-
* canonical hash itself and returns it on every response — this SDK echoes
|
|
53078
|
-
* the server's hash (memoized per client instance) rather than trusting
|
|
53079
|
-
* its own serialization.
|
|
53080
|
-
*
|
|
53081
|
-
* Unlike agents/flows, surfaces have NO version snapshots: there is no
|
|
53082
|
-
* `release: 'publish'` option and no `versionId` on the result.
|
|
53083
|
-
*
|
|
53084
|
-
* The content hash is the canonical surface hash (`computeSurfaceContentHash` —
|
|
53085
|
-
* mirrored from `packages/shared/src/utils/surface-content-hash.ts`; this
|
|
53086
|
-
* package is dependency-free by convention) over `{ type, behavior, status,
|
|
53087
|
-
* environment }`. `name` is identity, not content, so it is excluded; `inbound` /
|
|
53088
|
-
* `outbound` are also EXCLUDED — they carry sealed secrets that hash
|
|
53089
|
-
* non-deterministically against the stored row (see `normalizeSurfaceDefinition`).
|
|
53090
|
-
*
|
|
53091
|
-
* See docs/adr/0003-agent-config-as-code-ensure.md for the design rationale.
|
|
53092
|
-
*/
|
|
53093
|
-
|
|
53094
52808
|
/**
|
|
53095
52809
|
* Canonical normalized form of a surface definition (name excluded — identity).
|
|
53096
52810
|
* `inbound` / `outbound` are EXCLUDED — they carry sealed secrets that hash
|
|
@@ -53212,16 +52926,6 @@ declare class SurfaceDriftError extends Error {
|
|
|
53212
52926
|
constructor(plan: EnsureSurfacePlan);
|
|
53213
52927
|
}
|
|
53214
52928
|
|
|
53215
|
-
/**
|
|
53216
|
-
* SurfacesNamespace — config-as-code operations for product surfaces.
|
|
53217
|
-
*
|
|
53218
|
-
* `surfaces.ensure` is the deploy-time, non-executing converge (create-or-update
|
|
53219
|
-
* a surface by name within a product); `surfaces.pull` is the absorb-drift
|
|
53220
|
-
* direction. Both delegate to the implementation in `surfaces-ensure.ts`.
|
|
53221
|
-
*
|
|
53222
|
-
* Surfaces are PRODUCT-scoped: every operation takes the owning `productId`.
|
|
53223
|
-
*/
|
|
53224
|
-
|
|
53225
52929
|
declare class SurfacesNamespace {
|
|
53226
52930
|
private getClient;
|
|
53227
52931
|
constructor(getClient: () => RuntypeClient$1);
|
|
@@ -53254,49 +52958,6 @@ declare class SurfacesNamespace {
|
|
|
53254
52958
|
pull(productId: string, name: string): Promise<SurfacePullResult>;
|
|
53255
52959
|
}
|
|
53256
52960
|
|
|
53257
|
-
/**
|
|
53258
|
-
* Runtype - The unified SDK client for building and executing flows, batches, evals, and prompts
|
|
53259
|
-
*
|
|
53260
|
-
* Provides a fluent API with static namespaces for all product areas.
|
|
53261
|
-
*
|
|
53262
|
-
* @example
|
|
53263
|
-
* ```typescript
|
|
53264
|
-
* import { Runtype } from '@runtypelabs/sdk'
|
|
53265
|
-
*
|
|
53266
|
-
* // Global configuration (once per app)
|
|
53267
|
-
* Runtype.configure({ apiKey: process.env.RUNTYPE_API_KEY })
|
|
53268
|
-
*
|
|
53269
|
-
* // Build and stream a flow
|
|
53270
|
-
* const stream = await Runtype.flows.upsert({ name: 'My Flow' })
|
|
53271
|
-
* .withRecord({ name: 'Test', metadata: {} })
|
|
53272
|
-
* .prompt({ name: 'Analyze', model: 'gpt-4o', userPrompt: '...' })
|
|
53273
|
-
* .stream()
|
|
53274
|
-
*
|
|
53275
|
-
* // Get complete result
|
|
53276
|
-
* const result = await Runtype.flows.use('flow_123')
|
|
53277
|
-
* .withRecord({ name: 'Test' })
|
|
53278
|
-
* .result()
|
|
53279
|
-
*
|
|
53280
|
-
* // Schedule a batch
|
|
53281
|
-
* const batch = await Runtype.batches.schedule({
|
|
53282
|
-
* flowId: 'flow_123',
|
|
53283
|
-
* recordType: 'customers',
|
|
53284
|
-
* })
|
|
53285
|
-
*
|
|
53286
|
-
* // Run an eval with streaming
|
|
53287
|
-
* const evalStream = await Runtype.evals.run({
|
|
53288
|
-
* flowId: 'flow_123',
|
|
53289
|
-
* recordType: 'test_data',
|
|
53290
|
-
* models: [{ stepName: 'Analyze', model: 'gpt-4o' }]
|
|
53291
|
-
* }).stream()
|
|
53292
|
-
*
|
|
53293
|
-
* // Execute a prompt
|
|
53294
|
-
* const promptResult = await Runtype.prompts.run('prompt_123', {
|
|
53295
|
-
* recordId: 'rec_456'
|
|
53296
|
-
* }).result()
|
|
53297
|
-
* ```
|
|
53298
|
-
*/
|
|
53299
|
-
|
|
53300
52961
|
interface RuntypeConfig {
|
|
53301
52962
|
/** API key for authentication */
|
|
53302
52963
|
apiKey?: string;
|
|
@@ -53384,9 +53045,46 @@ declare class RuntypeClient$1 {
|
|
|
53384
53045
|
private transformResponse;
|
|
53385
53046
|
}
|
|
53386
53047
|
/**
|
|
53387
|
-
* Runtype -
|
|
53048
|
+
* Runtype - The unified SDK client for building and executing flows, batches, evals, and prompts.
|
|
53049
|
+
*
|
|
53050
|
+
* Provides a fluent API with static namespaces for all product areas.
|
|
53051
|
+
*
|
|
53052
|
+
* @example
|
|
53053
|
+
* ```typescript
|
|
53054
|
+
* import { Runtype } from '@runtypelabs/sdk'
|
|
53055
|
+
*
|
|
53056
|
+
* // Global configuration (once per app)
|
|
53057
|
+
* Runtype.configure({ apiKey: process.env.RUNTYPE_API_KEY })
|
|
53058
|
+
*
|
|
53059
|
+
* // Build and stream a flow
|
|
53060
|
+
* const stream = await Runtype.flows.upsert({ name: 'My Flow' })
|
|
53061
|
+
* .withRecord({ name: 'Test', metadata: {} })
|
|
53062
|
+
* .prompt({ name: 'Analyze', model: 'gpt-4o', userPrompt: '...' })
|
|
53063
|
+
* .stream()
|
|
53388
53064
|
*
|
|
53389
|
-
*
|
|
53065
|
+
* // Get complete result
|
|
53066
|
+
* const result = await Runtype.flows.use('flow_123')
|
|
53067
|
+
* .withRecord({ name: 'Test' })
|
|
53068
|
+
* .result()
|
|
53069
|
+
*
|
|
53070
|
+
* // Schedule a batch
|
|
53071
|
+
* const batch = await Runtype.batches.schedule({
|
|
53072
|
+
* flowId: 'flow_123',
|
|
53073
|
+
* recordType: 'customers',
|
|
53074
|
+
* })
|
|
53075
|
+
*
|
|
53076
|
+
* // Run an eval with streaming
|
|
53077
|
+
* const evalStream = await Runtype.evals.run({
|
|
53078
|
+
* flowId: 'flow_123',
|
|
53079
|
+
* recordType: 'test_data',
|
|
53080
|
+
* models: [{ stepName: 'Analyze', model: 'gpt-4o' }]
|
|
53081
|
+
* }).stream()
|
|
53082
|
+
*
|
|
53083
|
+
* // Execute a prompt
|
|
53084
|
+
* const promptResult = await Runtype.prompts.run('prompt_123', {
|
|
53085
|
+
* recordId: 'rec_456'
|
|
53086
|
+
* }).result()
|
|
53087
|
+
* ```
|
|
53390
53088
|
*/
|
|
53391
53089
|
declare class Runtype {
|
|
53392
53090
|
/**
|
|
@@ -54168,15 +53866,6 @@ type TypedCreateRecordRequest<S extends string> = Omit<CreateRecordRequest, 'typ
|
|
|
54168
53866
|
metadata?: CollectionMeta<S>;
|
|
54169
53867
|
};
|
|
54170
53868
|
|
|
54171
|
-
/**
|
|
54172
|
-
* Pluggable workflow architecture for marathon task execution.
|
|
54173
|
-
*
|
|
54174
|
-
* A WorkflowDefinition describes the phases an agent goes through
|
|
54175
|
-
* (e.g. research → planning → execution) and the rules for each phase.
|
|
54176
|
-
* The default implementation mirrors the existing hardcoded behavior;
|
|
54177
|
-
* consumers can supply custom workflows for different strategies (TDD, etc.).
|
|
54178
|
-
*/
|
|
54179
|
-
|
|
54180
53869
|
interface RunTaskStateSlice {
|
|
54181
53870
|
agentId: string;
|
|
54182
53871
|
taskName: string;
|
|
@@ -54318,10 +54007,6 @@ interface WorkflowDefinition {
|
|
|
54318
54007
|
buildCandidateBlock?: (state: RunTaskStateSlice) => string;
|
|
54319
54008
|
}
|
|
54320
54009
|
|
|
54321
|
-
/**
|
|
54322
|
-
* API endpoint handlers with automatic camelCase/snake_case transformation
|
|
54323
|
-
*/
|
|
54324
|
-
|
|
54325
54010
|
interface ApiClient {
|
|
54326
54011
|
get<T>(path: string, params?: {
|
|
54327
54012
|
[key: string]: any;
|
|
@@ -55537,7 +55222,7 @@ interface AgentMediaEvent extends BaseAgentEvent {
|
|
|
55537
55222
|
*
|
|
55538
55223
|
* Local SDK copy of `ExternalAgentContext` from `@runtypelabs/shared`'s
|
|
55539
55224
|
* `sse-parser.ts`. The SDK has zero production dependencies and
|
|
55540
|
-
* re-derives wire types by design (
|
|
55225
|
+
* re-derives wire types by design (see
|
|
55541
55226
|
* `docs/features/shipped/2026-02-25-user-cloud-deployment.md`). Keep
|
|
55542
55227
|
* the shape identical to `@runtypelabs/shared`'s `ExternalAgentContext`.
|
|
55543
55228
|
*/
|
|
@@ -55572,7 +55257,7 @@ interface AgentElicitationRequest {
|
|
|
55572
55257
|
*
|
|
55573
55258
|
* Local SDK copy of `unifiedElicitationSchema` from `@runtypelabs/shared`'s
|
|
55574
55259
|
* `unified-sse-event-schemas.ts`. The SDK has zero production dependencies and
|
|
55575
|
-
* re-derives wire types by design
|
|
55260
|
+
* re-derives wire types by design. Keep the shape identical.
|
|
55576
55261
|
*/
|
|
55577
55262
|
interface AgentElicitation {
|
|
55578
55263
|
/** `form` answers with text; `url` sends the human to {@link url} first. */
|
|
@@ -55669,7 +55354,7 @@ interface AgentCompleteEvent extends BaseAgentEvent {
|
|
|
55669
55354
|
agentId: string;
|
|
55670
55355
|
success: boolean;
|
|
55671
55356
|
iterations: number;
|
|
55672
|
-
stopReason: 'complete' | 'end_turn' | 'max_turns' | 'max_cost' | 'timeout' | 'error';
|
|
55357
|
+
stopReason: 'complete' | 'end_turn' | 'max_turns' | 'max_cost' | 'timeout' | 'error' | 'length';
|
|
55673
55358
|
completedAt: string;
|
|
55674
55359
|
totalCost?: number;
|
|
55675
55360
|
totalTokens?: {
|
|
@@ -55962,7 +55647,7 @@ interface AgentExecuteResponse {
|
|
|
55962
55647
|
input: number;
|
|
55963
55648
|
output: number;
|
|
55964
55649
|
};
|
|
55965
|
-
stopReason: 'complete' | 'end_turn' | 'max_turns' | 'max_cost' | 'timeout' | 'error' | 'paused';
|
|
55650
|
+
stopReason: 'complete' | 'end_turn' | 'max_turns' | 'max_cost' | 'timeout' | 'error' | 'paused' | 'length';
|
|
55966
55651
|
reflections?: string[];
|
|
55967
55652
|
error?: string;
|
|
55968
55653
|
/**
|
|
@@ -56944,7 +56629,7 @@ declare class AgentVersionsEndpoint {
|
|
|
56944
56629
|
/**
|
|
56945
56630
|
* Publish a version (promote it to the agent's published version).
|
|
56946
56631
|
*/
|
|
56947
|
-
publish(agentId: string, versionId: string): Promise<AgentVersionPublishResponse>;
|
|
56632
|
+
publish(agentId: string, versionId: string, options?: VersionPublishOptions): Promise<AgentVersionPublishResponse>;
|
|
56948
56633
|
}
|
|
56949
56634
|
/**
|
|
56950
56635
|
* Flow Versions endpoint handlers
|
|
@@ -56972,7 +56657,7 @@ declare class FlowVersionsEndpoint {
|
|
|
56972
56657
|
/**
|
|
56973
56658
|
* Publish a version (promote it to the flow's published version).
|
|
56974
56659
|
*/
|
|
56975
|
-
publish(flowId: string, versionId: string): Promise<FlowVersionPublishResponse>;
|
|
56660
|
+
publish(flowId: string, versionId: string, options?: VersionPublishOptions): Promise<FlowVersionPublishResponse>;
|
|
56976
56661
|
}
|
|
56977
56662
|
/**
|
|
56978
56663
|
* Integrations endpoint handlers
|
|
@@ -57111,18 +56796,6 @@ declare class ToolApprovalGrantsEndpoint {
|
|
|
57111
56796
|
}>;
|
|
57112
56797
|
}
|
|
57113
56798
|
|
|
57114
|
-
/**
|
|
57115
|
-
* @layer sdk
|
|
57116
|
-
* @case camelCase (SDK and API both use native camelCase - no conversion needed)
|
|
57117
|
-
*
|
|
57118
|
-
* Main Runtype API Client.
|
|
57119
|
-
*
|
|
57120
|
-
* The SDK and API both use native camelCase for all request/response bodies.
|
|
57121
|
-
* No case transformation is performed.
|
|
57122
|
-
*
|
|
57123
|
-
* @see packages/client/src/transform.ts for pass-through utilities
|
|
57124
|
-
*/
|
|
57125
|
-
|
|
57126
56799
|
type LocalToolHandler = (args: unknown) => Promise<unknown>;
|
|
57127
56800
|
/**
|
|
57128
56801
|
* Richer local tool entry that pairs a handler with the wire schema the
|
|
@@ -57404,44 +57077,6 @@ declare function parseOffloadedOutputId(value: string): string | undefined;
|
|
|
57404
57077
|
/** Parse the tree-log-relative artifact path out of a ledger offload reference. */
|
|
57405
57078
|
declare function parseLedgerArtifactRelativePath(value: string): string | undefined;
|
|
57406
57079
|
|
|
57407
|
-
/**
|
|
57408
|
-
* Unified wire → stable SDK callback adapter (the client-side mirror of the api's
|
|
57409
|
-
* `apps/api/src/lib/unified-event-stream.ts`).
|
|
57410
|
-
*
|
|
57411
|
-
* As of the unified-SSE cutover (runtypelabs/core unified-sse-default) the
|
|
57412
|
-
* execution streams the SDK consumes — `/dispatch`, `/dispatch/resume`,
|
|
57413
|
-
* `/agents/{id}/execute`, `/agents/{id}/resume` — use the 35-event unified
|
|
57414
|
-
* vocabulary (`unifiedSSEEventSchema` in `@runtypelabs/shared`). The SDK
|
|
57415
|
-
* translates those frames back into its stable, hand-written callback shapes
|
|
57416
|
-
* here.
|
|
57417
|
-
*
|
|
57418
|
-
* Why translate instead of rewriting every consumer switch: the SDK's public
|
|
57419
|
-
* callback contracts (`StreamCallbacks`, `AgentStreamCallbacks`) and their event
|
|
57420
|
-
* types are part of the published surface. Reversing the wire at the parse
|
|
57421
|
-
* boundary moves the SDK onto the unified format on the wire while keeping that
|
|
57422
|
-
* surface byte-stable for downstream consumers. The translation is the inverse
|
|
57423
|
-
* of the api edge translator's mapping table
|
|
57424
|
-
* (`docs/features/planning/2026-06-16-persona-sse-event-merged-spec.md`).
|
|
57425
|
-
*
|
|
57426
|
-
* Scope: only the events the SDK's consumers actually read are reconstructed;
|
|
57427
|
-
* everything else (artifact channel, `source`, the `state_snapshot` /
|
|
57428
|
-
* `state_delta` agent-state channel, `custom`, fallback live-beat, `step_skip`)
|
|
57429
|
-
* maps to zero callback events. The state channel is recognized as unified
|
|
57430
|
-
* vocabulary (so `isUnifiedEventType` is true and the wire union stays exhaustive)
|
|
57431
|
-
* but has no stable SDK callback shape to project onto; surfacing it to the SDK
|
|
57432
|
-
* callback surface is a separate additive slice, not a wire-translation concern.
|
|
57433
|
-
* Two unified-contract folds are NOT reconstructed because the unified
|
|
57434
|
-
* vocabulary deliberately discards them:
|
|
57435
|
-
* - `agent_iteration_start` / `agent_iteration_complete` are folded into the
|
|
57436
|
-
* `iteration` field on turn/tool frames, so `onIterationStart` /
|
|
57437
|
-
* `onIterationComplete` no longer fire.
|
|
57438
|
-
* - the additive `fallback` summary on `step_complete` / `turn_complete` is
|
|
57439
|
-
* dropped (the SDK callback surface never consumed `fallback_*` events).
|
|
57440
|
-
*
|
|
57441
|
-
* Each translator is STATEFUL (channel block ids, current step/turn/iteration,
|
|
57442
|
-
* media accumulation) and therefore must be constructed once PER STREAM — never
|
|
57443
|
-
* shared across executions.
|
|
57444
|
-
*/
|
|
57445
57080
|
type Json = Record<string, unknown>;
|
|
57446
57081
|
/**
|
|
57447
57082
|
* @deprecated Unified events are now the only public execution-stream format.
|
|
@@ -57587,41 +57222,6 @@ declare class ClientBatchBuilder extends BatchBuilder {
|
|
|
57587
57222
|
run(): Promise<BatchResult>;
|
|
57588
57223
|
}
|
|
57589
57224
|
|
|
57590
|
-
/**
|
|
57591
|
-
* EvalBuilder - Fluent builder for evaluation runs
|
|
57592
|
-
*
|
|
57593
|
-
* Provides a chainable API for building evaluation configurations
|
|
57594
|
-
* that test flows against records with model overrides and comparisons.
|
|
57595
|
-
*
|
|
57596
|
-
* @example
|
|
57597
|
-
* ```typescript
|
|
57598
|
-
* import { EvalBuilder } from '@runtypelabs/sdk'
|
|
57599
|
-
*
|
|
57600
|
-
* // Single model eval with overrides
|
|
57601
|
-
* const eval1 = await new EvalBuilder()
|
|
57602
|
-
* .useFlow('flow_abc123')
|
|
57603
|
-
* .forRecordType('test_data')
|
|
57604
|
-
* .withModelOverrides([{ stepName: 'Analyze', model: 'gpt-4o' }])
|
|
57605
|
-
* .run(apiClient)
|
|
57606
|
-
*
|
|
57607
|
-
* // Multi-model comparison
|
|
57608
|
-
* const eval2 = await new EvalBuilder()
|
|
57609
|
-
* .useFlow('flow_abc123')
|
|
57610
|
-
* .forRecordType('test_data')
|
|
57611
|
-
* .compareModels([
|
|
57612
|
-
* { stepName: 'Analyze', model: 'gpt-5.4' },
|
|
57613
|
-
* { stepName: 'Analyze', model: 'claude-opus-4-6' },
|
|
57614
|
-
* ])
|
|
57615
|
-
* .run(apiClient)
|
|
57616
|
-
*
|
|
57617
|
-
* // Virtual flow eval
|
|
57618
|
-
* const eval3 = await new EvalBuilder()
|
|
57619
|
-
* .useVirtualFlow(flowBuilder)
|
|
57620
|
-
* .forRecordType('test_data')
|
|
57621
|
-
* .run(apiClient)
|
|
57622
|
-
* ```
|
|
57623
|
-
*/
|
|
57624
|
-
|
|
57625
57225
|
interface ModelOverride {
|
|
57626
57226
|
/** Name of the step to override */
|
|
57627
57227
|
stepName: string;
|
|
@@ -57813,16 +57413,6 @@ declare class ClientEvalBuilder extends EvalBuilder {
|
|
|
57813
57413
|
run(): Promise<EvalResult>;
|
|
57814
57414
|
}
|
|
57815
57415
|
|
|
57816
|
-
/**
|
|
57817
|
-
* SDK Code Generation Metadata
|
|
57818
|
-
*
|
|
57819
|
-
* Type-safe field registry for generating SDK code from flow step configs.
|
|
57820
|
-
* Co-located with the step config interfaces so that adding or removing a
|
|
57821
|
-
* field on any config interface produces a compile error here, preventing
|
|
57822
|
-
* silent drift between the SDK and downstream code generators (e.g. the
|
|
57823
|
-
* dashboard's sdk-code-generator.ts).
|
|
57824
|
-
*/
|
|
57825
|
-
|
|
57826
57416
|
/** How to serialize a field value into TypeScript source code. */
|
|
57827
57417
|
type FieldFormat = 'json' | 'template' | 'raw' | 'value';
|
|
57828
57418
|
/** Describes one field in a step config for code emission. */
|
|
@@ -58538,20 +58128,6 @@ declare const STEP_TYPE_TO_METHOD: {
|
|
|
58538
58128
|
readonly 'memory-summary': "memorySummary";
|
|
58539
58129
|
};
|
|
58540
58130
|
|
|
58541
|
-
/**
|
|
58542
|
-
* Named workflow hook registry.
|
|
58543
|
-
*
|
|
58544
|
-
* Workflow configs (the data form compiled by `compileWorkflowConfig`) can
|
|
58545
|
-
* reference behavior by name instead of carrying functions: `builtin:*` names
|
|
58546
|
-
* are reserved for the hooks that power the default workflow, and consumers
|
|
58547
|
-
* register their own under a custom namespace (e.g. `acme:my-completion`).
|
|
58548
|
-
*
|
|
58549
|
-
* Every hook declares which SLOT KIND it implements so a config that wires a
|
|
58550
|
-
* hook into the wrong slot fails at load/compile time with an actionable
|
|
58551
|
-
* error — not mid-marathon. Hook misfires in this system don't crash, they
|
|
58552
|
-
* stall, which is the worst failure mode to debug.
|
|
58553
|
-
*/
|
|
58554
|
-
|
|
58555
58131
|
interface WorkflowHookSignatures {
|
|
58556
58132
|
/** WorkflowPhase.buildInstructions — used verbatim (no header is added) */
|
|
58557
58133
|
instructions: (state: RunTaskStateSlice) => string;
|
|
@@ -58605,27 +58181,6 @@ declare function listWorkflowHooks(): Array<{
|
|
|
58605
58181
|
/** Test seam: remove a custom hook (builtin entries cannot be removed). */
|
|
58606
58182
|
declare function unregisterWorkflowHook(name: string): boolean;
|
|
58607
58183
|
|
|
58608
|
-
/**
|
|
58609
|
-
* Declarative workflow configs and the compiler that turns them into a
|
|
58610
|
-
* `WorkflowDefinition`.
|
|
58611
|
-
*
|
|
58612
|
-
* This is the single compile path for marathon workflows-as-data: the CLI
|
|
58613
|
-
* playbook loader parses YAML/JSON into a `WorkflowConfig` and delegates here,
|
|
58614
|
-
* and the shipped default workflow is itself a `WorkflowConfig`
|
|
58615
|
-
* (`defaultWorkflowConfig` in default-workflow.ts) compiled through the same
|
|
58616
|
-
* function — so playbooks and the default cannot drift in semantics.
|
|
58617
|
-
*
|
|
58618
|
-
* Each behavior slot accepts either INLINE DATA (strings, declarative
|
|
58619
|
-
* criteria, policy rules) or a HOOK REFERENCE (`"<namespace>:<id>"`, see
|
|
58620
|
-
* hook-registry.ts) resolved against the registry with slot-kind validation
|
|
58621
|
-
* at compile time.
|
|
58622
|
-
*
|
|
58623
|
-
* The compiler is environment-free: no fs, no YAML, no glob library. Glob
|
|
58624
|
-
* matching for policy rules is injected via `WorkflowCompileDeps` (the CLI
|
|
58625
|
-
* passes micromatch); configs that use glob policies without a matcher fail
|
|
58626
|
-
* at compile time with an actionable error.
|
|
58627
|
-
*/
|
|
58628
|
-
|
|
58629
58184
|
declare const DEFAULT_RECOVERY_AFTER_EMPTY_SESSIONS = 2;
|
|
58630
58185
|
/** A `"<namespace>:<id>"` reference into the workflow hook registry. */
|
|
58631
58186
|
type WorkflowHookRef = string;
|
|
@@ -58770,14 +58325,6 @@ declare function buildPolicyGuidance(policy?: WorkflowPolicyConfig): string[];
|
|
|
58770
58325
|
*/
|
|
58771
58326
|
declare function compileWorkflowConfig(config: WorkflowConfig, deps?: WorkflowCompileDeps): WorkflowDefinition;
|
|
58772
58327
|
|
|
58773
|
-
/**
|
|
58774
|
-
* Default marathon workflow: research → planning → execution.
|
|
58775
|
-
*
|
|
58776
|
-
* This is a data-driven extraction of the previously hardcoded logic
|
|
58777
|
-
* in AgentsEndpoint. It handles both "modify" and "create" task variants
|
|
58778
|
-
* via the `workflowVariant` / `isCreationTask` flags on state.
|
|
58779
|
-
*/
|
|
58780
|
-
|
|
58781
58328
|
/**
|
|
58782
58329
|
* Register the default workflow's behaviors as `builtin:*` hooks. Idempotent.
|
|
58783
58330
|
* Importing this module (or anything that pulls in `defaultWorkflow`) calls it
|
|
@@ -58797,58 +58344,10 @@ declare function ensureDefaultWorkflowHooks(): void;
|
|
|
58797
58344
|
declare const defaultWorkflowConfig: WorkflowConfig;
|
|
58798
58345
|
declare const defaultWorkflow: WorkflowDefinition;
|
|
58799
58346
|
|
|
58800
|
-
/**
|
|
58801
|
-
* Deploy workflow: scaffold → deploy.
|
|
58802
|
-
*
|
|
58803
|
-
* A streamlined two-phase workflow for tasks where the goal is to build
|
|
58804
|
-
* code and deploy it to a sandbox with a live preview URL, rather than
|
|
58805
|
-
* editing files in the local repository.
|
|
58806
|
-
*
|
|
58807
|
-
* Phase 1 (scaffold): Understand what the user wants built. Quick —
|
|
58808
|
-
* auto-advances after the agent has acknowledged the task.
|
|
58809
|
-
*
|
|
58810
|
-
* Phase 2 (deploy): Write code and call deploy_sandbox to get a live
|
|
58811
|
-
* preview URL. Iterate on errors until the deployment succeeds.
|
|
58812
|
-
*/
|
|
58813
|
-
|
|
58814
58347
|
declare const deployWorkflow: WorkflowDefinition;
|
|
58815
58348
|
|
|
58816
|
-
/**
|
|
58817
|
-
* Game workflow: design → build → verify.
|
|
58818
|
-
*
|
|
58819
|
-
* A three-phase workflow for tasks where the goal is to build a game
|
|
58820
|
-
* (Three.js, Phaser, WebGL, etc.) and deploy it to a Daytona sandbox.
|
|
58821
|
-
*
|
|
58822
|
-
* The key difference from the deploy workflow is that game code often
|
|
58823
|
-
* uses template literals, which break when embedded inside Express
|
|
58824
|
-
* `res.send()` template literals. This workflow instructs the agent to
|
|
58825
|
-
* use the `files` parameter for multi-file deployment (Express static
|
|
58826
|
-
* server + separate HTML/JS/CSS files).
|
|
58827
|
-
*
|
|
58828
|
-
* Phase 1 (design): Understand game requirements. Auto-advances after
|
|
58829
|
-
* the first session.
|
|
58830
|
-
*
|
|
58831
|
-
* Phase 2 (build): Write game code using multi-file deployment. The
|
|
58832
|
-
* agent uses `code` for a minimal Express static server and `files`
|
|
58833
|
-
* for the actual game assets (HTML, JS, CSS).
|
|
58834
|
-
*
|
|
58835
|
-
* Phase 3 (verify): Confirm the game is running and playable. Auto-
|
|
58836
|
-
* accepts completion when deploy_sandbox has succeeded.
|
|
58837
|
-
*/
|
|
58838
|
-
|
|
58839
58349
|
declare const gameWorkflow: WorkflowDefinition;
|
|
58840
58350
|
|
|
58841
|
-
/**
|
|
58842
|
-
* Helpers for WorkflowDefinition.stallPolicy: what happens when an agent
|
|
58843
|
-
* produces consecutive sessions with no tool actions.
|
|
58844
|
-
*
|
|
58845
|
-
* All thresholds count the run-level `consecutiveEmptySessions` counter (a
|
|
58846
|
-
* session is empty when it performed no write/read/discovery/verification
|
|
58847
|
-
* tool action), so narration-only sessions escalate here even though they
|
|
58848
|
-
* carry text output. Absent policy values preserve the legacy behavior:
|
|
58849
|
-
* no nudge, no escalation signal, stop after 3.
|
|
58850
|
-
*/
|
|
58851
|
-
|
|
58852
58351
|
declare const DEFAULT_STALL_STOP_AFTER = 3;
|
|
58853
58352
|
/** Resolve how many consecutive empty sessions end the run as 'stalled'. */
|
|
58854
58353
|
declare function resolveStallStopAfter(policy?: WorkflowStallPolicy): number;
|
|
@@ -58885,4 +58384,4 @@ declare function getLikelySupportingCandidatePaths(bestCandidatePath: string | u
|
|
|
58885
58384
|
declare function getDefaultPlanPath(taskName: string): string;
|
|
58886
58385
|
declare function sanitizeTaskSlug(taskName: string): string;
|
|
58887
58386
|
|
|
58888
|
-
export { type AIGrader, type Agent, type AgentAdmissionOptions, type AgentApprovalCompleteEvent, type AgentApprovalStartEvent, type AgentCompleteEvent, type AgentDefinition, type AgentDefinitionConfig, AgentDriftError, type AgentElicitation, type AgentElicitationRequest, AgentEnsureConflictError, type AgentErrorEvent, type AgentEvent, type AgentEventType, type AgentExecuteRequest, type AgentExecuteResponse, type AgentIterationCompleteEvent, type AgentIterationStartEvent, type AgentMediaEvent, type AgentMessage, type AgentPausedEvent, type AgentPingEvent, type AgentPullResult, type AgentReflectionEvent, type AgentRuntimeToolDefinition, type AgentStartEvent, type AgentStreamCallbacks, type AgentStreamEvent, type AgentSubagentConfig, type AgentToolCompleteEvent, type AgentToolDeltaEvent, type AgentToolInputCompleteEvent, type AgentToolInputDeltaEvent, type AgentToolStartEvent, type AgentTurnCompleteEvent, type AgentTurnDeltaEvent, type AgentTurnStartEvent, type AgentVersionDetail, type AgentVersionListItem, type AgentVersionPublishResponse, AgentVersionsEndpoint, type AgentVersionsListResponse, AgentsEndpoint, AgentsNamespace, AnalyticsEndpoint, type ApiClient, type ApiKey, type ApiKeyRequest, type ApiKeyRequestDelivery, type ApiKeyRequestEnvironment, type ApiKeyRequestHandoff, type ApiKeyRequestListParams, type ApiKeyRequestRequester, type ApiKeyRequestStatus, ApiKeyRequestsEndpoint, ApiKeysEndpoint, type ApiResponse, type ApplyGeneratedProposalOptions, type ApplyGeneratedProposalResult, type AssetReferenceContentPart, type AsyncExecutionHandle, type AsyncExecutionStatus, type AttachRuntimeToolsOptions, type BaseAgentEvent, BatchBuilder, type BatchClient, type BatchListParams, type BatchOptions, type BatchRequest, type BatchResult, type BatchScheduleConfig, type BatchStatus, BatchesNamespace, BillingEndpoint, type BillingSpendAnalyticsParams, type BindSkillInput, type BuiltInGraderId, type BuiltInTool, type BulkEditCondition, type BulkEditRequest, type BulkEditResponse, type BulkEditResult, type CanonicalDispatchMessageContent, type CanonicalDispatchRequest, type CaseExpected, type CatalogClientToolRef, ChatEndpoint, type CheckGrader, type ClaimApiKeyRequestInput, type ClaimApiKeyRequestResponse, type ClaudeManagedEvalOverrideValues, ClientBatchBuilder, type ClientConfig, type ClientConversation, ClientEvalBuilder, ClientFlowBuilder, type ClientToken, type ClientTokenConfig, type ClientTokenEnvironment, type ClientTokenVersionPin, ClientTokensEndpoint, type ClientToolDefinition, type ClientToolEntry, type ClientWidgetTheme, type CollectionMeta, CollectionsEndpoint, type ConditionalGetResult, type ConditionalStepConfig$1 as ConditionalStepConfig, type ContextErrorHandling, type ContextFallback, ContextTemplatesEndpoint, type Conversation, type ConversationListItem, type ConversationListParams, type ConversationMessage, type ConversationSource, ConversationsEndpoint, type ConversationsListResponse, type CreateApiKeyRequest, type CreateApiKeyRequestInput, type CreateApiKeyRequestResponse, type CreateClientTokenRequest, type CreateClientTokenResponse, type CreateCollectionRequest, type CreateConversationRequest, type CreateEvalSuiteInput, type CreateFlowRequest, type CreateModelConfigRequest, type CreatePromptData, type CreatePromptRequest, type CreateProviderKeyRequest, type CreateRecordRequest, type CreateScheduleRequest, type CreateSecretRequest, type CreateToolRequest, type CurrentBilledSpendResponse, type CurrentBilledSpendSource, type CustomMCPServer, type CustomMCPServerAuth, type CustomToolConfig, DEFAULT_MAX_DETACHED_RECONNECTS, DEFAULT_RECOVERY_AFTER_EMPTY_SESSIONS, DEFAULT_STALL_STOP_AFTER, type DecomposeCriteriaResult, type DefineAgentInput, type DefineEvalCaseInput, type DefineEvalInput, type DefineFlowInput, type DefineProductInput, type DefineSkillInput, type DefineSurfaceInput, type DefineToolInput, type DeployCfSandboxRequest, type DeployCfSandboxResponse, type DeploySandboxRequest, type DeploySandboxResponse, type DetachedReattach, type DetachedReconnectOptions, type DiscoveredModel, type DispatchAgentInput, type DispatchApprovalContinuationResponse, type DispatchApproveRequest, type DispatchApproveResponse, type DispatchClient, type DispatchContinuationRequest, type DispatchContinuationResponse, type DispatchDetachedApprovalResponse, DispatchEndpoint, type DispatchEnvironment, type DispatchEvent, type DispatchFlowInput, type DispatchMessageContent, type DispatchOptions$1 as DispatchOptions, type DispatchRequest, type DispatchResponse, type DispatchResumeRequest, type DispatchResumeResponse, type EndUserUsageQuery, type EndUserUsageResponse, type EnsureAgentConverged, type EnsureAgentOptions, type EnsureAgentPlan, type EnsureAgentResult, type EnsureEvalResult, type EnsureFlowConverged, type EnsureFlowOptions, type EnsureFlowPlan, type EnsureFlowResult, type EnsureFpoOptions, type EnsureFpoResult, type EnsureProductConverged, type EnsureProductOptions, type EnsureProductPlan, type EnsureProductResult, type EnsureSkillConverged, type EnsureSkillOptions, type EnsureSkillPlan, type EnsureSkillResult, type EnsureSurfaceConverged, type EnsureSurfaceOptions, type EnsureSurfacePlan, type EnsureSurfaceResult, type EnsureToolConverged, type EnsureToolOptions, type EnsureToolPlan, type EnsureToolResult, type ErrorHandlingMode, EvalBuilder, type EvalCaseDefinition, type EvalCaseInput, type EvalCaseProposal, type EvalCaseProposalAccepted, type EvalCaseProposalListResult, type EvalCasesGenerated, type EvalClient, type EvalDefinition, EvalEndpoint, type EvalListParams, type EvalMessage, type EvalOptions, type EvalOverrideValues, type EvalProposalSource, type EvalProposalStatus, type EvalProposedCase, type EvalPullResult, type EvalRecord, type EvalRequest, type EvalResult, type EvalRunCaseScores, type EvalRunConfig, type EvalRunScores, EvalRunner, type EvalStatus, type EvalSuiteCase, type EvalSuiteCaseInput, type EvalSuiteCoverage, type EvalSuiteDetail, type EvalSuiteLatestRun, type EvalSuiteListResult, type EvalSuiteRunQueued, type EvalSuiteRunResult, type EvalSuiteSummary, EvalSuitesNamespace, type EvalTarget, EvalsNamespace, type ExecuteToolRequest, type ExecuteToolResponse, type ExecutionStreamEvent, ExecutionsEndpoint, ExecutionsNamespace, type ExternalAgentContext, type ExternalToolConfig, type FallbackFailEvent, type FallbackStartEvent, type FallbackSuccessEvent, type FallbackTrigger, type FallbackTriggerType, type FallbacksExhaustedEvent, type FallbacksInitiatedEvent, type FetchUrlStepConfig$1 as FetchUrlStepConfig, type FieldFormat, type FileContentPart, type Flow, type FlowAttachment, FlowBuilder, type FlowCompleteEvent, type FlowConfig$1 as FlowConfig, type FlowDefinition, type FlowDefinitionStep, FlowDriftError, FlowEnsureConflictError, type FlowErrorEvent, type FlowFallback, type FlowInlineEvalInput, type FlowListItem, type FlowPausedEvent, type FlowPullResult, FlowResult, type FlowStartEvent, type FlowStep, type FlowStepDefinition, type FlowStepType, FlowStepsEndpoint, type FlowStreamEvent, type FlowSummary, type FlowToolConfig, type FlowValidationClient, type FlowValidationIssue, type FlowValidationResult, type FlowVersionDetail, type FlowVersionListItem, type FlowVersionPublishResponse, FlowVersionsEndpoint, type FlowVersionsListResponse, FlowsEndpoint, FlowsNamespace, type FpoEntityOutcome, type FpoInput, type GenerateEmbeddingStepConfig$1 as GenerateEmbeddingStepConfig, type GenerateEvalCasesInput, type GeneratedRuntimeToolGateDecision, type GeneratedRuntimeToolGateOptions, type GetApiKeyRequestResponse, type GetRecordStepConfig$1 as GetRecordStepConfig, type Gradeable, type GraderConfig, type GraderOutcome, type GraderSeverity, type HumanVerdict, type ImageContentPart, type InferCollectionSchemaResponse, type Integration, type IntegrationTool, IntegrationsEndpoint, type IntegrationsListResponse, type JSONSchema, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, LEDGER_ARTIFACT_LINE_PREFIX, type ListCollectionsResponse, type ListConversationsResponse, type ListParams, type ListRecordsStepConfig$1 as ListRecordsStepConfig, type LocalToolConfig, type LocalToolDefinition, type LocalToolExecutionCompleteEvent, type LocalToolExecutionLoopSnapshotSlice, type LocalToolExecutionStartEvent, type LogEntry, type LogQueryParams, type LogQueryResponse, type LogQueryResult, type LogStatsParams, type LogStatsResponse, type LogStatsResult, LogsEndpoint, type LoopStepConfig$1 as LoopStepConfig, type Message$1 as Message, type MessageContent, type MessageFallback, type Metadata, type ModelConfig, ModelConfigsEndpoint, type ModelFallback, type ModelOverride, type ModelUsageDetail, type ModelUsageQueryParams, type ModelUsageResponse, type ModelUsageSummary, type ModelUsageTimeSeries, type PaginationResponse, type PersistedGraderOutcome, type ProductDefinition, ProductDriftError, ProductEnsureConflictError, type ProductPullResult, ProductsNamespace, type Prompt$1 as Prompt, type PromptErrorHandling, type PromptFallback, type PromptListParams, type PromptStepConfig$1 as PromptStepConfig, PromptsEndpoint, PromptsNamespace, type ProviderApiKey, type ProviderKeyModel, ProviderKeysEndpoint, type PullFpoResult, RUNTYPE_CLIENT_KIND, type ReasoningConfig, type ReasoningContentPart, type ReasoningValue, type RecordCollection, type RecordCollectionWithHistory, type RecordCollections, type RecordConfig$1 as RecordConfig, type RecordCostAggregation, type RecordCostModelBreakdown, type RecordFilter, type RecordFilterCondition, type RecordFilterGroup, type RecordFilterOperator, type RecordListItem, type RecordListParams, type RecordStepResult, type RecordStepResultsParams, type RecordStepResultsResponse, type RecordWriteResponse, RecordsEndpoint, type RetrieveRecordStepConfig$1 as RetrieveRecordStepConfig, type RetryFallback, type RunEvalCaseResult, type RunEvalInput, type RunEvalResult, type RunTaskContextBudgetBreakdown, type RunTaskContextCompactionEvent, type RunTaskContextCompactionStrategy, type RunTaskContextNoticeEvent, type RunTaskContextSummaryEntry, type RunTaskContinuation, type RunTaskOffloadRecorder, type RunTaskOnContextCompaction, type RunTaskOnContextNotice, type RunTaskOnSession, type RunTaskOptions, type RunTaskResult, type RunTaskResumeState, type RunTaskSessionSummary, type RunTaskState, type RunTaskStateSlice, type RunTaskStatus, type RunTaskToolTraceSlice, type RuntimeCustomToolConfig, type RuntimeExternalToolConfig, type RuntimeFlowToolConfig, type RuntimeLocalToolConfig, type RuntimeSubagentToolConfig, type RuntimeTool, type RuntimeToolConfig, Runtype, type AgentSkillBinding as RuntypeAgentSkillBinding, RuntypeApiError, RuntypeClient, type ConditionalStepConfig as RuntypeConditionalStepConfig, type RuntypeConfig, type FetchUrlStepConfig as RuntypeFetchUrlStepConfig, RuntypeFlowBuilder, type FlowConfig as RuntypeFlowConfig, type GenerateEmbeddingStepConfig as RuntypeGenerateEmbeddingStepConfig, type GetRecordStepConfig as RuntypeGetRecordStepConfig, type ListRecordsStepConfig as RuntypeListRecordsStepConfig, type LoopStepConfig as RuntypeLoopStepConfig, type Message as RuntypeMessage, type ModelOverride$1 as RuntypeModelOverride, type Prompt as RuntypePrompt, type PromptStepConfig as RuntypePromptStepConfig, type RuntypeRecord, type RecordConfig as RuntypeRecordConfig, type RetrieveRecordStepConfig as RuntypeRetrieveRecordStepConfig, type SearchStepConfig as RuntypeSearchStepConfig, type SendEmailStepConfig as RuntypeSendEmailStepConfig, type SendEventStepConfig as RuntypeSendEventStepConfig, type SendStreamStepConfig as RuntypeSendStreamStepConfig, type SetVariableStepConfig as RuntypeSetVariableStepConfig, type Skill as RuntypeSkill, type SkillCapabilities as RuntypeSkillCapabilities, type SkillFrontmatter as RuntypeSkillFrontmatter, type SkillManifest as RuntypeSkillManifest, type SkillProposal as RuntypeSkillProposal, type SkillRuntypeExtensions as RuntypeSkillRuntypeExtensions, type SkillVersion as RuntypeSkillVersion, type TransformDataStepConfig as RuntypeTransformDataStepConfig, type UpsertFlowConfig as RuntypeUpsertFlowConfig, type UpsertRecordStepConfig as RuntypeUpsertRecordStepConfig, type VectorSearchStepConfig as RuntypeVectorSearchStepConfig, type WaitUntilStepConfig as RuntypeWaitUntilStepConfig, SDK_USER_AGENT, SDK_VERSION, STEP_FIELD_REGISTRY, STEP_TYPE_TO_METHOD, type Schedule, type ScheduleExecutionOptions, type ScheduleListParams, type ScheduleMessage, type ScheduleMessageSet, type ScheduleMessages, type ScheduleMutationResponse, type ScheduleRun, type ScheduleRunNowResponse, type ScheduleStatusResponse, type ScheduleTarget, type ScheduleTrigger, SchedulesEndpoint, type SearchStepConfig$1 as SearchStepConfig, type Secret, type SecretCheckResponse, type SecretDeleteResponse, type SecretSetupUrlRequest, type SecretSetupUrlResponse, SecretsEndpoint, type SelectOrganizationProviderCredentialRequest, type SelectOrganizationProviderCredentialResponse, type SendEmailStepConfig$1 as SendEmailStepConfig, type SendEventStepConfig$1 as SendEventStepConfig, type SendStreamStepConfig$1 as SendStreamStepConfig, type SetVariableStepConfig$1 as SetVariableStepConfig, type SkillDefinition, SkillDriftError, SkillEnsureConflictError, type SkillListPage, type SkillListPagination, type SkillListParams, type SkillManifestInput, type SkillMarkdownInput, type SkillOrigin, type SkillProposalStatus, SkillProposalsNamespace, type SkillPullResult, type SkillStatus, type SkillTrustLevel, type SkillVersionStatus, type SkillWithVersion, type SkillWriteInput, SkillsNamespace, type SlackInstallRequest, type SlackManifestRequest, type SlackManifestResponse, type SlackOAuthStartRequest, type SlackOAuthStartResponse, type StepCompleteEvent, type StepDeltaEvent, type StepFallback, type StepFieldMeta, type StepStartEvent, type StepWaitingLocalEvent, type StreamCallbacks, type StreamConsumeOptions, type StreamEvent, type StreamEventOf, type SubagentToolConfig, type Surface, type SurfaceDefinition, type SurfaceDefinitionEnvironment, type SurfaceDefinitionStatus, type SurfaceDefinitionType, SurfaceDriftError, SurfaceEnsureConflictError, type SurfaceListParams, type SurfacePullResult, SurfacesEndpoint, SurfacesNamespace, type TextContentPart, type Tool, type ToolApprovalGrant, ToolApprovalGrantsEndpoint, type ToolConfig, type ToolDefinition, type ToolDefinitionType, ToolDriftError, ToolEnsureConflictError, type ToolPullResult, type ToolWithValidation, type ToolsConfig, ToolsEndpoint, ToolsNamespace, type TransformDataStepConfig$1 as TransformDataStepConfig, type TypedCreateRecordRequest, type TypedRecordListItem, type TypedRecordWriteResponse, TypedRecordsScope, type TypedRuntypeRecord, UNIFIED_EVENTS_QUERY, type UpdateClientTokenRequest, type UpdateCollectionRequest, type UpdateCollectionResponse, type UpdateConversationRequest, type UpdateEvalCaseInput, type UpdateEvalSuiteInput, type UpdateFlowRequest, type UpdatePromptData, type UpdateProviderKeyRequest, type UpdateScheduleRequest, type UpdateSecretRequest, type UpdateToolRequest, type UpdatedFlow, type UpsertFlowConfig$1 as UpsertFlowConfig, type UpsertOptions, type UpsertRecordStepConfig$1 as UpsertRecordStepConfig, type UserProfile, UsersEndpoint, type ValidateExistingRecordsResponse, type VectorSearchStepConfig$1 as VectorSearchStepConfig, type VersionType, type WaitUntilStepConfig$1 as WaitUntilStepConfig, type WorkflowCompileDeps, type WorkflowCompletionCriteriaConfig, type WorkflowConfig, type WorkflowConfigFactory, type WorkflowContext, type WorkflowDefinition, type WorkflowHookEntry, type WorkflowHookKind, type WorkflowHookRef, type WorkflowHookSignatures, type WorkflowMilestoneConfig, type WorkflowPhase, type WorkflowPolicyConfig, type WorkflowRecoveryConfig, type WorkflowSlot, type WorkflowStallPolicy, applyGeneratedRuntimeToolProposalToDispatchRequest, attachRuntimeToolsToDispatchRequest, buildAgentAdmissionHeaders, buildEmptySessionNudge, buildGeneratedRuntimeToolGateOutput, buildLedgerOffloadReference, buildPolicyGuidance, buildSendViewOffloadMarker, calledTool, compileWorkflowConfig, completed, computeAgentContentHash, computeEvalContentHash, computeFlowContentHash, computeFpoContentHash, computeProductContentHash, computeSkillContentHash, computeSurfaceContentHash, computeToolContentHash, contains, cost, createAgentEventTranslator, createClient, createExternalTool, createFlowEventTranslator, defaultWorkflow, defaultWorkflowConfig, defineAgent, defineEval, defineFlow, defineFpo, definePlaybook, defineProduct, defineSkill, defineSurface, defineTool, deployWorkflow, ensureDefaultWorkflowHooks, ensureEval, ensureFpo, evaluateGeneratedRuntimeToolProposal, extractDeclaredToolResultChars, gameWorkflow, getDefaultPlanPath, getLikelySupportingCandidatePaths, interpolateWorkflowTemplate, isCatalogClientToolRef, isDiscoveryToolName, isMarathonArtifactPath, isPreservationSensitiveTask, isUnifiedEventType, isWorkflowHookRef, jsonField, judge, judges, latency, length, listWorkflowHooks, matchesExpected, maxToolCalls, noError, normalizeAgentDefinition, normalizeCandidatePath, normalizeFpoDefinition, normalizeProductDefinition, normalizeSkillDefinition, normalizeSurfaceDefinition, normalizeToolDefinition, notCalledTool, notContains, parseFinalBuffer, parseLedgerArtifactRelativePath, parseOffloadedOutputId, parseSSEChunk, processStream, pullEval, pullFpo, ranStep, regex, registerWorkflowHook, resolveStallStopAfter, resolveWorkflowHook, runEvalSuite, sanitizeTaskSlug, shouldInjectEmptySessionNudge, shouldRequestModelEscalation, stepOrder, streamEvents, toolOrder, unregisterWorkflowHook, usedNoTools, validJson, withDetachedReconnect, withUnifiedEvents };
|
|
58387
|
+
export { type AIGrader, type Agent, type AgentAdmissionOptions, type AgentApprovalCompleteEvent, type AgentApprovalStartEvent, type AgentCompleteEvent, type AgentDefinition, type AgentDefinitionConfig, AgentDriftError, type AgentElicitation, type AgentElicitationRequest, AgentEnsureConflictError, type AgentErrorEvent, type AgentEvent, type AgentEventType, type AgentExecuteRequest, type AgentExecuteResponse, type AgentIterationCompleteEvent, type AgentIterationStartEvent, type AgentMediaEvent, type AgentMessage, type AgentPausedEvent, type AgentPingEvent, type AgentPullResult, type AgentReflectionEvent, type AgentRuntimeToolDefinition, type AgentStartEvent, type AgentStreamCallbacks, type AgentStreamEvent, type AgentSubagentConfig, type AgentToolCompleteEvent, type AgentToolDeltaEvent, type AgentToolInputCompleteEvent, type AgentToolInputDeltaEvent, type AgentToolStartEvent, type AgentTurnCompleteEvent, type AgentTurnDeltaEvent, type AgentTurnStartEvent, type AgentVersionDetail, type AgentVersionListItem, type AgentVersionPublishResponse, AgentVersionsEndpoint, type AgentVersionsListResponse, AgentsEndpoint, AgentsNamespace, AnalyticsEndpoint, type ApiClient, type ApiKey, type ApiKeyRequest, type ApiKeyRequestDelivery, type ApiKeyRequestEnvironment, type ApiKeyRequestHandoff, type ApiKeyRequestListParams, type ApiKeyRequestRequester, type ApiKeyRequestStatus, ApiKeyRequestsEndpoint, ApiKeysEndpoint, type ApiResponse, type ApplyGeneratedProposalOptions, type ApplyGeneratedProposalResult, type AssetReferenceContentPart, type AsyncExecutionHandle, type AsyncExecutionStatus, type AttachRuntimeToolsOptions, type BaseAgentEvent, BatchBuilder, type BatchClient, type BatchListParams, type BatchOptions, type BatchRequest, type BatchResult, type BatchScheduleConfig, type BatchStatus, BatchesNamespace, BillingEndpoint, type BillingSpendAnalyticsParams, type BindSkillInput, type BuiltInGraderId, type BuiltInTool, type BulkEditCondition, type BulkEditRequest, type BulkEditResponse, type BulkEditResult, type CanonicalDispatchMessageContent, type CanonicalDispatchRequest, type CaseExpected, type CatalogClientToolRef, ChatEndpoint, type CheckGrader, type ClaimApiKeyRequestInput, type ClaimApiKeyRequestResponse, type ClaudeManagedEvalOverrideValues, ClientBatchBuilder, type ClientConfig, type ClientConversation, ClientEvalBuilder, ClientFlowBuilder, type ClientToken, type ClientTokenConfig, type ClientTokenEnvironment, type ClientTokenVersionPin, ClientTokensEndpoint, type ClientToolDefinition, type ClientToolEntry, type ClientWidgetTheme, type CollectionMeta, CollectionsEndpoint, type ConditionalGetResult, type ConditionalStepConfig$1 as ConditionalStepConfig, type ContextErrorHandling, type ContextFallback, ContextTemplatesEndpoint, type Conversation, type ConversationListItem, type ConversationListParams, type ConversationMessage, type ConversationSource, ConversationsEndpoint, type ConversationsListResponse, type CreateApiKeyRequest, type CreateApiKeyRequestInput, type CreateApiKeyRequestResponse, type CreateClientTokenRequest, type CreateClientTokenResponse, type CreateCollectionRequest, type CreateConversationRequest, type CreateEvalSuiteInput, type CreateFlowRequest, type CreateModelConfigRequest, type CreatePromptData, type CreatePromptRequest, type CreateProviderKeyRequest, type CreateRecordRequest, type CreateScheduleRequest, type CreateSecretRequest, type CreateToolRequest, type CurrentBilledSpendResponse, type CurrentBilledSpendSource, type CustomMCPServer, type CustomMCPServerAuth, type CustomToolConfig, DEFAULT_MAX_DETACHED_RECONNECTS, DEFAULT_RECOVERY_AFTER_EMPTY_SESSIONS, DEFAULT_STALL_STOP_AFTER, type DecomposeCriteriaResult, type DefineAgentInput, type DefineEvalCaseInput, type DefineEvalInput, type DefineFlowInput, type DefineProductInput, type DefineSkillInput, type DefineSurfaceInput, type DefineToolInput, type DeployCfSandboxRequest, type DeployCfSandboxResponse, type DeploySandboxRequest, type DeploySandboxResponse, type DetachedReattach, type DetachedReconnectOptions, type DiscoveredModel, type DispatchAgentInput, type DispatchApprovalContinuationResponse, type DispatchApproveRequest, type DispatchApproveResponse, type DispatchClient, type DispatchContinuationRequest, type DispatchContinuationResponse, type DispatchDetachedApprovalResponse, DispatchEndpoint, type DispatchEnvironment, type DispatchEvent, type DispatchFlowInput, type DispatchMessageContent, type DispatchOptions$1 as DispatchOptions, type DispatchRequest, type DispatchResponse, type DispatchResumeRequest, type DispatchResumeResponse, type EndUserUsageQuery, type EndUserUsageResponse, type EnsureAgentConverged, type EnsureAgentOptions, type EnsureAgentPlan, type EnsureAgentResult, type EnsureEvalResult, type EnsureFlowConverged, type EnsureFlowOptions, type EnsureFlowPlan, type EnsureFlowResult, type EnsureFpoOptions, type EnsureFpoResult, type EnsureProductConverged, type EnsureProductOptions, type EnsureProductPlan, type EnsureProductResult, type EnsureSkillConverged, type EnsureSkillOptions, type EnsureSkillPlan, type EnsureSkillResult, type EnsureSurfaceConverged, type EnsureSurfaceOptions, type EnsureSurfacePlan, type EnsureSurfaceResult, type EnsureToolConverged, type EnsureToolOptions, type EnsureToolPlan, type EnsureToolResult, type ErrorHandlingMode, EvalBuilder, type EvalCaseDefinition, type EvalCaseInput, type EvalCaseProposal, type EvalCaseProposalAccepted, type EvalCaseProposalListResult, type EvalCasesGenerated, type EvalClient, type EvalDefinition, EvalEndpoint, type EvalListParams, type EvalMessage, type EvalOptions, type EvalOverrideValues, type EvalProposalSource, type EvalProposalStatus, type EvalProposedCase, type EvalPullResult, type EvalRecord, type EvalRequest, type EvalResult, type EvalRunCaseScores, type EvalRunConfig, type EvalRunScores, EvalRunner, type EvalStatus, type EvalSuiteCase, type EvalSuiteCaseInput, type EvalSuiteCoverage, type EvalSuiteDetail, type EvalSuiteLatestRun, type EvalSuiteListResult, type EvalSuiteRunQueued, type EvalSuiteRunResult, type EvalSuiteSummary, EvalSuitesNamespace, type EvalTarget, EvalsNamespace, type ExecuteToolRequest, type ExecuteToolResponse, type ExecutionStreamEvent, ExecutionsEndpoint, ExecutionsNamespace, type ExternalAgentContext, type ExternalToolConfig, type FallbackFailEvent, type FallbackStartEvent, type FallbackSuccessEvent, type FallbackTrigger, type FallbackTriggerType, type FallbacksExhaustedEvent, type FallbacksInitiatedEvent, type FetchUrlStepConfig$1 as FetchUrlStepConfig, type FieldFormat, type FileContentPart, type Flow, type FlowAttachment, FlowBuilder, type FlowCompleteEvent, type FlowConfig$1 as FlowConfig, type FlowDefinition, type FlowDefinitionStep, FlowDriftError, FlowEnsureConflictError, type FlowErrorEvent, type FlowFallback, type FlowInlineEvalInput, type FlowListItem, type FlowPausedEvent, type FlowPullResult, FlowResult, type FlowStartEvent, type FlowStep, type FlowStepDefinition, type FlowStepType, FlowStepsEndpoint, type FlowStreamEvent, type FlowSummary, type FlowToolConfig, type FlowValidationClient, type FlowValidationIssue, type FlowValidationResult, type FlowVersionDetail, type FlowVersionListItem, type FlowVersionPublishResponse, FlowVersionsEndpoint, type FlowVersionsListResponse, FlowsEndpoint, FlowsNamespace, type FpoEntityOutcome, type FpoInput, type GenerateEmbeddingStepConfig$1 as GenerateEmbeddingStepConfig, type GenerateEvalCasesInput, type GeneratedRuntimeToolGateDecision, type GeneratedRuntimeToolGateOptions, type GetApiKeyRequestResponse, type GetRecordStepConfig$1 as GetRecordStepConfig, type Gradeable, type GraderConfig, type GraderOutcome, type GraderSeverity, type HumanVerdict, type ImageContentPart, type InferCollectionSchemaResponse, type Integration, type IntegrationTool, IntegrationsEndpoint, type IntegrationsListResponse, type JSONSchema, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, LEDGER_ARTIFACT_LINE_PREFIX, type ListCollectionsResponse, type ListConversationsResponse, type ListParams, type ListRecordsStepConfig$1 as ListRecordsStepConfig, type LocalToolConfig, type LocalToolDefinition, type LocalToolExecutionCompleteEvent, type LocalToolExecutionLoopSnapshotSlice, type LocalToolExecutionStartEvent, type LogEntry, type LogQueryParams, type LogQueryResponse, type LogQueryResult, type LogStatsParams, type LogStatsResponse, type LogStatsResult, LogsEndpoint, type LoopStepConfig$1 as LoopStepConfig, type Message$1 as Message, type MessageContent, type MessageFallback, type Metadata, type ModelConfig, ModelConfigsEndpoint, type ModelFallback, type ModelOverride, type ModelUsageDetail, type ModelUsageQueryParams, type ModelUsageResponse, type ModelUsageSummary, type ModelUsageTimeSeries, type PaginationResponse, type PersistedGraderOutcome, type ProductDefinition, ProductDriftError, ProductEnsureConflictError, type ProductPullResult, ProductsNamespace, type Prompt$1 as Prompt, type PromptErrorHandling, type PromptFallback, type PromptListParams, type PromptStepConfig$1 as PromptStepConfig, PromptsEndpoint, PromptsNamespace, type ProviderApiKey, type ProviderKeyModel, ProviderKeysEndpoint, type PullFpoResult, RUNTYPE_CLIENT_KIND, type ReasoningConfig, type ReasoningContentPart, type ReasoningValue, type RecordCollection, type RecordCollectionWithHistory, type RecordCollections, type RecordConfig$1 as RecordConfig, type RecordCostAggregation, type RecordCostModelBreakdown, type RecordFilter, type RecordFilterCondition, type RecordFilterGroup, type RecordFilterOperator, type RecordListItem, type RecordListParams, type RecordStepResult, type RecordStepResultsParams, type RecordStepResultsResponse, type RecordWriteResponse, RecordsEndpoint, type RetrieveRecordStepConfig$1 as RetrieveRecordStepConfig, type RetryFallback, type RunEvalCaseResult, type RunEvalInput, type RunEvalResult, type RunTaskContextBudgetBreakdown, type RunTaskContextCompactionEvent, type RunTaskContextCompactionStrategy, type RunTaskContextNoticeEvent, type RunTaskContextSummaryEntry, type RunTaskContinuation, type RunTaskOffloadRecorder, type RunTaskOnContextCompaction, type RunTaskOnContextNotice, type RunTaskOnSession, type RunTaskOptions, type RunTaskResult, type RunTaskResumeState, type RunTaskSessionSummary, type RunTaskState, type RunTaskStateSlice, type RunTaskStatus, type RunTaskToolTraceSlice, type RuntimeCustomToolConfig, type RuntimeExternalToolConfig, type RuntimeFlowToolConfig, type RuntimeLocalToolConfig, type RuntimeSubagentToolConfig, type RuntimeTool, type RuntimeToolConfig, Runtype, type AgentSkillBinding as RuntypeAgentSkillBinding, RuntypeApiError, RuntypeClient, type ConditionalStepConfig as RuntypeConditionalStepConfig, type RuntypeConfig, type FetchUrlStepConfig as RuntypeFetchUrlStepConfig, RuntypeFlowBuilder, type FlowConfig as RuntypeFlowConfig, type GenerateEmbeddingStepConfig as RuntypeGenerateEmbeddingStepConfig, type GetRecordStepConfig as RuntypeGetRecordStepConfig, type ListRecordsStepConfig as RuntypeListRecordsStepConfig, type LoopStepConfig as RuntypeLoopStepConfig, type Message as RuntypeMessage, type ModelOverride$1 as RuntypeModelOverride, type Prompt as RuntypePrompt, type PromptStepConfig as RuntypePromptStepConfig, type RuntypeRecord, type RecordConfig as RuntypeRecordConfig, type RetrieveRecordStepConfig as RuntypeRetrieveRecordStepConfig, type SearchStepConfig as RuntypeSearchStepConfig, type SendEmailStepConfig as RuntypeSendEmailStepConfig, type SendEventStepConfig as RuntypeSendEventStepConfig, type SendStreamStepConfig as RuntypeSendStreamStepConfig, type SetVariableStepConfig as RuntypeSetVariableStepConfig, type Skill as RuntypeSkill, type SkillCapabilities as RuntypeSkillCapabilities, type SkillFrontmatter as RuntypeSkillFrontmatter, type SkillManifest as RuntypeSkillManifest, type SkillProposal as RuntypeSkillProposal, type SkillRuntypeExtensions as RuntypeSkillRuntypeExtensions, type SkillVersion as RuntypeSkillVersion, type TransformDataStepConfig as RuntypeTransformDataStepConfig, type UpsertFlowConfig as RuntypeUpsertFlowConfig, type UpsertRecordStepConfig as RuntypeUpsertRecordStepConfig, type VectorSearchStepConfig as RuntypeVectorSearchStepConfig, type WaitUntilStepConfig as RuntypeWaitUntilStepConfig, SDK_USER_AGENT, SDK_VERSION, STEP_FIELD_REGISTRY, STEP_TYPE_TO_METHOD, type Schedule, type ScheduleExecutionOptions, type ScheduleListParams, type ScheduleMessage, type ScheduleMessageSet, type ScheduleMessages, type ScheduleMutationResponse, type ScheduleRun, type ScheduleRunNowResponse, type ScheduleStatusResponse, type ScheduleTarget, type ScheduleTrigger, SchedulesEndpoint, type SearchStepConfig$1 as SearchStepConfig, type Secret, type SecretCheckResponse, type SecretDeleteResponse, type SecretSetupUrlRequest, type SecretSetupUrlResponse, SecretsEndpoint, type SelectOrganizationProviderCredentialRequest, type SelectOrganizationProviderCredentialResponse, type SendEmailStepConfig$1 as SendEmailStepConfig, type SendEventStepConfig$1 as SendEventStepConfig, type SendStreamStepConfig$1 as SendStreamStepConfig, type SetVariableStepConfig$1 as SetVariableStepConfig, type SkillDefinition, SkillDriftError, SkillEnsureConflictError, type SkillListPage, type SkillListPagination, type SkillListParams, type SkillManifestInput, type SkillMarkdownInput, type SkillOrigin, type SkillProposalStatus, SkillProposalsNamespace, type SkillPullResult, type SkillStatus, type SkillTrustLevel, type SkillVersionStatus, type SkillWithVersion, type SkillWriteInput, SkillsNamespace, type SlackInstallRequest, type SlackManifestRequest, type SlackManifestResponse, type SlackOAuthStartRequest, type SlackOAuthStartResponse, type StepCompleteEvent, type StepDeltaEvent, type StepFallback, type StepFieldMeta, type StepStartEvent, type StepWaitingLocalEvent, type StreamCallbacks, type StreamConsumeOptions, type StreamEvent, type StreamEventOf, type SubagentToolConfig, type Surface, type SurfaceDefinition, type SurfaceDefinitionEnvironment, type SurfaceDefinitionStatus, type SurfaceDefinitionType, SurfaceDriftError, SurfaceEnsureConflictError, type SurfaceListParams, type SurfacePullResult, SurfacesEndpoint, SurfacesNamespace, type TextContentPart, type Tool, type ToolApprovalGrant, ToolApprovalGrantsEndpoint, type ToolConfig, type ToolDefinition, type ToolDefinitionType, ToolDriftError, ToolEnsureConflictError, type ToolPullResult, type ToolWithValidation, type ToolsConfig, ToolsEndpoint, ToolsNamespace, type TransformDataStepConfig$1 as TransformDataStepConfig, type TypedCreateRecordRequest, type TypedRecordListItem, type TypedRecordWriteResponse, TypedRecordsScope, type TypedRuntypeRecord, UNIFIED_EVENTS_QUERY, type UpdateClientTokenRequest, type UpdateCollectionRequest, type UpdateCollectionResponse, type UpdateConversationRequest, type UpdateEvalCaseInput, type UpdateEvalSuiteInput, type UpdateFlowRequest, type UpdatePromptData, type UpdateProviderKeyRequest, type UpdateScheduleRequest, type UpdateSecretRequest, type UpdateToolRequest, type UpdatedFlow, type UpsertFlowConfig$1 as UpsertFlowConfig, type UpsertOptions, type UpsertRecordStepConfig$1 as UpsertRecordStepConfig, type UserProfile, UsersEndpoint, type ValidateExistingRecordsResponse, type VectorSearchStepConfig$1 as VectorSearchStepConfig, type VersionPublishOptions, type VersionType, type WaitUntilStepConfig$1 as WaitUntilStepConfig, type WorkflowCompileDeps, type WorkflowCompletionCriteriaConfig, type WorkflowConfig, type WorkflowConfigFactory, type WorkflowContext, type WorkflowDefinition, type WorkflowHookEntry, type WorkflowHookKind, type WorkflowHookRef, type WorkflowHookSignatures, type WorkflowMilestoneConfig, type WorkflowPhase, type WorkflowPolicyConfig, type WorkflowRecoveryConfig, type WorkflowSlot, type WorkflowStallPolicy, applyGeneratedRuntimeToolProposalToDispatchRequest, attachRuntimeToolsToDispatchRequest, buildAgentAdmissionHeaders, buildEmptySessionNudge, buildGeneratedRuntimeToolGateOutput, buildLedgerOffloadReference, buildPolicyGuidance, buildSendViewOffloadMarker, calledTool, compileWorkflowConfig, completed, computeAgentContentHash, computeEvalContentHash, computeFlowContentHash, computeFpoContentHash, computeProductContentHash, computeSkillContentHash, computeSurfaceContentHash, computeToolContentHash, contains, cost, createAgentEventTranslator, createClient, createExternalTool, createFlowEventTranslator, defaultWorkflow, defaultWorkflowConfig, defineAgent, defineEval, defineFlow, defineFpo, definePlaybook, defineProduct, defineSkill, defineSurface, defineTool, deployWorkflow, ensureDefaultWorkflowHooks, ensureEval, ensureFpo, evaluateGeneratedRuntimeToolProposal, extractDeclaredToolResultChars, gameWorkflow, getDefaultPlanPath, getLikelySupportingCandidatePaths, interpolateWorkflowTemplate, isCatalogClientToolRef, isDiscoveryToolName, isMarathonArtifactPath, isPreservationSensitiveTask, isUnifiedEventType, isWorkflowHookRef, jsonField, judge, judges, latency, length, listWorkflowHooks, matchesExpected, maxToolCalls, noError, normalizeAgentDefinition, normalizeCandidatePath, normalizeFpoDefinition, normalizeProductDefinition, normalizeSkillDefinition, normalizeSurfaceDefinition, normalizeToolDefinition, notCalledTool, notContains, parseFinalBuffer, parseLedgerArtifactRelativePath, parseOffloadedOutputId, parseSSEChunk, processStream, pullEval, pullFpo, ranStep, regex, registerWorkflowHook, resolveStallStopAfter, resolveWorkflowHook, runEvalSuite, sanitizeTaskSlug, shouldInjectEmptySessionNudge, shouldRequestModelEscalation, stepOrder, streamEvents, toolOrder, unregisterWorkflowHook, usedNoTools, validJson, withDetachedReconnect, withUnifiedEvents };
|