@archastro/sdk 0.7.0 → 0.8.0

package/dist/types/common.js

@@ -1,7 +1,8 @@
-// Copyright (c) 2026 ArchAstro Inc. All Rights Reserved.
+// Copyright (c) 2026 ArchAstro Inc. Licensed under the MIT License.
 // This file is auto-generated by @archastro/sdk-generator. Do not edit.
-// Content hash: b4afbeb2488f
+// Content hash: 616a0f880281
 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";
@@ -33,7 +34,7 @@ export const aclSchema = z.object({
 /** 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() }).optional(), app: z.string().optional(), created_at: z.string().optional(), default_model: z.string().optional(), email: z.string().optional(), id: z.string(), identity: z.string().optional(), last_applied_template_config: z.string().optional(), lookup_key: z.string().optional(), metadata: z.record(z.unknown()).optional(), name: z.string().optional(), org: z.string().optional(), org_name: z.string().optional(), originator: z.string().optional(), phone_number: z.string().optional(), sandbox: z.string().optional(), source_solution: z.object({ solution: z.object({ category_keys: z.array(z.string()).optional(), created_at: z.string().optional(), description: z.string().optional(), id: z.string(), kind: z.string(), latest_solution: z.string().optional(), latest_version: z.string().optional(), lookup_key: z.string().optional(), metadata: z.record(z.unknown()).optional(), name: z.string().optional(), org: z.string().optional(), org_logo: z.object({ file: z.string().optional(), height: z.number().int().optional(), media: z.string().optional(), mime_type: z.string().optional(), refresh_url: z.string().optional(), url: z.string().optional(), width: z.number().int().optional() }).optional(), org_name: z.string().optional(), org_slug: z.string().optional(), owners: z.array(z.string()), readme_url: z.string().optional(), solution_id: z.string().optional(), solution_version: z.string().optional(), tag_keys: z.array(z.string()).optional(), template_kind: z.string().optional(), templates: z.array(z.object({ description: z.string().optional(), display_name: z.string().optional(), id: z.string().optional(), kind: z.string(), lookup_key: z.string().optional(), name: z.string().optional(), readme_url: z.string().optional(), virtual_path: z.string().optional() })), updated_at: z.string().optional(), upgrade_available: z.boolean(), virtual_path: z.string().optional() }), template: z.object({ created_at: z.string().optional(), description: z.string().optional(), display_name: z.string().optional(), id: z.string(), kind: z.string(), lookup_key: z.string().optional(), name: z.string().optional(), updated_at: z.string().optional(), virtual_path: z.string().optional() }) }).optional(), team: z.string().optional(), template_upgrade_available: z.boolean().optional(), updated_at: z.string().optional(), user: z.string().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(), 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() }).optional(), app: z.string().optional(), created_at: z.string().optional(), default_model: z.string().optional(), description: z.string().optional(), email: z.string().optional(), id: z.string(), identity: z.string().optional(), last_applied_template_config: z.string().optional(), lookup_key: z.string().optional(), metadata: z.record(z.unknown()).optional(), name: z.string().optional(), org: z.string().optional(), org_name: z.string().optional(), originator: z.string().optional(), phone_number: z.string().optional(), sandbox: z.string().optional(), source_solution: z.object({ current_solution: z.object({ category_keys: z.array(z.string()).optional(), created_at: z.string().optional(), description: z.string().optional(), events: z.record(z.unknown()).optional(), id: z.string(), image_url: z.string().optional(), kind: z.string(), latest_solution: z.string().optional(), latest_version: z.string().optional(), lookup_key: z.string().optional(), metadata: z.record(z.unknown()).optional(), name: z.string().optional(), org: z.string().optional(), org_logo: z.object({ file: z.string().optional(), height: z.number().int().optional(), media: z.string().optional(), mime_type: z.string().optional(), refresh_url: z.string().optional(), url: z.string().optional(), width: z.number().int().optional() }).optional(), org_name: z.string().optional(), org_slug: z.string().optional(), owners: z.array(z.string()), readme_url: z.string().optional(), screenshot_urls: z.array(z.string()).optional(), solution_id: z.string().optional(), solution_version: z.string().optional(), tag_keys: z.array(z.string()).optional(), template_kind: z.string().optional(), templates: z.array(z.object({ description: z.string().optional(), details: z.object({ automation_type: z.string().optional(), invoke_contract: z.object({ input_schema: z.record(z.unknown()).optional(), participants: z.array(z.object({ description: z.string().optional(), name: z.string(), required: z.boolean(), type: z.string() })).optional(), prefills: z.object({ participants: z.record(z.unknown()).optional(), payload: z.record(z.unknown()).optional() }) }).optional(), type: z.literal("automation") }).optional(), display_name: z.string().optional(), id: z.string().optional(), kind: z.string(), lookup_key: z.string().optional(), name: z.string().optional(), readme_url: z.string().optional(), virtual_path: z.string().optional() })), updated_at: z.string().optional(), upgrade_available: z.boolean(), virtual_path: z.string().optional() }).optional(), solution: z.object({ category_keys: z.array(z.string()).optional(), created_at: z.string().optional(), description: z.string().optional(), events: z.record(z.unknown()).optional(), id: z.string(), image_url: z.string().optional(), kind: z.string(), latest_solution: z.string().optional(), latest_version: z.string().optional(), lookup_key: z.string().optional(), metadata: z.record(z.unknown()).optional(), name: z.string().optional(), org: z.string().optional(), org_logo: z.object({ file: z.string().optional(), height: z.number().int().optional(), media: z.string().optional(), mime_type: z.string().optional(), refresh_url: z.string().optional(), url: z.string().optional(), width: z.number().int().optional() }).optional(), org_name: z.string().optional(), org_slug: z.string().optional(), owners: z.array(z.string()), readme_url: z.string().optional(), screenshot_urls: z.array(z.string()).optional(), solution_id: z.string().optional(), solution_version: z.string().optional(), tag_keys: z.array(z.string()).optional(), template_kind: z.string().optional(), templates: z.array(z.object({ description: z.string().optional(), details: z.object({ automation_type: z.string().optional(), invoke_contract: z.object({ input_schema: z.record(z.unknown()).optional(), participants: z.array(z.object({ description: z.string().optional(), name: z.string(), required: z.boolean(), type: z.string() })).optional(), prefills: z.object({ participants: z.record(z.unknown()).optional(), payload: z.record(z.unknown()).optional() }) }).optional(), type: z.literal("automation") }).optional(), display_name: z.string().optional(), id: z.string().optional(), kind: z.string(), lookup_key: z.string().optional(), name: z.string().optional(), readme_url: z.string().optional(), virtual_path: z.string().optional() })), updated_at: z.string().optional(), upgrade_available: z.boolean(), virtual_path: z.string().optional() }), template: z.object({ created_at: z.string().optional(), description: z.string().optional(), display_name: z.string().optional(), id: z.string(), kind: z.string(), lookup_key: z.string().optional(), name: z.string().optional(), updated_at: z.string().optional(), virtual_path: z.string().optional() }) }).optional(), team: z.string().optional(), template_upgrade_available: z.boolean().optional(), updated_at: z.string().optional(), user: z.string().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. */
@@ -127,10 +128,17 @@ 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().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 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. */
+    recipients: z.array(z.string()).optional().describe("Required and non-empty for private visibility. Sources are additive. Routine owner includes the agent owner and optional user co-owner."),
+    /** Message visibility. One of `default` or `private`. */
+    visibility: z.string().optional().describe("Message visibility. One of `default` or `private`."),
+}).describe("Controls visibility and canonical recipient selection for routine-emitted messages.");
 /** Runtime validator for {@link LLMConfig}. */
 export const lLMConfigSchema = z.object({
-    /** Model identifier to use for this routine or step, e.g. `"claude-sonnet-4-5"`. When omitted, the agent's default model is used. */
-    model: z.string().optional().describe("Model identifier to use for this routine or step, e.g. `\"claude-sonnet-4-5\"`. When omitted, the agent's default model is used."),
+    /** Provider-prefixed model identifier for this routine or step, e.g. `"openrouter/anthropic/claude-sonnet-latest"`. When omitted, the agent's default model is used. */
+    model: z.string().optional().describe("Provider-prefixed model identifier for this routine or step, e.g. `\"openrouter/anthropic/claude-sonnet-latest\"`. When omitted, the agent's default model is used."),
 }).describe("LLM invocation settings for a routine or chain step. When present, overrides the agent-level model selection.");
 /** Runtime validator for {@link PresetConfig}. */
 export const presetConfigSchema = z.object({
@@ -203,12 +211,12 @@ export const attachmentSchema = z.object({
     media_type: z.string().optional().describe("The media category, e.g. `\"video\"` or `\"audio\"`. Present on `media` type only. `null` otherwise."),
     /** Display name of the media item. Present on `media` type only. `null` otherwise. */
     name: z.string().optional().describe("Display name of the media item. Present on `media` type only. `null` otherwise."),
-    /** The full embedded object payload. For `task` type, contains the task record. For `action` type, contains the action definition. `null` on other types. */
-    object: z.record(z.unknown()).optional().describe("The full embedded object payload. For `task` type, contains the task record. For `action` type, contains the action definition. `null` on other types."),
+    /** The full embedded object payload. For `task` type, contains the task record. For `action` type, contains the action definition. For `chart` type, contains the chart with its inline `spec`. `null` on other types. */
+    object: z.record(z.unknown()).optional().describe("The full embedded object payload. For `task` type, contains the task record. For `action` type, contains the action definition. For `chart` type, contains the chart with its inline `spec`. `null` on other types."),
     /** Display title. The page title for `scraped_link`, the artifact name for `artifact`, and the task title for `task` types. `null` on other types. */
     title: z.string().optional().describe("Display title. The page title for `scraped_link`, the artifact name for `artifact`, and the task title for `task` types. `null` on other types."),
-    /** The attachment type. One of `"file"`, `"scraped_link"`, `"artifact"`, `"task"`, `"media"`, or `"action"`. Determines which additional fields are present. */
-    type: z.string().describe("The attachment type. One of `\"file\"`, `\"scraped_link\"`, `\"artifact\"`, `\"task\"`, `\"media\"`, or `\"action\"`. Determines which additional fields are present."),
+    /** The attachment type. One of `"file"`, `"scraped_link"`, `"artifact"`, `"task"`, `"media"`, `"action"`, or `"chart"`. Determines which additional fields are present. */
+    type: z.string().describe("The attachment type. One of `\"file\"`, `\"scraped_link\"`, `\"artifact\"`, `\"task\"`, `\"media\"`, `\"action\"`, or `\"chart\"`. Determines which additional fields are present."),
     /** URL to access the resource. A signed download URL for `file` and `artifact` types; the original URL for `scraped_link`; a media playback URL for `media`. `null` on `task` and `action` types. */
     url: z.string().optional().describe("URL to access the resource. A signed download URL for `file` and `artifact` types; the original URL for `scraped_link`; a media playback URL for `media`. `null` on `task` and `action` types."),
     /** Array of available encoding variants for the media item (e.g. different resolutions). Present on `media` type only. `null` otherwise. */
@@ -301,6 +309,8 @@ export const messageReactionSchema = z.object({
 }).describe("A compact reaction record embedded in a message's `reactions` array, representing a single user's reaction to a message.");
 /** Runtime validator for {@link Message}. */
 export const messageSchema = z.object({
+    /** Access control list for private messages (grants with `read` action). Only returned to resource owners (and privileged/org-admin viewers) via server-side `field_redactions: [acl: :owner]`; `null` for everyone else. */
+    acl: aclSchema.optional().describe("Access control list for private messages (grants with `read` action). Only returned to resource owners (and privileged/org-admin viewers) via server-side `field_redactions: [acl: :owner]`; `null` for everyone else."),
     /** Resolved actor descriptors for the message sender, combining identity and display metadata. Always contains exactly one entry. */
     actors: z.array(actorSchema).optional().describe("Resolved actor descriptors for the message sender, combining identity and display metadata. Always contains exactly one entry."),
     /** ID of the agent user that sent this message (`agi_...`). `null` for messages sent by human users. */
@@ -321,6 +331,8 @@ export const messageSchema = z.object({
     id: z.string().describe("Message ID (`msg_...`)."),
     /** Client-supplied idempotency key used to deduplicate message sends. `null` if the sender did not provide one. */
     idempotency_key: z.string().optional().describe("Client-supplied idempotency key used to deduplicate message sends. `null` if the sender did not provide one."),
+    /** Whether this message is a deletion tombstone. `true` only on the `message_updated` broadcast emitted when a message is deleted: the original content is replaced with a placeholder and the message no longer exists on the server. Always `false` for live messages. */
+    is_deleted: z.boolean().optional().describe("Whether this message is a deletion tombstone. `true` only on the `message_updated` broadcast emitted when a message is deleted: the original content is replaced with a placeholder and the message no longer exists on the server. Always `false` for live messages."),
     /** Identifier of the legacy chat agent that sent this message, if applicable. `null` for messages sent by users or modern agent users. */
     legacy_agent: z.string().optional().describe("Identifier of the legacy chat agent that sent this message, if applicable. `null` for messages sent by users or modern agent users."),
     /** Arbitrary key-value metadata attached to the message. Always present; defaults to an empty object when no metadata has been set. */
@@ -347,8 +359,12 @@ export const messageSchema = z.object({
     team: z.string().optional().describe("ID of the team this message is scoped to (`tem_...`). `null` if the message is not team-scoped."),
     /** ID of the thread this message belongs to (`thr_...`). `null` for messages not yet associated with a thread. */
     thread: z.string().optional().describe("ID of the thread this message belongs to (`thr_...`). `null` for messages not yet associated with a thread."),
+    /** Optional client-defined classification for the message (for example `note` or `status`). Free-form string up to 64 characters. The value `system` is reserved for platform-authored messages and cannot be set by clients. `null` when unset. */
+    type: z.string().optional().describe("Optional client-defined classification for the message (for example `note` or `status`). Free-form string up to 64 characters. The value `system` is reserved for platform-authored messages and cannot be set by clients. `null` when unset."),
     /** The human user who sent this message. Returns a public ID string (`usr_...`) when the association is not preloaded, or an expanded user object when it is. `null` for messages sent by agents. */
     user: z.string().optional().describe("The human user who sent this message. Returns a public ID string (`usr_...`) when the association is not preloaded, or an expanded user object when it is. `null` for messages sent by agents."),
+    /** Message-level visibility. `default` is visible to anyone who can see the parent thread. `private` is restricted to the sender and explicit ACL `read` grantees. */
+    visibility: z.enum(["default", "private"]).optional().describe("Message-level visibility. `default` is visible to anyone who can see the parent thread. `private` is restricted to the sender and explicit ACL `read` grantees."),
 }).describe("A chat message posted in a thread, including its content, author, attachments, reactions, and optional reply metadata.");
 /** Runtime validator for {@link ComputerExecResult}. */
 export const computerExecResultSchema = z.object({
@@ -361,6 +377,8 @@ export const computerExecResultSchema = z.object({
 export const contextDocumentSchema = z.object({
     /** ID of the agent that owns this document (`agi_...`). `null` if owned by a user or team. */
     agent: z.string().optional().describe("ID of the agent that owns this document (`agi_...`). `null` if owned by a user or team."),
+    /** Lowercase-hex sha256 of the document's full text, covering content only — not `title` or `metadata`. Compare it against a hash of your local copy to decide whether the document needs re-ingesting, without fetching `/content`. `null` for documents ingested before this field existed; it is not backfilled. */
+    content_hash: z.string().optional().describe("Lowercase-hex sha256 of the document's full text, covering content only — not `title` or `metadata`. Compare it against a hash of your local copy to decide whether the document needs re-ingesting, without fetching `/content`. `null` for documents ingested before this field existed; it is not backfilled."),
     /** When the document was created (ISO 8601). */
     created_at: z.string().optional().describe("When the document was created (ISO 8601)."),
     /** ID of the backing storage file (`fil_...`) when the document is file-backed. `null` for inline documents. */
@@ -465,6 +483,19 @@ export const customObjectSchema = z.object({
     /** Optimistic concurrency version of the object. Increments with each successful update; pass this value in write operations to detect conflicting changes. */
     version: z.number().int().optional().describe("Optimistic concurrency version of the object. Increments with each successful update; pass this value in write operations to detect conflicting changes."),
 }).describe("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.");
+/** Runtime validator for {@link CustomObjectJoinResponse}. */
+export const customObjectJoinResponseSchema = z.object({
+    /** Collision-free identifier for this browser connection. */
+    connection_id: z.string().describe("Collision-free identifier for this browser connection."),
+    /** Current materialized fields, or `null` while waiting for object creation. */
+    fields: z.record(z.unknown()).nullable().describe("Current materialized fields, or `null` while waiting for object creation."),
+    /** Custom-object ID, or `null` while a row-key subscription waits for creation. */
+    id: z.string().nullable().describe("Custom-object ID, or `null` while a row-key subscription waits for creation."),
+    /** Current ephemeral collaborator presence. */
+    presence: z.array(z.record(z.unknown())).describe("Current ephemeral collaborator presence."),
+    /** Whether the current connection may only read the object. */
+    readonly: z.boolean().describe("Whether the current connection may only read the object."),
+}).describe("Initial authoritative snapshot returned by a custom-object channel join.");
 /** Runtime validator for {@link CustomObjectListResponse}. */
 export const customObjectListResponseSchema = z.object({
     /** Array of custom objects for the current page. */
@@ -482,33 +513,50 @@ export const customObjectListResponseSchema = z.object({
     /** Total number of pages available for the current query. */
     total_pages: z.number().int().describe("Total number of pages available for the current query."),
 }).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({
+    /** Collision-free connection identifier assigned to this browser connection. */
+    connection_id: z.string().describe("Collision-free connection identifier assigned to this browser connection."),
+}).describe("Acknowledges an ephemeral custom-object presence update.");
+/** Runtime validator for {@link CustomObjectSaveResponse}. */
+export const customObjectSaveResponseSchema = z.object({
+    /** Durable optimistic-concurrency version after the save. */
+    version: z.number().int().describe("Durable optimistic-concurrency version after the save."),
+}).describe("Acknowledges that the current custom-object document reached durable storage.");
 /** Runtime validator for {@link CustomObjectUpdateFieldsResponse}. */
 export const customObjectUpdateFieldsResponseSchema = z.object({
-    /** Map of field names to their new values as applied during the update. Only the fields that were included in the update request are present. */
-    fields: z.record(z.unknown()).describe("Map of field names to their new values as applied during the update. Only the fields that were included in the update request are present."),
+    /** The materialized object fields after the update. */
+    fields: z.record(z.unknown()).describe("The materialized object fields after the update."),
     /** ID of the custom object that was updated (`cobj_...`). */
     id: z.string().describe("ID of the custom object that was updated (`cobj_...`)."),
+    /** Idempotency key acknowledged for this update. */
+    operation_id: z.string().describe("Idempotency key acknowledged for this update."),
 }).describe("Response returned after updating one or more fields on a custom object. Confirms the object that was modified and the field values that were applied.");
-/** Runtime validator for {@link DeviceAuthorizationResponse}. */
-export const deviceAuthorizationResponseSchema = z.object({
-    /** Opaque code identifying this device authorization session. Pass this value when polling the token endpoint; do not display it to the user. */
-    device_code: z.string().describe("Opaque code identifying this device authorization session. Pass this value when polling the token endpoint; do not display it to the user."),
-    /** Number of seconds until the `device_code` and `user_code` expire. After expiry the user must restart the authorization flow. */
-    expires_in: z.number().int().describe("Number of seconds until the `device_code` and `user_code` expire. After expiry the user must restart the authorization flow."),
-    /** Minimum number of seconds to wait between polling attempts on the token endpoint. Polling more frequently will result in a `slow_down` error. */
-    interval: z.number().int().describe("Minimum number of seconds to wait between polling attempts on the token endpoint. Polling more frequently will result in a `slow_down` error."),
-    /** Short alphanumeric code the user must enter at `verification_uri` to authorize the device. */
-    user_code: z.string().describe("Short alphanumeric code the user must enter at `verification_uri` to authorize the device."),
-    /** URL the user visits to enter the `user_code` and approve the authorization request. */
-    verification_uri: z.string().describe("URL the user visits to enter the `user_code` and approve the authorization request."),
-    /** Full verification URL with the `user_code` pre-filled as a query parameter. Display this as a QR code or deep link to reduce manual entry. */
-    verification_uri_complete: z.string().describe("Full verification URL with the `user_code` pre-filled as a query parameter. Display this as a QR code or deep link to reduce manual entry."),
-}).describe("The initial response from an OAuth 2.0 Device Authorization Grant request, containing the codes and URIs needed to complete device authentication.");
-/** Runtime validator for {@link DeviceAuthorizationStatusResponse}. */
-export const deviceAuthorizationStatusResponseSchema = z.object({
-    /** Outcome of the device authorization request. One of `"approved"` (the user granted access) or `"denied"` (the user rejected or cancelled the request). */
-    status: z.string().describe("Outcome of the device authorization request. One of `\"approved\"` (the user granted access) or `\"denied\"` (the user rejected or cancelled the request)."),
-}).describe("The result of a completed OAuth 2.0 Device Authorization flow, indicating whether the user approved or denied the device's access request.");
+/** Runtime validator for {@link StorageFile}. */
+export const storageFileSchema = z.object({
+    /** MIME type of the file, e.g. `"image/png"` or `"application/pdf"`. */
+    content_type: z.string().optional().describe("MIME type of the file, e.g. `\"image/png\"` or `\"application/pdf\"`."),
+    /** When the file was uploaded (ISO 8601). */
+    created_at: z.string().optional().describe("When the file was uploaded (ISO 8601)."),
+    /** Original filename as provided at upload time. */
+    filename: z.string().optional().describe("Original filename as provided at upload time."),
+    /** File ID (`fil_...`). */
+    id: z.string().describe("File ID (`fil_...`)."),
+    /** Image display metadata. Present only when `content_type` is an image type; `null` otherwise. */
+    image_source: imageSourceSchema.optional().describe("Image display metadata. Present only when `content_type` is an image type; `null` otherwise."),
+    /** ID of the organization that owns this file (`org_...`). */
+    org: z.string().optional().describe("ID of the organization that owns this file (`org_...`)."),
+    /** ID of the sandbox this file is scoped to (`sbx_...`). `null` for files not associated with a sandbox. */
+    sandbox: z.string().optional().describe("ID of the sandbox this file is scoped to (`sbx_...`). `null` for files not associated with a sandbox."),
+    /** Stable public URL for the file, fetchable without authentication. Present only when the file was shared (`share: true`); does not expire until sharing is disabled. Disabling and re-enabling sharing reactivates the same URL. `null` otherwise. */
+    share_url: z.string().optional().describe("Stable public URL for the file, fetchable without authentication. Present only when the file was shared (`share: true`); does not expire until sharing is disabled. Disabling and re-enabling sharing reactivates the same URL. `null` otherwise."),
+    /** Size of the file in bytes. */
+    size: z.number().int().optional().describe("Size of the file in bytes."),
+    /** When the file record was last modified (ISO 8601). */
+    updated_at: z.string().optional().describe("When the file record was last modified (ISO 8601)."),
+    /** Short-lived signed URL for downloading the file. `null` if a URL could not be generated. */
+    url: z.string().optional().describe("Short-lived signed URL for downloading the file. `null` if a URL could not be generated."),
+}).describe("A file stored in the platform's object storage, with metadata and a signed URL for downloading its contents.");
 /** Runtime validator for {@link AgentHealthAction}. */
 export const agentHealthActionSchema = z.object({
     /** ID of the agent this action is scoped to (`agt_...`). `null` for org-level actions. */
@@ -599,7 +647,7 @@ export const installationKindSchema = z.object({
 export const installationKindListResponseSchema = z.object({
     /** Array of installation kind objects describing the available integration types and their configuration requirements. */
     data: z.array(installationKindSchema).describe("Array of installation kind objects describing the available integration types and their configuration requirements."),
-}).describe("List response containing all available installation kinds that can be used when configuring an agent installation.");
+}).describe("List response containing the publicly available installation kinds that can be used when configuring an agent installation.");
 /** Runtime validator for {@link InstallationListResponse}. */
 export const installationListResponseSchema = z.object({
     /** Array of installation objects returned for the current page. */
@@ -733,21 +781,6 @@ export const knowledgeSourceKindListResponseSchema = z.object({
     /** Array of knowledge source kind objects describing each creatable source type. */
     data: z.array(knowledgeSourceKindSchema).describe("Array of knowledge source kind objects describing each creatable source type."),
 }).describe("List response containing the knowledge source kinds available for creation via the API.");
-/** Runtime validator for {@link OAuthTokenResponse}. */
-export const oAuthTokenResponseSchema = z.object({
-    /** Bearer token used to authenticate API requests. Include this value in the `Authorization: Bearer <token>` header. */
-    access_token: z.string().describe("Bearer token used to authenticate API requests. Include this value in the `Authorization: Bearer <token>` header."),
-    /** Number of seconds until the access token expires. */
-    expires_in: z.number().int().describe("Number of seconds until the access token expires."),
-    /** Token that can be exchanged for a new access token once the current one expires. `null` if the grant type does not issue refresh tokens. */
-    refresh_token: z.string().optional().describe("Token that can be exchanged for a new access token once the current one expires. `null` if the grant type does not issue refresh tokens."),
-    /** Space-separated list of scopes granted to the access token. `null` if scope was not included in the grant request. */
-    scope: z.string().optional().describe("Space-separated list of scopes granted to the access token. `null` if scope was not included in the grant request."),
-    /** Token type. Always `"Bearer"`. */
-    token_type: z.string().describe("Token type. Always `\"Bearer\"`."),
-    /** The authenticated user associated with this token. `null` when the token is not tied to a specific user (e.g. client-credentials grants). */
-    user: userSchema.optional().describe("The authenticated user associated with this token. `null` when the token is not tied to a specific user (e.g. client-credentials grants)."),
-}).describe("A successful OAuth 2.0 token response. Issued by the token endpoint after a completed authorization or device-flow grant.");
 /** Runtime validator for {@link PaginatedReplies}. */
 export const paginatedRepliesSchema = z.object({
     /** Opaque cursor to pass as the pagination cursor to retrieve the page of replies that follow this one. `null` when no further pages exist. */
@@ -773,25 +806,90 @@ export const routinePresetSchema = z.object({
     label: z.string().describe("Human-readable display name for the preset, suitable for use in UIs."),
     /** Stable machine identifier for the preset, e.g. `"do_task"`. Used when assigning a preset to a routine. */
     name: z.string().describe("Stable machine identifier for the preset, e.g. `\"do_task\"`. Used when assigning a preset to a routine."),
-    /** Whether routines using this preset maintain a persistent conversation session across invocations. Sessionable presets do not expose instruction or session-mode configuration on individual routines. */
-    sessionable: z.boolean().describe("Whether routines using this preset maintain a persistent conversation session across invocations. Sessionable presets do not expose instruction or session-mode configuration on individual routines."),
+    /** Whether the preset runs inside the thread conversation-session lifecycle. This is distinct from preset_config.session_mode, which controls durable session reuse for do_task and send_message. */
+    sessionable: z.boolean().describe("Whether the preset runs inside the thread conversation-session lifecycle. This is distinct from preset_config.session_mode, which controls durable session reuse for do_task and send_message."),
     /** Whether at most one routine with this preset may exist per agent. Attempting to create a second routine with a unique preset on the same agent will be rejected. */
     unique: z.boolean().describe("Whether at most one routine with this preset may exist per agent. Attempting to create a second routine with a unique preset on the same agent will be rejected."),
 }).describe("A named preset that defines the execution model and constraints for a routine. Presets are shared definitions; individual routines reference a preset by name.");
+/** Runtime validator for {@link WorkflowJournalEntry}. */
+export const workflowJournalEntrySchema = z.object({
+    /** Durable command identifier associated with the record, when present. */
+    command_id: z.string().optional().describe("Durable command identifier associated with the record, when present."),
+    /** When this entry was durably committed. */
+    created_at: z.string().optional().describe("When this entry was durably committed."),
+    /** Journal entry ID (`wdr_...`). */
+    id: z.string().describe("Journal entry ID (`wdr_...`)."),
+    /** Workflow node associated with the record. `null` for execution-level records. */
+    node_id: z.string().optional().describe("Workflow node associated with the record. `null` for execution-level records."),
+    /** Replayable workflow record body, including payload, context, environment, metadata, and timestamp. */
+    record: z.record(z.unknown()).describe("Replayable workflow record body, including payload, context, environment, metadata, and timestamp."),
+    /** Monotonically increasing sequence within the journal. */
+    sequence: z.number().int().describe("Monotonically increasing sequence within the journal."),
+    /** Durable timer identifier associated with the record, when present. */
+    timer_id: z.string().optional().describe("Durable timer identifier associated with the record, when present."),
+    /** Workflow record type, such as `node_started`, `node_completed`, or `node_failed`. */
+    type: z.string().describe("Workflow record type, such as `node_started`, `node_completed`, or `node_failed`."),
+}).describe("One ordered, replayable record from a durable workflow journal.");
+/** Runtime validator for {@link WorkflowJournal}. */
+export const workflowJournalSchema = z.object({
+    /** When durable workflow execution reached a terminal state. `null` while it is active. */
+    completed_at: z.string().optional().describe("When durable workflow execution reached a terminal state. `null` while it is active."),
+    /** When the journal was created. */
+    created_at: z.string().optional().describe("When the journal was created."),
+    /** Highest workflow record sequence durably committed to this journal. */
+    current_sequence: z.number().int().describe("Highest workflow record sequence durably committed to this journal."),
+    /** Journal execution ID (`wde_...`). */
+    id: z.string().describe("Journal execution ID (`wde_...`)."),
+    /** When durable workflow execution started. */
+    started_at: z.string().optional().describe("When durable workflow execution started."),
+    /** Current durable execution status: `pending`, `running`, `waiting`, `completed`, `failed`, or `cancelled`. */
+    status: z.string().describe("Current durable execution status: `pending`, `running`, `waiting`, `completed`, `failed`, or `cancelled`."),
+    /** When the journal was last updated. */
+    updated_at: z.string().optional().describe("When the journal was last updated."),
+}).describe("Summary of the durable workflow execution journal associated with a run.");
+/** Runtime validator for {@link RunJournalPage}. */
+export const runJournalPageSchema = z.object({
+    /** Opaque cursor for the next entry page. `null` when this is the final page. */
+    after_cursor: z.string().optional().describe("Opaque cursor for the next entry page. `null` when this is the final page."),
+    /** Always `null`; journal pagination is forward-only. */
+    before_cursor: z.string().optional().describe("Always `null`; journal pagination is forward-only."),
+    /** Journal entries ordered by ascending sequence. Empty when the run has no journal. */
+    data: z.array(workflowJournalEntrySchema).describe("Journal entries ordered by ascending sequence. Empty when the run has no journal."),
+    /** Whether additional entries exist after this page. */
+    has_more: z.boolean().describe("Whether additional entries exist after this page."),
+    /** Durable execution summary. `null` when this run has no journal, which is valid for script-backed, preview, or legacy runs. */
+    journal: workflowJournalSchema.optional().describe("Durable execution summary. `null` when this run has no journal, which is valid for script-backed, preview, or legacy runs."),
+}).describe("A forward-paginated journal entry page for an automation or routine run.");
 /** Runtime validator for {@link SlackChannelBinding}. */
 export const slackChannelBindingSchema = z.object({
-    /** IDs of the agents attached to this binding. Empty array when no agents are assigned. */
-    agents: z.array(z.string()).optional().describe("IDs of the agents attached to this binding. Empty array when no agents are assigned."),
+    /** IDs of every agent attached to this binding, including legacy concierge attachments. Use `resident_agent` and `route_kind` for the effective runtime route. */
+    agents: z.array(z.string()).optional().describe("IDs of every agent attached to this binding, including legacy concierge attachments. Use `resident_agent` and `route_kind` for the effective runtime route."),
+    /** Whether this channel opts into sustained bot-to-bot conversation, exempting it from the reply loop brake. Defaults to `false`. */
+    allow_bot_conversations: z.boolean().describe("Whether this channel opts into sustained bot-to-bot conversation, exempting it from the reply loop brake. Defaults to `false`."),
     /** Slack channel ID (e.g. `C01234ABCDE`) that this binding targets. */
     channel: z.string().optional().describe("Slack channel ID (e.g. `C01234ABCDE`) that this binding targets."),
     /** Human-readable label identifying the customer, derived from the binding's embedded config. `null` when not set. */
     customer_label: z.string().optional().describe("Human-readable label identifying the customer, derived from the binding's embedded config. `null` when not set."),
+    /** Staging thread the deposit pipe copies this channel's mirror content into (`thr_…` public ID). `null` when the pipe is off for this binding. */
+    deposit_thread: z.string().optional().describe("Staging thread the deposit pipe copies this channel's mirror content into (`thr_…` public ID). `null` when the pipe is off for this binding."),
     /** Unique identifier for this Slack channel binding. */
     id: z.string().describe("Unique identifier for this Slack channel binding."),
     /** ID of the Slack integration that owns this binding. */
     integration: z.string().optional().describe("ID of the Slack integration that owns this binding."),
     /** Cached value of Slack's `is_ext_shared` flag for this channel. May be stale relative to Slack's current state. */
     is_ext_shared_cached: z.boolean().optional().describe("Cached value of Slack's `is_ext_shared` flag for this channel. May be stale relative to Slack's current state."),
+    /** Cached value of Slack's `is_private` flag for this channel. May be stale relative to Slack's current state. Private channels are member-managed: mutating the binding requires in-channel evidence. */
+    is_private_cached: z.boolean().optional().describe("Cached value of Slack's `is_private` flag for this channel. May be stale relative to Slack's current state. Private channels are member-managed: mutating the binding requires in-channel evidence."),
+    /** Whether the resident agent is currently muted. A muted resident keeps mirroring the channel (reading) but stops replying. A timed mute expires automatically at `muted_until`; this reflects the effective state as of now. Defaults to `false`. */
+    muted: z.boolean().describe("Whether the resident agent is currently muted. A muted resident keeps mirroring the channel (reading) but stops replying. A timed mute expires automatically at `muted_until`; this reflects the effective state as of now. Defaults to `false`."),
+    /** ISO 8601 timestamp when a timed mute expires and replies resume. `null` for an indefinite mute (until an explicit unmute) or when not muted. */
+    muted_until: z.string().optional().describe("ISO 8601 timestamp when a timed mute expires and replies resume. `null` for an indefinite mute (until an explicit unmute) or when not muted."),
+    /** How the resident agent's replies post to Slack: `thread` (default) threads a reply under the message that triggered it; `top_level` posts it flat in the channel. */
+    reply_style: z.string().describe("How the resident agent's replies post to Slack: `thread` (default) threads a reply under the message that triggered it; `top_level` posts it flat in the channel."),
+    /** ID of the non-concierge agent selected by Slack ingress. `null` when ingress falls back to the concierge. */
+    resident_agent: z.string().optional().describe("ID of the non-concierge agent selected by Slack ingress. `null` when ingress falls back to the concierge."),
+    /** Effective Slack ingress route: `fda` for a team-bound resident, `resident` for an unbound resident, or `concierge` when no non-concierge agent is attached. */
+    route_kind: z.enum(["fda", "resident", "concierge"]).describe("Effective Slack ingress route: `fda` for a team-bound resident, `resident` for an unbound resident, or `concierge` when no non-concierge agent is attached."),
     /** ID of the ArchAstro team this channel is bound to. */
     team: z.string().optional().describe("ID of the ArchAstro team this channel is bound to."),
 }).describe("A binding that connects a Slack channel to an ArchAstro team and one or more agents, enabling those agents to receive and respond to messages in that channel.");
@@ -808,29 +906,67 @@ export const slackChannelBindingListResponseSchema = z.object({
     /** Total number of pages available at the current `per_page` size. */
     total_pages: z.number().int().describe("Total number of pages available at the current `per_page` size."),
 }).describe("Paginated list of Slack channel bindings for the requested integration or team. Use the `page` and `per_page` fields to navigate pages of results.");
-/** Runtime validator for {@link StorageFile}. */
-export const storageFileSchema = z.object({
-    /** MIME type of the file, e.g. `"image/png"` or `"application/pdf"`. */
-    content_type: z.string().optional().describe("MIME type of the file, e.g. `\"image/png\"` or `\"application/pdf\"`."),
-    /** When the file was uploaded (ISO 8601). */
-    created_at: z.string().optional().describe("When the file was uploaded (ISO 8601)."),
-    /** Original filename as provided at upload time. */
-    filename: z.string().optional().describe("Original filename as provided at upload time."),
-    /** File ID (`fil_...`). */
-    id: z.string().describe("File ID (`fil_...`)."),
-    /** Image display metadata. Present only when `content_type` is an image type; `null` otherwise. */
-    image_source: imageSourceSchema.optional().describe("Image display metadata. Present only when `content_type` is an image type; `null` otherwise."),
-    /** ID of the organization that owns this file (`org_...`). */
-    org: z.string().optional().describe("ID of the organization that owns this file (`org_...`)."),
-    /** ID of the sandbox this file is scoped to (`sbx_...`). `null` for files not associated with a sandbox. */
-    sandbox: z.string().optional().describe("ID of the sandbox this file is scoped to (`sbx_...`). `null` for files not associated with a sandbox."),
-    /** Size of the file in bytes. */
-    size: z.number().int().optional().describe("Size of the file in bytes."),
-    /** When the file record was last modified (ISO 8601). */
-    updated_at: z.string().optional().describe("When the file record was last modified (ISO 8601)."),
-    /** Short-lived signed URL for downloading the file. `null` if a URL could not be generated. */
-    url: z.string().optional().describe("Short-lived signed URL for downloading the file. `null` if a URL could not be generated."),
-}).describe("A file stored in the platform's object storage, with metadata and a signed URL for downloading its contents.");
+/** Runtime validator for {@link Task}. */
+export const taskSchema = z.object({
+    /** ID of the agent that owns this task (`agi_...`). `null` if the task is scoped to a team or user. */
+    agent: z.string().optional().describe("ID of the agent that owns this task (`agi_...`). `null` if the task is scoped to a team or user."),
+    /** Number of tasks marked as blocking this task, whether or not they are done (see `GET /tasks/{task}/blockers`). Computed on list/show reads; create/update responses may lag one read behind. */
+    blocked_by_count: z.number().int().optional().describe("Number of tasks marked as blocking this task, whether or not they are done (see `GET /tasks/{task}/blockers`). Computed on list/show reads; create/update responses may lag one read behind."),
+    /** When the task was marked as done or otherwise closed (ISO 8601). `null` if the task is still open. */
+    closed_at: z.string().optional().describe("When the task was marked as done or otherwise closed (ISO 8601). `null` if the task is still open."),
+    /** Total number of comments posted on this task. */
+    comments_count: z.number().int().optional().describe("Total number of comments posted on this task."),
+    /** When the task was created (ISO 8601). */
+    created_at: z.string().optional().describe("When the task was created (ISO 8601)."),
+    /** Resolved creator details including `id`, `name`, `alias`, and `profile_picture`. `null` if no creator is set or the creator cannot be resolved (e.g. creating agent was deleted). */
+    created_by_actor: actorSchema.optional().describe("Resolved creator details including `id`, `name`, `alias`, and `profile_picture`. `null` if no creator is set or the creator cannot be resolved (e.g. creating agent was deleted)."),
+    /** ID of the agent that created this task (`agi_...`). `null` if the task was created by a human user, or if the creating agent was later deleted. */
+    created_by_agent: z.string().optional().describe("ID of the agent that created this task (`agi_...`). `null` if the task was created by a human user, or if the creating agent was later deleted."),
+    /** ID of the user who created this task (`usr_...`). `null` if the task was created by an agent, or if creator provenance was cleared after the creator was deleted. */
+    created_by_user: z.string().optional().describe("ID of the user who created this task (`usr_...`). `null` if the task was created by an agent, or if creator provenance was cleared after the creator was deleted."),
+    /** Long-form description or notes for the task. `null` if no description has been provided. */
+    description: z.string().optional().describe("Long-form description or notes for the task. `null` if no description has been provided."),
+    /** Date and time by which the task should be completed (ISO 8601). `null` if no due date is set. */
+    due_date: z.string().optional().describe("Date and time by which the task should be completed (ISO 8601). `null` if no due date is set."),
+    /** Task ID (`tsk_...`). */
+    id: z.string().describe("Task ID (`tsk_...`)."),
+    /** `true` while at least one blocking task is not yet done. Informational only — a blocked task can still change status — and derived at read time, so the task un-blocks automatically when its last open blocker completes. Computed on list/show reads; create/update responses report `false` until the next read. */
+    is_blocked: z.boolean().optional().describe("`true` while at least one blocking task is not yet done. Informational only — a blocked task can still change status — and derived at read time, so the task un-blocks automatically when its last open blocker completes. Computed on list/show reads; create/update responses report `false` until the next read."),
+    /** Key-value map of named URLs or references associated with the task. Returns an empty object when no links have been set. */
+    links: z.record(z.unknown()).optional().describe("Key-value map of named URLs or references associated with the task. Returns an empty object when no links have been set."),
+    /** Arbitrary key-value map of application-specific data stored alongside the task. Returns an empty object when no metadata has been set. */
+    metadata: z.record(z.unknown()).optional().describe("Arbitrary key-value map of application-specific data stored alongside the task. Returns an empty object when no metadata has been set."),
+    /** Human-readable title of the task. */
+    name: z.string().describe("Human-readable title of the task."),
+    /** ID of the organization this task belongs to (`org_...`). `null` for tasks outside an org context. */
+    org: z.string().optional().describe("ID of the organization this task belongs to (`org_...`). `null` for tasks outside an org context."),
+    /** Resolved owner details including `id`, `name`, `alias`, and `profile_picture`. `null` if the task is unassigned or the owner cannot be resolved (e.g. assigned agent was deleted). */
+    owner_actor: actorSchema.optional().describe("Resolved owner details including `id`, `name`, `alias`, and `profile_picture`. `null` if the task is unassigned or the owner cannot be resolved (e.g. assigned agent was deleted)."),
+    /** ID of the agent assigned as owner (`agi_...`). `null` if the owner is a human user, the task is unassigned, or the assigned agent was deleted. */
+    owner_agent: z.string().optional().describe("ID of the agent assigned as owner (`agi_...`). `null` if the owner is a human user, the task is unassigned, or the assigned agent was deleted."),
+    /** ID of the user assigned as owner (`usr_...`). `null` if the owner is an agent, the task is unassigned, or the assigned agent was deleted. */
+    owner_user: z.string().optional().describe("ID of the user assigned as owner (`usr_...`). `null` if the owner is an agent, the task is unassigned, or the assigned agent was deleted."),
+    /** ID of the parent task when this task is a subtask (`tsk_...`). `null` for top-level tasks. Subtasks nest exactly one level. */
+    parent: z.string().optional().describe("ID of the parent task when this task is a subtask (`tsk_...`). `null` for top-level tasks. Subtasks nest exactly one level."),
+    /** Priority level of the task from `0` (highest) to `4` (lowest). Defaults to `2` (medium) when not explicitly set. */
+    priority: z.number().int().optional().describe("Priority level of the task from `0` (highest) to `4` (lowest). Defaults to `2` (medium) when not explicitly set."),
+    /** ID of the developer sandbox this task is scoped to (`dsb_...`). `null` for tasks outside a sandbox environment. */
+    sandbox: z.string().optional().describe("ID of the developer sandbox this task is scoped to (`dsb_...`). `null` for tasks outside a sandbox environment."),
+    /** Current status of the task. One of `"open"`, `"in_progress"`, or `"done"`. */
+    status: z.string().describe("Current status of the task. One of `\"open\"`, `\"in_progress\"`, or `\"done\"`."),
+    /** Number of subtasks under this task. Computed on list/show reads; create/update responses may report 0 until the next read. Always 0 for subtasks. */
+    subtasks_count: z.number().int().optional().describe("Number of subtasks under this task. Computed on list/show reads; create/update responses may report 0 until the next read. Always 0 for subtasks."),
+    /** Labels for grouping and filtering, stored lowercase and de-duplicated. Empty array when untagged. */
+    tags: z.array(z.string()).optional().describe("Labels for grouping and filtering, stored lowercase and de-duplicated. Empty array when untagged."),
+    /** ID of the team that owns this task (`tem_...`). `null` if the task is not scoped to a team. */
+    team: z.string().optional().describe("ID of the team that owns this task (`tem_...`). `null` if the task is not scoped to a team."),
+    /** ID of the thread this task is bound to (`thr_...`) — the conversation it was filed from, or the thread passed at creation. `null` for tasks not tied to a thread. */
+    thread: z.string().optional().describe("ID of the thread this task is bound to (`thr_...`) — the conversation it was filed from, or the thread passed at creation. `null` for tasks not tied to a thread."),
+    /** When the task was last modified (ISO 8601). */
+    updated_at: z.string().optional().describe("When the task was last modified (ISO 8601)."),
+    /** ID of the user that owns this task (`usr_...`). `null` if the task is scoped to a team. */
+    user: z.string().optional().describe("ID of the user that owns this task (`usr_...`). `null` if the task is scoped to a team."),
+}).describe("A task representing a unit of work, optionally assignable to a user or agent.");
 /** Runtime validator for {@link ValidationResult}. */
 export const validationResultSchema = z.object({
     /** List of human-readable error messages describing why validation failed. Empty or absent when `valid` is `true`. */
@@ -840,6 +976,56 @@ export const validationResultSchema = z.object({
     /** List of human-readable warning messages emitted during validation. Warnings do not cause `valid` to be `false` but indicate potentially problematic configuration. */
     warnings: z.array(z.string()).optional().describe("List of human-readable warning messages emitted during validation. Warnings do not cause `valid` to be `false` but indicate potentially problematic configuration."),
 }).describe("The result of a configuration validation check, indicating whether the config is valid and listing any errors or warnings.");
+/** Runtime validator for {@link WorkflowWorkItem}. */
+export const workflowWorkItemSchema = z.object({
+    /** Agent assigned to execute this work. */
+    agent: z.string().describe("Agent assigned to execute this work."),
+    /** Number of times this work has been freshly claimed or reclaimed. */
+    attempt_count: z.number().int().describe("Number of times this work has been freshly claimed or reclaimed."),
+    /** Opaque journal command identity used to resume the workflow exactly once. */
+    command_id: z.string().describe("Opaque journal command identity used to resume the workflow exactly once."),
+    created_at: z.string(),
+    /** Durable workflow execution that owns this work. */
+    execution: z.string().describe("Durable workflow execution that owns this work."),
+    /** Work item ID (`wdi_...`). */
+    id: z.string().describe("Work item ID (`wdi_...`)."),
+    /** When the current claim expires. Null for queued or terminal work. */
+    lease_expires_at: z.string().optional().describe("When the current claim expires. Null for queued or terminal work."),
+    /** Workflow graph node that yielded the work. */
+    node_id: z.string().describe("Workflow graph node that yielded the work."),
+    /** Instructions and participant bindings needed to execute the work. */
+    payload: z.record(z.unknown()).describe("Instructions and participant bindings needed to execute the work."),
+    /** Routine run that owns the execution, when this work came from a routine. */
+    routine_run: z.string().optional().describe("Routine run that owns the execution, when this work came from a routine."),
+    /** Current queue lifecycle status. */
+    status: z.string().describe("Current queue lifecycle status."),
+    /** Stable resource discriminator. Always `workflow_work_item`. */
+    type: z.string().describe("Stable resource discriminator. Always `workflow_work_item`."),
+    updated_at: z.string(),
+}).describe("Externally executable work yielded by a durable workflow.");
+/** Runtime validator for {@link WorkflowWorkItemLease}. */
+export const workflowWorkItemLeaseSchema = z.object({
+    /** Opaque lease token that must be persisted and presented for later transitions. */
+    lease_owner: z.string().describe("Opaque lease token that must be persisted and presented for later transitions."),
+    /** The claimed, resumed, started, or heartbeated work item. */
+    work_item: workflowWorkItemSchema.describe("The claimed, resumed, started, or heartbeated work item."),
+}).describe("A claimed workflow work item and its caller-held lease token.");
+/** Runtime validator for {@link WorkflowWorkItemClaim}. */
+export const workflowWorkItemClaimSchema = z.object({
+    /** Claimed or resumed work and its lease; null when no eligible item exists. */
+    data: workflowWorkItemLeaseSchema.optional().describe("Claimed or resumed work and its lease; null when no eligible item exists."),
+}).describe("Result of polling an agent's durable workflow work queue.");
+/** Runtime validator for {@link WorkflowWorkItemList}. */
+export const workflowWorkItemListSchema = z.object({
+    /** Opaque cursor for the next page, or null at the end. */
+    after_cursor: z.string().optional().describe("Opaque cursor for the next page, or null at the end."),
+    /** Always null because queue pagination is forward-only. */
+    before_cursor: z.string().optional().describe("Always null because queue pagination is forward-only."),
+    /** Active work items. Lease tokens are intentionally never included in list responses. */
+    data: z.array(workflowWorkItemSchema).describe("Active work items. Lease tokens are intentionally never included in list responses."),
+    /** Whether another page of work exists. */
+    has_more: z.boolean().describe("Whether another page of work exists."),
+}).describe("Active durable workflow work available to the viewer.");
 /** Runtime validator for {@link WorkingMemoryEntry}. */
 export const workingMemoryEntrySchema = z.object({
     /** ID of the agent that owns this memory entry (`agt_...`). */
@@ -874,10 +1060,32 @@ export const workingMemoryEntryListResponseSchema = z.object({
     /** Total number of pages given the current `page_size`. */
     total_pages: z.number().int().optional().describe("Total number of pages given the current `page_size`."),
 }).describe("Paginated list of working memory entries stored for an agent. Includes page metadata to support sequential page traversal.");
+/** Runtime validator for {@link SolutionAutomationInvokeContract}. */
+export const solutionAutomationInvokeContractSchema = z.object({
+    /** JSON Schema validated against the whole invoke payload, from the automation's `input_schema_config`. `null` when none is configured. */
+    input_schema: z.record(z.unknown()).optional().describe("JSON Schema validated against the whole invoke payload, from the automation's `input_schema_config`. `null` when none is configured."),
+    /** Named participant slots declared by the workflow, sorted by name. `null` when the workflow declares none. Values supplied under the top-level `participants` field are agent IDs. */
+    participants: z.array(automationParticipantSlotSchema).optional().describe("Named participant slots declared by the workflow, sorted by name. `null` when the workflow declares none. Values supplied under the top-level `participants` field are agent IDs."),
+    /** Owner-controlled payload and participant values the platform applies to every invocation. Supplying a conflicting value is rejected. */
+    prefills: automationPrefillsSchema.describe("Owner-controlled payload and participant values the platform applies to every invocation. Supplying a conflicting value is rejected."),
+}).describe("The schema-driven values an installer may lock when provisioning an invoked automation template.");
+/** Runtime validator for {@link SolutionAutomationTemplateDetails}. */
+export const solutionAutomationTemplateDetailsSchema = z.object({
+    /** Automation execution type (`invoked`, `scheduled`, or `trigger`). */
+    automation_type: z.string().optional().describe("Automation execution type (`invoked`, `scheduled`, or `trigger`)."),
+    /** Schema-driven payload and participant inputs for an invoked automation. Used by installation clients to collect locked prefills before provisioning. */
+    invoke_contract: solutionAutomationInvokeContractSchema.optional().describe("Schema-driven payload and participant inputs for an invoked automation. Used by installation clients to collect locked prefills before provisioning."),
+    /** Template-details discriminator. Always `automation` for this variant. */
+    type: z.literal("automation").describe("Template-details discriminator. Always `automation` for this variant."),
+}).describe("AutomationTemplate-specific details exposed by a Solution template summary.");
+/** Template-kind-specific Solution summary details, discriminated by `type`. */
+export const solutionTemplateDetailsSchema = z.discriminatedUnion("type", [solutionAutomationTemplateDetailsSchema]);
 /** Runtime validator for {@link SolutionTemplateSummary}. */
 export const solutionTemplateSummarySchema = z.object({
     /** Short prose blurb from the template body's `description:` field. `null` when the body doesn't set one. Used as the card subhead in the Library carousel. */
     description: z.string().optional().describe("Short prose blurb from the template body's `description:` field. `null` when the body doesn't set one. Used as the card subhead in the Library carousel."),
+    /** Template-kind-specific details selected by the `type` discriminator. `null` when this template kind has no additional details. */
+    details: solutionTemplateDetailsSchema.optional().describe("Template-kind-specific details selected by the `type` discriminator. `null` when this template kind has no additional details."),
     /** Human-facing label from the template body's `display_name:` field. `null` when the body doesn't set one. Library carousels use this for the card title, falling back to a humanized `name`. */
     display_name: z.string().optional().describe("Human-facing label from the template body's `display_name:` field. `null` when the body doesn't set one. Library carousels use this for the card title, falling back to a humanized `name`."),
     /** Template config ID (`cfg_...`). `null` for inline-only templates. */
@@ -901,8 +1109,12 @@ export const solutionSummarySchema = z.object({
     created_at: z.string().optional().describe("When the Solution config was first imported (ISO 8601)."),
     /** Short tagline or summary declared in the Solution body, used as the card subhead in catalog UIs. `null` when the Solution body does not set one. */
     description: z.string().optional().describe("Short tagline or summary declared in the Solution body, used as the card subhead in catalog UIs. `null` when the Solution body does not set one."),
+    /** Custom analytics events declared in the Solution body's `events:` manifest — a map of event key (snake_case) to its definition (`label`, optional `description`, optional typed `fields`). Dashboards use the `label` as the event's display name. Present as an empty object when the body declares none. */
+    events: z.record(z.unknown()).optional().describe("Custom analytics events declared in the Solution body's `events:` manifest — a map of event key (snake_case) to its definition (`label`, optional `description`, optional typed `fields`). Dashboards use the `label` as the event's display name. Present as an empty object when the body declares none."),
     /** Solution config ID (`cfg_...`). */
     id: z.string().describe("Solution config ID (`cfg_...`)."),
+    /** Absolute URL of the Solution's cover image — the bundled asset the body's `image:` field names. A stable, non-expiring capability URL (like `org_logo.url`), safe to hold in caches and OpenGraph tags; it 404s if the Solution stops declaring a cover. `null` when the Solution has no cover image, and always `null` for org-scoped rows — the permanent URL is minted for system-scope (catalog) Solutions only. */
+    image_url: z.string().optional().describe("Absolute URL of the Solution's cover image — the bundled asset the body's `image:` field names. A stable, non-expiring capability URL (like `org_logo.url`), safe to hold in caches and OpenGraph tags; it 404s if the Solution stops declaring a cover. `null` when the Solution has no cover image, and always `null` for org-scoped rows — the permanent URL is minted for system-scope (catalog) Solutions only."),
     /** Resource type. Always `"Solution"`. */
     kind: z.string().describe("Resource type. Always `\"Solution\"`."),
     /** When `upgrade_available` is `true`, the system-scope Solution config ID (`cfg_...`) that should be used as the upgrade source. `null` otherwise. */
@@ -917,8 +1129,8 @@ export const solutionSummarySchema = z.object({
     name: z.string().optional().describe("Human-facing display name declared in the Solution body. `null` when the Solution body does not set one."),
     /** Organization ID (`org_...`) that owns this Solution config, when the Solution is scoped to a specific org. `null` for system-scope (app-level) Solutions. */
     org: z.string().optional().describe("Organization ID (`org_...`) that owns this Solution config, when the Solution is scoped to a specific org. `null` for system-scope (app-level) Solutions."),
-    /** Canonical image-source object for the resolved `org`'s logo, used as the principal category section glyph. Carries the signed `url` plus a `refresh_url`. `null` when `org_slug` is `null` or the org has no logo. */
-    org_logo: imageSourceSchema.optional().describe("Canonical image-source object for the resolved `org`'s logo, used as the principal category section glyph. Carries the signed `url` plus a `refresh_url`. `null` when `org_slug` is `null` or the org has no logo."),
+    /** Canonical image-source object for the resolved `org`'s logo, used as the principal category section glyph. The `url` is a stable, non-expiring capability URL (`refresh_url` is `null` — there is nothing to refresh). `null` when `org_slug` is `null` or the org has no logo. */
+    org_logo: imageSourceSchema.optional().describe("Canonical image-source object for the resolved `org`'s logo, used as the principal category section glyph. The `url` is a stable, non-expiring capability URL (`refresh_url` is `null` — there is nothing to refresh). `null` when `org_slug` is `null` or the org has no logo."),
     /** Display name of the resolved `org`. Pairs with `org_slug` as the principal catalog category's label. `null` when `org_slug` is `null`. */
     org_name: z.string().optional().describe("Display name of the resolved `org`. Pairs with `org_slug` as the principal catalog category's label. `null` when `org_slug` is `null`."),
     /** Resolved slug of the Solution body's `org` (the publishing organization), when set and it resolves to a real org visible to the viewer. When present this is the Solution's principal catalog category key — clients group the Solution under this org ahead of `category_keys`. `null` when the body has no `org` or it doesn't resolve. */
@@ -927,6 +1139,8 @@ export const solutionSummarySchema = z.object({
     owners: z.array(z.string()).describe("Owner scopes this Solution appears under. Members: `\"system\"` (app-level system scope) and/or `\"org\"` (viewer's org scope)."),
     /** Relative path to the public README endpoint with a signed token already embedded. `null` when the Solution has no README. Token expires in 1 hour — refresh via `GET /api/v1/solutions/:solution`. */
     readme_url: z.string().optional().describe("Relative path to the public README endpoint with a signed token already embedded. `null` when the Solution has no README. Token expires in 1 hour — refresh via `GET /api/v1/solutions/:solution`."),
+    /** Absolute URLs of the Solution's gallery screenshots — the bundled assets the body's `screenshots:` field names, in declared order. Each is a stable, non-expiring capability URL with the same cacheability contract as `image_url` (one shared token, a `v` cache key, and a `file` param selecting the screenshot); a URL 404s if the Solution stops declaring its screenshot. An empty array when the Solution declares none, and always empty for org-scoped rows — the permanent URLs are minted for system-scope (catalog) Solutions only. */
+    screenshot_urls: z.array(z.string()).optional().describe("Absolute URLs of the Solution's gallery screenshots — the bundled assets the body's `screenshots:` field names, in declared order. Each is a stable, non-expiring capability URL with the same cacheability contract as `image_url` (one shared token, a `v` cache key, and a `file` param selecting the screenshot); a URL 404s if the Solution stops declaring its screenshot. An empty array when the Solution declares none, and always empty for org-scoped rows — the permanent URLs are minted for system-scope (catalog) Solutions only."),
     /** Stable UUID declared in the Solution body, used to identify the same logical Solution across multiple installed copies and owner scopes. `null` when the body omits it. */
     solution_id: z.string().optional().describe("Stable UUID declared in the Solution body, used to identify the same logical Solution across multiple installed copies and owner scopes. `null` when the body omits it."),
     /** Semver string declared in the Solution body (e.g. `"1.2.0"`). `null` when the body does not declare a version. */
@@ -946,6 +1160,8 @@ export const solutionSummarySchema = z.object({
 }).describe("A catalog entry for an imported Solution, including its display metadata, bundled templates, owner scopes, and any available upgrade information.");
 /** Runtime validator for {@link AgentSourceSolution}. */
 export const agentSourceSolutionSchema = z.object({
+    /** Summary of the current parent Solution config row. `solution` is the pinned Solution version the agent points at; `current_solution` is the source Solution config row as it exists now. */
+    current_solution: solutionSummarySchema.optional().describe("Summary of the current parent Solution config row. `solution` is the pinned Solution version the agent points at; `current_solution` is the source Solution config row as it exists now."),
     /** Summary of the parent Solution, including `upgrade_available`, `latest_version`, and `latest_solution` when a newer system-scoped version is available for the agent's org-scoped Solution. */
     solution: solutionSummarySchema.describe("Summary of the parent Solution, including `upgrade_available`, `latest_version`, and `latest_solution` when a newer system-scoped version is available for the agent's org-scoped Solution."),
     /** Summary of the AgentTemplate config (`cfg_...`) the agent was last provisioned or updated from. */
@@ -961,6 +1177,8 @@ export const agentSchema = z.object({
     created_at: z.string().optional().describe("When the agent was created (ISO 8601)."),
     /** Default LLM model identifier used by this agent when no model is specified at runtime (e.g. `"claude-3-7-sonnet-latest"`). */
     default_model: z.string().optional().describe("Default LLM model identifier used by this agent when no model is specified at runtime (e.g. `\"claude-3-7-sonnet-latest\"`)."),
+    /** Human-readable description of what the agent does. `null` if not set. */
+    description: z.string().optional().describe("Human-readable description of what the agent does. `null` if not set."),
     /** Email address provisioned for this agent. `null` if email delivery is not configured. */
     email: z.string().optional().describe("Email address provisioned for this agent. `null` if email delivery is not configured."),
     /** Agent ID (`agi_...`). */
@@ -989,8 +1207,8 @@ export const agentSchema = z.object({
     source_solution: agentSourceSolutionSchema.optional().describe("Source Solution and AgentTemplate summary for agents provisioned from a Solution. Includes `upgrade_available`, `latest_version`, and `latest_solution` so you can render an upgrade badge without a separate dry-run call. `null` for hand-built agents and agents whose tracked template or parent Solution has been deleted. Populated only on single-agent GET responses, never on list endpoints."),
     /** ID of the team that owns this agent (`tem_...`). `null` if the agent is not team-scoped. */
     team: z.string().optional().describe("ID of the team that owns this agent (`tem_...`). `null` if the agent is not team-scoped."),
-    /** True when the agent's last-applied template version is behind the current version of its AgentTemplate config — i.e. reapplying the template (a per-agent upgrade) would bring it newer Solution content. Self-clears once the agent is reapplied. Computed only on list endpoints; `null` on single-agent GET. */
-    template_upgrade_available: z.boolean().optional().describe("True when the agent's last-applied template version is behind the current version of its AgentTemplate config — i.e. reapplying the template (a per-agent upgrade) would bring it newer Solution content. Self-clears once the agent is reapplied. Computed only on list endpoints; `null` on single-agent GET."),
+    /** True when the agent's last-applied template version is behind the current version of its AgentTemplate config — i.e. reapplying the template (a per-agent upgrade) would bring it newer Solution content. Self-clears once the agent is reapplied. Computed on both the list endpoints and single-agent GET. Distinct from `source_solution.upgrade_available`, which compares Solution *versions*: an agent can lag its template (`template_upgrade_available: true`) while the org already holds the latest Solution version (`upgrade_available: false`). */
+    template_upgrade_available: z.boolean().optional().describe("True when the agent's last-applied template version is behind the current version of its AgentTemplate config — i.e. reapplying the template (a per-agent upgrade) would bring it newer Solution content. Self-clears once the agent is reapplied. Computed on both the list endpoints and single-agent GET. Distinct from `source_solution.upgrade_available`, which compares Solution *versions*: an agent can lag its template (`template_upgrade_available: true`) while the org already holds the latest Solution version (`upgrade_available: false`)."),
     /** When the agent was last modified (ISO 8601). */
     updated_at: z.string().optional().describe("When the agent was last modified (ISO 8601)."),
     /** ID of the user that owns this agent (`usr_...`). `null` if the agent is not user-scoped. */
@@ -1142,8 +1360,8 @@ export const agentListResponseSchema = z.object({
 }).describe("Paginated list of agent objects. Use the pagination fields to traverse multiple pages of results.");
 /** 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`. `null` when no ACL restrictions are applied and the routine is accessible to all members of its scope. */
-    acl: aclSchema.optional().describe("Access control list for the routine. Contains a `grants` array where each entry specifies `principal_type`, `principal`, and `actions`. `null` when no ACL restrictions are applied and the routine is accessible to all members of its scope."),
+    /** 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: aclSchema.optional().describe("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."),
     /** ID of the agent that owns this routine (`agi_...`). */
     agent: z.string().optional().describe("ID of the agent that owns this routine (`agi_...`)."),
     /** Application that scopes this routine (`dap_...`). */
@@ -1166,6 +1384,8 @@ export const agentRoutineSchema = z.object({
     last_applied_template_config: z.string().optional().describe("ID of the AgentRoutineTemplate Config this routine was last provisioned or updated from (`cfg_...`). `null` for hand-built routines."),
     /** Unique human-readable key used to look up this routine without knowing its ID. `null` when not set. */
     lookup_key: z.string().optional().describe("Unique human-readable key used to look up this routine without knowing its ID. `null` when not set."),
+    /** Visibility and explicit recipient selection for messages emitted by this routine. */
+    message_policy: messagePolicySchema.optional().describe("Visibility and explicit recipient selection for messages emitted by this routine."),
     /** Arbitrary key-value metadata attached to this routine. `null` when not set. */
     metadata: z.record(z.unknown()).optional().describe("Arbitrary key-value metadata attached to this routine. `null` when not set."),
     /** Human-readable name for the routine. */
@@ -1186,12 +1406,31 @@ export const agentRoutineSchema = z.object({
     trigger_context: z.string().optional().describe("Execution context in which runs are created. One of `\"event\"` (background job) or `\"chat_session\"` (interactive session). Defaults to `\"event\"`."),
     /** When this routine was last updated (ISO 8601). */
     updated_at: z.string().optional().describe("When this routine was last updated (ISO 8601)."),
+    /** 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: z.string().optional().describe("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."),
 }).describe("An agent routine defines a reusable handler — script, preset, or chain — that runs in response to events or on a schedule.");
 /** Runtime validator for {@link AgentRoutineListResponse}. */
 export const agentRoutineListResponseSchema = z.object({
     /** Array of agent routine objects. */
     data: z.array(agentRoutineSchema).describe("Array of agent routine objects."),
 }).describe("List of agent routine objects belonging to a given agent.");
+/** Runtime validator for {@link AgentRoutineRunDelivery}. */
+export const agentRoutineRunDeliverySchema = z.object({
+    /** When delivery completed successfully (ISO 8601). */
+    delivered_at: z.string().optional().describe("When delivery completed successfully (ISO 8601)."),
+    /** ID of the message created by a successful delivery (`msg_...`). */
+    delivered_message: z.string().optional().describe("ID of the message created by a successful delivery (`msg_...`)."),
+    /** Stable public error code for the most recent failed delivery attempt. */
+    last_error: z.string().optional().describe("Stable public error code for the most recent failed delivery attempt."),
+    /** Source message ID (`msg_...`) when the delivery is a reply. */
+    message: z.string().optional().describe("Source message ID (`msg_...`) when the delivery is a reply."),
+    /** Current delivery lifecycle status. */
+    status: z.enum(["not_requested", "pending", "delivered", "failed"]).describe("Current delivery lifecycle status."),
+    /** Destination thread ID (`thr_...`) when delivery was requested. */
+    thread: z.string().optional().describe("Destination thread ID (`thr_...`) when delivery was requested."),
+    /** Normalized delivery mode. */
+    type: z.enum(["none", "thread", "reply"]).describe("Normalized delivery mode."),
+}).describe("Normalized destination and status for an agent routine run's final-result delivery.");
 /** Runtime validator for {@link AgentRoutineRun}. */
 export const agentRoutineRunSchema = z.object({
     /** Access control list for the run. Contains a `grants` array where each entry specifies `principal_type`, `principal`, and `actions`. `null` when no ACL restrictions are applied and the run is accessible to all members of its scope. */
@@ -1202,6 +1441,8 @@ export const agentRoutineRunSchema = z.object({
     app: z.string().optional().describe("Application that scopes this run (`dap_...`)."),
     /** When this run was created (ISO 8601). */
     created_at: z.string().optional().describe("When this run was created (ISO 8601)."),
+    /** Normalized final-result delivery destination and its current delivery status. */
+    delivery: agentRoutineRunDeliverySchema.optional().describe("Normalized final-result delivery destination and its current delivery status."),
     /** Total wall-clock time the run took to execute, in milliseconds. `null` while the run is still in progress. */
     duration_ms: z.number().int().optional().describe("Total wall-clock time the run took to execute, in milliseconds. `null` while the run is still in progress."),
     /** Identifier of the platform event that triggered this run. `null` for manually invoked runs. */
@@ -1210,6 +1451,8 @@ export const agentRoutineRunSchema = z.object({
     id: z.string().describe("Routine run ID (`arr_...`)."),
     /** Arbitrary key-value metadata attached to this run. Empty object when no metadata was set. */
     metadata: z.record(z.unknown()).optional().describe("Arbitrary key-value metadata attached to this run. Empty object when no metadata was set."),
+    /** Invoke-time map of symbolic participant references to agent IDs. `null` when no participants were supplied. */
+    participants: z.record(z.unknown()).optional().describe("Invoke-time map of symbolic participant references to agent IDs. `null` when no participants were supplied."),
     /** Input payload delivered to the routine when this run was triggered. Empty object when no payload was provided. */
     payload: z.record(z.unknown()).optional().describe("Input payload delivered to the routine when this run was triggered. Empty object when no payload was provided."),
     /** Output produced by the routine after execution. `null` while the run has not yet completed. */
@@ -1579,6 +1822,15 @@ export const solutionDiffSummarySchema = z.object({
     /** Number of config entries that exist and will be updated with new content. */
     updates: z.number().int().describe("Number of config entries that exist and will be updated with new content."),
 }).describe("Aggregate counts of each action type across all entries in a solution upgrade diff.");
+/** Runtime validator for {@link SolutionImportWarning}. */
+export const solutionImportWarningSchema = z.object({
+    /** Machine-readable warning code. `"setup_requirements_dropped"`: a template or config body declares catalog-DSL `setup_requirements` that direct import does not convert — installs read only `setup_actions`, so those setup steps would never surface. */
+    code: z.string().describe("Machine-readable warning code. `\"setup_requirements_dropped\"`: a template or config body declares catalog-DSL `setup_requirements` that direct import does not convert — installs read only `setup_actions`, so those setup steps would never surface."),
+    /** Human-readable explanation of the warning and how to resolve it. */
+    message: z.string().describe("Human-readable explanation of the warning and how to resolve it."),
+    /** Which bundle entry the warning is about, as `<slot>[<index>] (<relative_path>)`. */
+    path: z.string().describe("Which bundle entry the warning is about, as `<slot>[<index>] (<relative_path>)`."),
+}).describe("A non-fatal finding surfaced by a Solution import. The import proceeds despite warnings; validation callers (dry-run) can choose to treat them as failures.");
 /** Runtime validator for {@link SolutionImportResult}. */
 export const solutionImportResultSchema = z.object({
     /** Machine-readable conflict code present when `status` is `"conflict"`, identifying the specific conflict reason. `null` when `status` is `"ready"`. */
@@ -1595,6 +1847,8 @@ export const solutionImportResultSchema = z.object({
     status: z.string().describe("Outcome of the import check. `\"ready\"` means the import can proceed as a normal create or update. `\"conflict\"` means a version conflict was detected and the upgrade flow must be used instead."),
     /** Whether the caller must invoke the dedicated upgrade flow to complete the import. Mirrors `status == "conflict"` as a convenience boolean. */
     upgrade_required: z.boolean().describe("Whether the caller must invoke the dedicated upgrade flow to complete the import. Mirrors `status == \"conflict\"` as a convenience boolean."),
+    /** Non-fatal findings the import proceeded despite (present on real imports and dry-runs alike; defaults to an empty array). Dry-run validation callers should surface these — or treat them as failures — before applying the real import. */
+    warnings: z.array(solutionImportWarningSchema).optional().describe("Non-fatal findings the import proceeded despite (present on real imports and dry-runs alike; defaults to an empty array). Dry-run validation callers should surface these — or treat them as failures — before applying the real import."),
 }).describe("The machine-readable outcome of a Solution import attempt, indicating whether the import succeeded or requires an upgrade flow to resolve a version conflict.");
 /** Runtime validator for {@link SolutionImportResponse}. */
 export const solutionImportResponseSchema = z.object({
@@ -1628,6 +1882,44 @@ export const solutionInstallResponseSchema = z.object({
     /** Solution config ID (`cfg_...`) that was used as the source for this install. */
     solution: z.string().describe("Solution config ID (`cfg_...`) that was used as the source for this install."),
 }).describe("The runtime resource provisioned by installing a Solution, along with a reference back to the source Solution config.");
+/** Runtime validator for {@link SolutionInstance}. */
+export const solutionInstanceSchema = z.object({
+    /** Materialized agent for this customer (`agi_...`). `null` for a row without an agent. */
+    agent: z.string().optional().describe("Materialized agent for this customer (`agi_...`). `null` for a row without an agent."),
+    /** Opaque tagged reference to the deployment target. Consumers interpret its kind. */
+    attachment_ref: z.record(z.unknown()).optional().describe("Opaque tagged reference to the deployment target. Consumers interpret its kind."),
+    /** When this instance was stamped. */
+    created_at: z.string().describe("When this instance was stamped."),
+    /** Stable vendor-defined key for the customer. */
+    customer_key: z.string().describe("Stable vendor-defined key for the customer."),
+    /** Human-readable customer label. `null` when the vendor did not provide one. */
+    customer_label: z.string().optional().describe("Human-readable customer label. `null` when the vendor did not provide one."),
+    /** Solution instance ID (`sli_...`). */
+    id: z.string().describe("Solution instance ID (`sli_...`)."),
+    /** Count of local agent edits relative to the pinned template. `null` when unavailable. */
+    local_edit_count: z.number().int().optional().describe("Count of local agent edits relative to the pinned template. `null` when unavailable."),
+    /** Pinned template version record (`cfv_...`). `null` when no version is pinned. */
+    pinned_template_version: z.string().optional().describe("Pinned template version record (`cfv_...`). `null` when no version is pinned."),
+    /** Human-readable version number of the pinned template. `null` when unavailable. */
+    pinned_version_number: z.number().int().optional().describe("Human-readable version number of the pinned template. `null` when unavailable."),
+    /** Installed solution template config that stamped this instance (`cfg_...`). */
+    solution_template_config: z.string().describe("Installed solution template config that stamped this instance (`cfg_...`)."),
+    /** Lifecycle status of this stamped instance. */
+    status: z.enum(["active", "archived"]).describe("Lifecycle status of this stamped instance."),
+    /** When this instance was last updated. */
+    updated_at: z.string().describe("When this instance was last updated."),
+}).describe("A customer-keyed instance stamped from an installed solution template.");
+/** Runtime validator for {@link SolutionInstanceListResponse}. */
+export const solutionInstanceListResponseSchema = z.object({
+    /** Opaque cursor for the next page. `null` when this is the final page. */
+    after_cursor: z.string().optional().describe("Opaque cursor for the next page. `null` when this is the final page."),
+    /** Always `null`; this endpoint supports forward pagination only. */
+    before_cursor: z.string().optional().describe("Always `null`; this endpoint supports forward pagination only."),
+    /** Customer solution instances in stable customer-key order. */
+    data: z.array(solutionInstanceSchema).describe("Customer solution instances in stable customer-key order."),
+    /** Whether another page exists after this one. */
+    has_more: z.boolean().describe("Whether another page exists after this one."),
+}).describe("A forward cursor-paginated page of customer solution instances.");
 /** Runtime validator for {@link SolutionListResponse}. */
 export const solutionListResponseSchema = z.object({
     /** Array of Solution summary objects for the current page, in the order returned by the query. */