@archastro/sdk 0.20.0 → 0.22.0

package/dist/types/common.js

@@ -1,12 +1,18 @@
 // Copyright (c) 2026 ArchAstro Inc. Licensed under the MIT License.
 // This file is auto-generated by @archastro/sdk-generator. Do not edit.
-// Content hash: afbd6dd19860
+// Content hash: e322067d3dcd
 import { z } from "zod";
 import { automationParticipantSlotSchema, automationPrefillsSchema } from "./automations.js";
+import { computerRepositorySchema } from "./computers.js";
 import { configSchema } from "./config.js";
 import { imageSourceSchema } from "./image.js";
 import { userSchema } from "./users.js";
 import { workflowJournalSchema, workflowJournalEntrySchema } from "./workflows.js";
+/** Runtime validator for {@link Refusal}. */
+export const refusalSchema = z.object({
+    id: z.string(),
+    type: z.literal("refusal"),
+}).describe("The model declined to judge this question.");
 /** Runtime validator for {@link AclGrant}. */
 export const aclGrantSchema = z.object({
     /** Array of action strings the principal is permitted to perform, e.g. `["read", "write"]`. Must contain at least one entry. */
@@ -27,15 +33,23 @@ export const aclRemoveTargetSchema = z.object({
 export const aclSchema = z.object({
     /** Patch mode: grants to add or merge into the existing list. Cannot be combined with `grants`. */
     add: z.array(aclGrantSchema).optional().describe("Patch mode: grants to add or merge into the existing list. Cannot be combined with `grants`."),
+    /** Patch mode: denies to add or merge, replacing any grant for the same principal. */
+    add_denies: z.array(aclGrantSchema).optional().describe("Patch mode: denies to add or merge, replacing any grant for the same principal."),
+    /** Replace mode: the complete deny list. Supplying grants or denies replaces both lists. Requires schema deny support. */
+    denies: z.array(aclGrantSchema).optional().describe("Replace mode: the complete deny list. Supplying grants or denies replaces both lists. Requires schema deny support."),
     /** Replace mode: the complete new list of grants that replaces all existing entries. Send an empty array (`[]`) to clear all grants. Cannot be combined with `add` or `remove`. */
     grants: z.array(aclGrantSchema).optional().describe("Replace mode: the complete new list of grants that replaces all existing entries. Send an empty array (`[]`) to clear all grants. Cannot be combined with `add` or `remove`."),
+    /** Retain current server denies atomically in replacement or patch mode; current denies win. */
+    preserve_denies: z.boolean().optional().describe("Retain current server denies atomically in replacement or patch mode; current denies win."),
     /** Patch mode: principals whose grants should be removed from the existing list. Cannot be combined with `grants`. */
     remove: z.array(aclRemoveTargetSchema).optional().describe("Patch mode: principals whose grants should be removed from the existing list. Cannot be combined with `grants`."),
+    /** Patch mode: principals whose denies should be removed. */
+    remove_denies: z.array(aclRemoveTargetSchema).optional().describe("Patch mode: principals whose denies should be removed."),
 }).describe("An access-control list payload that supports either full replacement or targeted patch operations on a resource's grants.");
 /** Runtime validator for {@link ActivityFeedEntry}. */
 export const activityFeedEntrySchema = z.object({
     /** The agent that produced this event. Returns an agent ID (`agi_...`) by default, or an expanded agent object when the association is loaded. `null` if no agent is associated. */
-    agent: z.union([z.string(), z.object({ acl: z.object({ add: z.array(z.object({ actions: z.array(z.string()), principal: z.string().optional(), principal_type: z.string() })).optional(), grants: z.array(z.object({ actions: z.array(z.string()), principal: z.string().optional(), principal_type: z.string() })).optional(), remove: z.array(z.object({ principal: z.string().optional(), principal_type: z.string() })).optional() }).nullable().optional(), app: z.string().optional(), created_at: z.string().optional(), default_model: z.string().nullable().optional(), description: z.string().nullable().optional(), email: z.string().nullable().optional(), id: z.string(), identity: z.string().nullable().optional(), last_applied_template_config: z.string().nullable().optional(), lookup_key: z.string().nullable().optional(), metadata: z.record(z.custom((value) => value !== undefined)).optional(), name: z.string().optional(), org: z.string().nullable().optional(), org_name: z.string().nullable().optional(), originator: z.string().nullable().optional(), phone_number: z.string().nullable().optional(), sandbox: z.string().nullable().optional(), source_solution: z.object({ current_solution: z.object({ category_keys: z.array(z.string()).optional(), created_at: z.string().optional(), description: z.string().nullable().optional(), events: z.record(z.custom((value) => value !== undefined)).optional(), id: z.string(), image_url: z.string().nullable().optional(), installed_config_ids: z.array(z.string()), kind: z.string(), latest_solution: z.string().nullable().optional(), latest_version: z.string().nullable().optional(), lookup_key: z.string().nullable().optional(), metadata: z.record(z.custom((value) => value !== undefined)).optional(), name: z.string().nullable().optional(), org: z.string().nullable().optional(), org_logo: z.object({ file: z.string().nullable().optional(), height: z.number().int().nullable().optional(), media: z.string().nullable().optional(), mime_type: z.string().nullable().optional(), refresh_url: z.string().nullable().optional(), url: z.string().nullable().optional(), width: z.number().int().nullable().optional() }).nullable().optional(), org_name: z.string().nullable().optional(), org_slug: z.string().nullable().optional(), owners: z.array(z.string()), readme_url: z.string().nullable().optional(), screenshot_urls: z.array(z.string()).optional(), solution_id: z.string().nullable().optional(), solution_version: z.string().nullable().optional(), tag_keys: z.array(z.string()).optional(), template_kind: z.string().nullable().optional(), templates: z.array(z.object({ description: z.string().nullable().optional(), details: z.object({ automation_type: z.string().nullable().optional(), invoke_contract: z.object({ input_schema: z.record(z.custom((value) => value !== undefined)).nullable().optional(), participants: z.array(z.object({ description: z.string().nullable().optional(), name: z.string(), required: z.boolean(), type: z.string() })).nullable().optional(), prefills: z.object({ participants: z.record(z.custom((value) => value !== undefined)).optional(), payload: z.record(z.custom((value) => value !== undefined)).optional() }) }).nullable().optional(), type: z.literal("automation") }).nullable().optional(), display_name: z.string().nullable().optional(), id: z.string().nullable().optional(), kind: z.string(), lookup_key: z.string().nullable().optional(), name: z.string().nullable().optional(), readme_url: z.string().nullable().optional(), virtual_path: z.string().nullable().optional() })), updated_at: z.string().optional(), upgrade_available: z.boolean(), virtual_path: z.string().nullable().optional() }).optional(), solution: z.object({ category_keys: z.array(z.string()).optional(), created_at: z.string().optional(), description: z.string().nullable().optional(), events: z.record(z.custom((value) => value !== undefined)).optional(), id: z.string(), image_url: z.string().nullable().optional(), installed_config_ids: z.array(z.string()), kind: z.string(), latest_solution: z.string().nullable().optional(), latest_version: z.string().nullable().optional(), lookup_key: z.string().nullable().optional(), metadata: z.record(z.custom((value) => value !== undefined)).optional(), name: z.string().nullable().optional(), org: z.string().nullable().optional(), org_logo: z.object({ file: z.string().nullable().optional(), height: z.number().int().nullable().optional(), media: z.string().nullable().optional(), mime_type: z.string().nullable().optional(), refresh_url: z.string().nullable().optional(), url: z.string().nullable().optional(), width: z.number().int().nullable().optional() }).nullable().optional(), org_name: z.string().nullable().optional(), org_slug: z.string().nullable().optional(), owners: z.array(z.string()), readme_url: z.string().nullable().optional(), screenshot_urls: z.array(z.string()).optional(), solution_id: z.string().nullable().optional(), solution_version: z.string().nullable().optional(), tag_keys: z.array(z.string()).optional(), template_kind: z.string().nullable().optional(), templates: z.array(z.object({ description: z.string().nullable().optional(), details: z.object({ automation_type: z.string().nullable().optional(), invoke_contract: z.object({ input_schema: z.record(z.custom((value) => value !== undefined)).nullable().optional(), participants: z.array(z.object({ description: z.string().nullable().optional(), name: z.string(), required: z.boolean(), type: z.string() })).nullable().optional(), prefills: z.object({ participants: z.record(z.custom((value) => value !== undefined)).optional(), payload: z.record(z.custom((value) => value !== undefined)).optional() }) }).nullable().optional(), type: z.literal("automation") }).nullable().optional(), display_name: z.string().nullable().optional(), id: z.string().nullable().optional(), kind: z.string(), lookup_key: z.string().nullable().optional(), name: z.string().nullable().optional(), readme_url: z.string().nullable().optional(), virtual_path: z.string().nullable().optional() })), updated_at: z.string().optional(), upgrade_available: z.boolean(), virtual_path: z.string().nullable().optional() }), template: z.object({ created_at: z.string().optional(), description: z.string().nullable().optional(), display_name: z.string().nullable().optional(), id: z.string(), kind: z.string(), lookup_key: z.string().nullable().optional(), name: z.string().nullable().optional(), updated_at: z.string().optional(), virtual_path: z.string().nullable().optional() }) }).nullable().optional(), team: z.string().nullable().optional(), template_upgrade_available: z.boolean().nullable().optional(), updated_at: z.string().optional(), user: z.string().nullable().optional() })]).optional().describe("The agent that produced this event. Returns an agent ID (`agi_...`) by default, or an expanded agent object when the association is loaded. `null` if no agent is associated."),
+    agent: z.union([z.string(), z.object({ acl: z.object({ add: z.array(z.object({ actions: z.array(z.string()), principal: z.string().optional(), principal_type: z.string() })).optional(), add_denies: z.array(z.object({ actions: z.array(z.string()), principal: z.string().optional(), principal_type: z.string() })).optional(), denies: z.array(z.object({ actions: z.array(z.string()), principal: z.string().optional(), principal_type: z.string() })).optional(), grants: z.array(z.object({ actions: z.array(z.string()), principal: z.string().optional(), principal_type: z.string() })).optional(), preserve_denies: z.boolean().optional(), remove: z.array(z.object({ principal: z.string().optional(), principal_type: z.string() })).optional(), remove_denies: z.array(z.object({ principal: z.string().optional(), principal_type: z.string() })).optional() }).nullable().optional(), app: z.string().optional(), created_at: z.string().optional(), default_model: z.string().nullable().optional(), description: z.string().nullable().optional(), email: z.string().nullable().optional(), id: z.string(), identity: z.string().nullable().optional(), last_applied_template_config: z.string().nullable().optional(), lookup_key: z.string().nullable().optional(), metadata: z.record(z.custom((value) => value !== undefined)).optional(), name: z.string().optional(), org: z.string().nullable().optional(), org_name: z.string().nullable().optional(), originator: z.string().nullable().optional(), phone_number: z.string().nullable().optional(), sandbox: z.string().nullable().optional(), source_solution: z.object({ current_solution: z.object({ category_keys: z.array(z.string()).optional(), created_at: z.string().optional(), description: z.string().nullable().optional(), events: z.record(z.custom((value) => value !== undefined)).optional(), id: z.string(), image_url: z.string().nullable().optional(), installed_config_ids: z.array(z.string()), kind: z.string(), latest_solution: z.string().nullable().optional(), latest_version: z.string().nullable().optional(), lookup_key: z.string().nullable().optional(), metadata: z.record(z.custom((value) => value !== undefined)).optional(), name: z.string().nullable().optional(), org: z.string().nullable().optional(), org_logo: z.object({ file: z.string().nullable().optional(), height: z.number().int().nullable().optional(), media: z.string().nullable().optional(), mime_type: z.string().nullable().optional(), refresh_url: z.string().nullable().optional(), url: z.string().nullable().optional(), width: z.number().int().nullable().optional() }).nullable().optional(), org_name: z.string().nullable().optional(), org_slug: z.string().nullable().optional(), owners: z.array(z.string()), readme_url: z.string().nullable().optional(), screenshot_urls: z.array(z.string()).optional(), solution_id: z.string().nullable().optional(), solution_version: z.string().nullable().optional(), tag_keys: z.array(z.string()).optional(), template_kind: z.string().nullable().optional(), templates: z.array(z.object({ description: z.string().nullable().optional(), details: z.object({ automation_type: z.string().nullable().optional(), invoke_contract: z.object({ input_schema: z.record(z.custom((value) => value !== undefined)).nullable().optional(), participants: z.array(z.object({ description: z.string().nullable().optional(), name: z.string(), required: z.boolean(), type: z.string() })).nullable().optional(), prefills: z.object({ participants: z.record(z.custom((value) => value !== undefined)).optional(), payload: z.record(z.custom((value) => value !== undefined)).optional() }) }).nullable().optional(), type: z.literal("automation") }).nullable().optional(), display_name: z.string().nullable().optional(), id: z.string().nullable().optional(), kind: z.string(), lookup_key: z.string().nullable().optional(), name: z.string().nullable().optional(), readme_url: z.string().nullable().optional(), virtual_path: z.string().nullable().optional() })), updated_at: z.string().optional(), upgrade_available: z.boolean(), virtual_path: z.string().nullable().optional() }).optional(), solution: z.object({ category_keys: z.array(z.string()).optional(), created_at: z.string().optional(), description: z.string().nullable().optional(), events: z.record(z.custom((value) => value !== undefined)).optional(), id: z.string(), image_url: z.string().nullable().optional(), installed_config_ids: z.array(z.string()), kind: z.string(), latest_solution: z.string().nullable().optional(), latest_version: z.string().nullable().optional(), lookup_key: z.string().nullable().optional(), metadata: z.record(z.custom((value) => value !== undefined)).optional(), name: z.string().nullable().optional(), org: z.string().nullable().optional(), org_logo: z.object({ file: z.string().nullable().optional(), height: z.number().int().nullable().optional(), media: z.string().nullable().optional(), mime_type: z.string().nullable().optional(), refresh_url: z.string().nullable().optional(), url: z.string().nullable().optional(), width: z.number().int().nullable().optional() }).nullable().optional(), org_name: z.string().nullable().optional(), org_slug: z.string().nullable().optional(), owners: z.array(z.string()), readme_url: z.string().nullable().optional(), screenshot_urls: z.array(z.string()).optional(), solution_id: z.string().nullable().optional(), solution_version: z.string().nullable().optional(), tag_keys: z.array(z.string()).optional(), template_kind: z.string().nullable().optional(), templates: z.array(z.object({ description: z.string().nullable().optional(), details: z.object({ automation_type: z.string().nullable().optional(), invoke_contract: z.object({ input_schema: z.record(z.custom((value) => value !== undefined)).nullable().optional(), participants: z.array(z.object({ description: z.string().nullable().optional(), name: z.string(), required: z.boolean(), type: z.string() })).nullable().optional(), prefills: z.object({ participants: z.record(z.custom((value) => value !== undefined)).optional(), payload: z.record(z.custom((value) => value !== undefined)).optional() }) }).nullable().optional(), type: z.literal("automation") }).nullable().optional(), display_name: z.string().nullable().optional(), id: z.string().nullable().optional(), kind: z.string(), lookup_key: z.string().nullable().optional(), name: z.string().nullable().optional(), readme_url: z.string().nullable().optional(), virtual_path: z.string().nullable().optional() })), updated_at: z.string().optional(), upgrade_available: z.boolean(), virtual_path: z.string().nullable().optional() }), template: z.object({ created_at: z.string().optional(), description: z.string().nullable().optional(), display_name: z.string().nullable().optional(), id: z.string(), kind: z.string(), lookup_key: z.string().nullable().optional(), name: z.string().nullable().optional(), updated_at: z.string().optional(), virtual_path: z.string().nullable().optional() }) }).nullable().optional(), team: z.string().nullable().optional(), template_upgrade_available: z.boolean().nullable().optional(), updated_at: z.string().optional(), user: z.string().nullable().optional() })]).optional().describe("The agent that produced this event. Returns an agent ID (`agi_...`) by default, or an expanded agent object when the association is loaded. `null` if no agent is associated."),
     /** ID of the application that produced this entry (`dap_...`). `null` if not scoped to an app. */
     app: z.string().optional().describe("ID of the application that produced this entry (`dap_...`). `null` if not scoped to an app."),
     /** Array of attachment objects associated with this entry. Each attachment has a `type` field (e.g. `"file"`, `"task"`, `"artifact"`) and type-specific additional fields. Empty array when there are no attachments. */
@@ -129,6 +143,51 @@ export const installedConfigEntrySchema = z.object({
     /** Stored `lookup_key` for this config after any suffix has been applied. `null` for `File` children inside a skill bundle, which are keyed by `(parent_id, relative_path)` rather than by `lookup_key`. */
     lookup_key: z.string().nullable().optional().describe("Stored `lookup_key` for this config after any suffix has been applied. `null` for `File` children inside a skill bundle, which are keyed by `(parent_id, relative_path)` rather than by `lookup_key`."),
 }).describe("A slim summary of a single config record created during an agent install transaction. Returned as an entry in `AgentCreateResponse.installed_configs`.");
+/** Runtime validator for {@link Approvers}. */
+export const approversSchema = z.object({
+    mode: z.string(),
+}).describe("Approval policy, excluding user IDs.");
+/** Runtime validator for {@link Origin}. */
+export const originSchema = z.object({
+    routine_id: z.string().nullable().optional(),
+    session_id: z.string().nullable().optional(),
+    thread_id: z.string().nullable().optional(),
+}).describe("Origin references.");
+/** Runtime validator for {@link SelfUpdateChange}. */
+export const selfUpdateChangeSchema = z.object({
+    action: z.string().optional(),
+    class: z.string().optional(),
+    path: z.string().optional(),
+    tier: z.string().optional(),
+}).describe("Public review fields for one proposed self-update change.");
+/** Runtime validator for {@link Payload}. */
+export const payloadSchema = z.object({
+    changes: z.array(selfUpdateChangeSchema).optional(),
+    from_version: z.string().optional(),
+    instructions_md: z.string().optional(),
+    key: z.string().optional(),
+    overwrite: z.boolean().optional(),
+    prompt: z.string().optional(),
+    proposal_id: z.string().optional(),
+    question: z.string().optional(),
+    rationale: z.string().optional(),
+    to_version: z.string().optional(),
+    validate_script: z.string().optional(),
+}).describe("Kind-safe request payload.");
+/** Runtime validator for {@link Resolution}. */
+export const resolutionSchema = z.object({
+    answer: z.string().optional(),
+    key: z.string().optional(),
+    reason: z.string().optional(),
+    set: z.boolean().optional(),
+    status: z.string().optional(),
+    to_version: z.string().optional(),
+}).describe("Answer or rejection reason; null before resolution.");
+/** Runtime validator for {@link Summary}. */
+export const summarySchema = z.object({
+    lines: z.array(z.string()),
+    title: z.string(),
+}).describe("Kind-provided summary.");
 /** Runtime validator for {@link MessagePolicy}. */
 export const messagePolicySchema = z.object({
     /** Required and non-empty for private visibility. Sources are additive. Routine owner includes the agent owner and optional user co-owner. */
@@ -174,10 +233,14 @@ export const setupSchema = z.object({
 }).describe("Current MCP setup assessment, not a historical downgrade reason or upstream protocol probe.");
 /** Runtime validator for {@link MediaVariant}. */
 export const mediaVariantSchema = z.object({
+    /** Size of the stored bytes. */
+    byte_size: z.number().int().nullable().optional().describe("Size of the stored bytes."),
     /** MIME type of this variant's file (e.g., `"image/jpeg"`, `"video/mp4"`). `null` if the file is not loaded. */
     content_type: z.string().nullable().optional().describe("MIME type of this variant's file (e.g., `\"image/jpeg\"`, `\"video/mp4\"`). `null` if the file is not loaded."),
     /** When this variant was created (ISO 8601). */
     created_at: z.string().optional().describe("When this variant was created (ISO 8601)."),
+    /** Client-declared video duration in milliseconds; not server-probed. */
+    duration_ms: z.number().int().nullable().optional().describe("Client-declared video duration in milliseconds; not server-probed."),
     /** ID of the underlying storage file that backs this variant (`fil_...`). */
     file: z.string().optional().describe("ID of the underlying storage file that backs this variant (`fil_...`)."),
     /** Original filename of the uploaded file for this variant. `null` if the file is not loaded. */
@@ -188,10 +251,14 @@ export const mediaVariantSchema = z.object({
     id: z.string().describe("Media variant ID (`mvr_...`)."),
     /** Resolved image delivery metadata for this variant, including dimensions and CDN URL. `null` for non-image content types. */
     image_source: imageSourceSchema.nullable().optional().describe("Resolved image delivery metadata for this variant, including dimensions and CDN URL. `null` for non-image content types."),
+    /** Lowercase SHA-256 of the stored bytes. */
+    sha256: z.string().nullable().optional().describe("Lowercase SHA-256 of the stored bytes."),
     /** When this variant was last updated (ISO 8601). */
     updated_at: z.string().optional().describe("When this variant was last updated (ISO 8601)."),
     /** Signed download URL for this variant, resolved at request time. `null` if the file is unavailable. */
     url: z.string().nullable().optional().describe("Signed download URL for this variant, resolved at request time. `null` if the file is unavailable."),
+    /** Expiry of this variant's playable URL. */
+    url_expires_at: z.string().nullable().optional().describe("Expiry of this variant's playable URL."),
     /** Identifier for this variant's processing tier. Common values include `"original"` (the unmodified upload) and `"thumbnail"` (a resized preview). */
     variant_key: z.string().optional().describe("Identifier for this variant's processing tier. Common values include `\"original\"` (the unmodified upload) and `\"thumbnail\"` (a resized preview)."),
     /** Width of this variant in pixels. `null` if not recorded. */
@@ -422,13 +489,6 @@ export const commandSchema = z.object({
     /** JSON Schema describing the shape of a successful output. `null` if the command produces no output on success. */
     successOutput: z.record(z.custom((value) => value !== undefined)).optional().describe("JSON Schema describing the shape of a successful output. `null` if the command produces no output on success."),
 }).describe("A workflow command that a workflow node can invoke, including its identifier, human-readable name, and JSON schemas for its inputs and outputs.");
-/** Runtime validator for {@link ComputerExecResult}. */
-export const computerExecResultSchema = z.object({
-    /** 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.number().int().optional().describe("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."),
-    /** The combined stdout and stderr output produced by the command. `null` if the command produced no output. */
-    output: z.string().optional().describe("The combined stdout and stderr output produced by the command. `null` if the command produced no output."),
-}).describe("The result of executing a shell command on an agent's computer environment. Contains the captured output and the process exit code.");
 /** Runtime validator for {@link ContextDocument}. */
 export const contextDocumentSchema = z.object({
     /** ID of the agent that owns this document (`agi_...`). `null` if owned by a user or team. */
@@ -547,12 +607,20 @@ export const effectiveAccessEntitlementSchema = z.object({
     granted: z.boolean().describe("Whether any eligible source grants the key."),
     /** Stable entitlement catalog key. */
     key: z.string().describe("Stable entitlement catalog key."),
+    /** Unexpired metered allowance, including exhausted grants; null for boolean entitlements. */
+    limit: z.number().int().nullable().optional().describe("Unexpired metered allowance, including exhausted grants; null for boolean entitlements."),
     /** Privacy-safe principal kinds that contribute to the effective value. */
     provided_by: z.array(z.enum(["personal", "organization"])).describe("Privacy-safe principal kinds that contribute to the effective value."),
+    /** 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.number().int().nullable().optional().describe("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."),
+    /** Remaining metered allowance credits; null for boolean entitlements. */
+    remaining: z.number().int().nullable().optional().describe("Remaining metered allowance credits; null for boolean entitlements."),
+    /** Signed metered consumption in the allowance window; may be negative after reversals. Null for boolean entitlements. */
+    used: z.number().int().nullable().optional().describe("Signed metered consumption in the allowance window; may be negative after reversals. Null for boolean entitlements."),
     /** Merged entitlement value, or `null` when the key is not granted. */
     value: z.boolean().nullable().optional().describe("Merged entitlement value, or `null` when the key is not granted."),
     /** Catalog type used to interpret `value`. */
-    value_type: z.literal("boolean").describe("Catalog type used to interpret `value`."),
+    value_type: z.enum(["boolean", "metered"]).describe("Catalog type used to interpret `value`."),
 }).describe("A billing-derived effective entitlement for the authenticated user.");
 /** Runtime validator for {@link EffectiveAccess}. */
 export const effectiveAccessSchema = z.object({
@@ -569,6 +637,8 @@ export const currentUserSchema = z.object({
     app: z.string().nullable().optional().describe("ID of the token-scoped app (`dap_...`)."),
     /** Display name of the token-scoped app. */
     app_name: z.string().nullable().optional().describe("Display name of the token-scoped app."),
+    /** Stable public URL of the profile picture. Unlike `profile_picture.url` it does not expire, so clients can store it; it stops resolving when the picture is replaced. `null` when the user has no profile picture. */
+    avatar_url: z.string().nullable().optional().describe("Stable public URL of the profile picture. Unlike `profile_picture.url` it does not expire, so clients can store it; it stops resolving when the picture is replaced. `null` when the user has no profile picture."),
     /** Present only when the request supplies one or more `entitlement[]` values. */
     effective_access: effectiveAccessSchema.optional().describe("Present only when the request supplies one or more `entitlement[]` values."),
     /** Email address of the user. */
@@ -583,6 +653,8 @@ export const currentUserSchema = z.object({
     name: z.string().nullable().optional().describe("Full display name of the user."),
     /** The authenticated user's notification preferences. */
     notification_settings: z.record(z.custom((value) => value !== undefined)).describe("The authenticated user's notification preferences."),
+    /** Registered display name of the verified OAuth client, when available. Not a verified vendor identity. */
+    oauth_client_name: z.string().optional().describe("Registered display name of the verified OAuth client, when available. Not a verified vendor identity."),
     /** ID of the current organization (`org_...`). */
     org: z.string().nullable().optional().describe("ID of the current organization (`org_...`)."),
     /** Whether the current organization is company-domain or person-owned. */
@@ -606,8 +678,12 @@ export const currentUserSchema = z.object({
 export const customObjectSchema = z.object({
     /** 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: aclSchema.optional().describe("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."),
+    /** ID of the agent that owns this object (`agt_...`). `null` for other ownership types. */
+    agent: z.string().optional().describe("ID of the agent that owns this object (`agt_...`). `null` for other ownership types."),
     /** When the custom object was created (ISO 8601). */
     created_at: z.string().optional().describe("When the custom object was created (ISO 8601)."),
+    /** Absolute expiry time (RFC 3339). Null when no expiry is set. */
+    expires_at: z.string().nullable().optional().describe("Absolute expiry time (RFC 3339). Null when no expiry is set."),
     /** Map of field names to their current values as defined by the object's schema type. */
     fields: z.record(z.custom((value) => value !== undefined)).optional().describe("Map of field names to their current values as defined by the object's schema type."),
     /** Unique identifier for the custom object (`cobj_...`). */
@@ -654,10 +730,10 @@ export const customObjectListResponseSchema = z.object({
     page: z.number().int().describe("The current page number (1-indexed)."),
     /** Maximum number of results returned per page. */
     page_size: z.number().int().describe("Maximum number of results returned per page."),
-    /** Total number of custom objects matching the query across all pages. */
-    total_entries: z.number().int().describe("Total number of custom objects matching the query across all pages."),
-    /** Total number of pages available for the current query. */
-    total_pages: z.number().int().describe("Total number of pages available for the current query."),
+    /** Total number of custom objects matching the query across all pages; null when include_count is false. */
+    total_entries: z.number().int().nullable().describe("Total number of custom objects matching the query across all pages; null when include_count is false."),
+    /** Total number of pages available for the current query; null when include_count is false. */
+    total_pages: z.number().int().nullable().describe("Total number of pages available for the current query; null when include_count is false."),
 }).describe("A paginated page of custom objects returned by a list operation. Use the pagination fields to navigate through result sets.");
 /** Runtime validator for {@link CustomObjectPresenceAck}. */
 export const customObjectPresenceAckSchema = z.object({
@@ -898,27 +974,43 @@ export const installationSourceListResponseSchema = z.object({
 }).describe("Paginated list response containing installation source objects attached to an installation.");
 /** Runtime validator for {@link KeyValueStorageEntry}. */
 export const keyValueStorageEntrySchema = z.object({
+    /** Agent owner, if any. */
+    agent: z.string().optional().describe("Agent owner, if any."),
     /** When this storage entry was first created (ISO 8601). `null` if not yet persisted. */
     created_at: z.string().optional().describe("When this storage entry was first created (ISO 8601). `null` if not yet persisted."),
+    /** Expiry deadline, or null for entries without expiry. */
+    expires_at: z.string().optional().describe("Expiry deadline, or null for entries without expiry."),
     /** The string key used to store and look up this entry. */
     key: z.string().describe("The string key used to store and look up this entry."),
+    /** Organization scope. */
+    org: z.string().optional().describe("Organization scope."),
+    /** Team owner, if any. */
+    team: z.string().optional().describe("Team owner, if any."),
     /** When this storage entry was last updated (ISO 8601). `null` if not yet persisted. */
     updated_at: z.string().optional().describe("When this storage entry was last updated (ISO 8601). `null` if not yet persisted."),
-    /** ID of the user who owns this storage entry (`usr_...`). */
-    user: z.string().describe("ID of the user who owns this storage entry (`usr_...`)."),
+    /** ID of the user owner, or null for non-user ownership. */
+    user: z.string().optional().describe("ID of the user owner, or null for non-user ownership."),
     /** The string value stored under `key` for this user. */
     value: z.string().describe("The string value stored under `key` for this user."),
-}).describe("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.");
+}).describe("An owner-scoped key/value pair within an app, optionally expiring.");
 /** Runtime validator for {@link KeyValueStorageEntryWithUser}. */
 export const keyValueStorageEntryWithUserSchema = z.object({
+    /** Agent owner, if any. */
+    agent: z.string().optional().describe("Agent owner, if any."),
     /** When this storage entry was first created (ISO 8601). */
     created_at: z.string().describe("When this storage entry was first created (ISO 8601)."),
+    /** Expiry deadline, or null for entries without expiry. */
+    expires_at: z.string().optional().describe("Expiry deadline, or null for entries without expiry."),
     /** The string key used to store and look up this entry. */
     key: z.string().describe("The string key used to store and look up this entry."),
+    /** Organization scope. */
+    org: z.string().optional().describe("Organization scope."),
+    /** Team owner, if any. */
+    team: z.string().optional().describe("Team owner, if any."),
     /** When this storage entry was last updated (ISO 8601). */
     updated_at: z.string().describe("When this storage entry was last updated (ISO 8601)."),
-    /** ID of the user who owns this storage entry (`usr_...`). */
-    user: z.string().describe("ID of the user who owns this storage entry (`usr_...`)."),
+    /** ID of the user owner, or null for non-user ownership. */
+    user: z.string().optional().describe("ID of the user owner, or null for non-user ownership."),
     /** Email address of the owning user. `null` for end-user (user-JWT) callers; populated for developer and server-to-server callers. */
     user_email: z.string().optional().describe("Email address of the owning user. `null` for end-user (user-JWT) callers; populated for developer and server-to-server callers."),
     /** Display name of the owning user. `null` for end-user (user-JWT) callers; populated for developer and server-to-server callers. */
@@ -1517,33 +1609,41 @@ export const agentSchema = z.object({
 /** Runtime validator for {@link AgentComputer}. */
 export const agentComputerSchema = z.object({
     /** ID of the agent that owns this computer (`agi_...`). `null` if the computer is not yet assigned to an agent. */
-    agent: z.string().optional().describe("ID of the agent that owns this computer (`agi_...`). `null` if the computer is not yet assigned to an agent."),
+    agent: z.string().nullable().optional().describe("ID of the agent that owns this computer (`agi_...`). `null` if the computer is not yet assigned to an agent."),
     /** ID of the app this computer belongs to (`dap_...`). */
     app: z.string().optional().describe("ID of the app this computer belongs to (`dap_...`)."),
+    /** Bootstrap results, including each repository's status, commit and error. */
+    bootstrap: z.record(z.custom((value) => value !== undefined)).optional().describe("Bootstrap results, including each repository's status, commit and error."),
     /** Provider-specific configuration key-value pairs for the computer. Structure depends on the underlying compute provider. */
     config: z.record(z.custom((value) => value !== undefined)).optional().describe("Provider-specific configuration key-value pairs for the computer. Structure depends on the underlying compute provider."),
     /** When the computer was created (ISO 8601). */
     created_at: z.string().optional().describe("When the computer was created (ISO 8601)."),
     /** Human-readable error description when `status` is `"error"`. `null` otherwise. */
-    error_message: z.string().optional().describe("Human-readable error description when `status` is `\"error\"`. `null` otherwise."),
+    error_message: z.string().nullable().optional().describe("Human-readable error description when `status` is `\"error\"`. `null` otherwise."),
     /** Computer ID (`cmp_...`). */
     id: z.string().describe("Computer ID (`cmp_...`)."),
+    /** Stable key unique within the thread, or null if unset. */
+    key: z.string().nullable().optional().describe("Stable key unique within the thread, or null if unset."),
     /** When the computer last reported activity or received a command. `null` if the computer has never been active. */
-    last_active_at: z.string().optional().describe("When the computer last reported activity or received a command. `null` if the computer has never been active."),
+    last_active_at: z.string().nullable().optional().describe("When the computer last reported activity or received a command. `null` if the computer has never been active."),
     /** Unique, stable identifier you assign to this computer within its app. `null` if not set. */
-    lookup_key: z.string().optional().describe("Unique, stable identifier you assign to this computer within its app. `null` if not set."),
+    lookup_key: z.string().nullable().optional().describe("Unique, stable identifier you assign to this computer within its app. `null` if not set."),
     /** Arbitrary key-value metadata you attached to the computer. `null` if none was provided. */
     metadata: z.record(z.custom((value) => value !== undefined)).optional().describe("Arbitrary key-value metadata you attached to the computer. `null` if none was provided."),
     /** Human-readable display name for the computer. `null` if not set. */
     name: z.string().optional().describe("Human-readable display name for the computer. `null` if not set."),
-    /** Compute backend powering this computer: `"sprites"` (Fly Sprites) or `"vercel"` (Vercel Sandbox). */
-    provider: z.string().optional().describe("Compute backend powering this computer: `\"sprites\"` (Fly Sprites) or `\"vercel\"` (Vercel Sandbox)."),
-    /** 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.string().optional().describe("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\"`)."),
+    /** Compute backend powering this computer: `"sprites"` (Fly Sprites), `"vercel"` (Vercel Sandbox), `"e2b"` (E2B) or `"devbox"` (an ArchAstro devbox owned by the computer's user). */
+    provider: z.string().optional().describe("Compute backend powering this computer: `\"sprites\"` (Fly Sprites), `\"vercel\"` (Vercel Sandbox), `\"e2b\"` (E2B) or `\"devbox\"` (an ArchAstro devbox owned by the computer's user)."),
+    /** 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.string().nullable().optional().describe("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\"`)."),
+    /** Ordered GitHub checkouts with repository and nullable ref; the first checkout is primary. */
+    repositories: z.array(computerRepositorySchema).optional().describe("Ordered GitHub checkouts with repository and nullable ref; the first checkout is primary."),
     /** 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.string().optional().describe("URL of the live screenshot sprite used to render a real-time preview of the computer's screen. `null` when no sprite is available."),
-    /** Current lifecycle state of the computer. Common values include `"provisioning"`, `"ready"`, `"error"`, and `"terminated"`. */
-    status: z.string().optional().describe("Current lifecycle state of the computer. Common values include `\"provisioning\"`, `\"ready\"`, `\"error\"`, and `\"terminated\"`."),
+    sprite_url: z.string().nullable().optional().describe("URL of the live screenshot sprite used to render a real-time preview of the computer's screen. `null` when no sprite is available."),
+    /** Current lifecycle state of the computer. Common values include `"provisioning"`, `"ready"`, `"paused"` (resumes on use), `"error"`, and `"destroyed"`. */
+    status: z.string().nullable().optional().describe("Current lifecycle state of the computer. Common values include `\"provisioning\"`, `\"ready\"`, `\"paused\"` (resumes on use), `\"error\"`, and `\"destroyed\"`."),
+    /** Thread this computer belongs to, or null for a non-thread computer. */
+    thread_id: z.string().nullable().optional().describe("Thread this computer belongs to, or null for a non-thread computer."),
     /** When the computer record was last modified (ISO 8601). */
     updated_at: z.string().optional().describe("When the computer record was last modified (ISO 8601)."),
 }).describe("A cloud computer resource provisioned for an agent to use for browser and desktop automation tasks.");
@@ -1658,6 +1758,47 @@ export const agentListResponseSchema = z.object({
     /** Total number of pages available given the current `page_size`. */
     total_pages: z.number().int().optional().describe("Total number of pages available given the current `page_size`."),
 }).describe("Paginated list of agent objects. Use the pagination fields to traverse multiple pages of results.");
+/** Runtime validator for {@link AgentRequestAgent}. */
+export const agentRequestAgentSchema = z.object({
+    id: z.string(),
+    name: z.string().nullable().optional(),
+}).describe("Originating agent.");
+/** Runtime validator for {@link AgentRequest}. */
+export const agentRequestSchema = z.object({
+    /** Originating agent. */
+    agent: agentRequestAgentSchema.optional().describe("Originating agent."),
+    /** Approval policy, excluding user IDs. */
+    approvers: approversSchema.optional().describe("Approval policy, excluding user IDs."),
+    /** Expiration time. */
+    expires_at: z.string().optional().describe("Expiration time."),
+    /** Request ID (`arq_...`). */
+    id: z.string().describe("Request ID (`arq_...`)."),
+    /** Whether the authenticated caller is an approver, regardless of request status. */
+    is_approver: z.boolean().optional().describe("Whether the authenticated caller is an approver, regardless of request status."),
+    /** Registered request kind. */
+    kind: z.string().optional().describe("Registered request kind."),
+    /** Origin references. */
+    origin: originSchema.optional().describe("Origin references."),
+    /** Kind-safe request payload. */
+    payload: payloadSchema.optional().describe("Kind-safe request payload."),
+    /** Answer or rejection reason; null before resolution. */
+    resolution: resolutionSchema.nullable().optional().describe("Answer or rejection reason; null before resolution."),
+    /** Resolution time. */
+    resolved_at: z.string().optional().describe("Resolution time."),
+    /** Resolving user ID. */
+    resolved_by: z.string().optional().describe("Resolving user ID."),
+    /** Request status. */
+    status: z.string().optional().describe("Request status."),
+    /** Kind-provided summary. */
+    summary: summarySchema.optional().describe("Kind-provided summary."),
+}).describe("A request for human approval or input. Secret input is never returned.");
+/** Runtime validator for {@link AgentRequestListResponse}. */
+export const agentRequestListResponseSchema = z.object({
+    /** Visible requests. */
+    data: z.array(agentRequestSchema).describe("Visible requests."),
+    /** Pass as cursor for the next page; null at the end. */
+    next_cursor: z.string().optional().describe("Pass as cursor for the next page; null at the end."),
+}).describe("A page of visible agent requests.");
 /** Runtime validator for {@link AgentRoutine}. */
 export const agentRoutineSchema = z.object({
     /** 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. */
@@ -1851,6 +1992,19 @@ export const agentSessionSchema = z.object({
     /** ID of the trajectory that records the full message history for this session (`trj_...`). `null` until the session has started. */
     trajectory: z.string().optional().describe("ID of the trajectory that records the full message history for this session (`trj_...`). `null` until the session has started."),
 }).describe("A durable agent session record representing a single AI task execution. Tracks status, trajectory, result, and any inbox messages delivered to the session.");
+/** Runtime validator for {@link AgentSessionEvent}. */
+export const agentSessionEventSchema = z.object({
+    /** Event name: `session_started`, `message`, `tool_use`, `needs_input`, `activity`, `error`, `turn_complete`, `finished`, `adopted`, or `harness_raw`. */
+    event: z.string().optional().describe("Event name: `session_started`, `message`, `tool_use`, `needs_input`, `activity`, `error`, `turn_complete`, `finished`, `adopted`, or `harness_raw`."),
+    /** Harness that emitted it. */
+    harness: z.string().nullable().optional().describe("Harness that emitted it."),
+    /** Event ID; pass as `after` to page. */
+    id: z.string().optional().describe("Event ID; pass as `after` to page."),
+    /** When the event happened in the sandbox. */
+    occurred_at: z.string().optional().describe("When the event happened in the sandbox."),
+    /** Harness-specific event data. */
+    payload: z.record(z.custom((value) => value !== undefined)).nullable().optional().describe("Harness-specific event data."),
+}).describe("One event from the coding harness running an agent session on a computer.");
 /** Runtime validator for {@link AgentSessionListResponse}. */
 export const agentSessionListResponseSchema = z.object({
     /** Array of agent session objects for the current page. */
@@ -1967,8 +2121,8 @@ export const agentUpgradeChangeSchema = z.object({
     parent_template_config: upgradeTemplateSummarySchema.describe("Summary of the parent AgentTemplate config (`cfg_...`) being applied in this upgrade."),
     /** Resource-type-specific identity details. Tools: `tool_type`, `builtin_tool_key`, `name_prefix`, `handler_type`, `instruction`. Routines: `handler_type`, `preset_name`, `event_type`, `schedule`, `trigger_context`. Skills: `instruction`. Computers: `region`. Knowledge: `mode`, `knowledge_key`, `extraction_output_ref`. Only populated keys are present; `null` when nothing is known. */
     resource: z.record(z.custom((value) => value !== undefined)).optional().describe("Resource-type-specific identity details. Tools: `tool_type`, `builtin_tool_key`, `name_prefix`, `handler_type`, `instruction`. Routines: `handler_type`, `preset_name`, `event_type`, `schedule`, `trigger_context`. Skills: `instruction`. Computers: `region`. Knowledge: `mode`, `knowledge_key`, `extraction_output_ref`. Only populated keys are present; `null` when nothing is known."),
-    /** Type of the resource being changed. One of `"agent"`, `"tool"`, `"routine"`, `"skill"`, `"computer"`, or `"knowledge"`. */
-    resource_type: z.string().describe("Type of the resource being changed. One of `\"agent\"`, `\"tool\"`, `\"routine\"`, `\"skill\"`, `\"computer\"`, or `\"knowledge\"`."),
+    /** Type of the resource being changed. One of `"agent"`, `"tool"`, `"routine"`, `"skill"`, `"computer"`, `"endpoint"`, or `"knowledge"`. */
+    resource_type: z.string().describe("Type of the resource being changed. One of `\"agent\"`, `\"tool\"`, `\"routine\"`, `\"skill\"`, `\"computer\"`, `\"endpoint\"`, or `\"knowledge\"`."),
     /** Summary of the specific child template config (`cfg_...`) that defines this resource. `null` when no source template is resolvable. */
     source_template_config: upgradeTemplateSummarySchema.optional().describe("Summary of the specific child template config (`cfg_...`) that defines this resource. `null` when no source template is resolvable."),
 }).describe("One child-resource change produced by an agent upgrade, describing the action to be taken on a single resource.");