@archastro/sdk 0.5.2 → 0.6.0

package/dist/types/ai.js

@@ -1,50 +1,130 @@
 // Copyright (c) 2026 ArchAstro Inc. All Rights Reserved.
 // This file is auto-generated by @archastro/sdk-generator. Do not edit.
-// Content hash: 553c5e455ac7
+// Content hash: a9120b7e4fcc
 import { z } from "zod";
-/** Tool call from assistant message. */
+/** Runtime validator for {@link AIChatStreamDone}. */
+export const aIChatStreamDoneSchema = z.object({
+    /** The overall finish reason for the completion. */
+    finish_reason: z.string().optional().describe("The overall finish reason for the completion."),
+    /** Number of model runs executed, including continuations triggered by tool calls. */
+    run_count: z.number().int().optional().describe("Number of model runs executed, including continuations triggered by tool calls."),
+    /** Aggregate token usage across every run in the completion (including tool-call continuations), keyed by model ID. */
+    total_usage: z.record(z.unknown()).optional().describe("Aggregate token usage across every run in the completion (including tool-call continuations), keyed by model ID."),
+    /** Token usage for the final run, keyed by model ID. */
+    usage: z.record(z.unknown()).optional().describe("Token usage for the final run, keyed by model ID."),
+}).describe("Terminal event marking the end of a streaming chat completion (SSE `done` event).");
+/** Runtime validator for {@link AIChatStreamError}. */
+export const aIChatStreamErrorSchema = z.object({
+    /** Human-readable description of the error that terminated the stream. */
+    message: z.string().describe("Human-readable description of the error that terminated the stream."),
+}).describe("Terminal error event for a streaming chat completion (SSE `error` event).");
+/** Runtime validator for {@link AIToolCall}. */
 export const aIToolCallSchema = z.object({
-    arguments: z.record(z.unknown()), // Tool arguments
-    id: z.string(), // Tool call ID
-    name: z.string(), // Tool/function name
-    thought_signature: z.string().optional(), // Optional thought signature
-});
-/** Tool result from tool execution. */
+    /** Arguments the model wants to pass to the tool, as a key-value map. Deserialize and validate these against the tool's input schema before executing. */
+    arguments: z.record(z.unknown()).describe("Arguments the model wants to pass to the tool, as a key-value map. Deserialize and validate these against the tool's input schema before executing."),
+    /** Unique identifier for this tool call, assigned by the model. Use this value as `id` when submitting the corresponding tool result. */
+    id: z.string().describe("Unique identifier for this tool call, assigned by the model. Use this value as `id` when submitting the corresponding tool result."),
+    /** Name of the tool or function the model wants to invoke, e.g. `"web_search"` or `"run_code"`. */
+    name: z.string().describe("Name of the tool or function the model wants to invoke, e.g. `\"web_search\"` or `\"run_code\"`."),
+    /** Opaque signature representing the model's internal reasoning that led to this tool call. `null` when the provider does not expose chain-of-thought data. */
+    thought_signature: z.string().optional().describe("Opaque signature representing the model's internal reasoning that led to this tool call. `null` when the provider does not expose chain-of-thought data."),
+}).describe("A tool (function) call emitted by the assistant within an AI message. Mirrors the OpenAI tool-call object format.");
+/** Runtime validator for {@link AIToolResult}. */
 export const aIToolResultSchema = z.object({
-    content: z.string().optional(), // Tool result content
-    id: z.string(), // Tool call ID this result responds to
-    name: z.string(), // Tool/function name
-    resolution: z.unknown().optional(), // Structured tool resolution
-});
-/** AI chat message (OpenAI-compatible format). */
+    /** Plain-text output produced by the tool execution. `null` when the result is expressed entirely through `resolution`. */
+    content: z.string().optional().describe("Plain-text output produced by the tool execution. `null` when the result is expressed entirely through `resolution`."),
+    /** ID of the tool call this result satisfies. Must match the `id` from the corresponding `AIToolCall`. */
+    id: z.string().describe("ID of the tool call this result satisfies. Must match the `id` from the corresponding `AIToolCall`."),
+    /** Name of the tool or function that was executed, e.g. `"web_search"`. Must match the `name` from the corresponding `AIToolCall`. */
+    name: z.string().describe("Name of the tool or function that was executed, e.g. `\"web_search\"`. Must match the `name` from the corresponding `AIToolCall`."),
+    /** Structured result data from the tool execution. Shape varies by tool. `null` when the result is expressed as plain text in `content`. */
+    resolution: z.unknown().optional().describe("Structured result data from the tool execution. Shape varies by tool. `null` when the result is expressed as plain text in `content`."),
+}).describe("The result of executing a tool call, submitted back to the model as a tool-role message. Mirrors the OpenAI tool-result object format.");
+/** Runtime validator for {@link AIMessage}. */
 export const aIMessageSchema = z.object({
-    content: z.string().optional(), // Message text content
-    content_parts: z.array(z.record(z.unknown())).optional(), // Multimodal content parts
-    resume_token: z.string().optional(), // Resume token for continuing conversations
-    role: z.string(), // Message role (system, user, assistant, tool)
-    structured_output: z.unknown().optional(), // Structured output data
-    tool_calls: z.array(aIToolCallSchema).optional(), // Tool calls from assistant
-    tool_results: z.array(aIToolResultSchema).optional(), // Tool results from tool execution
-});
-/** Schema for AI chat completion results. */
+    /** Plain-text content of the message. Present for `system`, `user`, and `assistant` messages. `null` when the message body is expressed through `content_parts` or `tool_calls`. */
+    content: z.string().optional().describe("Plain-text content of the message. Present for `system`, `user`, and `assistant` messages. `null` when the message body is expressed through `content_parts` or `tool_calls`."),
+    /** Multimodal content parts for the message, used when the body includes images or mixed media. Each part is a map with a `type` key (`"text"`, `"image_url"`, or `"image_data"`). `null` when `content` is set. */
+    content_parts: z.array(z.record(z.unknown())).optional().describe("Multimodal content parts for the message, used when the body includes images or mixed media. Each part is a map with a `type` key (`\"text\"`, `\"image_url\"`, or `\"image_data\"`). `null` when `content` is set."),
+    /** Opaque token that can be passed on a subsequent request to resume this conversation from the current state. `null` when the provider does not support conversation resumption. */
+    resume_token: z.string().optional().describe("Opaque token that can be passed on a subsequent request to resume this conversation from the current state. `null` when the provider does not support conversation resumption."),
+    /** The speaker role for this message. One of `"system"`, `"user"`, `"assistant"`, or `"tool"`. */
+    role: z.string().describe("The speaker role for this message. One of `\"system\"`, `\"user\"`, `\"assistant\"`, or `\"tool\"`."),
+    /** Parsed structured data returned by the model when a JSON schema or structured-output mode was requested. Shape varies by the schema supplied at call time. `null` when structured output was not requested. */
+    structured_output: z.unknown().optional().describe("Parsed structured data returned by the model when a JSON schema or structured-output mode was requested. Shape varies by the schema supplied at call time. `null` when structured output was not requested."),
+    /** Tool calls requested by the model in an `assistant` message. Present only on assistant messages that invoke one or more tools. `null` on all other message roles. */
+    tool_calls: z.array(aIToolCallSchema).optional().describe("Tool calls requested by the model in an `assistant` message. Present only on assistant messages that invoke one or more tools. `null` on all other message roles."),
+    /** Tool execution results provided in a `tool` message. Each entry corresponds to a prior tool call by its `id`. `null` on all other message roles. */
+    tool_results: z.array(aIToolResultSchema).optional().describe("Tool execution results provided in a `tool` message. Each entry corresponds to a prior tool call by its `id`. `null` on all other message roles."),
+}).describe("A single message in an AI conversation, following the OpenAI-compatible chat format. Used in both request inputs and completion responses.");
+/** Runtime validator for {@link AIChatStreamMessageComplete}. */
+export const aIChatStreamMessageCompleteSchema = z.object({
+    /** Why the model stopped generating this message, e.g. `"stop"`, `"length"`, or `"tool_calls"`. */
+    finish_reason: z.string().optional().describe("Why the model stopped generating this message, e.g. `\"stop\"`, `\"length\"`, or `\"tool_calls\"`."),
+    /** The complete assistant message for this run, assembled from the preceding deltas. */
+    message: aIMessageSchema.describe("The complete assistant message for this run, assembled from the preceding deltas."),
+    /** Token consumption for this run, keyed by model ID. `null` when usage data is unavailable. */
+    usage: z.record(z.unknown()).optional().describe("Token consumption for this run, keyed by model ID. `null` when usage data is unavailable."),
+}).describe("The fully assembled assistant message for one run of a streaming chat completion (SSE `message_complete` event).");
+/** Runtime validator for {@link AIChatStreamMessageDelta}. */
+export const aIChatStreamMessageDeltaSchema = z.object({
+    /** The chunk of assistant text produced since the previous `message_delta` event. Concatenate deltas in order to reconstruct the message. */
+    delta: z.string().describe("The chunk of assistant text produced since the previous `message_delta` event. Concatenate deltas in order to reconstruct the message."),
+}).describe("Incremental assistant text emitted during a streaming chat completion (SSE `message_delta` event).");
+/** Runtime validator for {@link AIChatStreamToolCallDelta}. */
+export const aIChatStreamToolCallDeltaSchema = z.object({
+    /** A chunk of the tool call's serialized arguments. Concatenate deltas to reconstruct the arguments JSON. */
+    delta: z.string().optional().describe("A chunk of the tool call's serialized arguments. Concatenate deltas to reconstruct the arguments JSON."),
+    /** Identifier of the tool call this delta belongs to, once the model has assigned one. */
+    id: z.string().optional().describe("Identifier of the tool call this delta belongs to, once the model has assigned one."),
+    /** Name of the tool being called, once known. */
+    name: z.string().optional().describe("Name of the tool being called, once known."),
+}).describe("Incremental tool-call data emitted as the model assembles a tool invocation (SSE `tool_call_delta` event).");
+/** Runtime validator for {@link AIChatStreamToolResult}. */
+export const aIChatStreamToolResultSchema = z.object({
+    /** The tool's output, serialized as a string. */
+    content: z.string().optional().describe("The tool's output, serialized as a string."),
+    /** ID of the tool call this result satisfies. */
+    id: z.string().optional().describe("ID of the tool call this result satisfies."),
+    /** Name of the tool that produced this result. */
+    name: z.string().optional().describe("Name of the tool that produced this result."),
+    /** How the tool call resolved, e.g. `"ok"` or `"error"`. */
+    resolution: z.string().optional().describe("How the tool call resolved, e.g. `\"ok\"` or `\"error\"`."),
+}).describe("The result of a server-executed tool, streamed back into the run (SSE `tool_result` event).");
+/** Runtime validator for {@link AICompletionResult}. */
 export const aICompletionResultSchema = z.object({
-    finish_reason: z.string(), // Completion stop reason
-    message: aIMessageSchema, // Final assistant message
-    messages: z.array(aIMessageSchema), // Full message history
-    token_usage: z.record(z.unknown()).optional(), // Token usage keyed by model
-});
-/** Schema for an AI image generation result. */
+    /** The reason the model stopped generating. Common values include `"stop"` (natural end), `"length"` (token limit reached), and `"tool_calls"` (the model invoked a tool). */
+    finish_reason: z.string().describe("The reason the model stopped generating. Common values include `\"stop\"` (natural end), `\"length\"` (token limit reached), and `\"tool_calls\"` (the model invoked a tool)."),
+    /** The final assistant message produced by the completion. */
+    message: aIMessageSchema.describe("The final assistant message produced by the completion."),
+    /** The complete message history for the conversation, including all user, assistant, and tool messages in order. */
+    messages: z.array(aIMessageSchema).describe("The complete message history for the conversation, including all user, assistant, and tool messages in order."),
+    /** Token consumption breakdown keyed by model ID. Each value is a map with `"input_tokens"` and `"output_tokens"` counts. `null` when usage data is unavailable. */
+    token_usage: z.record(z.unknown()).optional().describe("Token consumption breakdown keyed by model ID. Each value is a map with `\"input_tokens\"` and `\"output_tokens\"` counts. `null` when usage data is unavailable."),
+}).describe("The result of an AI chat completion request. Returned by chat completion endpoints after the model finishes generating.");
+/** Runtime validator for {@link AIImageResult}. */
 export const aIImageResultSchema = z.object({
-    aspect_ratio: z.string().optional(), // Aspect ratio (e.g. 16:9)
-    height: z.number().int().optional(), // Image height in pixels
-    image_data: z.string().optional(), // Base64-encoded image data
-    image_size: z.string().optional(), // Image size tier (e.g. 1K, 2K)
-    image_type: z.string().optional(), // MIME type (e.g. image/png)
-    image_url: z.string().optional(), // URL to the generated image
-    model: z.string(), // Model used for generation
-    revised_prompt: z.string().optional(), // Provider-revised prompt
-    size: z.string().optional(), // Size string (e.g. 1024x1024)
-    usage: z.record(z.unknown()).optional(), // Token/usage information
-    width: z.number().int().optional(), // Image width in pixels
-});
+    /** Aspect ratio of the generated image, e.g. `"16:9"` or `"1:1"`. `null` when not reported by the provider. */
+    aspect_ratio: z.string().optional().describe("Aspect ratio of the generated image, e.g. `\"16:9\"` or `\"1:1\"`. `null` when not reported by the provider."),
+    /** Height of the generated image in pixels. `null` when the provider does not report dimensions. */
+    height: z.number().int().optional().describe("Height of the generated image in pixels. `null` when the provider does not report dimensions."),
+    /** The generated image encoded as a base64 string. Present when the provider returns inline image data. `null` when `image_url` is set instead. */
+    image_data: z.string().optional().describe("The generated image encoded as a base64 string. Present when the provider returns inline image data. `null` when `image_url` is set instead."),
+    /** Resolution tier label for the image, e.g. `"1K"` or `"2K"`. `null` when the provider does not include a tier label. */
+    image_size: z.string().optional().describe("Resolution tier label for the image, e.g. `\"1K\"` or `\"2K\"`. `null` when the provider does not include a tier label."),
+    /** MIME type of the generated image, e.g. `"image/png"` or `"image/jpeg"`. `null` when the provider does not report a content type. */
+    image_type: z.string().optional().describe("MIME type of the generated image, e.g. `\"image/png\"` or `\"image/jpeg\"`. `null` when the provider does not report a content type."),
+    /** Temporary URL pointing to the generated image hosted by the provider. Present when the provider returns a URL rather than inline data. `null` when `image_data` is set instead. */
+    image_url: z.string().optional().describe("Temporary URL pointing to the generated image hosted by the provider. Present when the provider returns a URL rather than inline data. `null` when `image_data` is set instead."),
+    /** Identifier of the model that produced the image, e.g. `"dall-e-3"` or `"imagen-3"`. */
+    model: z.string().describe("Identifier of the model that produced the image, e.g. `\"dall-e-3\"` or `\"imagen-3\"`."),
+    /** The prompt as rewritten by the provider before generation. Some providers (e.g. DALL-E 3) automatically expand or safety-check the original prompt. `null` when the provider does not revise prompts. */
+    revised_prompt: z.string().optional().describe("The prompt as rewritten by the provider before generation. Some providers (e.g. DALL-E 3) automatically expand or safety-check the original prompt. `null` when the provider does not revise prompts."),
+    /** Canonical size string as returned by the provider, e.g. `"1024x1024"`. `null` when not reported. */
+    size: z.string().optional().describe("Canonical size string as returned by the provider, e.g. `\"1024x1024\"`. `null` when not reported."),
+    /** Provider-reported token and compute usage for the request. Structure varies by provider. `null` when usage data is unavailable. */
+    usage: z.record(z.unknown()).optional().describe("Provider-reported token and compute usage for the request. Structure varies by provider. `null` when usage data is unavailable."),
+    /** Width of the generated image in pixels. `null` when the provider does not report dimensions. */
+    width: z.number().int().optional().describe("Width of the generated image in pixels. `null` when the provider does not report dimensions."),
+}).describe("The result returned by an AI image generation or editing operation. Contains the generated image (as inline data or a URL) along with dimension, size, and usage metadata.");
 //# sourceMappingURL=ai.js.map

