@archastro/sdk 0.20.0 → 0.21.0

package/dist/types/common.d.ts

@@ -4,6 +4,22 @@ import type { Config } from "./config.js";
 import type { ImageSource } from "./image.js";
 import type { User } from "./users.js";
 import type { WorkflowJournal, WorkflowJournalEntry } from "./workflows.js";
+/** The model declined to judge this question. */
+export interface Refusal {
+    id: string;
+    type: "refusal";
+}
+/** Runtime validator for {@link Refusal}. */
+export declare const refusalSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"refusal">;
+}, "strip", z.ZodTypeAny, {
+    type: "refusal";
+    id: string;
+}, {
+    type: "refusal";
+    id: string;
+}>;
 /** A single access-control grant that pairs a principal with the set of actions it is allowed to perform. */
 export interface AclGrant {
     /** Array of action strings the principal is permitted to perform, e.g. `["read", "write"]`. Must contain at least one entry. */
@@ -4932,6 +4948,82 @@ export declare const installedConfigEntrySchema: z.ZodObject<{
     id: string;
     lookup_key?: string | null | undefined;
 }>;
+/** Approval policy, excluding user IDs. */
+export interface Approvers {
+    mode: string;
+}
+/** Runtime validator for {@link Approvers}. */
+export declare const approversSchema: z.ZodObject<{
+    mode: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    mode: string;
+}, {
+    mode: string;
+}>;
+/** Origin references. */
+export interface Origin {
+    routine_id?: string | null | undefined;
+    session_id?: string | null | undefined;
+    thread_id?: string | null | undefined;
+}
+/** Runtime validator for {@link Origin}. */
+export declare const originSchema: z.ZodObject<{
+    routine_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    session_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    thread_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    routine_id?: string | null | undefined;
+    session_id?: string | null | undefined;
+    thread_id?: string | null | undefined;
+}, {
+    routine_id?: string | null | undefined;
+    session_id?: string | null | undefined;
+    thread_id?: string | null | undefined;
+}>;
+/** Question request payload. */
+export interface Payload {
+    question: string;
+}
+/** Runtime validator for {@link Payload}. */
+export declare const payloadSchema: z.ZodObject<{
+    question: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    question: string;
+}, {
+    question: string;
+}>;
+/** Answer or rejection reason; null before resolution. */
+export interface Resolution {
+    answer?: string | undefined;
+    reason?: string | undefined;
+}
+/** Runtime validator for {@link Resolution}. */
+export declare const resolutionSchema: z.ZodObject<{
+    answer: z.ZodOptional<z.ZodString>;
+    reason: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    answer?: string | undefined;
+    reason?: string | undefined;
+}, {
+    answer?: string | undefined;
+    reason?: string | undefined;
+}>;
+/** Kind-provided summary. */
+export interface Summary {
+    lines: string[];
+    title: string;
+}
+/** Runtime validator for {@link Summary}. */
+export declare const summarySchema: z.ZodObject<{
+    lines: z.ZodArray<z.ZodString, "many">;
+    title: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    lines: string[];
+}, {
+    title: string;
+    lines: string[];
+}>;
 /** Controls visibility and canonical recipient selection for routine-emitted messages. */
 export interface MessagePolicy {
     /** Required and non-empty for private visibility. Sources are additive. Routine owner includes the agent owner and optional user co-owner. */
@@ -5059,20 +5151,24 @@ export declare const setupSchema: z.ZodObject<{
     /** Reason for the current MCP setup state. */
     reason: z.ZodString;
 }, "strip", z.ZodTypeAny, {
+    reason: string;
     next_action: string;
     protocol_status: "not_checked";
-    reason: string;
 }, {
+    reason: string;
     next_action: string;
     protocol_status: "not_checked";
-    reason: string;
 }>;
 /** A processed variant of a media item, such as the original upload or a resized thumbnail, including a signed download URL resolved at request time. */
 export interface MediaVariant {
+    /** Size of the stored bytes. */
+    byte_size?: number | null | undefined;
     /** MIME type of this variant's file (e.g., `"image/jpeg"`, `"video/mp4"`). `null` if the file is not loaded. */
     content_type?: string | null | undefined;
     /** When this variant was created (ISO 8601). */
     created_at?: string | undefined;
+    /** Client-declared video duration in milliseconds; not server-probed. */
+    duration_ms?: number | null | undefined;
     /** ID of the underlying storage file that backs this variant (`fil_...`). */
     file?: string | undefined;
     /** Original filename of the uploaded file for this variant. `null` if the file is not loaded. */
@@ -5083,10 +5179,14 @@ export interface MediaVariant {
     id: string;
     /** Resolved image delivery metadata for this variant, including dimensions and CDN URL. `null` for non-image content types. */
     image_source?: ImageSource | null | undefined;
+    /** Lowercase SHA-256 of the stored bytes. */
+    sha256?: string | null | undefined;
     /** When this variant was last updated (ISO 8601). */
     updated_at?: string | undefined;
     /** Signed download URL for this variant, resolved at request time. `null` if the file is unavailable. */
     url?: string | null | undefined;
+    /** Expiry of this variant's playable URL. */
+    url_expires_at?: string | null | undefined;
     /** Identifier for this variant's processing tier. Common values include `"original"` (the unmodified upload) and `"thumbnail"` (a resized preview). */
     variant_key?: string | undefined;
     /** Width of this variant in pixels. `null` if not recorded. */
@@ -5094,10 +5194,14 @@ export interface MediaVariant {
 }
 /** Runtime validator for {@link MediaVariant}. */
 export declare const mediaVariantSchema: z.ZodObject<{
+    /** Size of the stored bytes. */
+    byte_size: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     /** MIME type of this variant's file (e.g., `"image/jpeg"`, `"video/mp4"`). `null` if the file is not loaded. */
     content_type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     /** When this variant was created (ISO 8601). */
     created_at: z.ZodOptional<z.ZodString>;
+    /** Client-declared video duration in milliseconds; not server-probed. */
+    duration_ms: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     /** ID of the underlying storage file that backs this variant (`fil_...`). */
     file: z.ZodOptional<z.ZodString>;
     /** Original filename of the uploaded file for this variant. `null` if the file is not loaded. */
@@ -5132,10 +5236,14 @@ export declare const mediaVariantSchema: z.ZodObject<{
         url?: string | null | undefined;
         width?: number | null | undefined;
     }>>>;
+    /** Lowercase SHA-256 of the stored bytes. */
+    sha256: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     /** When this variant was last updated (ISO 8601). */
     updated_at: z.ZodOptional<z.ZodString>;
     /** Signed download URL for this variant, resolved at request time. `null` if the file is unavailable. */
     url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** Expiry of this variant's playable URL. */
+    url_expires_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     /** Identifier for this variant's processing tier. Common values include `"original"` (the unmodified upload) and `"thumbnail"` (a resized preview). */
     variant_key: z.ZodOptional<z.ZodString>;
     /** Width of this variant in pixels. `null` if not recorded. */
@@ -5148,7 +5256,9 @@ export declare const mediaVariantSchema: z.ZodObject<{
     height?: number | null | undefined;
     url?: string | null | undefined;
     width?: number | null | undefined;
+    byte_size?: number | null | undefined;
     content_type?: string | null | undefined;
+    duration_ms?: number | null | undefined;
     filename?: string | null | undefined;
     image_source?: {
         mime_type?: string | null | undefined;
@@ -5159,6 +5269,8 @@ export declare const mediaVariantSchema: z.ZodObject<{
         url?: string | null | undefined;
         width?: number | null | undefined;
     } | null | undefined;
+    sha256?: string | null | undefined;
+    url_expires_at?: string | null | undefined;
     variant_key?: string | undefined;
 }, {
     id: string;
@@ -5168,7 +5280,9 @@ export declare const mediaVariantSchema: z.ZodObject<{
     height?: number | null | undefined;
     url?: string | null | undefined;
     width?: number | null | undefined;
+    byte_size?: number | null | undefined;
     content_type?: string | null | undefined;
+    duration_ms?: number | null | undefined;
     filename?: string | null | undefined;
     image_source?: {
         mime_type?: string | null | undefined;
@@ -5179,6 +5293,8 @@ export declare const mediaVariantSchema: z.ZodObject<{
         url?: string | null | undefined;
         width?: number | null | undefined;
     } | null | undefined;
+    sha256?: string | null | undefined;
+    url_expires_at?: string | null | undefined;
     variant_key?: string | undefined;
 }>;
 /** A rich attachment associated with a message, such as a file, scraped link, artifact, task, media item, or inline action. */
@@ -5282,10 +5398,14 @@ export declare const attachmentSchema: z.ZodObject<{
     url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     /** Array of available encoding variants for the media item (e.g. different resolutions). Present on `media` type only; omitted otherwise. */
     variants: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        /** Size of the stored bytes. */
+        byte_size: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         /** MIME type of this variant's file (e.g., `"image/jpeg"`, `"video/mp4"`). `null` if the file is not loaded. */
         content_type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         /** When this variant was created (ISO 8601). */
         created_at: z.ZodOptional<z.ZodString>;
+        /** Client-declared video duration in milliseconds; not server-probed. */
+        duration_ms: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         /** ID of the underlying storage file that backs this variant (`fil_...`). */
         file: z.ZodOptional<z.ZodString>;
         /** Original filename of the uploaded file for this variant. `null` if the file is not loaded. */
@@ -5320,10 +5440,14 @@ export declare const attachmentSchema: z.ZodObject<{
             url?: string | null | undefined;
             width?: number | null | undefined;
         }>>>;
+        /** Lowercase SHA-256 of the stored bytes. */
+        sha256: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         /** When this variant was last updated (ISO 8601). */
         updated_at: z.ZodOptional<z.ZodString>;
         /** Signed download URL for this variant, resolved at request time. `null` if the file is unavailable. */
         url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Expiry of this variant's playable URL. */
+        url_expires_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         /** Identifier for this variant's processing tier. Common values include `"original"` (the unmodified upload) and `"thumbnail"` (a resized preview). */
         variant_key: z.ZodOptional<z.ZodString>;
         /** Width of this variant in pixels. `null` if not recorded. */
@@ -5336,7 +5460,9 @@ export declare const attachmentSchema: z.ZodObject<{
         height?: number | null | undefined;
         url?: string | null | undefined;
         width?: number | null | undefined;
+        byte_size?: number | null | undefined;
         content_type?: string | null | undefined;
+        duration_ms?: number | null | undefined;
         filename?: string | null | undefined;
         image_source?: {
             mime_type?: string | null | undefined;
@@ -5347,6 +5473,8 @@ export declare const attachmentSchema: z.ZodObject<{
             url?: string | null | undefined;
             width?: number | null | undefined;
         } | null | undefined;
+        sha256?: string | null | undefined;
+        url_expires_at?: string | null | undefined;
         variant_key?: string | undefined;
     }, {
         id: string;
@@ -5356,7 +5484,9 @@ export declare const attachmentSchema: z.ZodObject<{
         height?: number | null | undefined;
         url?: string | null | undefined;
         width?: number | null | undefined;
+        byte_size?: number | null | undefined;
         content_type?: string | null | undefined;
+        duration_ms?: number | null | undefined;
         filename?: string | null | undefined;
         image_source?: {
             mime_type?: string | null | undefined;
@@ -5367,6 +5497,8 @@ export declare const attachmentSchema: z.ZodObject<{
             url?: string | null | undefined;
             width?: number | null | undefined;
         } | null | undefined;
+        sha256?: string | null | undefined;
+        url_expires_at?: string | null | undefined;
         variant_key?: string | undefined;
     }>, "many">>;
     /** Version number of the attached artifact at the time of attachment. Present on `artifact` type only. `null` otherwise. */
@@ -5407,7 +5539,9 @@ export declare const attachmentSchema: z.ZodObject<{
         height?: number | null | undefined;
         url?: string | null | undefined;
         width?: number | null | undefined;
+        byte_size?: number | null | undefined;
         content_type?: string | null | undefined;
+        duration_ms?: number | null | undefined;
         filename?: string | null | undefined;
         image_source?: {
             mime_type?: string | null | undefined;
@@ -5418,6 +5552,8 @@ export declare const attachmentSchema: z.ZodObject<{
             url?: string | null | undefined;
             width?: number | null | undefined;
         } | null | undefined;
+        sha256?: string | null | undefined;
+        url_expires_at?: string | null | undefined;
         variant_key?: string | undefined;
     }[] | undefined;
     version?: number | null | undefined;
@@ -5455,7 +5591,9 @@ export declare const attachmentSchema: z.ZodObject<{
         height?: number | null | undefined;
         url?: string | null | undefined;
         width?: number | null | undefined;
+        byte_size?: number | null | undefined;
         content_type?: string | null | undefined;
+        duration_ms?: number | null | undefined;
         filename?: string | null | undefined;
         image_source?: {
             mime_type?: string | null | undefined;
@@ -5466,6 +5604,8 @@ export declare const attachmentSchema: z.ZodObject<{
             url?: string | null | undefined;
             width?: number | null | undefined;
         } | null | undefined;
+        sha256?: string | null | undefined;
+        url_expires_at?: string | null | undefined;
         variant_key?: string | undefined;
     }[] | undefined;
     version?: number | null | undefined;
@@ -6173,10 +6313,14 @@ export declare const messageSchema: z.ZodObject<{
         url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         /** Array of available encoding variants for the media item (e.g. different resolutions). Present on `media` type only; omitted otherwise. */
         variants: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            /** Size of the stored bytes. */
+            byte_size: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             /** MIME type of this variant's file (e.g., `"image/jpeg"`, `"video/mp4"`). `null` if the file is not loaded. */
             content_type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             /** When this variant was created (ISO 8601). */
             created_at: z.ZodOptional<z.ZodString>;
+            /** Client-declared video duration in milliseconds; not server-probed. */
+            duration_ms: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             /** ID of the underlying storage file that backs this variant (`fil_...`). */
             file: z.ZodOptional<z.ZodString>;
             /** Original filename of the uploaded file for this variant. `null` if the file is not loaded. */
@@ -6211,10 +6355,14 @@ export declare const messageSchema: z.ZodObject<{
                 url?: string | null | undefined;
                 width?: number | null | undefined;
             }>>>;
+            /** Lowercase SHA-256 of the stored bytes. */
+            sha256: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             /** When this variant was last updated (ISO 8601). */
             updated_at: z.ZodOptional<z.ZodString>;
             /** Signed download URL for this variant, resolved at request time. `null` if the file is unavailable. */
             url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            /** Expiry of this variant's playable URL. */
+            url_expires_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             /** Identifier for this variant's processing tier. Common values include `"original"` (the unmodified upload) and `"thumbnail"` (a resized preview). */
             variant_key: z.ZodOptional<z.ZodString>;
             /** Width of this variant in pixels. `null` if not recorded. */
@@ -6227,7 +6375,9 @@ export declare const messageSchema: z.ZodObject<{
             height?: number | null | undefined;
             url?: string | null | undefined;
             width?: number | null | undefined;
+            byte_size?: number | null | undefined;
             content_type?: string | null | undefined;
+            duration_ms?: number | null | undefined;
             filename?: string | null | undefined;
             image_source?: {
                 mime_type?: string | null | undefined;
@@ -6238,6 +6388,8 @@ export declare const messageSchema: z.ZodObject<{
                 url?: string | null | undefined;
                 width?: number | null | undefined;
             } | null | undefined;
+            sha256?: string | null | undefined;
+            url_expires_at?: string | null | undefined;
             variant_key?: string | undefined;
         }, {
             id: string;
@@ -6247,7 +6399,9 @@ export declare const messageSchema: z.ZodObject<{
             height?: number | null | undefined;
             url?: string | null | undefined;
             width?: number | null | undefined;
+            byte_size?: number | null | undefined;
             content_type?: string | null | undefined;
+            duration_ms?: number | null | undefined;
             filename?: string | null | undefined;
             image_source?: {
                 mime_type?: string | null | undefined;
@@ -6258,6 +6412,8 @@ export declare const messageSchema: z.ZodObject<{
                 url?: string | null | undefined;
                 width?: number | null | undefined;
             } | null | undefined;
+            sha256?: string | null | undefined;
+            url_expires_at?: string | null | undefined;
             variant_key?: string | undefined;
         }>, "many">>;
         /** Version number of the attached artifact at the time of attachment. Present on `artifact` type only. `null` otherwise. */
@@ -6298,7 +6454,9 @@ export declare const messageSchema: z.ZodObject<{
             height?: number | null | undefined;
             url?: string | null | undefined;
             width?: number | null | undefined;
+            byte_size?: number | null | undefined;
             content_type?: string | null | undefined;
+            duration_ms?: number | null | undefined;
             filename?: string | null | undefined;
             image_source?: {
                 mime_type?: string | null | undefined;
@@ -6309,6 +6467,8 @@ export declare const messageSchema: z.ZodObject<{
                 url?: string | null | undefined;
                 width?: number | null | undefined;
             } | null | undefined;
+            sha256?: string | null | undefined;
+            url_expires_at?: string | null | undefined;
             variant_key?: string | undefined;
         }[] | undefined;
         version?: number | null | undefined;
@@ -6346,7 +6506,9 @@ export declare const messageSchema: z.ZodObject<{
             height?: number | null | undefined;
             url?: string | null | undefined;
             width?: number | null | undefined;
+            byte_size?: number | null | undefined;
             content_type?: string | null | undefined;
+            duration_ms?: number | null | undefined;
             filename?: string | null | undefined;
             image_source?: {
                 mime_type?: string | null | undefined;
@@ -6357,6 +6519,8 @@ export declare const messageSchema: z.ZodObject<{
                 url?: string | null | undefined;
                 width?: number | null | undefined;
             } | null | undefined;
+            sha256?: string | null | undefined;
+            url_expires_at?: string | null | undefined;
             variant_key?: string | undefined;
         }[] | undefined;
         version?: number | null | undefined;
@@ -6587,7 +6751,9 @@ export declare const messageSchema: z.ZodObject<{
             height?: number | null | undefined;
             url?: string | null | undefined;
             width?: number | null | undefined;
+            byte_size?: number | null | undefined;
             content_type?: string | null | undefined;
+            duration_ms?: number | null | undefined;
             filename?: string | null | undefined;
             image_source?: {
                 mime_type?: string | null | undefined;
@@ -6598,6 +6764,8 @@ export declare const messageSchema: z.ZodObject<{
                 url?: string | null | undefined;
                 width?: number | null | undefined;
             } | null | undefined;
+            sha256?: string | null | undefined;
+            url_expires_at?: string | null | undefined;
             variant_key?: string | undefined;
         }[] | undefined;
         version?: number | null | undefined;
@@ -6723,7 +6891,9 @@ export declare const messageSchema: z.ZodObject<{
             height?: number | null | undefined;
             url?: string | null | undefined;
             width?: number | null | undefined;
+            byte_size?: number | null | undefined;
             content_type?: string | null | undefined;
+            duration_ms?: number | null | undefined;
             filename?: string | null | undefined;
             image_source?: {
                 mime_type?: string | null | undefined;
@@ -6734,6 +6904,8 @@ export declare const messageSchema: z.ZodObject<{
                 url?: string | null | undefined;
                 width?: number | null | undefined;
             } | null | undefined;
+            sha256?: string | null | undefined;
+            url_expires_at?: string | null | undefined;
             variant_key?: string | undefined;
         }[] | undefined;
         version?: number | null | undefined;
@@ -6842,26 +7014,6 @@ export declare const commandSchema: z.ZodObject<{
     expectedInput?: Record<string, {} | null> | undefined;
     successOutput?: Record<string, {} | null> | undefined;
 }>;
-/** The result of executing a shell command on an agent's computer environment. Contains the captured output and the process exit code. */
-export interface ComputerExecResult {
-    /** The UNIX exit code returned by the process. `0` indicates success; any non-zero value indicates an error. `null` if the process did not terminate normally. */
-    exit_code?: number | undefined;
-    /** The combined stdout and stderr output produced by the command. `null` if the command produced no output. */
-    output?: string | undefined;
-}
-/** Runtime validator for {@link ComputerExecResult}. */
-export declare const computerExecResultSchema: z.ZodObject<{
-    /** The UNIX exit code returned by the process. `0` indicates success; any non-zero value indicates an error. `null` if the process did not terminate normally. */
-    exit_code: z.ZodOptional<z.ZodNumber>;
-    /** The combined stdout and stderr output produced by the command. `null` if the command produced no output. */
-    output: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    exit_code?: number | undefined;
-    output?: string | undefined;
-}, {
-    exit_code?: number | undefined;
-    output?: string | undefined;
-}>;
 /** A context document stored within a context source. Carries metadata and size information only; retrieve the full text content via the `/content` endpoint. */
 export interface ContextDocument {
     /** ID of the agent that owns this document (`agi_...`). `null` if owned by a user or team. */
@@ -7228,12 +7380,20 @@ export interface EffectiveAccessEntitlement {
     granted: boolean;
     /** Stable entitlement catalog key. */
     key: string;
+    /** Unexpired metered allowance, including exhausted grants; null for boolean entitlements. */
+    limit?: number | null | undefined;
     /** Privacy-safe principal kinds that contribute to the effective value. */
     provided_by: ("personal" | "organization")[];
+    /** Effective purchased quantity from the recurring terms linked to this key (for example seats), summed across granting principals. `null` when the key is not granted or no granting plan links a term to it. */
+    quantity?: number | null | undefined;
+    /** Remaining metered allowance credits; null for boolean entitlements. */
+    remaining?: number | null | undefined;
+    /** Signed metered consumption in the allowance window; may be negative after reversals. Null for boolean entitlements. */
+    used?: number | null | undefined;
     /** Merged entitlement value, or `null` when the key is not granted. */
     value?: boolean | null | undefined;
     /** Catalog type used to interpret `value`. */
-    value_type: "boolean";
+    value_type: "boolean" | "metered";
 }
 /** Runtime validator for {@link EffectiveAccessEntitlement}. */
 export declare const effectiveAccessEntitlementSchema: z.ZodObject<{
@@ -7241,24 +7401,40 @@ export declare const effectiveAccessEntitlementSchema: z.ZodObject<{
     granted: z.ZodBoolean;
     /** Stable entitlement catalog key. */
     key: z.ZodString;
+    /** Unexpired metered allowance, including exhausted grants; null for boolean entitlements. */
+    limit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     /** Privacy-safe principal kinds that contribute to the effective value. */
     provided_by: z.ZodArray<z.ZodEnum<["personal", "organization"]>, "many">;
+    /** Effective purchased quantity from the recurring terms linked to this key (for example seats), summed across granting principals. `null` when the key is not granted or no granting plan links a term to it. */
+    quantity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    /** Remaining metered allowance credits; null for boolean entitlements. */
+    remaining: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    /** Signed metered consumption in the allowance window; may be negative after reversals. Null for boolean entitlements. */
+    used: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     /** Merged entitlement value, or `null` when the key is not granted. */
     value: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     /** Catalog type used to interpret `value`. */
-    value_type: z.ZodLiteral<"boolean">;
+    value_type: z.ZodEnum<["boolean", "metered"]>;
 }, "strip", z.ZodTypeAny, {
     key: string;
     granted: boolean;
     provided_by: ("personal" | "organization")[];
-    value_type: "boolean";
+    value_type: "boolean" | "metered";
     value?: boolean | null | undefined;
+    limit?: number | null | undefined;
+    quantity?: number | null | undefined;
+    remaining?: number | null | undefined;
+    used?: number | null | undefined;
 }, {
     key: string;
     granted: boolean;
     provided_by: ("personal" | "organization")[];
-    value_type: "boolean";
+    value_type: "boolean" | "metered";
     value?: boolean | null | undefined;
+    limit?: number | null | undefined;
+    quantity?: number | null | undefined;
+    remaining?: number | null | undefined;
+    used?: number | null | undefined;
 }>;
 /** Live effective access, billing authority, and relevant trials for the authenticated user. */
 export interface EffectiveAccess {
@@ -7314,24 +7490,40 @@ export declare const effectiveAccessSchema: z.ZodObject<{
         granted: z.ZodBoolean;
         /** Stable entitlement catalog key. */
         key: z.ZodString;
+        /** Unexpired metered allowance, including exhausted grants; null for boolean entitlements. */
+        limit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         /** Privacy-safe principal kinds that contribute to the effective value. */
         provided_by: z.ZodArray<z.ZodEnum<["personal", "organization"]>, "many">;
+        /** Effective purchased quantity from the recurring terms linked to this key (for example seats), summed across granting principals. `null` when the key is not granted or no granting plan links a term to it. */
+        quantity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        /** Remaining metered allowance credits; null for boolean entitlements. */
+        remaining: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        /** Signed metered consumption in the allowance window; may be negative after reversals. Null for boolean entitlements. */
+        used: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         /** Merged entitlement value, or `null` when the key is not granted. */
         value: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         /** Catalog type used to interpret `value`. */
-        value_type: z.ZodLiteral<"boolean">;
+        value_type: z.ZodEnum<["boolean", "metered"]>;
     }, "strip", z.ZodTypeAny, {
         key: string;
         granted: boolean;
         provided_by: ("personal" | "organization")[];
-        value_type: "boolean";
+        value_type: "boolean" | "metered";
         value?: boolean | null | undefined;
+        limit?: number | null | undefined;
+        quantity?: number | null | undefined;
+        remaining?: number | null | undefined;
+        used?: number | null | undefined;
     }, {
         key: string;
         granted: boolean;
         provided_by: ("personal" | "organization")[];
-        value_type: "boolean";
+        value_type: "boolean" | "metered";
         value?: boolean | null | undefined;
+        limit?: number | null | undefined;
+        quantity?: number | null | undefined;
+        remaining?: number | null | undefined;
+        used?: number | null | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     billing: {
@@ -7347,8 +7539,12 @@ export declare const effectiveAccessSchema: z.ZodObject<{
         key: string;
         granted: boolean;
         provided_by: ("personal" | "organization")[];
-        value_type: "boolean";
+        value_type: "boolean" | "metered";
         value?: boolean | null | undefined;
+        limit?: number | null | undefined;
+        quantity?: number | null | undefined;
+        remaining?: number | null | undefined;
+        used?: number | null | undefined;
     }[];
 }, {
     billing: {
@@ -7364,8 +7560,12 @@ export declare const effectiveAccessSchema: z.ZodObject<{
         key: string;
         granted: boolean;
         provided_by: ("personal" | "organization")[];
-        value_type: "boolean";
+        value_type: "boolean" | "metered";
         value?: boolean | null | undefined;
+        limit?: number | null | undefined;
+        quantity?: number | null | undefined;
+        remaining?: number | null | undefined;
+        used?: number | null | undefined;
     }[];
 }>;
 /** The authenticated user's profile, live session context, and optional effective access. */
@@ -7390,6 +7590,8 @@ export interface CurrentUser {
     name?: string | null | undefined;
     /** The authenticated user's notification preferences. */
     notification_settings: Record<string, unknown>;
+    /** Registered display name of the verified OAuth client, when available. Not a verified vendor identity. */
+    oauth_client_name?: string | undefined;
     /** ID of the current organization (`org_...`). */
     org?: string | null | undefined;
     /** Whether the current organization is company-domain or person-owned. */
@@ -7464,24 +7666,40 @@ export declare const currentUserSchema: z.ZodObject<{
             granted: z.ZodBoolean;
             /** Stable entitlement catalog key. */
             key: z.ZodString;
+            /** Unexpired metered allowance, including exhausted grants; null for boolean entitlements. */
+            limit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             /** Privacy-safe principal kinds that contribute to the effective value. */
             provided_by: z.ZodArray<z.ZodEnum<["personal", "organization"]>, "many">;
+            /** Effective purchased quantity from the recurring terms linked to this key (for example seats), summed across granting principals. `null` when the key is not granted or no granting plan links a term to it. */
+            quantity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            /** Remaining metered allowance credits; null for boolean entitlements. */
+            remaining: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            /** Signed metered consumption in the allowance window; may be negative after reversals. Null for boolean entitlements. */
+            used: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             /** Merged entitlement value, or `null` when the key is not granted. */
             value: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
             /** Catalog type used to interpret `value`. */
-            value_type: z.ZodLiteral<"boolean">;
+            value_type: z.ZodEnum<["boolean", "metered"]>;
         }, "strip", z.ZodTypeAny, {
             key: string;
             granted: boolean;
             provided_by: ("personal" | "organization")[];
-            value_type: "boolean";
+            value_type: "boolean" | "metered";
             value?: boolean | null | undefined;
+            limit?: number | null | undefined;
+            quantity?: number | null | undefined;
+            remaining?: number | null | undefined;
+            used?: number | null | undefined;
         }, {
             key: string;
             granted: boolean;
             provided_by: ("personal" | "organization")[];
-            value_type: "boolean";
+            value_type: "boolean" | "metered";
             value?: boolean | null | undefined;
+            limit?: number | null | undefined;
+            quantity?: number | null | undefined;
+            remaining?: number | null | undefined;
+            used?: number | null | undefined;
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
         billing: {
@@ -7497,8 +7715,12 @@ export declare const currentUserSchema: z.ZodObject<{
             key: string;
             granted: boolean;
             provided_by: ("personal" | "organization")[];
-            value_type: "boolean";
+            value_type: "boolean" | "metered";
             value?: boolean | null | undefined;
+            limit?: number | null | undefined;
+            quantity?: number | null | undefined;
+            remaining?: number | null | undefined;
+            used?: number | null | undefined;
         }[];
     }, {
         billing: {
@@ -7514,8 +7736,12 @@ export declare const currentUserSchema: z.ZodObject<{
             key: string;
             granted: boolean;
             provided_by: ("personal" | "organization")[];
-            value_type: "boolean";
+            value_type: "boolean" | "metered";
             value?: boolean | null | undefined;
+            limit?: number | null | undefined;
+            quantity?: number | null | undefined;
+            remaining?: number | null | undefined;
+            used?: number | null | undefined;
         }[];
     }>>;
     /** Email address of the user. */
@@ -7530,6 +7756,8 @@ export declare const currentUserSchema: z.ZodObject<{
     name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     /** The authenticated user's notification preferences. */
     notification_settings: z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>;
+    /** Registered display name of the verified OAuth client, when available. Not a verified vendor identity. */
+    oauth_client_name: z.ZodOptional<z.ZodString>;
     /** ID of the current organization (`org_...`). */
     org: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     /** Whether the current organization is company-domain or person-owned. */
@@ -7612,10 +7840,15 @@ export declare const currentUserSchema: z.ZodObject<{
             key: string;
             granted: boolean;
             provided_by: ("personal" | "organization")[];
-            value_type: "boolean";
+            value_type: "boolean" | "metered";
             value?: boolean | null | undefined;
+            limit?: number | null | undefined;
+            quantity?: number | null | undefined;
+            remaining?: number | null | undefined;
+            used?: number | null | undefined;
         }[];
     } | undefined;
+    oauth_client_name?: string | undefined;
     org_kind?: "personal" | "company" | null | undefined;
 }, {
     id: string;
@@ -7657,18 +7890,27 @@ export declare const currentUserSchema: z.ZodObject<{
             key: string;
             granted: boolean;
             provided_by: ("personal" | "organization")[];
-            value_type: "boolean";
+            value_type: "boolean" | "metered";
             value?: boolean | null | undefined;
+            limit?: number | null | undefined;
+            quantity?: number | null | undefined;
+            remaining?: number | null | undefined;
+            used?: number | null | undefined;
         }[];
     } | undefined;
+    oauth_client_name?: string | undefined;
     org_kind?: "personal" | "company" | null | undefined;
 }>;
 /** A custom object belonging to an organization. Custom objects store arbitrary structured data defined by a schema type and are scoped to an org, team, or user. */
 export interface CustomObject {
     /** Access control list governing read and write access to this custom object. Only returned to resource owners and privileged or organization-admin viewers; `null` for everyone else. */
     acl?: Acl | undefined;
+    /** ID of the agent that owns this object (`agt_...`). `null` for other ownership types. */
+    agent?: string | undefined;
     /** When the custom object was created (ISO 8601). */
     created_at?: string | undefined;
+    /** Absolute expiry time (RFC 3339). Null when no expiry is set. */
+    expires_at?: string | null | undefined;
     /** Map of field names to their current values as defined by the object's schema type. */
     fields?: Record<string, unknown> | undefined;
     /** Unique identifier for the custom object (`cobj_...`). */
@@ -7772,8 +8014,12 @@ export declare const customObjectSchema: z.ZodObject<{
             principal?: string | undefined;
         }[] | undefined;
     }>>;
+    /** ID of the agent that owns this object (`agt_...`). `null` for other ownership types. */
+    agent: z.ZodOptional<z.ZodString>;
     /** When the custom object was created (ISO 8601). */
     created_at: z.ZodOptional<z.ZodString>;
+    /** Absolute expiry time (RFC 3339). Null when no expiry is set. */
+    expires_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     /** Map of field names to their current values as defined by the object's schema type. */
     fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>>;
     /** Unique identifier for the custom object (`cobj_...`). */
@@ -7798,6 +8044,7 @@ export declare const customObjectSchema: z.ZodObject<{
     id: string;
     user?: string | undefined;
     org?: string | undefined;
+    agent?: string | undefined;
     team?: string | undefined;
     created_at?: string | undefined;
     updated_at?: string | undefined;
@@ -7819,6 +8066,7 @@ export declare const customObjectSchema: z.ZodObject<{
         }[] | undefined;
     } | undefined;
     version?: number | undefined;
+    expires_at?: string | null | undefined;
     fields?: Record<string, {} | null> | undefined;
     row_key?: string | undefined;
     schema_type?: string | undefined;
@@ -7826,6 +8074,7 @@ export declare const customObjectSchema: z.ZodObject<{
     id: string;
     user?: string | undefined;
     org?: string | undefined;
+    agent?: string | undefined;
     team?: string | undefined;
     created_at?: string | undefined;
     updated_at?: string | undefined;
@@ -7847,6 +8096,7 @@ export declare const customObjectSchema: z.ZodObject<{
         }[] | undefined;
     } | undefined;
     version?: number | undefined;
+    expires_at?: string | null | undefined;
     fields?: Record<string, {} | null> | undefined;
     row_key?: string | undefined;
     schema_type?: string | undefined;
@@ -7901,10 +8151,10 @@ export interface CustomObjectListResponse {
     page: number;
     /** Maximum number of results returned per page. */
     page_size: number;
-    /** Total number of custom objects matching the query across all pages. */
-    total_entries: number;
-    /** Total number of pages available for the current query. */
-    total_pages: number;
+    /** Total number of custom objects matching the query across all pages; null when include_count is false. */
+    total_entries: number | null;
+    /** Total number of pages available for the current query; null when include_count is false. */
+    total_pages: number | null;
 }
 /** Runtime validator for {@link CustomObjectListResponse}. */
 export declare const customObjectListResponseSchema: z.ZodObject<{
@@ -7990,8 +8240,12 @@ export declare const customObjectListResponseSchema: z.ZodObject<{
                 principal?: string | undefined;
             }[] | undefined;
         }>>;
+        /** ID of the agent that owns this object (`agt_...`). `null` for other ownership types. */
+        agent: z.ZodOptional<z.ZodString>;
         /** When the custom object was created (ISO 8601). */
         created_at: z.ZodOptional<z.ZodString>;
+        /** Absolute expiry time (RFC 3339). Null when no expiry is set. */
+        expires_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         /** Map of field names to their current values as defined by the object's schema type. */
         fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>>;
         /** Unique identifier for the custom object (`cobj_...`). */
@@ -8016,6 +8270,7 @@ export declare const customObjectListResponseSchema: z.ZodObject<{
         id: string;
         user?: string | undefined;
         org?: string | undefined;
+        agent?: string | undefined;
         team?: string | undefined;
         created_at?: string | undefined;
         updated_at?: string | undefined;
@@ -8037,6 +8292,7 @@ export declare const customObjectListResponseSchema: z.ZodObject<{
             }[] | undefined;
         } | undefined;
         version?: number | undefined;
+        expires_at?: string | null | undefined;
         fields?: Record<string, {} | null> | undefined;
         row_key?: string | undefined;
         schema_type?: string | undefined;
@@ -8044,6 +8300,7 @@ export declare const customObjectListResponseSchema: z.ZodObject<{
         id: string;
         user?: string | undefined;
         org?: string | undefined;
+        agent?: string | undefined;
         team?: string | undefined;
         created_at?: string | undefined;
         updated_at?: string | undefined;
@@ -8065,6 +8322,7 @@ export declare const customObjectListResponseSchema: z.ZodObject<{
             }[] | undefined;
         } | undefined;
         version?: number | undefined;
+        expires_at?: string | null | undefined;
         fields?: Record<string, {} | null> | undefined;
         row_key?: string | undefined;
         schema_type?: string | undefined;
@@ -8077,15 +8335,16 @@ export declare const customObjectListResponseSchema: z.ZodObject<{
     page: z.ZodNumber;
     /** Maximum number of results returned per page. */
     page_size: z.ZodNumber;
-    /** Total number of custom objects matching the query across all pages. */
-    total_entries: z.ZodNumber;
-    /** Total number of pages available for the current query. */
-    total_pages: z.ZodNumber;
+    /** Total number of custom objects matching the query across all pages; null when include_count is false. */
+    total_entries: z.ZodNullable<z.ZodNumber>;
+    /** Total number of pages available for the current query; null when include_count is false. */
+    total_pages: z.ZodNullable<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     data: {
         id: string;
         user?: string | undefined;
         org?: string | undefined;
+        agent?: string | undefined;
         team?: string | undefined;
         created_at?: string | undefined;
         updated_at?: string | undefined;
@@ -8107,6 +8366,7 @@ export declare const customObjectListResponseSchema: z.ZodObject<{
             }[] | undefined;
         } | undefined;
         version?: number | undefined;
+        expires_at?: string | null | undefined;
         fields?: Record<string, {} | null> | undefined;
         row_key?: string | undefined;
         schema_type?: string | undefined;
@@ -8115,13 +8375,14 @@ export declare const customObjectListResponseSchema: z.ZodObject<{
     has_prev: boolean;
     page: number;
     page_size: number;
-    total_entries: number;
-    total_pages: number;
+    total_entries: number | null;
+    total_pages: number | null;
 }, {
     data: {
         id: string;
         user?: string | undefined;
         org?: string | undefined;
+        agent?: string | undefined;
         team?: string | undefined;
         created_at?: string | undefined;
         updated_at?: string | undefined;
@@ -8143,6 +8404,7 @@ export declare const customObjectListResponseSchema: z.ZodObject<{
             }[] | undefined;
         } | undefined;
         version?: number | undefined;
+        expires_at?: string | null | undefined;
         fields?: Record<string, {} | null> | undefined;
         row_key?: string | undefined;
         schema_type?: string | undefined;
@@ -8151,8 +8413,8 @@ export declare const customObjectListResponseSchema: z.ZodObject<{
     has_prev: boolean;
     page: number;
     page_size: number;
-    total_entries: number;
-    total_pages: number;
+    total_entries: number | null;
+    total_pages: number | null;
 }>;
 /** Acknowledges an ephemeral custom-object presence update. */
 export interface CustomObjectPresenceAck {
@@ -9324,54 +9586,86 @@ export declare const installationSourceListResponseSchema: z.ZodObject<{
         parent_source?: string | undefined;
     }[];
 }>;
-/** A single key-value storage entry belonging to a user. Represents one key/value pair written to a user's isolated storage namespace within an app. */
+/** An owner-scoped key/value pair within an app, optionally expiring. */
 export interface KeyValueStorageEntry {
+    /** Agent owner, if any. */
+    agent?: string | undefined;
     /** When this storage entry was first created (ISO 8601). `null` if not yet persisted. */
     created_at?: string | undefined;
+    /** Expiry deadline, or null for entries without expiry. */
+    expires_at?: string | undefined;
     /** The string key used to store and look up this entry. */
     key: string;
+    /** Organization scope. */
+    org?: string | undefined;
+    /** Team owner, if any. */
+    team?: string | undefined;
     /** When this storage entry was last updated (ISO 8601). `null` if not yet persisted. */
     updated_at?: string | undefined;
-    /** ID of the user who owns this storage entry (`usr_...`). */
-    user: string;
+    /** ID of the user owner, or null for non-user ownership. */
+    user?: string | undefined;
     /** The string value stored under `key` for this user. */
     value: string;
 }
 /** Runtime validator for {@link KeyValueStorageEntry}. */
 export declare const keyValueStorageEntrySchema: z.ZodObject<{
+    /** Agent owner, if any. */
+    agent: z.ZodOptional<z.ZodString>;
     /** When this storage entry was first created (ISO 8601). `null` if not yet persisted. */
     created_at: z.ZodOptional<z.ZodString>;
+    /** Expiry deadline, or null for entries without expiry. */
+    expires_at: z.ZodOptional<z.ZodString>;
     /** The string key used to store and look up this entry. */
     key: z.ZodString;
+    /** Organization scope. */
+    org: z.ZodOptional<z.ZodString>;
+    /** Team owner, if any. */
+    team: z.ZodOptional<z.ZodString>;
     /** When this storage entry was last updated (ISO 8601). `null` if not yet persisted. */
     updated_at: z.ZodOptional<z.ZodString>;
-    /** ID of the user who owns this storage entry (`usr_...`). */
-    user: z.ZodString;
+    /** ID of the user owner, or null for non-user ownership. */
+    user: z.ZodOptional<z.ZodString>;
     /** The string value stored under `key` for this user. */
     value: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     value: string;
     key: string;
-    user: string;
+    user?: string | undefined;
+    org?: string | undefined;
+    agent?: string | undefined;
+    team?: string | undefined;
     created_at?: string | undefined;
     updated_at?: string | undefined;
+    expires_at?: string | undefined;
 }, {
     value: string;
     key: string;
-    user: string;
+    user?: string | undefined;
+    org?: string | undefined;
+    agent?: string | undefined;
+    team?: string | undefined;
     created_at?: string | undefined;
     updated_at?: string | undefined;
+    expires_at?: string | undefined;
 }>;
 /** A key-value storage entry enriched with owner information. Developer and server-to-server callers receive `user_email` and `user_name` populated; end-user (user-JWT) callers receive those fields as `null`. */
 export interface KeyValueStorageEntryWithUser {
+    /** Agent owner, if any. */
+    agent?: string | undefined;
     /** When this storage entry was first created (ISO 8601). */
     created_at: string;
+    /** Expiry deadline, or null for entries without expiry. */
+    expires_at?: string | undefined;
     /** The string key used to store and look up this entry. */
     key: string;
+    /** Organization scope. */
+    org?: string | undefined;
+    /** Team owner, if any. */
+    team?: string | undefined;
     /** When this storage entry was last updated (ISO 8601). */
     updated_at: string;
-    /** ID of the user who owns this storage entry (`usr_...`). */
-    user: string;
+    /** ID of the user owner, or null for non-user ownership. */
+    user?: string | undefined;
     /** Email address of the owning user. `null` for end-user (user-JWT) callers; populated for developer and server-to-server callers. */
     user_email?: string | undefined;
     /** Display name of the owning user. `null` for end-user (user-JWT) callers; populated for developer and server-to-server callers. */
@@ -9381,14 +9675,22 @@ export interface KeyValueStorageEntryWithUser {
 }
 /** Runtime validator for {@link KeyValueStorageEntryWithUser}. */
 export declare const keyValueStorageEntryWithUserSchema: z.ZodObject<{
+    /** Agent owner, if any. */
+    agent: z.ZodOptional<z.ZodString>;
     /** When this storage entry was first created (ISO 8601). */
     created_at: z.ZodString;
+    /** Expiry deadline, or null for entries without expiry. */
+    expires_at: z.ZodOptional<z.ZodString>;
     /** The string key used to store and look up this entry. */
     key: z.ZodString;
+    /** Organization scope. */
+    org: z.ZodOptional<z.ZodString>;
+    /** Team owner, if any. */
+    team: z.ZodOptional<z.ZodString>;
     /** When this storage entry was last updated (ISO 8601). */
     updated_at: z.ZodString;
-    /** ID of the user who owns this storage entry (`usr_...`). */
-    user: z.ZodString;
+    /** ID of the user owner, or null for non-user ownership. */
+    user: z.ZodOptional<z.ZodString>;
     /** Email address of the owning user. `null` for end-user (user-JWT) callers; populated for developer and server-to-server callers. */
     user_email: z.ZodOptional<z.ZodString>;
     /** Display name of the owning user. `null` for end-user (user-JWT) callers; populated for developer and server-to-server callers. */
@@ -9398,17 +9700,25 @@ export declare const keyValueStorageEntryWithUserSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     value: string;
     key: string;
-    user: string;
     created_at: string;
     updated_at: string;
+    user?: string | undefined;
+    org?: string | undefined;
+    agent?: string | undefined;
+    team?: string | undefined;
+    expires_at?: string | undefined;
     user_email?: string | undefined;
     user_name?: string | undefined;
 }, {
     value: string;
     key: string;
-    user: string;
     created_at: string;
     updated_at: string;
+    user?: string | undefined;
+    org?: string | undefined;
+    agent?: string | undefined;
+    team?: string | undefined;
+    expires_at?: string | undefined;
     user_email?: string | undefined;
     user_name?: string | undefined;
 }>;
@@ -9433,14 +9743,22 @@ export interface KeyValueStorageEntryPage {
 export declare const keyValueStorageEntryPageSchema: z.ZodObject<{
     /** Array of key-value storage entries for the current page. */
     data: z.ZodArray<z.ZodObject<{
+        /** Agent owner, if any. */
+        agent: z.ZodOptional<z.ZodString>;
         /** When this storage entry was first created (ISO 8601). */
         created_at: z.ZodString;
+        /** Expiry deadline, or null for entries without expiry. */
+        expires_at: z.ZodOptional<z.ZodString>;
         /** The string key used to store and look up this entry. */
         key: z.ZodString;
+        /** Organization scope. */
+        org: z.ZodOptional<z.ZodString>;
+        /** Team owner, if any. */
+        team: z.ZodOptional<z.ZodString>;
         /** When this storage entry was last updated (ISO 8601). */
         updated_at: z.ZodString;
-        /** ID of the user who owns this storage entry (`usr_...`). */
-        user: z.ZodString;
+        /** ID of the user owner, or null for non-user ownership. */
+        user: z.ZodOptional<z.ZodString>;
         /** Email address of the owning user. `null` for end-user (user-JWT) callers; populated for developer and server-to-server callers. */
         user_email: z.ZodOptional<z.ZodString>;
         /** Display name of the owning user. `null` for end-user (user-JWT) callers; populated for developer and server-to-server callers. */
@@ -9450,17 +9768,25 @@ export declare const keyValueStorageEntryPageSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         value: string;
         key: string;
-        user: string;
         created_at: string;
         updated_at: string;
+        user?: string | undefined;
+        org?: string | undefined;
+        agent?: string | undefined;
+        team?: string | undefined;
+        expires_at?: string | undefined;
         user_email?: string | undefined;
         user_name?: string | undefined;
     }, {
         value: string;
         key: string;
-        user: string;
         created_at: string;
         updated_at: string;
+        user?: string | undefined;
+        org?: string | undefined;
+        agent?: string | undefined;
+        team?: string | undefined;
+        expires_at?: string | undefined;
         user_email?: string | undefined;
         user_name?: string | undefined;
     }>, "many">;
@@ -9480,9 +9806,13 @@ export declare const keyValueStorageEntryPageSchema: z.ZodObject<{
     data: {
         value: string;
         key: string;
-        user: string;
         created_at: string;
         updated_at: string;
+        user?: string | undefined;
+        org?: string | undefined;
+        agent?: string | undefined;
+        team?: string | undefined;
+        expires_at?: string | undefined;
         user_email?: string | undefined;
         user_name?: string | undefined;
     }[];
@@ -9496,9 +9826,13 @@ export declare const keyValueStorageEntryPageSchema: z.ZodObject<{
     data: {
         value: string;
         key: string;
-        user: string;
         created_at: string;
         updated_at: string;
+        user?: string | undefined;
+        org?: string | undefined;
+        agent?: string | undefined;
+        team?: string | undefined;
+        expires_at?: string | undefined;
         user_email?: string | undefined;
         user_name?: string | undefined;
     }[];
@@ -10063,10 +10397,14 @@ export declare const paginatedRepliesSchema: z.ZodObject<{
             url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             /** Array of available encoding variants for the media item (e.g. different resolutions). Present on `media` type only; omitted otherwise. */
             variants: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                /** Size of the stored bytes. */
+                byte_size: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
                 /** MIME type of this variant's file (e.g., `"image/jpeg"`, `"video/mp4"`). `null` if the file is not loaded. */
                 content_type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 /** When this variant was created (ISO 8601). */
                 created_at: z.ZodOptional<z.ZodString>;
+                /** Client-declared video duration in milliseconds; not server-probed. */
+                duration_ms: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
                 /** ID of the underlying storage file that backs this variant (`fil_...`). */
                 file: z.ZodOptional<z.ZodString>;
                 /** Original filename of the uploaded file for this variant. `null` if the file is not loaded. */
@@ -10101,10 +10439,14 @@ export declare const paginatedRepliesSchema: z.ZodObject<{
                     url?: string | null | undefined;
                     width?: number | null | undefined;
                 }>>>;
+                /** Lowercase SHA-256 of the stored bytes. */
+                sha256: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 /** When this variant was last updated (ISO 8601). */
                 updated_at: z.ZodOptional<z.ZodString>;
                 /** Signed download URL for this variant, resolved at request time. `null` if the file is unavailable. */
                 url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                /** Expiry of this variant's playable URL. */
+                url_expires_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 /** Identifier for this variant's processing tier. Common values include `"original"` (the unmodified upload) and `"thumbnail"` (a resized preview). */
                 variant_key: z.ZodOptional<z.ZodString>;
                 /** Width of this variant in pixels. `null` if not recorded. */
@@ -10117,7 +10459,9 @@ export declare const paginatedRepliesSchema: z.ZodObject<{
                 height?: number | null | undefined;
                 url?: string | null | undefined;
                 width?: number | null | undefined;
+                byte_size?: number | null | undefined;
                 content_type?: string | null | undefined;
+                duration_ms?: number | null | undefined;
                 filename?: string | null | undefined;
                 image_source?: {
                     mime_type?: string | null | undefined;
@@ -10128,6 +10472,8 @@ export declare const paginatedRepliesSchema: z.ZodObject<{
                     url?: string | null | undefined;
                     width?: number | null | undefined;
                 } | null | undefined;
+                sha256?: string | null | undefined;
+                url_expires_at?: string | null | undefined;
                 variant_key?: string | undefined;
             }, {
                 id: string;
@@ -10137,7 +10483,9 @@ export declare const paginatedRepliesSchema: z.ZodObject<{
                 height?: number | null | undefined;
                 url?: string | null | undefined;
                 width?: number | null | undefined;
+                byte_size?: number | null | undefined;
                 content_type?: string | null | undefined;
+                duration_ms?: number | null | undefined;
                 filename?: string | null | undefined;
                 image_source?: {
                     mime_type?: string | null | undefined;
@@ -10148,6 +10496,8 @@ export declare const paginatedRepliesSchema: z.ZodObject<{
                     url?: string | null | undefined;
                     width?: number | null | undefined;
                 } | null | undefined;
+                sha256?: string | null | undefined;
+                url_expires_at?: string | null | undefined;
                 variant_key?: string | undefined;
             }>, "many">>;
             /** Version number of the attached artifact at the time of attachment. Present on `artifact` type only. `null` otherwise. */
@@ -10188,7 +10538,9 @@ export declare const paginatedRepliesSchema: z.ZodObject<{
                 height?: number | null | undefined;
                 url?: string | null | undefined;
                 width?: number | null | undefined;
+                byte_size?: number | null | undefined;
                 content_type?: string | null | undefined;
+                duration_ms?: number | null | undefined;
                 filename?: string | null | undefined;
                 image_source?: {
                     mime_type?: string | null | undefined;
@@ -10199,6 +10551,8 @@ export declare const paginatedRepliesSchema: z.ZodObject<{
                     url?: string | null | undefined;
                     width?: number | null | undefined;
                 } | null | undefined;
+                sha256?: string | null | undefined;
+                url_expires_at?: string | null | undefined;
                 variant_key?: string | undefined;
             }[] | undefined;
             version?: number | null | undefined;
@@ -10236,7 +10590,9 @@ export declare const paginatedRepliesSchema: z.ZodObject<{
                 height?: number | null | undefined;
                 url?: string | null | undefined;
                 width?: number | null | undefined;
+                byte_size?: number | null | undefined;
                 content_type?: string | null | undefined;
+                duration_ms?: number | null | undefined;
                 filename?: string | null | undefined;
                 image_source?: {
                     mime_type?: string | null | undefined;
@@ -10247,6 +10603,8 @@ export declare const paginatedRepliesSchema: z.ZodObject<{
                     url?: string | null | undefined;
                     width?: number | null | undefined;
                 } | null | undefined;
+                sha256?: string | null | undefined;
+                url_expires_at?: string | null | undefined;
                 variant_key?: string | undefined;
             }[] | undefined;
             version?: number | null | undefined;
@@ -10477,7 +10835,9 @@ export declare const paginatedRepliesSchema: z.ZodObject<{
                 height?: number | null | undefined;
                 url?: string | null | undefined;
                 width?: number | null | undefined;
+                byte_size?: number | null | undefined;
                 content_type?: string | null | undefined;
+                duration_ms?: number | null | undefined;
                 filename?: string | null | undefined;
                 image_source?: {
                     mime_type?: string | null | undefined;
@@ -10488,6 +10848,8 @@ export declare const paginatedRepliesSchema: z.ZodObject<{
                     url?: string | null | undefined;
                     width?: number | null | undefined;
                 } | null | undefined;
+                sha256?: string | null | undefined;
+                url_expires_at?: string | null | undefined;
                 variant_key?: string | undefined;
             }[] | undefined;
             version?: number | null | undefined;
@@ -10613,7 +10975,9 @@ export declare const paginatedRepliesSchema: z.ZodObject<{
                 height?: number | null | undefined;
                 url?: string | null | undefined;
                 width?: number | null | undefined;
+                byte_size?: number | null | undefined;
                 content_type?: string | null | undefined;
+                duration_ms?: number | null | undefined;
                 filename?: string | null | undefined;
                 image_source?: {
                     mime_type?: string | null | undefined;
@@ -10624,6 +10988,8 @@ export declare const paginatedRepliesSchema: z.ZodObject<{
                     url?: string | null | undefined;
                     width?: number | null | undefined;
                 } | null | undefined;
+                sha256?: string | null | undefined;
+                url_expires_at?: string | null | undefined;
                 variant_key?: string | undefined;
             }[] | undefined;
             version?: number | null | undefined;
@@ -10753,7 +11119,9 @@ export declare const paginatedRepliesSchema: z.ZodObject<{
                 height?: number | null | undefined;
                 url?: string | null | undefined;
                 width?: number | null | undefined;
+                byte_size?: number | null | undefined;
                 content_type?: string | null | undefined;
+                duration_ms?: number | null | undefined;
                 filename?: string | null | undefined;
                 image_source?: {
                     mime_type?: string | null | undefined;
@@ -10764,6 +11132,8 @@ export declare const paginatedRepliesSchema: z.ZodObject<{
                     url?: string | null | undefined;
                     width?: number | null | undefined;
                 } | null | undefined;
+                sha256?: string | null | undefined;
+                url_expires_at?: string | null | undefined;
                 variant_key?: string | undefined;
             }[] | undefined;
             version?: number | null | undefined;
@@ -10895,7 +11265,9 @@ export declare const paginatedRepliesSchema: z.ZodObject<{
                 height?: number | null | undefined;
                 url?: string | null | undefined;
                 width?: number | null | undefined;
+                byte_size?: number | null | undefined;
                 content_type?: string | null | undefined;
+                duration_ms?: number | null | undefined;
                 filename?: string | null | undefined;
                 image_source?: {
                     mime_type?: string | null | undefined;
@@ -10906,6 +11278,8 @@ export declare const paginatedRepliesSchema: z.ZodObject<{
                     url?: string | null | undefined;
                     width?: number | null | undefined;
                 } | null | undefined;
+                sha256?: string | null | undefined;
+                url_expires_at?: string | null | undefined;
                 variant_key?: string | undefined;
             }[] | undefined;
             version?: number | null | undefined;
@@ -11480,14 +11854,14 @@ export declare const runtimeCapabilitySchema: z.ZodObject<{
     expires_at: z.ZodString;
     gateway_url: z.ZodString;
 }, "strip", z.ZodTypeAny, {
+    expires_at: string;
     bindings: Record<string, {} | null>;
     capability: string;
-    expires_at: string;
     gateway_url: string;
 }, {
+    expires_at: string;
     bindings: Record<string, {} | null>;
     capability: string;
-    expires_at: string;
     gateway_url: string;
 }>;
 /** A single runtime environment variable available within a script execution context, including its key, description, and origin. */
@@ -16060,7 +16434,7 @@ export declare const agentSchema: z.ZodObject<{
 /** A cloud computer resource provisioned for an agent to use for browser and desktop automation tasks. */
 export interface AgentComputer {
     /** ID of the agent that owns this computer (`agi_...`). `null` if the computer is not yet assigned to an agent. */
-    agent?: string | undefined;
+    agent?: string | null | undefined;
     /** ID of the app this computer belongs to (`dap_...`). */
     app?: string | undefined;
     /** Provider-specific configuration key-value pairs for the computer. Structure depends on the underlying compute provider. */
@@ -16068,32 +16442,36 @@ export interface AgentComputer {
     /** When the computer was created (ISO 8601). */
     created_at?: string | undefined;
     /** Human-readable error description when `status` is `"error"`. `null` otherwise. */
-    error_message?: string | undefined;
+    error_message?: string | null | undefined;
     /** Computer ID (`cmp_...`). */
     id: string;
+    /** Stable key unique within the thread, or null if unset. */
+    key?: string | null | undefined;
     /** When the computer last reported activity or received a command. `null` if the computer has never been active. */
-    last_active_at?: string | undefined;
+    last_active_at?: string | null | undefined;
     /** Unique, stable identifier you assign to this computer within its app. `null` if not set. */
-    lookup_key?: string | undefined;
+    lookup_key?: string | null | undefined;
     /** Arbitrary key-value metadata you attached to the computer. `null` if none was provided. */
     metadata?: Record<string, unknown> | undefined;
     /** Human-readable display name for the computer. `null` if not set. */
     name?: string | undefined;
-    /** Compute backend powering this computer: `"sprites"` (Fly Sprites) or `"vercel"` (Vercel Sandbox). */
+    /** Compute backend powering this computer: `"sprites"` (Fly Sprites), `"vercel"` (Vercel Sandbox) or `"e2b"` (E2B). */
     provider?: string | undefined;
-    /** Cloud region where the computer is hosted, e.g. `"us-east-1"`. `null` if not yet assigned or when the provider has no region concept (e.g. `"vercel"`). */
-    region?: string | undefined;
+    /** Cloud region where the computer is hosted, e.g. `"us-east-1"`. `null` if not yet assigned or when the provider has no region concept (e.g. `"vercel"`, `"e2b"`). */
+    region?: string | null | undefined;
     /** URL of the live screenshot sprite used to render a real-time preview of the computer's screen. `null` when no sprite is available. */
-    sprite_url?: string | undefined;
+    sprite_url?: string | null | undefined;
     /** Current lifecycle state of the computer. Common values include `"provisioning"`, `"ready"`, `"error"`, and `"terminated"`. */
-    status?: string | undefined;
+    status?: string | null | undefined;
+    /** Thread this computer belongs to, or null for a non-thread computer. */
+    thread_id?: string | null | undefined;
     /** When the computer record was last modified (ISO 8601). */
     updated_at?: string | undefined;
 }
 /** Runtime validator for {@link AgentComputer}. */
 export declare const agentComputerSchema: z.ZodObject<{
     /** ID of the agent that owns this computer (`agi_...`). `null` if the computer is not yet assigned to an agent. */
-    agent: z.ZodOptional<z.ZodString>;
+    agent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     /** ID of the app this computer belongs to (`dap_...`). */
     app: z.ZodOptional<z.ZodString>;
     /** Provider-specific configuration key-value pairs for the computer. Structure depends on the underlying compute provider. */
@@ -16101,59 +16479,67 @@ export declare const agentComputerSchema: z.ZodObject<{
     /** When the computer was created (ISO 8601). */
     created_at: z.ZodOptional<z.ZodString>;
     /** Human-readable error description when `status` is `"error"`. `null` otherwise. */
-    error_message: z.ZodOptional<z.ZodString>;
+    error_message: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     /** Computer ID (`cmp_...`). */
     id: z.ZodString;
+    /** Stable key unique within the thread, or null if unset. */
+    key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     /** When the computer last reported activity or received a command. `null` if the computer has never been active. */
-    last_active_at: z.ZodOptional<z.ZodString>;
+    last_active_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     /** Unique, stable identifier you assign to this computer within its app. `null` if not set. */
-    lookup_key: z.ZodOptional<z.ZodString>;
+    lookup_key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     /** Arbitrary key-value metadata you attached to the computer. `null` if none was provided. */
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>>;
     /** Human-readable display name for the computer. `null` if not set. */
     name: z.ZodOptional<z.ZodString>;
-    /** Compute backend powering this computer: `"sprites"` (Fly Sprites) or `"vercel"` (Vercel Sandbox). */
+    /** Compute backend powering this computer: `"sprites"` (Fly Sprites), `"vercel"` (Vercel Sandbox) or `"e2b"` (E2B). */
     provider: z.ZodOptional<z.ZodString>;
-    /** Cloud region where the computer is hosted, e.g. `"us-east-1"`. `null` if not yet assigned or when the provider has no region concept (e.g. `"vercel"`). */
-    region: z.ZodOptional<z.ZodString>;
+    /** Cloud region where the computer is hosted, e.g. `"us-east-1"`. `null` if not yet assigned or when the provider has no region concept (e.g. `"vercel"`, `"e2b"`). */
+    region: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     /** URL of the live screenshot sprite used to render a real-time preview of the computer's screen. `null` when no sprite is available. */
-    sprite_url: z.ZodOptional<z.ZodString>;
+    sprite_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     /** Current lifecycle state of the computer. Common values include `"provisioning"`, `"ready"`, `"error"`, and `"terminated"`. */
-    status: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** Thread this computer belongs to, or null for a non-thread computer. */
+    thread_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     /** When the computer record was last modified (ISO 8601). */
     updated_at: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     id: string;
+    key?: string | null | undefined;
     name?: string | undefined;
-    agent?: string | undefined;
-    status?: string | undefined;
+    agent?: string | null | undefined;
+    status?: string | null | undefined;
     app?: string | undefined;
     created_at?: string | undefined;
     updated_at?: string | undefined;
-    lookup_key?: string | undefined;
+    lookup_key?: string | null | undefined;
     metadata?: Record<string, {} | null> | undefined;
+    thread_id?: string | null | undefined;
     config?: Record<string, {} | null> | undefined;
     provider?: string | undefined;
-    error_message?: string | undefined;
-    last_active_at?: string | undefined;
-    region?: string | undefined;
-    sprite_url?: string | undefined;
+    error_message?: string | null | undefined;
+    last_active_at?: string | null | undefined;
+    region?: string | null | undefined;
+    sprite_url?: string | null | undefined;
 }, {
     id: string;
+    key?: string | null | undefined;
     name?: string | undefined;
-    agent?: string | undefined;
-    status?: string | undefined;
+    agent?: string | null | undefined;
+    status?: string | null | undefined;
     app?: string | undefined;
     created_at?: string | undefined;
     updated_at?: string | undefined;
-    lookup_key?: string | undefined;
+    lookup_key?: string | null | undefined;
     metadata?: Record<string, {} | null> | undefined;
+    thread_id?: string | null | undefined;
     config?: Record<string, {} | null> | undefined;
     provider?: string | undefined;
-    error_message?: string | undefined;
-    last_active_at?: string | undefined;
-    region?: string | undefined;
-    sprite_url?: string | undefined;
+    error_message?: string | null | undefined;
+    last_active_at?: string | null | undefined;
+    region?: string | null | undefined;
+    sprite_url?: string | null | undefined;
 }>;
 /** A list of agent computers returned by a list query. */
 export interface AgentComputerListResponse {
@@ -16165,7 +16551,7 @@ export declare const agentComputerListResponseSchema: z.ZodObject<{
     /** Array of agent computer objects matching the query. */
     data: z.ZodArray<z.ZodObject<{
         /** ID of the agent that owns this computer (`agi_...`). `null` if the computer is not yet assigned to an agent. */
-        agent: z.ZodOptional<z.ZodString>;
+        agent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         /** ID of the app this computer belongs to (`dap_...`). */
         app: z.ZodOptional<z.ZodString>;
         /** Provider-specific configuration key-value pairs for the computer. Structure depends on the underlying compute provider. */
@@ -16173,95 +16559,107 @@ export declare const agentComputerListResponseSchema: z.ZodObject<{
         /** When the computer was created (ISO 8601). */
         created_at: z.ZodOptional<z.ZodString>;
         /** Human-readable error description when `status` is `"error"`. `null` otherwise. */
-        error_message: z.ZodOptional<z.ZodString>;
+        error_message: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         /** Computer ID (`cmp_...`). */
         id: z.ZodString;
+        /** Stable key unique within the thread, or null if unset. */
+        key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         /** When the computer last reported activity or received a command. `null` if the computer has never been active. */
-        last_active_at: z.ZodOptional<z.ZodString>;
+        last_active_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         /** Unique, stable identifier you assign to this computer within its app. `null` if not set. */
-        lookup_key: z.ZodOptional<z.ZodString>;
+        lookup_key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         /** Arbitrary key-value metadata you attached to the computer. `null` if none was provided. */
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>>;
         /** Human-readable display name for the computer. `null` if not set. */
         name: z.ZodOptional<z.ZodString>;
-        /** Compute backend powering this computer: `"sprites"` (Fly Sprites) or `"vercel"` (Vercel Sandbox). */
+        /** Compute backend powering this computer: `"sprites"` (Fly Sprites), `"vercel"` (Vercel Sandbox) or `"e2b"` (E2B). */
         provider: z.ZodOptional<z.ZodString>;
-        /** Cloud region where the computer is hosted, e.g. `"us-east-1"`. `null` if not yet assigned or when the provider has no region concept (e.g. `"vercel"`). */
-        region: z.ZodOptional<z.ZodString>;
+        /** Cloud region where the computer is hosted, e.g. `"us-east-1"`. `null` if not yet assigned or when the provider has no region concept (e.g. `"vercel"`, `"e2b"`). */
+        region: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         /** URL of the live screenshot sprite used to render a real-time preview of the computer's screen. `null` when no sprite is available. */
-        sprite_url: z.ZodOptional<z.ZodString>;
+        sprite_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         /** Current lifecycle state of the computer. Common values include `"provisioning"`, `"ready"`, `"error"`, and `"terminated"`. */
-        status: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Thread this computer belongs to, or null for a non-thread computer. */
+        thread_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         /** When the computer record was last modified (ISO 8601). */
         updated_at: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         id: string;
+        key?: string | null | undefined;
         name?: string | undefined;
-        agent?: string | undefined;
-        status?: string | undefined;
+        agent?: string | null | undefined;
+        status?: string | null | undefined;
         app?: string | undefined;
         created_at?: string | undefined;
         updated_at?: string | undefined;
-        lookup_key?: string | undefined;
+        lookup_key?: string | null | undefined;
         metadata?: Record<string, {} | null> | undefined;
+        thread_id?: string | null | undefined;
         config?: Record<string, {} | null> | undefined;
         provider?: string | undefined;
-        error_message?: string | undefined;
-        last_active_at?: string | undefined;
-        region?: string | undefined;
-        sprite_url?: string | undefined;
+        error_message?: string | null | undefined;
+        last_active_at?: string | null | undefined;
+        region?: string | null | undefined;
+        sprite_url?: string | null | undefined;
     }, {
         id: string;
+        key?: string | null | undefined;
         name?: string | undefined;
-        agent?: string | undefined;
-        status?: string | undefined;
+        agent?: string | null | undefined;
+        status?: string | null | undefined;
         app?: string | undefined;
         created_at?: string | undefined;
         updated_at?: string | undefined;
-        lookup_key?: string | undefined;
+        lookup_key?: string | null | undefined;
         metadata?: Record<string, {} | null> | undefined;
+        thread_id?: string | null | undefined;
         config?: Record<string, {} | null> | undefined;
         provider?: string | undefined;
-        error_message?: string | undefined;
-        last_active_at?: string | undefined;
-        region?: string | undefined;
-        sprite_url?: string | undefined;
+        error_message?: string | null | undefined;
+        last_active_at?: string | null | undefined;
+        region?: string | null | undefined;
+        sprite_url?: string | null | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     data: {
         id: string;
+        key?: string | null | undefined;
         name?: string | undefined;
-        agent?: string | undefined;
-        status?: string | undefined;
+        agent?: string | null | undefined;
+        status?: string | null | undefined;
         app?: string | undefined;
         created_at?: string | undefined;
         updated_at?: string | undefined;
-        lookup_key?: string | undefined;
+        lookup_key?: string | null | undefined;
         metadata?: Record<string, {} | null> | undefined;
+        thread_id?: string | null | undefined;
         config?: Record<string, {} | null> | undefined;
         provider?: string | undefined;
-        error_message?: string | undefined;
-        last_active_at?: string | undefined;
-        region?: string | undefined;
-        sprite_url?: string | undefined;
+        error_message?: string | null | undefined;
+        last_active_at?: string | null | undefined;
+        region?: string | null | undefined;
+        sprite_url?: string | null | undefined;
     }[];
 }, {
     data: {
         id: string;
+        key?: string | null | undefined;
         name?: string | undefined;
-        agent?: string | undefined;
-        status?: string | undefined;
+        agent?: string | null | undefined;
+        status?: string | null | undefined;
         app?: string | undefined;
         created_at?: string | undefined;
         updated_at?: string | undefined;
-        lookup_key?: string | undefined;
+        lookup_key?: string | null | undefined;
         metadata?: Record<string, {} | null> | undefined;
+        thread_id?: string | null | undefined;
         config?: Record<string, {} | null> | undefined;
         provider?: string | undefined;
-        error_message?: string | undefined;
-        last_active_at?: string | undefined;
-        region?: string | undefined;
-        sprite_url?: string | undefined;
+        error_message?: string | null | undefined;
+        last_active_at?: string | null | undefined;
+        region?: string | null | undefined;
+        sprite_url?: string | null | undefined;
     }[];
 }>;
 /** The response returned by `POST /api/v1/agents`. Contains all agent fields plus an optional `installed_configs` array when a `template_bundle` was supplied in the request. */
@@ -20848,58 +21246,467 @@ export declare const agentListResponseSchema: z.ZodObject<{
     total_entries?: number | undefined;
     total_pages?: number | undefined;
 }>;
-/** An agent routine defines a reusable handler — script, preset, or chain — that runs in response to events or on a schedule. */
-export interface AgentRoutine {
-    /** Access control list for the routine. Contains a `grants` array where each entry specifies `principal_type`, `principal`, and `actions` (`"read"`, `"invoke"`, or `"assign"` — an `"assign"` grant names the agents or orgs that may be handed this routine's embedded work items). `null` when no ACL restrictions are applied and the routine is accessible to all members of its scope. */
-    acl?: Acl | undefined;
-    /** ID of the agent that owns this routine (`agi_...`). */
-    agent?: string | undefined;
-    /** Application that scopes this routine (`dap_...`). */
-    app?: string | undefined;
-    /** ID of the Config record that backs this routine's configuration (`cfg_...`). `null` when the routine is not config-backed. */
-    config?: string | undefined;
-    /** When this routine was created (ISO 8601). */
-    created_at?: string | undefined;
-    /** Optional description of what this routine does. `null` when not set. */
-    description?: string | undefined;
-    /** Additional configuration controlling how the event trigger is matched or filtered. Shape depends on `event_type`. `null` when not configured. */
-    event_config?: Record<string, unknown> | undefined;
-    /** Platform event type that triggers this routine, e.g. `"agentroutine.invoked"`. `null` for schedule-only routines. */
-    event_type?: string | undefined;
-    /** Execution strategy for this routine. One of `"workflow_graph"`, `"script"`, `"preset"`, or `"chain"`. */
-    handler_type?: string | undefined;
-    /** Routine ID (`arn_...`). */
+/** Originating agent. */
+export interface AgentRequestAgent {
     id: string;
-    /** ID of the AgentRoutineTemplate Config this routine was last provisioned or updated from (`cfg_...`). `null` for hand-built routines. */
-    last_applied_template_config?: string | undefined;
-    /** Unique human-readable key used to look up this routine without knowing its ID. `null` when not set. */
-    lookup_key?: string | undefined;
-    /** Visibility and explicit recipient selection for messages emitted by this routine. */
-    message_policy?: MessagePolicy | undefined;
-    /** Arbitrary key-value metadata attached to this routine. `null` when not set. */
-    metadata?: Record<string, unknown> | undefined;
-    /** Human-readable name for the routine. */
-    name?: string | undefined;
-    /** Resolved preset configuration when `handler_type` is `"preset"`. `null` for other handler types. */
-    preset_config?: PresetConfig | undefined;
-    /** Name of the preset invoked when `handler_type` is `"preset"`. `null` for other handler types. */
-    preset_name?: string | undefined;
-    /** Cron expression controlling when the routine fires on a schedule. `null` for event-only routines. */
-    schedule?: string | undefined;
-    /** Inline script body executed when `handler_type` is `"script"`. `null` for other handler types. */
-    script?: string | undefined;
-    /** Lifecycle status of the routine. One of `"draft"`, `"active"`, or `"paused"`. Only `"active"` routines respond to triggers. */
+    name?: string | null | undefined;
+}
+/** Runtime validator for {@link AgentRequestAgent}. */
+export declare const agentRequestAgentSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name?: string | null | undefined;
+}, {
+    id: string;
+    name?: string | null | undefined;
+}>;
+/** A request for human approval or input. Secret input is never returned. */
+export interface AgentRequest {
+    /** Originating agent. */
+    agent?: AgentRequestAgent | undefined;
+    /** Approval policy, excluding user IDs. */
+    approvers?: Approvers | undefined;
+    /** Expiration time. */
+    expires_at?: string | undefined;
+    /** Request ID (`arq_...`). */
+    id: string;
+    /** Whether the authenticated caller is an approver, regardless of request status. */
+    is_approver?: boolean | undefined;
+    /** Registered request kind. */
+    kind?: string | undefined;
+    /** Origin references. */
+    origin?: Origin | undefined;
+    /** Question request payload. */
+    payload?: Payload | undefined;
+    /** Answer or rejection reason; null before resolution. */
+    resolution?: Resolution | null | undefined;
+    /** Resolution time. */
+    resolved_at?: string | undefined;
+    /** Resolving user ID. */
+    resolved_by?: string | undefined;
+    /** Request status. */
     status?: string | undefined;
-    /** Ordered list of chain steps (present when handler_type is "chain"). Each step is a plain map with handler_type, optional body fields (preset_name / preset_config / script / config), and step-local plumbing (name, inputs, output_key, on_error). */
-    steps?: Record<string, unknown>[] | undefined;
-    /** Execution context in which runs are created. One of `"event"` (background job) or `"chat_session"` (interactive session). Defaults to `"event"`. */
-    trigger_context?: string | undefined;
-    /** When this routine was last updated (ISO 8601). */
-    updated_at?: string | undefined;
-    /** Optional co-owner user (`usr_...`). When set, that user shares view/modify/delete authority on this routine without administering the parent agent. `null` when not set. Never inferred from the caller — only present when explicitly provided on create/update. */
-    user?: string | undefined;
+    /** Kind-provided summary. */
+    summary?: Summary | undefined;
 }
-/** Runtime validator for {@link AgentRoutine}. */
+/** Runtime validator for {@link AgentRequest}. */
+export declare const agentRequestSchema: z.ZodObject<{
+    /** Originating agent. */
+    agent: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name?: string | null | undefined;
+    }, {
+        id: string;
+        name?: string | null | undefined;
+    }>>;
+    /** Approval policy, excluding user IDs. */
+    approvers: z.ZodOptional<z.ZodObject<{
+        mode: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        mode: string;
+    }, {
+        mode: string;
+    }>>;
+    /** Expiration time. */
+    expires_at: z.ZodOptional<z.ZodString>;
+    /** Request ID (`arq_...`). */
+    id: z.ZodString;
+    /** Whether the authenticated caller is an approver, regardless of request status. */
+    is_approver: z.ZodOptional<z.ZodBoolean>;
+    /** Registered request kind. */
+    kind: z.ZodOptional<z.ZodString>;
+    /** Origin references. */
+    origin: z.ZodOptional<z.ZodObject<{
+        routine_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        session_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        thread_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        routine_id?: string | null | undefined;
+        session_id?: string | null | undefined;
+        thread_id?: string | null | undefined;
+    }, {
+        routine_id?: string | null | undefined;
+        session_id?: string | null | undefined;
+        thread_id?: string | null | undefined;
+    }>>;
+    /** Question request payload. */
+    payload: z.ZodOptional<z.ZodObject<{
+        question: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        question: string;
+    }, {
+        question: string;
+    }>>;
+    /** Answer or rejection reason; null before resolution. */
+    resolution: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        answer: z.ZodOptional<z.ZodString>;
+        reason: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        answer?: string | undefined;
+        reason?: string | undefined;
+    }, {
+        answer?: string | undefined;
+        reason?: string | undefined;
+    }>>>;
+    /** Resolution time. */
+    resolved_at: z.ZodOptional<z.ZodString>;
+    /** Resolving user ID. */
+    resolved_by: z.ZodOptional<z.ZodString>;
+    /** Request status. */
+    status: z.ZodOptional<z.ZodString>;
+    /** Kind-provided summary. */
+    summary: z.ZodOptional<z.ZodObject<{
+        lines: z.ZodArray<z.ZodString, "many">;
+        title: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        lines: string[];
+    }, {
+        title: string;
+        lines: string[];
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    kind?: string | undefined;
+    agent?: {
+        id: string;
+        name?: string | null | undefined;
+    } | undefined;
+    status?: string | undefined;
+    payload?: {
+        question: string;
+    } | undefined;
+    expires_at?: string | undefined;
+    approvers?: {
+        mode: string;
+    } | undefined;
+    is_approver?: boolean | undefined;
+    origin?: {
+        routine_id?: string | null | undefined;
+        session_id?: string | null | undefined;
+        thread_id?: string | null | undefined;
+    } | undefined;
+    resolution?: {
+        answer?: string | undefined;
+        reason?: string | undefined;
+    } | null | undefined;
+    resolved_at?: string | undefined;
+    resolved_by?: string | undefined;
+    summary?: {
+        title: string;
+        lines: string[];
+    } | undefined;
+}, {
+    id: string;
+    kind?: string | undefined;
+    agent?: {
+        id: string;
+        name?: string | null | undefined;
+    } | undefined;
+    status?: string | undefined;
+    payload?: {
+        question: string;
+    } | undefined;
+    expires_at?: string | undefined;
+    approvers?: {
+        mode: string;
+    } | undefined;
+    is_approver?: boolean | undefined;
+    origin?: {
+        routine_id?: string | null | undefined;
+        session_id?: string | null | undefined;
+        thread_id?: string | null | undefined;
+    } | undefined;
+    resolution?: {
+        answer?: string | undefined;
+        reason?: string | undefined;
+    } | null | undefined;
+    resolved_at?: string | undefined;
+    resolved_by?: string | undefined;
+    summary?: {
+        title: string;
+        lines: string[];
+    } | undefined;
+}>;
+/** A page of visible agent requests. */
+export interface AgentRequestListResponse {
+    /** Visible requests. */
+    data: AgentRequest[];
+    /** Pass as cursor for the next page; null at the end. */
+    next_cursor?: string | undefined;
+}
+/** Runtime validator for {@link AgentRequestListResponse}. */
+export declare const agentRequestListResponseSchema: z.ZodObject<{
+    /** Visible requests. */
+    data: z.ZodArray<z.ZodObject<{
+        /** Originating agent. */
+        agent: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            name?: string | null | undefined;
+        }, {
+            id: string;
+            name?: string | null | undefined;
+        }>>;
+        /** Approval policy, excluding user IDs. */
+        approvers: z.ZodOptional<z.ZodObject<{
+            mode: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            mode: string;
+        }, {
+            mode: string;
+        }>>;
+        /** Expiration time. */
+        expires_at: z.ZodOptional<z.ZodString>;
+        /** Request ID (`arq_...`). */
+        id: z.ZodString;
+        /** Whether the authenticated caller is an approver, regardless of request status. */
+        is_approver: z.ZodOptional<z.ZodBoolean>;
+        /** Registered request kind. */
+        kind: z.ZodOptional<z.ZodString>;
+        /** Origin references. */
+        origin: z.ZodOptional<z.ZodObject<{
+            routine_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            session_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            thread_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            routine_id?: string | null | undefined;
+            session_id?: string | null | undefined;
+            thread_id?: string | null | undefined;
+        }, {
+            routine_id?: string | null | undefined;
+            session_id?: string | null | undefined;
+            thread_id?: string | null | undefined;
+        }>>;
+        /** Question request payload. */
+        payload: z.ZodOptional<z.ZodObject<{
+            question: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            question: string;
+        }, {
+            question: string;
+        }>>;
+        /** Answer or rejection reason; null before resolution. */
+        resolution: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            answer: z.ZodOptional<z.ZodString>;
+            reason: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            answer?: string | undefined;
+            reason?: string | undefined;
+        }, {
+            answer?: string | undefined;
+            reason?: string | undefined;
+        }>>>;
+        /** Resolution time. */
+        resolved_at: z.ZodOptional<z.ZodString>;
+        /** Resolving user ID. */
+        resolved_by: z.ZodOptional<z.ZodString>;
+        /** Request status. */
+        status: z.ZodOptional<z.ZodString>;
+        /** Kind-provided summary. */
+        summary: z.ZodOptional<z.ZodObject<{
+            lines: z.ZodArray<z.ZodString, "many">;
+            title: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            title: string;
+            lines: string[];
+        }, {
+            title: string;
+            lines: string[];
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        kind?: string | undefined;
+        agent?: {
+            id: string;
+            name?: string | null | undefined;
+        } | undefined;
+        status?: string | undefined;
+        payload?: {
+            question: string;
+        } | undefined;
+        expires_at?: string | undefined;
+        approvers?: {
+            mode: string;
+        } | undefined;
+        is_approver?: boolean | undefined;
+        origin?: {
+            routine_id?: string | null | undefined;
+            session_id?: string | null | undefined;
+            thread_id?: string | null | undefined;
+        } | undefined;
+        resolution?: {
+            answer?: string | undefined;
+            reason?: string | undefined;
+        } | null | undefined;
+        resolved_at?: string | undefined;
+        resolved_by?: string | undefined;
+        summary?: {
+            title: string;
+            lines: string[];
+        } | undefined;
+    }, {
+        id: string;
+        kind?: string | undefined;
+        agent?: {
+            id: string;
+            name?: string | null | undefined;
+        } | undefined;
+        status?: string | undefined;
+        payload?: {
+            question: string;
+        } | undefined;
+        expires_at?: string | undefined;
+        approvers?: {
+            mode: string;
+        } | undefined;
+        is_approver?: boolean | undefined;
+        origin?: {
+            routine_id?: string | null | undefined;
+            session_id?: string | null | undefined;
+            thread_id?: string | null | undefined;
+        } | undefined;
+        resolution?: {
+            answer?: string | undefined;
+            reason?: string | undefined;
+        } | null | undefined;
+        resolved_at?: string | undefined;
+        resolved_by?: string | undefined;
+        summary?: {
+            title: string;
+            lines: string[];
+        } | undefined;
+    }>, "many">;
+    /** Pass as cursor for the next page; null at the end. */
+    next_cursor: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    data: {
+        id: string;
+        kind?: string | undefined;
+        agent?: {
+            id: string;
+            name?: string | null | undefined;
+        } | undefined;
+        status?: string | undefined;
+        payload?: {
+            question: string;
+        } | undefined;
+        expires_at?: string | undefined;
+        approvers?: {
+            mode: string;
+        } | undefined;
+        is_approver?: boolean | undefined;
+        origin?: {
+            routine_id?: string | null | undefined;
+            session_id?: string | null | undefined;
+            thread_id?: string | null | undefined;
+        } | undefined;
+        resolution?: {
+            answer?: string | undefined;
+            reason?: string | undefined;
+        } | null | undefined;
+        resolved_at?: string | undefined;
+        resolved_by?: string | undefined;
+        summary?: {
+            title: string;
+            lines: string[];
+        } | undefined;
+    }[];
+    next_cursor?: string | undefined;
+}, {
+    data: {
+        id: string;
+        kind?: string | undefined;
+        agent?: {
+            id: string;
+            name?: string | null | undefined;
+        } | undefined;
+        status?: string | undefined;
+        payload?: {
+            question: string;
+        } | undefined;
+        expires_at?: string | undefined;
+        approvers?: {
+            mode: string;
+        } | undefined;
+        is_approver?: boolean | undefined;
+        origin?: {
+            routine_id?: string | null | undefined;
+            session_id?: string | null | undefined;
+            thread_id?: string | null | undefined;
+        } | undefined;
+        resolution?: {
+            answer?: string | undefined;
+            reason?: string | undefined;
+        } | null | undefined;
+        resolved_at?: string | undefined;
+        resolved_by?: string | undefined;
+        summary?: {
+            title: string;
+            lines: string[];
+        } | undefined;
+    }[];
+    next_cursor?: string | undefined;
+}>;
+/** An agent routine defines a reusable handler — script, preset, or chain — that runs in response to events or on a schedule. */
+export interface AgentRoutine {
+    /** Access control list for the routine. Contains a `grants` array where each entry specifies `principal_type`, `principal`, and `actions` (`"read"`, `"invoke"`, or `"assign"` — an `"assign"` grant names the agents or orgs that may be handed this routine's embedded work items). `null` when no ACL restrictions are applied and the routine is accessible to all members of its scope. */
+    acl?: Acl | undefined;
+    /** ID of the agent that owns this routine (`agi_...`). */
+    agent?: string | undefined;
+    /** Application that scopes this routine (`dap_...`). */
+    app?: string | undefined;
+    /** ID of the Config record that backs this routine's configuration (`cfg_...`). `null` when the routine is not config-backed. */
+    config?: string | undefined;
+    /** When this routine was created (ISO 8601). */
+    created_at?: string | undefined;
+    /** Optional description of what this routine does. `null` when not set. */
+    description?: string | undefined;
+    /** Additional configuration controlling how the event trigger is matched or filtered. Shape depends on `event_type`. `null` when not configured. */
+    event_config?: Record<string, unknown> | undefined;
+    /** Platform event type that triggers this routine, e.g. `"agentroutine.invoked"`. `null` for schedule-only routines. */
+    event_type?: string | undefined;
+    /** Execution strategy for this routine. One of `"workflow_graph"`, `"script"`, `"preset"`, or `"chain"`. */
+    handler_type?: string | undefined;
+    /** Routine ID (`arn_...`). */
+    id: string;
+    /** ID of the AgentRoutineTemplate Config this routine was last provisioned or updated from (`cfg_...`). `null` for hand-built routines. */
+    last_applied_template_config?: string | undefined;
+    /** Unique human-readable key used to look up this routine without knowing its ID. `null` when not set. */
+    lookup_key?: string | undefined;
+    /** Visibility and explicit recipient selection for messages emitted by this routine. */
+    message_policy?: MessagePolicy | undefined;
+    /** Arbitrary key-value metadata attached to this routine. `null` when not set. */
+    metadata?: Record<string, unknown> | undefined;
+    /** Human-readable name for the routine. */
+    name?: string | undefined;
+    /** Resolved preset configuration when `handler_type` is `"preset"`. `null` for other handler types. */
+    preset_config?: PresetConfig | undefined;
+    /** Name of the preset invoked when `handler_type` is `"preset"`. `null` for other handler types. */
+    preset_name?: string | undefined;
+    /** Cron expression controlling when the routine fires on a schedule. `null` for event-only routines. */
+    schedule?: string | undefined;
+    /** Inline script body executed when `handler_type` is `"script"`. `null` for other handler types. */
+    script?: string | undefined;
+    /** Lifecycle status of the routine. One of `"draft"`, `"active"`, or `"paused"`. Only `"active"` routines respond to triggers. */
+    status?: string | undefined;
+    /** Ordered list of chain steps (present when handler_type is "chain"). Each step is a plain map with handler_type, optional body fields (preset_name / preset_config / script / config), and step-local plumbing (name, inputs, output_key, on_error). */
+    steps?: Record<string, unknown>[] | undefined;
+    /** Execution context in which runs are created. One of `"event"` (background job) or `"chat_session"` (interactive session). Defaults to `"event"`. */
+    trigger_context?: string | undefined;
+    /** When this routine was last updated (ISO 8601). */
+    updated_at?: string | undefined;
+    /** Optional co-owner user (`usr_...`). When set, that user shares view/modify/delete authority on this routine without administering the parent agent. `null` when not set. Never inferred from the caller — only present when explicitly provided on create/update. */
+    user?: string | undefined;
+}
+/** Runtime validator for {@link AgentRoutine}. */
 export declare const agentRoutineSchema: z.ZodObject<{
     /** Access control list for the routine. Contains a `grants` array where each entry specifies `principal_type`, `principal`, and `actions` (`"read"`, `"invoke"`, or `"assign"` — an `"assign"` grant names the agents or orgs that may be handed this routine's embedded work items). `null` when no ACL restrictions are applied and the routine is accessible to all members of its scope. */
     acl: z.ZodOptional<z.ZodObject<{
@@ -21840,6 +22647,7 @@ export declare const agentRoutineRunSchema: z.ZodObject<{
             principal?: string | undefined;
         }[] | undefined;
     } | undefined;
+    duration_ms?: number | undefined;
     delivery?: {
         type: "thread" | "none" | "reply";
         status: "pending" | "failed" | "delivered" | "not_requested";
@@ -21849,7 +22657,6 @@ export declare const agentRoutineRunSchema: z.ZodObject<{
         delivered_message?: string | undefined;
         last_error?: string | undefined;
     } | undefined;
-    duration_ms?: number | undefined;
     routine?: string | undefined;
     structured_response?: Record<string, {} | null> | undefined;
     worker?: {
@@ -21885,6 +22692,7 @@ export declare const agentRoutineRunSchema: z.ZodObject<{
             principal?: string | undefined;
         }[] | undefined;
     } | undefined;
+    duration_ms?: number | undefined;
     delivery?: {
         type: "thread" | "none" | "reply";
         status: "pending" | "failed" | "delivered" | "not_requested";
@@ -21894,7 +22702,6 @@ export declare const agentRoutineRunSchema: z.ZodObject<{
         delivered_message?: string | undefined;
         last_error?: string | undefined;
     } | undefined;
-    duration_ms?: number | undefined;
     routine?: string | undefined;
     structured_response?: Record<string, {} | null> | undefined;
     worker?: {
@@ -22106,6 +22913,7 @@ export declare const agentRoutineRunListResponseSchema: z.ZodObject<{
                 principal?: string | undefined;
             }[] | undefined;
         } | undefined;
+        duration_ms?: number | undefined;
         delivery?: {
             type: "thread" | "none" | "reply";
             status: "pending" | "failed" | "delivered" | "not_requested";
@@ -22115,7 +22923,6 @@ export declare const agentRoutineRunListResponseSchema: z.ZodObject<{
             delivered_message?: string | undefined;
             last_error?: string | undefined;
         } | undefined;
-        duration_ms?: number | undefined;
         routine?: string | undefined;
         structured_response?: Record<string, {} | null> | undefined;
         worker?: {
@@ -22151,6 +22958,7 @@ export declare const agentRoutineRunListResponseSchema: z.ZodObject<{
                 principal?: string | undefined;
             }[] | undefined;
         } | undefined;
+        duration_ms?: number | undefined;
         delivery?: {
             type: "thread" | "none" | "reply";
             status: "pending" | "failed" | "delivered" | "not_requested";
@@ -22160,7 +22968,6 @@ export declare const agentRoutineRunListResponseSchema: z.ZodObject<{
             delivered_message?: string | undefined;
             last_error?: string | undefined;
         } | undefined;
-        duration_ms?: number | undefined;
         routine?: string | undefined;
         structured_response?: Record<string, {} | null> | undefined;
         worker?: {
@@ -22198,6 +23005,7 @@ export declare const agentRoutineRunListResponseSchema: z.ZodObject<{
                 principal?: string | undefined;
             }[] | undefined;
         } | undefined;
+        duration_ms?: number | undefined;
         delivery?: {
             type: "thread" | "none" | "reply";
             status: "pending" | "failed" | "delivered" | "not_requested";
@@ -22207,7 +23015,6 @@ export declare const agentRoutineRunListResponseSchema: z.ZodObject<{
             delivered_message?: string | undefined;
             last_error?: string | undefined;
         } | undefined;
-        duration_ms?: number | undefined;
         routine?: string | undefined;
         structured_response?: Record<string, {} | null> | undefined;
         worker?: {
@@ -22247,6 +23054,7 @@ export declare const agentRoutineRunListResponseSchema: z.ZodObject<{
                 principal?: string | undefined;
             }[] | undefined;
         } | undefined;
+        duration_ms?: number | undefined;
         delivery?: {
             type: "thread" | "none" | "reply";
             status: "pending" | "failed" | "delivered" | "not_requested";
@@ -22256,7 +23064,6 @@ export declare const agentRoutineRunListResponseSchema: z.ZodObject<{
             delivered_message?: string | undefined;
             last_error?: string | undefined;
         } | undefined;
-        duration_ms?: number | undefined;
         routine?: string | undefined;
         structured_response?: Record<string, {} | null> | undefined;
         worker?: {
@@ -22488,6 +23295,44 @@ export declare const agentSessionSchema: z.ZodObject<{
     max_turns?: number | undefined;
     trajectory?: string | undefined;
 }>;
+/** One event from the coding harness running an agent session on a computer. */
+export interface AgentSessionEvent {
+    /** Event name: `session_started`, `message`, `tool_use`, `needs_input`, `activity`, `error`, `turn_complete`, `finished`, `adopted`, or `harness_raw`. */
+    event?: string | undefined;
+    /** Harness that emitted it. */
+    harness?: string | null | undefined;
+    /** Event ID; pass as `after` to page. */
+    id?: string | undefined;
+    /** When the event happened in the sandbox. */
+    occurred_at?: string | undefined;
+    /** Harness-specific event data. */
+    payload?: Record<string, unknown> | null | undefined;
+}
+/** Runtime validator for {@link AgentSessionEvent}. */
+export declare const agentSessionEventSchema: z.ZodObject<{
+    /** Event name: `session_started`, `message`, `tool_use`, `needs_input`, `activity`, `error`, `turn_complete`, `finished`, `adopted`, or `harness_raw`. */
+    event: z.ZodOptional<z.ZodString>;
+    /** Harness that emitted it. */
+    harness: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** Event ID; pass as `after` to page. */
+    id: z.ZodOptional<z.ZodString>;
+    /** When the event happened in the sandbox. */
+    occurred_at: z.ZodOptional<z.ZodString>;
+    /** Harness-specific event data. */
+    payload: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>>>;
+}, "strip", z.ZodTypeAny, {
+    payload?: Record<string, {} | null> | null | undefined;
+    id?: string | undefined;
+    event?: string | undefined;
+    harness?: string | null | undefined;
+    occurred_at?: string | undefined;
+}, {
+    payload?: Record<string, {} | null> | null | undefined;
+    id?: string | undefined;
+    event?: string | undefined;
+    harness?: string | null | undefined;
+    occurred_at?: string | undefined;
+}>;
 /** Paginated list response containing an array of agent session objects. */
 export interface AgentSessionListResponse {
     /** Array of agent session objects for the current page. */
@@ -22852,13 +23697,13 @@ export declare const agentToolSchema: z.ZodObject<{
         /** Reason for the current MCP setup state. */
         reason: z.ZodString;
     }, "strip", z.ZodTypeAny, {
+        reason: string;
         next_action: string;
         protocol_status: "not_checked";
-        reason: string;
     }, {
+        reason: string;
         next_action: string;
         protocol_status: "not_checked";
-        reason: string;
     }>>>;
     /** Current status of the tool. One of `"active"` or `"draft"`. */
     status: z.ZodOptional<z.ZodString>;
@@ -22887,9 +23732,9 @@ export declare const agentToolSchema: z.ZodObject<{
     parameters?: Record<string, {} | null> | undefined;
     parameters_config?: string | undefined;
     setup?: {
+        reason: string;
         next_action: string;
         protocol_status: "not_checked";
-        reason: string;
     } | null | undefined;
 }, {
     id: string;
@@ -22914,9 +23759,9 @@ export declare const agentToolSchema: z.ZodObject<{
     parameters?: Record<string, {} | null> | undefined;
     parameters_config?: string | undefined;
     setup?: {
+        reason: string;
         next_action: string;
         protocol_status: "not_checked";
-        reason: string;
     } | null | undefined;
 }>;
 /** Paginated list response containing the tools attached to an agent. */
@@ -22975,13 +23820,13 @@ export declare const agentToolListResponseSchema: z.ZodObject<{
             /** Reason for the current MCP setup state. */
             reason: z.ZodString;
         }, "strip", z.ZodTypeAny, {
+            reason: string;
             next_action: string;
             protocol_status: "not_checked";
-            reason: string;
         }, {
+            reason: string;
             next_action: string;
             protocol_status: "not_checked";
-            reason: string;
         }>>>;
         /** Current status of the tool. One of `"active"` or `"draft"`. */
         status: z.ZodOptional<z.ZodString>;
@@ -23010,9 +23855,9 @@ export declare const agentToolListResponseSchema: z.ZodObject<{
         parameters?: Record<string, {} | null> | undefined;
         parameters_config?: string | undefined;
         setup?: {
+            reason: string;
             next_action: string;
             protocol_status: "not_checked";
-            reason: string;
         } | null | undefined;
     }, {
         id: string;
@@ -23037,9 +23882,9 @@ export declare const agentToolListResponseSchema: z.ZodObject<{
         parameters?: Record<string, {} | null> | undefined;
         parameters_config?: string | undefined;
         setup?: {
+            reason: string;
             next_action: string;
             protocol_status: "not_checked";
-            reason: string;
         } | null | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
@@ -23066,9 +23911,9 @@ export declare const agentToolListResponseSchema: z.ZodObject<{
         parameters?: Record<string, {} | null> | undefined;
         parameters_config?: string | undefined;
         setup?: {
+            reason: string;
             next_action: string;
             protocol_status: "not_checked";
-            reason: string;
         } | null | undefined;
     }[];
 }, {
@@ -23095,9 +23940,9 @@ export declare const agentToolListResponseSchema: z.ZodObject<{
         parameters?: Record<string, {} | null> | undefined;
         parameters_config?: string | undefined;
         setup?: {
+            reason: string;
             next_action: string;
             protocol_status: "not_checked";
-            reason: string;
         } | null | undefined;
     }[];
 }>;
@@ -23641,6 +24486,13 @@ export declare const agentUpgradeResultSchema: z.ZodObject<{
     }>;
 }, "strip", z.ZodTypeAny, {
     status: string;
+    mode: string;
+    summary: {
+        adds: number;
+        noops: number;
+        removes: number;
+        updates: number;
+    };
     changes: {
         action: string;
         parent_template_config: {
@@ -23680,6 +24532,9 @@ export declare const agentUpgradeResultSchema: z.ZodObject<{
         } | undefined;
     }[];
     dry_run: boolean;
+    review_fingerprint?: string | undefined;
+}, {
+    status: string;
     mode: string;
     summary: {
         adds: number;
@@ -23687,9 +24542,6 @@ export declare const agentUpgradeResultSchema: z.ZodObject<{
         removes: number;
         updates: number;
     };
-    review_fingerprint?: string | undefined;
-}, {
-    status: string;
     changes: {
         action: string;
         parent_template_config: {
@@ -23729,13 +24581,6 @@ export declare const agentUpgradeResultSchema: z.ZodObject<{
         } | undefined;
     }[];
     dry_run: boolean;
-    mode: string;
-    summary: {
-        adds: number;
-        noops: number;
-        removes: number;
-        updates: number;
-    };
     review_fingerprint?: string | undefined;
 }>;
 /** Response returned by the agent upgrade endpoint, combining the updated agent, its source Solution and template, and the full upgrade diff. */
@@ -25948,6 +26793,13 @@ export declare const agentUpgradeResponseSchema: z.ZodObject<{
         }>;
     }, "strip", z.ZodTypeAny, {
         status: string;
+        mode: string;
+        summary: {
+            adds: number;
+            noops: number;
+            removes: number;
+            updates: number;
+        };
         changes: {
             action: string;
             parent_template_config: {
@@ -25987,6 +26839,9 @@ export declare const agentUpgradeResponseSchema: z.ZodObject<{
             } | undefined;
         }[];
         dry_run: boolean;
+        review_fingerprint?: string | undefined;
+    }, {
+        status: string;
         mode: string;
         summary: {
             adds: number;
@@ -25994,9 +26849,6 @@ export declare const agentUpgradeResponseSchema: z.ZodObject<{
             removes: number;
             updates: number;
         };
-        review_fingerprint?: string | undefined;
-    }, {
-        status: string;
         changes: {
             action: string;
             parent_template_config: {
@@ -26036,13 +26888,6 @@ export declare const agentUpgradeResponseSchema: z.ZodObject<{
             } | undefined;
         }[];
         dry_run: boolean;
-        mode: string;
-        summary: {
-            adds: number;
-            noops: number;
-            removes: number;
-            updates: number;
-        };
         review_fingerprint?: string | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
@@ -26123,6 +26968,13 @@ export declare const agentUpgradeResponseSchema: z.ZodObject<{
     };
     upgrade_result: {
         status: string;
+        mode: string;
+        summary: {
+            adds: number;
+            noops: number;
+            removes: number;
+            updates: number;
+        };
         changes: {
             action: string;
             parent_template_config: {
@@ -26162,13 +27014,6 @@ export declare const agentUpgradeResponseSchema: z.ZodObject<{
             } | undefined;
         }[];
         dry_run: boolean;
-        mode: string;
-        summary: {
-            adds: number;
-            noops: number;
-            removes: number;
-            updates: number;
-        };
         review_fingerprint?: string | undefined;
     };
     agent?: {
@@ -26428,6 +27273,13 @@ export declare const agentUpgradeResponseSchema: z.ZodObject<{
     };
     upgrade_result: {
         status: string;
+        mode: string;
+        summary: {
+            adds: number;
+            noops: number;
+            removes: number;
+            updates: number;
+        };
         changes: {
             action: string;
             parent_template_config: {
@@ -26467,13 +27319,6 @@ export declare const agentUpgradeResponseSchema: z.ZodObject<{
             } | undefined;
         }[];
         dry_run: boolean;
-        mode: string;
-        summary: {
-            adds: number;
-            noops: number;
-            removes: number;
-            updates: number;
-        };
         review_fingerprint?: string | undefined;
     };
     agent?: {
@@ -29094,6 +29939,14 @@ export declare const solutionUpgradeResultSchema: z.ZodObject<{
     version_change: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     status: string;
+    summary: {
+        adds: number;
+        noops: number;
+        updates: number;
+        deletes: number;
+        orphans: number;
+        referenced_orphans: number;
+    };
     changes: {
         key: string;
         action: string;
@@ -29113,14 +29966,6 @@ export declare const solutionUpgradeResultSchema: z.ZodObject<{
         }[] | undefined;
     }[];
     dry_run: boolean;
-    summary: {
-        adds: number;
-        noops: number;
-        updates: number;
-        deletes: number;
-        orphans: number;
-        referenced_orphans: number;
-    };
     version_change: string;
     message?: string | undefined;
     code?: string | undefined;
@@ -29129,6 +29974,14 @@ export declare const solutionUpgradeResultSchema: z.ZodObject<{
     incoming_solution_version?: string | undefined;
 }, {
     status: string;
+    summary: {
+        adds: number;
+        noops: number;
+        updates: number;
+        deletes: number;
+        orphans: number;
+        referenced_orphans: number;
+    };
     changes: {
         key: string;
         action: string;
@@ -29148,14 +30001,6 @@ export declare const solutionUpgradeResultSchema: z.ZodObject<{
         }[] | undefined;
     }[];
     dry_run: boolean;
-    summary: {
-        adds: number;
-        noops: number;
-        updates: number;
-        deletes: number;
-        orphans: number;
-        referenced_orphans: number;
-    };
     version_change: string;
     message?: string | undefined;
     code?: string | undefined;
@@ -29718,6 +30563,14 @@ export declare const solutionUpgradeResponseSchema: z.ZodObject<{
         version_change: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         status: string;
+        summary: {
+            adds: number;
+            noops: number;
+            updates: number;
+            deletes: number;
+            orphans: number;
+            referenced_orphans: number;
+        };
         changes: {
             key: string;
             action: string;
@@ -29737,14 +30590,6 @@ export declare const solutionUpgradeResponseSchema: z.ZodObject<{
             }[] | undefined;
         }[];
         dry_run: boolean;
-        summary: {
-            adds: number;
-            noops: number;
-            updates: number;
-            deletes: number;
-            orphans: number;
-            referenced_orphans: number;
-        };
         version_change: string;
         message?: string | undefined;
         code?: string | undefined;
@@ -29753,6 +30598,14 @@ export declare const solutionUpgradeResponseSchema: z.ZodObject<{
         incoming_solution_version?: string | undefined;
     }, {
         status: string;
+        summary: {
+            adds: number;
+            noops: number;
+            updates: number;
+            deletes: number;
+            orphans: number;
+            referenced_orphans: number;
+        };
         changes: {
             key: string;
             action: string;
@@ -29772,14 +30625,6 @@ export declare const solutionUpgradeResponseSchema: z.ZodObject<{
             }[] | undefined;
         }[];
         dry_run: boolean;
-        summary: {
-            adds: number;
-            noops: number;
-            updates: number;
-            deletes: number;
-            orphans: number;
-            referenced_orphans: number;
-        };
         version_change: string;
         message?: string | undefined;
         code?: string | undefined;
@@ -29858,6 +30703,14 @@ export declare const solutionUpgradeResponseSchema: z.ZodObject<{
     };
     upgrade_result: {
         status: string;
+        summary: {
+            adds: number;
+            noops: number;
+            updates: number;
+            deletes: number;
+            orphans: number;
+            referenced_orphans: number;
+        };
         changes: {
             key: string;
             action: string;
@@ -29877,14 +30730,6 @@ export declare const solutionUpgradeResponseSchema: z.ZodObject<{
             }[] | undefined;
         }[];
         dry_run: boolean;
-        summary: {
-            adds: number;
-            noops: number;
-            updates: number;
-            deletes: number;
-            orphans: number;
-            referenced_orphans: number;
-        };
         version_change: string;
         message?: string | undefined;
         code?: string | undefined;
@@ -29971,6 +30816,14 @@ export declare const solutionUpgradeResponseSchema: z.ZodObject<{
     };
     upgrade_result: {
         status: string;
+        summary: {
+            adds: number;
+            noops: number;
+            updates: number;
+            deletes: number;
+            orphans: number;
+            referenced_orphans: number;
+        };
         changes: {
             key: string;
             action: string;
@@ -29990,14 +30843,6 @@ export declare const solutionUpgradeResponseSchema: z.ZodObject<{
             }[] | undefined;
         }[];
         dry_run: boolean;
-        summary: {
-            adds: number;
-            noops: number;
-            updates: number;
-            deletes: number;
-            orphans: number;
-            referenced_orphans: number;
-        };
         version_change: string;
         message?: string | undefined;
         code?: string | undefined;