@soleri/core 7.0.0 → 8.0.0

package/dist/queue/job-queue.js

@@ -0,0 +1,180 @@
+/**
+ * Job Queue — SQLite-backed FIFO queue with DAG dependencies and retries.
+ *
+ * Generic infrastructure — not curator-specific. Reusable by agency, intake, etc.
+ *
+ * Features:
+ * - Persistent jobs (survive process restarts)
+ * - DAG dependency resolution (job B waits for job A)
+ * - Pipeline grouping (group related jobs under one ID)
+ * - Configurable retries with max limit
+ * - Status tracking: pending → running → completed | failed
+ */
+import { randomUUID } from 'node:crypto';
+// ─── Class ───────────────────────────────────────────────────────────
+export class JobQueue {
+    provider;
+    constructor(provider) {
+        this.provider = provider;
+        this.initializeTable();
+    }
+    initializeTable() {
+        this.provider.execSql(`
+      CREATE TABLE IF NOT EXISTS job_queue (
+        id TEXT PRIMARY KEY,
+        type TEXT NOT NULL,
+        status TEXT NOT NULL DEFAULT 'pending',
+        entry_id TEXT,
+        payload TEXT DEFAULT '{}',
+        depends_on TEXT DEFAULT '[]',
+        pipeline_id TEXT,
+        retry_count INTEGER DEFAULT 0,
+        max_retries INTEGER DEFAULT 3,
+        result TEXT,
+        error TEXT,
+        created_at TEXT NOT NULL DEFAULT (datetime('now')),
+        started_at TEXT,
+        completed_at TEXT
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_job_queue_status ON job_queue(status);
+      CREATE INDEX IF NOT EXISTS idx_job_queue_pipeline ON job_queue(pipeline_id);
+    `);
+    }
+    /**
+     * Enqueue a new job. Returns the job ID.
+     */
+    enqueue(type, options) {
+        const id = randomUUID().slice(0, 12);
+        this.provider.run(`INSERT INTO job_queue (id, type, entry_id, payload, depends_on, pipeline_id, max_retries)
+       VALUES (?, ?, ?, ?, ?, ?, ?)`, [
+            id,
+            type,
+            options?.entryId ?? null,
+            JSON.stringify(options?.payload ?? {}),
+            JSON.stringify(options?.dependsOn ?? []),
+            options?.pipelineId ?? null,
+            options?.maxRetries ?? 3,
+        ]);
+        return id;
+    }
+    /**
+     * Dequeue the oldest pending job with all dependencies completed.
+     * Marks it as running. Returns null if no ready jobs.
+     */
+    dequeue() {
+        const ready = this.dequeueReady(1);
+        return ready.length > 0 ? ready[0] : null;
+    }
+    /**
+     * Dequeue up to `limit` pending jobs whose dependencies are all completed.
+     */
+    dequeueReady(limit = 10) {
+        const rows = this.provider.all("SELECT * FROM job_queue WHERE status = 'pending' ORDER BY created_at ASC LIMIT ?", [limit * 3]);
+        const ready = [];
+        for (const row of rows) {
+            if (ready.length >= limit)
+                break;
+            const deps = JSON.parse(row.depends_on);
+            if (deps.length === 0 || this.allDepsCompleted(deps)) {
+                this.provider.run("UPDATE job_queue SET status = 'running', started_at = datetime('now') WHERE id = ?", [row.id]);
+                const job = rowToJob(row);
+                job.status = 'running';
+                ready.push(job);
+            }
+        }
+        return ready;
+    }
+    /**
+     * Mark a job as completed with an optional result.
+     */
+    complete(jobId, result) {
+        this.provider.run("UPDATE job_queue SET status = 'completed', completed_at = datetime('now'), result = ? WHERE id = ?", [result !== undefined ? JSON.stringify(result) : null, jobId]);
+    }
+    /**
+     * Mark a job as failed with an error message.
+     */
+    fail(jobId, error) {
+        this.provider.run("UPDATE job_queue SET status = 'failed', completed_at = datetime('now'), error = ? WHERE id = ?", [error, jobId]);
+    }
+    /**
+     * Retry a failed job (resets to pending). Returns false if max retries exceeded.
+     */
+    retry(jobId) {
+        const row = this.provider.get('SELECT * FROM job_queue WHERE id = ?', [jobId]);
+        if (!row)
+            return false;
+        if (row.retry_count >= row.max_retries)
+            return false;
+        this.provider.run("UPDATE job_queue SET status = 'pending', retry_count = retry_count + 1, error = NULL, started_at = NULL, completed_at = NULL WHERE id = ?", [jobId]);
+        return true;
+    }
+    /**
+     * Get queue statistics.
+     */
+    getStats() {
+        const rows = this.provider.all('SELECT status, COUNT(*) as count FROM job_queue GROUP BY status');
+        const byStatus = {};
+        let total = 0;
+        for (const row of rows) {
+            byStatus[row.status] = row.count;
+            total += row.count;
+        }
+        return {
+            pending: byStatus['pending'] ?? 0,
+            running: byStatus['running'] ?? 0,
+            completed: byStatus['completed'] ?? 0,
+            failed: byStatus['failed'] ?? 0,
+            total,
+        };
+    }
+    /**
+     * Get all jobs for a pipeline.
+     */
+    getByPipeline(pipelineId) {
+        const rows = this.provider.all('SELECT * FROM job_queue WHERE pipeline_id = ? ORDER BY created_at ASC', [pipelineId]);
+        return rows.map(rowToJob);
+    }
+    /**
+     * Get a single job by ID.
+     */
+    get(jobId) {
+        const row = this.provider.get('SELECT * FROM job_queue WHERE id = ?', [jobId]);
+        return row ? rowToJob(row) : null;
+    }
+    /**
+     * Purge completed/failed jobs older than N days.
+     */
+    purge(olderThanDays = 30) {
+        const result = this.provider.run("DELETE FROM job_queue WHERE status IN ('completed', 'failed') AND completed_at < datetime('now', ?)", [`-${olderThanDays} days`]);
+        return result.changes;
+    }
+    // ─── Internal ──────────────────────────────────────────────────────
+    allDepsCompleted(deps) {
+        for (const depId of deps) {
+            const row = this.provider.get('SELECT status FROM job_queue WHERE id = ?', [depId]);
+            if (!row || row.status !== 'completed')
+                return false;
+        }
+        return true;
+    }
+}
+function rowToJob(row) {
+    return {
+        id: row.id,
+        type: row.type,
+        status: row.status,
+        entryId: row.entry_id,
+        payload: JSON.parse(row.payload),
+        dependsOn: JSON.parse(row.depends_on),
+        pipelineId: row.pipeline_id,
+        retryCount: row.retry_count,
+        maxRetries: row.max_retries,
+        result: row.result ? JSON.parse(row.result) : null,
+        error: row.error,
+        createdAt: row.created_at,
+        startedAt: row.started_at,
+        completedAt: row.completed_at,
+    };
+}
+//# sourceMappingURL=job-queue.js.map

