@runtypelabs/sdk 11.19.1 → 11.20.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.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.1";
14835
+ const SDK_VERSION = "11.20.0";
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
@@ -10145,7 +10145,7 @@ interface paths {
10145
10145
  untrustedContentHint?: boolean;
10146
10146
  }[];
10147
10147
  clientToolsFingerprint?: string;
10148
- /** @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. */
10148
+ /** @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). A proof that fails verification is rejected with 401 `invalid_identity_proof`. */
10149
10149
  identityProof?: {
10150
10150
  provider: string;
10151
10151
  token: string;
@@ -10337,7 +10337,7 @@ interface paths {
10337
10337
  };
10338
10338
  /**
10339
10339
  * List the visitor's own conversations
10340
- * @description List conversations belonging to the calling browser's anonymous visitor, newest first, cursor-paginated. Requires both a live `sessionId` and the `X-Visitor-Token` secret from `/client/init`; the site-wide client token alone can never reach this route. Every response carries `X-History-Identity-Status` (`not_provided` | `admitted` | `ignored`) reporting what the server did with a supplied `X-Identity-Proof`, so a widget can tell a verified action from a browser-scoped one. It is exposed via CORS; it grants no authority.
10340
+ * @description List conversations belonging to the calling browser's anonymous visitor, newest first, cursor-paginated. Requires both a live `sessionId` and the `X-Visitor-Token` secret from `/client/init`; the site-wide client token alone can never reach this route. Every response carries `X-History-Identity-Status` (`not_provided` | `admitted`) reporting what the server did with a supplied `X-Identity-Proof`, so a widget can tell a verified action from a browser-scoped one. It is exposed via CORS; it grants no authority.
10341
10341
  */
10342
10342
  get: {
10343
10343
  parameters: {
@@ -10440,22 +10440,13 @@ interface paths {
10440
10440
  "application/json": components["schemas"]["Error"];
10441
10441
  };
10442
10442
  };
10443
- /** @description An `X-Identity-Proof` was supplied but end-user identity admission is not enabled for this token owner, so it cannot be evaluated (`identity_proof_not_admitted`). Nothing was read, deleted, or otherwise acted on. Retry without the proof to act at plain browser scope. Distinct from 401 `invalid_identity_proof`, which means the proof WAS evaluated and rejected. */
10444
- 503: {
10445
- headers: {
10446
- [name: string]: unknown;
10447
- };
10448
- content: {
10449
- "application/json": components["schemas"]["Error"];
10450
- };
10451
- };
10452
10443
  };
10453
10444
  };
10454
10445
  put?: never;
10455
10446
  post?: never;
10456
10447
  /**
10457
10448
  * Delete all of the visitor's own conversations
10458
- * @description Permanently delete every conversation belonging to the calling visitor, with their transcripts. Intended for a widget's "clear my history" control and for host-site privacy-erasure hooks. Pass `targetId` to delete only the conversations a target-scoped UI actually listed; OMITTING it deliberately means every conversation in the authorized visitor scope, across all targets. Every response carries `X-History-Identity-Status` (`not_provided` | `admitted` | `ignored`) reporting what the server did with a supplied `X-Identity-Proof`, so a widget can tell a verified action from a browser-scoped one. It is exposed via CORS; it grants no authority.
10449
+ * @description Permanently delete every conversation belonging to the calling visitor, with their transcripts. Intended for a widget's "clear my history" control and for host-site privacy-erasure hooks. Pass `targetId` to delete only the conversations a target-scoped UI actually listed; OMITTING it deliberately means every conversation in the authorized visitor scope, across all targets. Every response carries `X-History-Identity-Status` (`not_provided` | `admitted`) reporting what the server did with a supplied `X-Identity-Proof`, so a widget can tell a verified action from a browser-scoped one. It is exposed via CORS; it grants no authority.
10459
10450
  */
10460
10451
  delete: {
10461
10452
  parameters: {
@@ -10535,15 +10526,6 @@ interface paths {
10535
10526
  "application/json": components["schemas"]["Error"];
10536
10527
  };
10537
10528
  };
10538
- /** @description An `X-Identity-Proof` was supplied but end-user identity admission is not enabled for this token owner, so it cannot be evaluated (`identity_proof_not_admitted`). Nothing was read, deleted, or otherwise acted on. Retry without the proof to act at plain browser scope. Distinct from 401 `invalid_identity_proof`, which means the proof WAS evaluated and rejected. */
10539
- 503: {
10540
- headers: {
10541
- [name: string]: unknown;
10542
- };
10543
- content: {
10544
- "application/json": components["schemas"]["Error"];
10545
- };
10546
- };
10547
10529
  };
