@archastro/sdk 0.18.0 → 0.20.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: a02baea2c1d9
+// Content hash: afbd6dd19860
 import { z } from "zod";
 import { automationParticipantSlotSchema, automationPrefillsSchema } from "./automations.js";
 import { configSchema } from "./config.js";
@@ -163,6 +163,15 @@ export const workerStatusSchema = z.object({
     /** Current execution state of the worker. One of `"queued"`, `"executing"`, `"retrying"`, `"completed"`, `"discarded"`, or `"cancelled"`. */
     status: z.string().describe("Current execution state of the worker. One of `\"queued\"`, `\"executing\"`, `\"retrying\"`, `\"completed\"`, `\"discarded\"`, or `\"cancelled\"`."),
 }).describe("Execution state of the background worker processing a routine run. Reflects the current job status and retry progress.");
+/** Runtime validator for {@link Setup}. */
+export const setupSchema = z.object({
+    /** Recommended next step for MCP setup. */
+    next_action: z.string().describe("Recommended next step for MCP setup."),
+    /** MCP protocol health is not checked by this assessment. */
+    protocol_status: z.literal("not_checked").describe("MCP protocol health is not checked by this assessment."),
+    /** Reason for the current MCP setup state. */
+    reason: z.string().describe("Reason for the current MCP setup state."),
+}).describe("Current MCP setup assessment, not a historical downgrade reason or upstream protocol probe.");
 /** Runtime validator for {@link MediaVariant}. */
 export const mediaVariantSchema = z.object({
     /** MIME type of this variant's file (e.g., `"image/jpeg"`, `"video/mp4"`). `null` if the file is not loaded. */
@@ -208,16 +217,18 @@ export const attachmentSchema = z.object({
     image_url: z.string().nullable().optional().describe("URL of the preview image extracted from the scraped page. Present on `scraped_link` type only. `null` otherwise."),
     /** Width in pixels of the scraped preview image. Present on `scraped_link` type only. `null` otherwise. */
     image_width: z.number().int().nullable().optional().describe("Width in pixels of the scraped preview image. Present on `scraped_link` type only. `null` otherwise."),
+    /** For `structured_data` type, what the data is about as set by the sender (for example `"pr:14963"`), copied from the record so it can be read without `object`. Not unique. `null` when unset and on other types. */
+    key: z.string().nullable().optional().describe("For `structured_data` type, what the data is about as set by the sender (for example `\"pr:14963\"`), copied from the record so it can be read without `object`. Not unique. `null` when unset and on other types."),
     /** The media category, e.g. `"video"` or `"audio"`. Present on `media` type only; omitted otherwise. */
     media_type: z.string().optional().describe("The media category, e.g. `\"video\"` or `\"audio\"`. Present on `media` type only; omitted otherwise."),
     /** Display name of the media item. Present on `media` type only. `null` otherwise. */
     name: z.string().nullable().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. For `chart` type, contains the chart with its inline `spec`. Omitted on other types. */
-    object: z.record(z.custom((value) => value !== undefined)).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`. Omitted 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`. For `structured_data` type, contains the inline `data` and the `schema_url` or `schema_config` naming its JSON Schema. Omitted on other types. */
+    object: z.record(z.custom((value) => value !== undefined)).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`. For `structured_data` type, contains the inline `data` and the `schema_url` or `schema_config` naming its JSON Schema. Omitted 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().nullable().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"`, `"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."),
+    /** The attachment type. One of `"file"`, `"scraped_link"`, `"artifact"`, `"task"`, `"media"`, `"action"`, `"chart"`, or `"structured_data"`. Determines which additional fields are present. */
+    type: z.string().describe("The attachment type. One of `\"file\"`, `\"scraped_link\"`, `\"artifact\"`, `\"task\"`, `\"media\"`, `\"action\"`, `\"chart\"`, or `\"structured_data\"`. 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().nullable().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; omitted otherwise. */
@@ -229,6 +240,8 @@ export const attachmentSchema = z.object({
 }).describe("A rich attachment associated with a message, such as a file, scraped link, artifact, task, media item, or inline action.");
 /** Runtime validator for {@link AuthTokens}. */
 export const authTokensSchema = z.object({
+    /** `true` when this request created the account (the same moment the platform records the signup), `false` for a returning sign-in or a token refresh. Registration always returns `true`; password login and refresh always return `false`. */
+    account_created: z.boolean().describe("`true` when this request created the account (the same moment the platform records the signup), `false` for a returning sign-in or a token refresh. Registration always returns `true`; password login and refresh always return `false`."),
     /** Number of seconds until `token` expires. After this period, use `refresh_token` to obtain a new access token. */
     expires_in: z.number().int().describe("Number of seconds until `token` expires. After this period, use `refresh_token` to obtain a new access token."),
     /** Optional auxiliary data associated with this authentication event, such as `onboarding_job_id` when the user is completing onboarding. `null` when no extra context is present. */
@@ -394,13 +407,6 @@ export const okSchema = z.object({
     content: z.string(),
     status: z.literal("ok"),
 }).describe("A successful local-tool outcome.");
-/** Runtime validator for {@link Error}. */
-export const errorSchema = z.object({
-    call_id: z.string(),
-    code: z.string(),
-    message: z.string(),
-    status: z.literal("error"),
-}).describe("A failed local-tool outcome.");
 /** Runtime validator for {@link Command}. */
 export const commandSchema = z.object({
     /** Human-readable description of what the command does, shown alongside the name in the workflow builder. */
@@ -518,12 +524,23 @@ export const createdPrivateServiceEnrollmentSchema = z.object({
     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 EffectiveAccessBillingTrial}. */
+export const effectiveAccessBillingTrialSchema = z.object({
+    /** Effective trial end: the earlier of its accepted boundary and enrollment end. */
+    ends_at: z.string().describe("Effective trial end: the earlier of its accepted boundary and enrollment end."),
+    /** Whether a provider webhook has confirmed a stored payment method. */
+    payment_method_stored: z.boolean().describe("Whether a provider webhook has confirmed a stored payment method."),
+    /** Catalog plan whose trial is active. */
+    plan: z.string().describe("Catalog plan whose trial is active."),
+}).describe("Privacy-safe current trial state for one Viewer-derived billing principal.");
 /** Runtime validator for {@link EffectiveAccessBillingPrincipal}. */
 export const effectiveAccessBillingPrincipalSchema = z.object({
     /** Whether the authenticated user may administer this principal's billing account. */
     administrator: z.boolean().describe("Whether the authenticated user may administer this principal's billing account."),
     principal_type: z.enum(["user", "org"]),
-}).describe("Billing administration authority for one Viewer-derived principal kind.");
+    /** Currently active trials for this Viewer-derived principal. Contains no billing-account or provider identifiers. */
+    trials: z.array(effectiveAccessBillingTrialSchema).describe("Currently active trials for this Viewer-derived principal. Contains no billing-account or provider identifiers."),
+}).describe("Billing authority and relevant active trials for one Viewer-derived principal kind.");
 /** Runtime validator for {@link EffectiveAccessEntitlement}. */
 export const effectiveAccessEntitlementSchema = z.object({
     /** Whether any eligible source grants the key. */
@@ -539,11 +556,11 @@ export const effectiveAccessEntitlementSchema = z.object({
 }).describe("A billing-derived effective entitlement for the authenticated user.");
 /** Runtime validator for {@link EffectiveAccess}. */
 export const effectiveAccessSchema = z.object({
-    /** Administration authority for the personal and current-organization principals. */
-    billing: z.array(effectiveAccessBillingPrincipalSchema).describe("Administration authority for the personal and current-organization principals."),
+    /** Administration authority and requested-entitlement-relevant trials for the personal and current-organization principals. */
+    billing: z.array(effectiveAccessBillingPrincipalSchema).describe("Administration authority and requested-entitlement-relevant trials for the personal and current-organization principals."),
     /** Requested catalog entitlements in request order. */
     entitlements: z.array(effectiveAccessEntitlementSchema).describe("Requested catalog entitlements in request order."),
-}).describe("Live effective access and billing authority for the authenticated user.");
+}).describe("Live effective access, billing authority, and relevant trials for the authenticated user.");
 /** Runtime validator for {@link CurrentUser}. */
 export const currentUserSchema = z.object({
     /** Short handle or alias of the user. */
@@ -1394,8 +1411,8 @@ export const solutionSummarySchema = z.object({
     events: z.record(z.custom((value) => value !== undefined)).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().nullable().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."),
+    /** 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. Org-only rows remain `null`; when a list entry merges an org copy with its system counterpart, it may reuse the system row's public cover URL. Permanent URLs are never minted for private org assets. */
+    image_url: z.string().nullable().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. Org-only rows remain `null`; when a list entry merges an org copy with its system counterpart, it may reuse the system row's public cover URL. Permanent URLs are never minted for private org assets."),
     /** Config IDs (`cfg_...`) of this Solution's installations in the viewer's organization. The array is empty when the Solution is visible only from the system catalog. */
     installed_config_ids: z.array(z.string()).describe("Config IDs (`cfg_...`) of this Solution's installations in the viewer's organization. The array is empty when the Solution is visible only from the system catalog."),
     /** Resource type. Always `"Solution"`. */
@@ -1907,8 +1924,10 @@ export const agentToolSchema = z.object({
     parameters: z.record(z.custom((value) => value !== undefined)).optional().describe("JSON Schema object describing the tool's input parameters as presented to the LLM."),
     /** ID of the config record (`cfg_...`) storing the tool's parameter schema. `null` when parameters are defined inline. */
     parameters_config: z.string().optional().describe("ID of the config record (`cfg_...`) storing the tool's parameter schema. `null` when parameters are defined inline."),
-    /** Current status of the tool. One of `"active"` or `"disabled"`. */
-    status: z.string().optional().describe("Current status of the tool. One of `\"active\"` or `\"disabled\"`."),
+    /** Current MCP setup assessment, not a historical downgrade reason or upstream protocol probe. */
+    setup: setupSchema.nullable().optional().describe("Current MCP setup assessment, not a historical downgrade reason or upstream protocol probe."),
+    /** Current status of the tool. One of `"active"` or `"draft"`. */
+    status: z.string().optional().describe("Current status of the tool. One of `\"active\"` or `\"draft\"`."),
     /** When the tool was last modified (ISO 8601). */
     updated_at: z.string().optional().describe("When the tool was last modified (ISO 8601)."),
 }).describe("A tool attached to an agent, defining a capability the agent can invoke during a conversation or task run.");