@runtypelabs/sdk 11.20.0 → 11.22.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
@@ -14832,7 +14832,7 @@ function transformQueryParams(params) {
14832
14832
  return result;
14833
14833
  }
14834
14834
  // src/version.ts
14835
- const SDK_VERSION = "11.20.0";
14835
+ const SDK_VERSION = "11.22.0";
14836
14836
  /**
14837
14837
  * Canonical client identity the API uses for attribution
14838
14838
  * (`detectActorSource` in apps/api/src/lib/audit-log.ts keys `'sdk'` off the
package/dist/index.d.cts CHANGED
@@ -10145,6 +10145,11 @@ interface paths {
10145
10145
  untrustedContentHint?: boolean;
10146
10146
  }[];
10147
10147
  clientToolsFingerprint?: string;
10148
+ /**
10149
+ * @description Set to `socket` to receive this turn on the client session socket named by `realtime` in the init response, instead of in this response. When the server honors it, the response is `202 {executionId, conversationId, delivery: "socket"}`. Otherwise the turn streams over Server-Sent Events as usual.
10150
+ * @enum {string}
10151
+ */
10152
+ delivery?: "socket";
10148
10153
  /** @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
10154
  identityProof?: {
10150
10155
  provider: string;
@@ -10217,7 +10222,7 @@ interface paths {
10217
10222
  "text/event-stream": unknown;
10218
10223
  };
10219
10224
  };
10220
- /** @description Input accepted without a new response stream: a steer receipt from the running execution, or (for `auto`) a queued handle for the next turn */
10225
+ /** @description Input accepted without a new response stream: a steer receipt from the running execution, (for `auto`) a queued handle for the next turn, or, with `delivery: "socket"`, a turn whose events arrive on the client session socket */
10221
10226
  202: {
10222
10227
  headers: {
10223
10228
  [name: string]: unknown;
@@ -10242,7 +10247,7 @@ interface paths {
10242
10247
  status: string;
10243
10248
  } & {
10244
10249
  [key: string]: unknown;
10245
- });
10250
+ }) | components["schemas"]["ClientSocketDeliveryAccepted"];
10246
10251
  };
10247
10252
  };
10248
10253
  /** @description Validation error */
@@ -11337,6 +11342,13 @@ interface paths {
11337
11342
  /** @description Flow name. Present only for a flow session; the agent branch returns `id` alone because the widget does not render either field. */
11338
11343
  name?: string;
11339
11344
  };
11345
+ /** @description Present when this conversation can receive its turns on the client session socket. Send `delivery: "socket"` on chat and resume to use it. Without this field, stream over Server-Sent Events. */
11346
+ realtime?: {
11347
+ /** @description The client session socket protocol, `runtype-client-session-v1`. */
11348
+ protocol: string;
11349
+ /** @description The `wss://` URL to open. Add `protocol`, `sessionId` and `clientVersion` query parameters and offer `runtype.bearer`, the client token and the visitor credential as WebSocket subprotocols. */
11350
+ url: string;
11351
+ };
11340
11352
  /** @description The created (or resumed) client session ID. */
11341
11353
  sessionId: string;
11342
11354
  /** @description The flow or agent this session executes against, resolved server-side. Canonical replacement for `flow.id`, and the exact key to pass as `targetId` when listing or deleting this conversation's history. Matches the value stored on the conversation record; an agent-only token resolves to its agent id. Absent only on the data-only Runtype App branch, which is not chat-capable. */
@@ -11467,6 +11479,11 @@ interface paths {
11467
11479
  untrustedContentHint?: boolean;
11468
11480
  }[];
11469
11481
  clientToolsFingerprint?: string;
11482
+ /**
11483
+ * @description Set to `socket` to receive the resumed turn on the client session socket. When the server honors it, the response is `202 {executionId, conversationId, delivery: "socket"}`. Otherwise the resumed turn streams as usual.
11484
+ * @enum {string}
11485
+ */
11486
+ delivery?: "socket";
11470
11487
  executionId: string;