10548
10530
  };
10549
10531
  options?: never;
@@ -10747,7 +10729,7 @@ interface paths {
10747
10729
  };
10748
10730
  /**
10749
10731
  * Read one of the visitor's own conversations
10750
- * @description Return a single conversation with its message transcript. Answers 404 (never 403) for a conversation the caller does not own, so the route cannot be used to probe for other visitors' conversations. Every response carries `X-History-Identity-Status` (`not_provided` | `admitted` | `ignored`) reporting what the server did with a supplied `X-Identity-Proof`, so a widget can tell a verified action from a browser-scoped one. It is exposed via CORS; it grants no authority.
10732
+ * @description Return a single conversation with its message transcript. Answers 404 (never 403) for a conversation the caller does not own, so the route cannot be used to probe for other visitors' conversations. Every response carries `X-History-Identity-Status` (`not_provided` | `admitted`) reporting what the server did with a supplied `X-Identity-Proof`, so a widget can tell a verified action from a browser-scoped one. It is exposed via CORS; it grants no authority.
10751
10733
  */
10752
10734
  get: {
10753
10735
  parameters: {
@@ -10872,22 +10854,13 @@ interface paths {
10872
10854
  "application/json": components["schemas"]["Error"];
10873
10855
  };
10874
10856
  };
10875
- /** @description An `X-Identity-Proof` was supplied but end-user identity admission is not enabled for this token owner, so it cannot be evaluated (`identity_proof_not_admitted`). Nothing was read, deleted, or otherwise acted on. Retry without the proof to act at plain browser scope. Distinct from 401 `invalid_identity_proof`, which means the proof WAS evaluated and rejected. */
10876
- 503: {
10877
- headers: {
10878
- [name: string]: unknown;
10879
- };
10880
- content: {
10881
- "application/json": components["schemas"]["Error"];
10882
- };
10883
- };
10884
10857
  };
10885
10858
  };
10886
10859
  put?: never;
10887
10860
  post?: never;
10888
10861
  /**
10889
10862
  * Delete one of the visitor's own conversations
10890
- * @description Permanently delete a conversation and its stored transcript. Answers 404 (never 403) for a conversation the caller does not own. Every response carries `X-History-Identity-Status` (`not_provided` | `admitted` | `ignored`) reporting what the server did with a supplied `X-Identity-Proof`, so a widget can tell a verified action from a browser-scoped one. It is exposed via CORS; it grants no authority.
10863
+ * @description Permanently delete a conversation and its stored transcript. Answers 404 (never 403) for a conversation the caller does not own. Every response carries `X-History-Identity-Status` (`not_provided` | `admitted`) reporting what the server did with a supplied `X-Identity-Proof`, so a widget can tell a verified action from a browser-scoped one. It is exposed via CORS; it grants no authority.
10891
10864
  */
10892
10865
  delete: {
10893
10866
  parameters: {
@@ -10975,15 +10948,6 @@ interface paths {
10975
10948
  "application/json": components["schemas"]["Error"];
10976
10949
  };
10977
10950
  };
10978
- /** @description An `X-Identity-Proof` was supplied but end-user identity admission is not enabled for this token owner, so it cannot be evaluated (`identity_proof_not_admitted`). Nothing was read, deleted, or otherwise acted on. Retry without the proof to act at plain browser scope. Distinct from 401 `invalid_identity_proof`, which means the proof WAS evaluated and rejected. */
10979
- 503: {
10980
- headers: {
10981
- [name: string]: unknown;
10982
- };
10983
- content: {
10984
- "application/json": components["schemas"]["Error"];
10985
- };
10986
- };
10987
10951
  };
10988
10952
  };
10989
10953
  options?: never;
