@archastro/sdk 0.9.0 → 0.10.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: 3cf6aaa1b1df
 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. */
@@ -460,6 +462,8 @@ export const contextIngestionSchema = z.object({
 }).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 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. */
@@ -872,6 +876,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 +896,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 +916,6 @@ 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 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 +1820,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 +1835,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. */