package/dist/types/ai.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai.js","sourceRoot":"","sources":["../../src/types/ai.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ai.js","sourceRoot":"","sources":["../../src/types/ai.ts"],"names":[],"mappings":"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"}

package/dist/types/artifacts.d.ts

@@ -1,15 +1,65 @@
 import { z } from "zod";
-/** API schema for an artifact. */
+import type { ImageSource } from "./image.js";
+/** A versioned artifact produced or managed by an agent, such as a generated file, report, or code output. */
+export interface Artifact {
+    /** ID of the agent that produced this artifact (`agt_...`). `null` if not agent-produced. */
+    agent?: string | undefined;
+    /** MIME type of the current version's file, e.g. `"text/csv"` or `"image/png"`. `null` if no file is attached. */
+    content_type?: string | undefined;
+    /** When the artifact was first created (ISO 8601). */
+    created_at?: string | undefined;
+    /** ID of the current (latest published) artifact version (`artv_...`). `null` if no version has been published. */
+    current_version?: string | undefined;
+    /** Optional longer description of the artifact's contents or purpose. `null` if not set. */
+    description?: string | undefined;
+    /** Storage file ID for the current version (`fil_...`). `null` if no file is attached. */
+    file?: string | undefined;
+    /** Original filename of the current version's file, e.g. `"output.csv"`. `null` if no file is attached. */
+    file_name?: string | undefined;
+    /** Short-lived signed URL for downloading the current version's file. `null` if no file is attached. */
+    file_url?: string | undefined;
+    /** Artifact ID (`art_...`). */
+    id: string;
+    /** Image source metadata for rendering the current version's file inline. Present only when `content_type` starts with `"image/"`. `null` otherwise. */
+    image_source?: ImageSource | undefined;
+    /** Human-readable name for the artifact, e.g. `"Q2 Report"`. `null` if not set. */
+    name?: string | undefined;
+    /** ID of the organization this artifact belongs to (`org_...`). */
+    org?: string | undefined;
+    /** Identifier of the sandbox environment associated with this artifact. `null` if not sandbox-scoped. */
+    sandbox?: string | undefined;
+    /** ID of the team that owns this artifact (`tea_...`). `null` if not team-scoped. */
+    team?: string | undefined;
+    /** ID of the thread in which this artifact was created (`thr_...`). `null` if not thread-scoped. */
+    thread?: string | undefined;
+    /** When the artifact record was last modified (ISO 8601). */
+    updated_at?: string | undefined;
+    /** ID of the user who created this artifact (`usr_...`). `null` if not user-scoped. */
+    user?: string | undefined;
+    /** Current version number of the artifact. Increments each time a new version is published. */
+    version?: number | undefined;
+}
+/** Runtime validator for {@link Artifact}. */
 export declare const artifactSchema: z.ZodObject<{
+    /** ID of the agent that produced this artifact (`agt_...`). `null` if not agent-produced. */
     agent: z.ZodOptional<z.ZodString>;
+    /** MIME type of the current version's file, e.g. `"text/csv"` or `"image/png"`. `null` if no file is attached. */
     content_type: z.ZodOptional<z.ZodString>;
+    /** When the artifact was first created (ISO 8601). */
     created_at: z.ZodOptional<z.ZodString>;
+    /** ID of the current (latest published) artifact version (`artv_...`). `null` if no version has been published. */
     current_version: z.ZodOptional<z.ZodString>;
+    /** Optional longer description of the artifact's contents or purpose. `null` if not set. */
     description: z.ZodOptional<z.ZodString>;
+    /** Storage file ID for the current version (`fil_...`). `null` if no file is attached. */
     file: z.ZodOptional<z.ZodString>;
+    /** Original filename of the current version's file, e.g. `"output.csv"`. `null` if no file is attached. */
     file_name: z.ZodOptional<z.ZodString>;
+    /** Short-lived signed URL for downloading the current version's file. `null` if no file is attached. */
     file_url: z.ZodOptional<z.ZodString>;
+    /** Artifact ID (`art_...`). */
     id: z.ZodString;
+    /** Image source metadata for rendering the current version's file inline. Present only when `content_type` starts with `"image/"`. `null` otherwise. */
     image_source: z.ZodOptional<z.ZodObject<{
         file: z.ZodOptional<z.ZodString>;
         height: z.ZodOptional<z.ZodNumber>;
@@ -19,84 +69,91 @@ export declare const artifactSchema: z.ZodObject<{
         url: z.ZodOptional<z.ZodString>;
         width: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
+        mime_type?: string | undefined;
         file?: string | undefined;
         height?: number | undefined;
         media?: string | undefined;
-        mime_type?: string | undefined;
         refresh_url?: string | undefined;
         url?: string | undefined;
         width?: number | undefined;
     }, {
+        mime_type?: string | undefined;
         file?: string | undefined;
         height?: number | undefined;
         media?: string | undefined;
-        mime_type?: string | undefined;
         refresh_url?: string | undefined;
         url?: string | undefined;
         width?: number | undefined;
     }>>;
+    /** Human-readable name for the artifact, e.g. `"Q2 Report"`. `null` if not set. */
     name: z.ZodOptional<z.ZodString>;
+    /** ID of the organization this artifact belongs to (`org_...`). */
     org: z.ZodOptional<z.ZodString>;
+    /** Identifier of the sandbox environment associated with this artifact. `null` if not sandbox-scoped. */
     sandbox: z.ZodOptional<z.ZodString>;
+    /** ID of the team that owns this artifact (`tea_...`). `null` if not team-scoped. */
     team: z.ZodOptional<z.ZodString>;
+    /** ID of the thread in which this artifact was created (`thr_...`). `null` if not thread-scoped. */
     thread: z.ZodOptional<z.ZodString>;
+    /** When the artifact record was last modified (ISO 8601). */
     updated_at: z.ZodOptional<z.ZodString>;
+    /** ID of the user who created this artifact (`usr_...`). `null` if not user-scoped. */
     user: z.ZodOptional<z.ZodString>;
+    /** Current version number of the artifact. Increments each time a new version is published. */
     version: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     id: string;
-    file?: string | undefined;
-    name?: string | undefined;
+    agent?: string | undefined;
+    thread?: string | undefined;
+    team?: string | undefined;
     org?: string | undefined;
-    sandbox?: string | undefined;
     created_at?: string | undefined;
-    thread?: string | undefined;
+    sandbox?: string | undefined;
+    current_version?: string | undefined;
+    updated_at?: string | undefined;
     user?: string | undefined;
+    file?: string | undefined;
+    name?: string | undefined;
+    description?: string | undefined;
     content_type?: string | undefined;
     image_source?: {
+        mime_type?: string | undefined;
         file?: string | undefined;
         height?: number | undefined;
         media?: string | undefined;
-        mime_type?: string | undefined;
         refresh_url?: string | undefined;
         url?: string | undefined;
         width?: number | undefined;
     } | undefined;
-    updated_at?: string | undefined;
-    description?: string | undefined;
     version?: number | undefined;
-    team?: string | undefined;
-    agent?: string | undefined;
-    current_version?: string | undefined;
     file_name?: string | undefined;
     file_url?: string | undefined;
 }, {
     id: string;
-    file?: string | undefined;
-    name?: string | undefined;
+    agent?: string | undefined;
+    thread?: string | undefined;
+    team?: string | undefined;
     org?: string | undefined;
-    sandbox?: string | undefined;
     created_at?: string | undefined;
-    thread?: string | undefined;
+    sandbox?: string | undefined;
+    current_version?: string | undefined;
+    updated_at?: string | undefined;
     user?: string | undefined;
+    file?: string | undefined;
+    name?: string | undefined;
+    description?: string | undefined;
     content_type?: string | undefined;
     image_source?: {
+        mime_type?: string | undefined;
         file?: string | undefined;
         height?: number | undefined;
         media?: string | undefined;
-        mime_type?: string | undefined;
         refresh_url?: string | undefined;
         url?: string | undefined;
         width?: number | undefined;
     } | undefined;
-    updated_at?: string | undefined;
-    description?: string | undefined;
     version?: number | undefined;
-    team?: string | undefined;
-    agent?: string | undefined;
-    current_version?: string | undefined;
     file_name?: string | undefined;
     file_url?: string | undefined;
 }>;
-export type Artifact = z.infer<typeof artifactSchema>;
 //# sourceMappingURL=artifacts.d.ts.map

package/dist/types/artifacts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../src/types/artifacts.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,kCAAkC;AAClC,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmBzB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../src/types/artifacts.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,8GAA8G;AAC9G,MAAM,WAAW,QAAQ;IACvB,6FAA6F;IAC7F,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,kHAAkH;IAClH,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,mHAAmH;IACnH,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,4FAA4F;IAC5F,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,0FAA0F;IAC1F,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,2GAA2G;IAC3G,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,wGAAwG;IACxG,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,wJAAwJ;IACxJ,YAAY,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACvC,mFAAmF;IACnF,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,mEAAmE;IACnE,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,yGAAyG;IACzG,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,qFAAqF;IACrF,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,oGAAoG;IACpG,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,uFAAuF;IACvF,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,+FAA+F;IAC/F,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED,8CAA8C;AAC9C,eAAO,MAAM,cAAc;IACzB,6FAA6F;;IAE7F,kHAAkH;;IAElH,sDAAsD;;IAEtD,mHAAmH;;IAEnH,4FAA4F;;IAE5F,0FAA0F;;IAE1F,2GAA2G;;IAE3G,wGAAwG;;IAExG,+BAA+B;;IAE/B,wJAAwJ;;;;;;;;;;;;;;;;;;;;;;;;;;IAExJ,mFAAmF;;IAEnF,mEAAmE;;IAEnE,yGAAyG;;IAEzG,qFAAqF;;IAErF,oGAAoG;;IAEpG,6DAA6D;;IAE7D,uFAAuF;;IAEvF,+FAA+F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEmD,CAAC"}

package/dist/types/artifacts.js

@@ -1,27 +1,45 @@
 // Copyright (c) 2026 ArchAstro Inc. All Rights Reserved.
 // This file is auto-generated by @archastro/sdk-generator. Do not edit.
-// Content hash: 6821b85d633c
+// Content hash: bcb128cc379a
 import { z } from "zod";
 import { imageSourceSchema } from "./image.js";
-/** API schema for an artifact. */
+/** Runtime validator for {@link Artifact}. */
 export const artifactSchema = z.object({
-    agent: z.string().optional(), // Agent
-    content_type: z.string().optional(), // MIME content type
-    created_at: z.string().optional(), // Creation timestamp
-    current_version: z.string().optional(), // Current version ID
-    description: z.string().optional(), // Artifact description
-    file: z.string().optional(), // Storage file
-    file_name: z.string().optional(), // Original filename
-    file_url: z.string().optional(), // Signed file URL
-    id: z.string(), // Artifact ID
-    image_source: imageSourceSchema.optional(), // Image source metadata
-    name: z.string().optional(), // Artifact name
-    org: z.string().optional(), // Organization
-    sandbox: z.string().optional(), // Sandbox identifier
-    team: z.string().optional(), // Team
-    thread: z.string().optional(), // Thread
-    updated_at: z.string().optional(), // Last update timestamp
-    user: z.string().optional(), // User
-    version: z.number().int().optional(), // Current version number
-});
+    /** ID of the agent that produced this artifact (`agt_...`). `null` if not agent-produced. */
+    agent: z.string().optional().describe("ID of the agent that produced this artifact (`agt_...`). `null` if not agent-produced."),
+    /** MIME type of the current version's file, e.g. `"text/csv"` or `"image/png"`. `null` if no file is attached. */
+    content_type: z.string().optional().describe("MIME type of the current version's file, e.g. `\"text/csv\"` or `\"image/png\"`. `null` if no file is attached."),
+    /** When the artifact was first created (ISO 8601). */
+    created_at: z.string().optional().describe("When the artifact was first created (ISO 8601)."),
+    /** ID of the current (latest published) artifact version (`artv_...`). `null` if no version has been published. */
+    current_version: z.string().optional().describe("ID of the current (latest published) artifact version (`artv_...`). `null` if no version has been published."),
+    /** Optional longer description of the artifact's contents or purpose. `null` if not set. */
+    description: z.string().optional().describe("Optional longer description of the artifact's contents or purpose. `null` if not set."),
+    /** Storage file ID for the current version (`fil_...`). `null` if no file is attached. */
+    file: z.string().optional().describe("Storage file ID for the current version (`fil_...`). `null` if no file is attached."),
+    /** Original filename of the current version's file, e.g. `"output.csv"`. `null` if no file is attached. */
+    file_name: z.string().optional().describe("Original filename of the current version's file, e.g. `\"output.csv\"`. `null` if no file is attached."),
+    /** Short-lived signed URL for downloading the current version's file. `null` if no file is attached. */
+    file_url: z.string().optional().describe("Short-lived signed URL for downloading the current version's file. `null` if no file is attached."),
+    /** Artifact ID (`art_...`). */
+    id: z.string().describe("Artifact ID (`art_...`)."),
+    /** Image source metadata for rendering the current version's file inline. Present only when `content_type` starts with `"image/"`. `null` otherwise. */
+    image_source: imageSourceSchema.optional().describe("Image source metadata for rendering the current version's file inline. Present only when `content_type` starts with `\"image/\"`. `null` otherwise."),
+    /** Human-readable name for the artifact, e.g. `"Q2 Report"`. `null` if not set. */
+    name: z.string().optional().describe("Human-readable name for the artifact, e.g. `\"Q2 Report\"`. `null` if not set."),
+    /** ID of the organization this artifact belongs to (`org_...`). */
+    org: z.string().optional().describe("ID of the organization this artifact belongs to (`org_...`)."),
+    /** Identifier of the sandbox environment associated with this artifact. `null` if not sandbox-scoped. */
+    sandbox: z.string().optional().describe("Identifier of the sandbox environment associated with this artifact. `null` if not sandbox-scoped."),
+    /** ID of the team that owns this artifact (`tea_...`). `null` if not team-scoped. */
+    team: z.string().optional().describe("ID of the team that owns this artifact (`tea_...`). `null` if not team-scoped."),
+    /** ID of the thread in which this artifact was created (`thr_...`). `null` if not thread-scoped. */
+    thread: z.string().optional().describe("ID of the thread in which this artifact was created (`thr_...`). `null` if not thread-scoped."),
+    /** When the artifact record was last modified (ISO 8601). */
+    updated_at: z.string().optional().describe("When the artifact record was last modified (ISO 8601)."),
+    /** ID of the user who created this artifact (`usr_...`). `null` if not user-scoped. */
+    user: z.string().optional().describe("ID of the user who created this artifact (`usr_...`). `null` if not user-scoped."),
+    /** Current version number of the artifact. Increments each time a new version is published. */
+    version: z.number().int().optional().describe("Current version number of the artifact. Increments each time a new version is published."),
+}).describe("A versioned artifact produced or managed by an agent, such as a generated file, report, or code output.");
 //# sourceMappingURL=artifacts.js.map

