@runtypelabs/sdk 6.3.5 → 6.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -734,6 +734,10 @@ interface paths {
734
734
  persistence?: "ephemeral" | "conversation" | "named";
735
735
  /** @enum {string} */
736
736
  provider?: "runtype-sandbox" | "daytona";
737
+ secretEnv?: {
738
+ [key: string]: string;
739
+ };
740
+ setupCommands?: string[];
737
741
  /** @enum {string} */
738
742
  sleepAfter?: "5m" | "15m" | "30m" | "1h";
739
743
  /** @enum {string} */
@@ -1147,6 +1151,10 @@ interface paths {
1147
1151
  persistence?: "ephemeral" | "conversation" | "named";
1148
1152
  /** @enum {string} */
1149
1153
  provider?: "runtype-sandbox" | "daytona";
1154
+ secretEnv?: {
1155
+ [key: string]: string;
1156
+ };
1157
+ setupCommands?: string[];
1150
1158
  /** @enum {string} */
1151
1159
  sleepAfter?: "5m" | "15m" | "30m" | "1h";
1152
1160
  /** @enum {string} */
@@ -1832,6 +1840,10 @@ interface paths {
1832
1840
  persistence?: "ephemeral" | "conversation" | "named";
1833
1841
  /** @enum {string} */
1834
1842
  provider?: "runtype-sandbox" | "daytona";
1843
+ secretEnv?: {
1844
+ [key: string]: string;
1845
+ };
1846
+ setupCommands?: string[];
1835
1847
  /** @enum {string} */
1836
1848
  sleepAfter?: "5m" | "15m" | "30m" | "1h";
1837
1849
  /** @enum {string} */
@@ -6487,7 +6499,7 @@ interface paths {
6487
6499
  untrustedContentHint?: boolean;
6488
6500
  }[];
6489
6501
  clientToolsFingerprint?: string;
6490
- /** @description Customer-native auth proof for the Identity Exchange. When present and the surface has a matching integration, the verified tenant/end-user replace any body-asserted tenant/endUser (which are never trusted for web-embedded callers). Ignored until the Identity Exchange admission upgrade ships. */
6502
+ /** @description Customer-native auth proof for the Identity Exchange. When present and the surface has a matching integration, the verified tenant/end-user replace any body-asserted tenant/endUser (which are never trusted for web-embedded callers). When Identity Exchange admission is disabled for the caller, the proof is accepted but ignored and confers no trust. */
6491
6503
  identityProof?: {
6492
6504
  provider: string;
6493
6505
  token: string;
@@ -9656,7 +9668,581 @@ interface paths {
9656
9668
  requestBody?: {
9657
9669
  content: {
9658
9670
  "application/json": {
9659
- [key: string]: unknown;
9671
+ agent?: {
9672
+ advisor?: {
9673
+ model: string;
9674
+ systemPrompt?: string;
9675
+ } | null;
9676
+ agentId?: string;
9677
+ /** @enum {string} */
9678
+ agentType?: "runtype" | "claude_managed";
9679
+ artifacts?: {
9680
+ /** @enum {boolean} */
9681
+ enabled: true;
9682
+ types: ("markdown" | "component")[];
9683
+ };
9684
+ claudeManagedConfig?: {
9685
+ anthropicAgentId?: string;
9686
+ anthropicAgentVersion?: number;
9687
+ anthropicEnvironmentId?: string;
9688
+ autoDelete?: boolean;
9689
+ model?: string;
9690
+ /** @enum {string} */
9691
+ setupMode?: "create" | "connect";
9692
+ systemPrompt?: string;
9693
+ };
9694
+ frequencyPenalty?: number;
9695
+ loopConfig?: {
9696
+ enableReflection?: boolean;
9697
+ maxCost?: number;
9698
+ maxTurns?: number;
9699
+ reflectionInterval?: number;
9700
+ };
9701
+ memory?: {
9702
+ enabled: boolean;
9703
+ injectSummary?: boolean;
9704
+ profileTemplate?: string;
9705
+ };
9706
+ model?: string;
9707
+ name?: string;
9708
+ presencePenalty?: number;
9709
+ sandbox?: {
9710
+ enabled: boolean;
9711
+ /** @enum {string} */
9712
+ instanceType?: "standard-1" | "standard-2" | "standard-3" | "standard-4";
9713
+ networkAccess?: ("none" | "essentials" | "open") | {
9714
+ allow?: string[];
9715
+ /** @enum {string} */
9716
+ profile?: "none" | "essentials" | "open";
9717
+ };
9718
+ /** @enum {string} */
9719
+ persistence?: "ephemeral" | "conversation" | "named";
9720
+ /** @enum {string} */
9721
+ provider?: "runtype-sandbox" | "daytona";
9722
+ secretEnv?: {
9723
+ [key: string]: string;
9724
+ };
9725
+ setupCommands?: string[];
9726
+ /** @enum {string} */
9727
+ sleepAfter?: "5m" | "15m" | "30m" | "1h";
9728
+ /** @enum {string} */
9729
+ ttl?: "5m" | "1h" | "24h" | "unlimited";
9730
+ };
9731
+ seed?: number;
9732
+ systemPrompt?: string;
9733
+ temperature?: number;
9734
+ tools?: {
9735
+ approval?: {
9736
+ choices?: {
9737
+ alwaysAllow?: boolean;
9738
+ alwaysDeny?: boolean;
9739
+ };
9740
+ requestReason?: boolean;
9741
+ require: string[] | boolean;
9742
+ timeout?: number;
9743
+ };
9744
+ codeModeConfig?: {
9745
+ description?: string;
9746
+ timeoutMs?: number;
9747
+ toolPool: string[];
9748
+ };
9749
+ maxToolCalls?: number;
9750
+ mcpServers?: unknown[];
9751
+ perToolLimits?: {
9752
+ [key: string]: {
9753
+ maxCalls?: number;
9754
+ required?: boolean;
9755
+ };
9756
+ };
9757
+ runtimeTools?: unknown[];
9758
+ subagentConfig?: {
9759
+ allowNesting?: boolean;
9760
+ /** @enum {string} */
9761
+ defaultExecutionMode?: "attached" | "detached";
9762
+ defaultMaxTurns?: number;
9763
+ defaultModel?: string;
9764
+ /** @enum {string} */
9765
+ defaultNotify?: "none" | "narrate" | "react";
9766
+ defaultTimeoutMs?: number;
9767
+ detachedMaxBudgetMs?: number;
9768
+ detachedNoProgressBudgetMs?: number;
9769
+ executionModes?: ("attached" | "detached")[];
9770
+ maxSpawnsPerRun?: number;
9771
+ maxTurnsLimit?: number;
9772
+ toolPool: string[];
9773
+ };
9774
+ /** @enum {string} */
9775
+ toolCallStrategy?: "auto" | "required" | "none";
9776
+ toolConfigs?: {
9777
+ [key: string]: {
9778
+ [key: string]: unknown;
9779
+ };
9780
+ };
9781
+ toolIds?: string[];
9782
+ };
9783
+ topK?: number;
9784
+ topP?: number;
9785
+ };
9786
+ clientTools?: {
9787
+ description: string;
9788
+ name: string;
9789
+ /** @enum {string} */
9790
+ origin?: "webmcp" | "sdk";
9791
+ pageOrigin?: string;
9792
+ parametersSchema: {
9793
+ /** @enum {string} */
9794
+ type: "object";
9795
+ } & {
9796
+ [key: string]: unknown;
9797
+ };
9798
+ untrustedContentHint?: boolean;
9799
+ }[];
9800
+ clientToolsPolicy?: {
9801
+ allowlist?: string[];
9802
+ };
9803
+ conversationId?: string;
9804
+ credentialProxies?: {
9805
+ envVarName?: string;
9806
+ hostnamePattern: string;
9807
+ /** @default {} */
9808
+ injectionConfig?: {
9809
+ [key: string]: unknown;
9810
+ };
9811
+ /** @enum {string} */
9812
+ injectionMode: "bearer_header" | "api_key_header" | "query_param" | "basic_auth";
9813
+ /** @default /* */
9814
+ pathPattern?: string;
9815
+ secretKey: string;
9816
+ }[];
9817
+ endUser?: {
9818
+ email?: string;
9819
+ id: string;
9820
+ } & {
9821
+ [key: string]: unknown;
9822
+ };
9823
+ flow: {
9824
+ contentHash?: string;
9825
+ description?: string;
9826
+ id?: string;
9827
+ name?: string;
9828
+ steps?: unknown[];
9829
+ };
9830
+ /** @description Customer-native auth proof for the Identity Exchange. When present and the surface has a matching integration, the verified tenant/end-user replace any body-asserted tenant/endUser (which are never trusted for web-embedded callers). When Identity Exchange admission is disabled for the caller, the proof is accepted but ignored and confers no trust. */
9831
+ identityProof?: {
9832
+ provider: string;
9833
+ token: string;
9834
+ };
9835
+ inputs?: {
9836
+ [key: string]: unknown;
9837
+ };
9838
+ messages?: {
9839
+ content: string | ({
9840
+ text: string;
9841
+ /** @enum {string} */
9842
+ type: "text";
9843
+ } | {
9844
+ image: string;
9845
+ mimeType?: string;
9846
+ /** @enum {string} */
9847
+ type: "image";
9848
+ } | {
9849
+ data: string;
9850
+ filename: string;
9851
+ mimeType: string;
9852
+ /** @enum {string} */
9853
+ type: "file";
9854
+ } | {
9855
+ providerOptions?: {
9856
+ [key: string]: unknown;
9857
+ };
9858
+ text: string;
9859
+ /** @enum {string} */
9860
+ type: "reasoning";
9861
+ })[];
9862
+ /** @enum {string} */
9863
+ role: "system" | "user" | "assistant";
9864
+ }[];
9865
+ /**
9866
+ * @default {
9867
+ * "autoAppendMetadata": false,
9868
+ * "createVersion": false,
9869
+ * "debugMode": false,
9870
+ * "environment": "development",
9871
+ * "flowMode": "existing",
9872
+ * "recordMode": "existing",
9873
+ * "storeResults": true,
9874
+ * "streamResponse": true
9875
+ * }
9876
+ */
9877
+ options?: {
9878
+ /** @default false */
9879
+ autoAppendMetadata?: boolean;
9880
+ /** @description Set false to disable prompt caching for this request (no cache markers, no cache routing keys). Use for workloads where deterministic byte-identical requests must never share provider cache state, or to A/B against cached behavior. Default: caching follows the account rollout. */
9881
+ cache?: boolean;
9882
+ clientToolOutputs?: {
9883
+ [key: string]: unknown;
9884
+ };
9885
+ /** @default false */
9886
+ createVersion?: boolean;
9887
+ /** @default false */
9888
+ debugMode?: boolean;
9889
+ /**
9890
+ * @default development
9891
+ * @enum {string}
9892
+ */
9893
+ environment?: "development" | "production";
9894
+ /**
9895
+ * @default existing
9896
+ * @enum {string}
9897
+ */
9898
+ flowMode?: "existing" | "create" | "virtual" | "upsert";
9899
+ flowTimeoutMs?: number;
9900
+ flowVersionId?: string;
9901
+ localInference?: {
9902
+ /** @enum {string} */
9903
+ backend: "ollama";
9904
+ model: string;
9905
+ /** Format: uuid */
9906
+ sessionId: string;
9907
+ /** @enum {string} */
9908
+ surface?: "playground" | "flows" | "agents";
9909
+ };
9910
+ /** @enum {string} */
9911
+ loggingPolicy?: "default" | "on" | "off";
9912
+ modelOverride?: string;
9913
+ /**
9914
+ * @default existing
9915
+ * @enum {string}
9916
+ */
9917
+ recordMode?: "existing" | "create" | "virtual";
9918
+ resumeFrom?: {
9919
+ executionId: string;
9920
+ iteration?: number;
9921
+ };
9922
+ stepTimeoutMs?: number;
9923
+ /** @default true */
9924
+ storeResults?: boolean;
9925
+ /** @default true */
9926
+ streamResponse?: boolean;
9927
+ upsertOptions?: {
9928
+ /** @default false */
9929
+ allowOverwriteExternalChanges?: boolean;
9930
+ /** @default true */
9931
+ createVersionOnChange?: boolean;
9932
+ };
9933
+ /** @description For FLOW dispatches this compatibility field is accepted but ignored: eligible flows always use the @runtypelabs/runtime lane, while ineligible flows still fold to legacy silently. Agent dispatches still require an explicit `true` and remain subject to their separate runtime-agent rollout gate. */
9934
+ useRuntimePackage?: boolean;
9935
+ versionLabel?: string;
9936
+ versionNotes?: string;
9937
+ /** @enum {string} */
9938
+ versionType?: "published" | "draft" | "test" | "virtual";
9939
+ };
9940
+ record?: {
9941
+ id?: string;
9942
+ metadata?: {
9943
+ [key: string]: unknown;
9944
+ };
9945
+ name?: string;
9946
+ ownerId?: string;
9947
+ type?: string;
9948
+ };
9949
+ /** @description Per-request credentials for agent/external-tool execution. Ignored when `flow` is the hosted target; FLOW credentials must use managed {{secret:NAME}} references. */
9950
+ secrets?: {
9951
+ [key: string]: string;
9952
+ };
9953
+ tenant?: {
9954
+ id: string;
9955
+ } & {
9956
+ [key: string]: unknown;
9957
+ };
9958
+ } | {
9959
+ agent: {
9960
+ advisor?: {
9961
+ model: string;
9962
+ systemPrompt?: string;
9963
+ } | null;
9964
+ agentId?: string;
9965
+ /** @enum {string} */
9966
+ agentType?: "runtype" | "claude_managed";
9967
+ artifacts?: {
9968
+ /** @enum {boolean} */
9969
+ enabled: true;
9970
+ types: ("markdown" | "component")[];
9971
+ };
9972
+ claudeManagedConfig?: {
9973
+ anthropicAgentId?: string;
9974
+ anthropicAgentVersion?: number;
9975
+ anthropicEnvironmentId?: string;
9976
+ autoDelete?: boolean;
9977
+ model?: string;
9978
+ /** @enum {string} */
9979
+ setupMode?: "create" | "connect";
9980
+ systemPrompt?: string;
9981
+ };
9982
+ frequencyPenalty?: number;
9983
+ loopConfig?: {
9984
+ enableReflection?: boolean;
9985
+ maxCost?: number;
9986
+ maxTurns?: number;
9987
+ reflectionInterval?: number;
9988
+ };
9989
+ memory?: {
9990
+ enabled: boolean;
9991
+ injectSummary?: boolean;
9992
+ profileTemplate?: string;
9993
+ };
9994
+ model?: string;
9995
+ name?: string;
9996
+ presencePenalty?: number;
9997
+ sandbox?: {
9998
+ enabled: boolean;
9999
+ /** @enum {string} */
10000
+ instanceType?: "standard-1" | "standard-2" | "standard-3" | "standard-4";
10001
+ networkAccess?: ("none" | "essentials" | "open") | {
10002
+ allow?: string[];
10003
+ /** @enum {string} */
10004
+ profile?: "none" | "essentials" | "open";
10005
+ };
10006
+ /** @enum {string} */
10007
+ persistence?: "ephemeral" | "conversation" | "named";
10008
+ /** @enum {string} */
10009
+ provider?: "runtype-sandbox" | "daytona";
10010
+ secretEnv?: {
10011
+ [key: string]: string;
10012
+ };
10013
+ setupCommands?: string[];
10014
+ /** @enum {string} */
10015
+ sleepAfter?: "5m" | "15m" | "30m" | "1h";
10016
+ /** @enum {string} */
10017
+ ttl?: "5m" | "1h" | "24h" | "unlimited";
10018
+ };
10019
+ seed?: number;
10020
+ systemPrompt?: string;
10021
+ temperature?: number;
10022
+ tools?: {
10023
+ approval?: {
10024
+ choices?: {
10025
+ alwaysAllow?: boolean;
10026
+ alwaysDeny?: boolean;
10027
+ };
10028
+ requestReason?: boolean;
10029
+ require: string[] | boolean;
10030
+ timeout?: number;
10031
+ };
10032
+ codeModeConfig?: {
10033
+ description?: string;
10034
+ timeoutMs?: number;
10035
+ toolPool: string[];
10036
+ };
10037
+ maxToolCalls?: number;
10038
+ mcpServers?: unknown[];
10039
+ perToolLimits?: {
10040
+ [key: string]: {
10041
+ maxCalls?: number;
10042
+ required?: boolean;
10043
+ };
10044
+ };
10045
+ runtimeTools?: unknown[];
10046
+ subagentConfig?: {
10047
+ allowNesting?: boolean;
10048
+ /** @enum {string} */
10049
+ defaultExecutionMode?: "attached" | "detached";
10050
+ defaultMaxTurns?: number;
10051
+ defaultModel?: string;
10052
+ /** @enum {string} */
10053
+ defaultNotify?: "none" | "narrate" | "react";
10054
+ defaultTimeoutMs?: number;
10055
+ detachedMaxBudgetMs?: number;
10056
+ detachedNoProgressBudgetMs?: number;
10057
+ executionModes?: ("attached" | "detached")[];
10058
+ maxSpawnsPerRun?: number;
10059
+ maxTurnsLimit?: number;
10060
+ toolPool: string[];
10061
+ };
10062
+ /** @enum {string} */
10063
+ toolCallStrategy?: "auto" | "required" | "none";
10064
+ toolConfigs?: {
10065
+ [key: string]: {
10066
+ [key: string]: unknown;
10067
+ };
10068
+ };
10069
+ toolIds?: string[];
10070
+ };
10071
+ topK?: number;
10072
+ topP?: number;
10073
+ };
10074
+ clientTools?: {
10075
+ description: string;
10076
+ name: string;
10077
+ /** @enum {string} */
10078
+ origin?: "webmcp" | "sdk";
10079
+ pageOrigin?: string;
10080
+ parametersSchema: {
10081
+ /** @enum {string} */
10082
+ type: "object";
10083
+ } & {
10084
+ [key: string]: unknown;
10085
+ };
10086
+ untrustedContentHint?: boolean;
10087
+ }[];
10088
+ clientToolsPolicy?: {
10089
+ allowlist?: string[];
10090
+ };
10091
+ conversationId?: string;
10092
+ credentialProxies?: {
10093
+ envVarName?: string;
10094
+ hostnamePattern: string;
10095
+ /** @default {} */
10096
+ injectionConfig?: {
10097
+ [key: string]: unknown;
10098
+ };
10099
+ /** @enum {string} */
10100
+ injectionMode: "bearer_header" | "api_key_header" | "query_param" | "basic_auth";
10101
+ /** @default /* */
10102
+ pathPattern?: string;
10103
+ secretKey: string;
10104
+ }[];
10105
+ endUser?: {
10106
+ email?: string;
10107
+ id: string;
10108
+ } & {
10109
+ [key: string]: unknown;
10110
+ };
10111
+ flow?: {
10112
+ contentHash?: string;
10113
+ description?: string;
10114
+ id?: string;
10115
+ name?: string;
10116
+ steps?: unknown[];
10117
+ };
10118
+ /** @description Customer-native auth proof for the Identity Exchange. When present and the surface has a matching integration, the verified tenant/end-user replace any body-asserted tenant/endUser (which are never trusted for web-embedded callers). When Identity Exchange admission is disabled for the caller, the proof is accepted but ignored and confers no trust. */
10119
+ identityProof?: {
10120
+ provider: string;
10121
+ token: string;
10122
+ };
10123
+ inputs?: {
10124
+ [key: string]: unknown;
10125
+ };
10126
+ messages?: {
10127
+ content: string | ({
10128
+ text: string;
10129
+ /** @enum {string} */
10130
+ type: "text";
10131
+ } | {
10132
+ image: string;
10133
+ mimeType?: string;
10134
+ /** @enum {string} */
10135
+ type: "image";
10136
+ } | {
10137
+ data: string;
10138
+ filename: string;
10139
+ mimeType: string;
10140
+ /** @enum {string} */
10141
+ type: "file";
10142
+ } | {
10143
+ providerOptions?: {
10144
+ [key: string]: unknown;
10145
+ };
10146
+ text: string;
10147
+ /** @enum {string} */
10148
+ type: "reasoning";
10149
+ })[];
10150
+ /** @enum {string} */
10151
+ role: "system" | "user" | "assistant";
10152
+ }[];
10153
+ /**
10154
+ * @default {
10155
+ * "autoAppendMetadata": false,
10156
+ * "createVersion": false,
10157
+ * "debugMode": false,
10158
+ * "environment": "development",
10159
+ * "flowMode": "existing",
10160
+ * "recordMode": "existing",
10161
+ * "storeResults": true,
10162
+ * "streamResponse": true
10163
+ * }
10164
+ */
10165
+ options?: {
10166
+ /** @default false */
10167
+ autoAppendMetadata?: boolean;
10168
+ /** @description Set false to disable prompt caching for this request (no cache markers, no cache routing keys). Use for workloads where deterministic byte-identical requests must never share provider cache state, or to A/B against cached behavior. Default: caching follows the account rollout. */
10169
+ cache?: boolean;
10170
+ clientToolOutputs?: {
10171
+ [key: string]: unknown;
10172
+ };
10173
+ /** @default false */
10174
+ createVersion?: boolean;
10175
+ /** @default false */
10176
+ debugMode?: boolean;
10177
+ /**
10178
+ * @default development
10179
+ * @enum {string}
10180
+ */
10181
+ environment?: "development" | "production";
10182
+ /**
10183
+ * @default existing
10184
+ * @enum {string}
10185
+ */
10186
+ flowMode?: "existing" | "create" | "virtual" | "upsert";
10187
+ flowTimeoutMs?: number;
10188
+ flowVersionId?: string;
10189
+ localInference?: {
10190
+ /** @enum {string} */
10191
+ backend: "ollama";
10192
+ model: string;
10193
+ /** Format: uuid */
10194
+ sessionId: string;
10195
+ /** @enum {string} */
10196
+ surface?: "playground" | "flows" | "agents";
10197
+ };
10198
+ /** @enum {string} */
10199
+ loggingPolicy?: "default" | "on" | "off";
10200
+ modelOverride?: string;
10201
+ /**
10202
+ * @default existing
10203
+ * @enum {string}
10204
+ */
10205
+ recordMode?: "existing" | "create" | "virtual";
10206
+ resumeFrom?: {
10207
+ executionId: string;
10208
+ iteration?: number;
10209
+ };
10210
+ stepTimeoutMs?: number;
10211
+ /** @default true */
10212
+ storeResults?: boolean;
10213
+ /** @default true */
10214
+ streamResponse?: boolean;
10215
+ upsertOptions?: {
10216
+ /** @default false */
10217
+ allowOverwriteExternalChanges?: boolean;
10218
+ /** @default true */
10219
+ createVersionOnChange?: boolean;
10220
+ };
10221
+ /** @description For FLOW dispatches this compatibility field is accepted but ignored: eligible flows always use the @runtypelabs/runtime lane, while ineligible flows still fold to legacy silently. Agent dispatches still require an explicit `true` and remain subject to their separate runtime-agent rollout gate. */
10222
+ useRuntimePackage?: boolean;
10223
+ versionLabel?: string;
10224
+ versionNotes?: string;
10225
+ /** @enum {string} */
10226
+ versionType?: "published" | "draft" | "test" | "virtual";
10227
+ };
10228
+ record?: {
10229
+ id?: string;
10230
+ metadata?: {
10231
+ [key: string]: unknown;
10232
+ };
10233
+ name?: string;
10234
+ ownerId?: string;
10235
+ type?: string;
10236
+ };
10237
+ /** @description Per-request credentials for agent/external-tool execution. Ignored when `flow` is the hosted target; FLOW credentials must use managed {{secret:NAME}} references. */
10238
+ secrets?: {
10239
+ [key: string]: string;
10240
+ };
10241
+ tenant?: {
10242
+ id: string;
10243
+ } & {
10244
+ [key: string]: unknown;
10245
+ };
9660
10246
  };
9661
10247
  };
9662
10248
  };
@@ -9667,6 +10253,7 @@ interface paths {
9667
10253
  [name: string]: unknown;
9668
10254
  };
9669
10255
  content: {
10256
+ "application/json": components["schemas"]["DispatchJsonResponse"];
9670
10257
  "text/event-stream": unknown;
9671
10258
  };
9672
10259
  };
@@ -11572,6 +12159,8 @@ interface paths {
11572
12159
  };
11573
12160
  virtual?: boolean;
11574
12161
  };
12162
+ /** @description Run every case against this model instead of the target’s configured one, without editing the suite, the flow, or the agent. Re-run the same suite once per candidate model and compare the scores to choose a model on graded evidence. Applies to flow and agent targets alike. */
12163
+ modelOverride?: string;
11575
12164
  /** @description Strict mode (the `runtype eval --strict` gate): a soft grader miss fails its case like a gate miss. Default false — soft misses are reported per-outcome but do not fail the suite. */
11576
12165
  strict?: boolean;
11577
12166
  suiteId?: string;
@@ -13517,6 +14106,8 @@ interface paths {
13517
14106
  * @enum {string}
13518
14107
  */
13519
14108
  mode?: "sync" | "batch";
14109
+ /** @description Run every case against this model instead of the target’s configured one, without editing the suite or its target. Re-run the same suite once per candidate model and compare scores to pick a model on graded evidence. Applies to both flow and agent targets. */
14110
+ modelOverride?: string;
13520
14111
  /** @description Strict grading: a soft grader miss fails its case like a gate miss. */
13521
14112
  strict?: boolean;
13522
14113
  };
@@ -26065,6 +26656,7 @@ interface paths {
26065
26656
  status: string;
26066
26657
  type: string;
26067
26658
  updatedAt: string;
26659
+ webhookHealth: components["schemas"]["WebhookHealth"];
26068
26660
  }[];
26069
26661
  pagination: components["schemas"]["Pagination"];
26070
26662
  };
@@ -26178,6 +26770,7 @@ interface paths {
26178
26770
  status: string;
26179
26771
  type: string;
26180
26772
  updatedAt: string;
26773
+ webhookHealth: components["schemas"]["WebhookHealth"];
26181
26774
  };
26182
26775
  };
26183
26776
  };
