@petepetrash/circuit 0.1.0

package/dist/schemas/skill-hook.js

@@ -0,0 +1,279 @@
+import { z } from 'zod';
+import { CompiledFlowId, SkillId, StageId, StepId } from './ids.js';
+export const SKILL_HOOK_VOCABULARY = [
+    {
+        hook: 'before:high-impact-alignment',
+        detected_from: ['goal-contract:impact=high', 'operator-flag:high-impact'],
+        cardinality: 'per-run',
+        // High-impact alignment defaults to observe-only (record, do not inject) so a
+        // high-impact step is never auto-augmented without the operator opting in.
+        default_mode: 'mute',
+    },
+    {
+        hook: 'before:architecture-analysis',
+        detected_from: ['selected-process:explore-architecture', 'step-metadata:architecture-analysis'],
+        cardinality: 'per-step',
+        default_mode: 'auto',
+    },
+    {
+        hook: 'before:plan-implementation',
+        detected_from: ['stage-transition:Plan', 'step-metadata:plan'],
+        cardinality: 'per-stage',
+        default_mode: 'auto',
+    },
+    {
+        hook: 'before:implementation',
+        detected_from: ['stage-transition:Plan->Act', 'stage-transition:Act'],
+        cardinality: 'per-stage',
+        default_mode: 'auto',
+    },
+    {
+        hook: 'before:verification',
+        detected_from: ['stage-transition:Verify', 'step-metadata:verify'],
+        cardinality: 'per-stage',
+        default_mode: 'auto',
+    },
+    // Parameterized file-edit anchors. One pair replaces the five named
+    // file-surface hooks (after:react-ui-change/test-change/schema-change/
+    // api-surface-change/dependency-change) and the four *_surfaces config
+    // buckets. The operator writes the predicate as a key suffix
+    // (`after:edit-files:.tsx`); the engine matches a literal extension suffix and
+    // never interprets the meaning. See docs/ideas/skill-hooks-first-principles.md
+    // (the reframe) and docs/ideas/skill-hooks-dispatch-spec.md (D1).
+    {
+        hook: 'before:edit-files',
+        detected_from: ['plan-report:anticipated-file-extensions', 'plan-report:likely-touched'],
+        cardinality: 'per-step',
+        default_mode: 'auto',
+    },
+    {
+        hook: 'after:edit-files',
+        detected_from: ['change-report:touched-files', 'change-set:observed'],
+        cardinality: 'per-step',
+        default_mode: 'auto',
+    },
+    {
+        hook: 'after:verification-failed',
+        detected_from: ['evidence-map:required-check-failed'],
+        cardinality: 'per-step',
+        default_mode: 'auto',
+    },
+    {
+        hook: 'after:evidence-gap',
+        detected_from: ['evidence-map:required-claim-missing-after-verify'],
+        cardinality: 'per-stage',
+        default_mode: 'auto',
+    },
+    {
+        hook: 'before:close-run',
+        detected_from: ['run-envelope:close-decision', 'stage-transition:Close'],
+        cardinality: 'per-run',
+        default_mode: 'auto',
+    },
+    {
+        hook: 'before:handoff',
+        detected_from: ['command:handoff', 'run-envelope:handoff-decision'],
+        cardinality: 'per-run',
+        default_mode: 'auto',
+    },
+];
+export const SkillHookCardinality = z.enum(['per-run', 'per-stage', 'per-step']);
+// Two modes: `auto` injects the configured skills; `mute` records the event but
+// injects nothing (observe-only). There is no `ask` mode — an operator who wants
+// a skill to load says so by listing it under `auto` (the default).
+export const SkillHookPolicyMode = z.enum(['auto', 'mute']);
+const SHIPPED_HOOKS = new Set(SKILL_HOOK_VOCABULARY.map((entry) => entry.hook));
+const CUSTOM_HOOK_RE = /^[a-z][a-z0-9-]*\/(before|after):[a-z][a-z0-9-]*$/;
+const SHIPPED_SHAPE_RE = /^(before|after):[a-z][a-z0-9-]*$/;
+// Parameterized edit-files hook: the predicate is the key suffix. v1 predicate is
+// an extension suffix — one or more dot-segments (`.tsx`, `.test.ts`, `.d.ts`).
+// The bare `before:edit-files`/`after:edit-files` anchors validate via SHIPPED_HOOKS
+// above (they mean "any file edit"); this matches only the suffixed form.
+const PARAMETERIZED_EDIT_FILE_RE = /^(before|after):edit-files:(\.[A-Za-z0-9]+)+$/;
+function hookBody(value) {
+    const slash = value.indexOf('/');
+    return slash === -1 ? value : value.slice(slash + 1);
+}
+export const SkillHookName = z.string().superRefine((value, ctx) => {
+    if (SHIPPED_HOOKS.has(value))
+        return;
+    if (PARAMETERIZED_EDIT_FILE_RE.test(value))
+        return;
+    if (SHIPPED_SHAPE_RE.test(value)) {
+        ctx.addIssue({
+            code: 'custom',
+            message: `unknown shipped Skill Hook '${value}'`,
+        });
+        return;
+    }
+    if (!CUSTOM_HOOK_RE.test(value)) {
+        ctx.addIssue({
+            code: 'custom',
+            message: 'custom Skill Hooks must be namespaced as <namespace>/<before|after>:<name>',
+        });
+        return;
+    }
+    if (SHIPPED_HOOKS.has(hookBody(value))) {
+        ctx.addIssue({
+            code: 'custom',
+            message: 'custom Skill Hooks must not reuse shipped hook names',
+        });
+    }
+});
+export const SkillHookNameArray = z.array(SkillHookName).superRefine((hooks, ctx) => {
+    const seen = new Set();
+    for (const [index, hook] of hooks.entries()) {
+        if (seen.has(hook)) {
+            ctx.addIssue({
+                code: 'custom',
+                path: [index],
+                message: `duplicate Skill Hook '${hook}'`,
+            });
+        }
+        seen.add(hook);
+    }
+});
+export const SkillHookPolicyRule = z
+    .object({
+    // Omitting mode means auto: listing skills under a hook is enough to load them.
+    mode: SkillHookPolicyMode.default('auto'),
+    skills: z.array(SkillId).optional(),
+    strict: z.boolean().default(false),
+})
+    .strict()
+    .superRefine((rule, ctx) => {
+    if (rule.mode === 'mute') {
+        if (rule.skills !== undefined) {
+            ctx.addIssue({
+                code: 'custom',
+                path: ['skills'],
+                message: 'mute Skill Hook policy must not declare skills',
+            });
+        }
+        return;
+    }
+    if (rule.skills === undefined || rule.skills.length === 0) {
+        ctx.addIssue({
+            code: 'custom',
+            path: ['skills'],
+            message: `${rule.mode} Skill Hook policy requires at least one skill`,
+        });
+        return;
+    }
+    const seen = new Set();
+    for (const [index, skill] of rule.skills.entries()) {
+        const key = skill;
+        if (seen.has(key)) {
+            ctx.addIssue({
+                code: 'custom',
+                path: ['skills', index],
+                message: `duplicate Skill Hook skill '${key}'`,
+            });
+        }
+        seen.add(key);
+    }
+});
+// The four per-surface glob buckets (react_surfaces/test_surfaces/
+// schema_surfaces/api_surfaces) that fed the named file-surface hooks are gone:
+// the glob predicate now lives in the parameterized edit-files hook key, so the
+// operator writes one `after:edit-files:.tsx` policy rule instead of a surface
+// bucket plus a named hook. `disabled_patterns` is an unrelated per-hook mute
+// list and stays.
+export const SkillHookDetectionConfig = z
+    .object({
+    disabled_patterns: z.record(SkillHookName, z.array(z.string().min(1))).default({}),
+})
+    .strict();
+export const SkillHookConfig = z
+    .object({
+    policy: z.record(SkillHookName, SkillHookPolicyRule).default({}),
+    detection: SkillHookDetectionConfig.default({ disabled_patterns: {} }),
+})
+    .strict();
+export const SkillHookSkillState = z.enum([
+    'planned',
+    'staged',
+    'requested',
+    'observed',
+    'unplanned',
+    'unavailable',
+]);
+export const SkillHookPolicyResolution = z.discriminatedUnion('source', [
+    z
+        .object({
+        mode: z.literal('none'),
+        source: z.literal('none'),
+    })
+        .strict(),
+    z
+        .object({
+        mode: SkillHookPolicyMode,
+        source: z.enum(['project-policy', 'user-global-policy', 'default-mapping']),
+        strict: z.boolean(),
+        policy_ref: z.string().min(1).optional(),
+    })
+        .strict(),
+]);
+export const SkillHookSkillRef = z
+    .object({
+    id: SkillId,
+    state: SkillHookSkillState,
+    source: z.enum(['project-policy', 'user-global-policy', 'default-mapping', 'host-observed']),
+    reason: z.string().min(1).optional(),
+})
+    .strict()
+    .superRefine((skill, ctx) => {
+    if (['observed', 'unplanned'].includes(skill.state) && skill.source !== 'host-observed') {
+        ctx.addIssue({
+            code: 'custom',
+            path: ['source'],
+            message: `${skill.state} Skill Hook activity requires host-observed source`,
+        });
+    }
+});
+export const RunSkillHookEvent = z
+    .object({
+    schema: z.literal('run.skill-hook@v0'),
+    event_id: z.string().min(1),
+    hook: SkillHookName,
+    detected_from: z.array(z.string().min(1)).min(1),
+    cardinality: SkillHookCardinality,
+    policy: SkillHookPolicyResolution,
+    flow_id: CompiledFlowId.optional(),
+    stage_id: StageId.optional(),
+    step_id: StepId.optional(),
+    attempt_id: z.string().min(1).optional(),
+    decision_packet_id: z.string().min(1).optional(),
+    triggered_skills: z.array(SkillHookSkillRef),
+    unavailable_skills: z.array(SkillHookSkillRef).optional(),
+})
+    .strict()
+    .superRefine((event, ctx) => {
+    if ((event.policy.mode === 'none' || event.policy.mode === 'mute') &&
+        event.triggered_skills.length > 0) {
+        ctx.addIssue({
+            code: 'custom',
+            path: ['triggered_skills'],
+            message: `${event.policy.mode} Skill Hook policy must not trigger skills`,
+        });
+    }
+    for (const [index, skill] of event.unavailable_skills?.entries() ?? []) {
+        if (skill.state !== 'unavailable') {
+            ctx.addIssue({
+                code: 'custom',
+                path: ['unavailable_skills', index, 'state'],
+                message: 'unavailable_skills entries must use unavailable state',
+            });
+        }
+    }
+    for (const [index, skill] of event.triggered_skills.entries()) {
+        if (skill.state === 'unavailable') {
+            ctx.addIssue({
+                code: 'custom',
+                path: ['triggered_skills', index, 'state'],
+                message: 'unavailable skills belong in unavailable_skills, not triggered_skills',
+            });
+        }
+    }
+});
+//# sourceMappingURL=skill-hook.js.map

