@deriest/ai-engineering-company 1.15.2

package/dist/metrics-registry.js

@@ -0,0 +1,195 @@
+// Metrics registry for AI Company operational observability.
+// In-memory with optional JSON file persistence.
+// All metrics must be explicitly declared at construction.
+import * as fs from "node:fs";
+import * as path from "node:path";
+const DEFAULT_HISTOGRAM_BUCKETS = [10, 50, 100, 250, 500, 1000, 2500, 5000, 10000, 30000];
+export class MetricsRegistry {
+    declarations = new Map();
+    counters = new Map();
+    gauges = new Map();
+    histograms = new Map();
+    timers = new Map();
+    filePath = null;
+    constructor(declarations) {
+        for (const decl of declarations) {
+            if (this.declarations.has(decl.name)) {
+                throw new Error(`Duplicate metric declaration: ${decl.name}`);
+            }
+            this.declarations.set(decl.name, decl);
+            switch (decl.type) {
+                case "counter":
+                    this.counters.set(decl.name, 0);
+                    break;
+                case "gauge":
+                    this.gauges.set(decl.name, 0);
+                    break;
+                case "histogram": {
+                    const buckets = decl.buckets ?? DEFAULT_HISTOGRAM_BUCKETS;
+                    this.histograms.set(decl.name, {
+                        buckets: [...buckets],
+                        counts: new Array(buckets.length + 1).fill(0),
+                        sum: 0,
+                        count: 0,
+                    });
+                    break;
+                }
+                case "timer":
+                    this.timers.set(decl.name, { count: 0, sum: 0, min: Infinity, max: -Infinity });
+                    break;
+            }
+        }
+    }
+    assertDeclared(name, expectedType) {
+        const decl = this.declarations.get(name);
+        if (!decl) {
+            throw new Error(`Unknown metric: ${name}`);
+        }
+        if (decl.type !== expectedType) {
+            throw new Error(`Metric ${name} is type ${decl.type}, not ${expectedType}`);
+        }
+    }
+    increment(name, value = 1) {
+        this.assertDeclared(name, "counter");
+        const current = this.counters.get(name);
+        this.counters.set(name, current + value);
+    }
+    gauge(name, value) {
+        this.assertDeclared(name, "gauge");
+        this.gauges.set(name, value);
+    }
+    observe(name, value) {
+        this.assertDeclared(name, "histogram");
+        const hist = this.histograms.get(name);
+        hist.count++;
+        hist.sum += value;
+        let placed = false;
+        for (let i = 0; i < hist.buckets.length; i++) {
+            if (value <= hist.buckets[i]) {
+                hist.counts[i]++;
+                placed = true;
+                break;
+            }
+        }
+        if (!placed) {
+            hist.counts[hist.buckets.length]++; // +Inf bucket
+        }
+    }
+    startTimer(name) {
+        this.assertDeclared(name, "timer");
+        const start = Date.now();
+        return () => {
+            const elapsed = Date.now() - start;
+            const timer = this.timers.get(name);
+            timer.count++;
+            timer.sum += elapsed;
+            if (elapsed < timer.min)
+                timer.min = elapsed;
+            if (elapsed > timer.max)
+                timer.max = elapsed;
+        };
+    }
+    getSnapshot() {
+        const counters = {};
+        for (const [k, v] of this.counters)
+            counters[k] = v;
+        const gauges = {};
+        for (const [k, v] of this.gauges)
+            gauges[k] = v;
+        const histograms = {};
+        for (const [k, v] of this.histograms)
+            histograms[k] = { ...v, counts: [...v.counts] };
+        const timers = {};
+        for (const [k, v] of this.timers)
+            timers[k] = { ...v };
+        return { counters, gauges, histograms, timers };
+    }
+    toJSON() {
+        return JSON.stringify(this.getSnapshot(), null, 2) + "\n";
+    }
+    /**
+     * Load persisted counters, histograms, and timers from JSON.
+     * Gauges are NOT restored — they must be recomputed from live state.
+     */
+    loadFromJSON(json) {
+        try {
+            const snapshot = JSON.parse(json);
+            if (snapshot.counters) {
+                for (const [k, v] of Object.entries(snapshot.counters)) {
+                    if (this.counters.has(k)) {
+                        this.counters.set(k, v);
+                    }
+                }
+            }
+            if (snapshot.histograms) {
+                for (const [k, v] of Object.entries(snapshot.histograms)) {
+                    if (this.histograms.has(k)) {
+                        this.histograms.set(k, { buckets: v.buckets, counts: [...v.counts], sum: v.sum, count: v.count });
+                    }
+                }
+            }
+            if (snapshot.timers) {
+                for (const [k, v] of Object.entries(snapshot.timers)) {
+                    if (this.timers.has(k)) {
+                        this.timers.set(k, { count: v.count, sum: v.sum, min: v.min, max: v.max });
+                    }
+                }
+            }
+            // Gauges intentionally NOT restored — recomputed from live state
+        }
+        catch {
+            // Corrupt file — start with fresh values
+        }
+    }
+    /**
+     * Load from a JSON file. Gracefully handles missing or corrupt files.
+     */
+    load(filePath) {
+        this.filePath = filePath;
+        try {
+            const raw = fs.readFileSync(filePath, "utf-8");
+            this.loadFromJSON(raw);
+        }
+        catch {
+            // Missing or corrupt file — start with fresh values
+        }
+    }
+    /**
+     * Save current snapshot to the configured file path. Atomic write (.tmp + rename).
+     */
+    save(filePath) {
+        const target = filePath ?? this.filePath;
+        if (!target)
+            return;
+        const tmpPath = target + ".tmp";
+        try {
+            fs.mkdirSync(path.dirname(target), { recursive: true });
+            fs.writeFileSync(tmpPath, this.toJSON(), "utf-8");
+            fs.renameSync(tmpPath, target);
+        }
+        catch {
+            // Persistence failure — metrics remain functional in-memory
+        }
+    }
+    /** Reset all metrics to initial values. Declarations are preserved. */
+    reset() {
+        for (const [k] of this.counters)
+            this.counters.set(k, 0);
+        for (const [k] of this.gauges)
+            this.gauges.set(k, 0);
+        for (const [k, decl] of this.declarations) {
+            if (decl.type === "histogram") {
+                const buckets = decl.buckets ?? DEFAULT_HISTOGRAM_BUCKETS;
+                this.histograms.set(k, {
+                    buckets: [...buckets],
+                    counts: new Array(buckets.length + 1).fill(0),
+                    sum: 0,
+                    count: 0,
+                });
+            }
+        }
+        for (const [k] of this.timers)
+            this.timers.set(k, { count: 0, sum: 0, min: Infinity, max: -Infinity });
+    }
+}
+//# sourceMappingURL=metrics-registry.js.map

