@archastro/sdk 0.10.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: 3cf6aaa1b1df
+// Content hash: 76c7762b600d
 import { z } from "zod";
 import { automationParticipantSlotSchema, automationPrefillsSchema } from "./automations.js";
 import { configSchema } from "./config.js";
@@ -460,6 +460,16 @@ 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. */
@@ -536,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). */
@@ -556,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({
@@ -798,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. */
@@ -864,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. */
@@ -916,6 +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 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`. */