@runtypelabs/sdk 10.9.0 → 10.11.0

package/dist/index.cjs

@@ -2080,21 +2080,6 @@ var AgentAliasNotFoundError = class extends Error {
 		this.agentId = body.agentId;
 	}
 };
-/**
-* A new preview pointer refused by the active-preview quota (HTTP 429). Archive
-* a preview you no longer need — archiving frees the quota immediately — or wait
-* for one to expire. `live` is never counted.
-*/
-var AgentAliasPreviewLimitError = class extends Error {
-	constructor(body) {
-		super(body.error ?? `This ${body.scope} already has ${body.limit} active preview aliases, the maximum.`);
-		this.code = "PREVIEW_ALIAS_LIMIT";
-		this.name = "AgentAliasPreviewLimitError";
-		this.scope = body.scope;
-		this.limit = body.limit;
-		this.active = body.active;
-	}
-};
 /** A version whose named references no longer resolve in this account (HTTP 422). */
 var AgentAliasDependencyError = class extends Error {
 	constructor(body) {
@@ -2163,12 +2148,6 @@ function toAliasError(err, agentId, alias) {
 		alias: asString$1(body.alias, alias),
 		agentId: asString$1(body.agentId, agentId)
 	});
-	if (status === 429 && body?.code === "PREVIEW_ALIAS_LIMIT") return new AgentAliasPreviewLimitError({
-		...error !== void 0 ? { error } : {},
-		scope: body.scope === "organization" ? "organization" : "agent",
-		limit: typeof body.limit === "number" ? body.limit : 0,
-		active: typeof body.active === "number" ? body.active : 0
-	});
 	if (status === 422 && body?.code === "alias_dependency_unresolved") return new AgentAliasDependencyError({
 		...error !== void 0 ? { error } : {},
 		refs: Array.isArray(body.refs) ? body.refs.filter((ref) => typeof ref === "string") : []
@@ -2179,8 +2158,7 @@ const TYPED_ALIAS_ERRORS = [
 	AgentAliasRevisionMismatchError,
 	AgentAliasRevisionRequiredError,
 	AgentAliasNotFoundError,
-	AgentAliasDependencyError,
-	AgentAliasPreviewLimitError
+	AgentAliasDependencyError
 ];
 /** The refusal code, when this is one of the typed alias errors. */
 function agentAliasErrorCode(err) {
@@ -14299,7 +14277,7 @@ function transformQueryParams(params) {
 }
 //#endregion
 //#region src/version.ts
-const SDK_VERSION = "10.9.0";
+const SDK_VERSION = "10.11.0";
 /**
 * Canonical client identity the API uses for attribution
 * (`detectActorSource` in apps/api/src/lib/audit-log.ts keys `'sdk'` off the
@@ -16490,7 +16468,6 @@ const STEP_TYPE_TO_METHOD = {
 //#endregion
 exports.AgentAliasDependencyError = AgentAliasDependencyError;
 exports.AgentAliasNotFoundError = AgentAliasNotFoundError;
-exports.AgentAliasPreviewLimitError = AgentAliasPreviewLimitError;
 exports.AgentAliasRevisionMismatchError = AgentAliasRevisionMismatchError;
 exports.AgentAliasRevisionRequiredError = AgentAliasRevisionRequiredError;
 exports.AgentAliasesNamespace = AgentAliasesNamespace;

package/dist/index.d.cts

@@ -1853,15 +1853,6 @@ interface paths {
             "application/json": components["schemas"]["AgentEnsureHashMismatch"];
           };
         };
-        /** @description Active preview alias quota exceeded for the organization or the agent (code PREVIEW_ALIAS_LIMIT). Archive a preview alias and retry. */
-        429: {
-          headers: {
-            [name: string]: unknown;
-          };
-          content: {
-            "application/json": components["schemas"]["AgentEnsurePreviewAliasLimit"];
-          };
-        };
         /** @description Internal server error, or code alias_activation_failed when a non-live activation could not be applied (nothing was written) */
         500: {
           headers: {
@@ -3063,7 +3054,7 @@ interface paths {
     };
     /**
      * Activate a version at a release alias
-     * @description Aim one alias at one immutable version of the same agent, appending a deployment receipt in the same transaction. Moving an existing `live` pointer requires the AGENTS:DEPLOY:LIVE scope and an `If-Match` revision; preview aliases require AGENTS:DEPLOY:PREVIEW. Dependency references the version names are fingerprinted first, and an unresolvable reference refuses the activation. Activating a preview alias renews its 14-day expiry; `live` never expires. Creating a new preview alias past the active-preview quota answers 429 with code PREVIEW_ALIAS_LIMIT.
+     * @description Aim one alias at one immutable version of the same agent, appending a deployment receipt in the same transaction. Moving an existing `live` pointer requires the AGENTS:DEPLOY:LIVE scope and an `If-Match` revision; preview aliases require AGENTS:DEPLOY:PREVIEW. Dependency references the version names are fingerprinted first, and an unresolvable reference refuses the activation. Activating a preview alias renews its 14-day expiry; `live` never expires.
      */
     put: {
       parameters: {
@@ -3098,14 +3089,10 @@ interface paths {
           };
           content: {
             "application/json": {
-              /** @description How many preview aliases this agent has active after the write. Null for `live`, which is never counted. Read it beside `previewLimit` to see a per-pull-request pipeline filling up before an activation is refused with PREVIEW_ALIAS_LIMIT. */
-              activePreviewCount: number | null;
               alias: string;
               /** @description Per-alias secret binding names in force after this activation. Names only, never values. */
               bindingNames: string[];
               changed: boolean;
-              /** @description The active-preview ceiling this agent is counted against. Null for `live`. */
-              previewLimit: number | null;
               receiptId: string;
               revision: number;
               versionId: string;
@@ -3197,15 +3184,6 @@ interface paths {
             "application/json": components["schemas"]["Error"];
           };
         };
-        /** @description Active preview alias quota exceeded for the organization or the agent */
-        429: {
-          headers: {
-            [name: string]: unknown;
-          };
-          content: {
-            "application/json": components["schemas"]["PreviewAliasLimitError"];
-          };
-        };
         /** @description Internal server error */
         500: {
           headers: {
@@ -3720,14 +3698,10 @@ interface paths {
           };
           content: {
             "application/json": {
-              /** @description How many preview aliases this agent has active after the write. Null for `live`, which is never counted. Read it beside `previewLimit` to see a per-pull-request pipeline filling up before an activation is refused with PREVIEW_ALIAS_LIMIT. */
-              activePreviewCount: number | null;
               alias: string;
               /** @description Per-alias secret binding names in force after this activation. Names only, never values. */
               bindingNames: string[];
               changed: boolean;
-              /** @description The active-preview ceiling this agent is counted against. Null for `live`. */
-              previewLimit: number | null;
               receiptId: string;
               revision: number;
               versionId: string;
@@ -31838,6 +31812,18 @@ interface paths {
                     totalCost: string | null;
                     /** @description Trace id in the span store; null on a row the control-plane arm served. */
                     traceId: string | null;
+                    /** @description How the run started, for a Via column. Forward-only for schedule, api key, cli, mcp and eval detail: a header written before those stamps reads null, or falls back to the coarse origin/surface facts when they alone answer it. A label is a snapshot or a lookup and never authority; mcp, cli and sdk are self-declared by the client. */
+                    via?: {
+                      /** @description The thing that started it: the schedule id (schedule), product surface id (surface), API key id (api), the acting user id (cli) or eval suite id (eval). Null for mcp and test, and for an api run whose header predates key stamping. */
+                      id: string | null;
+                      /**
+                       * @description One word for the way the run started.
+                       * @enum {string}
+                       */
+                      kind: "schedule" | "surface" | "api" | "mcp" | "cli" | "test" | "eval";
+                      /** @description Its display name when the API could resolve one: schedule name, surface name, API key name as it was at dispatch, MCP client name, the acting user's first name, or eval suite name. Null when unresolved, for example a deleted schedule. */
+                      label: string | null;
+                    } | null;
                   }[];
                   error?: {
                     message: string;
@@ -42555,7 +42541,7 @@ interface paths {
     };
     /**
      * List runs
-     * @description Every agent and flow run in the span store, newest start first, including runs that write no control-plane row. The UNSCOPED feed is ROOT runs only: a subagent or nested-flow run folds under its parent, `childCount` says how many are folded there, and `parentExecutionId=<id>` reads them. Pass `includeChildren=true` for the flat enumeration. Any resource-scoped filter (`agentId`, `flowId`, `conversationId`, `surfaceId`, `recordId`, `batchExecutionId`, `parentExecutionId`, `rootExecutionId`, `executionId`) is already an explicit selection and never folds, so an agent that only ever runs as a subagent still lists under `agentId`. Each row carries `origin` (dashboard | api | internal | null), read from the caller's authenticated principal, and `test` as its derived alias for `origin === "dashboard"`; any entrance that resolves a principal stamps origin, including the Runtype MCP server tools and Code Mode (`api`) and the hosted `/v1/mcp` proxy (`internal`). A lane with no principal answers null for both by design: schedule, webhook, messaging, A2A, an agent exposed as an MCP surface, subagent, nested flow, a client-token product surface, an ingested run, and any row whose header predates the field. `overlay=live` adds live control-plane fields; the overlay never adds, drops or reorders a row. A cursor minted by the retired control-plane list lane (`cp.` prefix) restarts at page one and answers `pagination.cursorReset: true`.
+     * @description Every agent and flow run in the span store, newest start first, including runs that write no control-plane row. The UNSCOPED feed is ROOT runs only: a subagent or nested-flow run folds under its parent, `childCount` says how many are folded there, and `parentExecutionId=<id>` reads them. Pass `includeChildren=true` for the flat enumeration. Any resource-scoped filter (`agentId`, `flowId`, `conversationId`, `surfaceId`, `recordId`, `batchExecutionId`, `parentExecutionId`, `rootExecutionId`, `executionId`) is already an explicit selection and never folds, so an agent that only ever runs as a subagent still lists under `agentId`. Each row carries `origin` (dashboard | api | internal | null), read from the caller's authenticated principal, and `test` as its derived alias for `origin === "dashboard"`; any entrance that resolves a principal stamps origin, including the Runtype MCP server tools and Code Mode (`api`) and the hosted `/v1/mcp` proxy (`internal`). A lane with no principal answers null for both by design: schedule, webhook, messaging, A2A, an agent exposed as an MCP surface, subagent, nested flow, a client-token product surface, an ingested run, and any row whose header predates the field. `overlay=live` adds live control-plane fields; the overlay never adds, drops or reorders a row. A cursor minted by the retired control-plane list lane (`cp.` prefix) restarts at page one and answers `pagination.cursorReset: true`. `includeCount=true` adds `pagination.totalCount`, counted up to 1000, and `pagination.totalCountCapped`. Each row carries `via` (schedule | surface | api | mcp | cli | test | eval, with the id and name of the thing that started it) where the entrance stated it; null otherwise.
      */
     get: {
       parameters: {
@@ -42598,6 +42584,8 @@ interface paths {
           limit?: string;
           /** @description Keyset cursor from a previous page. */
           cursor?: string;
+          /** @description "true" adds pagination.totalCount and pagination.totalCountCapped: the number of runs matching this request's filters within its window, ignoring the cursor and limit, counted up to 1000. Past that the count stops at 1000 and totalCountCapped is true, so read it as "more than 1000". Omitted, or any other value, the response carries neither field. */
+          includeCount?: string;
         };
         header?: never;
         path?: never;
@@ -42620,6 +42608,10 @@ interface paths {
                 hasPrev: boolean;
                 limit: number;
                 nextCursor: string | null;
+                /** @description The runs the request's filters match within its window, ignoring the cursor and limit, counted up to 1000. Present only when `includeCount=true`. */
+                totalCount?: number;
+                /** @description True when more than 1000 runs matched, so `totalCount` is the cap rather than the total. Present only when `includeCount=true`. */
+                totalCountCapped?: boolean;
               };
               /** @description The started_at window the query resolved to, after defaults. */
               window: {
@@ -44309,6 +44301,8 @@ interface paths {
           search?: string;
           /** @description Filter by status */
           status?: "active" | "paused";
+          /** @description Only schedules that run this agent */
+          agentId?: string;
           /** @description Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`. */
           view?: "full" | "compact";
         };
@@ -44357,7 +44351,7 @@ interface paths {
             };
           };
         };
-        /** @description Canonical first page (no cursor/search/status, includeCount=true) is unchanged since the ETag echoed in If-None-Match. No body. */
+        /** @description Canonical first page (no cursor/search/status/agentId, includeCount=true) is unchanged since the ETag echoed in If-None-Match. No body. */
         304: {
           headers: {
             [name: string]: unknown;
@@ -51432,20 +51426,6 @@ interface components {
       contentHash: string;
       error: string;
     };
-    AgentEnsurePreviewAliasLimit: {
-      active: number;
-      /** @enum {string} */
-      code: "PREVIEW_ALIAS_LIMIT";
-      error: string;
-      limit: number;
-      /** @description The same remediation sentence as `error`. */
-      message: string;
-      /**
-       * @description Which population was already at its active-preview limit.
-       * @enum {string}
-       */
-      scope: "organization" | "agent";
-    };
     AgentEnsureResponse: {
       agentId: string;
       /** @description Present when the request carried capabilities: one row per declared capability, then removals. */
@@ -54219,15 +54199,6 @@ interface components {
       totalCount?: number;
       totalPages?: number;
     };
-    PreviewAliasLimitError: components["schemas"]["Error"] & {
-      active: number;
-      /** @enum {string} */
-      code: "PREVIEW_ALIAS_LIMIT";
-      limit: number;
-      message: string;
-      /** @enum {string} */
-      scope: "organization" | "agent";
-    };
     ProductCanvasBlock: {
       /** @description When the block was added; set by the server */
       readonly addedAt?: string;
@@ -54778,6 +54749,18 @@ interface components {
       totalCost: string | null;
       /** @description Trace id in the span store; null on a row the control-plane arm served. */
       traceId: string | null;
+      /** @description How the run started, for a Via column. Forward-only for schedule, api key, cli, mcp and eval detail: a header written before those stamps reads null, or falls back to the coarse origin/surface facts when they alone answer it. A label is a snapshot or a lookup and never authority; mcp, cli and sdk are self-declared by the client. */
+      via?: {
+        /** @description The thing that started it: the schedule id (schedule), product surface id (surface), API key id (api), the acting user id (cli) or eval suite id (eval). Null for mcp and test, and for an api run whose header predates key stamping. */
+        id: string | null;
+        /**
+         * @description One word for the way the run started.
+         * @enum {string}
+         */
+        kind: "schedule" | "surface" | "api" | "mcp" | "cli" | "test" | "eval";
+        /** @description Its display name when the API could resolve one: schedule name, surface name, API key name as it was at dispatch, MCP client name, the acting user's first name, or eval suite name. Null when unresolved, for example a deleted schedule. */
+        label: string | null;
+      } | null;
     };
     RuntimeEmailAdmissionError: {
       code?: string;
@@ -61393,23 +61376,6 @@ export declare class AgentAliasNotFoundError extends Error {
     agentId: string;
   });
 }
-/**
- * A new preview pointer refused by the active-preview quota (HTTP 429). Archive
- * a preview you no longer need — archiving frees the quota immediately — or wait
- * for one to expire. `live` is never counted.
- */
-export declare class AgentAliasPreviewLimitError extends Error {
-  readonly code = "PREVIEW_ALIAS_LIMIT";
-  readonly scope: 'organization' | 'agent';
-  readonly limit: number;
-  readonly active: number;
-  constructor(body: {
-    error?: string;
-    scope: 'organization' | 'agent';
-    limit: number;
-    active: number;
-  });
-}
 /** A version whose named references no longer resolve in this account (HTTP 422). */
 export declare class AgentAliasDependencyError extends Error {
   readonly code = "alias_dependency_unresolved";
@@ -61420,7 +61386,7 @@ export declare class AgentAliasDependencyError extends Error {
   });
 }
 /** Every coded refusal the alias plane maps onto a typed error. */
-type TypedAliasError = AgentAliasRevisionMismatchError | AgentAliasRevisionRequiredError | AgentAliasNotFoundError | AgentAliasDependencyError | AgentAliasPreviewLimitError;
+type TypedAliasError = AgentAliasRevisionMismatchError | AgentAliasRevisionRequiredError | AgentAliasNotFoundError | AgentAliasDependencyError;
 /** The refusal code, when this is one of the typed alias errors. */
 export declare function agentAliasErrorCode(err: unknown): TypedAliasError['code'] | undefined;
 interface ListAgentAliasesOptions {
@@ -62026,6 +61992,18 @@ interface RunListRow {
    * predates the field.
    */
   test: boolean | null;
+  /**
+   * How the run started, for a Via column. Forward-only for schedule, API key,
+   * CLI, MCP and eval detail: a header written before those stamps reads null or
+   * the coarse origin. `mcp`, `cli` and `sdk` are self-declared by the client.
+   */
+  via?: {
+    kind: 'schedule' | 'surface' | 'api' | 'mcp' | 'cli' | 'test' | 'eval';
+    /** Schedule, surface, API key, acting user or eval suite id; null for mcp and test. */
+    id: string | null;
+    /** Its display name when the API could resolve one; null otherwise. */
+    label: string | null;
+  } | null;
   stopReason?: string | null;
   iterations?: number | null;
   /**
@@ -62079,6 +62057,8 @@ interface RunListParams {
   overlay?: 'live' | 'none';
   limit?: number;
   cursor?: string;
+  /** `'true'` adds `pagination.totalCount`, counted up to 1000, and `totalCountCapped`. */
+  includeCount?: 'true' | 'false';
 }
 interface RunListResponse {
   data: RunListRow[];
@@ -62089,6 +62069,10 @@ interface RunListResponse {
     limit: number;
     /** True when the supplied cursor was rejected and the read restarted at page one; stop paging. */
     cursorReset?: boolean;
+    /** Runs the filters match in the window, up to 1000; present only when `includeCount` was `'true'`. */
+    totalCount?: number;
+    /** True when more runs matched than `totalCount` counts, so read it as "more than". */
+    totalCountCapped?: boolean;
   };
   window: {
     from: string;

package/dist/index.d.ts

@@ -1853,15 +1853,6 @@ interface paths {
             "application/json": components["schemas"]["AgentEnsureHashMismatch"];
           };
         };
-        /** @description Active preview alias quota exceeded for the organization or the agent (code PREVIEW_ALIAS_LIMIT). Archive a preview alias and retry. */
-        429: {
-          headers: {
-            [name: string]: unknown;
-          };
-          content: {
-            "application/json": components["schemas"]["AgentEnsurePreviewAliasLimit"];
-          };
-        };
         /** @description Internal server error, or code alias_activation_failed when a non-live activation could not be applied (nothing was written) */
         500: {
           headers: {
@@ -3063,7 +3054,7 @@ interface paths {
     };
     /**
      * Activate a version at a release alias
-     * @description Aim one alias at one immutable version of the same agent, appending a deployment receipt in the same transaction. Moving an existing `live` pointer requires the AGENTS:DEPLOY:LIVE scope and an `If-Match` revision; preview aliases require AGENTS:DEPLOY:PREVIEW. Dependency references the version names are fingerprinted first, and an unresolvable reference refuses the activation. Activating a preview alias renews its 14-day expiry; `live` never expires. Creating a new preview alias past the active-preview quota answers 429 with code PREVIEW_ALIAS_LIMIT.
+     * @description Aim one alias at one immutable version of the same agent, appending a deployment receipt in the same transaction. Moving an existing `live` pointer requires the AGENTS:DEPLOY:LIVE scope and an `If-Match` revision; preview aliases require AGENTS:DEPLOY:PREVIEW. Dependency references the version names are fingerprinted first, and an unresolvable reference refuses the activation. Activating a preview alias renews its 14-day expiry; `live` never expires.
      */
     put: {
       parameters: {
@@ -3098,14 +3089,10 @@ interface paths {
           };
           content: {
             "application/json": {
-              /** @description How many preview aliases this agent has active after the write. Null for `live`, which is never counted. Read it beside `previewLimit` to see a per-pull-request pipeline filling up before an activation is refused with PREVIEW_ALIAS_LIMIT. */
-              activePreviewCount: number | null;
               alias: string;
               /** @description Per-alias secret binding names in force after this activation. Names only, never values. */
               bindingNames: string[];
               changed: boolean;
-              /** @description The active-preview ceiling this agent is counted against. Null for `live`. */
-              previewLimit: number | null;
               receiptId: string;
               revision: number;
               versionId: string;
@@ -3197,15 +3184,6 @@ interface paths {
             "application/json": components["schemas"]["Error"];
           };
         };
-        /** @description Active preview alias quota exceeded for the organization or the agent */
-        429: {
-          headers: {
-            [name: string]: unknown;
-          };
-          content: {
-            "application/json": components["schemas"]["PreviewAliasLimitError"];
-          };
-        };
         /** @description Internal server error */
         500: {
           headers: {
@@ -3720,14 +3698,10 @@ interface paths {
           };
           content: {
             "application/json": {
-              /** @description How many preview aliases this agent has active after the write. Null for `live`, which is never counted. Read it beside `previewLimit` to see a per-pull-request pipeline filling up before an activation is refused with PREVIEW_ALIAS_LIMIT. */
-              activePreviewCount: number | null;
               alias: string;
               /** @description Per-alias secret binding names in force after this activation. Names only, never values. */
               bindingNames: string[];
               changed: boolean;
-              /** @description The active-preview ceiling this agent is counted against. Null for `live`. */
-              previewLimit: number | null;
               receiptId: string;
               revision: number;
               versionId: string;
@@ -31838,6 +31812,18 @@ interface paths {
                     totalCost: string | null;
                     /** @description Trace id in the span store; null on a row the control-plane arm served. */
                     traceId: string | null;
+                    /** @description How the run started, for a Via column. Forward-only for schedule, api key, cli, mcp and eval detail: a header written before those stamps reads null, or falls back to the coarse origin/surface facts when they alone answer it. A label is a snapshot or a lookup and never authority; mcp, cli and sdk are self-declared by the client. */
+                    via?: {
+                      /** @description The thing that started it: the schedule id (schedule), product surface id (surface), API key id (api), the acting user id (cli) or eval suite id (eval). Null for mcp and test, and for an api run whose header predates key stamping. */
+                      id: string | null;
+                      /**
+                       * @description One word for the way the run started.
+                       * @enum {string}
+                       */
+                      kind: "schedule" | "surface" | "api" | "mcp" | "cli" | "test" | "eval";
+                      /** @description Its display name when the API could resolve one: schedule name, surface name, API key name as it was at dispatch, MCP client name, the acting user's first name, or eval suite name. Null when unresolved, for example a deleted schedule. */
+                      label: string | null;
+                    } | null;
                   }[];
                   error?: {
                     message: string;
@@ -42555,7 +42541,7 @@ interface paths {
     };
     /**
      * List runs
-     * @description Every agent and flow run in the span store, newest start first, including runs that write no control-plane row. The UNSCOPED feed is ROOT runs only: a subagent or nested-flow run folds under its parent, `childCount` says how many are folded there, and `parentExecutionId=<id>` reads them. Pass `includeChildren=true` for the flat enumeration. Any resource-scoped filter (`agentId`, `flowId`, `conversationId`, `surfaceId`, `recordId`, `batchExecutionId`, `parentExecutionId`, `rootExecutionId`, `executionId`) is already an explicit selection and never folds, so an agent that only ever runs as a subagent still lists under `agentId`. Each row carries `origin` (dashboard | api | internal | null), read from the caller's authenticated principal, and `test` as its derived alias for `origin === "dashboard"`; any entrance that resolves a principal stamps origin, including the Runtype MCP server tools and Code Mode (`api`) and the hosted `/v1/mcp` proxy (`internal`). A lane with no principal answers null for both by design: schedule, webhook, messaging, A2A, an agent exposed as an MCP surface, subagent, nested flow, a client-token product surface, an ingested run, and any row whose header predates the field. `overlay=live` adds live control-plane fields; the overlay never adds, drops or reorders a row. A cursor minted by the retired control-plane list lane (`cp.` prefix) restarts at page one and answers `pagination.cursorReset: true`.
+     * @description Every agent and flow run in the span store, newest start first, including runs that write no control-plane row. The UNSCOPED feed is ROOT runs only: a subagent or nested-flow run folds under its parent, `childCount` says how many are folded there, and `parentExecutionId=<id>` reads them. Pass `includeChildren=true` for the flat enumeration. Any resource-scoped filter (`agentId`, `flowId`, `conversationId`, `surfaceId`, `recordId`, `batchExecutionId`, `parentExecutionId`, `rootExecutionId`, `executionId`) is already an explicit selection and never folds, so an agent that only ever runs as a subagent still lists under `agentId`. Each row carries `origin` (dashboard | api | internal | null), read from the caller's authenticated principal, and `test` as its derived alias for `origin === "dashboard"`; any entrance that resolves a principal stamps origin, including the Runtype MCP server tools and Code Mode (`api`) and the hosted `/v1/mcp` proxy (`internal`). A lane with no principal answers null for both by design: schedule, webhook, messaging, A2A, an agent exposed as an MCP surface, subagent, nested flow, a client-token product surface, an ingested run, and any row whose header predates the field. `overlay=live` adds live control-plane fields; the overlay never adds, drops or reorders a row. A cursor minted by the retired control-plane list lane (`cp.` prefix) restarts at page one and answers `pagination.cursorReset: true`. `includeCount=true` adds `pagination.totalCount`, counted up to 1000, and `pagination.totalCountCapped`. Each row carries `via` (schedule | surface | api | mcp | cli | test | eval, with the id and name of the thing that started it) where the entrance stated it; null otherwise.
      */
     get: {
       parameters: {
@@ -42598,6 +42584,8 @@ interface paths {
           limit?: string;
           /** @description Keyset cursor from a previous page. */
           cursor?: string;
+          /** @description "true" adds pagination.totalCount and pagination.totalCountCapped: the number of runs matching this request's filters within its window, ignoring the cursor and limit, counted up to 1000. Past that the count stops at 1000 and totalCountCapped is true, so read it as "more than 1000". Omitted, or any other value, the response carries neither field. */
+          includeCount?: string;
         };
         header?: never;
         path?: never;
@@ -42620,6 +42608,10 @@ interface paths {
                 hasPrev: boolean;
                 limit: number;
                 nextCursor: string | null;
+                /** @description The runs the request's filters match within its window, ignoring the cursor and limit, counted up to 1000. Present only when `includeCount=true`. */
+                totalCount?: number;
+                /** @description True when more than 1000 runs matched, so `totalCount` is the cap rather than the total. Present only when `includeCount=true`. */
+                totalCountCapped?: boolean;
               };
               /** @description The started_at window the query resolved to, after defaults. */
               window: {
@@ -44309,6 +44301,8 @@ interface paths {
           search?: string;
           /** @description Filter by status */
           status?: "active" | "paused";
+          /** @description Only schedules that run this agent */
+          agentId?: string;
           /** @description Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`. */
           view?: "full" | "compact";
         };
@@ -44357,7 +44351,7 @@ interface paths {
             };
           };
         };
-        /** @description Canonical first page (no cursor/search/status, includeCount=true) is unchanged since the ETag echoed in If-None-Match. No body. */
+        /** @description Canonical first page (no cursor/search/status/agentId, includeCount=true) is unchanged since the ETag echoed in If-None-Match. No body. */
         304: {
           headers: {
             [name: string]: unknown;
@@ -51432,20 +51426,6 @@ interface components {
       contentHash: string;
       error: string;
     };
-    AgentEnsurePreviewAliasLimit: {
-      active: number;
-      /** @enum {string} */
-      code: "PREVIEW_ALIAS_LIMIT";
-      error: string;
-      limit: number;
-      /** @description The same remediation sentence as `error`. */
-      message: string;
-      /**
-       * @description Which population was already at its active-preview limit.
-       * @enum {string}
-       */
-      scope: "organization" | "agent";
-    };
     AgentEnsureResponse: {
       agentId: string;
       /** @description Present when the request carried capabilities: one row per declared capability, then removals. */
@@ -54219,15 +54199,6 @@ interface components {
       totalCount?: number;
       totalPages?: number;
     };
-    PreviewAliasLimitError: components["schemas"]["Error"] & {
-      active: number;
-      /** @enum {string} */
-      code: "PREVIEW_ALIAS_LIMIT";
-      limit: number;
-      message: string;
-      /** @enum {string} */
-      scope: "organization" | "agent";
-    };
     ProductCanvasBlock: {
       /** @description When the block was added; set by the server */
       readonly addedAt?: string;
@@ -54778,6 +54749,18 @@ interface components {
       totalCost: string | null;
       /** @description Trace id in the span store; null on a row the control-plane arm served. */
       traceId: string | null;
+      /** @description How the run started, for a Via column. Forward-only for schedule, api key, cli, mcp and eval detail: a header written before those stamps reads null, or falls back to the coarse origin/surface facts when they alone answer it. A label is a snapshot or a lookup and never authority; mcp, cli and sdk are self-declared by the client. */
+      via?: {
+        /** @description The thing that started it: the schedule id (schedule), product surface id (surface), API key id (api), the acting user id (cli) or eval suite id (eval). Null for mcp and test, and for an api run whose header predates key stamping. */
+        id: string | null;
+        /**
+         * @description One word for the way the run started.
+         * @enum {string}
+         */
+        kind: "schedule" | "surface" | "api" | "mcp" | "cli" | "test" | "eval";
+        /** @description Its display name when the API could resolve one: schedule name, surface name, API key name as it was at dispatch, MCP client name, the acting user's first name, or eval suite name. Null when unresolved, for example a deleted schedule. */
+        label: string | null;
+      } | null;
     };
     RuntimeEmailAdmissionError: {
       code?: string;
@@ -61393,23 +61376,6 @@ export declare class AgentAliasNotFoundError extends Error {
     agentId: string;
   });
 }
-/**
- * A new preview pointer refused by the active-preview quota (HTTP 429). Archive
- * a preview you no longer need — archiving frees the quota immediately — or wait
- * for one to expire. `live` is never counted.
- */
-export declare class AgentAliasPreviewLimitError extends Error {
-  readonly code = "PREVIEW_ALIAS_LIMIT";
-  readonly scope: 'organization' | 'agent';
-  readonly limit: number;
-  readonly active: number;
-  constructor(body: {
-    error?: string;
-    scope: 'organization' | 'agent';
-    limit: number;
-    active: number;
-  });
-}
 /** A version whose named references no longer resolve in this account (HTTP 422). */
 export declare class AgentAliasDependencyError extends Error {
   readonly code = "alias_dependency_unresolved";
@@ -61420,7 +61386,7 @@ export declare class AgentAliasDependencyError extends Error {
   });
 }
 /** Every coded refusal the alias plane maps onto a typed error. */
-type TypedAliasError = AgentAliasRevisionMismatchError | AgentAliasRevisionRequiredError | AgentAliasNotFoundError | AgentAliasDependencyError | AgentAliasPreviewLimitError;
+type TypedAliasError = AgentAliasRevisionMismatchError | AgentAliasRevisionRequiredError | AgentAliasNotFoundError | AgentAliasDependencyError;
 /** The refusal code, when this is one of the typed alias errors. */
 export declare function agentAliasErrorCode(err: unknown): TypedAliasError['code'] | undefined;
 interface ListAgentAliasesOptions {
@@ -62026,6 +61992,18 @@ interface RunListRow {
    * predates the field.
    */
   test: boolean | null;
+  /**
+   * How the run started, for a Via column. Forward-only for schedule, API key,
+   * CLI, MCP and eval detail: a header written before those stamps reads null or
+   * the coarse origin. `mcp`, `cli` and `sdk` are self-declared by the client.
+   */
+  via?: {
+    kind: 'schedule' | 'surface' | 'api' | 'mcp' | 'cli' | 'test' | 'eval';
+    /** Schedule, surface, API key, acting user or eval suite id; null for mcp and test. */
+    id: string | null;
+    /** Its display name when the API could resolve one; null otherwise. */
+    label: string | null;
+  } | null;
   stopReason?: string | null;
   iterations?: number | null;
   /**
@@ -62079,6 +62057,8 @@ interface RunListParams {
   overlay?: 'live' | 'none';
   limit?: number;
   cursor?: string;
+  /** `'true'` adds `pagination.totalCount`, counted up to 1000, and `totalCountCapped`. */
+  includeCount?: 'true' | 'false';
 }
 interface RunListResponse {
   data: RunListRow[];
@@ -62089,6 +62069,10 @@ interface RunListResponse {
     limit: number;
     /** True when the supplied cursor was rejected and the read restarted at page one; stop paging. */
     cursorReset?: boolean;
+    /** Runs the filters match in the window, up to 1000; present only when `includeCount` was `'true'`. */
+    totalCount?: number;
+    /** True when more runs matched than `totalCount` counts, so read it as "more than". */
+    totalCountCapped?: boolean;
   };
   window: {
     from: string;

package/dist/index.mjs

@@ -2079,21 +2079,6 @@ var AgentAliasNotFoundError = class extends Error {
 		this.agentId = body.agentId;
 	}
 };
-/**
-* A new preview pointer refused by the active-preview quota (HTTP 429). Archive
-* a preview you no longer need — archiving frees the quota immediately — or wait
-* for one to expire. `live` is never counted.
-*/
-var AgentAliasPreviewLimitError = class extends Error {
-	constructor(body) {
-		super(body.error ?? `This ${body.scope} already has ${body.limit} active preview aliases, the maximum.`);
-		this.code = "PREVIEW_ALIAS_LIMIT";
-		this.name = "AgentAliasPreviewLimitError";
-		this.scope = body.scope;
-		this.limit = body.limit;
-		this.active = body.active;
-	}
-};
 /** A version whose named references no longer resolve in this account (HTTP 422). */
 var AgentAliasDependencyError = class extends Error {
 	constructor(body) {
@@ -2162,12 +2147,6 @@ function toAliasError(err, agentId, alias) {
 		alias: asString$1(body.alias, alias),
 		agentId: asString$1(body.agentId, agentId)
 	});
-	if (status === 429 && body?.code === "PREVIEW_ALIAS_LIMIT") return new AgentAliasPreviewLimitError({
-		...error !== void 0 ? { error } : {},
-		scope: body.scope === "organization" ? "organization" : "agent",
-		limit: typeof body.limit === "number" ? body.limit : 0,
-		active: typeof body.active === "number" ? body.active : 0
-	});
 	if (status === 422 && body?.code === "alias_dependency_unresolved") return new AgentAliasDependencyError({
 		...error !== void 0 ? { error } : {},
 		refs: Array.isArray(body.refs) ? body.refs.filter((ref) => typeof ref === "string") : []
@@ -2178,8 +2157,7 @@ const TYPED_ALIAS_ERRORS = [
 	AgentAliasRevisionMismatchError,
 	AgentAliasRevisionRequiredError,
 	AgentAliasNotFoundError,
-	AgentAliasDependencyError,
-	AgentAliasPreviewLimitError
+	AgentAliasDependencyError
 ];
 /** The refusal code, when this is one of the typed alias errors. */
 function agentAliasErrorCode(err) {
@@ -14298,7 +14276,7 @@ function transformQueryParams(params) {
 }
 //#endregion
 //#region src/version.ts
-const SDK_VERSION = "10.9.0";
+const SDK_VERSION = "10.11.0";
 /**
 * Canonical client identity the API uses for attribution
 * (`detectActorSource` in apps/api/src/lib/audit-log.ts keys `'sdk'` off the
@@ -16487,5 +16465,5 @@ const STEP_TYPE_TO_METHOD = {
 	"memory-summary": "memorySummary"
 };
 //#endregion
-export { AgentAliasDependencyError, AgentAliasNotFoundError, AgentAliasPreviewLimitError, AgentAliasRevisionMismatchError, AgentAliasRevisionRequiredError, AgentAliasesNamespace, AgentDeploymentsNamespace, AgentDriftError, AgentEnsureConflictError, AgentPromotionError, AgentVersionsEndpoint, AgentsEndpoint, AgentsNamespace, AnalyticsEndpoint, ApiKeyRequestsEndpoint, ApiKeysEndpoint, BatchBuilder, BatchesNamespace, BillingEndpoint, ChatEndpoint, ClientBatchBuilder, ClientEvalBuilder, ClientFlowBuilder, ClientTokenDriftError, ClientTokenEnsureError, ClientTokensEndpoint, ClientTokensNamespace, CollectionDriftError, CollectionEnsureConflictError, CollectionsEndpoint, ContextTemplatesEndpoint, ConversationsEndpoint, DEFAULT_MAX_DETACHED_RECONNECTS, DEFAULT_RECOVERY_AFTER_EMPTY_SESSIONS, DEFAULT_STALL_STOP_AFTER, DispatchEndpoint, ENSURE_RELEASE_DEPLOY_CONFLICT_MESSAGE, EvalBuilder, EvalDriftError, EvalEndpoint, EvalEnsureConflictError, EvalRunner, EvalSuitesNamespace, EvalsNamespace, ExecutionsEndpoint, ExecutionsNamespace, FlowBuilder, FlowDriftError, FlowEnsureConflictError, FlowResult, FlowStepsEndpoint, FlowVersionsEndpoint, FlowsEndpoint, FlowsNamespace, FpoDriftError, IntegrationsEndpoint, LEDGER_ARTIFACT_LINE_PREFIX, LIVE_AGENT_ALIAS, LogsEndpoint, ModelConfigsEndpoint, ProductDriftError, ProductEnsureConflictError, ProductsNamespace, PromptsEndpoint, PromptsNamespace, ProviderKeysEndpoint, QuestionSetDriftError, QuestionSetEnsureConflictError, QuestionSetsNamespace, RUNTYPE_CLIENT_KIND, RecordsEndpoint, RunsNamespace, Runtype, RuntypeApiError, RuntypeClient, RuntypeFlowBuilder, SDK_USER_AGENT, SDK_VERSION, STEP_FIELD_REGISTRY, STEP_TYPE_TO_METHOD, ScheduleDriftError, ScheduleEnsureConflictError, SchedulesEndpoint, SecretsEndpoint, SkillDriftError, SkillEnsureConflictError, SkillProposalsNamespace, SkillsNamespace, SurfaceDriftError, SurfaceEnsureConflictError, SurfacesEndpoint, SurfacesNamespace, ToolApprovalGrantsEndpoint, ToolDriftError, ToolEnsureConflictError, ToolsEndpoint, ToolsNamespace, TypedRecordsScope, UNIFIED_EVENTS_QUERY, UsersEndpoint, activateAgentPromotion, agentAliasErrorCode, applyGeneratedRuntimeToolProposalToDispatchRequest, attachRuntimeToolsToDispatchRequest, buildAgentAdmissionHeaders, buildEmptySessionNudge, buildExecutionEventsPath, buildGeneratedRuntimeToolGateOutput, buildLedgerOffloadReference, buildObservationMaskMarker, buildPolicyGuidance, buildSendViewOffloadMarker, calledTool, combineAbortSignals, compileWorkflowConfig, completed, computeAgentContentHash, computeEvalContentHash, computeFlowContentHash, computeFpoContentHash, computeProductContentHash, computeQuestionSetContentHash, computeRecordCollectionContentHash, computeScheduleContentHash, computeScheduleDefinitionHash, computeSkillContentHash, computeSurfaceContentHash, computeToolContentHash, contains, cost, createAgentEventTranslator, createClient, createExternalTool, createFlowEventTranslator, defaultWorkflow, defaultWorkflowConfig, defineAgent, defineEval, defineFlow, defineFpo, definePlaybook, defineProduct, defineQuestionSet, defineSchedule, defineSkill, defineSurface, defineTool, deployWorkflow, ensureDefaultWorkflowHooks, ensureEval, ensureFpo, ensureSchedule, evaluateGeneratedRuntimeToolProposal, extractDeclaredToolResultChars, fpoPlanHasDrift, gameWorkflow, getDefaultPlanPath, getLikelySupportingCandidatePaths, interpolateWorkflowTemplate, isBuiltinToolExecuteResponse, isCatalogClientToolRef, isDiscoveryToolName, isMarathonArtifactPath, isPreservationSensitiveTask, isUnifiedEventType, isWorkflowHookRef, jsonField, judge, judges, latency, length, listWorkflowHooks, matchesExpected, maxToolCalls, noError, normalizeAgentDefinition, normalizeCandidatePath, normalizeFpoDefinition, normalizeProductDefinition, normalizeQuestionSetDefinition, normalizeRecordCollectionDefinition, normalizeScheduleContent, normalizeSkillDefinition, normalizeSurfaceDefinition, normalizeToolDefinition, notCalledTool, notContains, parseFinalBuffer, parseLedgerArtifactRelativePath, parseOffloadedOutputId, parseSSEChunk, prepareAgentPromotion, processStream, promoteAgent, promotionIdempotencyKey, pullEval, pullFpo, pullSchedule, ranStep, regex, registerWorkflowHook, resolveStallStopAfter, resolveWorkflowHook, runEvalSuite, sanitizeTaskSlug, shouldInjectEmptySessionNudge, shouldRequestModelEscalation, stepOrder, streamEvents, toolOrder, unregisterWorkflowHook, usedNoTools, validJson, validateAgentPromotion, withDetachedReconnect, withUnifiedEvents };
+export { AgentAliasDependencyError, AgentAliasNotFoundError, AgentAliasRevisionMismatchError, AgentAliasRevisionRequiredError, AgentAliasesNamespace, AgentDeploymentsNamespace, AgentDriftError, AgentEnsureConflictError, AgentPromotionError, AgentVersionsEndpoint, AgentsEndpoint, AgentsNamespace, AnalyticsEndpoint, ApiKeyRequestsEndpoint, ApiKeysEndpoint, BatchBuilder, BatchesNamespace, BillingEndpoint, ChatEndpoint, ClientBatchBuilder, ClientEvalBuilder, ClientFlowBuilder, ClientTokenDriftError, ClientTokenEnsureError, ClientTokensEndpoint, ClientTokensNamespace, CollectionDriftError, CollectionEnsureConflictError, CollectionsEndpoint, ContextTemplatesEndpoint, ConversationsEndpoint, DEFAULT_MAX_DETACHED_RECONNECTS, DEFAULT_RECOVERY_AFTER_EMPTY_SESSIONS, DEFAULT_STALL_STOP_AFTER, DispatchEndpoint, ENSURE_RELEASE_DEPLOY_CONFLICT_MESSAGE, EvalBuilder, EvalDriftError, EvalEndpoint, EvalEnsureConflictError, EvalRunner, EvalSuitesNamespace, EvalsNamespace, ExecutionsEndpoint, ExecutionsNamespace, FlowBuilder, FlowDriftError, FlowEnsureConflictError, FlowResult, FlowStepsEndpoint, FlowVersionsEndpoint, FlowsEndpoint, FlowsNamespace, FpoDriftError, IntegrationsEndpoint, LEDGER_ARTIFACT_LINE_PREFIX, LIVE_AGENT_ALIAS, LogsEndpoint, ModelConfigsEndpoint, ProductDriftError, ProductEnsureConflictError, ProductsNamespace, PromptsEndpoint, PromptsNamespace, ProviderKeysEndpoint, QuestionSetDriftError, QuestionSetEnsureConflictError, QuestionSetsNamespace, RUNTYPE_CLIENT_KIND, RecordsEndpoint, RunsNamespace, Runtype, RuntypeApiError, RuntypeClient, RuntypeFlowBuilder, SDK_USER_AGENT, SDK_VERSION, STEP_FIELD_REGISTRY, STEP_TYPE_TO_METHOD, ScheduleDriftError, ScheduleEnsureConflictError, SchedulesEndpoint, SecretsEndpoint, SkillDriftError, SkillEnsureConflictError, SkillProposalsNamespace, SkillsNamespace, SurfaceDriftError, SurfaceEnsureConflictError, SurfacesEndpoint, SurfacesNamespace, ToolApprovalGrantsEndpoint, ToolDriftError, ToolEnsureConflictError, ToolsEndpoint, ToolsNamespace, TypedRecordsScope, UNIFIED_EVENTS_QUERY, UsersEndpoint, activateAgentPromotion, agentAliasErrorCode, applyGeneratedRuntimeToolProposalToDispatchRequest, attachRuntimeToolsToDispatchRequest, buildAgentAdmissionHeaders, buildEmptySessionNudge, buildExecutionEventsPath, buildGeneratedRuntimeToolGateOutput, buildLedgerOffloadReference, buildObservationMaskMarker, buildPolicyGuidance, buildSendViewOffloadMarker, calledTool, combineAbortSignals, compileWorkflowConfig, completed, computeAgentContentHash, computeEvalContentHash, computeFlowContentHash, computeFpoContentHash, computeProductContentHash, computeQuestionSetContentHash, computeRecordCollectionContentHash, computeScheduleContentHash, computeScheduleDefinitionHash, computeSkillContentHash, computeSurfaceContentHash, computeToolContentHash, contains, cost, createAgentEventTranslator, createClient, createExternalTool, createFlowEventTranslator, defaultWorkflow, defaultWorkflowConfig, defineAgent, defineEval, defineFlow, defineFpo, definePlaybook, defineProduct, defineQuestionSet, defineSchedule, defineSkill, defineSurface, defineTool, deployWorkflow, ensureDefaultWorkflowHooks, ensureEval, ensureFpo, ensureSchedule, evaluateGeneratedRuntimeToolProposal, extractDeclaredToolResultChars, fpoPlanHasDrift, gameWorkflow, getDefaultPlanPath, getLikelySupportingCandidatePaths, interpolateWorkflowTemplate, isBuiltinToolExecuteResponse, isCatalogClientToolRef, isDiscoveryToolName, isMarathonArtifactPath, isPreservationSensitiveTask, isUnifiedEventType, isWorkflowHookRef, jsonField, judge, judges, latency, length, listWorkflowHooks, matchesExpected, maxToolCalls, noError, normalizeAgentDefinition, normalizeCandidatePath, normalizeFpoDefinition, normalizeProductDefinition, normalizeQuestionSetDefinition, normalizeRecordCollectionDefinition, normalizeScheduleContent, normalizeSkillDefinition, normalizeSurfaceDefinition, normalizeToolDefinition, notCalledTool, notContains, parseFinalBuffer, parseLedgerArtifactRelativePath, parseOffloadedOutputId, parseSSEChunk, prepareAgentPromotion, processStream, promoteAgent, promotionIdempotencyKey, pullEval, pullFpo, pullSchedule, ranStep, regex, registerWorkflowHook, resolveStallStopAfter, resolveWorkflowHook, runEvalSuite, sanitizeTaskSlug, shouldInjectEmptySessionNudge, shouldRequestModelEscalation, stepOrder, streamEvents, toolOrder, unregisterWorkflowHook, usedNoTools, validJson, validateAgentPromotion, withDetachedReconnect, withUnifiedEvents };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runtypelabs/sdk",
-  "version": "10.9.0",
+  "version": "10.11.0",
   "type": "module",
   "description": "TypeScript SDK for the Runtype API with fluent methods. Use it to quickly realize AI products, agents, and workflows.",
   "main": "dist/index.cjs",
@@ -24,7 +24,7 @@
   ],
   "dependencies": {},
   "devDependencies": {
-    "@runtypelabs/shared": "3.69.0",
+    "@runtypelabs/shared": "3.71.0",
     "openapi-typescript": "^7.13.0",
     "tsdown": "^0.23.0",
     "typescript": "^6.0.3",