@archastro/sdk 0.7.0 → 0.8.0

package/dist/types/automations.d.ts

@@ -1,4 +1,56 @@
 import { z } from "zod";
+/** A named participant slot declared by an automation's workflow. Embedded stages hand work to the agent the invoker names for the slot. */
+export interface AutomationParticipantSlot {
+    /** Workflow-authored explanation of the slot's role. `null` when the workflow declares none. */
+    description?: string | undefined;
+    /** The slot's name, as referenced by the workflow. Supply the chosen agent under the top-level `participants[name]` field when invoking. */
+    name: string;
+    /** Whether the workflow requires this slot to be filled for the run to complete its embedded stages. */
+    required: boolean;
+    /** The kind of principal the slot accepts. Currently always `"agent_user"` — the value supplied at invoke is an agent ID (`agi_...`). */
+    type: string;
+}
+/** Runtime validator for {@link AutomationParticipantSlot}. */
+export declare const automationParticipantSlotSchema: z.ZodObject<{
+    /** Workflow-authored explanation of the slot's role. `null` when the workflow declares none. */
+    description: z.ZodOptional<z.ZodString>;
+    /** The slot's name, as referenced by the workflow. Supply the chosen agent under the top-level `participants[name]` field when invoking. */
+    name: z.ZodString;
+    /** Whether the workflow requires this slot to be filled for the run to complete its embedded stages. */
+    required: z.ZodBoolean;
+    /** The kind of principal the slot accepts. Currently always `"agent_user"` — the value supplied at invoke is an agent ID (`agi_...`). */
+    type: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    required: boolean;
+    type: string;
+    description?: string | undefined;
+}, {
+    name: string;
+    required: boolean;
+    type: string;
+    description?: string | undefined;
+}>;
+/** Locked payload and participant values supplied by the automation owner. */
+export interface AutomationPrefills {
+    /** Participant slot-to-agent mappings applied by the platform. Caller values at these slots must match exactly. */
+    participants?: Record<string, unknown> | undefined;
+    /** Partial invocation payload applied by the platform. A caller may omit these values, but supplying a different value at any locked path is rejected. */
+    payload?: Record<string, unknown> | undefined;
+}
+/** Runtime validator for {@link AutomationPrefills}. */
+export declare const automationPrefillsSchema: z.ZodObject<{
+    /** Participant slot-to-agent mappings applied by the platform. Caller values at these slots must match exactly. */
+    participants: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    /** Partial invocation payload applied by the platform. A caller may omit these values, but supplying a different value at any locked path is rejected. */
+    payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    participants?: Record<string, unknown> | undefined;
+    payload?: Record<string, unknown> | undefined;
+}, {
+    participants?: Record<string, unknown> | undefined;
+    payload?: Record<string, unknown> | undefined;
+}>;
 /** 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_...`). */
@@ -11,6 +63,8 @@ export interface AutomationRun {
     event_id?: string | 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;
     /** 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. */
@@ -36,6 +90,8 @@ export declare const automationRunSchema: z.ZodObject<{
     event_id: z.ZodOptional<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.ZodUnknown>>;
     /** 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. */
@@ -49,28 +105,30 @@ export declare const automationRunSchema: z.ZodObject<{
     /** 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, {
+    automation: string;
     status: string;
-    id: string;
     app: string;
-    automation: string;
+    id: string;
     team?: string | undefined;
-    created_at?: string | undefined;
-    updated_at?: string | undefined;
-    user?: string | undefined;
+    participants?: Record<string, unknown> | undefined;
     payload?: Record<string, unknown> | undefined;
+    created_at?: string | undefined;
     event_id?: string | undefined;
     result?: Record<string, unknown> | undefined;
+    updated_at?: string | undefined;
+    user?: string | undefined;
 }, {
+    automation: string;
     status: string;
-    id: string;
     app: string;
-    automation: string;
+    id: string;
     team?: string | undefined;
-    created_at?: string | undefined;
-    updated_at?: string | undefined;
-    user?: string | undefined;
+    participants?: Record<string, unknown> | undefined;
     payload?: Record<string, unknown> | undefined;
+    created_at?: string | undefined;
     event_id?: string | undefined;
     result?: Record<string, unknown> | undefined;
+    updated_at?: string | undefined;
+    user?: 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,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"}
+{"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,SAAS,CAAC;IACjC,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"}

package/dist/types/automations.js

@@ -1,7 +1,25 @@
-// Copyright (c) 2026 ArchAstro Inc. All Rights Reserved.
+// Copyright (c) 2026 ArchAstro Inc. Licensed under the MIT License.
 // This file is auto-generated by @archastro/sdk-generator. Do not edit.
-// Content hash: 6f9b2344ac6b
+// Content hash: 33374864aa9d
 import { z } from "zod";
+/** Runtime validator for {@link AutomationParticipantSlot}. */
+export const automationParticipantSlotSchema = z.object({
+    /** Workflow-authored explanation of the slot's role. `null` when the workflow declares none. */
+    description: z.string().optional().describe("Workflow-authored explanation of the slot's role. `null` when the workflow declares none."),
+    /** The slot's name, as referenced by the workflow. Supply the chosen agent under the top-level `participants[name]` field when invoking. */
+    name: z.string().describe("The slot's name, as referenced by the workflow. Supply the chosen agent under the top-level `participants[name]` field when invoking."),
+    /** Whether the workflow requires this slot to be filled for the run to complete its embedded stages. */
+    required: z.boolean().describe("Whether the workflow requires this slot to be filled for the run to complete its embedded stages."),
+    /** The kind of principal the slot accepts. Currently always `"agent_user"` — the value supplied at invoke is an agent ID (`agi_...`). */
+    type: z.string().describe("The kind of principal the slot accepts. Currently always `\"agent_user\"` — the value supplied at invoke is an agent ID (`agi_...`)."),
+}).describe("A named participant slot declared by an automation's workflow. Embedded stages hand work to the agent the invoker names for the slot.");
+/** Runtime validator for {@link AutomationPrefills}. */
+export const automationPrefillsSchema = z.object({
+    /** Participant slot-to-agent mappings applied by the platform. Caller values at these slots must match exactly. */
+    participants: z.record(z.unknown()).optional().describe("Participant slot-to-agent mappings applied by the platform. Caller values at these slots must match exactly."),
+    /** Partial invocation payload applied by the platform. A caller may omit these values, but supplying a different value at any locked path is rejected. */
+    payload: z.record(z.unknown()).optional().describe("Partial invocation payload applied by the platform. A caller may omit these values, but supplying a different value at any locked path is rejected."),
+}).describe("Locked payload and participant values supplied by the automation owner.");
 /** Runtime validator for {@link AutomationRun}. */
 export const automationRunSchema = z.object({
     /** ID of the app that owns this automation run (`dap_...`). */
@@ -14,6 +32,8 @@ export const automationRunSchema = z.object({
     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_...`)."),
+    /** Invoke-time map of symbolic participant references to agent IDs. `null` when no participants were supplied. */
+    participants: z.record(z.unknown()).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.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. */

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