@archastro/sdk 0.19.0 → 0.21.0

package/dist/types/common.js

@@ -1,12 +1,17 @@
 // Copyright (c) 2026 ArchAstro Inc. Licensed under the MIT License.
 // This file is auto-generated by @archastro/sdk-generator. Do not edit.
-// Content hash: d38489a6b420
+// Content hash: e9c10f6c8b7c
 import { z } from "zod";
 import { automationParticipantSlotSchema, automationPrefillsSchema } from "./automations.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. */
@@ -129,6 +134,30 @@ 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 Payload}. */
+export const payloadSchema = z.object({
+    question: z.string(),
+}).describe("Question request payload.");
+/** Runtime validator for {@link Resolution}. */
+export const resolutionSchema = z.object({
+    answer: z.string().optional(),
+    reason: 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 +203,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 +221,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. */
@@ -217,6 +254,8 @@ export const attachmentSchema = z.object({
     image_url: z.string().nullable().optional().describe("URL of the preview image extracted from the scraped page. Present on `scraped_link` type only. `null` otherwise."),
     /** Width in pixels of the scraped preview image. Present on `scraped_link` type only. `null` otherwise. */
     image_width: z.number().int().nullable().optional().describe("Width in pixels of the scraped preview image. Present on `scraped_link` type only. `null` otherwise."),
+    /** For `structured_data` type, what the data is about as set by the sender (for example `"pr:14963"`), copied from the record so it can be read without `object`. Not unique. `null` when unset and on other types. */
+    key: z.string().nullable().optional().describe("For `structured_data` type, what the data is about as set by the sender (for example `\"pr:14963\"`), copied from the record so it can be read without `object`. Not unique. `null` when unset and on other types."),
     /** The media category, e.g. `"video"` or `"audio"`. Present on `media` type only; omitted otherwise. */
     media_type: z.string().optional().describe("The media category, e.g. `\"video\"` or `\"audio\"`. Present on `media` type only; omitted otherwise."),
     /** Display name of the media item. Present on `media` type only. `null` otherwise. */
@@ -420,13 +459,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. */
@@ -545,12 +577,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({
@@ -581,6 +621,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. */
@@ -604,8 +646,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_...`). */
@@ -652,10 +698,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({
@@ -896,27 +942,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. */
@@ -1515,7 +1577,7 @@ 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_...`)."),
     /** Provider-specific configuration key-value pairs for the computer. Structure depends on the underlying compute provider. */
@@ -1523,25 +1585,29 @@ export const agentComputerSchema = z.object({
     /** 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) or `"e2b"` (E2B). */
+    provider: z.string().optional().describe("Compute backend powering this computer: `\"sprites\"` (Fly Sprites), `\"vercel\"` (Vercel Sandbox) or `\"e2b\"` (E2B)."),
+    /** 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\"`)."),
     /** 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."),
+    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"`, `"error"`, and `"terminated"`. */
-    status: z.string().optional().describe("Current lifecycle state of the computer. Common values include `\"provisioning\"`, `\"ready\"`, `\"error\"`, and `\"terminated\"`."),
+    status: z.string().nullable().optional().describe("Current lifecycle state of the computer. Common values include `\"provisioning\"`, `\"ready\"`, `\"error\"`, and `\"terminated\"`."),
+    /** 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.");
@@ -1656,6 +1722,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."),
+    /** Question request payload. */
+    payload: payloadSchema.optional().describe("Question 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. */
@@ -1849,6 +1956,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. */