package/dist/schemas/skill-hook.js.map

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

package/dist/schemas/skill.d.ts

@@ -0,0 +1,59 @@
+import { z } from 'zod';
+/**
+ * SkillDescriptor — see docs/contracts/skill.md.
+ *
+ * The compiled catalog entry for a Circuit plugin skill. A selection
+ * resolver binds skills by `SkillId`; a catalog compiler enumerates them.
+ *
+ * This is NOT the Claude Code `SKILL.md` YAML frontmatter shape. That
+ * upstream format is an external-protocol input to the catalog compiler,
+ * which emits `SkillDescriptor` as an internal projection. Field sets
+ * differ: CC frontmatter uses `name`/`description`/`trigger`; the
+ * descriptor here uses `id`/`title`/`description`/`trigger` plus
+ * `capabilities` and `domain`.
+ */
+export declare const SkillDomain: z.ZodEnum<{
+    coding: "coding";
+    design: "design";
+    research: "research";
+    ops: "ops";
+    "domain-general": "domain-general";
+}>;
+export type SkillDomain = z.infer<typeof SkillDomain>;
+export declare const SkillDescriptor: z.ZodPipe<z.ZodCustom<unknown, unknown>, z.ZodObject<{
+    id: z.core.$ZodBranded<z.ZodString, "SkillId", "out">;
+    title: z.ZodString;
+    description: z.ZodString;
+    trigger: z.ZodString;
+    capabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    domain: z.ZodDefault<z.ZodEnum<{
+        coding: "coding";
+        design: "design";
+        research: "research";
+        ops: "ops";
+        "domain-general": "domain-general";
+    }>>;
+}, z.core.$strict>>;
+export type SkillDescriptor = z.infer<typeof SkillDescriptor>;
+export declare const UserSkillEntry: z.ZodObject<{
+    id: z.core.$ZodBranded<z.ZodString, "SkillId", "out">;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    trigger: z.ZodOptional<z.ZodString>;
+    root: z.ZodString;
+    path: z.ZodString;
+    sha256: z.ZodString;
+    bytes: z.ZodNumber;
+}, z.core.$strict>;
+export type UserSkillEntry = z.infer<typeof UserSkillEntry>;
+export declare const SkillSlot: z.ZodObject<{
+    id: z.core.$ZodBranded<z.ZodString, "SkillSlotId", "out">;
+    description: z.ZodString;
+}, z.core.$strict>;
+export type SkillSlot = z.infer<typeof SkillSlot>;
+export declare const SkillSlotArray: z.ZodArray<z.ZodObject<{
+    id: z.core.$ZodBranded<z.ZodString, "SkillSlotId", "out">;
+    description: z.ZodString;
+}, z.core.$strict>>;
+export type SkillSlotArray = z.infer<typeof SkillSlotArray>;
+//# sourceMappingURL=skill.d.ts.map