package/dist/metrics-registry.js.map

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

package/dist/openclaw.plugin.json

@@ -0,0 +1,29 @@
+{
+    "id": "ai-engineering-company",
+    "name": "AI Engineering Company",
+    "version": "1.0.0",
+    "description": "Orchestrates AI agents to handle engineering tasks with human oversight.",
+    "kind": "tool",
+    "entry": "./dist/index.js",
+    "configSchema": {
+        "type": "object",
+        "properties": {
+            "offices": {
+                "type": "string",
+                "description": "Path to offices.json config"
+            },
+            "workflows": {
+                "type": "string",
+                "description": "Path to workflows.json config"
+            },
+            "workers": {
+                "type": "string",
+                "description": "Path to workers directory"
+            },
+            "boardId": {
+                "type": "string",
+                "description": "Workboard board ID for task cards (default: ai-company)"
+            }
+        }
+    }
+}

package/dist/org-engine.d.ts

@@ -0,0 +1,134 @@
+import { z } from "zod";
+export declare const OfficeSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    description: string;
+}, {
+    id: string;
+    name: string;
+    description: string;
+}>;
+export declare const OfficesConfigSchema: z.ZodObject<{
+    offices: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name: string;
+        description: string;
+    }, {
+        id: string;
+        name: string;
+        description: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    offices: {
+        id: string;
+        name: string;
+        description: string;
+    }[];
+}, {
+    offices: {
+        id: string;
+        name: string;
+        description: string;
+    }[];
+}>;
+export type Office = z.infer<typeof OfficeSchema>;
+declare const RoleSchema: z.ZodObject<{
+    office: z.ZodString;
+    capabilities: z.ZodArray<z.ZodString, "many">;
+    decision_authority: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>;
+    specializations: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    office: string;
+    capabilities: string[];
+    decision_authority: Record<string, string[]>;
+    specializations: string[];
+}, {
+    office: string;
+    capabilities: string[];
+    decision_authority: Record<string, string[]>;
+    specializations: string[];
+}>;
+declare const WorkerSchema: z.ZodObject<{
+    role: z.ZodString;
+    office: z.ZodNullable<z.ZodString>;
+    model: z.ZodString;
+    tools: z.ZodString;
+    responsibility: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    office: string | null;
+    role: string;
+    model: string;
+    tools: string;
+    responsibility: string;
+}, {
+    office: string | null;
+    role: string;
+    model: string;
+    tools: string;
+    responsibility: string;
+}>;
+declare const CollaborationPairSchema: z.ZodObject<{
+    from: z.ZodString;
+    to: z.ZodString;
+    on: z.ZodString;
+    bidirectional: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    from: string;
+    to: string;
+    on: string;
+    bidirectional: boolean;
+}, {
+    from: string;
+    to: string;
+    on: string;
+    bidirectional: boolean;
+}>;
+declare const EscalationTriggerSchema: z.ZodObject<{
+    trigger: z.ZodString;
+    worker: z.ZodString;
+    escalate_to: z.ZodString;
+    then: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    worker: string;
+    trigger: string;
+    escalate_to: string;
+    then?: string | undefined;
+}, {
+    worker: string;
+    trigger: string;
+    escalate_to: string;
+    then?: string | undefined;
+}>;
+export type Role = z.infer<typeof RoleSchema>;
+export type OrgWorker = z.infer<typeof WorkerSchema>;
+export type CollaborationPair = z.infer<typeof CollaborationPairSchema>;
+export type EscalationTrigger = z.infer<typeof EscalationTriggerSchema>;
+export declare class OrgEngine {
+    private configPath;
+    private orgPath?;
+    private offices;
+    private roles;
+    private workers;
+    private collaborationPairs;
+    private escalationTriggers;
+    constructor(configPath: string, orgPath?: string | undefined);
+    load(): Promise<void>;
+    getOffice(id: string): Office | undefined;
+    getOffices(): Office[];
+    getRoles(): Role[];
+    getRole(name: string): Role | undefined;
+    getWorkers(): OrgWorker[];
+    getWorker(name: string): OrgWorker | undefined;
+    getCollaborationPairs(): CollaborationPair[];
+    getEscalationRules(): EscalationTrigger[];
+}
+export {};
+//# sourceMappingURL=org-engine.d.ts.map

