@archastro/sdk 0.20.0 → 0.21.0

package/dist/types/artifacts.d.ts

@@ -1,7 +1,10 @@
 import { z } from "zod";
+import type { Acl } from "./common.js";
 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 {
+    /** Access control list for the artifact. Contains a `grants` array where each entry specifies `principal_type`, `principal`, and `actions` (`read`, `write`). `null` when the artifact has no grants or the viewer is not its owner. */
+    acl?: Acl | null | undefined;
     /** 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. */
@@ -45,6 +48,75 @@ export interface Artifact {
 }
 /** Runtime validator for {@link Artifact}. */
 export declare const artifactSchema: z.ZodObject<{
+    /** Access control list for the artifact. Contains a `grants` array where each entry specifies `principal_type`, `principal`, and `actions` (`read`, `write`). `null` when the artifact has no grants or the viewer is not its owner. */
+    acl: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        add: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            actions: z.ZodArray<z.ZodString, "many">;
+            principal: z.ZodOptional<z.ZodString>;
+            principal_type: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            actions: string[];
+            principal_type: string;
+            principal?: string | undefined;
+        }, {
+            actions: string[];
+            principal_type: string;
+            principal?: string | undefined;
+        }>, "many">>;
+        grants: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            actions: z.ZodArray<z.ZodString, "many">;
+            principal: z.ZodOptional<z.ZodString>;
+            principal_type: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            actions: string[];
+            principal_type: string;
+            principal?: string | undefined;
+        }, {
+            actions: string[];
+            principal_type: string;
+            principal?: string | undefined;
+        }>, "many">>;
+        remove: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            principal: z.ZodOptional<z.ZodString>;
+            principal_type: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            principal_type: string;
+            principal?: string | undefined;
+        }, {
+            principal_type: string;
+            principal?: string | undefined;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        add?: {
+            actions: string[];
+            principal_type: string;
+            principal?: string | undefined;
+        }[] | undefined;
+        grants?: {
+            actions: string[];
+            principal_type: string;
+            principal?: string | undefined;
+        }[] | undefined;
+        remove?: {
+            principal_type: string;
+            principal?: string | undefined;
+        }[] | undefined;
+    }, {
+        add?: {
+            actions: string[];
+            principal_type: string;
+            principal?: string | undefined;
+        }[] | undefined;
+        grants?: {
+            actions: string[];
+            principal_type: string;
+            principal?: string | undefined;
+        }[] | undefined;
+        remove?: {
+            principal_type: string;
+            principal?: string | undefined;
+        }[] | undefined;
+    }>>>;
     /** 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. */