package/dist/queue/job-queue.js.map

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

package/dist/queue/pipeline-runner.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Pipeline Runner — background polling loop for DAG job execution.
+ *
+ * Polls the job queue for ready jobs (dependencies completed),
+ * dispatches them to registered handlers, and marks them complete/failed.
+ *
+ * Generic — handlers are registered by type, any module can add its own.
+ */
+import type { JobQueue, Job } from './job-queue.js';
+export type JobHandler = (job: Job) => Promise<unknown>;
+export interface PipelineRunnerStatus {
+    running: boolean;
+    pollIntervalMs: number;
+    tickCount: number;
+    jobsProcessed: number;
+    jobsFailed: number;
+    jobsRetried: number;
+    lastTickAt: string | null;
+}
+export declare class PipelineRunner {
+    private queue;
+    private handlers;
+    private pollIntervalMs;
+    private running;
+    private timer;
+    private tickCount;
+    private jobsProcessed;
+    private jobsFailed;
+    private jobsRetried;
+    private lastTickAt;
+    private processing;
+    constructor(queue: JobQueue, pollIntervalMs?: number);
+    /**
+     * Register a handler for a job type. When a job of this type is dequeued,
+     * the handler is called. Return value is stored as the job result.
+     */
+    registerHandler(type: string, handler: JobHandler): void;
+    /**
+     * Start background polling. Idempotent — calling start() twice is safe.
+     */
+    start(): void;
+    /**
+     * Stop background polling.
+     */
+    stop(): void;
+    /**
+     * Process one batch of ready jobs immediately (without waiting for poll).
+     * Useful for testing or manual triggering.
+     */
+    processOnce(batchSize?: number): Promise<number>;
+    /**
+     * Get runner status.
+     */
+    getStatus(): PipelineRunnerStatus;
+    /**
+     * Check if a handler is registered for a job type.
+     */
+    hasHandler(type: string): boolean;
+    private tick;
+    private processBatch;
+}
+//# sourceMappingURL=pipeline-runner.d.ts.map

package/dist/queue/pipeline-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-runner.d.ts","sourceRoot":"","sources":["../../src/queue/pipeline-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAIpD,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAExD,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAID,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,UAAU,CAAS;gBAEf,KAAK,EAAE,QAAQ,EAAE,cAAc,GAAE,MAAa;IAK1D;;;OAGG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI;IAIxD;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,IAAI,IAAI,IAAI;IAQZ;;;OAGG;IACG,WAAW,CAAC,SAAS,GAAE,MAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAIzD;;OAEG;IACH,SAAS,IAAI,oBAAoB;IAYjC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAMjC,OAAO,CAAC,IAAI;YASE,YAAY;CAkC3B"}

package/dist/queue/pipeline-runner.js

