@archastro/sdk 0.9.0 → 0.11.0

package/dist/types/common.js

@@ -1,6 +1,6 @@
 // Copyright (c) 2026 ArchAstro Inc. Licensed under the MIT License.
 // This file is auto-generated by @archastro/sdk-generator. Do not edit.
-// Content hash: 616a0f880281
+// Content hash: 76c7762b600d
 import { z } from "zod";
 import { automationParticipantSlotSchema, automationPrefillsSchema } from "./automations.js";
 import { configSchema } from "./config.js";
@@ -353,6 +353,8 @@ export const messageSchema = z.object({
     reply_count: z.number().int().optional().describe("Total number of direct replies to this message. Only present when explicitly requested or computed by the server."),
     /** The parent message this message is a reply to, expanded as a full message object when loaded. `null` if this is a top-level message or the association is not preloaded. */
     reply_to: z.record(z.unknown()).optional().describe("The parent message this message is a reply to, expanded as a full message object when loaded. `null` if this is a top-level message or the association is not preloaded."),
+    /** ID of the root message in this reply chain (`msg_...`). `null` for a top-level message. The value is persisted when the reply is created, so callers can correlate a multi-turn session without walking parent messages. */
+    root_message_id: z.string().nullable().optional().describe("ID of the root message in this reply chain (`msg_...`). `null` for a top-level message. The value is persisted when the reply is created, so callers can correlate a multi-turn session without walking parent messages."),
     /** ID of the developer sandbox this message belongs to (`dsb_...`). `null` for non-sandbox messages. */
     sandbox: z.string().optional().describe("ID of the developer sandbox this message belongs to (`dsb_...`). `null` for non-sandbox messages."),
     /** ID of the team this message is scoped to (`tem_...`). `null` if the message is not team-scoped. */
@@ -458,8 +460,20 @@ export const contextIngestionSchema = z.object({
     /** ID of the user that initiated this ingestion (`usr_...`). `null` if initiated by an agent. */
     user: z.string().optional().describe("ID of the user that initiated this ingestion (`usr_...`). `null` if initiated by an agent."),
 }).describe("A context ingestion job that processes a context source and populates its documents. Tracks status and timing from submission through completion or failure.");
+/** Runtime validator for {@link CreatedPrivateServiceEnrollment}. */
+export const createdPrivateServiceEnrollmentSchema = z.object({
+    /** One-time connector enrollment token. Store it immediately. */
+    enrollment_token: z.string().describe("One-time connector enrollment token. Store it immediately."),
+    /** When the one-time enrollment token expires. */
+    enrollment_token_expires_at: z.string().describe("When the one-time enrollment token expires."),
+    generation: z.number().int(),
+    id: z.string(),
+    private_service: z.string(),
+}).describe("Creation-only private service enrollment response. The raw token is shown once and is omitted from every read schema.");
 /** Runtime validator for {@link CustomObject}. */
 export const customObjectSchema = z.object({
+    /** Access control list governing read and write access to this custom object. Only returned to resource owners and privileged or organization-admin viewers; `null` for everyone else. */
+    acl: aclSchema.optional().describe("Access control list governing read and write access to this custom object. Only returned to resource owners and privileged or organization-admin viewers; `null` for everyone else."),
     /** When the custom object was created (ISO 8601). */
     created_at: z.string().optional().describe("When the custom object was created (ISO 8601)."),
     /** Map of field names to their current values as defined by the object's schema type. */
@@ -532,8 +546,17 @@ export const customObjectUpdateFieldsResponseSchema = z.object({
     /** 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 Deployment}. */
+export const deploymentSchema = z.object({
+    /** Deployment environment, or `null` when it is not configured. */
+    environment: z.string().nullable().optional().describe("Deployment environment, or `null` when it is not configured."),
+    /** Opaque SHA-256 fingerprint of the image reference, or `null` in local development. */
+    release: z.string().nullable().optional().describe("Opaque SHA-256 fingerprint of the image reference, or `null` in local development."),
+}).describe("Deployment metadata.");
 /** Runtime validator for {@link StorageFile}. */
 export const storageFileSchema = z.object({
+    /** ID of the app this file belongs to (`app_...`). */
+    app: z.string().optional().describe("ID of the app this file belongs to (`app_...`)."),
     /** 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). */
@@ -552,10 +575,14 @@ export const storageFileSchema = z.object({
     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."),
+    /** ID of the team that owns this file (`team_...`). `null` if not team-owned. */
+    team: z.string().optional().describe("ID of the team that owns this file (`team_...`). `null` if not team-owned."),
     /** 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."),
+    /** ID of the user that owns this file (`user_...`). `null` if not user-owned. */
+    user: z.string().optional().describe("ID of the user that owns this file (`user_...`). `null` if not user-owned."),
 }).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({
@@ -794,6 +821,53 @@ export const paginatedRepliesSchema = z.object({
     /** Total number of replies in the thread across all pages. */
     total_count: z.number().int().optional().describe("Total number of replies in the thread across all pages."),
 }).describe("A paginated list of reply messages for a thread. The reply array is returned directly, not nested inside a `data` wrapper.");
+/** Runtime validator for {@link PrivateServiceFunction}. */
+export const privateServiceFunctionSchema = z.object({
+    /** Human-readable guidance describing when and why to call the operation. */
+    description: z.string().describe("Human-readable guidance describing when and why to call the operation."),
+    /** JSON Schema Draft 7 object describing the operation's argument object. */
+    input_schema: z.record(z.unknown()).describe("JSON Schema Draft 7 object describing the operation's argument object."),
+    /** Stable operation name used when invoking the private service. */
+    name: z.string().describe("Stable operation name used when invoking the private service."),
+    /** Optional JSON Schema Draft 7 object describing the successful result. */
+    output_schema: z.record(z.unknown()).optional().describe("Optional JSON Schema Draft 7 object describing the successful result."),
+}).describe("A documented callable operation exposed by a private service.");
+/** Runtime validator for {@link PrivateService}. */
+export const privateServiceSchema = z.object({
+    /** Sorted callable definitions exposed by this private service. */
+    functions: z.array(privateServiceFunctionSchema).describe("Sorted callable definitions exposed by this private service."),
+    /** Private service ID (`pvs_...`). */
+    id: z.string().describe("Private service ID (`pvs_...`)."),
+}).describe("An immutable private service with complete callable operation contracts.");
+/** Runtime validator for {@link PrivateServiceEnrollment}. */
+export const privateServiceEnrollmentSchema = z.object({
+    /** Latest committed connector certificate generation, or zero before enrollment. */
+    generation: z.number().int().describe("Latest committed connector certificate generation, or zero before enrollment."),
+    /** Canonical certificate-bound service identity. */
+    id: z.string().describe("Canonical certificate-bound service identity."),
+    /** Immutable private service ID (`pvs_...`). */
+    private_service: z.string().describe("Immutable private service ID (`pvs_...`)."),
+}).describe("A private service's durable connector identity. Read responses never contain an enrollment token or certificate.");
+/** Runtime validator for {@link PrivateServiceEnrollmentPage}. */
+export const privateServiceEnrollmentPageSchema = z.object({
+    data: z.array(privateServiceEnrollmentSchema),
+    has_next: z.boolean(),
+    has_prev: z.boolean(),
+    page: z.number().int(),
+    page_size: z.number().int(),
+    total_entries: z.number().int(),
+    total_pages: z.number().int(),
+}).describe("A secret-free page of private service enrollments.");
+/** Runtime validator for {@link PrivateServicePage}. */
+export const privateServicePageSchema = z.object({
+    data: z.array(privateServiceSchema),
+    has_next: z.boolean(),
+    has_prev: z.boolean(),
+    page: z.number().int(),
+    page_size: z.number().int(),
+    total_entries: z.number().int(),
+    total_pages: z.number().int(),
+}).describe("A page of private services.");
 /** Runtime validator for {@link RoutinePreset}. */
 export const routinePresetSchema = z.object({
     /** Event types that routines using this preset may be triggered by. `["*"]` means the preset accepts any event type. Routines assigned to this preset will be rejected at creation time if their trigger event is not in this list. */
@@ -860,6 +934,52 @@ export const runJournalPageSchema = z.object({
     /** 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 SandboxKey}. */
+export const sandboxKeySchema = z.object({
+    /** When this key was created (ISO 8601). */
+    created_at: z.string().optional().describe("When this key was created (ISO 8601)."),
+    /** When this key expires and becomes invalid. `null` if the key does not expire. */
+    expires_at: z.string().optional().describe("When this key expires and becomes invalid. `null` if the key does not expire."),
+    /** The complete secret key value, returned only once when the key is first created. `null` on subsequent retrievals. */
+    full_key: z.string().optional().describe("The complete secret key value, returned only once when the key is first created. `null` on subsequent retrievals."),
+    /** Sandbox key ID (`dsk_...`). */
+    id: z.string().describe("Sandbox key ID (`dsk_...`)."),
+    /** A short hint showing the last four characters of the key, used for identification. `null` if no hint is available. */
+    key_hint: z.string().optional().describe("A short hint showing the last four characters of the key, used for identification. `null` if no hint is available."),
+    /** The full key value for `"publishable"` keys. `null` for `"secret"` keys; use `full_key` instead, which is returned only at creation time. */
+    key_value: z.string().optional().describe("The full key value for `\"publishable\"` keys. `null` for `\"secret\"` keys; use `full_key` instead, which is returned only at creation time."),
+    /** When this key was last used to authenticate a request. `null` if the key has never been used. */
+    last_used_at: z.string().optional().describe("When this key was last used to authenticate a request. `null` if the key has never been used."),
+    /** Current lifecycle status of the key. One of `"active"` (usable) or `"revoked"` (permanently disabled). */
+    status: z.string().describe("Current lifecycle status of the key. One of `\"active\"` (usable) or `\"revoked\"` (permanently disabled)."),
+    /** The kind of key. One of `"publishable"` (safe for client-side use) or `"secret"` (server-side only). */
+    type: z.string().describe("The kind of key. One of `\"publishable\"` (safe for client-side use) or `\"secret\"` (server-side only)."),
+}).describe("An API key scoped to a developer sandbox, used to authenticate requests against sandbox resources.");
+/** Runtime validator for {@link Sandbox}. */
+export const sandboxSchema = z.object({
+    /** When this sandbox was created (ISO 8601). */
+    created_at: z.string().optional().describe("When this sandbox was created (ISO 8601)."),
+    /** When an eval sandbox expires and becomes eligible for platform cleanup. `null` for ordinary developer sandboxes. */
+    expires_at: z.string().optional().describe("When an eval sandbox expires and becomes eligible for platform cleanup. `null` for ordinary developer sandboxes."),
+    /** Sandbox ID (`dsb_...`). */
+    id: z.string().describe("Sandbox ID (`dsb_...`)."),
+    /** API keys associated with this sandbox. `null` if keys were not loaded with this response. */
+    keys: z.array(sandboxKeySchema).optional().describe("API keys associated with this sandbox. `null` if keys were not loaded with this response."),
+    /** Human-readable display name for the sandbox. */
+    name: z.string().describe("Human-readable display name for the sandbox."),
+    /** Organization ID this sandbox is scoped to, or `null` for an app-level sandbox. */
+    org: z.string().optional().describe("Organization ID this sandbox is scoped to, or `null` for an app-level sandbox."),
+    /** Logo of the owning organization, when present. */
+    org_logo: imageSourceSchema.optional().describe("Logo of the owning organization, when present."),
+    /** Display name of the owning organization, when org-scoped. */
+    org_name: z.string().optional().describe("Display name of the owning organization, when org-scoped."),
+    /** Sandbox purpose marker. `"eval"` marks a remote-eval sandbox; `null` for ordinary developer sandboxes. */
+    purpose: z.string().optional().describe("Sandbox purpose marker. `\"eval\"` marks a remote-eval sandbox; `null` for ordinary developer sandboxes."),
+    /** URL-safe identifier for the sandbox, unique within the application (e.g. `"my-sandbox"`). */
+    slug: z.string().describe("URL-safe identifier for the sandbox, unique within the application (e.g. `\"my-sandbox\"`)."),
+    /** When this sandbox was last modified (ISO 8601). */
+    updated_at: z.string().optional().describe("When this sandbox was last modified (ISO 8601)."),
+}).describe("An isolated developer sandbox environment used for testing integrations without affecting production data or sending real emails.");
 /** Runtime validator for {@link SlackChannelBinding}. */
 export const slackChannelBindingSchema = z.object({
     /** IDs of every agent attached to this binding, including legacy concierge attachments. Use `resident_agent` and `route_kind` for the effective runtime route. */
@@ -872,6 +992,8 @@ export const slackChannelBindingSchema = z.object({
     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."),
+    /** Slack Connect lifecycle: `pending` while the customer has not accepted the invite (nothing mirrors), `posted` once the AI disclosure is in the channel and the channel is live, `suppressed` when relay is stopped. `null` for a binding that never went through Connect provisioning. */
+    disclosure_state: z.enum(["pending", "posted", "suppressed"]).optional().describe("Slack Connect lifecycle: `pending` while the customer has not accepted the invite (nothing mirrors), `posted` once the AI disclosure is in the channel and the channel is live, `suppressed` when relay is stopped. `null` for a binding that never went through Connect provisioning."),
     /** 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. */
@@ -890,8 +1012,12 @@ export const slackChannelBindingSchema = z.object({
     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."),
+    /** The customer key this channel's agent is locked to, written when adding the customer finishes. A `posted` binding whose `scope_key` is still null has been accepted but not finished — the addition is either in flight or was refused. */
+    scope_key: z.string().optional().describe("The customer key this channel's agent is locked to, written when adding the customer finishes. A `posted` binding whose `scope_key` is still null has been accepted but not finished — the addition is either in flight or was refused."),
     /** 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."),
+    /** Whether the admin who added this customer ended up inside a Connect channel we created for them: `invited` (we put them in), `already_member` (they were in it already), `no_slack_user` (their account email is not a Slack account in your workspace, so nobody was invited), or `failed` (Slack refused). A created Connect channel is private and has no self-join, so the last two mean the channel has no human from your side until someone already in it adds one. `null` when nobody was added: the channel was adopted rather than created (an existing channel already has its own members), the binding never went through Connect provisioning, or the call had no admin behind it. */
+    vendor_admin_channel_access: z.enum(["invited", "already_member", "no_slack_user", "failed"]).optional().describe("Whether the admin who added this customer ended up inside a Connect channel we created for them: `invited` (we put them in), `already_member` (they were in it already), `no_slack_user` (their account email is not a Slack account in your workspace, so nobody was invited), or `failed` (Slack refused). A created Connect channel is private and has no self-join, so the last two mean the channel has no human from your side until someone already in it adds one. `null` when nobody was added: the channel was adopted rather than created (an existing channel already has its own members), the binding never went through Connect provisioning, or the call had no admin behind it."),
 }).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.");
 /** Runtime validator for {@link SlackChannelBindingListResponse}. */
 export const slackChannelBindingListResponseSchema = z.object({
@@ -906,67 +1032,25 @@ 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 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 Trajectory}. */
+export const trajectorySchema = z.object({
+    /** When the trajectory was recorded (ISO 8601). */
+    created_at: z.string().optional().describe("When the trajectory was recorded (ISO 8601)."),
+    /** ID of the storage file that persists the raw trajectory data (`fil_...`). `null` if the trajectory has not been written to a file. */
+    file: z.string().optional().describe("ID of the storage file that persists the raw trajectory data (`fil_...`). `null` if the trajectory has not been written to a file."),
+    /** Trajectory ID (`trj_...`). */
+    id: z.string().describe("Trajectory ID (`trj_...`)."),
+    /** Serialized message log for this trajectory. Contains the ordered sequence of AI and tool messages produced during the session. */
+    messages: z.record(z.unknown()).optional().describe("Serialized message log for this trajectory. Contains the ordered sequence of AI and tool messages produced during the session."),
+    /** ID of the organization this trajectory belongs to (`org_...`). `null` for trajectories outside an org context. */
+    org: z.string().optional().describe("ID of the organization this trajectory belongs to (`org_...`). `null` for trajectories outside an org context."),
+    /** ID of the developer sandbox this trajectory is scoped to (`sbx_...`). `null` for production trajectories. */
+    sandbox: z.string().optional().describe("ID of the developer sandbox this trajectory is scoped to (`sbx_...`). `null` for production trajectories."),
+    /** ID of the team this trajectory is scoped to (`team_...`). `null` for trajectories not associated with a team. */
+    team: z.string().optional().describe("ID of the team this trajectory is scoped to (`team_...`). `null` for trajectories not associated with a team."),
+    /** When the trajectory record was last updated (ISO 8601). */
+    updated_at: z.string().optional().describe("When the trajectory record was last updated (ISO 8601)."),
+}).describe("A recorded sequence of AI messages and tool interactions representing a single AI reasoning session. Trajectories are stored as structured message logs and can be replayed or inspected after execution.");
 /** 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`. */
@@ -1871,6 +1955,11 @@ export const solutionImportResponseSchema = z.object({
     /** The `virtual_path` stored on the Solution config, used as the stable dedupe key across owner scopes. `null` when no virtual path was assigned. */
     virtual_path: z.string().optional().describe("The `virtual_path` stored on the Solution config, used as the stable dedupe key across owner scopes. `null` when no virtual path was assigned."),
 }).describe("The result of importing a Solution bundle into the library, including the Solution config record, a structured import result, and the list of all configs persisted during the transaction.");
+/** Runtime validator for {@link SolutionInstallResponseWebhook}. */
+export const solutionInstallResponseWebhookSchema = z.object({
+    signing_secret: z.string(),
+    url: z.string(),
+}).describe("One-time connection details for a webhook-auth Automation install.");
 /** Runtime validator for {@link SolutionInstallResponse}. */
 export const solutionInstallResponseSchema = z.object({
     /** Public ID of the provisioned resource. The prefix reflects the resource kind: `agi_...` for Agent, `aut_...` for Automation, `art_...` for AgentRoutine, `att_...` for AgentTool, `ask_...` for AgentSkill, `cmp_...` for AgentComputer. */
@@ -1881,11 +1970,15 @@ export const solutionInstallResponseSchema = z.object({
     lookup_key: z.string().optional().describe("The `lookup_key` stamped on the provisioned resource. `null` for `AgentSkill`, which is a join record and does not carry a lookup key."),
     /** 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."),
+    /** One-time connection details for a webhook-auth Automation install. */
+    webhook: solutionInstallResponseWebhookSchema.optional().describe("One-time connection details for a webhook-auth Automation 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."),
+    /** Human-readable display name of the materialized agent. `null` when no agent is visible. */
+    agent_name: z.string().optional().describe("Human-readable display name of the materialized agent. `null` when no agent is visible."),
     /** 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. */