@@ -11386,7 +11350,7 @@ interface paths {
11386
11350
  /** @description Durable anonymous visitor id (`cvis_…`). */
11387
11351
  id: string;
11388
11352
  /**
11389
- * @description What the server did with a supplied `identityProof` on THIS request. `not_provided`: none was sent. `admitted`: it was verified and produced the end-user scope. `ignored`: one was sent but end-user admission is not enabled for this token owner, so it was never evaluated and the session is plain browser scope. Init still succeeds on `ignored` so chat degrades gracefully, but a widget must not offer verified cross-device history or a verified erase in that state (the history routes refuse such a request outright with 503 `identity_proof_not_admitted`). Reporting only: it confers no authority and carries no identity value.
11353
+ * @description What the server did with a supplied `identityProof` on THIS request. `not_provided`: none was sent. `admitted`: it was verified and produced the end-user scope. `ignored`: no longer emitted, because every token owner now evaluates a supplied proof; it stays in the enum for older clients. An invalid proof fails init with 401 `invalid_identity_proof`. Reporting only: it confers no authority and carries no identity value.
11390
11354
  * @enum {string}
11391
11355
  */
11392
11356
  identityStatus: "not_provided" | "admitted" | "ignored";
@@ -11643,7 +11607,7 @@ interface paths {
11643
11607
  put?: never;
11644
11608
  /**
11645
11609
  * Reset the current browser visitor
11646
- * @description Explicit widget shutdown/logout lifecycle. Revokes the presented browser visitor when it still resolves, without deleting conversation records. The response is idempotent so it cannot reveal whether a visitor secret was valid. Clear the locally stored secret after success; a later history-capable init creates a clean anonymous visitor. Every response carries `X-History-Identity-Status` (`not_provided` | `admitted` | `ignored`) reporting what the server did with a supplied `X-Identity-Proof`, so a widget can tell a verified action from a browser-scoped one. It is exposed via CORS; it grants no authority.
11610
+ * @description Explicit widget shutdown/logout lifecycle. Revokes the presented browser visitor when it still resolves, without deleting conversation records. The response is idempotent so it cannot reveal whether a visitor secret was valid. Clear the locally stored secret after success; a later history-capable init creates a clean anonymous visitor. Every response carries `X-History-Identity-Status` (`not_provided` | `admitted`) reporting what the server did with a supplied `X-Identity-Proof`, so a widget can tell a verified action from a browser-scoped one. It is exposed via CORS; it grants no authority.
11647
11611
  */
11648
11612
  post: {
11649
11613
  parameters: {
@@ -11720,15 +11684,6 @@ interface paths {
11720
11684
  "application/json": components["schemas"]["Error"];
11721
11685
  };
11722
11686
  };
11723
- /** @description An `X-Identity-Proof` was supplied but end-user identity admission is not enabled for this token owner, so it cannot be evaluated (`identity_proof_not_admitted`). Nothing was read, deleted, or otherwise acted on. Retry without the proof to act at plain browser scope. Distinct from 401 `invalid_identity_proof`, which means the proof WAS evaluated and rejected. */
11724
- 503: {
11725
- headers: {
11726
- [name: string]: unknown;
11727
- };
11728
- content: {
11729
- "application/json": components["schemas"]["Error"];
11730
- };
11731
- };
11732
11687
  };
11733
11688
  };
11734
11689
  delete?: never;
@@ -13165,6 +13120,7 @@ interface paths {
13165
13120
  conversations: {
13166
13121
  createdAt: string;
13167
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. */
13168
13124
  messageCount: number;
13169
13125
  modelId: string | null;
13170
13126
  ownerId: string | null;
@@ -13264,6 +13220,7 @@ interface paths {
13264
13220
  id: string;
13265
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). */
13266
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. */
13267
13224
  messages: components["schemas"]["ConversationTranscriptMessage"][];
13268
13225
  metadata: {
13269
13226
  [key: string]: unknown;
@@ -13294,6 +13251,7 @@ interface paths {
13294
13251
  id: string;
13295
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). */
13296
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. */
13297
13255
  messages: components["schemas"]["ConversationTranscriptMessage"][];
13298
13256
  metadata: {
13299
13257
  [key: string]: unknown;
@@ -13418,6 +13376,7 @@ interface paths {
13418
13376
  id: string;
13419
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). */
13420
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. */
13421
13380
  messages: components["schemas"]["ConversationTranscriptMessage"][];
13422
13381
  metadata: {
13423
13382
  [key: string]: unknown;
@@ -13531,6 +13490,7 @@ interface paths {
13531
13490
  id: string;
13532
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). */
13533
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. */
13534
13494
  messages: components["schemas"]["ConversationTranscriptMessage"][];
13535
13495
  metadata: {
13536
13496
  [key: string]: unknown;
@@ -16295,7 +16255,7 @@ interface paths {
16295
16255
  * @enum {string}
16296
16256
  */
16297
16257
  history?: "inline" | "stored";
16298
- /** @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. */
16258
+ /** @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). A proof that fails verification is rejected with 401 `invalid_identity_proof`. */
16299
16259
  identityProof?: {
16300
16260
  provider: string;
16301
16261
  token: string;
@@ -16768,7 +16728,7 @@ interface paths {
16768
16728
  * @enum {string}
16769
16729
  */
16770
16730
  history?: "inline" | "stored";
16771
- /** @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. */
16731
+ /** @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). A proof that fails verification is rejected with 401 `invalid_identity_proof`. */
16772
16732
  identityProof?: {
16773
16733
  provider: string;
16774
16734
  token: string;
@@ -55100,7 +55060,7 @@ interface paths {
55100
55060
  put?: never;
55101
55061
  /**
55102
55062
  * Bind a signal set to an agent
55103
- * @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.
55063
+ * @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.
55104
55064
  */
55105
55065
  post: {
55106
55066
  parameters: {
@@ -55114,10 +55074,11 @@ interface paths {
55114
55074
  "application/json": {
55115
55075
  /** @description Required for a PHI organization whose set uses a decision model outside Cloudflare Workers AI. Written to the audit log. */
55116
55076
  acknowledgeExternalProcessing?: boolean;
55117
- /** @description Default $25 a month. */
55118
- budget?: {
55119
- monthlyUsd: number;
55120
- };
55077
+ /**
55078
+ * @deprecated
55079
+ * @description Ignored. Bindings have no budget; their model calls bill to the organization’s usage.
55080
+ */
55081
+ budget?: unknown;
55121
55082
  coverage?: {
55122
55083
  /** @enum {string} */
55123
55084
  mode: "all";
@@ -65545,10 +65506,6 @@ interface components {
65545
65506
  value?: unknown;
65546
65507
  };
65547
65508
  SignalBinding: {
65548
- /** @description Monthly cap. 0 on an implicit binding, which has no cap and is billed to usage. */
65549
- budget: {
65550
- monthlyUsd: number;
65551
- };
65552
65509
  coverage: {
65553
65510
  [key: string]: unknown;
65554
65511
  };
@@ -65560,7 +65517,7 @@ interface components {
65560
65517
  [key: string]: unknown;
65561
65518
  };
65562
65519
  id: string;
65563
- /** @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. */
65520
+ /** @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. */
65564
65521
  implicit: boolean;
65565
65522
  signalSetId: string;
65566
65523
  signalSetName?: string;
@@ -67687,6 +67644,16 @@ interface FetchUrlStepConfig {
67687
67644
  method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
67688
67645
  headers?: Record<string, string>;
67689
67646
  body?: string;
67647
+ /** `multipart/form-data` body; needs POST, PUT or PATCH and cannot be combined with `body`. */
67648
+ multipart?: {
67649
+ fields?: Record<string, string>;
67650
+ files?: Array<{
67651
+ name: string;
67652
+ url: string;
67653
+ filename?: string;
67654
+ contentType?: string;
67655
+ }>;
67656
+ };
67690
67657
  auth?: Record<string, unknown>;
67691
67658
  responseType?: 'json' | 'text';
67692
67659
  markdownIfAvailable?: boolean;
@@ -78183,11 +78150,8 @@ interface SignalBinding {
78183
78150
  filter: Record<string, unknown>;
78184
78151
  coverage: Record<string, unknown>;
78185
78152
  uniformShare: number;
78186
- budget: {
78187
- monthlyUsd: number;
78188
- };
78189
78153
  enabled: boolean;
78190
- /** Platform-created failure-detector binding (5% uniform sample, billed to usage); unbinding it is a lasting opt-out. */
78154
+ /** Platform-created failure-detector binding (5% uniform sample); unbinding it is a lasting opt-out. */
78191
78155
  implicit: boolean;
78192
78156
  disabledAt: string | null;
78193
78157
  externalProcessingAcknowledgedAt: string | null;
@@ -78264,9 +78228,6 @@ interface BindSignalSetInput {
78264
78228
  rate: number;
78265
78229
  };
78266
78230
  uniformShare?: number;
78267
- budget?: {
78268
- monthlyUsd: number;
78269
- };
78270
78231
  /** Only after a human confirms; a PHI organization on a model outside Workers AI is refused until this is true. */
78271
78232
  acknowledgeExternalProcessing?: boolean;
78272
78233
  }
@@ -80905,6 +80866,10 @@ export declare const STEP_FIELD_REGISTRY: {
80905
80866
  readonly key: 'body';
80906
80867
  readonly format: 'template';
80907
80868
  readonly source: 'http.body';
80869
+ }, {
80870
+ readonly key: 'multipart';
80871
+ readonly format: 'value';
80872
+ readonly source: 'http.multipart';
80908
80873
  }, {
80909
80874
  readonly key: 'auth';
80910
80875
  readonly format: 'value';
package/dist/index.d.ts CHANGED
@@ -10145,7 +10145,7 @@ interface paths {
10145
10145
  untrustedContentHint?: boolean;
10146
10146
  }[];
10147
10147
  clientToolsFingerprint?: string;
10148
- /** @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. */
10148
+ /** @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). A proof that fails verification is rejected with 401 `invalid_identity_proof`. */
10149
10149
  identityProof?: {
10150
10150
  provider: string;
10151
10151
  token: string;
@@ -10337,7 +10337,7 @@ interface paths {
10337
10337
  };
10338
10338
  /**
10339
10339
  * List the visitor's own conversations
10340
- * @description List conversations belonging to the calling browser's anonymous visitor, newest first, cursor-paginated. Requires both a live `sessionId` and the `X-Visitor-Token` secret from `/client/init`; the site-wide client token alone can never reach this route. Every response carries `X-History-Identity-Status` (`not_provided` | `admitted` | `ignored`) reporting what the server did with a supplied `X-Identity-Proof`, so a widget can tell a verified action from a browser-scoped one. It is exposed via CORS; it grants no authority.
10340
+ * @description List conversations belonging to the calling browser's anonymous visitor, newest first, cursor-paginated. Requires both a live `sessionId` and the `X-Visitor-Token` secret from `/client/init`; the site-wide client token alone can never reach this route. Every response carries `X-History-Identity-Status` (`not_provided` | `admitted`) reporting what the server did with a supplied `X-Identity-Proof`, so a widget can tell a verified action from a browser-scoped one. It is exposed via CORS; it grants no authority.
10341
10341
  */
10342
10342
  get: {
10343
10343
  parameters: {
@@ -10440,22 +10440,13 @@ interface paths {
10440
10440
  "application/json": components["schemas"]["Error"];
10441
10441
  };
10442
10442
  };
10443
- /** @description An `X-Identity-Proof` was supplied but end-user identity admission is not enabled for this token owner, so it cannot be evaluated (`identity_proof_not_admitted`). Nothing was read, deleted, or otherwise acted on. Retry without the proof to act at plain browser scope. Distinct from 401 `invalid_identity_proof`, which means the proof WAS evaluated and rejected. */
10444
- 503: {
10445
- headers: {
10446
- [name: string]: unknown;
10447
- };
10448
- content: {
10449
- "application/json": components["schemas"]["Error"];
10450
- };
10451
- };
10452
10443
  };
10453
10444
  };
10454
10445
  put?: never;
10455
10446
  post?: never;
10456
10447
  /**
10457
10448
  * Delete all of the visitor's own conversations
10458
- * @description Permanently delete every conversation belonging to the calling visitor, with their transcripts. Intended for a widget's "clear my history" control and for host-site privacy-erasure hooks. Pass `targetId` to delete only the conversations a target-scoped UI actually listed; OMITTING it deliberately means every conversation in the authorized visitor scope, across all targets. Every response carries `X-History-Identity-Status` (`not_provided` | `admitted` | `ignored`) reporting what the server did with a supplied `X-Identity-Proof`, so a widget can tell a verified action from a browser-scoped one. It is exposed via CORS; it grants no authority.
10449
+ * @description Permanently delete every conversation belonging to the calling visitor, with their transcripts. Intended for a widget's "clear my history" control and for host-site privacy-erasure hooks. Pass `targetId` to delete only the conversations a target-scoped UI actually listed; OMITTING it deliberately means every conversation in the authorized visitor scope, across all targets. Every response carries `X-History-Identity-Status` (`not_provided` | `admitted`) reporting what the server did with a supplied `X-Identity-Proof`, so a widget can tell a verified action from a browser-scoped one. It is exposed via CORS; it grants no authority.
10459
10450
  */
10460
10451
  delete: {
10461
10452
  parameters: {
@@ -10535,15 +10526,6 @@ interface paths {
10535
10526
  "application/json": components["schemas"]["Error"];
10536
10527
  };
10537
10528
  };
10538
- /** @description An `X-Identity-Proof` was supplied but end-user identity admission is not enabled for this token owner, so it cannot be evaluated (`identity_proof_not_admitted`). Nothing was read, deleted, or otherwise acted on. Retry without the proof to act at plain browser scope. Distinct from 401 `invalid_identity_proof`, which means the proof WAS evaluated and rejected. */
10539
- 503: {
10540
- headers: {
10541
- [name: string]: unknown;
10542
- };
10543
- content: {
10544
- "application/json": components["schemas"]["Error"];
10545
- };
10546
- };
10547
10529
  };
10548
10530
  };
10549
10531
  options?: never;
@@ -10747,7 +10729,7 @@ interface paths {
10747
10729
  };
10748
10730
  /**
10749
10731
  * Read one of the visitor's own conversations
10750
- * @description Return a single conversation with its message transcript. Answers 404 (never 403) for a conversation the caller does not own, so the route cannot be used to probe for other visitors' conversations. Every response carries `X-History-Identity-Status` (`not_provided` | `admitted` | `ignored`) reporting what the server did with a supplied `X-Identity-Proof`, so a widget can tell a verified action from a browser-scoped one. It is exposed via CORS; it grants no authority.
10732
+ * @description Return a single conversation with its message transcript. Answers 404 (never 403) for a conversation the caller does not own, so the route cannot be used to probe for other visitors' conversations. Every response carries `X-History-Identity-Status` (`not_provided` | `admitted`) reporting what the server did with a supplied `X-Identity-Proof`, so a widget can tell a verified action from a browser-scoped one. It is exposed via CORS; it grants no authority.
10751
10733
  */
10752
10734
  get: {
10753
10735
  parameters: {
@@ -10872,22 +10854,13 @@ interface paths {
10872
10854
  "application/json": components["schemas"]["Error"];
10873
10855
  };
10874
10856
  };
10875
- /** @description An `X-Identity-Proof` was supplied but end-user identity admission is not enabled for this token owner, so it cannot be evaluated (`identity_proof_not_admitted`). Nothing was read, deleted, or otherwise acted on. Retry without the proof to act at plain browser scope. Distinct from 401 `invalid_identity_proof`, which means the proof WAS evaluated and rejected. */
10876
- 503: {
10877
- headers: {
10878
- [name: string]: unknown;
10879
- };
10880
- content: {
10881
- "application/json": components["schemas"]["Error"];
10882
- };
10883
- };
10884
10857
  };
10885
10858
  };
10886
10859
  put?: never;
10887
10860
  post?: never;
10888
10861
  /**
10889
10862
  * Delete one of the visitor's own conversations
10890
- * @description Permanently delete a conversation and its stored transcript. Answers 404 (never 403) for a conversation the caller does not own. Every response carries `X-History-Identity-Status` (`not_provided` | `admitted` | `ignored`) reporting what the server did with a supplied `X-Identity-Proof`, so a widget can tell a verified action from a browser-scoped one. It is exposed via CORS; it grants no authority.
10863
+ * @description Permanently delete a conversation and its stored transcript. Answers 404 (never 403) for a conversation the caller does not own. Every response carries `X-History-Identity-Status` (`not_provided` | `admitted`) reporting what the server did with a supplied `X-Identity-Proof`, so a widget can tell a verified action from a browser-scoped one. It is exposed via CORS; it grants no authority.
10891
10864
  */
10892
10865
  delete: {
10893
10866
  parameters: {
@@ -10975,15 +10948,6 @@ interface paths {
10975
10948
  "application/json": components["schemas"]["Error"];
10976
10949
  };
10977
10950
  };
10978
- /** @description An `X-Identity-Proof` was supplied but end-user identity admission is not enabled for this token owner, so it cannot be evaluated (`identity_proof_not_admitted`). Nothing was read, deleted, or otherwise acted on. Retry without the proof to act at plain browser scope. Distinct from 401 `invalid_identity_proof`, which means the proof WAS evaluated and rejected. */
10979
- 503: {
10980
- headers: {
10981
- [name: string]: unknown;
10982
- };
10983
- content: {
10984
- "application/json": components["schemas"]["Error"];
10985
- };
10986
- };
10987
10951
  };
10988
10952
  };
10989
10953
  options?: never;
@@ -11386,7 +11350,7 @@ interface paths {
11386
11350
  /** @description Durable anonymous visitor id (`cvis_…`). */
11387
11351
  id: string;
11388
11352
  /**
11389
- * @description What the server did with a supplied `identityProof` on THIS request. `not_provided`: none was sent. `admitted`: it was verified and produced the end-user scope. `ignored`: one was sent but end-user admission is not enabled for this token owner, so it was never evaluated and the session is plain browser scope. Init still succeeds on `ignored` so chat degrades gracefully, but a widget must not offer verified cross-device history or a verified erase in that state (the history routes refuse such a request outright with 503 `identity_proof_not_admitted`). Reporting only: it confers no authority and carries no identity value.
11353
+ * @description What the server did with a supplied `identityProof` on THIS request. `not_provided`: none was sent. `admitted`: it was verified and produced the end-user scope. `ignored`: no longer emitted, because every token owner now evaluates a supplied proof; it stays in the enum for older clients. An invalid proof fails init with 401 `invalid_identity_proof`. Reporting only: it confers no authority and carries no identity value.
11390
11354
  * @enum {string}
11391
11355
  */
11392
11356
  identityStatus: "not_provided" | "admitted" | "ignored";
@@ -11643,7 +11607,7 @@ interface paths {
11643
11607
  put?: never;
11644
11608
  /**
11645
11609
  * Reset the current browser visitor
11646
- * @description Explicit widget shutdown/logout lifecycle. Revokes the presented browser visitor when it still resolves, without deleting conversation records. The response is idempotent so it cannot reveal whether a visitor secret was valid. Clear the locally stored secret after success; a later history-capable init creates a clean anonymous visitor. Every response carries `X-History-Identity-Status` (`not_provided` | `admitted` | `ignored`) reporting what the server did with a supplied `X-Identity-Proof`, so a widget can tell a verified action from a browser-scoped one. It is exposed via CORS; it grants no authority.
11610
+ * @description Explicit widget shutdown/logout lifecycle. Revokes the presented browser visitor when it still resolves, without deleting conversation records. The response is idempotent so it cannot reveal whether a visitor secret was valid. Clear the locally stored secret after success; a later history-capable init creates a clean anonymous visitor. Every response carries `X-History-Identity-Status` (`not_provided` | `admitted`) reporting what the server did with a supplied `X-Identity-Proof`, so a widget can tell a verified action from a browser-scoped one. It is exposed via CORS; it grants no authority.
11647
11611
  */
11648
11612
  post: {
11649
11613
  parameters: {
@@ -11720,15 +11684,6 @@ interface paths {
11720
11684
  "application/json": components["schemas"]["Error"];
11721
11685
  };
11722
11686
  };
11723
- /** @description An `X-Identity-Proof` was supplied but end-user identity admission is not enabled for this token owner, so it cannot be evaluated (`identity_proof_not_admitted`). Nothing was read, deleted, or otherwise acted on. Retry without the proof to act at plain browser scope. Distinct from 401 `invalid_identity_proof`, which means the proof WAS evaluated and rejected. */
11724
- 503: {
11725
- headers: {
11726
- [name: string]: unknown;
11727
- };
11728
- content: {
11729
- "application/json": components["schemas"]["Error"];
11730
- };
11731
- };
11732
11687
  };
11733
11688
  };
11734
11689
  delete?: never;
@@ -13165,6 +13120,7 @@ interface paths {
13165
13120
  conversations: {
13166
13121
  createdAt: string;
13167
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. */
13168
13124
  messageCount: number;
13169
13125
  modelId: string | null;
13170
13126
  ownerId: string | null;
@@ -13264,6 +13220,7 @@ interface paths {
13264
13220
  id: string;
13265
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). */
13266
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. */
13267
13224
  messages: components["schemas"]["ConversationTranscriptMessage"][];
13268
13225
  metadata: {
13269
13226
  [key: string]: unknown;
@@ -13294,6 +13251,7 @@ interface paths {
13294
13251
  id: string;
13295
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). */
13296
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. */
13297
13255
  messages: components["schemas"]["ConversationTranscriptMessage"][];
13298
13256
  metadata: {
13299
13257
  [key: string]: unknown;
@@ -13418,6 +13376,7 @@ interface paths {
13418
13376
  id: string;
13419
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). */
13420
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. */
13421
13380
  messages: components["schemas"]["ConversationTranscriptMessage"][];
13422
13381
  metadata: {
13423
13382
  [key: string]: unknown;
@@ -13531,6 +13490,7 @@ interface paths {
13531
13490
  id: string;
13532
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). */
13533
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. */
13534
13494
  messages: components["schemas"]["ConversationTranscriptMessage"][];
13535
13495
  metadata: {
13536
13496
  [key: string]: unknown;
@@ -16295,7 +16255,7 @@ interface paths {
16295
16255
  * @enum {string}
16296
16256
  */
16297
16257
  history?: "inline" | "stored";
16298
- /** @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. */
16258
+ /** @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). A proof that fails verification is rejected with 401 `invalid_identity_proof`. */
16299
16259
  identityProof?: {
16300
16260
  provider: string;
16301
16261
  token: string;
@@ -16768,7 +16728,7 @@ interface paths {
16768
16728
  * @enum {string}
16769
16729
  */
16770
16730
  history?: "inline" | "stored";
16771
- /** @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. */
16731
+ /** @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). A proof that fails verification is rejected with 401 `invalid_identity_proof`. */
16772
16732
  identityProof?: {
16773
16733
  provider: string;
16774
16734
  token: string;
@@ -55100,7 +55060,7 @@ interface paths {
55100
55060
  put?: never;
55101
55061
  /**
55102
55062
  * Bind a signal set to an agent
55103
- * @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.
55063
+ * @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.
55104
55064
  */
55105
55065
  post: {
55106
55066
  parameters: {
@@ -55114,10 +55074,11 @@ interface paths {
55114
55074
  "application/json": {
55115
55075
  /** @description Required for a PHI organization whose set uses a decision model outside Cloudflare Workers AI. Written to the audit log. */
55116
55076
  acknowledgeExternalProcessing?: boolean;
55117
- /** @description Default $25 a month. */
55118
- budget?: {
55119
- monthlyUsd: number;
55120
- };
55077
+ /**
55078
+ * @deprecated
55079
+ * @description Ignored. Bindings have no budget; their model calls bill to the organization’s usage.
55080
+ */
55081
+ budget?: unknown;
55121
55082
  coverage?: {
55122
55083
  /** @enum {string} */
55123
55084
  mode: "all";
@@ -65545,10 +65506,6 @@ interface components {
65545
65506
  value?: unknown;
65546
65507
  };
65547
65508
  SignalBinding: {
65548
- /** @description Monthly cap. 0 on an implicit binding, which has no cap and is billed to usage. */
65549
- budget: {
65550
- monthlyUsd: number;
65551
- };
65552
65509
  coverage: {
65553
65510
  [key: string]: unknown;
65554
65511
  };
@@ -65560,7 +65517,7 @@ interface components {
65560
65517
  [key: string]: unknown;
65561
65518
  };
65562
65519
  id: string;
65563
- /** @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. */
65520
+ /** @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. */
65564
65521
  implicit: boolean;
65565
65522
  signalSetId: string;
65566
65523
  signalSetName?: string;
@@ -67687,6 +67644,16 @@ interface FetchUrlStepConfig {
67687
67644
  method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
67688
67645
  headers?: Record<string, string>;
67689
67646
  body?: string;
67647
+ /** `multipart/form-data` body; needs POST, PUT or PATCH and cannot be combined with `body`. */
67648
+ multipart?: {
67649
+ fields?: Record<string, string>;
67650
+ files?: Array<{
67651
+ name: string;
67652
+ url: string;
67653
+ filename?: string;
67654
+ contentType?: string;
67655
+ }>;
67656
+ };
67690
67657
  auth?: Record<string, unknown>;
67691
67658
  responseType?: 'json' | 'text';
67692
67659
  markdownIfAvailable?: boolean;
@@ -78183,11 +78150,8 @@ interface SignalBinding {
78183
78150
  filter: Record<string, unknown>;
78184
78151
  coverage: Record<string, unknown>;
78185
78152
  uniformShare: number;
78186
- budget: {
78187
- monthlyUsd: number;
78188
- };
78189
78153
  enabled: boolean;
78190
- /** Platform-created failure-detector binding (5% uniform sample, billed to usage); unbinding it is a lasting opt-out. */
78154
+ /** Platform-created failure-detector binding (5% uniform sample); unbinding it is a lasting opt-out. */
78191
78155
  implicit: boolean;
78192
78156
  disabledAt: string | null;
78193
78157
  externalProcessingAcknowledgedAt: string | null;
@@ -78264,9 +78228,6 @@ interface BindSignalSetInput {
78264
78228
  rate: number;
78265
78229
  };
78266
78230
  uniformShare?: number;
78267
- budget?: {
78268
- monthlyUsd: number;
78269
- };
78270
78231
  /** Only after a human confirms; a PHI organization on a model outside Workers AI is refused until this is true. */
78271
78232
  acknowledgeExternalProcessing?: boolean;
78272
78233
  }
@@ -80905,6 +80866,10 @@ export declare const STEP_FIELD_REGISTRY: {
80905
80866
  readonly key: 'body';
80906
80867
  readonly format: 'template';
80907
80868
  readonly source: 'http.body';
80869
+ }, {
80870
+ readonly key: 'multipart';
80871
+ readonly format: 'value';
80872
+ readonly source: 'http.multipart';
80908
80873
  }, {
80909
80874
  readonly key: 'auth';
80910
80875
  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.1";
14834
+ const SDK_VERSION = "11.20.0";
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.1",
3
+ "version": "11.20.0",
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.114.1",
27
+ "@runtypelabs/shared": "3.116.0",
28
28
  "openapi-typescript": "^7.13.0",
29
29
  "tsdown": "^0.23.2",
30
30
  "typescript": "^6.0.3",