@atom-workflow-agent/contracts 0.1.0

package/dist/atoms/host.d.ts

@@ -0,0 +1,200 @@
+import { z } from "zod";
+export declare const HostContinuationSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0">;
+    token: z.ZodString;
+    nonce: z.ZodString;
+    runId: z.ZodString;
+    workflowRevisionId: z.ZodString;
+    nodeId: z.ZodString;
+    activationId: z.ZodString;
+    attemptId: z.ZodString;
+    hostTaskId: z.ZodString;
+    workflowIrHash: z.ZodString;
+    outputSchemaHash: z.ZodString;
+    projectScope: z.ZodString;
+    hostScope: z.ZodString;
+    createdAt: z.ZodString;
+    expiresAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type HostContinuation = z.infer<typeof HostContinuationSchema>;
+export declare const HostTaskRequestSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0">;
+    hostTaskId: z.ZodString;
+    atom: z.ZodObject<{
+        id: z.ZodString;
+        version: z.ZodString;
+    }, z.core.$strict>;
+    runId: z.ZodString;
+    workflowRevisionId: z.ZodString;
+    nodeId: z.ZodString;
+    activationId: z.ZodString;
+    attemptId: z.ZodString;
+    instruction: z.ZodString;
+    input: z.ZodType<import("./manifest.js").JsonValue, unknown, z.core.$ZodTypeInternals<import("./manifest.js").JsonValue, unknown>>;
+    context: z.ZodType<import("./manifest.js").JsonValue, unknown, z.core.$ZodTypeInternals<import("./manifest.js").JsonValue, unknown>>;
+    artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodString;
+        hash: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    expected: z.ZodObject<{
+        outputSchema: z.ZodRecord<z.ZodString, z.ZodType<import("./manifest.js").JsonValue, unknown, z.core.$ZodTypeInternals<import("./manifest.js").JsonValue, unknown>>>;
+    }, z.core.$strict>;
+    projectScope: z.ZodString;
+    hostScope: z.ZodString;
+    resume: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<"1.0">;
+        runId: z.ZodString;
+        instruction: z.ZodString;
+        command: z.ZodLiteral<"resume-host">;
+        hostTaskId: z.ZodString;
+    }, z.core.$strict>;
+    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<import("./manifest.js").JsonValue, unknown, z.core.$ZodTypeInternals<import("./manifest.js").JsonValue, unknown>>>>;
+    continuation: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<"1.0">;
+        token: z.ZodString;
+        nonce: z.ZodString;
+        runId: z.ZodString;
+        workflowRevisionId: z.ZodString;
+        nodeId: z.ZodString;
+        activationId: z.ZodString;
+        attemptId: z.ZodString;
+        hostTaskId: z.ZodString;
+        workflowIrHash: z.ZodString;
+        outputSchemaHash: z.ZodString;
+        projectScope: z.ZodString;
+        hostScope: z.ZodString;
+        createdAt: z.ZodString;
+        expiresAt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type HostTaskRequest = z.infer<typeof HostTaskRequestSchema>;
+export declare const HostTaskResultSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0">;
+    output: z.ZodType<import("./manifest.js").JsonValue, unknown, z.core.$ZodTypeInternals<import("./manifest.js").JsonValue, unknown>>;
+    artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodString;
+        hash: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    summary: z.ZodString;
+}, z.core.$strict>;
+export type HostTaskResult = z.infer<typeof HostTaskResultSchema>;
+export declare const HostTaskResumeRequestSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0">;
+    hostTaskId: z.ZodString;
+    continuationToken: z.ZodString;
+    projectScope: z.ZodString;
+    hostScope: z.ZodString;
+    result: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<"1.0">;
+        output: z.ZodType<import("./manifest.js").JsonValue, unknown, z.core.$ZodTypeInternals<import("./manifest.js").JsonValue, unknown>>;
+        artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodString;
+            hash: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        summary: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type HostTaskResumeRequest = z.infer<typeof HostTaskResumeRequestSchema>;
+export declare const HostTaskStatusSchema: z.ZodEnum<{
+    cancelled: "cancelled";
+    waiting: "waiting";
+    consumed: "consumed";
+    expired: "expired";
+}>;
+export type HostTaskStatus = z.infer<typeof HostTaskStatusSchema>;
+export declare const HostTaskRecordSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0">;
+    request: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<"1.0">;
+        hostTaskId: z.ZodString;
+        atom: z.ZodObject<{
+            id: z.ZodString;
+            version: z.ZodString;
+        }, z.core.$strict>;
+        runId: z.ZodString;
+        workflowRevisionId: z.ZodString;
+        nodeId: z.ZodString;
+        activationId: z.ZodString;
+        attemptId: z.ZodString;
+        instruction: z.ZodString;
+        input: z.ZodType<import("./manifest.js").JsonValue, unknown, z.core.$ZodTypeInternals<import("./manifest.js").JsonValue, unknown>>;
+        context: z.ZodType<import("./manifest.js").JsonValue, unknown, z.core.$ZodTypeInternals<import("./manifest.js").JsonValue, unknown>>;
+        artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodString;
+            hash: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        expected: z.ZodObject<{
+            outputSchema: z.ZodRecord<z.ZodString, z.ZodType<import("./manifest.js").JsonValue, unknown, z.core.$ZodTypeInternals<import("./manifest.js").JsonValue, unknown>>>;
+        }, z.core.$strict>;
+        projectScope: z.ZodString;
+        hostScope: z.ZodString;
+        resume: z.ZodObject<{
+            schemaVersion: z.ZodLiteral<"1.0">;
+            runId: z.ZodString;
+            instruction: z.ZodString;
+            command: z.ZodLiteral<"resume-host">;
+            hostTaskId: z.ZodString;
+        }, z.core.$strict>;
+        metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<import("./manifest.js").JsonValue, unknown, z.core.$ZodTypeInternals<import("./manifest.js").JsonValue, unknown>>>>;
+        continuation: z.ZodObject<{
+            schemaVersion: z.ZodLiteral<"1.0">;
+            token: z.ZodString;
+            nonce: z.ZodString;
+            runId: z.ZodString;
+            workflowRevisionId: z.ZodString;
+            nodeId: z.ZodString;
+            activationId: z.ZodString;
+            attemptId: z.ZodString;
+            hostTaskId: z.ZodString;
+            workflowIrHash: z.ZodString;
+            outputSchemaHash: z.ZodString;
+            projectScope: z.ZodString;
+            hostScope: z.ZodString;
+            createdAt: z.ZodString;
+            expiresAt: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    declaration: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<"1.0">;
+        instruction: z.ZodString;
+        context: z.ZodDefault<z.ZodType<import("./manifest.js").JsonValue, unknown, z.core.$ZodTypeInternals<import("./manifest.js").JsonValue, unknown>>>;
+        artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodString;
+            hash: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        responseSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<import("./manifest.js").JsonValue, unknown, z.core.$ZodTypeInternals<import("./manifest.js").JsonValue, unknown>>>>;
+        requireSameProject: z.ZodDefault<z.ZodLiteral<true>>;
+        expiresInMs: z.ZodOptional<z.ZodNumber>;
+        metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<import("./manifest.js").JsonValue, unknown, z.core.$ZodTypeInternals<import("./manifest.js").JsonValue, unknown>>>>;
+    }, z.core.$strict>;
+    status: z.ZodEnum<{
+        cancelled: "cancelled";
+        waiting: "waiting";
+        consumed: "consumed";
+        expired: "expired";
+    }>;
+    consumedAt: z.ZodOptional<z.ZodString>;
+    cancelledAt: z.ZodOptional<z.ZodString>;
+    result: z.ZodOptional<z.ZodObject<{
+        schemaVersion: z.ZodLiteral<"1.0">;
+        output: z.ZodType<import("./manifest.js").JsonValue, unknown, z.core.$ZodTypeInternals<import("./manifest.js").JsonValue, unknown>>;
+        artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodString;
+            hash: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        summary: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type HostTaskRecord = z.infer<typeof HostTaskRecordSchema>;
+export declare const HostTaskArtifactListSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodString;
+    hash: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>>;
+//# sourceMappingURL=host.d.ts.map

package/dist/atoms/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/atoms/host.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgBxB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;kBAoBjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAyChC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,oBAAoB;;;;;;;;;kBAKtB,CAAC;AACZ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;kBAO7B,CAAC;AACZ,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,oBAAoB;;;;;EAA0D,CAAC;AAC5F,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAqB/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,0BAA0B;;;;mBAAuC,CAAC"}

package/dist/atoms/host.js

@@ -0,0 +1,109 @@
+import { z } from "zod";
+import { AtomArtifactReferenceSchema, AtomHostTaskDeclarationSchema, } from "./lifecycle.js";
+import { JsonSchemaSchema, JsonValueSchema, SemanticVersionSchema, AtomIdSchema, } from "./manifest.js";
+import { HostResumeDirectiveSchema } from "../runtime/resume.js";
+const HashSchema = z.string().regex(/^sha256:[a-f0-9]{64}$/);
+const TimestampSchema = z.string().datetime({ offset: true });
+export const HostContinuationSchema = z.object({
+    schemaVersion: z.literal("1.0"),
+    token: z.string().regex(/^[A-Za-z0-9_-]{32,}$/),
+    nonce: z.string().regex(/^[A-Za-z0-9_-]{16,}$/),
+    runId: z.string().trim().min(1),
+    workflowRevisionId: z.string().trim().min(1),
+    nodeId: z.string().trim().min(1),
+    activationId: z.string().trim().min(1),
+    attemptId: z.string().trim().min(1),
+    hostTaskId: z.string().trim().min(1),
+    workflowIrHash: HashSchema,
+    outputSchemaHash: HashSchema,
+    projectScope: z.string().trim().min(1),
+    hostScope: z.string().trim().min(1),
+    createdAt: TimestampSchema,
+    expiresAt: TimestampSchema.optional(),
+}).strict().superRefine((continuation, context) => {
+    if (continuation.expiresAt && Date.parse(continuation.expiresAt) <= Date.parse(continuation.createdAt)) {
+        context.addIssue({ code: "custom", path: ["expiresAt"], message: "Continuation expiry must be after creation" });
+    }
+});
+export const HostTaskRequestSchema = z.object({
+    schemaVersion: z.literal("1.0"),
+    hostTaskId: z.string().trim().min(1),
+    atom: z.object({ id: AtomIdSchema, version: SemanticVersionSchema }).strict(),
+    runId: z.string().trim().min(1),
+    workflowRevisionId: z.string().trim().min(1),
+    nodeId: z.string().trim().min(1),
+    activationId: z.string().trim().min(1),
+    attemptId: z.string().trim().min(1),
+    instruction: z.string().trim().min(1),
+    input: JsonValueSchema,
+    context: JsonValueSchema,
+    artifacts: z.array(AtomArtifactReferenceSchema).default([]),
+    expected: z.object({
+        outputSchema: JsonSchemaSchema,
+    }).strict(),
+    projectScope: z.string().trim().min(1),
+    hostScope: z.string().trim().min(1),
+    resume: HostResumeDirectiveSchema,
+    metadata: z.record(z.string(), JsonValueSchema).default({}),
+    continuation: HostContinuationSchema,
+}).strict().superRefine((request, context) => {
+    const bindings = [
+        ["hostTaskId", request.hostTaskId, request.continuation.hostTaskId],
+        ["runId", request.runId, request.continuation.runId],
+        ["workflowRevisionId", request.workflowRevisionId, request.continuation.workflowRevisionId],
+        ["nodeId", request.nodeId, request.continuation.nodeId],
+        ["activationId", request.activationId, request.continuation.activationId],
+        ["attemptId", request.attemptId, request.continuation.attemptId],
+        ["projectScope", request.projectScope, request.continuation.projectScope],
+        ["hostScope", request.hostScope, request.continuation.hostScope],
+    ];
+    for (const [field, outer, bound] of bindings) {
+        if (outer !== bound)
+            context.addIssue({ code: "custom", path: ["continuation", field], message: `${field} does not match its Continuation binding` });
+    }
+    if (request.resume.runId !== request.runId) {
+        context.addIssue({ code: "custom", path: ["resume", "runId"], message: "resume.runId does not match the HostTask runId" });
+    }
+    if (request.resume.hostTaskId !== request.hostTaskId) {
+        context.addIssue({ code: "custom", path: ["resume", "hostTaskId"], message: "resume.hostTaskId does not match the HostTask id" });
+    }
+});
+export const HostTaskResultSchema = z.object({
+    schemaVersion: z.literal("1.0"),
+    output: JsonValueSchema,
+    artifacts: z.array(AtomArtifactReferenceSchema).default([]),
+    summary: z.string().trim().min(1),
+}).strict();
+export const HostTaskResumeRequestSchema = z.object({
+    schemaVersion: z.literal("1.0"),
+    hostTaskId: z.string().trim().min(1),
+    continuationToken: z.string().regex(/^[A-Za-z0-9_-]{32,}$/),
+    projectScope: z.string().trim().min(1),
+    hostScope: z.string().trim().min(1),
+    result: HostTaskResultSchema,
+}).strict();
+export const HostTaskStatusSchema = z.enum(["waiting", "consumed", "cancelled", "expired"]);
+export const HostTaskRecordSchema = z.object({
+    schemaVersion: z.literal("1.0"),
+    request: HostTaskRequestSchema,
+    declaration: AtomHostTaskDeclarationSchema,
+    status: HostTaskStatusSchema,
+    consumedAt: TimestampSchema.optional(),
+    cancelledAt: TimestampSchema.optional(),
+    result: HostTaskResultSchema.optional(),
+}).strict().superRefine((record, context) => {
+    if (record.status === "consumed" && (!record.consumedAt || !record.result)) {
+        context.addIssue({ code: "custom", path: ["status"], message: "Consumed HostTask requires consumedAt and result" });
+    }
+    if (record.status === "cancelled" && !record.cancelledAt) {
+        context.addIssue({ code: "custom", path: ["status"], message: "Cancelled HostTask requires cancelledAt" });
+    }
+    if (record.status !== "consumed" && (record.consumedAt || record.result)) {
+        context.addIssue({ code: "custom", path: ["status"], message: "Only a consumed HostTask may contain a result" });
+    }
+    if (record.status !== "cancelled" && record.cancelledAt) {
+        context.addIssue({ code: "custom", path: ["status"], message: "Only a cancelled HostTask may contain cancelledAt" });
+    }
+});
+export const HostTaskArtifactListSchema = z.array(AtomArtifactReferenceSchema);
+//# sourceMappingURL=host.js.map

package/dist/atoms/host.js.map

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

package/dist/atoms/lifecycle.d.ts

@@ -0,0 +1,257 @@
+import { z } from "zod";
+import { type AtomManifest, type JsonValue } from "./manifest.js";
+export declare const AtomInstanceStateSchema: z.ZodEnum<{
+    enabled: "enabled";
+    discovered: "discovered";
+    loading: "loading";
+    validated: "validated";
+    registered: "registered";
+    draining: "draining";
+    disposed: "disposed";
+}>;
+export type AtomInstanceState = z.infer<typeof AtomInstanceStateSchema>;
+export declare const AtomAttemptStateSchema: z.ZodEnum<{
+    created: "created";
+    running: "running";
+    awaiting_signal: "awaiting_signal";
+    awaiting_host: "awaiting_host";
+    succeeded: "succeeded";
+    failed: "failed";
+    cancelled: "cancelled";
+    interrupted: "interrupted";
+    unknown_outcome: "unknown_outcome";
+}>;
+export type AtomAttemptState = z.infer<typeof AtomAttemptStateSchema>;
+export declare const AtomArtifactReferenceSchema: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodString;
+    hash: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type AtomArtifactReference = z.infer<typeof AtomArtifactReferenceSchema>;
+export declare const AtomSignalRequestSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0">;
+    key: z.ZodString;
+    prompt: z.ZodString;
+    context: z.ZodDefault<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+    responseSchema: z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+    expiresInMs: z.ZodOptional<z.ZodNumber>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>>;
+}, z.core.$strict>;
+export type AtomSignalRequest = z.infer<typeof AtomSignalRequestSchema>;
+export declare const AtomSignalResumeSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0">;
+    kind: z.ZodLiteral<"signal">;
+    signalId: z.ZodString;
+    key: z.ZodString;
+    response: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
+}, z.core.$strict>;
+export type AtomSignalResume = z.infer<typeof AtomSignalResumeSchema>;
+export declare const AtomHostTaskDeclarationSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0">;
+    instruction: z.ZodString;
+    context: z.ZodDefault<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+    artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodString;
+        hash: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    responseSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>>;
+    requireSameProject: z.ZodDefault<z.ZodLiteral<true>>;
+    expiresInMs: z.ZodOptional<z.ZodNumber>;
+    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>>;
+}, z.core.$strict>;
+export type AtomHostTaskDeclaration = z.infer<typeof AtomHostTaskDeclarationSchema>;
+export declare const AtomHostCompletionSchema: z.ZodObject<{
+    output: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
+    artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodString;
+        hash: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    summary: z.ZodString;
+}, z.core.$strict>;
+export type AtomHostCompletion = z.infer<typeof AtomHostCompletionSchema>;
+export declare const AtomHostResumeSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0">;
+    kind: z.ZodLiteral<"host">;
+    hostTaskId: z.ZodString;
+    continuationToken: z.ZodString;
+    result: z.ZodObject<{
+        output: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
+        artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodString;
+            hash: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        summary: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type AtomHostResume = z.infer<typeof AtomHostResumeSchema>;
+export declare const AtomResumeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0">;
+    kind: z.ZodLiteral<"signal">;
+    signalId: z.ZodString;
+    key: z.ZodString;
+    response: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
+}, z.core.$strict>, z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0">;
+    kind: z.ZodLiteral<"host">;
+    hostTaskId: z.ZodString;
+    continuationToken: z.ZodString;
+    result: z.ZodObject<{
+        output: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
+        artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodString;
+            hash: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        summary: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>], "kind">;
+export type AtomResume = z.infer<typeof AtomResumeSchema>;
+export declare const MAX_LIFECYCLE_POLL_DELAY_MS = 86400000;
+export declare const AtomRunningResultSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0">;
+    status: z.ZodLiteral<"running">;
+    checkpoint: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
+    nextPollAfterMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export interface AtomRunningResult<TCheckpoint = JsonValue> {
+    readonly schemaVersion: "1.0";
+    readonly status: "running";
+    readonly checkpoint: TCheckpoint;
+    readonly nextPollAfterMs?: number | undefined;
+}
+export declare const AtomAwaitingSignalResultSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0">;
+    status: z.ZodLiteral<"awaiting_signal">;
+    checkpoint: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
+    signal: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<"1.0">;
+        key: z.ZodString;
+        prompt: z.ZodString;
+        context: z.ZodDefault<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+        responseSchema: z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+        expiresInMs: z.ZodOptional<z.ZodNumber>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export interface AtomAwaitingSignalResult<TCheckpoint = JsonValue> {
+    readonly schemaVersion: "1.0";
+    readonly status: "awaiting_signal";
+    readonly checkpoint: TCheckpoint;
+    readonly signal: AtomSignalRequest;
+}
+export declare const AtomAwaitingHostResultSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0">;
+    status: z.ZodLiteral<"awaiting_host">;
+    checkpoint: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
+    task: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<"1.0">;
+        instruction: z.ZodString;
+        context: z.ZodDefault<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+        artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodString;
+            hash: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        responseSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>>;
+        requireSameProject: z.ZodDefault<z.ZodLiteral<true>>;
+        expiresInMs: z.ZodOptional<z.ZodNumber>;
+        metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export interface AtomAwaitingHostResult<TCheckpoint = JsonValue> {
+    readonly schemaVersion: "1.0";
+    readonly status: "awaiting_host";
+    readonly checkpoint: TCheckpoint;
+    readonly task: AtomHostTaskDeclaration;
+}
+export declare const AtomSucceededResultSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0">;
+    status: z.ZodLiteral<"succeeded">;
+    output: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
+    artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodString;
+        hash: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export interface AtomSucceededResult<TOutput = JsonValue> {
+    readonly schemaVersion: "1.0";
+    readonly status: "succeeded";
+    readonly output: TOutput;
+    readonly artifacts?: readonly AtomArtifactReference[];
+}
+export declare const AtomLifecycleResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0">;
+    status: z.ZodLiteral<"running">;
+    checkpoint: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
+    nextPollAfterMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>, z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0">;
+    status: z.ZodLiteral<"awaiting_signal">;
+    checkpoint: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
+    signal: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<"1.0">;
+        key: z.ZodString;
+        prompt: z.ZodString;
+        context: z.ZodDefault<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+        responseSchema: z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+        expiresInMs: z.ZodOptional<z.ZodNumber>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0">;
+    status: z.ZodLiteral<"awaiting_host">;
+    checkpoint: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
+    task: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<"1.0">;
+        instruction: z.ZodString;
+        context: z.ZodDefault<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+        artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodString;
+            hash: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        responseSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>>;
+        requireSameProject: z.ZodDefault<z.ZodLiteral<true>>;
+        expiresInMs: z.ZodOptional<z.ZodNumber>;
+        metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0">;
+    status: z.ZodLiteral<"succeeded">;
+    output: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
+    artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodString;
+        hash: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>], "status">;
+export type AtomLifecycleResult<TCheckpoint = JsonValue, TOutput = JsonValue> = AtomRunningResult<TCheckpoint> | AtomAwaitingSignalResult<TCheckpoint> | AtomAwaitingHostResult<TCheckpoint> | AtomSucceededResult<TOutput>;
+export declare const AtomLifecycleValidationErrorCodeSchema: z.ZodEnum<{
+    ATOM_LIFECYCLE_RESULT_INVALID: "ATOM_LIFECYCLE_RESULT_INVALID";
+    ATOM_OUTPUT_SCHEMA_MISMATCH: "ATOM_OUTPUT_SCHEMA_MISMATCH";
+    ATOM_SIGNAL_RESUME_INVALID: "ATOM_SIGNAL_RESUME_INVALID";
+    ATOM_SIGNAL_RESPONSE_SCHEMA_MISMATCH: "ATOM_SIGNAL_RESPONSE_SCHEMA_MISMATCH";
+    ATOM_HOST_RESUME_INVALID: "ATOM_HOST_RESUME_INVALID";
+    ATOM_HOST_RESULT_SCHEMA_MISMATCH: "ATOM_HOST_RESULT_SCHEMA_MISMATCH";
+}>;
+export type AtomLifecycleValidationErrorCode = z.infer<typeof AtomLifecycleValidationErrorCodeSchema>;
+export interface AtomLifecycleValidationError {
+    readonly code: AtomLifecycleValidationErrorCode;
+    readonly path: string;
+    readonly message: string;
+}
+export type AtomLifecycleValidationResult<T> = {
+    readonly success: true;
+    readonly data: T;
+} | {
+    readonly success: false;
+    readonly errors: readonly AtomLifecycleValidationError[];
+};
+export declare function validateAtomLifecycleResult(manifest: AtomManifest, raw: unknown): AtomLifecycleValidationResult<AtomLifecycleResult<JsonValue, JsonValue>>;
+export declare function validateAtomSignalResume(request: AtomSignalRequest, raw: unknown): AtomLifecycleValidationResult<AtomSignalResume>;
+export declare function validateAtomHostResume(manifest: AtomManifest, hostTaskId: string, continuationToken: string, raw: unknown, responseSchema?: Record<string, JsonValue>): AtomLifecycleValidationResult<AtomHostResume>;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/atoms/lifecycle.d.ts.map

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