package/dist/types/artifacts.js.map

@@ -1 +1 @@
-{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../../src/types/artifacts.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,wEAAwE;AACxE,6BAA6B;AAE7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,kCAAkC;AAClC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,QAAQ;IACtC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,oBAAoB;IACzD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,qBAAqB;IACxD,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,qBAAqB;IAC7D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,uBAAuB;IAC3D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,eAAe;IAC5C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,oBAAoB;IACtD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,kBAAkB;IACnD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,cAAc;IAC9B,YAAY,EAAE,iBAAiB,CAAC,QAAQ,EAAE,EAAE,wBAAwB;IACpE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,gBAAgB;IAC7C,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,eAAe;IAC3C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,qBAAqB;IACrD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,OAAO;IACpC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,SAAS;IACxC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,wBAAwB;IAC3D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,OAAO;IACpC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,yBAAyB;CAChE,CAAC,CAAC"}
+{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../../src/types/artifacts.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,wEAAwE;AACxE,6BAA6B;AAE7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AA2C/C,8CAA8C;AAC9C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,6FAA6F;IAC7F,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wFAAwF,CAAC;IAC/H,kHAAkH;IAClH,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iHAAiH,CAAC;IAC/J,sDAAsD;IACtD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;IAC7F,mHAAmH;IACnH,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8GAA8G,CAAC;IAC/J,4FAA4F;IAC5F,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uFAAuF,CAAC;IACpI,0FAA0F;IAC1F,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qFAAqF,CAAC;IAC3H,2GAA2G;IAC3G,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wGAAwG,CAAC;IACnJ,wGAAwG;IACxG,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mGAAmG,CAAC;IAC7I,+BAA+B;IAC/B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IACnD,wJAAwJ;IACxJ,YAAY,EAAE,iBAAiB,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qJAAqJ,CAAC;IAC1M,mFAAmF;IACnF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gFAAgF,CAAC;IACtH,mEAAmE;IACnE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8DAA8D,CAAC;IACnG,yGAAyG;IACzG,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oGAAoG,CAAC;IAC7I,qFAAqF;IACrF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gFAAgF,CAAC;IACtH,oGAAoG;IACpG,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+FAA+F,CAAC;IACvI,6DAA6D;IAC7D,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;IACpG,uFAAuF;IACvF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kFAAkF,CAAC;IACxH,+FAA+F;IAC/F,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0FAA0F,CAAC;CAC1I,CAAC,CAAC,QAAQ,CAAC,yGAAyG,CAA+B,CAAC"}

package/dist/types/automations.d.ts

@@ -1,29 +1,62 @@
 import { z } from "zod";
-/** Schema for an automation run.
-
-Maps to serialized automation run output from developer portal API.
- */
+/** A single execution of an automation triggered by a platform event or direct invocation. Captures the run's status, input payload, and final result. */
+export interface AutomationRun {
+    /** ID of the app that owns this automation run (`dap_...`). */
+    app: string;
+    /** ID of the automation that was executed (`aut_...`). */
+    automation: string;
+    /** When the automation run was created (ISO 8601). */
+    created_at?: string | undefined;
+    /** ID of the platform event that triggered this run. `null` for directly invoked automations. */
+    event_id?: string | undefined;
+    /** Automation run ID (`atr_...`). */
+    id: string;
+    /** The input event payload that triggered this run. Structure varies by automation type. Defaults to an empty object if no payload was provided. */
+    payload?: Record<string, unknown> | undefined;
+    /** The output produced after the automation finished executing. Contains workflow-defined keys alongside any returned output. `null` if the run has not yet completed. */
+    result?: Record<string, unknown> | undefined;
+    /** Current execution status of the run. One of `"pending"` (queued, not yet started), `"running"` (actively executing), `"completed"` (finished successfully), `"failed"` (finished with an error), or `"cancelled"` (stopped before completion). */
+    status: string;
+    /** ID of the team that owns this run (`tea_...`). `null` if the run is owned by a user rather than a team. */
+    team?: string | undefined;
+    /** When the automation run record was last updated (ISO 8601). */
+    updated_at?: string | undefined;
+    /** ID of the user that owns this run (`usr_...`). `null` if the run is owned by a team rather than a user. */
+    user?: string | undefined;
+}
+/** Runtime validator for {@link AutomationRun}. */
 export declare const automationRunSchema: z.ZodObject<{
+    /** ID of the app that owns this automation run (`dap_...`). */
     app: z.ZodString;
+    /** ID of the automation that was executed (`aut_...`). */
     automation: z.ZodString;
+    /** When the automation run was created (ISO 8601). */
     created_at: z.ZodOptional<z.ZodString>;
+    /** ID of the platform event that triggered this run. `null` for directly invoked automations. */
     event_id: z.ZodOptional<z.ZodString>;
+    /** Automation run ID (`atr_...`). */
     id: z.ZodString;
+    /** The input event payload that triggered this run. Structure varies by automation type. Defaults to an empty object if no payload was provided. */
     payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    /** The output produced after the automation finished executing. Contains workflow-defined keys alongside any returned output. `null` if the run has not yet completed. */
     result: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    /** Current execution status of the run. One of `"pending"` (queued, not yet started), `"running"` (actively executing), `"completed"` (finished successfully), `"failed"` (finished with an error), or `"cancelled"` (stopped before completion). */
     status: z.ZodString;
+    /** ID of the team that owns this run (`tea_...`). `null` if the run is owned by a user rather than a team. */
     team: z.ZodOptional<z.ZodString>;
+    /** When the automation run record was last updated (ISO 8601). */
     updated_at: z.ZodOptional<z.ZodString>;
+    /** ID of the user that owns this run (`usr_...`). `null` if the run is owned by a team rather than a user. */
     user: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     status: string;
     id: string;
     app: string;
     automation: string;
+    team?: string | undefined;
     created_at?: string | undefined;
-    user?: string | undefined;
     updated_at?: string | undefined;
-    team?: string | undefined;
+    user?: string | undefined;
     payload?: Record<string, unknown> | undefined;
     event_id?: string | undefined;
     result?: Record<string, unknown> | undefined;
@@ -32,13 +65,12 @@ export declare const automationRunSchema: z.ZodObject<{
     id: string;
     app: string;
     automation: string;
+    team?: string | undefined;
     created_at?: string | undefined;
-    user?: string | undefined;
     updated_at?: string | undefined;
-    team?: string | undefined;
+    user?: string | undefined;
     payload?: Record<string, unknown> | undefined;
     event_id?: string | undefined;
     result?: Record<string, unknown> | undefined;
 }>;
-export type AutomationRun = z.infer<typeof automationRunSchema>;
 //# sourceMappingURL=automations.d.ts.map

package/dist/types/automations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"automations.d.ts","sourceRoot":"","sources":["../../src/types/automations.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAY9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}
+{"version":3,"file":"automations.d.ts","sourceRoot":"","sources":["../../src/types/automations.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,0JAA0J;AAC1J,MAAM,WAAW,aAAa;IAC5B,+DAA+D;IAC/D,GAAG,EAAE,MAAM,CAAC;IACZ,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,iGAAiG;IACjG,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,oJAAoJ;IACpJ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC9C,0KAA0K;IAC1K,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC7C,qPAAqP;IACrP,MAAM,EAAE,MAAM,CAAC;IACf,8GAA8G;IAC9G,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,8GAA8G;IAC9G,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED,mDAAmD;AACnD,eAAO,MAAM,mBAAmB;IAC9B,+DAA+D;;IAE/D,0DAA0D;;IAE1D,sDAAsD;;IAEtD,iGAAiG;;IAEjG,qCAAqC;;IAErC,oJAAoJ;;IAEpJ,0KAA0K;;IAE1K,qPAAqP;;IAErP,8GAA8G;;IAE9G,kEAAkE;;IAElE,8GAA8G;;;;;;;;;;;;;;;;;;;;;;;;;;EAEqF,CAAC"}