package/dist/schemas/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../src/schemas/skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;;;;;;;;;GAYG;AAEH,eAAO,MAAM,WAAW;;;;;;EAAoE,CAAC;AAC7F,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAgCtD,eAAO,MAAM,eAAe;;;;;;;;;;;;;mBAAuD,CAAC;AACpF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,eAAO,MAAM,cAAc;;;;;;;;;kBAWhB,CAAC;AACZ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,eAAO,MAAM,SAAS;;;kBAKX,CAAC;AACZ,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD,eAAO,MAAM,cAAc;;;mBAazB,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/schemas/skill.js

@@ -0,0 +1,82 @@
+import { z } from 'zod';
+import { SkillId, SkillSlotId } from './ids.js';
+import { Sha256 } from './ref.js';
+/**
+ * SkillDescriptor — see docs/contracts/skill.md.
+ *
+ * The compiled catalog entry for a Circuit plugin skill. A selection
+ * resolver binds skills by `SkillId`; a catalog compiler enumerates them.
+ *
+ * This is NOT the Claude Code `SKILL.md` YAML frontmatter shape. That
+ * upstream format is an external-protocol input to the catalog compiler,
+ * which emits `SkillDescriptor` as an internal projection. Field sets
+ * differ: CC frontmatter uses `name`/`description`/`trigger`; the
+ * descriptor here uses `id`/`title`/`description`/`trigger` plus
+ * `capabilities` and `domain`.
+ */
+export const SkillDomain = z.enum(['coding', 'design', 'research', 'ops', 'domain-general']);
+/**
+ * Raw-input own-property guard (prototype-chain defense). Required
+ * catalog fields must be own properties on the raw input; inherited
+ * values through the prototype chain are rejected before Zod's own
+ * property access. Mirrors the same defense in continuity.ts and run.ts.
+ */
+const descriptorOwnPropertyGuard = z.custom((raw) => {
+    if (raw === null || typeof raw !== 'object')
+        return true;
+    const guarded = ['id', 'title', 'description', 'trigger'];
+    for (const f of guarded)
+        if (!Object.hasOwn(raw, f))
+            return false;
+    return true;
+}, 'skill descriptor has inherited (not own) required field; prototype-chain smuggle rejected');
+const SkillDescriptorBody = z
+    .object({
+    id: SkillId,
+    title: z.string().min(1),
+    description: z.string().min(1),
+    trigger: z.string().min(1),
+    /**
+     * `capabilities`, when present, is a non-empty array of non-empty
+     * strings. A catalog entry that has not declared any capabilities
+     * should omit the field; an empty list `[]` is an ambiguity bug
+     * and rejected.
+     */
+    capabilities: z.array(z.string().min(1)).min(1).optional(),
+    domain: SkillDomain.default('domain-general'),
+})
+    .strict();
+export const SkillDescriptor = descriptorOwnPropertyGuard.pipe(SkillDescriptorBody);
+export const UserSkillEntry = z
+    .object({
+    id: SkillId,
+    name: z.string().min(1).optional(),
+    description: z.string().min(1).optional(),
+    trigger: z.string().min(1).optional(),
+    root: z.string().min(1),
+    path: z.string().min(1),
+    sha256: Sha256,
+    bytes: z.number().int().nonnegative(),
+})
+    .strict();
+export const SkillSlot = z
+    .object({
+    id: SkillSlotId,
+    description: z.string().min(1),
+})
+    .strict();
+export const SkillSlotArray = z.array(SkillSlot).superRefine((slots, ctx) => {
+    const seen = new Set();
+    for (const [index, slot] of slots.entries()) {
+        const key = slot.id;
+        if (seen.has(key)) {
+            ctx.addIssue({
+                code: 'custom',
+                path: [index, 'id'],
+                message: `duplicate skill slot '${key}'`,
+            });
+        }
+        seen.add(key);
+    }
+});
+//# sourceMappingURL=skill.js.map