@@ -0,0 +1,126 @@
+/**
+ * Pipeline Runner — background polling loop for DAG job execution.
+ *
+ * Polls the job queue for ready jobs (dependencies completed),
+ * dispatches them to registered handlers, and marks them complete/failed.
+ *
+ * Generic — handlers are registered by type, any module can add its own.
+ */
+// ─── Class ───────────────────────────────────────────────────────────
+export class PipelineRunner {
+    queue;
+    handlers = new Map();
+    pollIntervalMs;
+    running = false;
+    timer = null;
+    tickCount = 0;
+    jobsProcessed = 0;
+    jobsFailed = 0;
+    jobsRetried = 0;
+    lastTickAt = null;
+    processing = false;
+    constructor(queue, pollIntervalMs = 5000) {
+        this.queue = queue;
+        this.pollIntervalMs = pollIntervalMs;
+    }
+    /**
+     * Register a handler for a job type. When a job of this type is dequeued,
+     * the handler is called. Return value is stored as the job result.
+     */
+    registerHandler(type, handler) {
+        this.handlers.set(type, handler);
+    }
+    /**
+     * Start background polling. Idempotent — calling start() twice is safe.
+     */
+    start() {
+        if (this.running)
+            return;
+        this.running = true;
+        this.timer = setInterval(() => this.tick(), this.pollIntervalMs);
+    }
+    /**
+     * Stop background polling.
+     */
+    stop() {
+        this.running = false;
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+    /**
+     * Process one batch of ready jobs immediately (without waiting for poll).
+     * Useful for testing or manual triggering.
+     */
+    async processOnce(batchSize = 5) {
+        return this.processBatch(batchSize);
+    }
+    /**
+     * Get runner status.
+     */
+    getStatus() {
+        return {
+            running: this.running,
+            pollIntervalMs: this.pollIntervalMs,
+            tickCount: this.tickCount,
+            jobsProcessed: this.jobsProcessed,
+            jobsFailed: this.jobsFailed,
+            jobsRetried: this.jobsRetried,
+            lastTickAt: this.lastTickAt,
+        };
+    }
+    /**
+     * Check if a handler is registered for a job type.
+     */
+    hasHandler(type) {
+        return this.handlers.has(type);
+    }
+    // ─── Internal ──────────────────────────────────────────────────────
+    tick() {
+        if (this.processing)
+            return; // Skip if previous tick still running
+        this.tickCount++;
+        this.lastTickAt = new Date().toISOString();
+        this.processBatch(5).catch(() => {
+            /* best-effort */
+        });
+    }
+    async processBatch(batchSize) {
+        this.processing = true;
+        let processed = 0;
+        try {
+            const jobs = this.queue.dequeueReady(batchSize);
+            for (const job of jobs) {
+                const handler = this.handlers.get(job.type);
+                if (!handler) {
+                    this.queue.fail(job.id, `No handler registered for job type: ${job.type}`);
+                    this.jobsFailed++;
+                    continue;
+                }
+                try {
+                    const result = await handler(job);
+                    this.queue.complete(job.id, result);
+                    this.jobsProcessed++;
+                    processed++;
+                }
+                catch (err) {
+                    const errorMsg = err instanceof Error ? err.message : String(err);
+                    const retried = this.queue.retry(job.id);
+                    if (retried) {
+                        this.jobsRetried++;
+                    }
+                    else {
+                        this.queue.fail(job.id, errorMsg);
+                        this.jobsFailed++;
+                    }
+                }
+            }
+        }
+        finally {
+            this.processing = false;
+        }
+        return processed;
+    }
+}
+//# sourceMappingURL=pipeline-runner.js.map

package/dist/queue/pipeline-runner.js.map

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

package/dist/runtime/admin-setup-ops.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Admin setup operations — 4 ops for agent self-installation.
+ *
+ * inject_claude_md: Inject agent sections into CLAUDE.md
+ * admin_setup_global: Install hooks + skills + settings.json lifecycle hooks
+ * admin_setup_project: Project-level hook management (analyze/cleanup/install)
+ * admin_check_persistence: Diagnostic — check plan/task/check storage status
+ *
+ * Ported from Salvador MCP. Key adaptations:
+ *   - Runtime-config-driven (no vault manifest dependency)
+ *   - Agent-scoped markers for multi-agent coexistence
+ *   - OpDefinition[] pattern (not standalone tool files)
+ */
+import type { OpDefinition } from '../facades/types.js';
+import type { AgentRuntime } from './types.js';
+/**
+ * Create 4 admin setup operations.
+ */
+export declare function createAdminSetupOps(runtime: AgentRuntime): OpDefinition[];
+//# sourceMappingURL=admin-setup-ops.d.ts.map

package/dist/runtime/admin-setup-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-setup-ops.d.ts","sourceRoot":"","sources":["../../src/runtime/admin-setup-ops.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAeH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAwM/C;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,EAAE,CAgbzE"}