package/dist/org-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"org-engine.d.ts","sourceRoot":"","sources":["../src/org-engine.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,YAAY;;;;;;;;;;;;EAIvB,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;EAE9B,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD,QAAA,MAAM,UAAU;;;;;;;;;;;;;;;EAKd,CAAC;AAEH,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;EAMhB,CAAC;AAEH,QAAA,MAAM,uBAAuB;;;;;;;;;;;;;;;EAK3B,CAAC;AAEH,QAAA,MAAM,uBAAuB;;;;;;;;;;;;;;;EAK3B,CAAC;AAEH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAC9C,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AACrD,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,qBAAa,SAAS;IAQlB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,OAAO,CAAC;IARlB,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,kBAAkB,CAA2B;IACrD,OAAO,CAAC,kBAAkB,CAA2B;gBAG3C,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,YAAA;IAGpB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA4D3B,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIzC,UAAU,IAAI,MAAM,EAAE;IAItB,QAAQ,IAAI,IAAI,EAAE;IAIlB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIvC,UAAU,IAAI,SAAS,EAAE;IAIzB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI9C,qBAAqB,IAAI,iBAAiB,EAAE;IAI5C,kBAAkB,IAAI,iBAAiB,EAAE;CAG1C"}

package/dist/org-engine.js

@@ -0,0 +1,129 @@
+import * as fs from "fs/promises";
+import { z } from "zod";
+export const OfficeSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    description: z.string(),
+});
+export const OfficesConfigSchema = z.object({
+    offices: z.array(OfficeSchema),
+});
+const RoleSchema = z.object({
+    office: z.string(),
+    capabilities: z.array(z.string()),
+    decision_authority: z.record(z.array(z.string())),
+    specializations: z.array(z.string()),
+});
+const WorkerSchema = z.object({
+    role: z.string(),
+    office: z.string().nullable(),
+    model: z.string(),
+    tools: z.string(),
+    responsibility: z.string(),
+});
+const CollaborationPairSchema = z.object({
+    from: z.string(),
+    to: z.string(),
+    on: z.string(),
+    bidirectional: z.boolean(),
+});
+const EscalationTriggerSchema = z.object({
+    trigger: z.string(),
+    worker: z.string(),
+    escalate_to: z.string(),
+    then: z.string().optional(),
+});
+export class OrgEngine {
+    configPath;
+    orgPath;
+    offices = new Map();
+    roles = new Map();
+    workers = new Map();
+    collaborationPairs = [];
+    escalationTriggers = [];
+    constructor(configPath, orgPath) {
+        this.configPath = configPath;
+        this.orgPath = orgPath;
+    }
+    async load() {
+        // Load offices (existing behavior)
+        try {
+            const data = await fs.readFile(this.configPath, "utf-8");
+            const parsed = OfficesConfigSchema.parse(JSON.parse(data));
+            this.offices.clear();
+            for (const office of parsed.offices) {
+                this.offices.set(office.id, office);
+            }
+        }
+        catch (e) {
+            if (e.code !== "ENOENT") {
+                throw e;
+            }
+        }
+        // Load organization.json if path provided
+        if (this.orgPath) {
+            try {
+                const data = await fs.readFile(this.orgPath, "utf-8");
+                const parsed = JSON.parse(data);
+                // Roles
+                this.roles.clear();
+                if (parsed.roles) {
+                    for (const [name, role] of Object.entries(parsed.roles)) {
+                        this.roles.set(name, RoleSchema.parse(role));
+                    }
+                }
+                // Workers
+                this.workers.clear();
+                if (parsed.workers) {
+                    for (const [name, worker] of Object.entries(parsed.workers)) {
+                        this.workers.set(name, WorkerSchema.parse(worker));
+                    }
+                }
+                // Collaboration pairs
+                this.collaborationPairs = [];
+                if (parsed.agent_collaboration?.pairs) {
+                    this.collaborationPairs = z
+                        .array(CollaborationPairSchema)
+                        .parse(parsed.agent_collaboration.pairs);
+                }
+                // Escalation triggers
+                this.escalationTriggers = [];
+                if (parsed.escalation?.triggers) {
+                    this.escalationTriggers = z
+                        .array(EscalationTriggerSchema)
+                        .parse(parsed.escalation.triggers);
+                }
+            }
+            catch (e) {
+                if (e.code !== "ENOENT") {
+                    throw e;
+                }
+            }
+        }
+    }
+    getOffice(id) {
+        return this.offices.get(id);
+    }
+    getOffices() {
+        return Array.from(this.offices.values());
+    }
+    getRoles() {
+        return Array.from(this.roles.values());
+    }
+    getRole(name) {
+        return this.roles.get(name);
+    }
+    getWorkers() {
+        return Array.from(this.workers.values());
+    }
+    getWorker(name) {
+        return this.workers.get(name);
+    }
+    getCollaborationPairs() {
+        return this.collaborationPairs;
+    }
+    getEscalationRules() {
+        return this.escalationTriggers;
+    }
+}
+//# sourceMappingURL=org-engine.js.map

