@atom-workflow-agent/contracts 0.1.0

package/dist/atoms/lifecycle.js

@@ -0,0 +1,201 @@
+import { z } from "zod";
+import { JsonSchemaSchema, JsonValueSchema, } from "./manifest.js";
+import { validateJsonSchemaInstance } from "../json-schema/validate-instance.js";
+export const AtomInstanceStateSchema = z.enum([
+    "discovered",
+    "loading",
+    "validated",
+    "registered",
+    "enabled",
+    "draining",
+    "disposed",
+]);
+export const AtomAttemptStateSchema = z.enum([
+    "created",
+    "running",
+    "awaiting_signal",
+    "awaiting_host",
+    "succeeded",
+    "failed",
+    "cancelled",
+    "interrupted",
+    "unknown_outcome",
+]);
+export const AtomArtifactReferenceSchema = z.object({
+    id: z.string().trim().min(1),
+    kind: z.string().trim().min(1),
+    hash: z.string().trim().min(1).optional(),
+}).strict();
+export const AtomSignalRequestSchema = z.object({
+    schemaVersion: z.literal("1.0"),
+    key: z.string().regex(/^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$/),
+    prompt: z.string().trim().min(1),
+    context: JsonValueSchema.default({}),
+    responseSchema: JsonSchemaSchema,
+    expiresInMs: z.number().int().positive().max(31_536_000_000).optional(),
+    metadata: z.record(z.string(), JsonValueSchema).optional(),
+}).strict();
+export const AtomSignalResumeSchema = z.object({
+    schemaVersion: z.literal("1.0"),
+    kind: z.literal("signal"),
+    signalId: z.string().trim().min(1),
+    key: z.string().regex(/^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$/),
+    response: JsonValueSchema,
+}).strict();
+export const AtomHostTaskDeclarationSchema = z.object({
+    schemaVersion: z.literal("1.0"),
+    instruction: z.string().trim().min(1),
+    context: JsonValueSchema.default({}),
+    artifacts: z.array(AtomArtifactReferenceSchema).default([]),
+    responseSchema: JsonSchemaSchema.optional(),
+    requireSameProject: z.literal(true).default(true),
+    expiresInMs: z.number().int().positive().max(31_536_000_000).optional(),
+    metadata: z.record(z.string(), JsonValueSchema).default({}),
+}).strict();
+export const AtomHostCompletionSchema = z.object({
+    output: JsonValueSchema,
+    artifacts: z.array(AtomArtifactReferenceSchema).default([]),
+    summary: z.string().trim().min(1),
+}).strict();
+export const AtomHostResumeSchema = z.object({
+    schemaVersion: z.literal("1.0"),
+    kind: z.literal("host"),
+    hostTaskId: z.string().trim().min(1),
+    continuationToken: z.string().trim().min(32),
+    result: AtomHostCompletionSchema,
+}).strict();
+export const AtomResumeSchema = z.discriminatedUnion("kind", [
+    AtomSignalResumeSchema,
+    AtomHostResumeSchema,
+]);
+export const MAX_LIFECYCLE_POLL_DELAY_MS = 86_400_000;
+export const AtomRunningResultSchema = z.object({
+    schemaVersion: z.literal("1.0"),
+    status: z.literal("running"),
+    checkpoint: JsonValueSchema,
+    nextPollAfterMs: z.number().int().positive().max(MAX_LIFECYCLE_POLL_DELAY_MS).optional(),
+}).strict();
+export const AtomAwaitingSignalResultSchema = z.object({
+    schemaVersion: z.literal("1.0"),
+    status: z.literal("awaiting_signal"),
+    checkpoint: JsonValueSchema,
+    signal: AtomSignalRequestSchema,
+}).strict();
+export const AtomAwaitingHostResultSchema = z.object({
+    schemaVersion: z.literal("1.0"),
+    status: z.literal("awaiting_host"),
+    checkpoint: JsonValueSchema,
+    task: AtomHostTaskDeclarationSchema,
+}).strict();
+export const AtomSucceededResultSchema = z.object({
+    schemaVersion: z.literal("1.0"),
+    status: z.literal("succeeded"),
+    output: JsonValueSchema,
+    artifacts: z.array(AtomArtifactReferenceSchema).default([]),
+}).strict();
+export const AtomLifecycleResultSchema = z.discriminatedUnion("status", [
+    AtomRunningResultSchema,
+    AtomAwaitingSignalResultSchema,
+    AtomAwaitingHostResultSchema,
+    AtomSucceededResultSchema,
+]);
+export const AtomLifecycleValidationErrorCodeSchema = z.enum([
+    "ATOM_LIFECYCLE_RESULT_INVALID",
+    "ATOM_OUTPUT_SCHEMA_MISMATCH",
+    "ATOM_SIGNAL_RESUME_INVALID",
+    "ATOM_SIGNAL_RESPONSE_SCHEMA_MISMATCH",
+    "ATOM_HOST_RESUME_INVALID",
+    "ATOM_HOST_RESULT_SCHEMA_MISMATCH",
+]);
+function formatIssuePath(segments) {
+    return segments.reduce((path, segment) => typeof segment === "number" ? `${path}[${segment}]` : `${path}.${String(segment)}`, "$");
+}
+function invalidResultErrors(raw) {
+    const result = AtomLifecycleResultSchema.safeParse(raw);
+    if (result.success)
+        return [];
+    return result.error.issues.map((issue) => ({
+        code: "ATOM_LIFECYCLE_RESULT_INVALID",
+        path: formatIssuePath(issue.path),
+        message: issue.message,
+    }));
+}
+export function validateAtomLifecycleResult(manifest, raw) {
+    const shapeErrors = invalidResultErrors(raw);
+    if (shapeErrors.length > 0)
+        return { success: false, errors: shapeErrors };
+    const parsed = AtomLifecycleResultSchema.parse(raw);
+    const errors = [];
+    if (parsed.status === "succeeded") {
+        errors.push(...validateJsonSchemaInstance(manifest.outputSchema, parsed.output, "$.output").map((issue) => ({
+            code: "ATOM_OUTPUT_SCHEMA_MISMATCH",
+            path: issue.path,
+            message: issue.message,
+        })));
+    }
+    return errors.length === 0
+        ? { success: true, data: parsed }
+        : { success: false, errors };
+}
+export function validateAtomSignalResume(request, raw) {
+    const parsed = AtomSignalResumeSchema.safeParse(raw);
+    if (!parsed.success) {
+        return {
+            success: false,
+            errors: parsed.error.issues.map((issue) => ({
+                code: "ATOM_SIGNAL_RESUME_INVALID",
+                path: formatIssuePath(issue.path),
+                message: issue.message,
+            })),
+        };
+    }
+    if (parsed.data.key !== request.key) {
+        return {
+            success: false,
+            errors: [{
+                    code: "ATOM_SIGNAL_RESUME_INVALID",
+                    path: "$.key",
+                    message: `Signal response key '${parsed.data.key}' does not match request key '${request.key}'`,
+                }],
+        };
+    }
+    const responseIssues = validateJsonSchemaInstance(request.responseSchema, parsed.data.response, "$.response");
+    if (responseIssues.length > 0) {
+        return {
+            success: false,
+            errors: responseIssues.map((issue) => ({
+                code: "ATOM_SIGNAL_RESPONSE_SCHEMA_MISMATCH",
+                path: issue.path,
+                message: issue.message,
+            })),
+        };
+    }
+    return { success: true, data: parsed.data };
+}
+export function validateAtomHostResume(manifest, hostTaskId, continuationToken, raw, responseSchema = manifest.outputSchema) {
+    const parsed = AtomHostResumeSchema.safeParse(raw);
+    if (!parsed.success) {
+        return {
+            success: false,
+            errors: parsed.error.issues.map((issue) => ({
+                code: "ATOM_HOST_RESUME_INVALID",
+                path: formatIssuePath(issue.path),
+                message: issue.message,
+            })),
+        };
+    }
+    const errors = [];
+    if (parsed.data.hostTaskId !== hostTaskId) {
+        errors.push({ code: "ATOM_HOST_RESUME_INVALID", path: "$.hostTaskId", message: "HostTask ID does not match the pending Handoff" });
+    }
+    if (parsed.data.continuationToken !== continuationToken) {
+        errors.push({ code: "ATOM_HOST_RESUME_INVALID", path: "$.continuationToken", message: "Continuation token does not match the pending Handoff" });
+    }
+    errors.push(...validateJsonSchemaInstance(responseSchema, parsed.data.result.output, "$.result.output").map((issue) => ({
+        code: "ATOM_HOST_RESULT_SCHEMA_MISMATCH",
+        path: issue.path,
+        message: issue.message,
+    })));
+    return errors.length === 0 ? { success: true, data: parsed.data } : { success: false, errors };
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/atoms/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../src/atoms/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,gBAAgB,EAChB,eAAe,GAGhB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AAEjF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,IAAI,CAAC;IAC5C,YAAY;IACZ,SAAS;IACT,WAAW;IACX,YAAY;IACZ,SAAS;IACT,UAAU;IACV,UAAU;CACX,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,IAAI,CAAC;IAC3C,SAAS;IACT,SAAS;IACT,iBAAiB;IACjB,eAAe;IACf,WAAW;IACX,QAAQ;IACR,WAAW;IACX,aAAa;IACb,iBAAiB;CAClB,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC,MAAM,EAAE,CAAC;AAIZ,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IAC/B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,oCAAoC,CAAC;IAC3D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC,OAAO,EAAE,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;IACpC,cAAc,EAAE,gBAAgB;IAChC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,QAAQ,EAAE;IACvE,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC,QAAQ,EAAE;CAC3D,CAAC,CAAC,MAAM,EAAE,CAAC;AAIZ,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IAC/B,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACzB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAClC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,oCAAoC,CAAC;IAC3D,QAAQ,EAAE,eAAe;CAC1B,CAAC,CAAC,MAAM,EAAE,CAAC;AAIZ,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IAC/B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrC,OAAO,EAAE,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;IACpC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC3D,cAAc,EAAE,gBAAgB,CAAC,QAAQ,EAAE;IAC3C,kBAAkB,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IACjD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,QAAQ,EAAE;IACvE,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CAC5D,CAAC,CAAC,MAAM,EAAE,CAAC;AAIZ,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,MAAM,EAAE,eAAe;IACvB,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC3D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAClC,CAAC,CAAC,MAAM,EAAE,CAAC;AAGZ,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IAC/B,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IACvB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACpC,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;IAC5C,MAAM,EAAE,wBAAwB;CACjC,CAAC,CAAC,MAAM,EAAE,CAAC;AAGZ,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAC3D,sBAAsB;IACtB,oBAAoB;CACrB,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,2BAA2B,GAAG,UAAU,CAAC;AAEtD,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IAC/B,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IAC5B,UAAU,EAAE,eAAe;IAC3B,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC,QAAQ,EAAE;CACzF,CAAC,CAAC,MAAM,EAAE,CAAC;AASZ,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IACrD,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IAC/B,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC;IACpC,UAAU,EAAE,eAAe;IAC3B,MAAM,EAAE,uBAAuB;CAChC,CAAC,CAAC,MAAM,EAAE,CAAC;AASZ,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IAC/B,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC;IAClC,UAAU,EAAE,eAAe;IAC3B,IAAI,EAAE,6BAA6B;CACpC,CAAC,CAAC,MAAM,EAAE,CAAC;AASZ,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IAC/B,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;IAC9B,MAAM,EAAE,eAAe;IACvB,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CAC5D,CAAC,CAAC,MAAM,EAAE,CAAC;AASZ,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,kBAAkB,CAAC,QAAQ,EAAE;IACtE,uBAAuB;IACvB,8BAA8B;IAC9B,4BAA4B;IAC5B,yBAAyB;CAC1B,CAAC,CAAC;AAWH,MAAM,CAAC,MAAM,sCAAsC,GAAG,CAAC,CAAC,IAAI,CAAC;IAC3D,+BAA+B;IAC/B,6BAA6B;IAC7B,4BAA4B;IAC5B,sCAAsC;IACtC,0BAA0B;IAC1B,kCAAkC;CACnC,CAAC,CAAC;AAcH,SAAS,eAAe,CAAC,QAAgC;IACvD,OAAO,QAAQ,CAAC,MAAM,CAAS,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAC/C,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,GAAa,CAAC,CAAC;AACvG,CAAC;AAED,SAAS,mBAAmB,CAAC,GAAY;IACvC,MAAM,MAAM,GAAG,yBAAyB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACxD,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IAC9B,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACzC,IAAI,EAAE,+BAA+B;QACrC,IAAI,EAAE,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC;QACjC,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,QAAsB,EACtB,GAAY;IAEZ,MAAM,WAAW,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;IAC7C,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IAC3E,MAAM,MAAM,GAAG,yBAAyB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpD,MAAM,MAAM,GAAmC,EAAE,CAAC;IAElD,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC,GAAG,0BAA0B,CACvC,QAAQ,CAAC,YAAY,EACrB,MAAM,CAAC,MAAM,EACb,UAAU,CACX,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAChB,IAAI,EAAE,6BAAsC;YAC5C,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC,CAAC,CAAC;IACP,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC;QACxB,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE;QACjC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,OAA0B,EAC1B,GAAY;IAEZ,MAAM,MAAM,GAAG,sBAAsB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACrD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBAC1C,IAAI,EAAE,4BAA4B;gBAClC,IAAI,EAAE,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC;gBACjC,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,OAAO,CAAC,GAAG,EAAE,CAAC;QACpC,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,CAAC;oBACP,IAAI,EAAE,4BAA4B;oBAClC,IAAI,EAAE,OAAO;oBACb,OAAO,EAAE,wBAAwB,MAAM,CAAC,IAAI,CAAC,GAAG,iCAAiC,OAAO,CAAC,GAAG,GAAG;iBAChG,CAAC;SACH,CAAC;IACJ,CAAC;IACD,MAAM,cAAc,GAAG,0BAA0B,CAAC,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAC9G,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBACrC,IAAI,EAAE,sCAAsC;gBAC5C,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,QAAsB,EACtB,UAAkB,EAClB,iBAAyB,EACzB,GAAY,EACZ,cAAc,GAAG,QAAQ,CAAC,YAAY;IAEtC,MAAM,MAAM,GAAG,oBAAoB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACnD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBAC1C,IAAI,EAAE,0BAA0B;gBAChC,IAAI,EAAE,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC;gBACjC,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAmC,EAAE,CAAC;IAClD,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,0BAA0B,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,gDAAgD,EAAE,CAAC,CAAC;IACrI,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,CAAC,iBAAiB,KAAK,iBAAiB,EAAE,CAAC;QACxD,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,0BAA0B,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,uDAAuD,EAAE,CAAC,CAAC;IACnJ,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,GAAG,0BAA0B,CACvC,cAAc,EACd,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EACzB,iBAAiB,CAClB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAChB,IAAI,EAAE,kCAA2C;QACjD,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC,CAAC,CAAC,CAAC;IACL,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AACjG,CAAC"}

package/dist/atoms/manifest.d.ts

@@ -0,0 +1,68 @@
+import { z } from "zod";
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export declare const JsonValueSchema: z.ZodType<JsonValue>;
+/**
+ * A deliberately format-focused JSON Schema contract.
+ *
+ * Full instance validation belongs to the Workflow compiler/runtime. At the
+ * registry boundary we reject non-JSON values and malformed top-level schema
+ * keywords without narrowing plugins to one JSON Schema draft.
+ */
+export declare const JsonSchemaSchema: z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+export type JsonSchema = z.infer<typeof JsonSchemaSchema>;
+export declare const AtomIdSchema: z.ZodString;
+export declare const SemanticVersionSchema: z.ZodString;
+export declare const AtomRetryPolicySchema: z.ZodObject<{
+    maxAttempts: z.ZodNumber;
+    strategy: z.ZodEnum<{
+        fixed: "fixed";
+        exponential: "exponential";
+    }>;
+    baseDelayMs: z.ZodNumber;
+    maxDelayMs: z.ZodNumber;
+    jitter: z.ZodBoolean;
+}, z.core.$strict>;
+export type AtomRetryPolicy = z.infer<typeof AtomRetryPolicySchema>;
+export declare const AtomCachePolicySchema: z.ZodObject<{
+    enabled: z.ZodBoolean;
+    ttlMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export type AtomCachePolicy = z.infer<typeof AtomCachePolicySchema>;
+export declare const AtomManifestSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"2.0">;
+    id: z.ZodString;
+    version: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+    status: z.ZodEnum<{
+        deprecated: "deprecated";
+        experimental: "experimental";
+        stable: "stable";
+    }>;
+    inputSchema: z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+    outputSchema: z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+    idempotent: z.ZodDefault<z.ZodBoolean>;
+    defaults: z.ZodDefault<z.ZodObject<{
+        timeoutMs: z.ZodOptional<z.ZodNumber>;
+        retry: z.ZodObject<{
+            maxAttempts: z.ZodNumber;
+            strategy: z.ZodEnum<{
+                fixed: "fixed";
+                exponential: "exponential";
+            }>;
+            baseDelayMs: z.ZodNumber;
+            maxDelayMs: z.ZodNumber;
+            jitter: z.ZodBoolean;
+        }, z.core.$strict>;
+        cache: z.ZodObject<{
+            enabled: z.ZodBoolean;
+            ttlMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type AtomManifest = z.infer<typeof AtomManifestSchema>;
+export declare function atomKey(manifest: Pick<AtomManifest, "id" | "version">): string;
+//# sourceMappingURL=manifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/atoms/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAC7D,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,SAAS,EAAE,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEnF,eAAO,MAAM,eAAe,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAShD,CAAC;AAmGF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,uGAE3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,YAAY,aAGxB,CAAC;AAEF,eAAO,MAAM,qBAAqB,aAGjC,CAAC;AAEF,eAAO,MAAM,qBAAqB;;;;;;;;;kBAUhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,qBAAqB;;;kBAGvB,CAAC;AAEZ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAmBpB,CAAC;AAEZ,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,wBAAgB,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,GAAG,SAAS,CAAC,GAAG,MAAM,CAE9E"}

package/dist/atoms/manifest.js

@@ -0,0 +1,144 @@
+import { z } from "zod";
+export const JsonValueSchema = z.lazy(() => z.union([
+    z.string(),
+    z.number().finite(),
+    z.boolean(),
+    z.null(),
+    z.array(JsonValueSchema),
+    z.record(z.string(), JsonValueSchema),
+]));
+const JSON_SCHEMA_TYPES = new Set(["null", "boolean", "object", "array", "number", "integer", "string"]);
+const JSON_SCHEMA_SHAPE_KEYS = ["type", "$ref", "enum", "const", "allOf", "anyOf", "oneOf", "not"];
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function validateJsonSchemaNode(schema, context, path) {
+    if (typeof schema === "boolean")
+        return;
+    if (!isRecord(schema)) {
+        context.addIssue({ code: "custom", path, message: "JSON Schema node must be an object or boolean" });
+        return;
+    }
+    if (!JSON_SCHEMA_SHAPE_KEYS.some((key) => key in schema)) {
+        context.addIssue({ code: "custom", path, message: "JSON Schema node must declare a type, reference, enum, const, or composition" });
+    }
+    if (schema.$schema !== undefined && typeof schema.$schema !== "string") {
+        context.addIssue({ code: "custom", path: [...path, "$schema"], message: "$schema must be a string" });
+    }
+    if (schema.$ref !== undefined && typeof schema.$ref !== "string") {
+        context.addIssue({ code: "custom", path: [...path, "$ref"], message: "$ref must be a string" });
+    }
+    const type = schema.type;
+    const types = typeof type === "string" ? [type] : Array.isArray(type) ? type : type === undefined ? [] : null;
+    if (types === null
+        || types.length === 0 && Array.isArray(type)
+        || types.some((value) => typeof value !== "string" || !JSON_SCHEMA_TYPES.has(value))
+        || new Set(types).size !== types.length) {
+        context.addIssue({ code: "custom", path: [...path, "type"], message: "type must contain unique valid JSON Schema primitive names" });
+    }
+    const properties = schema.properties;
+    if (properties !== undefined) {
+        if (!isRecord(properties)) {
+            context.addIssue({ code: "custom", path: [...path, "properties"], message: "properties must be an object" });
+        }
+        else {
+            for (const [name, child] of Object.entries(properties)) {
+                validateJsonSchemaNode(child, context, [...path, "properties", name]);
+            }
+        }
+    }
+    const required = schema.required;
+    if (required !== undefined) {
+        if (!Array.isArray(required) || required.some((value) => typeof value !== "string")) {
+            context.addIssue({ code: "custom", path: [...path, "required"], message: "required must be an array of strings" });
+        }
+        else if (new Set(required).size !== required.length) {
+            context.addIssue({ code: "custom", path: [...path, "required"], message: "required must not contain duplicates" });
+        }
+    }
+    const items = schema.items;
+    if (items !== undefined)
+        validateJsonSchemaNode(items, context, [...path, "items"]);
+    const additionalProperties = schema.additionalProperties;
+    if (additionalProperties !== undefined) {
+        validateJsonSchemaNode(additionalProperties, context, [...path, "additionalProperties"]);
+    }
+    for (const keyword of ["allOf", "anyOf", "oneOf"]) {
+        const alternatives = schema[keyword];
+        if (alternatives === undefined)
+            continue;
+        if (!Array.isArray(alternatives) || alternatives.length === 0) {
+            context.addIssue({ code: "custom", path: [...path, keyword], message: `${keyword} must be a non-empty array of schemas` });
+            continue;
+        }
+        alternatives.forEach((alternative, index) => validateJsonSchemaNode(alternative, context, [...path, keyword, index]));
+    }
+    if (schema.not !== undefined)
+        validateJsonSchemaNode(schema.not, context, [...path, "not"]);
+    for (const keyword of ["$defs", "definitions"]) {
+        const definitions = schema[keyword];
+        if (definitions === undefined)
+            continue;
+        if (!isRecord(definitions)) {
+            context.addIssue({ code: "custom", path: [...path, keyword], message: `${keyword} must be an object of schemas` });
+            continue;
+        }
+        for (const [name, definition] of Object.entries(definitions)) {
+            validateJsonSchemaNode(definition, context, [...path, keyword, name]);
+        }
+    }
+    if (schema.enum !== undefined && (!Array.isArray(schema.enum) || schema.enum.length === 0)) {
+        context.addIssue({ code: "custom", path: [...path, "enum"], message: "enum must be a non-empty array" });
+    }
+}
+/**
+ * A deliberately format-focused JSON Schema contract.
+ *
+ * Full instance validation belongs to the Workflow compiler/runtime. At the
+ * registry boundary we reject non-JSON values and malformed top-level schema
+ * keywords without narrowing plugins to one JSON Schema draft.
+ */
+export const JsonSchemaSchema = z.record(z.string(), JsonValueSchema).superRefine((schema, context) => {
+    validateJsonSchemaNode(schema, context, []);
+});
+export const AtomIdSchema = z.string().regex(/^[a-z][a-z0-9]*(?:\.[a-z][a-z0-9]*(?:-[a-z0-9]+)*)+$/, "Atom id must be a dot-delimited lowercase namespace, for example page.measure");
+export const SemanticVersionSchema = z.string().regex(/^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/, "Version must use semantic versioning");
+export const AtomRetryPolicySchema = z.object({
+    maxAttempts: z.number().int().min(1).max(11),
+    strategy: z.enum(["fixed", "exponential"]),
+    baseDelayMs: z.number().int().nonnegative(),
+    maxDelayMs: z.number().int().nonnegative(),
+    jitter: z.boolean(),
+}).strict().superRefine((policy, context) => {
+    if (policy.maxDelayMs < policy.baseDelayMs) {
+        context.addIssue({ code: "custom", path: ["maxDelayMs"], message: "maxDelayMs must be greater than or equal to baseDelayMs" });
+    }
+});
+export const AtomCachePolicySchema = z.object({
+    enabled: z.boolean(),
+    ttlMs: z.number().int().positive().optional(),
+}).strict();
+export const AtomManifestSchema = z.object({
+    schemaVersion: z.literal("2.0"),
+    id: AtomIdSchema,
+    version: SemanticVersionSchema,
+    title: z.string().trim().min(1),
+    description: z.string().trim().min(1),
+    status: z.enum(["experimental", "stable", "deprecated"]),
+    inputSchema: JsonSchemaSchema,
+    outputSchema: JsonSchemaSchema,
+    idempotent: z.boolean().default(false),
+    defaults: z.object({
+        /** Omit to let an Attempt run without a wall-clock timer. */
+        timeoutMs: z.number().int().positive().optional(),
+        retry: AtomRetryPolicySchema,
+        cache: AtomCachePolicySchema,
+    }).strict().default({
+        retry: { maxAttempts: 1, strategy: "fixed", baseDelayMs: 0, maxDelayMs: 0, jitter: false },
+        cache: { enabled: false },
+    }),
+}).strict();
+export function atomKey(manifest) {
+    return `${manifest.id}@${manifest.version}`;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/atoms/manifest.js.map

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

package/dist/atoms/package.d.ts

@@ -0,0 +1,11 @@
+import { z } from "zod";
+export declare const AtomPackageManifestSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"2.0">;
+    id: z.ZodString;
+    version: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+    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>;
+export type AtomPackageManifest = z.infer<typeof AtomPackageManifestSchema>;
+//# sourceMappingURL=package.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"package.d.ts","sourceRoot":"","sources":["../../src/atoms/package.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,yBAAyB;;;;;;;kBAO3B,CAAC;AAEZ,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/atoms/package.js

@@ -0,0 +1,11 @@
+import { z } from "zod";
+import { AtomIdSchema, JsonValueSchema, SemanticVersionSchema } from "./manifest.js";
+export const AtomPackageManifestSchema = z.object({
+    schemaVersion: z.literal("2.0"),
+    id: AtomIdSchema,
+    version: SemanticVersionSchema,
+    name: z.string().trim().min(1),
+    description: z.string().trim().min(1),
+    metadata: z.record(z.string(), JsonValueSchema).default({}),
+}).strict();
+//# sourceMappingURL=package.js.map

package/dist/atoms/package.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.js","sourceRoot":"","sources":["../../src/atoms/package.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAErF,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IAC/B,EAAE,EAAE,YAAY;IAChB,OAAO,EAAE,qBAAqB;IAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CAC5D,CAAC,CAAC,MAAM,EAAE,CAAC"}

package/dist/errors/atom-workflow-error.d.ts

@@ -0,0 +1,7 @@
+export declare class AtomWorkflowError extends Error {
+    readonly code: string;
+    readonly retryable: boolean;
+    constructor(code: string, message: string, retryable?: boolean, options?: ErrorOptions);
+}
+export declare function toAtomWorkflowError(error: unknown, fallbackCode?: string): AtomWorkflowError;
+//# sourceMappingURL=atom-workflow-error.d.ts.map

package/dist/errors/atom-workflow-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atom-workflow-error.d.ts","sourceRoot":"","sources":["../../src/errors/atom-workflow-error.ts"],"names":[],"mappings":"AAAA,qBAAa,iBAAkB,SAAQ,KAAK;aAExB,IAAI,EAAE,MAAM;aAEZ,SAAS;gBAFT,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACC,SAAS,UAAQ,EACjC,OAAO,CAAC,EAAE,YAAY;CAKzB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,SAAmB,GAAG,iBAAiB,CAQtG"}

package/dist/errors/atom-workflow-error.js

@@ -0,0 +1,21 @@
+export class AtomWorkflowError extends Error {
+    code;
+    retryable;
+    constructor(code, message, retryable = false, options) {
+        super(message, options);
+        this.code = code;
+        this.retryable = retryable;
+        this.name = "AtomWorkflowError";
+    }
+}
+export function toAtomWorkflowError(error, fallbackCode = "INTERNAL_ERROR") {
+    if (error instanceof AtomWorkflowError)
+        return error;
+    if (error instanceof Error) {
+        const code = "code" in error && typeof error.code === "string" ? error.code : fallbackCode;
+        const retryable = "retryable" in error && error.retryable === true;
+        return new AtomWorkflowError(code, error.message, retryable, { cause: error });
+    }
+    return new AtomWorkflowError(fallbackCode, String(error));
+}
+//# sourceMappingURL=atom-workflow-error.js.map

package/dist/errors/atom-workflow-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atom-workflow-error.js","sourceRoot":"","sources":["../../src/errors/atom-workflow-error.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAExB;IAEA;IAHlB,YACkB,IAAY,EAC5B,OAAe,EACC,YAAY,KAAK,EACjC,OAAsB;QAEtB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QALR,SAAI,GAAJ,IAAI,CAAQ;QAEZ,cAAS,GAAT,SAAS,CAAQ;QAIjC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAc,EAAE,YAAY,GAAG,gBAAgB;IACjF,IAAI,KAAK,YAAY,iBAAiB;QAAE,OAAO,KAAK,CAAC;IACrD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,MAAM,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC;QAC3F,MAAM,SAAS,GAAG,WAAW,IAAI,KAAK,IAAI,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC;QACnE,OAAO,IAAI,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,IAAI,iBAAiB,CAAC,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AAC5D,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+export * from "./atoms/manifest.js";
+export * from "./atoms/descriptors.js";
+export * from "./atoms/lifecycle.js";
+export * from "./atoms/host.js";
+export * from "./atoms/package.js";
+export * from "./json-schema/validate-instance.js";
+export * from "./planner/planner.js";
+export * from "./planner/planner-draft.js";
+export * from "./planner/planner-validation.js";
+export * from "./planner/planning-workspace.js";
+export * from "./planner/planning-capability.js";
+export * from "./planner/plan-record.js";
+export * from "./workflows/spec.js";
+export * from "./workflows/policy.js";
+export * from "./workflows/validation.js";
+export * from "./workflows/ir.js";
+export * from "./workflows/revision.js";
+export * from "./workflows/topology.js";
+export * from "./workflows/visualization.js";
+export * from "./runtime/records.js";
+export * from "./runtime/machine.js";
+export * from "./runtime/resume.js";
+export * from "./runtime/diagnostics.js";
+export * from "./errors/atom-workflow-error.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oCAAoC,CAAC;AACnD,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iCAAiC,CAAC"}

package/dist/index.js

@@ -0,0 +1,25 @@
+export * from "./atoms/manifest.js";
+export * from "./atoms/descriptors.js";
+export * from "./atoms/lifecycle.js";
+export * from "./atoms/host.js";
+export * from "./atoms/package.js";
+export * from "./json-schema/validate-instance.js";
+export * from "./planner/planner.js";
+export * from "./planner/planner-draft.js";
+export * from "./planner/planner-validation.js";
+export * from "./planner/planning-workspace.js";
+export * from "./planner/planning-capability.js";
+export * from "./planner/plan-record.js";
+export * from "./workflows/spec.js";
+export * from "./workflows/policy.js";
+export * from "./workflows/validation.js";
+export * from "./workflows/ir.js";
+export * from "./workflows/revision.js";
+export * from "./workflows/topology.js";
+export * from "./workflows/visualization.js";
+export * from "./runtime/records.js";
+export * from "./runtime/machine.js";
+export * from "./runtime/resume.js";
+export * from "./runtime/diagnostics.js";
+export * from "./errors/atom-workflow-error.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oCAAoC,CAAC;AACnD,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iCAAiC,CAAC"}

package/dist/json-schema/validate-instance.d.ts

@@ -0,0 +1,7 @@
+import type { JsonSchema, JsonValue } from "../atoms/manifest.js";
+export interface JsonSchemaInstanceIssue {
+    readonly path: string;
+    readonly message: string;
+}
+export declare function validateJsonSchemaInstance(schema: JsonSchema, value: JsonValue, path?: string): readonly JsonSchemaInstanceIssue[];
+//# sourceMappingURL=validate-instance.d.ts.map

package/dist/json-schema/validate-instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-instance.d.ts","sourceRoot":"","sources":["../../src/json-schema/validate-instance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAElE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAkLD,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,SAAS,EAChB,IAAI,SAAM,GACT,SAAS,uBAAuB,EAAE,CAEpC"}