@runtypelabs/sdk 11.18.2 → 11.19.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.d.cts CHANGED
@@ -14413,7 +14413,7 @@ interface paths {
14413
14413
  instruction: string;
14414
14414
  maxToolCalls?: number;
14415
14415
  /**
14416
- * @description Execution priority. Defaults to standard; fast uses DeepSeek V4.1 Flash Fast through Vercel. Applies when creating a task.
14416
+ * @description Execution speed. `standard` (the default) runs at normal speed; `fast` runs at a higher speed for tasks that need it. Applies when creating a task.
14417
14417
  * @enum {string}
14418
14418
  */
14419
14419
  priority?: "standard" | "fast";
@@ -41159,320 +41159,6 @@ interface paths {
41159
41159
  patch?: never;
41160
41160
  trace?: never;
41161
41161
  };
41162
- "/v1/products/{productId}/surfaces/{surfaceId}/cli/graduation": {
41163
- parameters: {
41164
- query?: never;
41165
- header?: never;
41166
- path?: never;
41167
- cookie?: never;
41168
- };
41169
- get?: never;
41170
- put?: never;
41171
- /**
41172
- * Start CLI graduation
41173
- * @description Mints a single-use token that moves a managed `cli` surface to your npm package once it is in that package's package.json on npm.
41174
- */
41175
- post: {
41176
- parameters: {
41177
- query?: never;
41178
- header?: never;
41179
- path: {
41180
- productId: string;
41181
- surfaceId: string;
41182
- };
41183
- cookie?: never;
41184
- };
41185
- requestBody: {
41186
- content: {
41187
- "application/json": {
41188
- /** @description Your npm package, `@acme/cli` or `acme`; never `@rtype/*` */
41189
- packageName: string;
41190
- };
41191
- };
41192
- };
41193
- responses: {
41194
- /** @description Token minted */
41195
- 200: {
41196
- headers: {
41197
- [name: string]: unknown;
41198
- };
41199
- content: {
41200
- "application/json": components["schemas"]["CliGraduationGrant"];
41201
- };
41202
- };
41203
- /** @description Invalid IDs or package name, or no command name */
41204
- 400: {
41205
- headers: {
41206
- [name: string]: unknown;
41207
- };
41208
- content: {
41209
- "application/json": {
41210
- code?: string;
41211
- error: string;
41212
- issues?: {
41213
- code: string;
41214
- message: string;
41215
- verdict: string;
41216
- }[];
41217
- /**
41218
- * @description Why `CLI_GRADUATION_REJECTED` refused the token
41219
- * @enum {string}
41220
- */
41221
- reason?: "malformed" | "bad_signature" | "wrong_surface" | "wrong_package" | "expired" | "consumed" | "bin_changed";
41222
- };
41223
- };
41224
- };
41225
- /** @description Insufficient permissions, or `CLI_SURFACE_GRADUATION_DISABLED` */
41226
- 403: {
41227
- headers: {
41228
- [name: string]: unknown;
41229
- };
41230
- content: {
41231
- "application/json": {
41232
- code?: string;
41233
- error: string;
41234
- issues?: {
41235
- code: string;
41236
- message: string;
41237
- verdict: string;
41238
- }[];
41239
- /**
41240
- * @description Why `CLI_GRADUATION_REJECTED` refused the token
41241
- * @enum {string}
41242
- */
41243
- reason?: "malformed" | "bad_signature" | "wrong_surface" | "wrong_package" | "expired" | "consumed" | "bin_changed";
41244
- };
41245
- };
41246
- };
41247
- /** @description CLI surface not found */
41248
- 404: {
41249
- headers: {
41250
- [name: string]: unknown;
41251
- };
41252
- content: {
41253
- "application/json": components["schemas"]["Error"];
41254
- };
41255
- };
41256
- /** @description `CLI_SURFACE_NOT_MANAGED` */
41257
- 409: {
41258
- headers: {
41259
- [name: string]: unknown;
41260
- };
41261
- content: {
41262
- "application/json": {
41263
- code?: string;
41264
- error: string;
41265
- issues?: {
41266
- code: string;
41267
- message: string;
41268
- verdict: string;
41269
- }[];
41270
- /**
41271
- * @description Why `CLI_GRADUATION_REJECTED` refused the token
41272
- * @enum {string}
41273
- */
41274
- reason?: "malformed" | "bad_signature" | "wrong_surface" | "wrong_package" | "expired" | "consumed" | "bin_changed";
41275
- };
41276
- };
41277
- };
41278
- /** @description `CLI_GRADUATION_NOT_CONFIGURED`: no signing key */
41279
- 503: {
41280
- headers: {
41281
- [name: string]: unknown;
41282
- };
41283
- content: {
41284
- "application/json": {
41285
- code?: string;
41286
- error: string;
41287
- issues?: {
41288
- code: string;
41289
- message: string;
41290
- verdict: string;
41291
- }[];
41292
- /**
41293
- * @description Why `CLI_GRADUATION_REJECTED` refused the token
41294
- * @enum {string}
41295
- */
41296
- reason?: "malformed" | "bad_signature" | "wrong_surface" | "wrong_package" | "expired" | "consumed" | "bin_changed";
41297
- };
41298
- };
41299
- };
41300
- };
41301
- };
41302
- delete?: never;
41303
- options?: never;
41304
- head?: never;
41305
- patch?: never;
41306
- trace?: never;
41307
- };
41308
- "/v1/products/{productId}/surfaces/{surfaceId}/cli/graduation/complete": {
41309
- parameters: {
41310
- query?: never;
41311
- header?: never;
41312
- path?: never;
41313
- cookie?: never;
41314
- };
41315
- get?: never;
41316
- put?: never;
41317
- /**
41318
- * Complete CLI graduation
41319
- * @description Verifies the token in the latest npm version of the package, switches the surface to it once, and commits a forwarding `@rtype/<binName>` release. Calling it again after the switch retries that release.
41320
- */
41321
- post: {
41322
- parameters: {
41323
- query?: never;
41324
- header?: never;
41325
- path: {
41326
- productId: string;
41327
- surfaceId: string;
41328
- };
41329
- cookie?: never;
41330
- };
41331
- requestBody: {
41332
- content: {
41333
- "application/json": {
41334
- /** @description Your npm package, `@acme/cli` or `acme`; never `@rtype/*` */
41335
- packageName: string;
41336
- };
41337
- };
41338
- };
41339
- responses: {
41340
- /** @description Switched over */
41341
- 200: {
41342
- headers: {
41343
- [name: string]: unknown;
41344
- };
41345
- content: {
41346
- "application/json": components["schemas"]["CliGraduationResult"];
41347
- };
41348
- };
41349
- /** @description Invalid IDs or package name, or no command name */
41350
- 400: {
41351
- headers: {
41352
- [name: string]: unknown;
41353
- };
41354
- content: {
41355
- "application/json": {
41356
- code?: string;
41357
- error: string;
41358
- issues?: {
41359
- code: string;
41360
- message: string;
41361
- verdict: string;
41362
- }[];
41363
- /**
41364
- * @description Why `CLI_GRADUATION_REJECTED` refused the token
41365
- * @enum {string}
41366
- */
41367
- reason?: "malformed" | "bad_signature" | "wrong_surface" | "wrong_package" | "expired" | "consumed" | "bin_changed";
41368
- };
41369
- };
41370
- };
41371
- /** @description Insufficient permissions, or `CLI_SURFACE_GRADUATION_DISABLED` */
41372
- 403: {
41373
- headers: {
41374
- [name: string]: unknown;
41375
- };
41376
- content: {
41377
- "application/json": {
41378
- code?: string;
41379
- error: string;
41380
- issues?: {
41381
- code: string;
41382
- message: string;
41383
- verdict: string;
41384
- }[];
41385
- /**
41386
- * @description Why `CLI_GRADUATION_REJECTED` refused the token
41387
- * @enum {string}
41388
- */
41389
- reason?: "malformed" | "bad_signature" | "wrong_surface" | "wrong_package" | "expired" | "consumed" | "bin_changed";
41390
- };
41391
- };
41392
- };
41393
- /** @description CLI surface not found */
41394
- 404: {
41395
- headers: {
41396
- [name: string]: unknown;
41397
- };
41398
- content: {
41399
- "application/json": components["schemas"]["Error"];
41400
- };
41401
- };
41402
- /** @description `CLI_SURFACE_NOT_MANAGED`, `CLI_GRADUATION_TOKEN_NOT_FOUND`, `CLI_GRADUATION_PRERELEASE`, `CLI_GRADUATION_REJECTED` or `CLI_GRADUATION_CONFLICT` */
41403
- 409: {
41404
- headers: {
41405
- [name: string]: unknown;
41406
- };
41407
- content: {
41408
- "application/json": {
41409
- code?: string;
41410
- error: string;
41411
- issues?: {
41412
- code: string;
41413
- message: string;
41414
- verdict: string;
41415
- }[];
41416
- /**
41417
- * @description Why `CLI_GRADUATION_REJECTED` refused the token
41418
- * @enum {string}
41419
- */
41420
- reason?: "malformed" | "bad_signature" | "wrong_surface" | "wrong_package" | "expired" | "consumed" | "bin_changed";
41421
- };
41422
- };
41423
- };
41424
- /** @description `CLI_NPM_UNAVAILABLE` */
41425
- 502: {
41426
- headers: {
41427
- [name: string]: unknown;
41428
- };
41429
- content: {
41430
- "application/json": {
41431
- code?: string;
41432
- error: string;
41433
- issues?: {
41434
- code: string;
41435
- message: string;
41436
- verdict: string;
41437
- }[];
41438
- /**
41439
- * @description Why `CLI_GRADUATION_REJECTED` refused the token
41440
- * @enum {string}
41441
- */
41442
- reason?: "malformed" | "bad_signature" | "wrong_surface" | "wrong_package" | "expired" | "consumed" | "bin_changed";
41443
- };
41444
- };
41445
- };
41446
- /** @description `CLI_GRADUATION_NOT_CONFIGURED`: no signing key */
41447
- 503: {
41448
- headers: {
41449
- [name: string]: unknown;
41450
- };
41451
- content: {
41452
- "application/json": {
41453
- code?: string;
41454
- error: string;
41455
- issues?: {
41456
- code: string;
41457
- message: string;
41458
- verdict: string;
41459
- }[];
41460
- /**
41461
- * @description Why `CLI_GRADUATION_REJECTED` refused the token
41462
- * @enum {string}
41463
- */
41464
- reason?: "malformed" | "bad_signature" | "wrong_surface" | "wrong_package" | "expired" | "consumed" | "bin_changed";
41465
- };
41466
- };
41467
- };
41468
- };
41469
- };
41470
- delete?: never;
41471
- options?: never;
41472
- head?: never;
41473
- patch?: never;
41474
- trace?: never;
41475
- };
41476
41162
  "/v1/products/{productId}/surfaces/{surfaceId}/cli/publish": {
41477
41163
  parameters: {
41478
41164
  query?: never;
@@ -41505,7 +41191,7 @@ interface paths {
41505
41191
  "application/json": components["schemas"]["CliPublishStatus"];
41506
41192
  };
41507
41193
  };
41508
- /** @description Invalid IDs, or a name or package the publish refuses */
41194
+ /** @description Invalid IDs, or a name, install domain (`CLI_INSTALL_DOMAIN_INVALID`) or package the publish refuses */
41509
41195
  400: {
41510
41196
  headers: {
41511
41197
  [name: string]: unknown;
@@ -41523,7 +41209,7 @@ interface paths {
41523
41209
  };
41524
41210
  };
41525
41211
  };
41526
- /** @description Insufficient permissions, or `CLI_SURFACE_PUBLISH_DISABLED` while publishing is off for the account */
41212
+ /** @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 */
41527
41213
  403: {
41528
41214
  headers: {
41529
41215
  [name: string]: unknown;
@@ -41591,7 +41277,7 @@ interface paths {
41591
41277
  put?: never;
41592
41278
  /**
41593
41279
  * Publish a CLI surface
41594
- * @description Writes the surface's `cli.json`, `SKILL.md` and install scripts to the install host under its slug (its command name), so `curl -fsSL https://get.runtype.com/<slug> | sh` installs it. The first version is 1.0.0; changed files bump the patch version. A slug belongs to the first surface that publishes it, and a name close to a protected brand needs a manual review first.
41280
+ * @description Writes the surface's `cli.json`, `SKILL.md` and install scripts to the install host under its slug (its command name), so `curl -fsSL https://get.runtype.com/<slug> | sh` installs it. With `installDomain` set, publish issues a TXT token (`_runtype-install.<installDomain>`); once a publish finds it, the install scripts point at `https://<installDomain>`, which serves the same files at its root. Until then the CLI installs from the Runtype host and `installDomain.state` is `pending`. The first version is 1.0.0; changed files bump the patch version. A slug belongs to the first surface that publishes it, a verified domain to the surface whose TXT record proves it, and a name close to a protected brand needs a manual review first.
41595
41281
  */
41596
41282
  post: {
41597
41283
  parameters: {
@@ -41614,7 +41300,7 @@ interface paths {
41614
41300
  "application/json": components["schemas"]["CliPublishResult"];
41615
41301
  };
41616
41302
  };
41617
- /** @description Invalid IDs, or a name or package the publish refuses */
41303
+ /** @description Invalid IDs, or a name, install domain (`CLI_INSTALL_DOMAIN_INVALID`) or package the publish refuses */
41618
41304
  400: {
41619
41305
  headers: {
41620
41306
  [name: string]: unknown;
@@ -41632,7 +41318,7 @@ interface paths {
41632
41318
  };
41633
41319
  };
41634
41320
  };
41635
- /** @description Insufficient permissions, or `CLI_SURFACE_PUBLISH_DISABLED` while publishing is off for the account */
41321
+ /** @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 */
41636
41322
  403: {
41637
41323
  headers: {
41638
41324
  [name: string]: unknown;
@@ -41659,7 +41345,7 @@ interface paths {
41659
41345
  "application/json": components["schemas"]["Error"];
41660
41346
  };
41661
41347
  };
41662
- /** @description The surface is inactive (`CLI_SURFACE_INACTIVE`) or has no tools (`CLI_SURFACE_HAS_NO_TOOLS`), another surface publishes its slug (`CLI_SLUG_TAKEN`), its name needs a brand review (`CLI_NAME_NEEDS_REVIEW`), or a concurrent publish changed it (`CLI_PUBLISH_CONFLICT`) */
41348
+ /** @description The surface is inactive (`CLI_SURFACE_INACTIVE`) or has no tools (`CLI_SURFACE_HAS_NO_TOOLS`), another surface publishes its slug (`CLI_SLUG_TAKEN`) or holds its install domain while its TXT record still names that surface (`CLI_INSTALL_DOMAIN_TAKEN`), its name needs a brand review (`CLI_NAME_NEEDS_REVIEW`), or a concurrent publish changed it (`CLI_PUBLISH_CONFLICT`) */
41663
41349
  409: {
41664
41350
  headers: {
41665
41351
  [name: string]: unknown;
@@ -60659,7 +60345,7 @@ interface paths {
60659
60345
  enableCanvasOnboarding: boolean;
60660
60346
  enableChromeSurface: boolean;
60661
60347
  enableCliSurface?: boolean;
60662
- enableCliSurfaceGraduation?: boolean;
60348
+ enableCliSurfaceInstallDomain?: boolean;
60663
60349
  enableCliSurfacePublish?: boolean;
60664
60350
  enableDashboardAssistant: boolean;
60665
60351
  enableDecisionModelsDashboard: boolean;
@@ -61986,45 +61672,6 @@ interface components {
61986
61672
  /** @description ISO timestamp of the provider message. */
61987
61673
  timestamp: string;
61988
61674
  };
61989
- CliGraduationGrant: {
61990
- binName: string;
61991
- /** @description Publish the version carrying the token before this */
61992
- expiresAt: string;
61993
- packageJson: {
61994
- rtype: {
61995
- graduationToken: string;
61996
- surfaceId: string;
61997
- };
61998
- };
61999
- packageName: string;
62000
- surfaceId: string;
62001
- token: string;
62002
- };
62003
- CliGraduationResult: {
62004
- /** @description The `npm deprecate` a Runtype maintainer runs (it needs 2FA) */
62005
- deprecation: {
62006
- command: string;
62007
- message: string;
62008
- packageName: string;
62009
- } | null;
62010
- /** @description The final `@rtype/<binName>` release, forwarding to your package */
62011
- forwarding: {
62012
- commitSha: string | null;
62013
- message: string;
62014
- packageName: string;
62015
- /** @enum {string} */
62016
- state: "committed" | "unchanged" | "retried" | "not_published" | "skipped" | "not_configured" | "failed";
62017
- version: string | null;
62018
- };
62019
- graduatedAt: string;
62020
- /**
62021
- * @description `retried`: already switched to this package, so only forwarding ran again
62022
- * @enum {string}
62023
- */
62024
- outcome: "graduated" | "retried";
62025
- packageName: string;
62026
- version: string;
62027
- };
62028
61675
  CliInstallCommands: {
62029
61676
  /** @description The Windows install command: `irm <url>/install.ps1 | iex` */
62030
61677
  powershell: string;
@@ -62033,8 +61680,35 @@ interface components {
62033
61680
  /** @description `GET` serves the POSIX install script, e.g. `https://get.runtype.com/<slug>` */
62034
61681
  url: string;
62035
61682
  } | null;
61683
+ /** @description The custom install domain the surface asks for and whether it is verified; null when it asks for none */
61684
+ CliInstallDomain: {
61685
+ /** @description The host a CNAME for `domain` points at when Runtype serves the domain */
61686
+ cnameTarget: string;
61687
+ /** @description The custom install domain the surface asks for, e.g. `get.acme.com` */
61688
+ domain: string;
61689
+ /** @description Each file the domain serves at its root, as the Runtype install host serves it; copy them to serve the domain yourself */
61690
+ files: {
61691
+ "SKILL.md": string;
61692
+ "cli.json": string;
61693
+ "install.ps1": string;
61694
+ "install.sh": string;
61695
+ };
61696
+ /**
61697
+ * @description `verified`: the TXT record proved control of the domain, and the published files point at it. `pending`: the CLI installs from the Runtype install host until the TXT record is found on a later publish.
61698
+ * @enum {string}
61699
+ */
61700
+ state: "pending" | "verified";
61701
+ /** @description The TXT record that verifies the domain; null until a publish has issued the token */
61702
+ verification: {
61703
+ /** @description The TXT record name, `_runtype-install.<domain>` */
61704
+ recordName: string;
61705
+ /** @description The TXT record value: this surface's verification token */
61706
+ recordValue: string;
61707
+ } | null;
61708
+ } | null;
62036
61709
  CliPublishResult: {
62037
61710
  install: components["schemas"]["CliInstallCommands"];
61711
+ installDomain: components["schemas"]["CliInstallDomain"];
62038
61712
  /**
62039
61713
  * @description `unchanged`: the files match the last publish, so the version stays; every file is still rewritten
62040
61714
  * @enum {string}
@@ -62046,6 +61720,7 @@ interface components {
62046
61720
  };
62047
61721
  CliPublishStatus: {
62048
61722
  install: components["schemas"]["CliInstallCommands"];
61723
+ installDomain: components["schemas"]["CliInstallDomain"];
62049
61724
  /** @description When the files last changed */
62050
61725
  publishedAt: string | null;
62051
61726
  /** @description The install slug, which is the surface's command name; null while it has none */
@@ -64275,6 +63950,11 @@ interface components {
64275
63950
  };
64276
63951
  seq: number;
64277
63952
  stepId?: string;
63953
+ subagent?: {
63954
+ agentName?: string;
63955
+ parentToolCallId?: string;
63956
+ toolName: string;
63957
+ };
64278
63958
  toolCallId?: string;
64279
63959
  toolId?: string;
64280
63960
  toolName?: string;
@@ -67765,6 +67445,19 @@ interface ContextErrorHandling {
67765
67445
  onError: ErrorHandlingMode;
67766
67446
  fallbacks?: ContextFallback[];
67767
67447
  }
67448
+ /** A single paused local tool call awaiting client execution. */
67449
+ interface LocalToolPausedState {
67450
+ toolName: string;
67451
+ executionId: string;
67452
+ parameters?: unknown;
67453
+ /** Set when a sub-agent raised the request on the parent it is parked on; the caller may not hold its handler. */
67454
+ subagent?: LocalToolSubagent;
67455
+ }
67456
+ /** The parent call a sub-agent's request is shown under; answering it on the parent forwards it to the child. */
67457
+ interface LocalToolSubagent {
67458
+ toolName: string;
67459
+ parentToolCallId: string;
67460
+ }
67768
67461
  /**
67769
67462
  * Options for the flow stream consumers.
67770
67463
  *
@@ -68524,6 +68217,12 @@ interface FlowSummary {
68524
68217
  results: Map<string, any>;
68525
68218
  /** Whether the flow completed successfully */
68526
68219
  success: boolean;
68220
+ /** Set when the run stopped on sub-agent requests this caller registered no handler for; answer them on the parent. */
68221
+ paused?: {
68222
+ status: 'paused';
68223
+ executionId: string;
68224
+ pausedTools: LocalToolPausedState[];
68225
+ };
68527
68226
  }
68528
68227
  /**
68529
68228
  * Generic flow-step config for step types that do not yet have a typed SDK
@@ -80394,8 +80093,13 @@ export declare class SimulationsEndpoint {
80394
80093
  }>;
80395
80094
  /** Answer one recorded exchange as published and as the variant's design answers it. */
80396
80095
  previewVariant(simulationId: string, variantId: string, data: PreviewSimulationVariantRequest): Promise<PreviewSimulationVariantResponse>;
80397
- /** Discard a run variant's frozen synthesized answers so its next run synthesizes again. */
80398
- resynthesizeVariant(runId: string, variantId: string): Promise<{
80096
+ /**
80097
+ * Discard a run variant's frozen synthesized answers so its next run synthesizes again; `tools` limits it to those
80098
+ * server tools' answers.
80099
+ */
80100
+ resynthesizeVariant(runId: string, variantId: string, options?: {
80101
+ tools?: string[];
80102
+ }): Promise<{
80399
80103
  discarded: number;
80400
80104
  }>;
80401
80105
  /** Mark a synthesized answer plausible or implausible; `null` clears the review. */