package/dist/schemas/skill.js.map

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

package/dist/schemas/snapshot.d.ts

@@ -0,0 +1,108 @@
+import { z } from 'zod';
+export declare const StepStatus: z.ZodEnum<{
+    complete: "complete";
+    pending: "pending";
+    in_progress: "in_progress";
+    check_failed: "check_failed";
+    aborted: "aborted";
+}>;
+export type StepStatus = z.infer<typeof StepStatus>;
+export declare const StepState: z.ZodObject<{
+    step_id: z.core.$ZodBranded<z.ZodString, "StepId", "out">;
+    status: z.ZodEnum<{
+        complete: "complete";
+        pending: "pending";
+        in_progress: "in_progress";
+        check_failed: "check_failed";
+        aborted: "aborted";
+    }>;
+    attempts: z.ZodNumber;
+    last_report_path: z.ZodOptional<z.ZodString>;
+    last_checkpoint_selection: z.ZodOptional<z.ZodString>;
+    last_route_taken: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type StepState = z.infer<typeof StepState>;
+export declare const SnapshotStatus: z.ZodEnum<{
+    complete: "complete";
+    stopped: "stopped";
+    handoff: "handoff";
+    in_progress: "in_progress";
+    aborted: "aborted";
+    escalated: "escalated";
+}>;
+export type SnapshotStatus = z.infer<typeof SnapshotStatus>;
+export declare const Snapshot: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    run_id: z.core.$ZodBranded<z.ZodGUID, "RunId", "out">;
+    flow_id: z.core.$ZodBranded<z.ZodString, "CompiledFlowId", "out">;
+    invocation_id: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "InvocationId", "out">>;
+    depth: z.ZodEnum<{
+        low: "low";
+        medium: "medium";
+        high: "high";
+        tournament: "tournament";
+        autonomous: "autonomous";
+    }>;
+    change_kind: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        failure_mode: z.ZodString;
+        acceptance_evidence: z.ZodString;
+        alternate_framing: z.ZodString;
+        change_kind: z.ZodLiteral<"ratchet-advance">;
+    }, z.core.$strict>, z.ZodObject<{
+        failure_mode: z.ZodString;
+        acceptance_evidence: z.ZodString;
+        alternate_framing: z.ZodString;
+        change_kind: z.ZodLiteral<"equivalence-refactor">;
+    }, z.core.$strict>, z.ZodObject<{
+        failure_mode: z.ZodString;
+        acceptance_evidence: z.ZodString;
+        alternate_framing: z.ZodString;
+        change_kind: z.ZodLiteral<"discovery">;
+    }, z.core.$strict>, z.ZodObject<{
+        failure_mode: z.ZodString;
+        acceptance_evidence: z.ZodString;
+        alternate_framing: z.ZodString;
+        change_kind: z.ZodLiteral<"disposable">;
+    }, z.core.$strict>, z.ZodObject<{
+        failure_mode: z.ZodString;
+        acceptance_evidence: z.ZodString;
+        alternate_framing: z.ZodString;
+        change_kind: z.ZodLiteral<"migration-escrow">;
+        expires_at: z.ZodISODateTime;
+        restoration_plan: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        failure_mode: z.ZodString;
+        acceptance_evidence: z.ZodString;
+        alternate_framing: z.ZodString;
+        change_kind: z.ZodLiteral<"break-glass">;
+        post_hoc_adr_deadline_at: z.ZodISODateTime;
+    }, z.core.$strict>], "change_kind">;
+    current_step: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "StepId", "out">>;
+    status: z.ZodEnum<{
+        complete: "complete";
+        stopped: "stopped";
+        handoff: "handoff";
+        in_progress: "in_progress";
+        aborted: "aborted";
+        escalated: "escalated";
+    }>;
+    steps: z.ZodArray<z.ZodObject<{
+        step_id: z.core.$ZodBranded<z.ZodString, "StepId", "out">;
+        status: z.ZodEnum<{
+            complete: "complete";
+            pending: "pending";
+            in_progress: "in_progress";
+            check_failed: "check_failed";
+            aborted: "aborted";
+        }>;
+        attempts: z.ZodNumber;
+        last_report_path: z.ZodOptional<z.ZodString>;
+        last_checkpoint_selection: z.ZodOptional<z.ZodString>;
+        last_route_taken: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    trace_entries_consumed: z.ZodNumber;
+    manifest_hash: z.ZodString;
+    updated_at: z.ZodISODateTime;
+}, z.core.$strict>;
+export type Snapshot = z.infer<typeof Snapshot>;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/schemas/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/schemas/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,UAAU;;;;;;EAA4E,CAAC;AACpG,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,eAAO,MAAM,SAAS;;;;;;;;;;;;;kBASX,CAAC;AACZ,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD,eAAO,MAAM,cAAc;;;;;;;EAOzB,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAeV,CAAC;AACZ,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC"}

