@runtypelabs/sdk 11.19.2 → 11.20.1

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.cjs CHANGED
@@ -1151,7 +1151,8 @@ var FlowBuilder = class {
1151
1151
  url: config.url,
1152
1152
  method: config.method || "GET",
1153
1153
  headers: config.headers,
1154
- body: config.body
1154
+ body: config.body,
1155
+ ...config.multipart !== void 0 && { multipart: config.multipart }
1155
1156
  },
1156
1157
  auth: config.auth,
1157
1158
  responseType: config.responseType,
@@ -10455,7 +10456,8 @@ var RuntypeFlowBuilder = class {
10455
10456
  url: config.url,
10456
10457
  method: config.method || "GET",
10457
10458
  headers: config.headers,
10458
- body: config.body
10459
+ body: config.body,
10460
+ ...config.multipart !== void 0 && { multipart: config.multipart }
10459
10461
  },
10460
10462
  auth: config.auth,
10461
10463
  responseType: config.responseType,
@@ -14830,7 +14832,7 @@ function transformQueryParams(params) {
14830
14832
  return result;
14831
14833
  }
14832
14834
  // src/version.ts
14833
- const SDK_VERSION = "11.19.2";
14835
+ const SDK_VERSION = "11.20.1";
14834
14836
  /**
14835
14837
  * Canonical client identity the API uses for attribution
14836
14838
  * (`detectActorSource` in apps/api/src/lib/audit-log.ts keys `'sdk'` off the
@@ -15863,6 +15865,11 @@ const STEP_FIELD_REGISTRY = {
15863
15865
  format: "template",
15864
15866
  source: "http.body"
15865
15867
  },
15868
+ {
15869
+ key: "multipart",
15870
+ format: "value",
15871
+ source: "http.multipart"
15872
+ },
15866
15873
  {
15867
15874
  key: "auth",
15868
15875
  format: "value"
package/dist/index.d.cts CHANGED
@@ -13120,6 +13120,7 @@ interface paths {
13120
13120
  conversations: {
13121
13121
  createdAt: string;
13122
13122
  id: string;
13123
+ /** @description Stored messages. For `source: client_token` this counts chat messages before tool results are split into their own `tool` messages, so it can be lower than the detail `messages` length. */
13123
13124
  messageCount: number;
13124
13125
  modelId: string | null;
13125
13126
  ownerId: string | null;