11471
11488
  messages?: {
11472
11489
  content: string | ({
@@ -11516,6 +11533,19 @@ interface paths {
11516
11533
  "text/event-stream": unknown;
11517
11534
  };
11518
11535
  };
11536
+ /** @description The resumed turn is running without a response stream: with `delivery: "socket"` its events arrive on the client session socket; otherwise read them from the conversation events stream */
11537
+ 202: {
11538
+ headers: {
11539
+ [name: string]: unknown;
11540
+ };
11541
+ content: {
11542
+ "application/json": components["schemas"]["ClientSocketDeliveryAccepted"] | {
11543
+ executionId: string;
11544
+ /** @enum {string} */
11545
+ status: "running";
11546
+ };
11547
+ };
11548
+ };
11519
11549
  /** @description Validation error */
11520
11550
  400: {
11521
11551
  headers: {
@@ -41119,6 +41149,129 @@ interface paths {
41119
41149
  patch?: never;
41120
41150
  trace?: never;
41121
41151
  };
41152
+ "/v1/products/{productId}/surfaces/{surfaceId}/cli/preview": {
41153
+ parameters: {
41154
+ query?: never;
41155
+ header?: never;
41156
+ path?: never;
41157
+ cookie?: never;
41158
+ };
41159
+ /**
41160
+ * Preview a CLI surface
41161
+ * @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.
41162
+ */
41163
+ get: {
41164
+ parameters: {
41165
+ query?: never;
41166
+ header?: never;
41167
+ path: {
41168
+ productId: string;
41169
+ surfaceId: string;
41170
+ };
41171
+ cookie?: never;
41172
+ };
41173
+ requestBody?: never;
41174
+ responses: {
41175
+ /** @description Preview */
41176
+ 200: {
41177
+ headers: {
41178
+ [name: string]: unknown;
41179
+ };
41180
+ content: {
41181
+ "application/json": components["schemas"]["CliPreview"];
41182
+ };
41183
+ };
41184
+ /** @description Invalid IDs, no valid command name (`CLI_BIN_NAME_REQUIRED`) or a name the publish refuses (`CLI_NAME_REJECTED`) */
41185
+ 400: {
41186
+ headers: {
41187
+ [name: string]: unknown;
41188
+ };
41189
+ content: {
41190
+ "application/json": {
41191
+ code?: string;
41192
+ error: string;
41193
+ issues?: {
41194
+ code: string;
41195
+ message: string;
41196
+ /** @enum {string} */
41197
+ verdict: "review" | "reject";
41198
+ }[];
41199
+ };
41200
+ };
41201
+ };
41202
+ /** @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 */
41203
+ 403: {
41204
+ headers: {
41205
+ [name: string]: unknown;
41206
+ };
41207
+ content: {
41208
+ "application/json": {
41209
+ code?: string;
41210
+ error: string;
41211
+ issues?: {
41212
+ code: string;
41213
+ message: string;
41214
+ /** @enum {string} */
41215
+ verdict: "review" | "reject";
41216
+ }[];
41217
+ };
41218
+ };
41219
+ };
41220
+ /** @description Product or CLI surface not found */
41221
+ 404: {
41222
+ headers: {
41223
+ [name: string]: unknown;
41224
+ };
41225
+ content: {
41226
+ "application/json": components["schemas"]["Error"];
41227
+ };
41228
+ };
41229
+ /** @description `CLI_DIST_UNAVAILABLE`: the install host's storage failed */
41230
+ 502: {
41231
+ headers: {
41232
+ [name: string]: unknown;
41233
+ };
41234
+ content: {
41235
+ "application/json": {
41236
+ code?: string;
41237
+ error: string;
41238
+ issues?: {
41239
+ code: string;
41240
+ message: string;
41241
+ /** @enum {string} */
41242
+ verdict: "review" | "reject";
41243
+ }[];
41244
+ };
41245
+ };
41246
+ };
41247
+ /** @description `CLI_DIST_NOT_CONFIGURED`: this deployment has no `CLI_DIST` bucket or install host */
41248
+ 503: {
41249
+ headers: {
41250
+ [name: string]: unknown;
41251
+ };
41252
+ content: {
41253
+ "application/json": {
41254
+ code?: string;
41255
+ error: string;
41256
+ issues?: {
41257
+ code: string;
41258
+ message: string;
41259
+ /** @enum {string} */
41260
+ verdict: "review" | "reject";
41261
+ }[];
41262
+ };
41263
+ };
41264
+ };
41265
+ };
41266
+ };
41267
+ put?: never;
41268
+ post?: never;
41269
+ delete?: never;
41270
+ options?: never;
41271
+ head?: never;
41272
+ patch?: never;
41273
+ trace?: never;
41274
+ };
41122
41275
  "/v1/products/{productId}/surfaces/{surfaceId}/cli/publish": {
41123
41276
  parameters: {
41124
41277
  query?: never;
@@ -61667,6 +61820,99 @@ interface components {
61667
61820
  recordValue: string;
61668
61821
  } | null;
61669
61822
  } | null;
61823
+ CliPreview: {
61824
+ /** @description The command name the preview renders, which is also the install slug */
61825
+ binName: string;
61826
+ /** @description The built-in commands every CLI has, as `--help` lists them */
61827
+ builtins: {
61828
+ command: string;
61829
+ description: string;
61830
+ }[];
61831
+ /** @description One entry per tool command, hidden ones included, sorted by command path */
61832
+ commands: components["schemas"]["CliPreviewCommand"][];
61833
+ /** @description The name `--help` opens with: the product name */
61834
+ displayName: string;
61835
+ /** @description The exact text `<bin> --help` prints */
61836
+ help: string;
61837
+ publish: components["schemas"]["CliPreviewPublish"];
61838
+ /** @description The SKILL.md a publish writes and `<bin> skill install` installs */
61839
+ skill: string;
61840
+ };
61841
+ CliPreviewCommand: {
61842
+ /** @description Other paths that reach the command, e.g. the hyphenated name */
61843
+ aliases: string[];
61844
+ /** @description The tool shares its name with a built-in, so only `<bin> call <tool>` reaches it */
61845
+ callOnly: boolean;
61846
+ /** @description The command path after the command name, e.g. `search_tickets` or `call login` */
61847
+ command: string;
61848
+ /** @description A runnable example invocation with every required flag */
61849
+ example: string;
61850
+ /** @description The flags `<bin> <command> --help` lists, in order */
61851
+ flags: components["schemas"]["CliPreviewFlag"][];
61852
+ /** @description The exact text `<bin> <command> --help` prints */
61853
+ help: string;
61854
+ /** @description A command override hides it from `--help`; it still runs */
61855
+ hidden: boolean;
61856
+ /** @description The description is the `Execute the <tool> capability` default a capability without a description gets */
61857
+ placeholderDescription: boolean;
61858
+ /** @description The first sentence of the description, as `--help` lists it */
61859
+ summary: string;
61860
+ /** @description The MCP tool the command calls */
61861
+ tool: string;
61862
+ /** @description The usage line, e.g. `acme search_tickets <query> [flags]` */
61863
+ usage: string;
61864
+ };
61865
+ CliPreviewFlag: {
61866
+ /** @description The schema default, when it declares one */
61867
+ default?: unknown;
61868
+ /** @description The first sentence of the argument's description; empty when it has none */
61869
+ description: string;
61870
+ /** @description The accepted values of an enum argument */
61871
+ enum?: unknown[];
61872
+ /** @description The flag without its leading `--`, e.g. `ticket-id` */
61873
+ name: string;
61874
+ /** @description Also accepted as a positional argument */
61875
+ positional: boolean;
61876
+ /** @description Takes the flag more than once, one value each time */
61877
+ repeatable: boolean;
61878
+ required: boolean;
61879
+ /** @description A TypeScript-style type, as the signature line prints it, e.g. `"open" | "closed"` */
61880
+ type: string;
61881
+ /** @description The tool argument the flag sets, e.g. `ticketId` */
61882
+ wire: string;
61883
+ };
61884
+ CliPreviewPublish: {
61885
+ /** @description What a publish would change; null while unpublished */
61886
+ changes: {
61887
+ commandsAdded: {
61888
+ command: string;
61889
+ tool: string;
61890
+ }[];
61891
+ commandsChanged: {
61892
+ command: string;
61893
+ fields: ("name" | "aliases" | "hidden" | "description" | "flags")[];
61894
+ tool: string;
61895
+ }[];
61896
+ commandsRemoved: {
61897
+ command: string;
61898
+ tool: string;
61899
+ }[];
61900
+ /** @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. */
61901
+ settings: ("binName" | "displayName" | "authMode" | "installDomain" | "other")[];
61902
+ } | null;
61903
+ /** @description The digest a publish of the saved surface would record */
61904
+ digest: string;
61905
+ publishedAt: string | null;
61906
+ /** @description The digest the published version recorded; null while unpublished */
61907
+ publishedDigest: string | null;
61908
+ /**
61909
+ * @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.
61910
+ * @enum {string}
61911
+ */
61912
+ state: "unpublished" | "published" | "changesNotPublished";
61913
+ /** @description The published version; null while unpublished */
61914
+ version: string | null;
61915
+ };
61670
61916
  CliPublishResult: {
61671
61917
  install: components["schemas"]["CliInstallCommands"];
61672
61918
  installDomain: components["schemas"]["CliInstallDomain"];
@@ -61703,6 +61949,17 @@ interface components {
61703
61949
  /** @enum {string} */
61704
61950
  status: "pending" | "applied" | "settled" | "not_applied";
61705
61951
  };
61952
+ ClientSocketDeliveryAccepted: {
61953
+ /** @description The conversation the socket is open on. */
61954
+ conversationId: string;
61955
+ /**
61956
+ * @description Always `socket`: this response carries no events; read them from the socket.
61957
+ * @enum {string}
61958
+ */
61959
+ delivery: "socket";
61960
+ /** @description The turn whose events arrive on the client session socket. */
61961
+ executionId: string;
61962
+ };
61706
61963
  CollectionEnsureConflict: {
61707
61964
  /** @enum {string} */
61708
61965
  code: "external_modification" | "remote_changed";
@@ -79804,6 +80061,11 @@ interface SimulationEpisodeMetrics {
79804
80061
  interruptedMidTurn?: true;
79805
80062
  /** The episode ended `agent_error` because the client model's provider stalled after its retries; unscored. */
79806
80063
  clientModelStall?: true;
80064
+ /** The read a `recording_miss` episode stopped on; upload its answer, then repair the run to play it again. */
80065
+ recordingMiss?: {
80066
+ tool: string;
80067
+ arguments?: Record<string, unknown>;
80068
+ };
79807
80069
  scoringFailed?: true;
79808
80070
  /** Scoring failed because no goal-judge attempt returned a valid verdict: the judge, not the episode, gave no verdict. */
79809
80071
  goalJudgeModelError?: true;
package/dist/index.d.ts CHANGED
@@ -10145,6 +10145,11 @@ interface paths {
10145
10145
  untrustedContentHint?: boolean;
10146
10146
  }[];
10147
10147
  clientToolsFingerprint?: string;
10148
+ /**
10149
+ * @description Set to `socket` to receive this turn on the client session socket named by `realtime` in the init response, instead of in this response. When the server honors it, the response is `202 {executionId, conversationId, delivery: "socket"}`. Otherwise the turn streams over Server-Sent Events as usual.
10150
+ * @enum {string}
10151
+ */
10152
+ delivery?: "socket";
10148
10153
  /** @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
10154
  identityProof?: {
10150
10155
  provider: string;
@@ -10217,7 +10222,7 @@ interface paths {
10217
10222
  "text/event-stream": unknown;
10218
10223
  };
10219
10224
  };
10220
- /** @description Input accepted without a new response stream: a steer receipt from the running execution, or (for `auto`) a queued handle for the next turn */
10225
+ /** @description Input accepted without a new response stream: a steer receipt from the running execution, (for `auto`) a queued handle for the next turn, or, with `delivery: "socket"`, a turn whose events arrive on the client session socket */
10221
10226
  202: {
10222
10227
  headers: {
10223
10228
  [name: string]: unknown;
@@ -10242,7 +10247,7 @@ interface paths {
10242
10247
  status: string;
10243
10248
  } & {
10244
10249
  [key: string]: unknown;
10245
- });
10250
+ }) | components["schemas"]["ClientSocketDeliveryAccepted"];
10246
10251
  };
10247
10252
  };
10248
10253
  /** @description Validation error */
@@ -11337,6 +11342,13 @@ interface paths {
11337
11342
  /** @description Flow name. Present only for a flow session; the agent branch returns `id` alone because the widget does not render either field. */
11338
11343
  name?: string;
11339
11344
  };
11345
+ /** @description Present when this conversation can receive its turns on the client session socket. Send `delivery: "socket"` on chat and resume to use it. Without this field, stream over Server-Sent Events. */
11346
+ realtime?: {
11347
+ /** @description The client session socket protocol, `runtype-client-session-v1`. */
11348
+ protocol: string;
11349
+ /** @description The `wss://` URL to open. Add `protocol`, `sessionId` and `clientVersion` query parameters and offer `runtype.bearer`, the client token and the visitor credential as WebSocket subprotocols. */
11350
+ url: string;
11351
+ };
11340
11352
  /** @description The created (or resumed) client session ID. */
11341
11353
  sessionId: string;
11342
11354
  /** @description The flow or agent this session executes against, resolved server-side. Canonical replacement for `flow.id`, and the exact key to pass as `targetId` when listing or deleting this conversation's history. Matches the value stored on the conversation record; an agent-only token resolves to its agent id. Absent only on the data-only Runtype App branch, which is not chat-capable. */
@@ -11467,6 +11479,11 @@ interface paths {
11467
11479
  untrustedContentHint?: boolean;
11468
11480
  }[];
11469
11481
  clientToolsFingerprint?: string;
11482
+ /**
11483
+ * @description Set to `socket` to receive the resumed turn on the client session socket. When the server honors it, the response is `202 {executionId, conversationId, delivery: "socket"}`. Otherwise the resumed turn streams as usual.
11484
+ * @enum {string}
11485
+ */
11486
+ delivery?: "socket";
11470
11487
  executionId: string;
11471
11488
  messages?: {
11472
11489
  content: string | ({
@@ -11516,6 +11533,19 @@ interface paths {
11516
11533
  "text/event-stream": unknown;
11517
11534
  };
11518
11535
  };
11536
+ /** @description The resumed turn is running without a response stream: with `delivery: "socket"` its events arrive on the client session socket; otherwise read them from the conversation events stream */
11537
+ 202: {
11538
+ headers: {
11539
+ [name: string]: unknown;
11540
+ };
11541
+ content: {
11542
+ "application/json": components["schemas"]["ClientSocketDeliveryAccepted"] | {
11543
+ executionId: string;
11544
+ /** @enum {string} */
11545
+ status: "running";
11546
+ };
11547
+ };
11548
+ };
11519
11549
  /** @description Validation error */
11520
11550
  400: {
11521
11551
  headers: {
@@ -41119,6 +41149,129 @@ interface paths {
41119
41149
  patch?: never;
41120
41150
  trace?: never;
41121
41151
  };
41152
+ "/v1/products/{productId}/surfaces/{surfaceId}/cli/preview": {
41153
+ parameters: {
41154
+ query?: never;
41155
+ header?: never;
41156
+ path?: never;
41157
+ cookie?: never;
41158
+ };
41159
+ /**
41160
+ * Preview a CLI surface
41161
+ * @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.
41162
+ */
41163
+ get: {
41164
+ parameters: {
41165
+ query?: never;
41166
+ header?: never;
41167
+ path: {
41168
+ productId: string;
41169
+ surfaceId: string;
41170
+ };
41171
+ cookie?: never;
41172
+ };
41173
+ requestBody?: never;
41174
+ responses: {
41175
+ /** @description Preview */
41176
+ 200: {
41177
+ headers: {
41178
+ [name: string]: unknown;
41179
+ };
41180
+ content: {
41181
+ "application/json": components["schemas"]["CliPreview"];
41182
+ };
41183
+ };
41184
+ /** @description Invalid IDs, no valid command name (`CLI_BIN_NAME_REQUIRED`) or a name the publish refuses (`CLI_NAME_REJECTED`) */
41185
+ 400: {
41186
+ headers: {
41187
+ [name: string]: unknown;
41188
+ };
41189
+ content: {
41190
+ "application/json": {
41191
+ code?: string;
41192
+ error: string;
41193
+ issues?: {
41194
+ code: string;
41195
+ message: string;
41196
+ /** @enum {string} */
41197
+ verdict: "review" | "reject";
41198
+ }[];
41199
+ };
41200
+ };
41201
+ };
41202
+ /** @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 */
41203
+ 403: {
41204
+ headers: {
41205
+ [name: string]: unknown;
41206
+ };
41207
+ content: {
41208
+ "application/json": {
41209
+ code?: string;
41210
+ error: string;
41211
+ issues?: {
41212
+ code: string;
41213
+ message: string;
41214
+ /** @enum {string} */
41215
+ verdict: "review" | "reject";
41216
+ }[];
41217
+ };
41218
+ };
41219
+ };
41220
+ /** @description Product or CLI surface not found */
41221
+ 404: {
41222
+ headers: {
41223
+ [name: string]: unknown;
41224
+ };
41225
+ content: {
41226
+ "application/json": components["schemas"]["Error"];
41227
+ };
41228
+ };
41229
+ /** @description `CLI_DIST_UNAVAILABLE`: the install host's storage failed */
41230
+ 502: {
41231
+ headers: {
41232
+ [name: string]: unknown;
41233
+ };
41234
+ content: {
41235
+ "application/json": {
41236
+ code?: string;
41237
+ error: string;
41238
+ issues?: {
41239
+ code: string;
41240
+ message: string;
41241
+ /** @enum {string} */
41242
+ verdict: "review" | "reject";
41243
+ }[];
41244
+ };
41245
+ };
41246
+ };
41247
+ /** @description `CLI_DIST_NOT_CONFIGURED`: this deployment has no `CLI_DIST` bucket or install host */
41248
+ 503: {
41249
+ headers: {
41250
+ [name: string]: unknown;
41251
+ };
41252
+ content: {
41253
+ "application/json": {
41254
+ code?: string;
41255
+ error: string;
41256
+ issues?: {
41257
+ code: string;
41258
+ message: string;
41259
+ /** @enum {string} */
41260
+ verdict: "review" | "reject";
41261
+ }[];
41262
+ };
41263
+ };
41264
+ };
41265
+ };
41266
+ };
41267
+ put?: never;
41268
+ post?: never;
41269
+ delete?: never;
41270
+ options?: never;
41271
+ head?: never;
41272
+ patch?: never;
41273
+ trace?: never;
41274
+ };
41122
41275
  "/v1/products/{productId}/surfaces/{surfaceId}/cli/publish": {
41123
41276
  parameters: {
41124
41277
  query?: never;
@@ -61667,6 +61820,99 @@ interface components {
61667
61820
  recordValue: string;
61668
61821
  } | null;
61669
61822
  } | null;
61823
+ CliPreview: {
61824
+ /** @description The command name the preview renders, which is also the install slug */
61825
+ binName: string;
61826
+ /** @description The built-in commands every CLI has, as `--help` lists them */
61827
+ builtins: {
61828
+ command: string;
61829
+ description: string;
61830
+ }[];
61831
+ /** @description One entry per tool command, hidden ones included, sorted by command path */
61832
+ commands: components["schemas"]["CliPreviewCommand"][];
61833
+ /** @description The name `--help` opens with: the product name */
61834
+ displayName: string;
61835
+ /** @description The exact text `<bin> --help` prints */
61836
+ help: string;
61837
+ publish: components["schemas"]["CliPreviewPublish"];
61838
+ /** @description The SKILL.md a publish writes and `<bin> skill install` installs */
61839
+ skill: string;
61840
+ };
61841
+ CliPreviewCommand: {
61842
+ /** @description Other paths that reach the command, e.g. the hyphenated name */
61843
+ aliases: string[];
61844
+ /** @description The tool shares its name with a built-in, so only `<bin> call <tool>` reaches it */
61845
+ callOnly: boolean;
61846
+ /** @description The command path after the command name, e.g. `search_tickets` or `call login` */
61847
+ command: string;
61848
+ /** @description A runnable example invocation with every required flag */
61849
+ example: string;
61850
+ /** @description The flags `<bin> <command> --help` lists, in order */
61851
+ flags: components["schemas"]["CliPreviewFlag"][];
61852
+ /** @description The exact text `<bin> <command> --help` prints */
61853
+ help: string;
61854
+ /** @description A command override hides it from `--help`; it still runs */
61855
+ hidden: boolean;
61856
+ /** @description The description is the `Execute the <tool> capability` default a capability without a description gets */
61857
+ placeholderDescription: boolean;
61858
+ /** @description The first sentence of the description, as `--help` lists it */
61859
+ summary: string;
61860
+ /** @description The MCP tool the command calls */
61861
+ tool: string;
61862
+ /** @description The usage line, e.g. `acme search_tickets <query> [flags]` */
61863
+ usage: string;
61864
+ };
61865
+ CliPreviewFlag: {
61866
+ /** @description The schema default, when it declares one */
61867
+ default?: unknown;
61868
+ /** @description The first sentence of the argument's description; empty when it has none */
61869
+ description: string;
61870
+ /** @description The accepted values of an enum argument */
61871
+ enum?: unknown[];
61872
+ /** @description The flag without its leading `--`, e.g. `ticket-id` */
61873
+ name: string;
61874
+ /** @description Also accepted as a positional argument */
61875
+ positional: boolean;
61876
+ /** @description Takes the flag more than once, one value each time */
61877
+ repeatable: boolean;
61878
+ required: boolean;
61879
+ /** @description A TypeScript-style type, as the signature line prints it, e.g. `"open" | "closed"` */
61880
+ type: string;
61881
+ /** @description The tool argument the flag sets, e.g. `ticketId` */
61882
+ wire: string;
61883
+ };
61884
+ CliPreviewPublish: {
61885
+ /** @description What a publish would change; null while unpublished */
61886
+ changes: {
61887
+ commandsAdded: {
61888
+ command: string;
61889
+ tool: string;
61890
+ }[];
61891
+ commandsChanged: {
61892
+ command: string;
61893
+ fields: ("name" | "aliases" | "hidden" | "description" | "flags")[];
61894
+ tool: string;
61895
+ }[];
61896
+ commandsRemoved: {
61897
+ command: string;
61898
+ tool: string;
61899
+ }[];
61900
+ /** @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. */
61901
+ settings: ("binName" | "displayName" | "authMode" | "installDomain" | "other")[];
61902
+ } | null;
61903
+ /** @description The digest a publish of the saved surface would record */
61904
+ digest: string;
61905
+ publishedAt: string | null;
61906
+ /** @description The digest the published version recorded; null while unpublished */
61907
+ publishedDigest: string | null;
61908
+ /**
61909
+ * @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.
61910
+ * @enum {string}
61911
+ */
61912
+ state: "unpublished" | "published" | "changesNotPublished";
61913
+ /** @description The published version; null while unpublished */
61914
+ version: string | null;
61915
+ };
61670
61916
  CliPublishResult: {
61671
61917
  install: components["schemas"]["CliInstallCommands"];
61672
61918
  installDomain: components["schemas"]["CliInstallDomain"];
@@ -61703,6 +61949,17 @@ interface components {
61703
61949
  /** @enum {string} */
61704
61950
  status: "pending" | "applied" | "settled" | "not_applied";
61705
61951
  };
61952
+ ClientSocketDeliveryAccepted: {
61953
+ /** @description The conversation the socket is open on. */
61954
+ conversationId: string;
61955
+ /**
61956
+ * @description Always `socket`: this response carries no events; read them from the socket.
61957
+ * @enum {string}
61958
+ */
61959
+ delivery: "socket";
61960
+ /** @description The turn whose events arrive on the client session socket. */
61961
+ executionId: string;
61962
+ };
61706
61963
  CollectionEnsureConflict: {
61707
61964
  /** @enum {string} */
61708
61965
  code: "external_modification" | "remote_changed";
@@ -79804,6 +80061,11 @@ interface SimulationEpisodeMetrics {
79804
80061
  interruptedMidTurn?: true;
79805
80062
  /** The episode ended `agent_error` because the client model's provider stalled after its retries; unscored. */
79806
80063
  clientModelStall?: true;
80064
+ /** The read a `recording_miss` episode stopped on; upload its answer, then repair the run to play it again. */
80065
+ recordingMiss?: {
80066
+ tool: string;
80067
+ arguments?: Record<string, unknown>;
80068
+ };
79807
80069
  scoringFailed?: true;
79808
80070
  /** Scoring failed because no goal-judge attempt returned a valid verdict: the judge, not the episode, gave no verdict. */
79809
80071
  goalJudgeModelError?: true;
package/dist/index.mjs CHANGED
@@ -14831,7 +14831,7 @@ function transformQueryParams(params) {
14831
14831
  return result;
14832
14832
  }
14833
14833
  // src/version.ts
14834
- const SDK_VERSION = "11.20.0";
14834
+ const SDK_VERSION = "11.22.0";
14835
14835
  /**
14836
14836
  * Canonical client identity the API uses for attribution
14837
14837
  * (`detectActorSource` in apps/api/src/lib/audit-log.ts keys `'sdk'` off the
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@runtypelabs/sdk",
3
- "version": "11.20.0",
3
+ "version": "11.22.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.116.0",
27
+ "@runtypelabs/shared": "3.119.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 ."