@runtypelabs/sdk 10.2.1 → 10.2.3

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
@@ -14149,7 +14149,7 @@ function transformQueryParams(params) {
14149
14149
 
14150
14150
  // src/version.ts
14151
14151
  var FALLBACK_VERSION = "0.0.0";
14152
- var SDK_VERSION = "10.2.1".length > 0 ? "10.2.1" : FALLBACK_VERSION;
14152
+ var SDK_VERSION = "10.2.3".length > 0 ? "10.2.3" : FALLBACK_VERSION;
14153
14153
  var RUNTYPE_CLIENT_KIND = "sdk";
14154
14154
  var SDK_USER_AGENT = `runtype-sdk/${SDK_VERSION} (typescript)`;
14155
14155
 
package/dist/index.d.cts CHANGED
@@ -918,6 +918,8 @@ interface paths {
918
918
  thinkingLevel?: string;
919
919
  };
920
920
  sandbox?: {
921
+ /** @description Coding agents the Sandbox can run as typed sessions. Non-empty adds the agent_session_* tools; empty or absent adds none. */
922
+ codingAgents?: "opencode"[];
921
923
  enabled: boolean;
922
924
  /**
923
925
  * @description Only standard-4 is supported on the hosted Agent Sandbox path; other sizes cannot be enabled.
@@ -1432,6 +1434,8 @@ interface paths {
1432
1434
  thinkingLevel?: string;
1433
1435
  };
1434
1436
  sandbox?: {
1437
+ /** @description Coding agents the Sandbox can run as typed sessions. Non-empty adds the agent_session_* tools; empty or absent adds none. */
1438
+ codingAgents?: "opencode"[];
1435
1439
  enabled: boolean;
1436
1440
  /**
1437
1441
  * @description Only standard-4 is supported on the hosted Agent Sandbox path; other sizes cannot be enabled.
@@ -2220,6 +2224,8 @@ interface paths {
2220
2224
  thinkingLevel?: string;
2221
2225
  };
2222
2226
  sandbox?: {
2227
+ /** @description Coding agents the Sandbox can run as typed sessions. Non-empty adds the agent_session_* tools; empty or absent adds none. */
2228
+ codingAgents?: "opencode"[];
2223
2229
  enabled: boolean;
2224
2230
  /**
2225
2231
  * @description Only standard-4 is supported on the hosted Agent Sandbox path; other sizes cannot be enabled.
@@ -4780,7 +4786,7 @@ interface paths {
4780
4786
  };
4781
4787
  /**
4782
4788
  * Stream execution events
4783
- * @description Reconnect to a durable agent turn: replay-and-tail its Server-Sent Events. A turn that streams over an expired watch lease ends with `await` / `awaitReason: "detached"` while the execution keeps running; pass the last seen SSE `id:` as `after` to rejoin it. The session owner is resolved from the execution's own persisted record — its conversation for a top-level turn, its private child thread for a subagent run — and the optional `conversationId` is used only for a turn that persists no record of its own. Replays buffered events strictly past the `after` cursor, then live-tails if the turn is still running. Each event carries an SSE `id:` line — a durable row seq, or (unified vocabulary) a composite `<seq>.<subIndex>` when one durable row translates to multiple events. Pass that id verbatim after any disconnect (tab reload, sleep, stream timeout) to resume without missing or duplicating events. Replayed and live-tailed frames use the unified execution vocabulary.
4789
+ * @description Reconnect to a durable agent turn: replay-and-tail its Server-Sent Events. A turn that streams over an expired watch lease ends with `await` / `awaitReason: "detached"` while the execution keeps running; pass the last seen SSE `id:` as `after` to rejoin it. The session owner is resolved from the execution's own persisted record — its conversation for a top-level turn, its private child thread for a subagent run — and the optional `conversationId` is used only for a turn that persists no record of its own. Replays buffered events strictly past the `after` cursor, then live-tails if the turn is still running. Each event carries an SSE `id:` line — a durable row seq, or (unified vocabulary) a composite `<seq>.<subIndex>` when one durable row translates to multiple events. Pass that id verbatim after any disconnect (tab reload, sleep, stream timeout) to resume without missing or duplicating events. Replayed and live-tailed frames use the unified execution vocabulary. A Runtype session turn's response carries `X-Runtype-Execution-Driver`, the driver holding the turn when the stream attached: `request-worker` or `workflow-leg` while that driver holds it, otherwise `owner`.
4784
4790
  */
4785
4791
  get: {
4786
4792
  parameters: {
@@ -12971,6 +12977,8 @@ interface paths {
12971
12977
  thinkingLevel?: string;
12972
12978
  };
12973
12979
  sandbox?: {
12980
+ /** @description Coding agents the Sandbox can run as typed sessions. Non-empty adds the agent_session_* tools; empty or absent adds none. */
12981
+ codingAgents?: "opencode"[];
12974
12982
  enabled: boolean;
12975
12983
  /**
12976
12984
  * @description Only standard-4 is supported on the hosted Agent Sandbox path; other sizes cannot be enabled.
@@ -13419,6 +13427,8 @@ interface paths {
13419
13427
  thinkingLevel?: string;
13420
13428
  };
13421
13429
  sandbox?: {
13430
+ /** @description Coding agents the Sandbox can run as typed sessions. Non-empty adds the agent_session_* tools; empty or absent adds none. */
13431
+ codingAgents?: "opencode"[];
13422
13432
  enabled: boolean;
13423
13433
  /**
13424
13434
  * @description Only standard-4 is supported on the hosted Agent Sandbox path; other sizes cannot be enabled.
@@ -18137,7 +18147,7 @@ interface paths {
18137
18147
  };
18138
18148
  /**
18139
18149
  * Stream execution events
18140
- * @description Execution-scoped alias of `GET /v1/agents/{id}/executions/{executionId}/events`: reconnect to a durable turn and replay-and-tail its Server-Sent Events without already knowing which agent ran it. The agent is resolved from the execution's own persisted record, so a run started through `/v1/dispatch` reconnects by execution id alone; a record with no agent (an inline definition, which addresses no durable session) answers 404. A turn that streams over an expired watch lease ends with `await` / `awaitReason: "detached"` while the execution keeps running; pass the last seen SSE `id:` as `after` to rejoin it. Replays buffered events strictly past the `after` cursor, then live-tails if the turn is still running. Each event carries an SSE `id:` line — a durable row seq, or (unified vocabulary) a composite `<seq>.<subIndex>` when one durable row translates to multiple events. Pass that id verbatim after any disconnect (tab reload, sleep, stream timeout) to resume without missing or duplicating events. Replayed and live-tailed frames use the unified execution vocabulary. An API key needs `AGENTS:READ`, `AGENTS:*`, `DISPATCH:*`, or `*`; `DISPATCH:*` is admitted because this alias exists for dispatch-started runs.
18150
+ * @description Execution-scoped alias of `GET /v1/agents/{id}/executions/{executionId}/events`: reconnect to a durable turn and replay-and-tail its Server-Sent Events without already knowing which agent ran it. The agent is resolved from the execution's own persisted record, so a run started through `/v1/dispatch` reconnects by execution id alone; a record with no agent (an inline definition, which addresses no durable session) answers 404. A turn that streams over an expired watch lease ends with `await` / `awaitReason: "detached"` while the execution keeps running; pass the last seen SSE `id:` as `after` to rejoin it. Replays buffered events strictly past the `after` cursor, then live-tails if the turn is still running. Each event carries an SSE `id:` line — a durable row seq, or (unified vocabulary) a composite `<seq>.<subIndex>` when one durable row translates to multiple events. Pass that id verbatim after any disconnect (tab reload, sleep, stream timeout) to resume without missing or duplicating events. Replayed and live-tailed frames use the unified execution vocabulary. A Runtype session turn's response carries `X-Runtype-Execution-Driver`, the driver holding the turn when the stream attached: `request-worker` or `workflow-leg` while that driver holds it, otherwise `owner`. An API key needs `AGENTS:READ`, `AGENTS:*`, `DISPATCH:*`, or `*`; `DISPATCH:*` is admitted because this alias exists for dispatch-started runs.
18141
18151
  */
18142
18152
  get: {
18143
18153
  parameters: {
@@ -25207,9 +25217,7 @@ interface paths {
25207
25217
  content: {
25208
25218
  "application/json": {
25209
25219
  data: {
25210
- /** @description True when the historical segment was served by the flat fallback plan because the deduplicating one was rejected, so a re-sent delivery can appear more than once. Absent on healthy responses. */
25211
- dedupeFallback?: boolean;
25212
- /** @description True when part of the window could not be read, so entries may be missing. Evicted ordinary rows are recovered from R2 when old enough; receipt-backed recovery remains degraded when source time cannot prove ingestion. Absent on healthy responses. */
25220
+ /** @description True when the live overlay or the audit plane could not be read, so entries from that source are missing. Absent on healthy responses. */
25213
25221
  degraded?: boolean;
25214
25222
  entries: {
25215
25223
  [key: string]: unknown;
@@ -25280,59 +25288,8 @@ interface paths {
25280
25288
  "application/json": components["schemas"]["Error"];
25281
25289
  };
25282
25290
  };
25283
- };
25284
- };
25285
- put?: never;
25286
- post?: never;
25287
- delete?: never;
25288
- options?: never;
25289
- head?: never;
25290
- patch?: never;
25291
- trace?: never;
25292
- };
25293
- "/v1/logs/debug": {
25294
- parameters: {
25295
- query?: never;
25296
- header?: never;
25297
- path?: never;
25298
- cookie?: never;
25299
- };
25300
- /**
25301
- * Debug R2 SQL diagnostics
25302
- * @description R2 SQL diagnostic endpoint for troubleshooting log queries. Non-production only.
25303
- */
25304
- get: {
25305
- parameters: {
25306
- query?: never;
25307
- header?: never;
25308
- path?: never;
25309
- cookie?: never;
25310
- };
25311
- requestBody?: never;
25312
- responses: {
25313
- /** @description Diagnostics returned */
25314
- 200: {
25315
- headers: {
25316
- [name: string]: unknown;
25317
- };
25318
- content: {
25319
- "application/json": {
25320
- data?: unknown;
25321
- success: boolean;
25322
- };
25323
- };
25324
- };
25325
- /** @description Unauthorized */
25326
- 401: {
25327
- headers: {
25328
- [name: string]: unknown;
25329
- };
25330
- content: {
25331
- "application/json": components["schemas"]["Error"];
25332
- };
25333
- };
25334
- /** @description Not found */
25335
- 404: {
25291
+ /** @description Log store temporarily unavailable; no entries or counts could be read */
25292
+ 503: {
25336
25293
  headers: {
25337
25294
  [name: string]: unknown;
25338
25295
  };
@@ -25503,15 +25460,20 @@ interface paths {
25503
25460
  byType: {
25504
25461
  [key: string]: number;
25505
25462
  };
25506
- /** @description True when counts came from the flat fallback plan because the deduplicating one was rejected, so a re-sent delivery can be counted more than once. Such a response is never cached. Absent on healthy responses. */
25507
- dedupeFallback?: boolean;
25508
- /** @description True when part of the window could not be read, so counts may be partial. Evicted ordinary rows are counted from R2 when old enough; receipt-backed recovery remains degraded when source time cannot prove ingestion. Absent on healthy responses, which are the only ones cached. */
25463
+ /** @description The span plane’s earliest certified hour for this organization (ISO 8601). Counts before it are not in the store. Null when no hour is certified yet. */
25464
+ coveredFrom?: string | null;
25465
+ /** @description True when the live overlay or the audit plane could not be read, so counts are partial. Absent on healthy responses, which are the only ones cached. */
25509
25466
  degraded?: boolean;
25510
25467
  histogram: {
25511
25468
  bucket: string;
25512
25469
  count: number;
25513
25470
  errors: number;
25514
25471
  }[];
25472
+ /**
25473
+ * @description Which tier answered these counts. Always store today; the field exists so a granularity discontinuity is a labeled one rather than an unexplained drop in total.
25474
+ * @enum {string}
25475
+ */
25476
+ statsSource?: "store" | "legacy" | "mixed";
25515
25477
  total: number;
25516
25478
  };
25517
25479
  success: boolean;
@@ -25565,6 +25527,15 @@ interface paths {
25565
25527
  "application/json": components["schemas"]["Error"];
25566
25528
  };
25567
25529
  };
25530
+ /** @description Log store temporarily unavailable; no entries or counts could be read */
25531
+ 503: {
25532
+ headers: {
25533
+ [name: string]: unknown;
25534
+ };
25535
+ content: {
25536
+ "application/json": components["schemas"]["Error"];
25537
+ };
25538
+ };
25568
25539
  };
25569
25540
  };
25570
25541
  put?: never;
@@ -48769,6 +48740,8 @@ interface components {
48769
48740
  thinkingLevel?: string;
48770
48741
  };
48771
48742
  sandbox?: {
48743
+ /** @description Coding agents the Sandbox can run as typed sessions. Non-empty adds the agent_session_* tools; empty or absent adds none. */
48744
+ codingAgents?: "opencode"[];
48772
48745
  enabled: boolean;
48773
48746
  /**
48774
48747
  * @description Only standard-4 is supported on the hosted Agent Sandbox path; other sizes cannot be enabled.
@@ -54256,7 +54229,7 @@ interface LogQueryResult {
54256
54229
  cursor: string | null;
54257
54230
  hasMore: boolean;
54258
54231
  };
54259
- /** True when historical (R2 SQL) logs were unavailable and only recent hot-tier entries are included. */
54232
+ /** True when the live overlay or the audit plane could not be read, so some entries are missing. */
54260
54233
  degraded?: boolean;
54261
54234
  }
54262
54235
  /** The `from`/`to` the API resolved for a logs query, after defaults and aliases. */
@@ -54283,8 +54256,12 @@ interface LogStatsResult {
54283
54256
  count: number;
54284
54257
  errors: number;
54285
54258
  }>;
54286
- /** True when historical (R2 SQL) counts were unavailable and stats cover only the recent hot-tier window. */
54259
+ /** True when the live overlay or the audit plane could not be read, so counts are partial. */
54287
54260
  degraded?: boolean;
54261
+ /** Which tier answered these counts. Always `store` today. */
54262
+ statsSource?: 'store' | 'legacy' | 'mixed';
54263
+ /** The span plane's earliest certified hour; counts before it are not in the store. */
54264
+ coveredFrom?: string | null;
54288
54265
  }
54289
54266
  interface LogStatsResponse {
54290
54267
  success: boolean;
package/dist/index.d.ts CHANGED
@@ -918,6 +918,8 @@ interface paths {
918
918
  thinkingLevel?: string;
919
919
  };
920
920
  sandbox?: {
921
+ /** @description Coding agents the Sandbox can run as typed sessions. Non-empty adds the agent_session_* tools; empty or absent adds none. */
922
+ codingAgents?: "opencode"[];
921
923
  enabled: boolean;
922
924
  /**
923
925
  * @description Only standard-4 is supported on the hosted Agent Sandbox path; other sizes cannot be enabled.
@@ -1432,6 +1434,8 @@ interface paths {
1432
1434
  thinkingLevel?: string;
1433
1435
  };
1434
1436
  sandbox?: {
1437
+ /** @description Coding agents the Sandbox can run as typed sessions. Non-empty adds the agent_session_* tools; empty or absent adds none. */
1438
+ codingAgents?: "opencode"[];
1435
1439
  enabled: boolean;
1436
1440
  /**
1437
1441
  * @description Only standard-4 is supported on the hosted Agent Sandbox path; other sizes cannot be enabled.
@@ -2220,6 +2224,8 @@ interface paths {
2220
2224
  thinkingLevel?: string;
2221
2225
  };
2222
2226
  sandbox?: {
2227
+ /** @description Coding agents the Sandbox can run as typed sessions. Non-empty adds the agent_session_* tools; empty or absent adds none. */
2228
+ codingAgents?: "opencode"[];
2223
2229
  enabled: boolean;
2224
2230
  /**
2225
2231
  * @description Only standard-4 is supported on the hosted Agent Sandbox path; other sizes cannot be enabled.
@@ -4780,7 +4786,7 @@ interface paths {
4780
4786
  };
4781
4787
  /**
4782
4788
  * Stream execution events
4783
- * @description Reconnect to a durable agent turn: replay-and-tail its Server-Sent Events. A turn that streams over an expired watch lease ends with `await` / `awaitReason: "detached"` while the execution keeps running; pass the last seen SSE `id:` as `after` to rejoin it. The session owner is resolved from the execution's own persisted record — its conversation for a top-level turn, its private child thread for a subagent run — and the optional `conversationId` is used only for a turn that persists no record of its own. Replays buffered events strictly past the `after` cursor, then live-tails if the turn is still running. Each event carries an SSE `id:` line — a durable row seq, or (unified vocabulary) a composite `<seq>.<subIndex>` when one durable row translates to multiple events. Pass that id verbatim after any disconnect (tab reload, sleep, stream timeout) to resume without missing or duplicating events. Replayed and live-tailed frames use the unified execution vocabulary.
4789
+ * @description Reconnect to a durable agent turn: replay-and-tail its Server-Sent Events. A turn that streams over an expired watch lease ends with `await` / `awaitReason: "detached"` while the execution keeps running; pass the last seen SSE `id:` as `after` to rejoin it. The session owner is resolved from the execution's own persisted record — its conversation for a top-level turn, its private child thread for a subagent run — and the optional `conversationId` is used only for a turn that persists no record of its own. Replays buffered events strictly past the `after` cursor, then live-tails if the turn is still running. Each event carries an SSE `id:` line — a durable row seq, or (unified vocabulary) a composite `<seq>.<subIndex>` when one durable row translates to multiple events. Pass that id verbatim after any disconnect (tab reload, sleep, stream timeout) to resume without missing or duplicating events. Replayed and live-tailed frames use the unified execution vocabulary. A Runtype session turn's response carries `X-Runtype-Execution-Driver`, the driver holding the turn when the stream attached: `request-worker` or `workflow-leg` while that driver holds it, otherwise `owner`.
4784
4790
  */
4785
4791
  get: {
4786
4792
  parameters: {
@@ -12971,6 +12977,8 @@ interface paths {
12971
12977
  thinkingLevel?: string;
12972
12978
  };
12973
12979
  sandbox?: {
12980
+ /** @description Coding agents the Sandbox can run as typed sessions. Non-empty adds the agent_session_* tools; empty or absent adds none. */
12981
+ codingAgents?: "opencode"[];
12974
12982
  enabled: boolean;
12975
12983
  /**
12976
12984
  * @description Only standard-4 is supported on the hosted Agent Sandbox path; other sizes cannot be enabled.
@@ -13419,6 +13427,8 @@ interface paths {
13419
13427
  thinkingLevel?: string;
13420
13428
  };
13421
13429
  sandbox?: {
13430
+ /** @description Coding agents the Sandbox can run as typed sessions. Non-empty adds the agent_session_* tools; empty or absent adds none. */
13431
+ codingAgents?: "opencode"[];
13422
13432
  enabled: boolean;
13423
13433
  /**
13424
13434
  * @description Only standard-4 is supported on the hosted Agent Sandbox path; other sizes cannot be enabled.
@@ -18137,7 +18147,7 @@ interface paths {
18137
18147
  };
18138
18148
  /**
18139
18149
  * Stream execution events
18140
- * @description Execution-scoped alias of `GET /v1/agents/{id}/executions/{executionId}/events`: reconnect to a durable turn and replay-and-tail its Server-Sent Events without already knowing which agent ran it. The agent is resolved from the execution's own persisted record, so a run started through `/v1/dispatch` reconnects by execution id alone; a record with no agent (an inline definition, which addresses no durable session) answers 404. A turn that streams over an expired watch lease ends with `await` / `awaitReason: "detached"` while the execution keeps running; pass the last seen SSE `id:` as `after` to rejoin it. Replays buffered events strictly past the `after` cursor, then live-tails if the turn is still running. Each event carries an SSE `id:` line — a durable row seq, or (unified vocabulary) a composite `<seq>.<subIndex>` when one durable row translates to multiple events. Pass that id verbatim after any disconnect (tab reload, sleep, stream timeout) to resume without missing or duplicating events. Replayed and live-tailed frames use the unified execution vocabulary. An API key needs `AGENTS:READ`, `AGENTS:*`, `DISPATCH:*`, or `*`; `DISPATCH:*` is admitted because this alias exists for dispatch-started runs.
18150
+ * @description Execution-scoped alias of `GET /v1/agents/{id}/executions/{executionId}/events`: reconnect to a durable turn and replay-and-tail its Server-Sent Events without already knowing which agent ran it. The agent is resolved from the execution's own persisted record, so a run started through `/v1/dispatch` reconnects by execution id alone; a record with no agent (an inline definition, which addresses no durable session) answers 404. A turn that streams over an expired watch lease ends with `await` / `awaitReason: "detached"` while the execution keeps running; pass the last seen SSE `id:` as `after` to rejoin it. Replays buffered events strictly past the `after` cursor, then live-tails if the turn is still running. Each event carries an SSE `id:` line — a durable row seq, or (unified vocabulary) a composite `<seq>.<subIndex>` when one durable row translates to multiple events. Pass that id verbatim after any disconnect (tab reload, sleep, stream timeout) to resume without missing or duplicating events. Replayed and live-tailed frames use the unified execution vocabulary. A Runtype session turn's response carries `X-Runtype-Execution-Driver`, the driver holding the turn when the stream attached: `request-worker` or `workflow-leg` while that driver holds it, otherwise `owner`. An API key needs `AGENTS:READ`, `AGENTS:*`, `DISPATCH:*`, or `*`; `DISPATCH:*` is admitted because this alias exists for dispatch-started runs.
18141
18151
  */
18142
18152
  get: {
18143
18153
  parameters: {
@@ -25207,9 +25217,7 @@ interface paths {
25207
25217
  content: {
25208
25218
  "application/json": {
25209
25219
  data: {
25210
- /** @description True when the historical segment was served by the flat fallback plan because the deduplicating one was rejected, so a re-sent delivery can appear more than once. Absent on healthy responses. */
25211
- dedupeFallback?: boolean;
25212
- /** @description True when part of the window could not be read, so entries may be missing. Evicted ordinary rows are recovered from R2 when old enough; receipt-backed recovery remains degraded when source time cannot prove ingestion. Absent on healthy responses. */
25220
+ /** @description True when the live overlay or the audit plane could not be read, so entries from that source are missing. Absent on healthy responses. */
25213
25221
  degraded?: boolean;
25214
25222
  entries: {
25215
25223
  [key: string]: unknown;
@@ -25280,59 +25288,8 @@ interface paths {
25280
25288
  "application/json": components["schemas"]["Error"];
25281
25289
  };
25282
25290
  };
25283
- };
25284
- };
25285
- put?: never;
25286
- post?: never;
25287
- delete?: never;
25288
- options?: never;
25289
- head?: never;
25290
- patch?: never;
25291
- trace?: never;
25292
- };
25293
- "/v1/logs/debug": {
25294
- parameters: {
25295
- query?: never;
25296
- header?: never;
25297
- path?: never;
25298
- cookie?: never;
25299
- };
25300
- /**
25301
- * Debug R2 SQL diagnostics
25302
- * @description R2 SQL diagnostic endpoint for troubleshooting log queries. Non-production only.
25303
- */
25304
- get: {
25305
- parameters: {
25306
- query?: never;
25307
- header?: never;
25308
- path?: never;
25309
- cookie?: never;
25310
- };
25311
- requestBody?: never;
25312
- responses: {
25313
- /** @description Diagnostics returned */
25314
- 200: {
25315
- headers: {
25316
- [name: string]: unknown;
25317
- };
25318
- content: {
25319
- "application/json": {
25320
- data?: unknown;
25321
- success: boolean;
25322
- };
25323
- };
25324
- };
25325
- /** @description Unauthorized */
25326
- 401: {
25327
- headers: {
25328
- [name: string]: unknown;
25329
- };
25330
- content: {
25331
- "application/json": components["schemas"]["Error"];
25332
- };
25333
- };
25334
- /** @description Not found */
25335
- 404: {
25291
+ /** @description Log store temporarily unavailable; no entries or counts could be read */
25292
+ 503: {
25336
25293
  headers: {
25337
25294
  [name: string]: unknown;
25338
25295
  };
@@ -25503,15 +25460,20 @@ interface paths {
25503
25460
  byType: {
25504
25461
  [key: string]: number;
25505
25462
  };
25506
- /** @description True when counts came from the flat fallback plan because the deduplicating one was rejected, so a re-sent delivery can be counted more than once. Such a response is never cached. Absent on healthy responses. */
25507
- dedupeFallback?: boolean;
25508
- /** @description True when part of the window could not be read, so counts may be partial. Evicted ordinary rows are counted from R2 when old enough; receipt-backed recovery remains degraded when source time cannot prove ingestion. Absent on healthy responses, which are the only ones cached. */
25463
+ /** @description The span plane’s earliest certified hour for this organization (ISO 8601). Counts before it are not in the store. Null when no hour is certified yet. */
25464
+ coveredFrom?: string | null;
25465
+ /** @description True when the live overlay or the audit plane could not be read, so counts are partial. Absent on healthy responses, which are the only ones cached. */
25509
25466
  degraded?: boolean;
25510
25467
  histogram: {
25511
25468
  bucket: string;
25512
25469
  count: number;
25513
25470
  errors: number;
25514
25471
  }[];
25472
+ /**
25473
+ * @description Which tier answered these counts. Always store today; the field exists so a granularity discontinuity is a labeled one rather than an unexplained drop in total.
25474
+ * @enum {string}
25475
+ */
25476
+ statsSource?: "store" | "legacy" | "mixed";
25515
25477
  total: number;
25516
25478
  };
25517
25479
  success: boolean;
@@ -25565,6 +25527,15 @@ interface paths {
25565
25527
  "application/json": components["schemas"]["Error"];
25566
25528
  };
25567
25529
  };
25530
+ /** @description Log store temporarily unavailable; no entries or counts could be read */
25531
+ 503: {
25532
+ headers: {
25533
+ [name: string]: unknown;
25534
+ };
25535
+ content: {
25536
+ "application/json": components["schemas"]["Error"];
25537
+ };
25538
+ };
25568
25539
  };
25569
25540
  };
25570
25541
  put?: never;
@@ -48769,6 +48740,8 @@ interface components {
48769
48740
  thinkingLevel?: string;
48770
48741
  };
48771
48742
  sandbox?: {
48743
+ /** @description Coding agents the Sandbox can run as typed sessions. Non-empty adds the agent_session_* tools; empty or absent adds none. */
48744
+ codingAgents?: "opencode"[];
48772
48745
  enabled: boolean;
48773
48746
  /**
48774
48747
  * @description Only standard-4 is supported on the hosted Agent Sandbox path; other sizes cannot be enabled.
@@ -54256,7 +54229,7 @@ interface LogQueryResult {
54256
54229
  cursor: string | null;
54257
54230
  hasMore: boolean;
54258
54231
  };
54259
- /** True when historical (R2 SQL) logs were unavailable and only recent hot-tier entries are included. */
54232
+ /** True when the live overlay or the audit plane could not be read, so some entries are missing. */
54260
54233
  degraded?: boolean;
54261
54234
  }
54262
54235
  /** The `from`/`to` the API resolved for a logs query, after defaults and aliases. */
@@ -54283,8 +54256,12 @@ interface LogStatsResult {
54283
54256
  count: number;
54284
54257
  errors: number;
54285
54258
  }>;
54286
- /** True when historical (R2 SQL) counts were unavailable and stats cover only the recent hot-tier window. */
54259
+ /** True when the live overlay or the audit plane could not be read, so counts are partial. */
54287
54260
  degraded?: boolean;
54261
+ /** Which tier answered these counts. Always `store` today. */
54262
+ statsSource?: 'store' | 'legacy' | 'mixed';
54263
+ /** The span plane's earliest certified hour; counts before it are not in the store. */
54264
+ coveredFrom?: string | null;
54288
54265
  }
54289
54266
  interface LogStatsResponse {
54290
54267
  success: boolean;
package/dist/index.mjs CHANGED
@@ -13934,7 +13934,7 @@ function transformQueryParams(params) {
13934
13934
 
13935
13935
  // src/version.ts
13936
13936
  var FALLBACK_VERSION = "0.0.0";
13937
- var SDK_VERSION = "10.2.1".length > 0 ? "10.2.1" : FALLBACK_VERSION;
13937
+ var SDK_VERSION = "10.2.3".length > 0 ? "10.2.3" : FALLBACK_VERSION;
13938
13938
  var RUNTYPE_CLIENT_KIND = "sdk";
13939
13939
  var SDK_USER_AGENT = `runtype-sdk/${SDK_VERSION} (typescript)`;
13940
13940
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@runtypelabs/sdk",
3
- "version": "10.2.1",
3
+ "version": "10.2.3",
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.59.0",
27
+ "@runtypelabs/shared": "3.60.0",
28
28
  "openapi-typescript": "^7.13.0",
29
29
  "tsup": "^8.0.2",
30
30
  "typescript": "^6.0.3",