@@ -13219,6 +13220,7 @@ interface paths {
13219
13220
  id: string;
13220
13221
  /** @description Set by POST /v1/conversations only. True when this call created the conversation (201); false when a conversation with the same source.system and source.externalId already existed and is returned unchanged (200). */
13221
13222
  imported?: boolean;
13223
+ /** @description The full ordered transcript, never paginated or capped. For `source: client_token` (Persona web chat) it is read from the chat transcript the widget wrote (also kept in `metadata.messages`): `timestamp` is returned as `createdAt`, `displayContent` as `metadata.displayContent`, and an assistant message that called tools carries `toolCalls` followed by a `tool` message (id `<assistant id>_tool_results`) holding each settled result; a call still awaiting approval or a client answer has no result. */
13222
13224
  messages: components["schemas"]["ConversationTranscriptMessage"][];
13223
13225
  metadata: {
13224
13226
  [key: string]: unknown;
@@ -13249,6 +13251,7 @@ interface paths {
13249
13251
  id: string;
13250
13252
  /** @description Set by POST /v1/conversations only. True when this call created the conversation (201); false when a conversation with the same source.system and source.externalId already existed and is returned unchanged (200). */
13251
13253
  imported?: boolean;
13254
+ /** @description The full ordered transcript, never paginated or capped. For `source: client_token` (Persona web chat) it is read from the chat transcript the widget wrote (also kept in `metadata.messages`): `timestamp` is returned as `createdAt`, `displayContent` as `metadata.displayContent`, and an assistant message that called tools carries `toolCalls` followed by a `tool` message (id `<assistant id>_tool_results`) holding each settled result; a call still awaiting approval or a client answer has no result. */
13252
13255
  messages: components["schemas"]["ConversationTranscriptMessage"][];
13253
13256
  metadata: {
13254
13257
  [key: string]: unknown;
@@ -13373,6 +13376,7 @@ interface paths {
13373
13376
  id: string;
13374
13377
  /** @description Set by POST /v1/conversations only. True when this call created the conversation (201); false when a conversation with the same source.system and source.externalId already existed and is returned unchanged (200). */
13375
13378
  imported?: boolean;
13379
+ /** @description The full ordered transcript, never paginated or capped. For `source: client_token` (Persona web chat) it is read from the chat transcript the widget wrote (also kept in `metadata.messages`): `timestamp` is returned as `createdAt`, `displayContent` as `metadata.displayContent`, and an assistant message that called tools carries `toolCalls` followed by a `tool` message (id `<assistant id>_tool_results`) holding each settled result; a call still awaiting approval or a client answer has no result. */
13376
13380
  messages: components["schemas"]["ConversationTranscriptMessage"][];
13377
13381
  metadata: {
13378
13382
  [key: string]: unknown;
@@ -13486,6 +13490,7 @@ interface paths {
13486
13490
  id: string;
13487
13491
  /** @description Set by POST /v1/conversations only. True when this call created the conversation (201); false when a conversation with the same source.system and source.externalId already existed and is returned unchanged (200). */
13488
13492
  imported?: boolean;
13493
+ /** @description The full ordered transcript, never paginated or capped. For `source: client_token` (Persona web chat) it is read from the chat transcript the widget wrote (also kept in `metadata.messages`): `timestamp` is returned as `createdAt`, `displayContent` as `metadata.displayContent`, and an assistant message that called tools carries `toolCalls` followed by a `tool` message (id `<assistant id>_tool_results`) holding each settled result; a call still awaiting approval or a client answer has no result. */
13489
13494
  messages: components["schemas"]["ConversationTranscriptMessage"][];
13490
13495
  metadata: {
13491
13496
  [key: string]: unknown;
@@ -41114,6 +41119,129 @@ interface paths {
41114
41119
  patch?: never;
41115
41120
  trace?: never;
41116
41121
  };
41122
+ "/v1/products/{productId}/surfaces/{surfaceId}/cli/preview": {
41123
+ parameters: {
41124
+ query?: never;
41125
+ header?: never;
41126
+ path?: never;
41127
+ cookie?: never;
41128
+ };
41129
+ /**
41130
+ * Preview a CLI surface
41131
+ * @description Renders the saved `cli` surface the way a publish would build it: the exact `--help` text of the CLI and of each command, each command's flags and an example, and the SKILL.md. Compares that build with the version the install host serves, listing added, removed and changed commands and changed settings. Reads the install host's bucket and never writes to it; a surface that is turned off still previews.
41132
+ */
41133
+ get: {
41134
+ parameters: {
41135
+ query?: never;
41136
+ header?: never;
41137
+ path: {
41138
+ productId: string;
41139
+ surfaceId: string;
41140
+ };
41141
+ cookie?: never;
41142
+ };
41143
+ requestBody?: never;
41144
+ responses: {
41145
+ /** @description Preview */
41146
+ 200: {
41147
+ headers: {
41148
+ [name: string]: unknown;
41149
+ };
41150
+ content: {
41151
+ "application/json": components["schemas"]["CliPreview"];
41152
+ };
41153
+ };
41154
+ /** @description Invalid IDs, no valid command name (`CLI_BIN_NAME_REQUIRED`) or a name the publish refuses (`CLI_NAME_REJECTED`) */
41155
+ 400: {
41156
+ headers: {
41157
+ [name: string]: unknown;
41158
+ };
41159
+ content: {
41160
+ "application/json": {
41161
+ code?: string;
41162
+ error: string;
41163
+ issues?: {
41164
+ code: string;
41165
+ message: string;
41166
+ /** @enum {string} */
41167
+ verdict: "review" | "reject";
41168
+ }[];
41169
+ };
41170
+ };
41171
+ };
41172
+ /** @description Insufficient permissions, `CLI_SURFACE_PUBLISH_DISABLED` while publishing is off for the account, or `CLI_INSTALL_DOMAIN_DISABLED` for an install domain while custom install domains are off */
41173
+ 403: {
41174
+ headers: {
41175
+ [name: string]: unknown;
41176
+ };
41177
+ content: {
41178
+ "application/json": {
41179
+ code?: string;
41180
+ error: string;
41181
+ issues?: {
41182
+ code: string;
41183
+ message: string;
41184
+ /** @enum {string} */
41185
+ verdict: "review" | "reject";
41186
+ }[];
41187
+ };
41188
+ };
41189
+ };
41190
+ /** @description Product or CLI surface not found */
41191
+ 404: {
41192
+ headers: {
41193
+ [name: string]: unknown;
41194
+ };
41195
+ content: {
41196
+ "application/json": components["schemas"]["Error"];
41197
+ };
41198
+ };
41199
+ /** @description `CLI_DIST_UNAVAILABLE`: the install host's storage failed */
41200
+ 502: {
41201
+ headers: {
41202
+ [name: string]: unknown;
41203
+ };
41204
+ content: {
41205
+ "application/json": {
41206
+ code?: string;
41207
+ error: string;
41208
+ issues?: {
41209
+ code: string;
41210
+ message: string;
41211
+ /** @enum {string} */
41212
+ verdict: "review" | "reject";
41213
+ }[];
41214
+ };
41215
+ };
41216
+ };
41217
+ /** @description `CLI_DIST_NOT_CONFIGURED`: this deployment has no `CLI_DIST` bucket or install host */
41218
+ 503: {
41219
+ headers: {
41220
+ [name: string]: unknown;
41221
+ };
41222
+ content: {
41223
+ "application/json": {
41224
+ code?: string;
41225
+ error: string;
41226
+ issues?: {
41227
+ code: string;
41228
+ message: string;
41229
+ /** @enum {string} */
41230
+ verdict: "review" | "reject";
41231
+ }[];
41232
+ };
41233
+ };
41234
+ };
41235
+ };
41236
+ };
41237
+ put?: never;
41238
+ post?: never;
41239
+ delete?: never;
41240
+ options?: never;
41241
+ head?: never;
41242
+ patch?: never;
41243
+ trace?: never;
41244
+ };
41117
41245
  "/v1/products/{productId}/surfaces/{surfaceId}/cli/publish": {
41118
41246
  parameters: {
41119
41247
  query?: never;
@@ -55055,7 +55183,7 @@ interface paths {
55055
55183
  put?: never;
55056
55184
  /**
55057
55185
  * Bind a signal set to an agent
55058
- * @description Evaluate a set version on every matching turn of an agent from now on. Refused for an agent with loggingPolicy "off" and under zero data retention; an organization handling PHI must pass acknowledgeExternalProcessing.
55186
+ * @description Evaluate a set version on every matching turn of an agent from now on. Its model calls bill to the organization’s usage like any other model call. Refused for an agent with loggingPolicy "off" and under zero data retention; an organization handling PHI must pass acknowledgeExternalProcessing.
55059
55187
  */
55060
55188
  post: {
55061
55189
  parameters: {
@@ -55069,10 +55197,11 @@ interface paths {
55069
55197
  "application/json": {
55070
55198
  /** @description Required for a PHI organization whose set uses a decision model outside Cloudflare Workers AI. Written to the audit log. */
55071
55199
  acknowledgeExternalProcessing?: boolean;
55072
- /** @description Default $25 a month. */
55073
- budget?: {
55074
- monthlyUsd: number;
55075
- };
55200
+ /**
55201
+ * @deprecated
55202
+ * @description Ignored. Bindings have no budget; their model calls bill to the organization’s usage.
55203
+ */
55204
+ budget?: unknown;
55076
55205
  coverage?: {
55077
55206
  /** @enum {string} */
55078
55207
  mode: "all";
@@ -61661,6 +61790,99 @@ interface components {
61661
61790
  recordValue: string;
61662
61791
  } | null;
61663
61792
  } | null;
61793
+ CliPreview: {
61794
+ /** @description The command name the preview renders, which is also the install slug */
61795
+ binName: string;
61796
+ /** @description The built-in commands every CLI has, as `--help` lists them */
61797
+ builtins: {
61798
+ command: string;
61799
+ description: string;
61800
+ }[];
61801
+ /** @description One entry per tool command, hidden ones included, sorted by command path */
61802
+ commands: components["schemas"]["CliPreviewCommand"][];
61803
+ /** @description The name `--help` opens with: the product name */
61804
+ displayName: string;
61805
+ /** @description The exact text `<bin> --help` prints */
61806
+ help: string;
61807
+ publish: components["schemas"]["CliPreviewPublish"];
61808
+ /** @description The SKILL.md a publish writes and `<bin> skill install` installs */
61809
+ skill: string;
61810
+ };
61811
+ CliPreviewCommand: {
61812
+ /** @description Other paths that reach the command, e.g. the hyphenated name */
61813
+ aliases: string[];
61814
+ /** @description The tool shares its name with a built-in, so only `<bin> call <tool>` reaches it */
61815
+ callOnly: boolean;
61816
+ /** @description The command path after the command name, e.g. `search_tickets` or `call login` */
61817
+ command: string;
61818
+ /** @description A runnable example invocation with every required flag */
61819
+ example: string;
61820
+ /** @description The flags `<bin> <command> --help` lists, in order */
61821
+ flags: components["schemas"]["CliPreviewFlag"][];
61822
+ /** @description The exact text `<bin> <command> --help` prints */
61823
+ help: string;
61824
+ /** @description A command override hides it from `--help`; it still runs */
61825
+ hidden: boolean;
61826
+ /** @description The description is the `Execute the <tool> capability` default a capability without a description gets */
61827
+ placeholderDescription: boolean;
61828
+ /** @description The first sentence of the description, as `--help` lists it */
61829
+ summary: string;
61830
+ /** @description The MCP tool the command calls */
61831
+ tool: string;
61832
+ /** @description The usage line, e.g. `acme search_tickets <query> [flags]` */
61833
+ usage: string;
61834
+ };
61835
+ CliPreviewFlag: {
61836
+ /** @description The schema default, when it declares one */
61837
+ default?: unknown;
61838
+ /** @description The first sentence of the argument's description; empty when it has none */
61839
+ description: string;
61840
+ /** @description The accepted values of an enum argument */
61841
+ enum?: unknown[];
61842
+ /** @description The flag without its leading `--`, e.g. `ticket-id` */
61843
+ name: string;
61844
+ /** @description Also accepted as a positional argument */
61845
+ positional: boolean;
61846
+ /** @description Takes the flag more than once, one value each time */
61847
+ repeatable: boolean;
61848
+ required: boolean;
61849
+ /** @description A TypeScript-style type, as the signature line prints it, e.g. `"open" | "closed"` */
61850
+ type: string;
61851
+ /** @description The tool argument the flag sets, e.g. `ticketId` */
61852
+ wire: string;
61853
+ };
61854
+ CliPreviewPublish: {
61855
+ /** @description What a publish would change; null while unpublished */
61856
+ changes: {
61857
+ commandsAdded: {
61858
+ command: string;
61859
+ tool: string;
61860
+ }[];
61861
+ commandsChanged: {
61862
+ command: string;
61863
+ fields: ("name" | "aliases" | "hidden" | "description" | "flags")[];
61864
+ tool: string;
61865
+ }[];
61866
+ commandsRemoved: {
61867
+ command: string;
61868
+ tool: string;
61869
+ }[];
61870
+ /** @description `binName`: the published version is under another command name. `installDomain`: the requested install domain differs from the last publish. `other`: the files differ in a way no listed setting or command explains, such as a newer installer. */
61871
+ settings: ("binName" | "displayName" | "authMode" | "installDomain" | "other")[];
61872
+ } | null;
61873
+ /** @description The digest a publish of the saved surface would record */
61874
+ digest: string;
61875
+ publishedAt: string | null;
61876
+ /** @description The digest the published version recorded; null while unpublished */
61877
+ publishedDigest: string | null;
61878
+ /**
61879
+ * @description `unpublished`: the install host serves nothing for this surface. `published`: it serves exactly what a publish would write now. `changesNotPublished`: the saved surface differs from the published version.
61880
+ * @enum {string}
61881
+ */
61882
+ state: "unpublished" | "published" | "changesNotPublished";
61883
+ /** @description The published version; null while unpublished */
61884
+ version: string | null;
61885
+ };
61664
61886
  CliPublishResult: {
61665
61887
  install: components["schemas"]["CliInstallCommands"];
61666
61888
  installDomain: components["schemas"]["CliInstallDomain"];
@@ -65500,10 +65722,6 @@ interface components {
65500
65722
  value?: unknown;
65501
65723
  };
65502
65724
  SignalBinding: {
65503
- /** @description Monthly cap. 0 on an implicit binding, which has no cap and is billed to usage. */
65504
- budget: {
65505
- monthlyUsd: number;
65506
- };
65507
65725
  coverage: {
65508
65726
  [key: string]: unknown;
65509
65727
  };
@@ -65515,7 +65733,7 @@ interface components {
65515
65733
  [key: string]: unknown;
65516
65734
  };
65517
65735
  id: string;
65518
- /** @description Created by the platform: the failure detector on a uniform 5% sample, billed to usage. Unbinding it records an opt-out (enabled false) and it is not recreated; an explicit failure_detector binding replaces it. */
65736
+ /** @description Created by the platform: the failure detector on a uniform 5% sample. Unbinding it records an opt-out (enabled false) and it is not recreated; an explicit failure_detector binding replaces it. */
65519
65737
  implicit: boolean;
65520
65738
  signalSetId: string;
65521
65739
  signalSetName?: string;
@@ -67642,6 +67860,16 @@ interface FetchUrlStepConfig {
67642
67860
  method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
67643
67861
  headers?: Record<string, string>;
67644
67862
  body?: string;
67863
+ /** `multipart/form-data` body; needs POST, PUT or PATCH and cannot be combined with `body`. */
67864
+ multipart?: {
67865
+ fields?: Record<string, string>;
67866
+ files?: Array<{
67867
+ name: string;
67868
+ url: string;
67869
+ filename?: string;
67870
+ contentType?: string;
67871
+ }>;
67872
+ };
67645
67873
  auth?: Record<string, unknown>;
67646
67874
  responseType?: 'json' | 'text';
67647
67875
  markdownIfAvailable?: boolean;
@@ -78138,11 +78366,8 @@ interface SignalBinding {
78138
78366
  filter: Record<string, unknown>;
78139
78367
  coverage: Record<string, unknown>;
78140
78368
  uniformShare: number;
78141
- budget: {
78142
- monthlyUsd: number;
78143
- };
78144
78369
  enabled: boolean;
78145
- /** Platform-created failure-detector binding (5% uniform sample, billed to usage); unbinding it is a lasting opt-out. */
78370
+ /** Platform-created failure-detector binding (5% uniform sample); unbinding it is a lasting opt-out. */
78146
78371
  implicit: boolean;
78147
78372
  disabledAt: string | null;
78148
78373
  externalProcessingAcknowledgedAt: string | null;
@@ -78219,9 +78444,6 @@ interface BindSignalSetInput {
78219
78444
  rate: number;
78220
78445
  };
78221
78446
  uniformShare?: number;
78222
- budget?: {
78223
- monthlyUsd: number;
78224
- };
78225
78447
  /** Only after a human confirms; a PHI organization on a model outside Workers AI is refused until this is true. */
78226
78448
  acknowledgeExternalProcessing?: boolean;
78227
78449
  }
@@ -80860,6 +81082,10 @@ export declare const STEP_FIELD_REGISTRY: {
80860
81082
  readonly key: 'body';
80861
81083
  readonly format: 'template';
80862
81084
  readonly source: 'http.body';
81085
+ }, {
81086
+ readonly key: 'multipart';
81087
+ readonly format: 'value';
81088
+ readonly source: 'http.multipart';
80863
81089
  }, {
80864
81090
  readonly key: 'auth';
80865
81091
  readonly format: 'value';
package/dist/index.d.ts CHANGED
@@ -13120,6 +13120,7 @@ interface paths {
13120
13120
  conversations: {
13121
13121
  createdAt: string;
13122
13122
  id: string;
13123
+ /** @description Stored messages. For `source: client_token` this counts chat messages before tool results are split into their own `tool` messages, so it can be lower than the detail `messages` length. */
13123
13124
  messageCount: number;
13124
13125
  modelId: string | null;
13125
13126
  ownerId: string | null;
@@ -13219,6 +13220,7 @@ interface paths {
13219
13220
  id: string;
13220
13221
  /** @description Set by POST /v1/conversations only. True when this call created the conversation (201); false when a conversation with the same source.system and source.externalId already existed and is returned unchanged (200). */
13221
13222
  imported?: boolean;
13223
+ /** @description The full ordered transcript, never paginated or capped. For `source: client_token` (Persona web chat) it is read from the chat transcript the widget wrote (also kept in `metadata.messages`): `timestamp` is returned as `createdAt`, `displayContent` as `metadata.displayContent`, and an assistant message that called tools carries `toolCalls` followed by a `tool` message (id `<assistant id>_tool_results`) holding each settled result; a call still awaiting approval or a client answer has no result. */
13222
13224
  messages: components["schemas"]["ConversationTranscriptMessage"][];
13223
13225
  metadata: {
13224
13226
  [key: string]: unknown;
@@ -13249,6 +13251,7 @@ interface paths {
13249
13251
  id: string;
13250
13252
  /** @description Set by POST /v1/conversations only. True when this call created the conversation (201); false when a conversation with the same source.system and source.externalId already existed and is returned unchanged (200). */
13251
13253
  imported?: boolean;
13254
+ /** @description The full ordered transcript, never paginated or capped. For `source: client_token` (Persona web chat) it is read from the chat transcript the widget wrote (also kept in `metadata.messages`): `timestamp` is returned as `createdAt`, `displayContent` as `metadata.displayContent`, and an assistant message that called tools carries `toolCalls` followed by a `tool` message (id `<assistant id>_tool_results`) holding each settled result; a call still awaiting approval or a client answer has no result. */
13252
13255
  messages: components["schemas"]["ConversationTranscriptMessage"][];
13253
13256
  metadata: {
13254
13257
  [key: string]: unknown;
@@ -13373,6 +13376,7 @@ interface paths {
13373
13376
  id: string;
13374
13377
  /** @description Set by POST /v1/conversations only. True when this call created the conversation (201); false when a conversation with the same source.system and source.externalId already existed and is returned unchanged (200). */
13375
13378
  imported?: boolean;
13379
+ /** @description The full ordered transcript, never paginated or capped. For `source: client_token` (Persona web chat) it is read from the chat transcript the widget wrote (also kept in `metadata.messages`): `timestamp` is returned as `createdAt`, `displayContent` as `metadata.displayContent`, and an assistant message that called tools carries `toolCalls` followed by a `tool` message (id `<assistant id>_tool_results`) holding each settled result; a call still awaiting approval or a client answer has no result. */
13376
13380
  messages: components["schemas"]["ConversationTranscriptMessage"][];
13377
13381
  metadata: {
13378
13382
  [key: string]: unknown;
@@ -13486,6 +13490,7 @@ interface paths {
13486
13490
  id: string;
13487
13491
  /** @description Set by POST /v1/conversations only. True when this call created the conversation (201); false when a conversation with the same source.system and source.externalId already existed and is returned unchanged (200). */
13488
13492
  imported?: boolean;
13493
+ /** @description The full ordered transcript, never paginated or capped. For `source: client_token` (Persona web chat) it is read from the chat transcript the widget wrote (also kept in `metadata.messages`): `timestamp` is returned as `createdAt`, `displayContent` as `metadata.displayContent`, and an assistant message that called tools carries `toolCalls` followed by a `tool` message (id `<assistant id>_tool_results`) holding each settled result; a call still awaiting approval or a client answer has no result. */
13489
13494
  messages: components["schemas"]["ConversationTranscriptMessage"][];
13490
13495
  metadata: {
13491
13496
  [key: string]: unknown;
@@ -41114,6 +41119,129 @@ interface paths {
41114
41119
  patch?: never;
41115
41120
  trace?: never;
41116
41121
  };
41122
+ "/v1/products/{productId}/surfaces/{surfaceId}/cli/preview": {
41123
+ parameters: {
41124
+ query?: never;
41125
+ header?: never;
41126
+ path?: never;
41127
+ cookie?: never;
41128
+ };
41129
+ /**
41130
+ * Preview a CLI surface
41131
+ * @description Renders the saved `cli` surface the way a publish would build it: the exact `--help` text of the CLI and of each command, each command's flags and an example, and the SKILL.md. Compares that build with the version the install host serves, listing added, removed and changed commands and changed settings. Reads the install host's bucket and never writes to it; a surface that is turned off still previews.
41132
+ */
41133
+ get: {
41134
+ parameters: {
41135
+ query?: never;
41136
+ header?: never;
41137
+ path: {
41138
+ productId: string;
41139
+ surfaceId: string;
41140
+ };
41141
+ cookie?: never;
41142
+ };
41143
+ requestBody?: never;
41144
+ responses: {
41145
+ /** @description Preview */
41146
+ 200: {
41147
+ headers: {
41148
+ [name: string]: unknown;
41149
+ };
41150
+ content: {
41151
+ "application/json": components["schemas"]["CliPreview"];
41152
+ };
41153
+ };
41154
+ /** @description Invalid IDs, no valid command name (`CLI_BIN_NAME_REQUIRED`) or a name the publish refuses (`CLI_NAME_REJECTED`) */
41155
+ 400: {
41156
+ headers: {
41157
+ [name: string]: unknown;
41158
+ };
41159
+ content: {
41160
+ "application/json": {
41161
+ code?: string;
41162
+ error: string;
41163
+ issues?: {
41164
+ code: string;
41165
+ message: string;
41166
+ /** @enum {string} */
41167
+ verdict: "review" | "reject";
41168
+ }[];
41169
+ };
41170
+ };
41171
+ };
41172
+ /** @description Insufficient permissions, `CLI_SURFACE_PUBLISH_DISABLED` while publishing is off for the account, or `CLI_INSTALL_DOMAIN_DISABLED` for an install domain while custom install domains are off */
41173
+ 403: {
41174
+ headers: {
41175
+ [name: string]: unknown;
41176
+ };
41177
+ content: {
41178
+ "application/json": {
41179
+ code?: string;
41180
+ error: string;
41181
+ issues?: {
41182
+ code: string;
41183
+ message: string;
41184
+ /** @enum {string} */
41185
+ verdict: "review" | "reject";
41186
+ }[];
41187
+ };
41188
+ };
41189
+ };
41190
+ /** @description Product or CLI surface not found */
41191
+ 404: {
41192
+ headers: {
41193
+ [name: string]: unknown;
41194
+ };
41195
+ content: {
41196
+ "application/json": components["schemas"]["Error"];
41197
+ };
41198
+ };
41199
+ /** @description `CLI_DIST_UNAVAILABLE`: the install host's storage failed */
41200
+ 502: {
41201
+ headers: {
41202
+ [name: string]: unknown;
41203
+ };
41204
+ content: {
41205
+ "application/json": {
41206
+ code?: string;
41207
+ error: string;
41208
+ issues?: {
41209
+ code: string;
41210
+ message: string;
41211
+ /** @enum {string} */
41212
+ verdict: "review" | "reject";
41213
+ }[];
41214
+ };
41215
+ };
41216
+ };
41217
+ /** @description `CLI_DIST_NOT_CONFIGURED`: this deployment has no `CLI_DIST` bucket or install host */
41218
+ 503: {
41219
+ headers: {
41220
+ [name: string]: unknown;
41221
+ };
41222
+ content: {
41223
+ "application/json": {
41224
+ code?: string;
41225
+ error: string;
41226
+ issues?: {
41227
+ code: string;
41228
+ message: string;
41229
+ /** @enum {string} */
41230
+ verdict: "review" | "reject";
41231
+ }[];
41232
+ };
41233
+ };
41234
+ };
41235
+ };
41236
+ };
41237
+ put?: never;
41238
+ post?: never;
41239
+ delete?: never;
41240
+ options?: never;
41241
+ head?: never;
41242
+ patch?: never;
41243
+ trace?: never;
41244
+ };
41117
41245
  "/v1/products/{productId}/surfaces/{surfaceId}/cli/publish": {
41118
41246
  parameters: {
41119
41247
  query?: never;
@@ -55055,7 +55183,7 @@ interface paths {
55055
55183
  put?: never;
55056
55184
  /**
55057
55185
  * Bind a signal set to an agent
55058
- * @description Evaluate a set version on every matching turn of an agent from now on. Refused for an agent with loggingPolicy "off" and under zero data retention; an organization handling PHI must pass acknowledgeExternalProcessing.
55186
+ * @description Evaluate a set version on every matching turn of an agent from now on. Its model calls bill to the organization’s usage like any other model call. Refused for an agent with loggingPolicy "off" and under zero data retention; an organization handling PHI must pass acknowledgeExternalProcessing.
55059
55187
  */
55060
55188
  post: {
55061
55189
  parameters: {
@@ -55069,10 +55197,11 @@ interface paths {
55069
55197
  "application/json": {
55070
55198
  /** @description Required for a PHI organization whose set uses a decision model outside Cloudflare Workers AI. Written to the audit log. */
55071
55199
  acknowledgeExternalProcessing?: boolean;
55072
- /** @description Default $25 a month. */
55073
- budget?: {
55074
- monthlyUsd: number;
55075
- };
55200
+ /**
55201
+ * @deprecated
55202
+ * @description Ignored. Bindings have no budget; their model calls bill to the organization’s usage.
55203
+ */
55204
+ budget?: unknown;
55076
55205
  coverage?: {
55077
55206
  /** @enum {string} */
55078
55207
  mode: "all";
@@ -61661,6 +61790,99 @@ interface components {
61661
61790
  recordValue: string;
61662
61791
  } | null;
61663
61792
  } | null;
61793
+ CliPreview: {
61794
+ /** @description The command name the preview renders, which is also the install slug */
61795
+ binName: string;
61796
+ /** @description The built-in commands every CLI has, as `--help` lists them */
61797
+ builtins: {
61798
+ command: string;
61799
+ description: string;
61800
+ }[];
61801
+ /** @description One entry per tool command, hidden ones included, sorted by command path */
61802
+ commands: components["schemas"]["CliPreviewCommand"][];
61803
+ /** @description The name `--help` opens with: the product name */
61804
+ displayName: string;
61805
+ /** @description The exact text `<bin> --help` prints */
61806
+ help: string;
61807
+ publish: components["schemas"]["CliPreviewPublish"];
61808
+ /** @description The SKILL.md a publish writes and `<bin> skill install` installs */
61809
+ skill: string;
61810
+ };
61811
+ CliPreviewCommand: {
61812
+ /** @description Other paths that reach the command, e.g. the hyphenated name */
61813
+ aliases: string[];
61814
+ /** @description The tool shares its name with a built-in, so only `<bin> call <tool>` reaches it */
61815
+ callOnly: boolean;
61816
+ /** @description The command path after the command name, e.g. `search_tickets` or `call login` */
61817
+ command: string;
61818
+ /** @description A runnable example invocation with every required flag */
61819
+ example: string;
61820
+ /** @description The flags `<bin> <command> --help` lists, in order */
61821
+ flags: components["schemas"]["CliPreviewFlag"][];
61822
+ /** @description The exact text `<bin> <command> --help` prints */
61823
+ help: string;
61824
+ /** @description A command override hides it from `--help`; it still runs */
61825
+ hidden: boolean;
61826
+ /** @description The description is the `Execute the <tool> capability` default a capability without a description gets */
61827
+ placeholderDescription: boolean;
61828
+ /** @description The first sentence of the description, as `--help` lists it */
61829
+ summary: string;
61830
+ /** @description The MCP tool the command calls */
61831
+ tool: string;
61832
+ /** @description The usage line, e.g. `acme search_tickets <query> [flags]` */
61833
+ usage: string;
61834
+ };
61835
+ CliPreviewFlag: {
61836
+ /** @description The schema default, when it declares one */
61837
+ default?: unknown;
61838
+ /** @description The first sentence of the argument's description; empty when it has none */
61839
+ description: string;
61840
+ /** @description The accepted values of an enum argument */
61841
+ enum?: unknown[];
61842
+ /** @description The flag without its leading `--`, e.g. `ticket-id` */
61843
+ name: string;
61844
+ /** @description Also accepted as a positional argument */
61845
+ positional: boolean;
61846
+ /** @description Takes the flag more than once, one value each time */
61847
+ repeatable: boolean;
61848
+ required: boolean;
61849
+ /** @description A TypeScript-style type, as the signature line prints it, e.g. `"open" | "closed"` */
61850
+ type: string;
61851
+ /** @description The tool argument the flag sets, e.g. `ticketId` */
61852
+ wire: string;
61853
+ };
61854
+ CliPreviewPublish: {
61855
+ /** @description What a publish would change; null while unpublished */
61856
+ changes: {
61857
+ commandsAdded: {
61858
+ command: string;
61859
+ tool: string;
61860
+ }[];
61861
+ commandsChanged: {
61862
+ command: string;
61863
+ fields: ("name" | "aliases" | "hidden" | "description" | "flags")[];
61864
+ tool: string;
61865
+ }[];
61866
+ commandsRemoved: {
61867
+ command: string;
61868
+ tool: string;
61869
+ }[];
61870
+ /** @description `binName`: the published version is under another command name. `installDomain`: the requested install domain differs from the last publish. `other`: the files differ in a way no listed setting or command explains, such as a newer installer. */
61871
+ settings: ("binName" | "displayName" | "authMode" | "installDomain" | "other")[];
61872
+ } | null;
61873
+ /** @description The digest a publish of the saved surface would record */
61874
+ digest: string;
61875
+ publishedAt: string | null;
61876
+ /** @description The digest the published version recorded; null while unpublished */
61877
+ publishedDigest: string | null;
61878
+ /**
61879
+ * @description `unpublished`: the install host serves nothing for this surface. `published`: it serves exactly what a publish would write now. `changesNotPublished`: the saved surface differs from the published version.
61880
+ * @enum {string}
61881
+ */
61882
+ state: "unpublished" | "published" | "changesNotPublished";
61883
+ /** @description The published version; null while unpublished */
61884
+ version: string | null;
61885
+ };
61664
61886
  CliPublishResult: {
61665
61887
  install: components["schemas"]["CliInstallCommands"];
61666
61888
  installDomain: components["schemas"]["CliInstallDomain"];
@@ -65500,10 +65722,6 @@ interface components {
65500
65722
  value?: unknown;
65501
65723
  };
65502
65724
  SignalBinding: {
65503
- /** @description Monthly cap. 0 on an implicit binding, which has no cap and is billed to usage. */
65504
- budget: {
65505
- monthlyUsd: number;
65506
- };
65507
65725
  coverage: {
65508
65726
  [key: string]: unknown;
65509
65727
  };
@@ -65515,7 +65733,7 @@ interface components {
65515
65733
  [key: string]: unknown;
65516
65734
  };
65517
65735
  id: string;
65518
- /** @description Created by the platform: the failure detector on a uniform 5% sample, billed to usage. Unbinding it records an opt-out (enabled false) and it is not recreated; an explicit failure_detector binding replaces it. */
65736
+ /** @description Created by the platform: the failure detector on a uniform 5% sample. Unbinding it records an opt-out (enabled false) and it is not recreated; an explicit failure_detector binding replaces it. */
65519
65737
  implicit: boolean;
65520
65738
  signalSetId: string;
65521
65739
  signalSetName?: string;
@@ -67642,6 +67860,16 @@ interface FetchUrlStepConfig {
67642
67860
  method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
67643
67861
  headers?: Record<string, string>;
67644
67862
  body?: string;
67863
+ /** `multipart/form-data` body; needs POST, PUT or PATCH and cannot be combined with `body`. */
67864
+ multipart?: {
67865
+ fields?: Record<string, string>;
67866
+ files?: Array<{
67867
+ name: string;
67868
+ url: string;
67869
+ filename?: string;
67870
+ contentType?: string;
67871
+ }>;
67872
+ };
67645
67873
  auth?: Record<string, unknown>;
67646
67874
  responseType?: 'json' | 'text';
67647
67875
  markdownIfAvailable?: boolean;
@@ -78138,11 +78366,8 @@ interface SignalBinding {
78138
78366
  filter: Record<string, unknown>;
78139
78367
  coverage: Record<string, unknown>;
78140
78368
  uniformShare: number;
78141
- budget: {
78142
- monthlyUsd: number;
78143
- };
78144
78369
  enabled: boolean;
78145
- /** Platform-created failure-detector binding (5% uniform sample, billed to usage); unbinding it is a lasting opt-out. */
78370
+ /** Platform-created failure-detector binding (5% uniform sample); unbinding it is a lasting opt-out. */
78146
78371
  implicit: boolean;
78147
78372
  disabledAt: string | null;
78148
78373
  externalProcessingAcknowledgedAt: string | null;
@@ -78219,9 +78444,6 @@ interface BindSignalSetInput {
78219
78444
  rate: number;
78220
78445
  };
78221
78446
  uniformShare?: number;
78222
- budget?: {
78223
- monthlyUsd: number;
78224
- };
78225
78447
  /** Only after a human confirms; a PHI organization on a model outside Workers AI is refused until this is true. */
78226
78448
  acknowledgeExternalProcessing?: boolean;
78227
78449
  }
@@ -80860,6 +81082,10 @@ export declare const STEP_FIELD_REGISTRY: {
80860
81082
  readonly key: 'body';
80861
81083
  readonly format: 'template';
80862
81084
  readonly source: 'http.body';
81085
+ }, {
81086
+ readonly key: 'multipart';
81087
+ readonly format: 'value';
81088
+ readonly source: 'http.multipart';
80863
81089
  }, {
80864
81090
  readonly key: 'auth';
80865
81091
  readonly format: 'value';
package/dist/index.mjs CHANGED
@@ -1150,7 +1150,8 @@ var FlowBuilder = class {
1150
1150
  url: config.url,
1151
1151
  method: config.method || "GET",
1152
1152
  headers: config.headers,
1153
- body: config.body
1153
+ body: config.body,
1154
+ ...config.multipart !== void 0 && { multipart: config.multipart }
1154
1155
  },
1155
1156
  auth: config.auth,
1156
1157
  responseType: config.responseType,
@@ -10454,7 +10455,8 @@ var RuntypeFlowBuilder = class {
10454
10455
  url: config.url,
10455
10456
  method: config.method || "GET",
10456
10457
  headers: config.headers,
10457
- body: config.body
10458
+ body: config.body,
10459
+ ...config.multipart !== void 0 && { multipart: config.multipart }
10458
10460
  },
10459
10461
  auth: config.auth,
10460
10462
  responseType: config.responseType,
@@ -14829,7 +14831,7 @@ function transformQueryParams(params) {
14829
14831
  return result;
14830
14832
  }
14831
14833
  // src/version.ts
14832
- const SDK_VERSION = "11.19.2";
14834
+ const SDK_VERSION = "11.20.1";
14833
14835
  /**
14834
14836
  * Canonical client identity the API uses for attribution
14835
14837
  * (`detectActorSource` in apps/api/src/lib/audit-log.ts keys `'sdk'` off the
@@ -15862,6 +15864,11 @@ const STEP_FIELD_REGISTRY = {
15862
15864
  format: "template",
15863
15865
  source: "http.body"
15864
15866
  },
15867
+ {
15868
+ key: "multipart",
15869
+ format: "value",
15870
+ source: "http.multipart"
15871
+ },
15865
15872
  {
15866
15873
  key: "auth",
15867
15874
  format: "value"
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@runtypelabs/sdk",
3
- "version": "11.19.2",
3
+ "version": "11.20.1",
4
4
  "type": "module",
5
5
  "description": "TypeScript SDK for the Runtype API with fluent methods. Use it to quickly realize AI products, agents, and workflows.",
6
6
  "main": "dist/index.cjs",
@@ -24,7 +24,7 @@
24
24
  ],
25
25
  "dependencies": {},
26
26
  "devDependencies": {
27
- "@runtypelabs/shared": "3.115.0",
27
+ "@runtypelabs/shared": "3.117.0",
28
28
  "openapi-typescript": "^7.13.0",
29
29
  "tsdown": "^0.23.2",
30
30
  "typescript": "^6.0.3",
@@ -67,6 +67,7 @@
67
67
  "clean": "rm -rf dist",
68
68
  "test": "vitest run",
69
69
  "test:watch": "vitest watch",
70
+ "test:live": "vitest run --config vitest.live.config.ts",
70
71
  "generate:types": "openapi-typescript ../../apps/api/openapi/public/v1/openapi.json -o src/generated/openapi-types.ts",
71
72
  "generate:types:check": "pnpm run generate:types && git diff --exit-code src/generated/openapi-types.ts",
72
73
  "lint": "oxlint ."