package/dist/org-engine.js.map

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

package/dist/pipeline-checkpoint.d.ts

@@ -0,0 +1,44 @@
+export interface PipelineCheckpointEntry {
+    sessionKey: string;
+    objective: string;
+    category: string;
+    currentStageIndex: number;
+    stageCount: number;
+    stages: Array<{
+        stage: string;
+        worker: string;
+        requiresApproval?: boolean;
+    }>;
+    history: Array<{
+        stage: string;
+        worker: string;
+        output: string;
+    }>;
+    status: "running" | "awaiting_approval" | "completed" | "failed";
+    decidedBy?: string;
+    startedAt: number;
+    updatedAt: number;
+    error?: string;
+}
+export declare class PipelineCheckpoint {
+    private readonly checkpoints;
+    private filePath;
+    /** Create or update a checkpoint. */
+    set(entry: PipelineCheckpointEntry): void;
+    /** Mark checkpoint as completed and remove it. */
+    complete(sessionKey: string): void;
+    /** Mark checkpoint as failed and persist the failure. */
+    fail(sessionKey: string, error: string): void;
+    /** Get a checkpoint by session key. */
+    get(sessionKey: string): PipelineCheckpointEntry | undefined;
+    /** List all checkpoints, optionally filtered by status. */
+    list(status?: PipelineCheckpointEntry["status"]): PipelineCheckpointEntry[];
+    /** Load checkpoints from a JSON file. No-op if file is missing or corrupt. */
+    load(filePath: string): void;
+    /** Persist active checkpoints to the configured file path. Atomic write. */
+    save(filePath?: string): void;
+    private trySave;
+    /** Remove failed/completed checkpoints older than maxAgeMs. Running and awaiting_approval are preserved. */
+    cleanup(maxAgeMs: number): number;
+}
+//# sourceMappingURL=pipeline-checkpoint.d.ts.map

