@archastro/sdk 0.5.0 → 0.5.3

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"}

package/dist/types/automations.js

@@ -1,22 +1,30 @@
 // Copyright (c) 2026 ArchAstro Inc. All Rights Reserved.
 // This file is auto-generated by @archastro/sdk-generator. Do not edit.
-// Content hash: ff9a625c46e3
+// Content hash: 6f9b2344ac6b
 import { z } from "zod";
-/** Schema for an automation run.
-
-Maps to serialized automation run output from developer portal API.
- */
+/** Runtime validator for {@link AutomationRun}. */
 export const automationRunSchema = z.object({
-    app: z.string(), // App (dap_...)
-    automation: z.string(), // Automation (aut_...)
-    created_at: z.string().optional(), // Created timestamp
-    event_id: z.string().optional(), // Triggering event ID
-    id: z.string(), // Public ID (atr_...)
-    payload: z.record(z.unknown()).optional(), // Event payload
-    result: z.record(z.unknown()).optional(), // Workflow execution result (payload and output)
-    status: z.string(), // Status: pending, running, completed, failed, cancelled
-    team: z.string().optional(), // Team if team-owned
-    updated_at: z.string().optional(), // Updated timestamp
-    user: z.string().optional(), // User if user-owned
-});
+    /** ID of the app that owns this automation run (`dap_...`). */
+    app: z.string().describe("ID of the app that owns this automation run (`dap_...`)."),
+    /** ID of the automation that was executed (`aut_...`). */
+    automation: z.string().describe("ID of the automation that was executed (`aut_...`)."),
+    /** When the automation run was created (ISO 8601). */
+    created_at: z.string().optional().describe("When the automation run was created (ISO 8601)."),
+    /** ID of the platform event that triggered this run. `null` for directly invoked automations. */
+    event_id: z.string().optional().describe("ID of the platform event that triggered this run. `null` for directly invoked automations."),
+    /** Automation run ID (`atr_...`). */
+    id: z.string().describe("Automation run ID (`atr_...`)."),
+    /** 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.record(z.unknown()).optional().describe("The input event payload that triggered this run. Structure varies by automation type. Defaults to an empty object if no payload was provided."),
+    /** 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.record(z.unknown()).optional().describe("The output produced after the automation finished executing. Contains workflow-defined keys alongside any returned output. `null` if the run has not yet completed."),
+    /** 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.string().describe("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)."),
+    /** ID of the team that owns this run (`tea_...`). `null` if the run is owned by a user rather than a team. */
+    team: z.string().optional().describe("ID of the team that owns this run (`tea_...`). `null` if the run is owned by a user rather than a team."),
+    /** When the automation run record was last updated (ISO 8601). */
+    updated_at: z.string().optional().describe("When the automation run record was last updated (ISO 8601)."),
+    /** ID of the user that owns this run (`usr_...`). `null` if the run is owned by a team rather than a user. */
+    user: z.string().optional().describe("ID of the user that owns this run (`usr_...`). `null` if the run is owned by a team rather than a user."),
+}).describe("A single execution of an automation triggered by a platform event or direct invocation. Captures the run's status, input payload, and final result.");
 //# sourceMappingURL=automations.js.map

package/dist/types/automations.js.map

@@ -1 +1 @@
-{"version":3,"file":"automations.js","sourceRoot":"","sources":["../../src/types/automations.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,wEAAwE;AACxE,6BAA6B;AAE7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,gBAAgB;IACjC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,uBAAuB;IAC/C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,oBAAoB;IACvD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,sBAAsB;IACvD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,sBAAsB;IACtC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,gBAAgB;IAC3D,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,iDAAiD;IAC3F,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,yDAAyD;IAC7E,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,qBAAqB;IAClD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,oBAAoB;IACvD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,qBAAqB;CACnD,CAAC,CAAC"}
+{"version":3,"file":"automations.js","sourceRoot":"","sources":["../../src/types/automations.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,wEAAwE;AACxE,6BAA6B;AAE7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA4BxB,mDAAmD;AACnD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,+DAA+D;IAC/D,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0DAA0D,CAAC;IACpF,0DAA0D;IAC1D,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qDAAqD,CAAC;IACtF,sDAAsD;IACtD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;IAC7F,iGAAiG;IACjG,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4FAA4F,CAAC;IACtI,qCAAqC;IACrC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IACzD,oJAAoJ;IACpJ,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+IAA+I,CAAC;IACnM,0KAA0K;IAC1K,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qKAAqK,CAAC;IACxN,qPAAqP;IACrP,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0PAA0P,CAAC;IACvR,8GAA8G;IAC9G,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yGAAyG,CAAC;IAC/I,kEAAkE;IAClE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6DAA6D,CAAC;IACzG,8GAA8G;IAC9G,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yGAAyG,CAAC;CAChJ,CAAC,CAAC,QAAQ,CAAC,qJAAqJ,CAAoC,CAAC"}