package/dist/schemas/snapshot.js

@@ -0,0 +1,40 @@
+import { z } from 'zod';
+import { ChangeKindDeclaration } from './change-kind.js';
+import { CompiledFlowId, InvocationId, RunId, StepId } from './ids.js';
+import { CompiledDepth } from './process.js';
+export const StepStatus = z.enum(['pending', 'in_progress', 'check_failed', 'complete', 'aborted']);
+export const StepState = z
+    .object({
+    step_id: StepId,
+    status: StepStatus,
+    attempts: z.number().int().nonnegative(),
+    last_report_path: z.string().optional(),
+    last_checkpoint_selection: z.string().optional(),
+    last_route_taken: z.string().optional(),
+})
+    .strict();
+export const SnapshotStatus = z.enum([
+    'in_progress',
+    'complete',
+    'aborted',
+    'handoff',
+    'stopped',
+    'escalated',
+]);
+export const Snapshot = z
+    .object({
+    schema_version: z.literal(1),
+    run_id: RunId,
+    flow_id: CompiledFlowId,
+    invocation_id: InvocationId.optional(),
+    depth: CompiledDepth,
+    change_kind: ChangeKindDeclaration,
+    current_step: StepId.optional(),
+    status: SnapshotStatus,
+    steps: z.array(StepState),
+    trace_entries_consumed: z.number().int().nonnegative(),
+    manifest_hash: z.string().min(1),
+    updated_at: z.iso.datetime(),
+})
+    .strict();
+//# sourceMappingURL=snapshot.js.map

package/dist/schemas/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../src/schemas/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC;AAGpG,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC;KACvB,MAAM,CAAC;IACN,OAAO,EAAE,MAAM;IACf,MAAM,EAAE,UAAU;IAClB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACxC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACvC,yBAAyB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChD,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACxC,CAAC;KACD,MAAM,EAAE,CAAC;AAGZ,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC;IACnC,aAAa;IACb,UAAU;IACV,SAAS;IACT,SAAS;IACT,SAAS;IACT,WAAW;CACZ,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC;KACtB,MAAM,CAAC;IACN,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5B,MAAM,EAAE,KAAK;IACb,OAAO,EAAE,cAAc;IACvB,aAAa,EAAE,YAAY,CAAC,QAAQ,EAAE;IACtC,KAAK,EAAE,aAAa;IACpB,WAAW,EAAE,qBAAqB;IAClC,YAAY,EAAE,MAAM,CAAC,QAAQ,EAAE;IAC/B,MAAM,EAAE,cAAc;IACtB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC;IACzB,sBAAsB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACtD,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC,UAAU,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE;CAC7B,CAAC;KACD,MAAM,EAAE,CAAC"}