package/dist/pipeline-checkpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-checkpoint.d.ts","sourceRoot":"","sources":["../src/pipeline-checkpoint.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC7E,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClE,MAAM,EAAE,SAAS,GAAG,mBAAmB,GAAG,WAAW,GAAG,QAAQ,CAAC;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA8C;IAC1E,OAAO,CAAC,QAAQ,CAAuB;IAEvC,qCAAqC;IACrC,GAAG,CAAC,KAAK,EAAE,uBAAuB,GAAG,IAAI;IAKzC,kDAAkD;IAClD,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAKlC,yDAAyD;IACzD,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAU7C,uCAAuC;IACvC,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS;IAI5D,2DAA2D;IAC3D,IAAI,CAAC,MAAM,CAAC,EAAE,uBAAuB,CAAC,QAAQ,CAAC,GAAG,uBAAuB,EAAE;IAK3E,8EAA8E;IAC9E,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAgB5B,4EAA4E;IAC5E,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAc7B,OAAO,CAAC,OAAO;IAIf,4GAA4G;IAC5G,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;CAclC"}

package/dist/pipeline-checkpoint.js

@@ -0,0 +1,90 @@
+// Pipeline checkpoint persistence for runtime recovery.
+import * as fs from "node:fs";
+import * as path from "node:path";
+export class PipelineCheckpoint {
+    checkpoints = new Map();
+    filePath = null;
+    /** Create or update a checkpoint. */
+    set(entry) {
+        this.checkpoints.set(entry.sessionKey, { ...entry, updatedAt: Date.now() });
+        this.trySave();
+    }
+    /** Mark checkpoint as completed and remove it. */
+    complete(sessionKey) {
+        const result = this.checkpoints.delete(sessionKey);
+        if (result)
+            this.trySave();
+    }
+    /** Mark checkpoint as failed and persist the failure. */
+    fail(sessionKey, error) {
+        const entry = this.checkpoints.get(sessionKey);
+        if (entry) {
+            entry.status = "failed";
+            entry.error = error;
+            entry.updatedAt = Date.now();
+            this.trySave();
+        }
+    }
+    /** Get a checkpoint by session key. */
+    get(sessionKey) {
+        return this.checkpoints.get(sessionKey);
+    }
+    /** List all checkpoints, optionally filtered by status. */
+    list(status) {
+        const all = [...this.checkpoints.values()];
+        return status ? all.filter((c) => c.status === status) : all;
+    }
+    /** Load checkpoints from a JSON file. No-op if file is missing or corrupt. */
+    load(filePath) {
+        this.filePath = filePath;
+        try {
+            const raw = fs.readFileSync(filePath, "utf-8");
+            const parsed = JSON.parse(raw);
+            if (!Array.isArray(parsed))
+                return;
+            for (const entry of parsed) {
+                if (entry && typeof entry.sessionKey === "string" && entry.status !== "completed" && entry.status !== "failed") {
+                    this.checkpoints.set(entry.sessionKey, entry);
+                }
+            }
+        }
+        catch {
+            // Missing or corrupt file — start with empty state
+        }
+    }
+    /** Persist active checkpoints to the configured file path. Atomic write. */
+    save(filePath) {
+        const target = filePath ?? this.filePath;
+        if (!target)
+            return;
+        const active = [...this.checkpoints.values()].filter((c) => c.status !== "completed" && c.status !== "failed");
+        const tmpPath = target + ".tmp";
+        try {
+            fs.mkdirSync(path.dirname(target), { recursive: true });
+            fs.writeFileSync(tmpPath, JSON.stringify(active, null, 2) + "\n", "utf-8");
+            fs.renameSync(tmpPath, target);
+        }
+        catch {
+            // Persistence failure — checkpoints remain functional in-memory
+        }
+    }
+    trySave() {
+        this.save();
+    }
+    /** Remove failed/completed checkpoints older than maxAgeMs. Running and awaiting_approval are preserved. */
+    cleanup(maxAgeMs) {
+        const now = Date.now();
+        let removed = 0;
+        for (const [key, entry] of this.checkpoints) {
+            if ((entry.status === "failed" || entry.status === "completed") && now - entry.updatedAt > maxAgeMs) {
+                this.checkpoints.delete(key);
+                removed++;
+            }
+        }
+        if (removed > 0) {
+            this.trySave();
+        }
+        return removed;
+    }
+}
+//# sourceMappingURL=pipeline-checkpoint.js.map

package/dist/pipeline-checkpoint.js.map

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