@@ -26542,6 +27135,7 @@ interface paths {
26542
27135
  status: string;
26543
27136
  type: string;
26544
27137
  updatedAt: string;
27138
+ webhookHealth: components["schemas"]["WebhookHealth"];
26545
27139
  };
26546
27140
  };
26547
27141
  };
@@ -26646,6 +27240,7 @@ interface paths {
26646
27240
  status: string;
26647
27241
  type: string;
26648
27242
  updatedAt: string;
27243
+ webhookHealth: components["schemas"]["WebhookHealth"];
26649
27244
  };
26650
27245
  };
26651
27246
  };
@@ -27646,9 +28241,15 @@ interface paths {
27646
28241
  enabled?: boolean;
27647
28242
  executionOptions?: {
27648
28243
  chunkSize?: number;
28244
+ flowTimeoutMs?: number;
28245
+ /** @enum {string} */
28246
+ loggingPolicy?: "default" | "on" | "off";
28247
+ maxRetries?: number;
27649
28248
  modelOverride?: string;
27650
28249
  progressFlushSize?: number;
27651
28250
  recordConcurrency?: number;
28251
+ skipCacheWarm?: boolean;
28252
+ stepTimeoutMs?: number;
27652
28253
  timeoutMs?: number;
27653
28254
  };
27654
28255
  flowId: string;
@@ -27885,9 +28486,15 @@ interface paths {
27885
28486
  enabled?: boolean;
27886
28487
  executionOptions?: {
27887
28488
  chunkSize?: number;
28489
+ flowTimeoutMs?: number;
28490
+ /** @enum {string} */
28491
+ loggingPolicy?: "default" | "on" | "off";
28492
+ maxRetries?: number;
27888
28493
  modelOverride?: string;
27889
28494
  progressFlushSize?: number;
27890
28495
  recordConcurrency?: number;
28496
+ skipCacheWarm?: boolean;
28497
+ stepTimeoutMs?: number;
27891
28498
  timeoutMs?: number;
27892
28499
  };
27893
28500
  flowId?: string;
@@ -28060,7 +28667,169 @@ interface paths {
28060
28667
  patch?: never;
28061
28668
  trace?: never;
28062
28669
  };
28063
- "/v1/products/{id}/surfaces/{surfaceId}/schedules/{scheduleId}/pause": {
28670
+ "/v1/products/{id}/surfaces/{surfaceId}/schedules/{scheduleId}/pause": {
28671
+ parameters: {
28672
+ query?: never;
28673
+ header?: never;
28674
+ path?: never;
28675
+ cookie?: never;
28676
+ };
28677
+ get?: never;
28678
+ put?: never;
28679
+ /**
28680
+ * Pause schedule
28681
+ * @description Pause a schedule (sets enabled to false).
28682
+ */
28683
+ post: {
28684
+ parameters: {
28685
+ query?: never;
28686
+ header?: never;
28687
+ path: {
28688
+ id: string;
28689
+ surfaceId: string;
28690
+ scheduleId: string;
28691
+ };
28692
+ cookie?: never;
28693
+ };
28694
+ requestBody?: never;
28695
+ responses: {
28696
+ /** @description Schedule paused */
28697
+ 200: {
28698
+ headers: {
28699
+ [name: string]: unknown;
28700
+ };
28701
+ content: {
28702
+ "application/json": {
28703
+ status: string;
28704
+ };
28705
+ };
28706
+ };
28707
+ /** @description Invalid ID or surface is not a schedule surface */
28708
+ 400: {
28709
+ headers: {
28710
+ [name: string]: unknown;
28711
+ };
28712
+ content: {
28713
+ "application/json": components["schemas"]["Error"];
28714
+ };
28715
+ };
28716
+ /** @description Unauthorized */
28717
+ 401: {
28718
+ headers: {
28719
+ [name: string]: unknown;
28720
+ };
28721
+ content: {
28722
+ "application/json": components["schemas"]["Error"];
28723
+ };
28724
+ };
28725
+ /** @description Product, surface, or schedule not found */
28726
+ 404: {
28727
+ headers: {
28728
+ [name: string]: unknown;
28729
+ };
28730
+ content: {
28731
+ "application/json": components["schemas"]["Error"];
28732
+ };
28733
+ };
28734
+ /** @description Internal server error */
28735
+ 500: {
28736
+ headers: {
28737
+ [name: string]: unknown;
28738
+ };
28739
+ content: {
28740
+ "application/json": components["schemas"]["Error"];
28741
+ };
28742
+ };
28743
+ };
28744
+ };
28745
+ delete?: never;
28746
+ options?: never;
28747
+ head?: never;
28748
+ patch?: never;
28749
+ trace?: never;
28750
+ };
28751
+ "/v1/products/{id}/surfaces/{surfaceId}/schedules/{scheduleId}/resume": {
28752
+ parameters: {
28753
+ query?: never;
28754
+ header?: never;
28755
+ path?: never;
28756
+ cookie?: never;
28757
+ };
28758
+ get?: never;
28759
+ put?: never;
28760
+ /**
28761
+ * Resume schedule
28762
+ * @description Resume a schedule (sets enabled to true).
28763
+ */
28764
+ post: {
28765
+ parameters: {
28766
+ query?: never;
28767
+ header?: never;
28768
+ path: {
28769
+ id: string;
28770
+ surfaceId: string;
28771
+ scheduleId: string;
28772
+ };
28773
+ cookie?: never;
28774
+ };
28775
+ requestBody?: never;
28776
+ responses: {
28777
+ /** @description Schedule resumed */
28778
+ 200: {
28779
+ headers: {
28780
+ [name: string]: unknown;
28781
+ };
28782
+ content: {
28783
+ "application/json": {
28784
+ status: string;
28785
+ };
28786
+ };
28787
+ };
28788
+ /** @description Invalid ID or surface is not a schedule surface */
28789
+ 400: {
28790
+ headers: {
28791
+ [name: string]: unknown;
28792
+ };
28793
+ content: {
28794
+ "application/json": components["schemas"]["Error"];
28795
+ };
28796
+ };
28797
+ /** @description Unauthorized */
28798
+ 401: {
28799
+ headers: {
28800
+ [name: string]: unknown;
28801
+ };
28802
+ content: {
28803
+ "application/json": components["schemas"]["Error"];
28804
+ };
28805
+ };
28806
+ /** @description Product, surface, or schedule not found */
28807
+ 404: {
28808
+ headers: {
28809
+ [name: string]: unknown;
28810
+ };
28811
+ content: {
28812
+ "application/json": components["schemas"]["Error"];
28813
+ };
28814
+ };
28815
+ /** @description Internal server error */
28816
+ 500: {
28817
+ headers: {
28818
+ [name: string]: unknown;
28819
+ };
28820
+ content: {
28821
+ "application/json": components["schemas"]["Error"];
28822
+ };
28823
+ };
28824
+ };
28825
+ };
28826
+ delete?: never;
28827
+ options?: never;
28828
+ head?: never;
28829
+ patch?: never;
28830
+ trace?: never;
28831
+ };
28832
+ "/v1/products/{id}/surfaces/{surfaceId}/schedules/{scheduleId}/run-now": {
28064
28833
  parameters: {
28065
28834
  query?: never;
28066
28835
  header?: never;
@@ -28070,8 +28839,8 @@ interface paths {
28070
28839
  get?: never;
28071
28840
  put?: never;
28072
28841
  /**
28073
- * Pause schedule
28074
- * @description Pause a schedule (sets enabled to false).
28842
+ * Run schedule immediately
28843
+ * @description Trigger an immediate batch run of a schedule, resolving its records and submitting a batch.
28075
28844
  */
28076
28845
  post: {
28077
28846
  parameters: {
@@ -28086,18 +28855,20 @@ interface paths {
28086
28855
  };
28087
28856
  requestBody?: never;
28088
28857
  responses: {
28089
- /** @description Schedule paused */
28858
+ /** @description Schedule run queued */
28090
28859
  200: {
28091
28860
  headers: {
28092
28861
  [name: string]: unknown;
28093
28862
  };
28094
28863
  content: {
28095
28864
  "application/json": {
28865
+ batchExecutionId: string;
28866
+ recordCount: number;
28096
28867
  status: string;
28097
28868
  };
28098
28869
  };
28099
28870
  };
28100
- /** @description Invalid ID or surface is not a schedule surface */
28871
+ /** @description Invalid ID, no records, or surface is not a schedule surface */
28101
28872
  400: {
28102
28873
  headers: {
28103
28874
  [name: string]: unknown;
@@ -28115,80 +28886,8 @@ interface paths {
28115
28886
  "application/json": components["schemas"]["Error"];
28116
28887
  };
28117
28888
  };
28118
- /** @description Product, surface, or schedule not found */
28119
- 404: {
28120
- headers: {
28121
- [name: string]: unknown;
28122
- };
28123
- content: {
28124
- "application/json": components["schemas"]["Error"];
28125
- };
28126
- };
28127
- /** @description Internal server error */
28128
- 500: {
28129
- headers: {
28130
- [name: string]: unknown;
28131
- };
28132
- content: {
28133
- "application/json": components["schemas"]["Error"];
28134
- };
28135
- };
28136
- };
28137
- };
28138
- delete?: never;
28139
- options?: never;
28140
- head?: never;
28141
- patch?: never;
28142
- trace?: never;
28143
- };
28144
- "/v1/products/{id}/surfaces/{surfaceId}/schedules/{scheduleId}/resume": {
28145
- parameters: {
28146
- query?: never;
28147
- header?: never;
28148
- path?: never;
28149
- cookie?: never;
28150
- };
28151
- get?: never;
28152
- put?: never;
28153
- /**
28154
- * Resume schedule
28155
- * @description Resume a schedule (sets enabled to true).
28156
- */
28157
- post: {
28158
- parameters: {
28159
- query?: never;
28160
- header?: never;
28161
- path: {
28162
- id: string;
28163
- surfaceId: string;
28164
- scheduleId: string;
28165
- };
28166
- cookie?: never;
28167
- };
28168
- requestBody?: never;
28169
- responses: {
28170
- /** @description Schedule resumed */
28171
- 200: {
28172
- headers: {
28173
- [name: string]: unknown;
28174
- };
28175
- content: {
28176
- "application/json": {
28177
- status: string;
28178
- };
28179
- };
28180
- };
28181
- /** @description Invalid ID or surface is not a schedule surface */
28182
- 400: {
28183
- headers: {
28184
- [name: string]: unknown;
28185
- };
28186
- content: {
28187
- "application/json": components["schemas"]["Error"];
28188
- };
28189
- };
28190
- /** @description Unauthorized */
28191
- 401: {
28889
+ /** @description Monthly spend limit exceeded */
28890
+ 402: {
28192
28891
  headers: {
28193
28892
  [name: string]: unknown;
28194
28893
  };
@@ -28205,82 +28904,8 @@ interface paths {
28205
28904
  "application/json": components["schemas"]["Error"];
28206
28905
  };
28207
28906
  };
28208
- /** @description Internal server error */
28209
- 500: {
28210
- headers: {
28211
- [name: string]: unknown;
28212
- };
28213
- content: {
28214
- "application/json": components["schemas"]["Error"];
28215
- };
28216
- };
28217
- };
28218
- };
28219
- delete?: never;
28220
- options?: never;
28221
- head?: never;
28222
- patch?: never;
28223
- trace?: never;
28224
- };
28225
- "/v1/products/{id}/surfaces/{surfaceId}/schedules/{scheduleId}/run-now": {
28226
- parameters: {
28227
- query?: never;
28228
- header?: never;
28229
- path?: never;
28230
- cookie?: never;
28231
- };
28232
- get?: never;
28233
- put?: never;
28234
- /**
28235
- * Run schedule immediately
28236
- * @description Trigger an immediate batch run of a schedule, resolving its records and submitting a batch.
28237
- */
28238
- post: {
28239
- parameters: {
28240
- query?: never;
28241
- header?: never;
28242
- path: {
28243
- id: string;
28244
- surfaceId: string;
28245
- scheduleId: string;
28246
- };
28247
- cookie?: never;
28248
- };
28249
- requestBody?: never;
28250
- responses: {
28251
- /** @description Schedule run queued */
28252
- 200: {
28253
- headers: {
28254
- [name: string]: unknown;
28255
- };
28256
- content: {
28257
- "application/json": {
28258
- batchExecutionId: string;
28259
- recordCount: number;
28260
- status: string;
28261
- };
28262
- };
28263
- };
28264
- /** @description Invalid ID, no records, or surface is not a schedule surface */
28265
- 400: {
28266
- headers: {
28267
- [name: string]: unknown;
28268
- };
28269
- content: {
28270
- "application/json": components["schemas"]["Error"];
28271
- };
28272
- };
28273
- /** @description Unauthorized */
28274
- 401: {
28275
- headers: {
28276
- [name: string]: unknown;
28277
- };
28278
- content: {
28279
- "application/json": components["schemas"]["Error"];
28280
- };
28281
- };
28282
- /** @description Product, surface, or schedule not found */
28283
- 404: {
28907
+ /** @description Daily execution limit exceeded */
28908
+ 429: {
28284
28909
  headers: {
28285
28910
  [name: string]: unknown;
28286
28911
  };
@@ -39049,13 +39674,14 @@ interface paths {
39049
39674
  };
39050
39675
  /**
39051
39676
  * List surfaces
39052
- * @description List product surfaces across all of the authenticated user/org's products with cursor-based pagination. Supports filtering by type, status, and environment. Slack inbound config is returned only for Slack surfaces and only includes safe-to-expose keys.
39677
+ * @description List product surfaces across the authenticated user/org's products with cursor-based pagination. Supports filtering by product, type, status, and environment. Slack inbound config is returned only for Slack surfaces and only includes safe-to-expose keys.
39053
39678
  */
39054
39679
  get: {
39055
39680
  parameters: {
39056
39681
  query?: {
39057
39682
  limit?: string;
39058
39683
  cursor?: string;
39684
+ productId?: string;
39059
39685
  type?: string;
39060
39686
  status?: string;
39061
39687
  environment?: string;
@@ -39094,6 +39720,7 @@ interface paths {
39094
39720
  status: string;
39095
39721
  type: string;
39096
39722
  updatedAt: string;
39723
+ webhookHealth: components["schemas"]["WebhookHealth"];
39097
39724
  }[];
39098
39725
  pagination: components["schemas"]["Pagination"];
39099
39726
  };
@@ -41808,6 +42435,10 @@ interface components {
41808
42435
  persistence?: "ephemeral" | "conversation" | "named";
41809
42436
  /** @enum {string} */
41810
42437
  provider?: "runtype-sandbox" | "daytona";
42438
+ secretEnv?: {
42439
+ [key: string]: string;
42440
+ };
42441
+ setupCommands?: string[];
41811
42442
  /** @enum {string} */
41812
42443
  sleepAfter?: "5m" | "15m" | "30m" | "1h";
41813
42444
  /** @enum {string} */
@@ -42026,6 +42657,75 @@ interface components {
42026
42657
  criteria: string;
42027
42658
  }[];
42028
42659
  };
42660
+ DispatchAgentJsonResponse: {
42661
+ blockReason?: string;
42662
+ claudeManagedAgentId?: string;
42663
+ code?: string;
42664
+ error?: string;
42665
+ /** @enum {string} */
42666
+ executionMode?: "claude_managed";
42667
+ executionTime?: number;
42668
+ externalAgent?: {
42669
+ contextId?: string;
42670
+ taskId?: string;
42671
+ };
42672
+ iterations?: number;
42673
+ pausedReason?: components["schemas"]["DispatchPausedReason"];
42674
+ reflections?: string[];
42675
+ result: string;
42676
+ /** @enum {string} */
42677
+ status?: "completed" | "paused" | "failed";
42678
+ stopReason?: string;
42679
+ success: boolean;
42680
+ totalCost?: number;
42681
+ totalTokens?: {
42682
+ input: number;
42683
+ output: number;
42684
+ };
42685
+ upgradeUrl?: string;
42686
+ };
42687
+ DispatchFlowJsonResponse: {
42688
+ blockReason?: string;
42689
+ code?: string;
42690
+ error?: string;
42691
+ events: components["schemas"]["ExecutionStreamEvent"][];
42692
+ executionSummary: string | number | boolean | null | unknown[] | {
42693
+ [key: string]: unknown;
42694
+ };
42695
+ flowId?: string;
42696
+ pausedReason?: components["schemas"]["DispatchPausedReason"];
42697
+ recordId?: string;
42698
+ /** @enum {string} */
42699
+ status: "completed" | "paused" | "failed";
42700
+ success: boolean;
42701
+ totalEvents: number;
42702
+ upgradeUrl?: string;
42703
+ };
42704
+ DispatchJsonResponse: components["schemas"]["DispatchFlowJsonResponse"] | components["schemas"]["DispatchAgentJsonResponse"];
42705
+ DispatchPausedReason: {
42706
+ approvalId?: string;
42707
+ awaitReason?: string;
42708
+ elicitation?: {
42709
+ [key: string]: unknown;
42710
+ };
42711
+ executionId: string;
42712
+ parameters: {
42713
+ [key: string]: unknown;
42714
+ };
42715
+ toolId: string;
42716
+ toolName: string;
42717
+ /** @enum {string} */
42718
+ type: "local_action";
42719
+ } | {
42720
+ crawlId?: string;
42721
+ stepId?: string;
42722
+ /** @enum {string} */
42723
+ type: "crawl_pending";
42724
+ } | {
42725
+ stepId?: string;
42726
+ /** @enum {string} */
42727
+ type: "durable_poll";
42728
+ };
42029
42729
  EndUserAuthConsumeRequest: {
42030
42730
  tenantOrganizationId: string;
42031
42731
  /** @description The one-time sign-in token from the email */
@@ -43445,6 +44145,16 @@ interface components {
43445
44145
  [key: string]: unknown;
43446
44146
  };
43447
44147
  };
44148
+ WebhookHealth: {
44149
+ /** @description ISO timestamp of the most recent accepted inbound delivery. */
44150
+ lastDeliveryAt: string | null;
44151
+ /** @description Most recent inbound rejections, newest first, capped at a small fixed number. A failure newer than lastDeliveryAt means the webhook is currently rejecting events (commonly a credential mismatch such as a wrong Slack signing secret). */
44152
+ recentFailures: {
44153
+ at: string;
44154
+ reason: string;
44155
+ statusCode?: number;
44156
+ }[];
44157
+ } | null;
43448
44158
  };
43449
44159
  responses: never;
43450
44160
  parameters: never;
@@ -44245,6 +44955,7 @@ interface UpsertOptions$1 {
44245
44955
  /** Allow overwriting changes made via dashboard/API (default: false) */
44246
44956
  allowOverwriteExternalChanges?: boolean;
44247
44957
  }
44958
+ /** Flow-only dispatch options sourced from the canonical API envelope. */
44248
44959
  interface DispatchOptions$1 {
44249
44960
  streamResponse?: boolean;
44250
44961
  modelOverride?: string;
@@ -44253,24 +44964,34 @@ interface DispatchOptions$1 {
44253
44964
  storeResults?: boolean;
44254
44965
  autoAppendMetadata?: boolean;
44255
44966
  debugMode?: boolean;
44967
+ loggingPolicy?: 'default' | 'on' | 'off';
44968
+ /** Ignored for flows; runtime eligibility selects the engine. */
44969
+ useRuntimePackage?: boolean;
44970
+ localInference?: {
44971
+ sessionId: string;
44972
+ model: string;
44973
+ backend: 'ollama';
44974
+ surface?: 'playground' | 'flows' | 'agents';
44975
+ };
44976
+ environment?: 'development' | 'production';
44256
44977
  createVersion?: boolean;
44257
44978
  versionType?: 'published' | 'draft' | 'test' | 'virtual';
44258
44979
  versionLabel?: string;
44259
44980
  versionNotes?: string;
44260
44981
  flowVersionId?: string;
44261
- /** Options for upsert mode (only used when flowMode is 'upsert') */
44982
+ /** Options for upsert mode (only used when flowMode is `upsert`). */
44262
44983
  upsertOptions?: UpsertOptions$1;
44263
44984
  flowTimeoutMs?: number;
44264
44985
  stepTimeoutMs?: number;
44265
44986
  /**
44266
- * Set false to disable prompt caching for this request (no cache markers, no
44267
- * cache routing keys). Default: caching follows the account rollout.
44987
+ * Set false to disable prompt caching for this request. Default: caching
44988
+ * follows the account rollout.
44268
44989
  */
44269
44990
  cache?: boolean;
44270
44991
  }
44271
44992
  interface Message$1 {
44272
44993
  role: 'system' | 'user' | 'assistant';
44273
- content: MessageContent;
44994
+ content: DispatchMessageContent;
44274
44995
  }
44275
44996
  /**
44276
44997
  * Union type of all possible flow-execution SSE events.
@@ -45231,7 +45952,8 @@ interface ClientToolDefinition {
45231
45952
  * `Record<string, unknown>` (matching {@link LocalToolDefinition} in
45232
45953
  * `endpoints.ts`) so callers can pass JSON Schema fragments built with
45233
45954
  * any helper library (Zod-to-JSON-Schema, ajv, hand-written, etc.)
45234
- * without fighting the strict {@link JSONSchema} surface.
45955
+ * without fighting the strict {@link JSONSchema} surface. Dispatch validates
45956
+ * that the runtime value has `type: "object"` before sending it to the API.
45235
45957
  */
45236
45958
  parametersSchema: Record<string, unknown>;
45237
45959
  origin?: 'webmcp' | 'sdk';
@@ -45270,96 +45992,82 @@ type FlowStepType = NonNullable<CreateFlowRequestBody['flowSteps']>[number]['typ
45270
45992
  type FlowStepDefinition = Omit<NonNullable<CreateFlowRequestBody['flowSteps']>[number], 'name'> & {
45271
45993
  name?: string;
45272
45994
  };
45273
- interface DispatchRequest {
45274
- record?: {
45275
- id?: number | string;
45276
- name?: string;
45277
- type?: string;
45278
- /** First-class owner; stored as `metadata.ownerId` (overrides any value in `metadata`). */
45279
- ownerId?: string;
45280
- metadata?: Metadata;
45281
- };
45282
- flow: {
45283
- id?: string;
45284
- name?: string;
45285
- contentHash?: string;
45286
- steps?: FlowStepDefinition[];
45287
- };
45995
+ type GeneratedDispatchRequest = NonNullable<NonNullable<paths['/v1/dispatch']['post']>['requestBody']>['content']['application/json'];
45996
+ /**
45997
+ * Buffered response returned by `/v1/dispatch` when
45998
+ * `options.streamResponse:false`.
45999
+ *
46000
+ * Generated from the route's named `DispatchJsonResponse` OpenAPI component;
46001
+ * streaming callers receive `ExecutionStreamEvent` frames instead.
46002
+ */
46003
+ type DispatchResponse = paths['/v1/dispatch']['post']['responses'][200]['content']['application/json'];
46004
+ /** @internal */
46005
+ type CanonicalDispatchMessageContent = NonNullable<NonNullable<GeneratedDispatchRequest['messages']>[number]['content']>;
46006
+ /**
46007
+ * Message content accepted by the SDK dispatch authoring surface.
46008
+ *
46009
+ * `asset_ref` remains in this source-compatible input type because it was
46010
+ * already part of `DispatchRequest` through {@link MessageContent}. It is an
46011
+ * internal persisted-message representation rather than a public wire shape,
46012
+ * so the dispatch endpoint rejects it before sending instead of silently
46013
+ * serializing a request the API cannot accept.
46014
+ */
46015
+ type DispatchMessageContent = MessageContent;
46016
+ /** Flow input accepted by the canonical `/v1/dispatch` request schema. */
46017
+ type DispatchFlowInput = Omit<NonNullable<GeneratedDispatchRequest['flow']>, 'steps'> & {
46018
+ steps?: FlowStepDefinition[];
46019
+ };
46020
+ /** Agent input accepted by the canonical `/v1/dispatch` request schema. */
46021
+ type DispatchAgentInput = NonNullable<GeneratedDispatchRequest['agent']>;
46022
+ type CanonicalDispatchRequestEnvelope = Omit<GeneratedDispatchRequest, 'flow' | 'agent'>;
46023
+ /**
46024
+ * Exact request body emitted by the SDK after compatibility normalization.
46025
+ *
46026
+ * @internal
46027
+ */
46028
+ type CanonicalDispatchRequest = (CanonicalDispatchRequestEnvelope & {
46029
+ flow: DispatchFlowInput;
46030
+ agent?: DispatchAgentInput;
46031
+ }) | (CanonicalDispatchRequestEnvelope & {
46032
+ agent: DispatchAgentInput;
46033
+ flow?: DispatchFlowInput;
46034
+ });
46035
+ type DispatchRecordInput = Omit<NonNullable<GeneratedDispatchRequest['record']>, 'id'> & {
46036
+ /**
46037
+ * @deprecated Numeric record ids are retained as an SDK input compatibility
46038
+ * alias and normalized to the API's canonical string wire type.
46039
+ */
46040
+ id?: string | number;
46041
+ };
46042
+ type DispatchRequestEnvelope = Omit<CanonicalDispatchRequestEnvelope, 'record' | 'messages' | 'clientTools'> & {
46043
+ record?: DispatchRecordInput;
45288
46044
  messages?: Array<{
45289
46045
  role: 'system' | 'user' | 'assistant';
45290
- content: MessageContent;
46046
+ content: DispatchMessageContent;
45291
46047
  }>;
45292
46048
  /**
45293
- * Per-dispatch client tools. The SDK populates this when
45294
- * `runWithLocalTools` is invoked with `{ scope: 'turn' }` (or when
45295
- * Persona snapshots the host page's WebMCP registry). Tool execution
45296
- * happens client-side; the server pauses the agent with
45297
- * `step_await` / `agent_await` and resumes once the client posts the
45298
- * result. Complementary to the in-engine `resolveTools` callback —
45299
- * `clientTools[]` is per-dispatch, `resolveTools` is per-iteration.
46049
+ * Kept on the historical SDK authoring type so schema-builder outputs typed
46050
+ * as generic records remain source-compatible. The dispatch boundary checks
46051
+ * every schema root before emitting the canonical wire request.
45300
46052
  */
45301
46053
  clientTools?: ClientToolDefinition[];
45302
- /**
45303
- * Optional policy governing how `clientTools[]` are admitted on this
45304
- * (API-key) dispatch. On the API-key path the caller is trusted, so
45305
- * `origin: 'webmcp'` tools are admitted by default — their presence in
45306
- * `clientTools[]` is the opt-in. `allowlist` is an optional self-restriction
45307
- * (glob patterns: exact, or single trailing `*`) narrowing which webmcp
45308
- * tools are accepted; omit it to admit all. `origin: 'sdk'` tools are never
45309
- * gated. Mirrors the shared `ClientToolsPolicy`.
45310
- */
45311
- clientToolsPolicy?: {
45312
- allowlist?: string[];
45313
- };
45314
- secrets?: Record<string, string>;
45315
- inputs?: Record<string, unknown>;
45316
- /**
45317
- * End-user identity for multi-tenant SaaS callers whose users are not Runtype account
45318
- * holders. Exposed as `{{_endUser.id}}`, `{{_endUser.email}}`, etc. in template variables
45319
- * — used most commonly by agent memory namespace templates like `{{_endUser.id}}` to
45320
- * shard long-term memory per end-user. Extra fields (name, tier, custom claims) are
45321
- * forwarded verbatim and exposed under `_endUser.*`.
45322
- */
45323
- endUser?: {
45324
- id: string;
45325
- email?: string;
45326
- [key: string]: unknown;
45327
- };
45328
- /**
45329
- * Product Tenant identity — the builder's customer/account/workspace *inside* a
45330
- * Product (the customer's customer), nested under the Builder Org (`_user`) and
45331
- * above the End User (`_endUser`). Exposed as `{{_tenant.id}}` (and any
45332
- * passthrough fields under `_tenant.*`) in template variables. Use it to address
45333
- * the account-level scope shared by all of a tenant's end-users. Caller-asserted.
45334
- */
45335
- tenant?: {
45336
- id: string;
45337
- [key: string]: unknown;
45338
- };
45339
- options?: {
45340
- streamResponse?: boolean;
45341
- modelOverride?: string;
45342
- recordMode?: 'existing' | 'create' | 'virtual';
45343
- flowMode?: 'existing' | 'create' | 'virtual' | 'upsert';
45344
- storeResults?: boolean;
45345
- autoAppendMetadata?: boolean;
45346
- debugMode?: boolean;
45347
- environment?: DispatchEnvironment;
45348
- createVersion?: boolean;
45349
- versionType?: 'published' | 'draft' | 'test' | 'virtual';
45350
- versionLabel?: string;
45351
- versionNotes?: string;
45352
- flowVersionId?: string;
45353
- upsertOptions?: UpsertOptions;
45354
- flowTimeoutMs?: number;
45355
- stepTimeoutMs?: number;
45356
- /**
45357
- * Set false to disable prompt caching for this request (no cache markers,
45358
- * no cache routing keys). Default: caching follows the account rollout.
45359
- */
45360
- cache?: boolean;
45361
- };
45362
- }
46054
+ };
46055
+ /**
46056
+ * Canonical `/v1/dispatch` request body, generated from the API's shared
46057
+ * `DispatchRequestSchema`.
46058
+ *
46059
+ * The OpenAPI shape supplies every public field and option. This small union
46060
+ * adds the schema's cross-field invariant that at least one execution target
46061
+ * (`flow` or `agent`) is required, while preserving the stricter
46062
+ * {@link FlowStepDefinition} type for inline flow steps.
46063
+ */
46064
+ type DispatchRequest = (DispatchRequestEnvelope & {
46065
+ flow: DispatchFlowInput;
46066
+ agent?: DispatchAgentInput;
46067
+ }) | (DispatchRequestEnvelope & {
46068
+ agent: DispatchAgentInput;
46069
+ flow?: DispatchFlowInput;
46070
+ });
45363
46071
  interface ListParams {
45364
46072
  limit?: number;
45365
46073
  cursor?: string;
@@ -45385,9 +46093,9 @@ interface FlowToolConfig {
45385
46093
  flowId?: string;
45386
46094
  toolId?: string;
45387
46095
  /**
45388
- * Inline flow definition, resolved first by the `@runtypelabs/runtime`
45389
- * execution lane (dispatch with `options.useRuntimePackage: true`); the
45390
- * legacy lane requires a `flowId`/`toolId` reference.
46096
+ * Inline flow definition. Runtime-selected agent dispatches support this with
46097
+ * `options.useRuntimePackage: true`; hosted flow definitions currently
46098
+ * require a `flowId`/`toolId` reference.
45391
46099
  */
45392
46100
  flow?: Record<string, unknown>;
45393
46101
  /** Registered-flow name key for the runtime lane (`flowName ?? flowId`). */
@@ -45535,9 +46243,9 @@ interface RuntimeFlowToolConfig {
45535
46243
  flowId?: string;
45536
46244
  toolId?: string;
45537
46245
  /**
45538
- * Inline flow definition, resolved first by the `@runtypelabs/runtime`
45539
- * execution lane (dispatch with `options.useRuntimePackage: true`); the
45540
- * legacy lane requires a `flowId`/`toolId` reference.
46246
+ * Inline flow definition. Runtime-selected agent dispatches support this with
46247
+ * `options.useRuntimePackage: true`; hosted flow definitions currently
46248
+ * require a `flowId`/`toolId` reference.
45541
46249
  */
45542
46250
  flow?: Record<string, unknown>;
45543
46251
  /** Registered-flow name key for the runtime lane (`flowName ?? flowId`). */
@@ -49793,9 +50501,21 @@ declare class RuntypeClient$1 {
49793
50501
  */
49794
50502
  requestStream(path: string, options?: RequestInit): Promise<Response>;
49795
50503
  /**
49796
- * Dispatch flow execution (streaming)
50504
+ * Dispatch flow execution (streaming).
50505
+ *
50506
+ * This is the sole streaming-dispatch chokepoint for the flow builders
50507
+ * (`RuntypeFlowBuilder`), so it normalizes the request to the canonical
50508
+ * `/v1/dispatch` wire contract here — every builder path inherits the same
50509
+ * normalization the `DispatchEndpoint` applies, with no per-builder call.
49797
50510
  */
49798
50511
  dispatch(config: unknown): Promise<Response>;
50512
+ /**
50513
+ * Dispatch flow execution (non-streaming JSON).
50514
+ *
50515
+ * The non-streaming sibling of {@link dispatch}; it normalizes to the same
50516
+ * canonical wire contract so builders never post a raw, un-normalized body.
50517
+ */
50518
+ dispatchJson<T>(config: unknown): Promise<T>;
49799
50519
  /**
49800
50520
  * Build full URL with query parameters
49801
50521
  */
@@ -51361,6 +52081,7 @@ interface AgentToolStartEvent extends BaseAgentEvent {
51361
52081
  toolName: string;
51362
52082
  toolType: 'flow' | 'mcp' | 'builtin' | 'custom' | 'external' | 'advisor' | 'subagent' | 'local';
51363
52083
  parameters?: Record<string, unknown>;
52084
+ hiddenParameterNames?: string[];
51364
52085
  /**
51365
52086
  * Provenance for client-executed tools (entered via
51366
52087
  * `dispatch.clientTools[]`). `'webmcp'` marks page-discovered tools
@@ -52931,6 +53652,10 @@ type LocalToolHandler = (args: unknown) => Promise<unknown>;
52931
53652
  */
52932
53653
  interface LocalToolEntry {
52933
53654
  description: string;
53655
+ /**
53656
+ * Kept wide so callers may pass schema-builder output typed as a generic
53657
+ * record. Turn-scoped dispatch validates the required object root at runtime.
53658
+ */
52934
53659
  parametersSchema: Record<string, unknown>;
52935
53660
  execute: (args: unknown) => Promise<unknown>;
52936
53661
  origin?: 'webmcp' | 'sdk';
@@ -54657,4 +55382,4 @@ declare function getLikelySupportingCandidatePaths(bestCandidatePath: string | u
54657
55382
  declare function getDefaultPlanPath(taskName: string): string;
54658
55383
  declare function sanitizeTaskSlug(taskName: string): string;
54659
55384
 
54660
- export { type AIGrader, type Agent, type AgentApprovalCompleteEvent, type AgentApprovalStartEvent, type AgentCompleteEvent, type AgentDefinition, type AgentDefinitionConfig, AgentDriftError, 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, ApiKeysEndpoint, type ApiResponse, type ApplyGeneratedProposalOptions, type ApplyGeneratedProposalResult, type AssetReferenceContentPart, 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 CaseExpected, ChatEndpoint, type CheckGrader, ClientBatchBuilder, type ClientConfig, type ClientConversation, ClientEvalBuilder, ClientFlowBuilder, type ClientToken, type ClientTokenConfig, type ClientTokenEnvironment, type ClientTokenVersionPin, ClientTokensEndpoint, type ClientToolDefinition, type ClientWidgetTheme, 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 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_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 DiscoveredModel, type DispatchClient, DispatchEndpoint, type DispatchEnvironment, type DispatchEvent, type DispatchOptions$1 as DispatchOptions, type DispatchRequest, 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 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, 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 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 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 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 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 SkillScanFinding as RuntypeSkillScanFinding, type SkillScanResult as RuntypeSkillScanResult, type SkillScanVerdict as RuntypeSkillScanVerdict, 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 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, 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, 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, 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, withUnifiedEvents };
55385
+ export { type AIGrader, type Agent, type AgentApprovalCompleteEvent, type AgentApprovalStartEvent, type AgentCompleteEvent, type AgentDefinition, type AgentDefinitionConfig, AgentDriftError, 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, ApiKeysEndpoint, type ApiResponse, type ApplyGeneratedProposalOptions, type ApplyGeneratedProposalResult, type AssetReferenceContentPart, 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, ChatEndpoint, type CheckGrader, ClientBatchBuilder, type ClientConfig, type ClientConversation, ClientEvalBuilder, ClientFlowBuilder, type ClientToken, type ClientTokenConfig, type ClientTokenEnvironment, type ClientTokenVersionPin, ClientTokensEndpoint, type ClientToolDefinition, type ClientWidgetTheme, 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 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_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 DiscoveredModel, type DispatchAgentInput, type DispatchClient, DispatchEndpoint, type DispatchEnvironment, type DispatchEvent, type DispatchFlowInput, type DispatchMessageContent, type DispatchOptions$1 as DispatchOptions, type DispatchRequest, type DispatchResponse, 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 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, 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 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 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 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 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 SkillScanFinding as RuntypeSkillScanFinding, type SkillScanResult as RuntypeSkillScanResult, type SkillScanVerdict as RuntypeSkillScanVerdict, 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 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, 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, 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, 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, withUnifiedEvents };