@@ -123,6 +195,22 @@ export declare const artifactSchema: z.ZodObject<{
     sandbox?: string | undefined;
     current_version?: string | undefined;
     file?: string | undefined;
+    acl?: {
+        add?: {
+            actions: string[];
+            principal_type: string;
+            principal?: string | undefined;
+        }[] | undefined;
+        grants?: {
+            actions: string[];
+            principal_type: string;
+            principal?: string | undefined;
+        }[] | undefined;
+        remove?: {
+            principal_type: string;
+            principal?: string | undefined;
+        }[] | undefined;
+    } | null | undefined;
     content_type?: string | undefined;
     image_source?: {
         mime_type?: string | null | undefined;
@@ -152,6 +240,22 @@ export declare const artifactSchema: z.ZodObject<{
     sandbox?: string | undefined;
     current_version?: string | undefined;
     file?: string | undefined;
+    acl?: {
+        add?: {
+            actions: string[];
+            principal_type: string;
+            principal?: string | undefined;
+        }[] | undefined;
+        grants?: {
+            actions: string[];
+            principal_type: string;
+            principal?: string | undefined;
+        }[] | undefined;
+        remove?: {
+            principal_type: string;
+            principal?: string | undefined;
+        }[] | undefined;
+    } | null | undefined;
     content_type?: string | undefined;
     image_source?: {
         mime_type?: string | null | undefined;
@@ -168,4 +272,251 @@ export declare const artifactSchema: z.ZodObject<{
     group_key?: string | null | undefined;
     system?: boolean | undefined;
 }>;
+/** Acknowledges an Artifact editing presence or leave request. */
+export interface ArtifactEditingAck {
+    ok: boolean;
+}
+/** Runtime validator for {@link ArtifactEditingAck}. */
+export declare const artifactEditingAckSchema: z.ZodObject<{
+    ok: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    ok: boolean;
+}, {
+    ok: boolean;
+}>;
+/** A Unicode code-point cursor and optional selection endpoint. */
+export interface ArtifactEditingCursor {
+    /** Zero-based Unicode code-point position. */
+    position: number;
+    /** Zero-based Unicode code-point selection endpoint. */
+    selection_end?: number | undefined;
+}
+/** Runtime validator for {@link ArtifactEditingCursor}. */
+export declare const artifactEditingCursorSchema: z.ZodObject<{
+    /** Zero-based Unicode code-point position. */
+    position: z.ZodNumber;
+    /** Zero-based Unicode code-point selection endpoint. */
+    selection_end: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    position: number;
+    selection_end?: number | undefined;
+}, {
+    position: number;
+    selection_end?: number | undefined;
+}>;
+/** A server-issued collaborator identity and its ephemeral presence. */
+export interface ArtifactEditingActor {
+    /** Opaque identity unique to this channel join. */
+    actor_id: string;
+    /** Current code-point cursor, or null. */
+    cursor?: ArtifactEditingCursor | null | undefined;
+    /** Server-derived collaborator display metadata. */
+    meta: Record<string, unknown>;
+}
+/** Runtime validator for {@link ArtifactEditingActor}. */
+export declare const artifactEditingActorSchema: z.ZodObject<{
+    /** Opaque identity unique to this channel join. */
+    actor_id: z.ZodString;
+    /** Current code-point cursor, or null. */
+    cursor: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        /** Zero-based Unicode code-point position. */
+        position: z.ZodNumber;
+        /** Zero-based Unicode code-point selection endpoint. */
+        selection_end: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        position: number;
+        selection_end?: number | undefined;
+    }, {
+        position: number;
+        selection_end?: number | undefined;
+    }>>>;
+    /** Server-derived collaborator display metadata. */
+    meta: z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>;
+}, "strip", z.ZodTypeAny, {
+    actor_id: string;
+    meta: Record<string, {} | null>;
+    cursor?: {
+        position: number;
+        selection_end?: number | undefined;
+    } | null | undefined;
+}, {
+    actor_id: string;
+    meta: Record<string, {} | null>;
+    cursor?: {
+        position: number;
+        selection_end?: number | undefined;
+    } | null | undefined;
+}>;
+/** Confirms the exact live revision that reached durable ArtifactVersion storage. */
+export interface ArtifactEditingCheckpointResponse {
+    /** New durable ArtifactVersion ID. */
+    artifact_version: string;
+    artifact_version_number: number;
+    checkpointed_revision: number;
+    /** True when later live operations remain unsaved. */
+    dirty: boolean;
+    incarnation: string;
+}
+/** Runtime validator for {@link ArtifactEditingCheckpointResponse}. */
+export declare const artifactEditingCheckpointResponseSchema: z.ZodObject<{
+    /** New durable ArtifactVersion ID. */
+    artifact_version: z.ZodString;
+    artifact_version_number: z.ZodNumber;
+    checkpointed_revision: z.ZodNumber;
+    /** True when later live operations remain unsaved. */
+    dirty: z.ZodBoolean;
+    incarnation: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    dirty: boolean;
+    artifact_version: string;
+    artifact_version_number: number;
+    checkpointed_revision: number;
+    incarnation: string;
+}, {
+    dirty: boolean;
+    artifact_version: string;
+    artifact_version_number: number;
+    checkpointed_revision: number;
+    incarnation: string;
+}>;
+/** Authoritative live Artifact snapshot returned by an editing-channel join. */
+export interface ArtifactEditingJoinResponse {
+    /** Server-issued identity for this channel join. */
+    actor_id: string;
+    actors: ArtifactEditingActor[];
+    /** Public Artifact ID (`art_...`). */
+    artifact: string;
+    /** Durable version ID (`artv_...`). */
+    artifact_version: string;
+    artifact_version_number: number;
+    can_write: boolean;
+    /** Last durable-save failure reason, or null. */
+    checkpoint_error?: string | null | undefined;
+    /** Latest revision known durable. */
+    checkpointed_revision: number;
+    /** Server-issued connection identity. */
+    connection_id: string;
+    /** UTF-8 document content. */
+    content: string;
+    /** True while a live tail remains crash-loss exposed. */
+    dirty: boolean;
+    /** Opaque live-session fence token. */
+    incarnation: string;
+    /** Live OT revision in Unicode code points. */
+    revision: number;
+}
+/** Runtime validator for {@link ArtifactEditingJoinResponse}. */
+export declare const artifactEditingJoinResponseSchema: z.ZodObject<{
+    /** Server-issued identity for this channel join. */
+    actor_id: z.ZodString;
+    actors: z.ZodArray<z.ZodObject<{
+        /** Opaque identity unique to this channel join. */
+        actor_id: z.ZodString;
+        /** Current code-point cursor, or null. */
+        cursor: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            /** Zero-based Unicode code-point position. */
+            position: z.ZodNumber;
+            /** Zero-based Unicode code-point selection endpoint. */
+            selection_end: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            position: number;
+            selection_end?: number | undefined;
+        }, {
+            position: number;
+            selection_end?: number | undefined;
+        }>>>;
+        /** Server-derived collaborator display metadata. */
+        meta: z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>;
+    }, "strip", z.ZodTypeAny, {
+        actor_id: string;
+        meta: Record<string, {} | null>;
+        cursor?: {
+            position: number;
+            selection_end?: number | undefined;
+        } | null | undefined;
+    }, {
+        actor_id: string;
+        meta: Record<string, {} | null>;
+        cursor?: {
+            position: number;
+            selection_end?: number | undefined;
+        } | null | undefined;
+    }>, "many">;
+    /** Public Artifact ID (`art_...`). */
+    artifact: z.ZodString;
+    /** Durable version ID (`artv_...`). */
+    artifact_version: z.ZodString;
+    artifact_version_number: z.ZodNumber;
+    can_write: z.ZodBoolean;
+    /** Last durable-save failure reason, or null. */
+    checkpoint_error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** Latest revision known durable. */
+    checkpointed_revision: z.ZodNumber;
+    /** Server-issued connection identity. */
+    connection_id: z.ZodString;
+    /** UTF-8 document content. */
+    content: z.ZodString;
+    /** True while a live tail remains crash-loss exposed. */
+    dirty: z.ZodBoolean;
+    /** Opaque live-session fence token. */
+    incarnation: z.ZodString;
+    /** Live OT revision in Unicode code points. */
+    revision: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    content: string;
+    dirty: boolean;
+    actors: {
+        actor_id: string;
+        meta: Record<string, {} | null>;
+        cursor?: {
+            position: number;
+            selection_end?: number | undefined;
+        } | null | undefined;
+    }[];
+    connection_id: string;
+    actor_id: string;
+    artifact_version: string;
+    artifact_version_number: number;
+    checkpointed_revision: number;
+    incarnation: string;
+    artifact: string;
+    can_write: boolean;
+    revision: number;
+    checkpoint_error?: string | null | undefined;
+}, {
+    content: string;
+    dirty: boolean;
+    actors: {
+        actor_id: string;
+        meta: Record<string, {} | null>;
+        cursor?: {
+            position: number;
+            selection_end?: number | undefined;
+        } | null | undefined;
+    }[];
+    connection_id: string;
+    actor_id: string;
+    artifact_version: string;
+    artifact_version_number: number;
+    checkpointed_revision: number;
+    incarnation: string;
+    artifact: string;
+    can_write: boolean;
+    revision: number;
+    checkpoint_error?: string | null | undefined;
+}>;
+/** Acknowledges an operation only after the authoritative OT server applied it. */
+export interface ArtifactEditingOperationAck {
+    /** Authoritative live revision after application. */
+    revision: number;
+}
+/** Runtime validator for {@link ArtifactEditingOperationAck}. */
+export declare const artifactEditingOperationAckSchema: z.ZodObject<{
+    /** Authoritative live revision after application. */
+    revision: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    revision: number;
+}, {
+    revision: number;
+}>;
 //# 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;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,qJAAqJ;IACrJ,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACtC,+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,2GAA2G;IAC3G,MAAM,CAAC,EAAE,OAAO,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,qJAAqJ;;IAErJ,+BAA+B;;IAE/B,wJAAwJ;;;;;;;;;;;;;;;;;;;;;;;;;;IAExJ,mFAAmF;;IAEnF,mEAAmE;;IAEnE,yGAAyG;;IAEzG,2GAA2G;;IAE3G,qFAAqF;;IAErF,oGAAoG;;IAEpG,6DAA6D;;IAE7D,uFAAuF;;IAEvF,+FAA+F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEmD,CAAC"}
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../src/types/artifacts.ts"],"names":[],"mappings":"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"}

package/dist/types/artifacts.js

@@ -1,10 +1,13 @@
 // Copyright (c) 2026 ArchAstro Inc. Licensed under the MIT License.
 // This file is auto-generated by @archastro/sdk-generator. Do not edit.
-// Content hash: 0e1768d2cc71
+// Content hash: 6ae93195aa02
 import { z } from "zod";
+import { aclSchema } from "./common.js";
 import { imageSourceSchema } from "./image.js";
 /** Runtime validator for {@link Artifact}. */
 export const artifactSchema = z.object({
+    /** Access control list for the artifact. Contains a `grants` array where each entry specifies `principal_type`, `principal`, and `actions` (`read`, `write`). `null` when the artifact has no grants or the viewer is not its owner. */
+    acl: aclSchema.nullable().optional().describe("Access control list for the artifact. Contains a `grants` array where each entry specifies `principal_type`, `principal`, and `actions` (`read`, `write`). `null` when the artifact has no grants or the viewer is not its owner."),
     /** 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. */
@@ -46,4 +49,65 @@ export const artifactSchema = z.object({
     /** 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.");
+/** Runtime validator for {@link ArtifactEditingAck}. */
+export const artifactEditingAckSchema = z.object({
+    ok: z.boolean(),
+}).describe("Acknowledges an Artifact editing presence or leave request.");
+/** Runtime validator for {@link ArtifactEditingCursor}. */
+export const artifactEditingCursorSchema = z.object({
+    /** Zero-based Unicode code-point position. */
+    position: z.number().int().describe("Zero-based Unicode code-point position."),
+    /** Zero-based Unicode code-point selection endpoint. */
+    selection_end: z.number().int().optional().describe("Zero-based Unicode code-point selection endpoint."),
+}).describe("A Unicode code-point cursor and optional selection endpoint.");
+/** Runtime validator for {@link ArtifactEditingActor}. */
+export const artifactEditingActorSchema = z.object({
+    /** Opaque identity unique to this channel join. */
+    actor_id: z.string().describe("Opaque identity unique to this channel join."),
+    /** Current code-point cursor, or null. */
+    cursor: artifactEditingCursorSchema.nullable().optional().describe("Current code-point cursor, or null."),
+    /** Server-derived collaborator display metadata. */
+    meta: z.record(z.custom((value) => value !== undefined)).describe("Server-derived collaborator display metadata."),
+}).describe("A server-issued collaborator identity and its ephemeral presence.");
+/** Runtime validator for {@link ArtifactEditingCheckpointResponse}. */
+export const artifactEditingCheckpointResponseSchema = z.object({
+    /** New durable ArtifactVersion ID. */
+    artifact_version: z.string().describe("New durable ArtifactVersion ID."),
+    artifact_version_number: z.number().int(),
+    checkpointed_revision: z.number().int(),
+    /** True when later live operations remain unsaved. */
+    dirty: z.boolean().describe("True when later live operations remain unsaved."),
+    incarnation: z.string(),
+}).describe("Confirms the exact live revision that reached durable ArtifactVersion storage.");
+/** Runtime validator for {@link ArtifactEditingJoinResponse}. */
+export const artifactEditingJoinResponseSchema = z.object({
+    /** Server-issued identity for this channel join. */
+    actor_id: z.string().describe("Server-issued identity for this channel join."),
+    actors: z.array(artifactEditingActorSchema),
+    /** Public Artifact ID (`art_...`). */
+    artifact: z.string().describe("Public Artifact ID (`art_...`)."),
+    /** Durable version ID (`artv_...`). */
+    artifact_version: z.string().describe("Durable version ID (`artv_...`)."),
+    artifact_version_number: z.number().int(),
+    can_write: z.boolean(),
+    /** Last durable-save failure reason, or null. */
+    checkpoint_error: z.string().nullable().optional().describe("Last durable-save failure reason, or null."),
+    /** Latest revision known durable. */
+    checkpointed_revision: z.number().int().describe("Latest revision known durable."),
+    /** Server-issued connection identity. */
+    connection_id: z.string().describe("Server-issued connection identity."),
+    /** UTF-8 document content. */
+    content: z.string().describe("UTF-8 document content."),
+    /** True while a live tail remains crash-loss exposed. */
+    dirty: z.boolean().describe("True while a live tail remains crash-loss exposed."),
+    /** Opaque live-session fence token. */
+    incarnation: z.string().describe("Opaque live-session fence token."),
+    /** Live OT revision in Unicode code points. */
+    revision: z.number().int().describe("Live OT revision in Unicode code points."),
+}).describe("Authoritative live Artifact snapshot returned by an editing-channel join.");
+/** Runtime validator for {@link ArtifactEditingOperationAck}. */
+export const artifactEditingOperationAckSchema = z.object({
+    /** Authoritative live revision after application. */
+    revision: z.number().int().describe("Authoritative live revision after application."),
+}).describe("Acknowledges an operation only after the authoritative OT server applied it.");
 //# 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":"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"}
+{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../../src/types/artifacts.ts"],"names":[],"mappings":"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"}

package/dist/types/automations.d.ts

@@ -59,24 +59,24 @@ export interface AutomationRun {
     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;
+    /** Event or invocation identifier for this run. Direct invocations use the supplied idempotency key or a generated UUID. `null` when no event identifier was recorded. */
+    event_id?: string | null | undefined;
     /** Automation run ID (`atr_...`). */
     id: string;
     /** Invoke-time map of symbolic participant references to agent IDs. `null` when no participants were supplied. */
-    participants?: Record<string, unknown> | undefined;
+    participants?: Record<string, unknown> | null | undefined;
     /** 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;
+    result?: Record<string, unknown> | null | 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;
+    team?: string | null | 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;
+    user?: string | null | undefined;
 }
 /** Runtime validator for {@link AutomationRun}. */
 export declare const automationRunSchema: z.ZodObject<{
@@ -86,49 +86,49 @@ export declare const automationRunSchema: z.ZodObject<{
     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>;
+    /** Event or invocation identifier for this run. Direct invocations use the supplied idempotency key or a generated UUID. `null` when no event identifier was recorded. */
+    event_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     /** Automation run ID (`atr_...`). */
     id: z.ZodString;
     /** Invoke-time map of symbolic participant references to agent IDs. `null` when no participants were supplied. */
-    participants: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>>;
+    participants: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>>>;
     /** 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.ZodType<{} | null, z.ZodTypeDef, {} | null>>>;
     /** 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.ZodType<{} | null, z.ZodTypeDef, {} | null>>>;
+    result: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>>>;
     /** 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>;
+    team: z.ZodOptional<z.ZodNullable<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>;
+    user: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
     automation: string;
     status: string;
     app: string;
     id: string;
-    user?: string | undefined;
-    team?: string | undefined;
-    participants?: Record<string, {} | null> | undefined;
+    user?: string | null | undefined;
+    team?: string | null | undefined;
+    participants?: Record<string, {} | null> | null | undefined;
     payload?: Record<string, {} | null> | undefined;
     created_at?: string | undefined;
-    event_id?: string | undefined;
-    result?: Record<string, {} | null> | undefined;
+    event_id?: string | null | undefined;
+    result?: Record<string, {} | null> | null | undefined;
     updated_at?: string | undefined;
 }, {
     automation: string;
     status: string;
     app: string;
     id: string;
-    user?: string | undefined;
-    team?: string | undefined;
-    participants?: Record<string, {} | null> | undefined;
+    user?: string | null | undefined;
+    team?: string | null | undefined;
+    participants?: Record<string, {} | null> | null | undefined;
     payload?: Record<string, {} | null> | undefined;
     created_at?: string | undefined;
-    event_id?: string | undefined;
-    result?: Record<string, {} | null> | undefined;
+    event_id?: string | null | undefined;
+    result?: Record<string, {} | null> | null | undefined;
     updated_at?: string | undefined;
 }>;
 //# 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,4IAA4I;AAC5I,MAAM,WAAW,yBAAyB;IACxC,gGAAgG;IAChG,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACxC,4IAA4I;IAC5I,IAAI,EAAE,MAAM,CAAC;IACb,wGAAwG;IACxG,QAAQ,EAAE,OAAO,CAAC;IAClB,yIAAyI;IACzI,IAAI,EAAE,MAAM,CAAC;CACd;AAED,+DAA+D;AAC/D,eAAO,MAAM,+BAA+B;IAC1C,gGAAgG;;IAEhG,4IAA4I;;IAE5I,wGAAwG;;IAExG,yIAAyI;;;;;;;;;;;;EAEwD,CAAC;AAEpM,8EAA8E;AAC9E,MAAM,WAAW,kBAAkB;IACjC,mHAAmH;IACnH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACnD,0JAA0J;IAC1J,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAC/C;AAED,wDAAwD;AACxD,eAAO,MAAM,wBAAwB;IACnC,mHAAmH;;IAEnH,0JAA0J;;;;;;;;EAE9B,CAAC;AAE/H,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,kHAAkH;IAClH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACnD,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,kHAAkH;;IAElH,oJAAoJ;;IAEpJ,0KAA0K;;IAE1K,qPAAqP;;IAErP,8GAA8G;;IAE9G,kEAAkE;;IAElE,8GAA8G;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEqF,CAAC"}
+{"version":3,"file":"automations.d.ts","sourceRoot":"","sources":["../../src/types/automations.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,4IAA4I;AAC5I,MAAM,WAAW,yBAAyB;IACxC,gGAAgG;IAChG,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACxC,4IAA4I;IAC5I,IAAI,EAAE,MAAM,CAAC;IACb,wGAAwG;IACxG,QAAQ,EAAE,OAAO,CAAC;IAClB,yIAAyI;IACzI,IAAI,EAAE,MAAM,CAAC;CACd;AAED,+DAA+D;AAC/D,eAAO,MAAM,+BAA+B;IAC1C,gGAAgG;;IAEhG,4IAA4I;;IAE5I,wGAAwG;;IAExG,yIAAyI;;;;;;;;;;;;EAEwD,CAAC;AAEpM,8EAA8E;AAC9E,MAAM,WAAW,kBAAkB;IACjC,mHAAmH;IACnH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACnD,0JAA0J;IAC1J,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAC/C;AAED,wDAAwD;AACxD,eAAO,MAAM,wBAAwB;IACnC,mHAAmH;;IAEnH,0JAA0J;;;;;;;;EAE9B,CAAC;AAE/H,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,0KAA0K;IAC1K,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACrC,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,kHAAkH;IAClH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IAC1D,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,IAAI,GAAG,SAAS,CAAC;IACpD,qPAAqP;IACrP,MAAM,EAAE,MAAM,CAAC;IACf,8GAA8G;IAC9G,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACjC,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,8GAA8G;IAC9G,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CAClC;AAED,mDAAmD;AACnD,eAAO,MAAM,mBAAmB;IAC9B,+DAA+D;;IAE/D,0DAA0D;;IAE1D,sDAAsD;;IAEtD,0KAA0K;;IAE1K,qCAAqC;;IAErC,kHAAkH;;IAElH,oJAAoJ;;IAEpJ,0KAA0K;;IAE1K,qPAAqP;;IAErP,8GAA8G;;IAE9G,kEAAkE;;IAElE,8GAA8G;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEqF,CAAC"}

package/dist/types/automations.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: 3334c83f45c4
+// Content hash: 810d52f31fad
 import { z } from "zod";
 /** Runtime validator for {@link AutomationParticipantSlot}. */
 export const automationParticipantSlotSchema = z.object({
@@ -28,23 +28,23 @@ export const automationRunSchema = z.object({
     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."),
+    /** Event or invocation identifier for this run. Direct invocations use the supplied idempotency key or a generated UUID. `null` when no event identifier was recorded. */
+    event_id: z.string().nullable().optional().describe("Event or invocation identifier for this run. Direct invocations use the supplied idempotency key or a generated UUID. `null` when no event identifier was recorded."),
     /** Automation run ID (`atr_...`). */
     id: z.string().describe("Automation run ID (`atr_...`)."),
     /** Invoke-time map of symbolic participant references to agent IDs. `null` when no participants were supplied. */
-    participants: z.record(z.custom((value) => value !== undefined)).optional().describe("Invoke-time map of symbolic participant references to agent IDs. `null` when no participants were supplied."),
+    participants: z.record(z.custom((value) => value !== undefined)).nullable().optional().describe("Invoke-time map of symbolic participant references to agent IDs. `null` when no participants were supplied."),
     /** 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.custom((value) => value !== undefined)).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.custom((value) => value !== undefined)).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."),
+    result: z.record(z.custom((value) => value !== undefined)).nullable().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."),
+    team: z.string().nullable().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."),
+    user: z.string().nullable().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