@runtypelabs/sdk 10.16.0 → 10.17.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
@@ -11911,6 +11911,7 @@ const AGENT_CONFIG_KEYS = [
11911
11911
  "sandbox",
11912
11912
  "tenancyStrategy",
11913
11913
  "durability",
11914
+ "busyMessageRouting",
11914
11915
  "state"
11915
11916
  ];
11916
11917
  const AGENT_CONFIG_KEY_LIST = [...AGENT_CONFIG_KEYS].sort();
@@ -14490,7 +14491,7 @@ function transformQueryParams(params) {
14490
14491
  }
14491
14492
  //#endregion
14492
14493
  //#region src/version.ts
14493
- const SDK_VERSION = "10.16.0";
14494
+ const SDK_VERSION = "10.17.0";
14494
14495
  /**
14495
14496
  * Canonical client identity the API uses for attribution
14496
14497
  * (`detectActorSource` in apps/api/src/lib/audit-log.ts keys `'sdk'` off the
package/dist/index.d.cts CHANGED
@@ -1014,6 +1014,11 @@ interface paths {
1014
1014
  enabled: true;
1015
1015
  types: ("markdown" | "component")[];
1016
1016
  };
1017
+ busyMessageRouting?: {
1018
+ classifierModel?: string;
1019
+ /** @enum {string} */
1020
+ mode?: "enforced" | "off";
1021
+ };
1017
1022
  contextManagement?: {
1018
1023
  compaction?: {
1019
1024
  enabled?: boolean;
@@ -1264,6 +1269,10 @@ interface paths {
1264
1269
  topK?: number;
1265
1270
  topP?: number;
1266
1271
  voice?: {
1272
+ directTools?: {
1273
+ enabled?: boolean;
1274
+ model?: string;
1275
+ };
1267
1276
  disclosure?: boolean;
1268
1277
  elevenLabs?: {
1269
1278
  modelId?: string;
@@ -1551,6 +1560,11 @@ interface paths {
1551
1560
  enabled: true;
1552
1561
  types: ("markdown" | "component")[];
1553
1562
  };
1563
+ busyMessageRouting?: {
1564
+ classifierModel?: string;
1565
+ /** @enum {string} */
1566
+ mode?: "enforced" | "off";
1567
+ };
1554
1568
  contextManagement?: {
1555
1569
  compaction?: {
1556
1570
  enabled?: boolean;
@@ -1801,6 +1815,10 @@ interface paths {
1801
1815
  topK?: number;
1802
1816
  topP?: number;
1803
1817
  voice?: {
1818
+ directTools?: {
1819
+ enabled?: boolean;
1820
+ model?: string;
1821
+ };
1804
1822
  disclosure?: boolean;
1805
1823
  elevenLabs?: {
1806
1824
  modelId?: string;
@@ -2377,6 +2395,11 @@ interface paths {
2377
2395
  enabled: true;
2378
2396
  types: ("markdown" | "component")[];
2379
2397
  };
2398
+ busyMessageRouting?: {
2399
+ classifierModel?: string;
2400
+ /** @enum {string} */
2401
+ mode?: "enforced" | "off";
2402
+ };
2380
2403
  contextManagement?: {
2381
2404
  compaction?: {
2382
2405
  enabled?: boolean;
@@ -2627,6 +2650,10 @@ interface paths {
2627
2650
  topK?: number;
2628
2651
  topP?: number;
2629
2652
  voice?: {
2653
+ directTools?: {
2654
+ enabled?: boolean;
2655
+ model?: string;
2656
+ };
2630
2657
  disclosure?: boolean;
2631
2658
  elevenLabs?: {
2632
2659
  modelId?: string;
@@ -4813,8 +4840,8 @@ interface paths {
4813
4840
  parameters: {
4814
4841
  query?: never;
4815
4842
  header?: {
4816
- /** @description How a durable turn handles overlap. `reject` (default) answers CONVERSATION_BUSY naming the occupant execution, its phase, and a Retry-After; `supersede` cancels and replaces; `queue` runs afterward; `steer` durably appends new user-message deltas to the same execution at a safe boundary, attaches through the host's slot claim when the host has not started yet, or starts the next execution if completion wins. Steer requires a conversationId, preserves configuration and authority, cannot combine with coalesce, and rejects unsupported lanes. Other policies remain ignored on in-process execution. */
4817
- "x-runtype-concurrency"?: "reject" | "supersede" | "queue" | "steer";
4843
+ /** @description How a durable turn handles overlap. `reject` (default) answers CONVERSATION_BUSY naming the occupant execution, its phase, and a Retry-After; `supersede` cancels and replaces; `queue` runs afterward; `steer` durably appends new user-message deltas to the same execution at a safe boundary, attaches through the host's slot claim when the host has not started yet, or starts the next execution if completion wins. Steer requires a conversationId, preserves configuration and authority, cannot combine with coalesce, and rejects unsupported lanes. `auto` sends the same user-message deltas as steer and lets a classifier choose: while a turn runs, a message that belongs to it steers and an independent one queues as the next turn; with nothing running it is an ordinary turn with no route report. A routed or downgraded answer reports the route in `X-Runtype-Busy-Message-Route` / `-Source` (plus `-Probability` and `-Model` when the classifier answered) and, on JSON bodies, `busyMessageRoute`. Where auto cannot route (in-process execution, stored history, no conversationId, coalesce, Prefer: respond-async) it keeps the default admission and reports source `disabled`. Other policies remain ignored on in-process execution. */
4844
+ "x-runtype-concurrency"?: "reject" | "supersede" | "queue" | "steer" | "auto";
4818
4845
  /** @description Send `true` to fold this request into an already-pending turn for the same conversation instead of starting a second one. The response is the pending execution. Any other value (or omitting the header) starts a new turn. */
4819
4846
  "x-runtype-coalesce"?: "true";
4820
4847
  /** @description Caller-chosen key that makes admission idempotent: a retry with the same key returns the ORIGINAL execution rather than starting a second turn, and consumes no additional quota. Scoped to the durable lane. */
@@ -9670,7 +9697,7 @@ interface paths {
9670
9697
  put?: never;
9671
9698
  /**
9672
9699
  * Send a client chat message
9673
- * @description Send a message for a browser client-token chat session. The request streams flow/agent events over Server-Sent Events. `turnId` and `submitMode` are optional and let newer Persona clients suppress stale interrupted responses; older clients can omit both fields. Opt-in `steer` accepts exactly one new user message whose `id` equals `turnId` for visitor-owned native durable agents. A new execution streams SSE; steering an existing execution returns a 202 delivery receipt without replacing its response. Retry with the same turn and message IDs. Send `voice: { spoken: true }` when the user turn came from a live voice call and the reply will be spoken by a voice model; the turn then runs with a per-turn instruction to lead with a short, speakable answer, which is not stored in the conversation.
9700
+ * @description Send a message for a browser client-token chat session. The request streams flow/agent events over Server-Sent Events. `turnId` and `submitMode` are optional and let newer Persona clients suppress stale interrupted responses; older clients can omit both fields. Opt-in `steer` accepts exactly one new user message whose `id` equals `turnId` for visitor-owned native durable agents. A new execution streams SSE; steering an existing execution returns a 202 delivery receipt without replacing its response. `auto` takes the same shape as `steer` and lets a classifier choose while a turn runs: a message that belongs to the running work steers it (202 delivery receipt), and an independent one queues as the next turn (202 queued handle); with nothing running it is an ordinary turn with no route report. A routed or downgraded answer carries `X-Runtype-Busy-Message-Route` and `X-Runtype-Busy-Message-Source` (plus `-Probability` and `-Model` when the classifier answered), repeated as `busyMessageRoute` on JSON bodies. Where `auto` cannot route (another lane, another message shape) it behaves as `normal` and reports source `disabled`. Retry with the same turn and message IDs. Send `voice: { spoken: true }` when the user turn came from a live voice call and the reply will be spoken by a voice model; the turn then runs with a per-turn instruction to lead with a short, speakable answer, which is not stored in the conversation.
9674
9701
  */
9675
9702
  post: {
9676
9703
  parameters: {
@@ -9750,7 +9777,7 @@ interface paths {
9750
9777
  };
9751
9778
  sessionId: string;
9752
9779
  /** @enum {string} */
9753
- submitMode?: "normal" | "interrupt" | "steer";
9780
+ submitMode?: "normal" | "interrupt" | "steer" | "auto";
9754
9781
  turnId?: string;
9755
9782
  /** @description Voice context for this turn. Omit for typed chat; behavior is unchanged when absent. */
9756
9783
  voice?: {
@@ -9770,7 +9797,7 @@ interface paths {
9770
9797
  "text/event-stream": unknown;
9771
9798
  };
9772
9799
  };
9773
- /** @description Input accepted by an existing durable execution; no new response stream */
9800
+ /** @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 */
9774
9801
  202: {
9775
9802
  headers: {
9776
9803
  [name: string]: unknown;
@@ -9779,6 +9806,7 @@ interface paths {
9779
9806
  "application/json": {
9780
9807
  /** @enum {boolean} */
9781
9808
  accepted: true;
9809
+ busyMessageRoute?: components["schemas"]["BusyMessageRouteReport"];
9782
9810
  conversationId: string;
9783
9811
  deliveryId: string;
9784
9812
  /** @enum {string} */
@@ -9786,7 +9814,15 @@ interface paths {
9786
9814
  deliveryStatusUrl: string;
9787
9815
  eventsUrl: string;
9788
9816
  executionId: string;
9789
- };
9817
+ } | ({
9818
+ busyMessageRoute: components["schemas"]["BusyMessageRouteReport"];
9819
+ /** @description The queued execution, distinct from the running one. */
9820
+ executionId: string;
9821
+ /** @description `queued` until the running execution finishes. */
9822
+ status: string;
9823
+ } & {
9824
+ [key: string]: unknown;
9825
+ });
9790
9826
  };
9791
9827
  };
9792
9828
  /** @description Validation error */
@@ -14344,7 +14380,7 @@ interface paths {
14344
14380
  put?: never;
14345
14381
  /**
14346
14382
  * Execute a flow or agent
14347
- * @description Main dispatch endpoint for flow and agent execution with record resolution. Supports streaming via SSE or synchronous JSON responses. Send the RFC 7240 `Prefer: respond-async` header to receive a durable execution handle immediately, then poll its status URL for completion. A saved agent may run on the durable session lane; the admission headers `x-runtype-concurrency` (reject, supersede, queue, steer), `x-runtype-coalesce` (true) and `idempotency-key` then apply exactly as on `POST /v1/agents/{id}/execute`, and are ignored for in-process execution except steer, which fails explicitly on unsupported lanes. Any other x-runtype-concurrency value is refused with 400 INVALID_CONCURRENCY_MODE. Steer accepts only new user-message deltas, preserves the active execution configuration and authority, and returns a deliveryId with a deliveryStatusUrl. Prefer: respond-async with steer returns a native delivery receipt without queuing an HTTP replay.
14383
+ * @description Main dispatch endpoint for flow and agent execution with record resolution. Supports streaming via SSE or synchronous JSON responses. Send the RFC 7240 `Prefer: respond-async` header to receive a durable execution handle immediately, then poll its status URL for completion. A saved agent may run on the durable session lane; the admission headers `x-runtype-concurrency` (reject, supersede, queue, steer), `x-runtype-coalesce` (true) and `idempotency-key` then apply exactly as on `POST /v1/agents/{id}/execute`, and are ignored for in-process execution except steer, which fails explicitly on unsupported lanes. `x-runtype-concurrency: auto` sends the same user-message deltas as steer and lets a classifier choose: while a turn runs, a message that belongs to it steers and an independent one queues as the next turn; with nothing running it is an ordinary turn with no route report. A routed or downgraded answer carries `X-Runtype-Busy-Message-Route` (steer or queue) and `X-Runtype-Busy-Message-Source` (classifier, shadow, abstained, timeout, error, unanswered, circuit_open, or disabled), plus `X-Runtype-Busy-Message-Probability` and `X-Runtype-Busy-Message-Model` when the classifier answered; JSON bodies repeat them as `busyMessageRoute`. Where auto cannot route (in-process execution, stored history, a flow, no conversationId, coalesce, Prefer: respond-async) it keeps the default admission and reports source `disabled`. Any other x-runtype-concurrency value is refused with 400 INVALID_CONCURRENCY_MODE. Steer accepts only new user-message deltas, preserves the active execution configuration and authority, and returns a deliveryId with a deliveryStatusUrl. Prefer: respond-async with steer returns a native delivery receipt without queuing an HTTP replay.
14348
14384
  */
14349
14385
  post: {
14350
14386
  parameters: {
@@ -14370,6 +14406,11 @@ interface paths {
14370
14406
  enabled: true;
14371
14407
  types: ("markdown" | "component")[];
14372
14408
  };
14409
+ busyMessageRouting?: {
14410
+ classifierModel?: string;
14411
+ /** @enum {string} */
14412
+ mode?: "enforced" | "off";
14413
+ };
14373
14414
  claudeManagedConfig?: {
14374
14415
  anthropicAgentId?: string;
14375
14416
  anthropicAgentVersion?: number;
@@ -14556,6 +14597,10 @@ interface paths {
14556
14597
  topP?: number;
14557
14598
  versionId?: string;
14558
14599
  voice?: {
14600
+ directTools?: {
14601
+ enabled?: boolean;
14602
+ model?: string;
14603
+ };
14559
14604
  disclosure?: boolean;
14560
14605
  elevenLabs?: {
14561
14606
  modelId?: string;
@@ -14832,6 +14877,11 @@ interface paths {
14832
14877
  enabled: true;
14833
14878
  types: ("markdown" | "component")[];
14834
14879
  };
14880
+ busyMessageRouting?: {
14881
+ classifierModel?: string;
14882
+ /** @enum {string} */
14883
+ mode?: "enforced" | "off";
14884
+ };
14835
14885
  claudeManagedConfig?: {
14836
14886
  anthropicAgentId?: string;
14837
14887
  anthropicAgentVersion?: number;
@@ -15018,6 +15068,10 @@ interface paths {
15018
15068
  topP?: number;
15019
15069
  versionId?: string;
15020
15070
  voice?: {
15071
+ directTools?: {
15072
+ enabled?: boolean;
15073
+ model?: string;
15074
+ };
15021
15075
  disclosure?: boolean;
15022
15076
  elevenLabs?: {
15023
15077
  modelId?: string;
@@ -52874,6 +52928,8 @@ interface components {
52874
52928
  error: string;
52875
52929
  };
52876
52930
  AgentEnsureResponse: {
52931
+ /** @description Non-blocking advisories, e.g. SCHEDULE_AGENT_CONFIG_UNSUPPORTED when this converge (or, on a dry run, the planned one) changes what active schedules run into a version they cannot run. */
52932
+ _warnings?: string[];
52877
52933
  agentId: string;
52878
52934
  /** @description Present when the request carried capabilities: one row per declared capability, then removals. */
52879
52935
  capabilityChanges?: components["schemas"]["AgentEnsureCapabilityChange"][];
@@ -52892,6 +52948,8 @@ interface components {
52892
52948
  /** @enum {string} */
52893
52949
  result: "definitionRequired";
52894
52950
  } | {
52951
+ /** @description Non-blocking advisories, e.g. SCHEDULE_AGENT_CONFIG_UNSUPPORTED when this converge (or, on a dry run, the planned one) changes what active schedules run into a version they cannot run. */
52952
+ _warnings?: string[];
52895
52953
  agentId?: string;
52896
52954
  /** @description Present when the request carried capabilities: one row per declared capability, then removals. */
52897
52955
  capabilityChanges?: components["schemas"]["AgentEnsureCapabilityChange"][];
@@ -52961,6 +53019,11 @@ interface components {
52961
53019
  enabled: true;
52962
53020
  types: ("markdown" | "component")[];
52963
53021
  };
53022
+ busyMessageRouting?: {
53023
+ classifierModel?: string;
53024
+ /** @enum {string} */
53025
+ mode?: "enforced" | "off";
53026
+ };
52964
53027
  contextManagement?: {
52965
53028
  compaction?: {
52966
53029
  enabled?: boolean;
@@ -53211,6 +53274,10 @@ interface components {
53211
53274
  topK?: number;
53212
53275
  topP?: number;
53213
53276
  voice?: {
53277
+ directTools?: {
53278
+ enabled?: boolean;
53279
+ model?: string;
53280
+ };
53214
53281
  disclosure?: boolean;
53215
53282
  elevenLabs?: {
53216
53283
  modelId?: string;
@@ -53360,6 +53427,27 @@ interface components {
53360
53427
  toolId: string;
53361
53428
  toolName: string;
53362
53429
  };
53430
+ BusyMessageRouteReport: {
53431
+ /** @description The decision model that answered. */
53432
+ model?: string;
53433
+ /** @description Probability the message belongs to the running work (classifier only). */
53434
+ probability?: number;
53435
+ /**
53436
+ * @description Where the message went: into the running execution, or after it.
53437
+ * @enum {string}
53438
+ */
53439
+ route: "steer" | "queue";
53440
+ /**
53441
+ * @description Why this route applied.
53442
+ * @enum {string}
53443
+ */
53444
+ source: "classifier" | "abstained" | "timeout" | "error" | "unanswered" | "circuit_open" | "disabled";
53445
+ /**
53446
+ * @description The classifier chose steer but the running execution could no longer take input.
53447
+ * @enum {boolean}
53448
+ */
53449
+ steerUnavailable?: true;
53450
+ };
53363
53451
  CaptureExecutionPreview: {
53364
53452
  /** @description The recorded tool-call actions in invocation order — the fork-picker rows. */
53365
53453
  actions: components["schemas"]["CaptureExecutionPreviewAction"][];
@@ -53755,6 +53843,11 @@ interface components {
53755
53843
  enabled: true;
53756
53844
  types: ("markdown" | "component")[];
53757
53845
  };
53846
+ busyMessageRouting?: {
53847
+ classifierModel?: string;
53848
+ /** @enum {string} */
53849
+ mode?: "enforced" | "off";
53850
+ };
53758
53851
  contextManagement?: {
53759
53852
  compaction?: {
53760
53853
  enabled?: boolean;
@@ -54005,6 +54098,10 @@ interface components {
54005
54098
  topK?: number;
54006
54099
  topP?: number;
54007
54100
  voice?: {
54101
+ directTools?: {
54102
+ enabled?: boolean;
54103
+ model?: string;
54104
+ };
54008
54105
  disclosure?: boolean;
54009
54106
  elevenLabs?: {
54010
54107
  modelId?: string;
@@ -55913,6 +56010,8 @@ interface components {
55913
56010
  ref: string;
55914
56011
  /** @enum {string} */
55915
56012
  result: "created" | "updated" | "unchanged" | "failed" | "skipped" | "pruned";
56013
+ /** @description Non-blocking advisories, e.g. SCHEDULE_AGENT_CONFIG_UNSUPPORTED when converging an agent moved `live` onto a version its active schedules cannot run. */
56014
+ warnings?: string[];
55916
56015
  }[];
55917
56016
  /** @description True when one or more entities failed to converge (re-run to self-heal). */
55918
56017
  hasFailures: boolean;
@@ -63432,6 +63531,14 @@ interface AgentDefinitionConfig {
63432
63531
  maxBudgetMs?: number | null;
63433
63532
  forced?: 'durable' | 'in_process';
63434
63533
  };
63534
+ /**
63535
+ * Steer-or-queue routing for a `submitMode: 'auto'` message sent while a turn runs. `mode` is
63536
+ * `enforced` (default) or `off` (always queue); `classifierModel` is a `GET /v1/decision-models` id.
63537
+ */
63538
+ busyMessageRouting?: {
63539
+ mode?: 'enforced' | 'off';
63540
+ classifierModel?: string;
63541
+ };
63435
63542
  /** Opt-in agent state channel — a shared JSON document the client and agent both see. */
63436
63543
  state?: {
63437
63544
  initial?: Record<string, unknown>;
@@ -63593,6 +63700,8 @@ interface EnsureAgentConverged {
63593
63700
  skillBindings?: AgentSkillBindingChange[];
63594
63701
  /** Present when the request carried `capabilities`. */
63595
63702
  capabilityChanges?: AgentCapabilityChange[];
63703
+ /** Non-blocking advisories, e.g. SCHEDULE_AGENT_CONFIG_UNSUPPORTED when `live` moves onto a version schedules cannot run. */
63704
+ _warnings?: string[];
63596
63705
  }
63597
63706
  interface EnsureAgentPlan {
63598
63707
  result: 'plan';
@@ -63607,6 +63716,8 @@ interface EnsureAgentPlan {
63607
63716
  skillBindings?: AgentSkillBindingChange[];
63608
63717
  /** Present when the request carried `capabilities`. */
63609
63718
  capabilityChanges?: AgentCapabilityChange[];
63719
+ /** Non-blocking advisories, e.g. SCHEDULE_AGENT_CONFIG_UNSUPPORTED when `live` moves onto a version schedules cannot run. */
63720
+ _warnings?: string[];
63610
63721
  }
63611
63722
  type EnsureAgentResult = EnsureAgentConverged | EnsureAgentPlan;
63612
63723
  interface AgentPullResult {
@@ -64299,6 +64410,8 @@ interface FpoEntityOutcome {
64299
64410
  result: 'created' | 'updated' | 'unchanged' | 'failed' | 'skipped' | 'pruned';
64300
64411
  id?: string;
64301
64412
  error?: string;
64413
+ /** Non-blocking advisories for this entity, e.g. SCHEDULE_AGENT_CONFIG_UNSUPPORTED. */
64414
+ warnings?: string[];
64302
64415
  }
64303
64416
  interface EnsureFpoResult {
64304
64417
  result: 'unchanged' | 'converged' | 'plan';
@@ -65552,7 +65665,7 @@ interface PromoteAgentResult {
65552
65665
  */
65553
65666
  export declare function promoteAgent(input: PromoteAgentInput): Promise<PromoteAgentResult>;
65554
65667
  //#endregion
65555
- //#region ../shared/dist/index-iH4WYCK8.d.ts
65668
+ //#region ../shared/dist/models-wYIgT_ZG.d.ts
65556
65669
  //#region src/generated-evaluation-models.d.ts
65557
65670
  /**
65558
65671
  * Per-token USD exactly as the gateway listed it, plus the per-million figures
@@ -68466,9 +68579,11 @@ export interface AgentAdmissionOptions {
68466
68579
  * What to do when the conversation already has a turn in flight. `reject`
68467
68580
  * (the default when omitted) answers `CONVERSATION_BUSY`; `supersede`
68468
68581
  * cancels the incumbent and takes over; `queue` runs after it; `steer` delivers
68469
- * new user-message deltas to the incumbent at a safe boundary, without resetting its budgets.
68582
+ * new user-message deltas to the incumbent at a safe boundary, without resetting its budgets;
68583
+ * `auto` sends steer-shaped deltas and lets a classifier choose steer or queue, reporting the
68584
+ * route in the `X-Runtype-Busy-Message-Route` / `-Source` response headers.
68470
68585
  */
68471
- concurrency?: 'reject' | 'supersede' | 'queue' | 'steer';
68586
+ concurrency?: 'reject' | 'supersede' | 'queue' | 'steer' | 'auto';
68472
68587
  /**
68473
68588
  * Fold this request into an already-pending turn for the same conversation
68474
68589
  * instead of starting a second one. The response is the pending execution.
package/dist/index.d.ts CHANGED
@@ -1014,6 +1014,11 @@ interface paths {
1014
1014
  enabled: true;
1015
1015
  types: ("markdown" | "component")[];
1016
1016
  };
1017
+ busyMessageRouting?: {
1018
+ classifierModel?: string;
1019
+ /** @enum {string} */
1020
+ mode?: "enforced" | "off";
1021
+ };
1017
1022
  contextManagement?: {
1018
1023
  compaction?: {
1019
1024
  enabled?: boolean;
@@ -1264,6 +1269,10 @@ interface paths {
1264
1269
  topK?: number;
1265
1270
  topP?: number;
1266
1271
  voice?: {
1272
+ directTools?: {
1273
+ enabled?: boolean;
1274
+ model?: string;
1275
+ };
1267
1276
  disclosure?: boolean;
1268
1277
  elevenLabs?: {
1269
1278
  modelId?: string;
@@ -1551,6 +1560,11 @@ interface paths {
1551
1560
  enabled: true;
1552
1561
  types: ("markdown" | "component")[];
1553
1562
  };
1563
+ busyMessageRouting?: {
1564
+ classifierModel?: string;
1565
+ /** @enum {string} */
1566
+ mode?: "enforced" | "off";
1567
+ };
1554
1568
  contextManagement?: {
1555
1569
  compaction?: {
1556
1570
  enabled?: boolean;
@@ -1801,6 +1815,10 @@ interface paths {
1801
1815
  topK?: number;
1802
1816
  topP?: number;
1803
1817
  voice?: {
1818
+ directTools?: {
1819
+ enabled?: boolean;
1820
+ model?: string;
1821
+ };
1804
1822
  disclosure?: boolean;
1805
1823
  elevenLabs?: {
1806
1824
  modelId?: string;
@@ -2377,6 +2395,11 @@ interface paths {
2377
2395
  enabled: true;
2378
2396
  types: ("markdown" | "component")[];
2379
2397
  };
2398
+ busyMessageRouting?: {
2399
+ classifierModel?: string;
2400
+ /** @enum {string} */
2401
+ mode?: "enforced" | "off";
2402
+ };
2380
2403
  contextManagement?: {
2381
2404
  compaction?: {
2382
2405
  enabled?: boolean;
@@ -2627,6 +2650,10 @@ interface paths {
2627
2650
  topK?: number;
2628
2651
  topP?: number;
2629
2652
  voice?: {
2653
+ directTools?: {
2654
+ enabled?: boolean;
2655
+ model?: string;
2656
+ };
2630
2657
  disclosure?: boolean;
2631
2658
  elevenLabs?: {
2632
2659
  modelId?: string;
@@ -4813,8 +4840,8 @@ interface paths {
4813
4840
  parameters: {
4814
4841
  query?: never;
4815
4842
  header?: {
4816
- /** @description How a durable turn handles overlap. `reject` (default) answers CONVERSATION_BUSY naming the occupant execution, its phase, and a Retry-After; `supersede` cancels and replaces; `queue` runs afterward; `steer` durably appends new user-message deltas to the same execution at a safe boundary, attaches through the host's slot claim when the host has not started yet, or starts the next execution if completion wins. Steer requires a conversationId, preserves configuration and authority, cannot combine with coalesce, and rejects unsupported lanes. Other policies remain ignored on in-process execution. */
4817
- "x-runtype-concurrency"?: "reject" | "supersede" | "queue" | "steer";
4843
+ /** @description How a durable turn handles overlap. `reject` (default) answers CONVERSATION_BUSY naming the occupant execution, its phase, and a Retry-After; `supersede` cancels and replaces; `queue` runs afterward; `steer` durably appends new user-message deltas to the same execution at a safe boundary, attaches through the host's slot claim when the host has not started yet, or starts the next execution if completion wins. Steer requires a conversationId, preserves configuration and authority, cannot combine with coalesce, and rejects unsupported lanes. `auto` sends the same user-message deltas as steer and lets a classifier choose: while a turn runs, a message that belongs to it steers and an independent one queues as the next turn; with nothing running it is an ordinary turn with no route report. A routed or downgraded answer reports the route in `X-Runtype-Busy-Message-Route` / `-Source` (plus `-Probability` and `-Model` when the classifier answered) and, on JSON bodies, `busyMessageRoute`. Where auto cannot route (in-process execution, stored history, no conversationId, coalesce, Prefer: respond-async) it keeps the default admission and reports source `disabled`. Other policies remain ignored on in-process execution. */
4844
+ "x-runtype-concurrency"?: "reject" | "supersede" | "queue" | "steer" | "auto";
4818
4845
  /** @description Send `true` to fold this request into an already-pending turn for the same conversation instead of starting a second one. The response is the pending execution. Any other value (or omitting the header) starts a new turn. */
4819
4846
  "x-runtype-coalesce"?: "true";
4820
4847
  /** @description Caller-chosen key that makes admission idempotent: a retry with the same key returns the ORIGINAL execution rather than starting a second turn, and consumes no additional quota. Scoped to the durable lane. */
@@ -9670,7 +9697,7 @@ interface paths {
9670
9697
  put?: never;
9671
9698
  /**
9672
9699
  * Send a client chat message
9673
- * @description Send a message for a browser client-token chat session. The request streams flow/agent events over Server-Sent Events. `turnId` and `submitMode` are optional and let newer Persona clients suppress stale interrupted responses; older clients can omit both fields. Opt-in `steer` accepts exactly one new user message whose `id` equals `turnId` for visitor-owned native durable agents. A new execution streams SSE; steering an existing execution returns a 202 delivery receipt without replacing its response. Retry with the same turn and message IDs. Send `voice: { spoken: true }` when the user turn came from a live voice call and the reply will be spoken by a voice model; the turn then runs with a per-turn instruction to lead with a short, speakable answer, which is not stored in the conversation.
9700
+ * @description Send a message for a browser client-token chat session. The request streams flow/agent events over Server-Sent Events. `turnId` and `submitMode` are optional and let newer Persona clients suppress stale interrupted responses; older clients can omit both fields. Opt-in `steer` accepts exactly one new user message whose `id` equals `turnId` for visitor-owned native durable agents. A new execution streams SSE; steering an existing execution returns a 202 delivery receipt without replacing its response. `auto` takes the same shape as `steer` and lets a classifier choose while a turn runs: a message that belongs to the running work steers it (202 delivery receipt), and an independent one queues as the next turn (202 queued handle); with nothing running it is an ordinary turn with no route report. A routed or downgraded answer carries `X-Runtype-Busy-Message-Route` and `X-Runtype-Busy-Message-Source` (plus `-Probability` and `-Model` when the classifier answered), repeated as `busyMessageRoute` on JSON bodies. Where `auto` cannot route (another lane, another message shape) it behaves as `normal` and reports source `disabled`. Retry with the same turn and message IDs. Send `voice: { spoken: true }` when the user turn came from a live voice call and the reply will be spoken by a voice model; the turn then runs with a per-turn instruction to lead with a short, speakable answer, which is not stored in the conversation.
9674
9701
  */
9675
9702
  post: {
9676
9703
  parameters: {
@@ -9750,7 +9777,7 @@ interface paths {
9750
9777
  };
9751
9778
  sessionId: string;
9752
9779
  /** @enum {string} */
9753
- submitMode?: "normal" | "interrupt" | "steer";
9780
+ submitMode?: "normal" | "interrupt" | "steer" | "auto";
9754
9781
  turnId?: string;
9755
9782
  /** @description Voice context for this turn. Omit for typed chat; behavior is unchanged when absent. */
9756
9783
  voice?: {
@@ -9770,7 +9797,7 @@ interface paths {
9770
9797
  "text/event-stream": unknown;
9771
9798
  };
9772
9799
  };
9773
- /** @description Input accepted by an existing durable execution; no new response stream */
9800
+ /** @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 */
9774
9801
  202: {
9775
9802
  headers: {
9776
9803
  [name: string]: unknown;
@@ -9779,6 +9806,7 @@ interface paths {
9779
9806
  "application/json": {
9780
9807
  /** @enum {boolean} */
9781
9808
  accepted: true;
9809
+ busyMessageRoute?: components["schemas"]["BusyMessageRouteReport"];
9782
9810
  conversationId: string;
9783
9811
  deliveryId: string;
9784
9812
  /** @enum {string} */
@@ -9786,7 +9814,15 @@ interface paths {
9786
9814
  deliveryStatusUrl: string;
9787
9815
  eventsUrl: string;
9788
9816
  executionId: string;
9789
- };
9817
+ } | ({
9818
+ busyMessageRoute: components["schemas"]["BusyMessageRouteReport"];
9819
+ /** @description The queued execution, distinct from the running one. */
9820
+ executionId: string;
9821
+ /** @description `queued` until the running execution finishes. */
9822
+ status: string;
9823
+ } & {
9824
+ [key: string]: unknown;
9825
+ });
9790
9826
  };
9791
9827
  };
9792
9828
  /** @description Validation error */
@@ -14344,7 +14380,7 @@ interface paths {
14344
14380
  put?: never;
14345
14381
  /**
14346
14382
  * Execute a flow or agent
14347
- * @description Main dispatch endpoint for flow and agent execution with record resolution. Supports streaming via SSE or synchronous JSON responses. Send the RFC 7240 `Prefer: respond-async` header to receive a durable execution handle immediately, then poll its status URL for completion. A saved agent may run on the durable session lane; the admission headers `x-runtype-concurrency` (reject, supersede, queue, steer), `x-runtype-coalesce` (true) and `idempotency-key` then apply exactly as on `POST /v1/agents/{id}/execute`, and are ignored for in-process execution except steer, which fails explicitly on unsupported lanes. Any other x-runtype-concurrency value is refused with 400 INVALID_CONCURRENCY_MODE. Steer accepts only new user-message deltas, preserves the active execution configuration and authority, and returns a deliveryId with a deliveryStatusUrl. Prefer: respond-async with steer returns a native delivery receipt without queuing an HTTP replay.
14383
+ * @description Main dispatch endpoint for flow and agent execution with record resolution. Supports streaming via SSE or synchronous JSON responses. Send the RFC 7240 `Prefer: respond-async` header to receive a durable execution handle immediately, then poll its status URL for completion. A saved agent may run on the durable session lane; the admission headers `x-runtype-concurrency` (reject, supersede, queue, steer), `x-runtype-coalesce` (true) and `idempotency-key` then apply exactly as on `POST /v1/agents/{id}/execute`, and are ignored for in-process execution except steer, which fails explicitly on unsupported lanes. `x-runtype-concurrency: auto` sends the same user-message deltas as steer and lets a classifier choose: while a turn runs, a message that belongs to it steers and an independent one queues as the next turn; with nothing running it is an ordinary turn with no route report. A routed or downgraded answer carries `X-Runtype-Busy-Message-Route` (steer or queue) and `X-Runtype-Busy-Message-Source` (classifier, shadow, abstained, timeout, error, unanswered, circuit_open, or disabled), plus `X-Runtype-Busy-Message-Probability` and `X-Runtype-Busy-Message-Model` when the classifier answered; JSON bodies repeat them as `busyMessageRoute`. Where auto cannot route (in-process execution, stored history, a flow, no conversationId, coalesce, Prefer: respond-async) it keeps the default admission and reports source `disabled`. Any other x-runtype-concurrency value is refused with 400 INVALID_CONCURRENCY_MODE. Steer accepts only new user-message deltas, preserves the active execution configuration and authority, and returns a deliveryId with a deliveryStatusUrl. Prefer: respond-async with steer returns a native delivery receipt without queuing an HTTP replay.
14348
14384
  */
14349
14385
  post: {
14350
14386
  parameters: {
@@ -14370,6 +14406,11 @@ interface paths {
14370
14406
  enabled: true;
14371
14407
  types: ("markdown" | "component")[];
14372
14408
  };
14409
+ busyMessageRouting?: {
14410
+ classifierModel?: string;
14411
+ /** @enum {string} */
14412
+ mode?: "enforced" | "off";
14413
+ };
14373
14414
  claudeManagedConfig?: {
14374
14415
  anthropicAgentId?: string;
14375
14416
  anthropicAgentVersion?: number;
@@ -14556,6 +14597,10 @@ interface paths {
14556
14597
  topP?: number;
14557
14598
  versionId?: string;
14558
14599
  voice?: {
14600
+ directTools?: {
14601
+ enabled?: boolean;
14602
+ model?: string;
14603
+ };
14559
14604
  disclosure?: boolean;
14560
14605
  elevenLabs?: {
14561
14606
  modelId?: string;
@@ -14832,6 +14877,11 @@ interface paths {
14832
14877
  enabled: true;
14833
14878
  types: ("markdown" | "component")[];
14834
14879
  };
14880
+ busyMessageRouting?: {
14881
+ classifierModel?: string;
14882
+ /** @enum {string} */
14883
+ mode?: "enforced" | "off";
14884
+ };
14835
14885
  claudeManagedConfig?: {
14836
14886
  anthropicAgentId?: string;
14837
14887
  anthropicAgentVersion?: number;
@@ -15018,6 +15068,10 @@ interface paths {
15018
15068
  topP?: number;
15019
15069
  versionId?: string;
15020
15070
  voice?: {
15071
+ directTools?: {
15072
+ enabled?: boolean;
15073
+ model?: string;
15074
+ };
15021
15075
  disclosure?: boolean;
15022
15076
  elevenLabs?: {
15023
15077
  modelId?: string;
@@ -52874,6 +52928,8 @@ interface components {
52874
52928
  error: string;
52875
52929
  };
52876
52930
  AgentEnsureResponse: {
52931
+ /** @description Non-blocking advisories, e.g. SCHEDULE_AGENT_CONFIG_UNSUPPORTED when this converge (or, on a dry run, the planned one) changes what active schedules run into a version they cannot run. */
52932
+ _warnings?: string[];
52877
52933
  agentId: string;
52878
52934
  /** @description Present when the request carried capabilities: one row per declared capability, then removals. */
52879
52935
  capabilityChanges?: components["schemas"]["AgentEnsureCapabilityChange"][];
@@ -52892,6 +52948,8 @@ interface components {
52892
52948
  /** @enum {string} */
52893
52949
  result: "definitionRequired";
52894
52950
  } | {
52951
+ /** @description Non-blocking advisories, e.g. SCHEDULE_AGENT_CONFIG_UNSUPPORTED when this converge (or, on a dry run, the planned one) changes what active schedules run into a version they cannot run. */
52952
+ _warnings?: string[];
52895
52953
  agentId?: string;
52896
52954
  /** @description Present when the request carried capabilities: one row per declared capability, then removals. */
52897
52955
  capabilityChanges?: components["schemas"]["AgentEnsureCapabilityChange"][];
@@ -52961,6 +53019,11 @@ interface components {
52961
53019
  enabled: true;
52962
53020
  types: ("markdown" | "component")[];
52963
53021
  };
53022
+ busyMessageRouting?: {
53023
+ classifierModel?: string;
53024
+ /** @enum {string} */
53025
+ mode?: "enforced" | "off";
53026
+ };
52964
53027
  contextManagement?: {
52965
53028
  compaction?: {
52966
53029
  enabled?: boolean;
@@ -53211,6 +53274,10 @@ interface components {
53211
53274
  topK?: number;
53212
53275
  topP?: number;
53213
53276
  voice?: {
53277
+ directTools?: {
53278
+ enabled?: boolean;
53279
+ model?: string;
53280
+ };
53214
53281
  disclosure?: boolean;
53215
53282
  elevenLabs?: {
53216
53283
  modelId?: string;
@@ -53360,6 +53427,27 @@ interface components {
53360
53427
  toolId: string;
53361
53428
  toolName: string;
53362
53429
  };
53430
+ BusyMessageRouteReport: {
53431
+ /** @description The decision model that answered. */
53432
+ model?: string;
53433
+ /** @description Probability the message belongs to the running work (classifier only). */
53434
+ probability?: number;
53435
+ /**
53436
+ * @description Where the message went: into the running execution, or after it.
53437
+ * @enum {string}
53438
+ */
53439
+ route: "steer" | "queue";
53440
+ /**
53441
+ * @description Why this route applied.
53442
+ * @enum {string}
53443
+ */
53444
+ source: "classifier" | "abstained" | "timeout" | "error" | "unanswered" | "circuit_open" | "disabled";
53445
+ /**
53446
+ * @description The classifier chose steer but the running execution could no longer take input.
53447
+ * @enum {boolean}
53448
+ */
53449
+ steerUnavailable?: true;
53450
+ };
53363
53451
  CaptureExecutionPreview: {
53364
53452
  /** @description The recorded tool-call actions in invocation order — the fork-picker rows. */
53365
53453
  actions: components["schemas"]["CaptureExecutionPreviewAction"][];
@@ -53755,6 +53843,11 @@ interface components {
53755
53843
  enabled: true;
53756
53844
  types: ("markdown" | "component")[];
53757
53845
  };
53846
+ busyMessageRouting?: {
53847
+ classifierModel?: string;
53848
+ /** @enum {string} */
53849
+ mode?: "enforced" | "off";
53850
+ };
53758
53851
  contextManagement?: {
53759
53852
  compaction?: {
53760
53853
  enabled?: boolean;
@@ -54005,6 +54098,10 @@ interface components {
54005
54098
  topK?: number;
54006
54099
  topP?: number;
54007
54100
  voice?: {
54101
+ directTools?: {
54102
+ enabled?: boolean;
54103
+ model?: string;
54104
+ };
54008
54105
  disclosure?: boolean;
54009
54106
  elevenLabs?: {
54010
54107
  modelId?: string;
@@ -55913,6 +56010,8 @@ interface components {
55913
56010
  ref: string;
55914
56011
  /** @enum {string} */
55915
56012
  result: "created" | "updated" | "unchanged" | "failed" | "skipped" | "pruned";
56013
+ /** @description Non-blocking advisories, e.g. SCHEDULE_AGENT_CONFIG_UNSUPPORTED when converging an agent moved `live` onto a version its active schedules cannot run. */
56014
+ warnings?: string[];
55916
56015
  }[];
55917
56016
  /** @description True when one or more entities failed to converge (re-run to self-heal). */
55918
56017
  hasFailures: boolean;
@@ -63432,6 +63531,14 @@ interface AgentDefinitionConfig {
63432
63531
  maxBudgetMs?: number | null;
63433
63532
  forced?: 'durable' | 'in_process';
63434
63533
  };
63534
+ /**
63535
+ * Steer-or-queue routing for a `submitMode: 'auto'` message sent while a turn runs. `mode` is
63536
+ * `enforced` (default) or `off` (always queue); `classifierModel` is a `GET /v1/decision-models` id.
63537
+ */
63538
+ busyMessageRouting?: {
63539
+ mode?: 'enforced' | 'off';
63540
+ classifierModel?: string;
63541
+ };
63435
63542
  /** Opt-in agent state channel — a shared JSON document the client and agent both see. */
63436
63543
  state?: {
63437
63544
  initial?: Record<string, unknown>;
@@ -63593,6 +63700,8 @@ interface EnsureAgentConverged {
63593
63700
  skillBindings?: AgentSkillBindingChange[];
63594
63701
  /** Present when the request carried `capabilities`. */
63595
63702
  capabilityChanges?: AgentCapabilityChange[];
63703
+ /** Non-blocking advisories, e.g. SCHEDULE_AGENT_CONFIG_UNSUPPORTED when `live` moves onto a version schedules cannot run. */
63704
+ _warnings?: string[];
63596
63705
  }
63597
63706
  interface EnsureAgentPlan {
63598
63707
  result: 'plan';
@@ -63607,6 +63716,8 @@ interface EnsureAgentPlan {
63607
63716
  skillBindings?: AgentSkillBindingChange[];
63608
63717
  /** Present when the request carried `capabilities`. */
63609
63718
  capabilityChanges?: AgentCapabilityChange[];
63719
+ /** Non-blocking advisories, e.g. SCHEDULE_AGENT_CONFIG_UNSUPPORTED when `live` moves onto a version schedules cannot run. */
63720
+ _warnings?: string[];
63610
63721
  }
63611
63722
  type EnsureAgentResult = EnsureAgentConverged | EnsureAgentPlan;
63612
63723
  interface AgentPullResult {
@@ -64299,6 +64410,8 @@ interface FpoEntityOutcome {
64299
64410
  result: 'created' | 'updated' | 'unchanged' | 'failed' | 'skipped' | 'pruned';
64300
64411
  id?: string;
64301
64412
  error?: string;
64413
+ /** Non-blocking advisories for this entity, e.g. SCHEDULE_AGENT_CONFIG_UNSUPPORTED. */
64414
+ warnings?: string[];
64302
64415
  }
64303
64416
  interface EnsureFpoResult {
64304
64417
  result: 'unchanged' | 'converged' | 'plan';
@@ -65552,7 +65665,7 @@ interface PromoteAgentResult {
65552
65665
  */
65553
65666
  export declare function promoteAgent(input: PromoteAgentInput): Promise<PromoteAgentResult>;
65554
65667
  //#endregion
65555
- //#region ../shared/dist/index-iH4WYCK8.d.ts
65668
+ //#region ../shared/dist/models-wYIgT_ZG.d.ts
65556
65669
  //#region src/generated-evaluation-models.d.ts
65557
65670
  /**
65558
65671
  * Per-token USD exactly as the gateway listed it, plus the per-million figures
@@ -68466,9 +68579,11 @@ export interface AgentAdmissionOptions {
68466
68579
  * What to do when the conversation already has a turn in flight. `reject`
68467
68580
  * (the default when omitted) answers `CONVERSATION_BUSY`; `supersede`
68468
68581
  * cancels the incumbent and takes over; `queue` runs after it; `steer` delivers
68469
- * new user-message deltas to the incumbent at a safe boundary, without resetting its budgets.
68582
+ * new user-message deltas to the incumbent at a safe boundary, without resetting its budgets;
68583
+ * `auto` sends steer-shaped deltas and lets a classifier choose steer or queue, reporting the
68584
+ * route in the `X-Runtype-Busy-Message-Route` / `-Source` response headers.
68470
68585
  */
68471
- concurrency?: 'reject' | 'supersede' | 'queue' | 'steer';
68586
+ concurrency?: 'reject' | 'supersede' | 'queue' | 'steer' | 'auto';
68472
68587
  /**
68473
68588
  * Fold this request into an already-pending turn for the same conversation
68474
68589
  * instead of starting a second one. The response is the pending execution.
package/dist/index.mjs CHANGED
@@ -11910,6 +11910,7 @@ const AGENT_CONFIG_KEYS = [
11910
11910
  "sandbox",
11911
11911
  "tenancyStrategy",
11912
11912
  "durability",
11913
+ "busyMessageRouting",
11913
11914
  "state"
11914
11915
  ];
11915
11916
  const AGENT_CONFIG_KEY_LIST = [...AGENT_CONFIG_KEYS].sort();
@@ -14489,7 +14490,7 @@ function transformQueryParams(params) {
14489
14490
  }
14490
14491
  //#endregion
14491
14492
  //#region src/version.ts
14492
- const SDK_VERSION = "10.16.0";
14493
+ const SDK_VERSION = "10.17.0";
14493
14494
  /**
14494
14495
  * Canonical client identity the API uses for attribution
14495
14496
  * (`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": "10.16.0",
3
+ "version": "10.17.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.82.0",
27
+ "@runtypelabs/shared": "3.83.0",
28
28
  "openapi-typescript": "^7.13.0",
29
29
  "tsdown": "^0.23.0",
30
30
  "typescript": "^6.0.3",