@soleri/core 7.0.0 → 8.0.0

package/dist/flows/chain-runner.js

@@ -0,0 +1,271 @@
+/**
+ * Chain Runner — executes multi-step workflows with data flow between steps.
+ *
+ * Steps call facade ops via a dispatch function. Each step's output is stored
+ * in a context object and can be referenced by subsequent steps via $variable syntax.
+ *
+ * Gates pause execution. Resume via approve(). State persists to SQLite.
+ */
+import { randomUUID } from 'node:crypto';
+// ─── Class ───────────────────────────────────────────────────────────
+export class ChainRunner {
+    provider;
+    constructor(provider) {
+        this.provider = provider;
+        this.initializeTable();
+    }
+    initializeTable() {
+        this.provider.execSql(`
+      CREATE TABLE IF NOT EXISTS chain_instances (
+        id TEXT PRIMARY KEY,
+        chain_id TEXT NOT NULL,
+        chain_name TEXT NOT NULL DEFAULT '',
+        status TEXT NOT NULL DEFAULT 'running',
+        current_step TEXT,
+        paused_at_gate TEXT,
+        input TEXT NOT NULL DEFAULT '{}',
+        context TEXT NOT NULL DEFAULT '{}',
+        step_outputs TEXT NOT NULL DEFAULT '[]',
+        steps_completed INTEGER NOT NULL DEFAULT 0,
+        total_steps INTEGER NOT NULL DEFAULT 0,
+        created_at TEXT NOT NULL DEFAULT (datetime('now')),
+        updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+      );
+    `);
+    }
+    /**
+     * Execute a chain from the beginning (or a specific step).
+     */
+    async execute(chainDef, input, dispatch, gateCheck, startFromStep) {
+        const instanceId = randomUUID().slice(0, 12);
+        const instance = {
+            id: instanceId,
+            chainId: chainDef.id,
+            chainName: chainDef.name ?? chainDef.id,
+            status: 'running',
+            currentStep: null,
+            pausedAtGate: null,
+            input,
+            context: { input },
+            stepOutputs: [],
+            stepsCompleted: 0,
+            totalSteps: chainDef.steps.length,
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+        };
+        this.persist(instance);
+        // Find start index
+        let startIdx = 0;
+        if (startFromStep) {
+            const idx = chainDef.steps.findIndex((s) => s.id === startFromStep);
+            if (idx >= 0)
+                startIdx = idx;
+        }
+        return this.runSteps(chainDef, instance, dispatch, gateCheck, startIdx);
+    }
+    /**
+     * Resume a paused chain from where it left off.
+     */
+    async resume(instanceId, chainDef, dispatch, gateCheck) {
+        const instance = this.getInstance(instanceId);
+        if (!instance)
+            throw new Error(`Chain instance not found: ${instanceId}`);
+        if (instance.status !== 'paused')
+            throw new Error(`Chain is ${instance.status}, not paused`);
+        // Find the step after the paused gate
+        const pausedStep = instance.pausedAtGate;
+        if (!pausedStep)
+            throw new Error('No paused gate to resume from');
+        const stepIdx = chainDef.steps.findIndex((s) => s.id === pausedStep);
+        if (stepIdx < 0)
+            throw new Error(`Paused step ${pausedStep} not found in chain def`);
+        // Mark step as approved, move to next
+        instance.status = 'running';
+        instance.pausedAtGate = null;
+        this.persist(instance);
+        return this.runSteps(chainDef, instance, dispatch, gateCheck, stepIdx + 1);
+    }
+    /**
+     * Approve a gate-paused step and resume the chain.
+     */
+    async approve(instanceId, chainDef, dispatch, gateCheck) {
+        return this.resume(instanceId, chainDef, dispatch, gateCheck);
+    }
+    /**
+     * Get chain instance status.
+     */
+    getInstance(instanceId) {
+        const row = this.provider.get('SELECT * FROM chain_instances WHERE id = ?', [
+            instanceId,
+        ]);
+        return row ? rowToInstance(row) : null;
+    }
+    /**
+     * List all chain instances.
+     */
+    list(limit = 20) {
+        const rows = this.provider.all('SELECT * FROM chain_instances ORDER BY updated_at DESC LIMIT ?', [limit]);
+        return rows.map(rowToInstance);
+    }
+    // ─── Core Execution Loop ──────────────────────────────────────────
+    async runSteps(chainDef, instance, dispatch, gateCheck, startIdx) {
+        // Steps MUST run sequentially — step N output feeds step N+1 input.
+        // Using recursive approach to satisfy no-await-in-loop lint rule.
+        return this.runStep(chainDef, instance, dispatch, gateCheck, startIdx);
+    }
+    async runStep(chainDef, instance, dispatch, gateCheck, idx) {
+        if (idx >= chainDef.steps.length) {
+            instance.status = 'completed';
+            instance.currentStep = null;
+            this.persist(instance);
+            return instance;
+        }
+        const step = chainDef.steps[idx];
+        instance.currentStep = step.id;
+        this.persist(instance);
+        const resolvedParams = resolveParams(step.params ?? {}, instance.context);
+        const stepStart = Date.now();
+        let result;
+        let stepStatus = 'completed';
+        try {
+            result = await dispatch(step.op, resolvedParams);
+        }
+        catch (err) {
+            result = { error: err.message };
+            stepStatus = 'failed';
+        }
+        const output = {
+            stepId: step.id,
+            op: step.op,
+            result,
+            status: stepStatus,
+            durationMs: Date.now() - stepStart,
+        };
+        instance.stepOutputs.push(output);
+        instance.context[step.id] = result;
+        if (step.output)
+            instance.context[step.output] = result;
+        if (stepStatus === 'completed')
+            instance.stepsCompleted++;
+        // Check gate
+        if (step.gate && step.gate !== 'none' && stepStatus === 'completed') {
+            const gateResult = await this.evaluateChainGate(step.gate, step.id, result, gateCheck);
+            if (!gateResult.passed) {
+                if (step.gate === 'user-approval') {
+                    instance.status = 'paused';
+                    instance.pausedAtGate = step.id;
+                    this.persist(instance);
+                    return instance;
+                }
+                instance.status = 'failed';
+                this.persist(instance);
+                return instance;
+            }
+        }
+        if (stepStatus === 'failed') {
+            instance.status = 'failed';
+            this.persist(instance);
+            return instance;
+        }
+        this.persist(instance);
+        return this.runStep(chainDef, instance, dispatch, gateCheck, idx + 1);
+    }
+    async evaluateChainGate(gate, stepId, stepResult, gateCheck) {
+        switch (gate) {
+            case 'user-approval':
+                return { passed: false, message: 'Awaiting user approval' };
+            case 'auto-test': {
+                const result = stepResult;
+                if (!result)
+                    return { passed: false, message: 'Step returned no result' };
+                if (result.error)
+                    return { passed: false, message: `Step error: ${result.error}` };
+                return { passed: true };
+            }
+            case 'vault-check': {
+                if (gateCheck)
+                    return gateCheck(gate, stepId, stepResult);
+                return { passed: true };
+            }
+            default:
+                return { passed: true };
+        }
+    }
+    // ─── Persistence ──────────────────────────────────────────────────
+    persist(instance) {
+        instance.updatedAt = new Date().toISOString();
+        this.provider.run(`INSERT OR REPLACE INTO chain_instances
+       (id, chain_id, chain_name, status, current_step, paused_at_gate, input, context, step_outputs, steps_completed, total_steps, created_at, updated_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+            instance.id,
+            instance.chainId,
+            instance.chainName,
+            instance.status,
+            instance.currentStep,
+            instance.pausedAtGate,
+            JSON.stringify(instance.input),
+            JSON.stringify(instance.context),
+            JSON.stringify(instance.stepOutputs),
+            instance.stepsCompleted,
+            instance.totalSteps,
+            instance.createdAt,
+            instance.updatedAt,
+        ]);
+    }
+}
+// ─── Variable Resolution ─────────────────────────────────────────────
+/**
+ * Resolve $variable references in params.
+ * $input.url → context.input.url
+ * $research.title → context.research.title
+ * $stepId → context.stepId (whole object)
+ */
+function resolveParams(params, context) {
+    const resolved = {};
+    for (const [key, value] of Object.entries(params)) {
+        resolved[key] = resolveValue(value, context);
+    }
+    return resolved;
+}
+function resolveValue(value, context) {
+    if (typeof value === 'string' && value.startsWith('$')) {
+        return resolveReference(value.slice(1), context);
+    }
+    if (Array.isArray(value)) {
+        return value.map((v) => resolveValue(v, context));
+    }
+    if (value !== null && typeof value === 'object') {
+        return resolveParams(value, context);
+    }
+    return value;
+}
+function resolveReference(path, context) {
+    const parts = path.split('.');
+    let current = context;
+    for (const part of parts) {
+        if (current === null || current === undefined)
+            return undefined;
+        if (typeof current !== 'object')
+            return undefined;
+        current = current[part];
+    }
+    return current;
+}
+function rowToInstance(row) {
+    return {
+        id: row.id,
+        chainId: row.chain_id,
+        chainName: row.chain_name,
+        status: row.status,
+        currentStep: row.current_step,
+        pausedAtGate: row.paused_at_gate,
+        input: JSON.parse(row.input),
+        context: JSON.parse(row.context),
+        stepOutputs: JSON.parse(row.step_outputs),
+        stepsCompleted: row.steps_completed,
+        totalSteps: row.total_steps,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+    };
+}
+//# sourceMappingURL=chain-runner.js.map

package/dist/flows/chain-runner.js.map

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

package/dist/flows/chain-types.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Chain types — composable multi-step workflows with data flow.
+ */
+import { z } from 'zod';
+export declare const chainStepSchema: z.ZodObject<{
+    id: z.ZodString;
+    op: z.ZodString;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    output: z.ZodOptional<z.ZodString>;
+    gate: z.ZodOptional<z.ZodEnum<["user-approval", "auto-test", "vault-check", "none"]>>;
+    description: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    op: string;
+    params?: Record<string, unknown> | undefined;
+    output?: string | undefined;
+    gate?: "user-approval" | "auto-test" | "vault-check" | "none" | undefined;
+    description?: string | undefined;
+}, {
+    id: string;
+    op: string;
+    params?: Record<string, unknown> | undefined;
+    output?: string | undefined;
+    gate?: "user-approval" | "auto-test" | "vault-check" | "none" | undefined;
+    description?: string | undefined;
+}>;
+export declare const chainDefSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    steps: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        op: z.ZodString;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        output: z.ZodOptional<z.ZodString>;
+        gate: z.ZodOptional<z.ZodEnum<["user-approval", "auto-test", "vault-check", "none"]>>;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        op: string;
+        params?: Record<string, unknown> | undefined;
+        output?: string | undefined;
+        gate?: "user-approval" | "auto-test" | "vault-check" | "none" | undefined;
+        description?: string | undefined;
+    }, {
+        id: string;
+        op: string;
+        params?: Record<string, unknown> | undefined;
+        output?: string | undefined;
+        gate?: "user-approval" | "auto-test" | "vault-check" | "none" | undefined;
+        description?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    steps: {
+        id: string;
+        op: string;
+        params?: Record<string, unknown> | undefined;
+        output?: string | undefined;
+        gate?: "user-approval" | "auto-test" | "vault-check" | "none" | undefined;
+        description?: string | undefined;
+    }[];
+    description?: string | undefined;
+    name?: string | undefined;
+}, {
+    id: string;
+    steps: {
+        id: string;
+        op: string;
+        params?: Record<string, unknown> | undefined;
+        output?: string | undefined;
+        gate?: "user-approval" | "auto-test" | "vault-check" | "none" | undefined;
+        description?: string | undefined;
+    }[];
+    description?: string | undefined;
+    name?: string | undefined;
+}>;
+export type ChainDef = z.infer<typeof chainDefSchema>;
+export type ChainStep = z.infer<typeof chainStepSchema>;
+export type ChainStatus = 'running' | 'paused' | 'completed' | 'failed';
+export interface StepOutput {
+    stepId: string;
+    op: string;
+    result: unknown;
+    status: 'completed' | 'failed' | 'skipped';
+    durationMs: number;
+}
+export interface ChainInstance {
+    id: string;
+    chainId: string;
+    chainName: string;
+    status: ChainStatus;
+    currentStep: string | null;
+    pausedAtGate: string | null;
+    input: Record<string, unknown>;
+    context: Record<string, unknown>;
+    stepOutputs: StepOutput[];
+    stepsCompleted: number;
+    totalSteps: number;
+    createdAt: string;
+    updatedAt: string;
+}
+//# sourceMappingURL=chain-types.d.ts.map

package/dist/flows/chain-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-types.d.ts","sourceRoot":"","sources":["../../src/flows/chain-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;EAU1B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAIxD,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;AAExE,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC3C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/flows/chain-types.js

@@ -0,0 +1,23 @@
+/**
+ * Chain types — composable multi-step workflows with data flow.
+ */
+import { z } from 'zod';
+// ─── Chain Definition (YAML schema) ──────────────────────────────────
+export const chainStepSchema = z.object({
+    id: z.string(),
+    op: z.string().describe('Facade op to call'),
+    params: z
+        .record(z.unknown())
+        .optional()
+        .describe('Params — use $input.x or $stepId.field for data flow'),
+    output: z.string().optional().describe('Key to store step result under'),
+    gate: z.enum(['user-approval', 'auto-test', 'vault-check', 'none']).optional(),
+    description: z.string().optional(),
+});
+export const chainDefSchema = z.object({
+    id: z.string(),
+    name: z.string().optional(),
+    description: z.string().optional(),
+    steps: z.array(chainStepSchema).min(1),
+});
+//# sourceMappingURL=chain-types.js.map

package/dist/flows/chain-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-types.js","sourceRoot":"","sources":["../../src/flows/chain-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,wEAAwE;AAExE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IAC5C,MAAM,EAAE,CAAC;SACN,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SACnB,QAAQ,EAAE;SACV,QAAQ,CAAC,sDAAsD,CAAC;IACnE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IACxE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC9E,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CACvC,CAAC,CAAC"}

package/dist/health/doctor-checks.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Doctor Checks — 8 specialized health checks for comprehensive diagnostics.
+ *
+ * Each check validates a subsystem and reports pass/warn/fail.
+ */
+import type { HealthRegistry } from './health-registry.js';
+import type { AgentRuntime } from '../runtime/types.js';
+export interface DoctorCheckResult {
+    check: string;
+    status: 'pass' | 'warn' | 'fail';
+    message: string;
+}
+export declare function runDoctorChecks(runtime: AgentRuntime): DoctorCheckResult[];
+export declare function registerDoctorChecks(health: HealthRegistry, runtime: AgentRuntime): void;
+//# sourceMappingURL=doctor-checks.d.ts.map

package/dist/health/doctor-checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-checks.d.ts","sourceRoot":"","sources":["../../src/health/doctor-checks.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,iBAAiB,EAAE,CAsF1E;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAWxF"}

package/dist/health/doctor-checks.js

@@ -0,0 +1,98 @@
+/**
+ * Doctor Checks — 8 specialized health checks for comprehensive diagnostics.
+ *
+ * Each check validates a subsystem and reports pass/warn/fail.
+ */
+export function runDoctorChecks(runtime) {
+    const results = [];
+    // 1. Config
+    try {
+        const id = runtime.config.agentId;
+        results.push({
+            check: 'config',
+            status: id ? 'pass' : 'fail',
+            message: id ? `Agent "${id}" configured` : 'No agent ID',
+        });
+    }
+    catch (e) {
+        results.push({ check: 'config', status: 'fail', message: e.message });
+    }
+    // 2. Database
+    try {
+        runtime.vault.getProvider().get('PRAGMA user_version');
+        results.push({ check: 'database', status: 'pass', message: 'SQLite healthy' });
+    }
+    catch (e) {
+        results.push({ check: 'database', status: 'fail', message: e.message });
+    }
+    // 3. Vault
+    try {
+        const stats = runtime.vault.stats();
+        results.push({
+            check: 'vault',
+            status: stats.totalEntries > 0 ? 'pass' : 'warn',
+            message: stats.totalEntries > 0 ? `${stats.totalEntries} entries` : 'Vault empty',
+        });
+    }
+    catch (e) {
+        results.push({ check: 'vault', status: 'fail', message: e.message });
+    }
+    // 4. LLM
+    try {
+        const pool = runtime.keyPool;
+        const total = (pool.openai?.getActiveKey() ? 1 : 0) + (pool.anthropic?.getActiveKey() ? 1 : 0);
+        results.push({
+            check: 'llm',
+            status: total > 0 ? 'pass' : 'warn',
+            message: total > 0 ? `${total} provider(s) available` : 'No API keys — LLM features disabled',
+        });
+    }
+    catch {
+        results.push({ check: 'llm', status: 'warn', message: 'LLM check failed' });
+    }
+    // 5. Auth
+    results.push({
+        check: 'auth',
+        status: 'pass',
+        message: `Mode: ${runtime.authPolicy.mode}`,
+    });
+    // 6. Plugins
+    try {
+        const count = runtime.pluginRegistry.list().length;
+        results.push({ check: 'plugins', status: 'pass', message: `${count} plugin(s)` });
+    }
+    catch {
+        results.push({ check: 'plugins', status: 'warn', message: 'Plugin check failed' });
+    }
+    // 7. Embeddings (Cognee)
+    try {
+        const available = runtime.cognee?.isAvailable ?? false;
+        results.push({
+            check: 'embeddings',
+            status: available ? 'pass' : 'warn',
+            message: available ? 'Cognee available' : 'Cognee not available — vector search disabled',
+        });
+    }
+    catch {
+        results.push({ check: 'embeddings', status: 'warn', message: 'Embedding check failed' });
+    }
+    // 8. Security
+    results.push({
+        check: 'security',
+        status: runtime.authPolicy.mode === 'permissive' ? 'warn' : 'pass',
+        message: runtime.authPolicy.mode === 'permissive'
+            ? 'Permissive mode — all ops allowed'
+            : `Enforcement: ${runtime.authPolicy.mode}`,
+    });
+    return results;
+}
+export function registerDoctorChecks(health, runtime) {
+    const results = runDoctorChecks(runtime);
+    for (const r of results) {
+        health.register(r.check, r.status === 'pass' ? 'healthy' : r.status === 'warn' ? 'degraded' : 'down');
+        if (r.status !== 'pass') {
+            health.update(r.check, r.status === 'warn' ? 'degraded' : 'down', r.message);
+        }
+    }
+}
+//# sourceMappingURL=doctor-checks.js.map

package/dist/health/doctor-checks.js.map

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

package/dist/intake/text-ingester.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Text Ingester — ingest articles, transcripts, and plain text into the vault.
+ *
+ * Reuses existing content-classifier (LLM extraction) and dedup-gate (TF-IDF).
+ * No new dependencies — fetch() is built-in, HTML stripping is regex-based.
+ */
+import type { Vault } from '../vault/vault.js';
+import type { LLMClient } from '../llm/llm-client.js';
+export interface IngestSource {
+    type: 'article' | 'transcript' | 'notes' | 'documentation';
+    title: string;
+    url?: string;
+    author?: string;
+}
+export interface IngestOptions {
+    domain?: string;
+    tags?: string[];
+    /** Max chars per chunk for LLM classification. Default 4000. */
+    chunkSize?: number;
+}
+export interface IngestResult {
+    source: IngestSource;
+    ingested: number;
+    duplicates: number;
+    entries: Array<{
+        id: string;
+        title: string;
+        type: string;
+    }>;
+}
+export declare class TextIngester {
+    private vault;
+    private llm;
+    constructor(vault: Vault, llm: LLMClient | null);
+    /**
+     * Ingest a URL — fetch, strip HTML, classify, dedup, store.
+     */
+    ingestUrl(url: string, opts?: IngestOptions): Promise<IngestResult>;
+    /**
+     * Ingest raw text — classify, dedup, store.
+     */
+    ingestText(text: string, source: IngestSource, opts?: IngestOptions): Promise<IngestResult>;
+    /**
+     * Ingest multiple items in sequence.
+     */
+    ingestBatch(items: Array<{
+        text: string;
+        source: IngestSource;
+        opts?: IngestOptions;
+    }>): Promise<IngestResult[]>;
+}
+//# sourceMappingURL=text-ingester.d.ts.map

package/dist/intake/text-ingester.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-ingester.d.ts","sourceRoot":"","sources":["../../src/intake/text-ingester.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAQtD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,GAAG,YAAY,GAAG,OAAO,GAAG,eAAe,CAAC;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7D;AASD,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,GAAG,CAAmB;gBAElB,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI;IAK/C;;OAEG;IACG,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IA8BzE;;OAEG;IACG,UAAU,CACd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,YAAY,EACpB,IAAI,CAAC,EAAE,aAAa,GACnB,OAAO,CAAC,YAAY,CAAC;IAsDxB;;OAEG;IACG,WAAW,CACf,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAC;QAAC,IAAI,CAAC,EAAE,aAAa,CAAA;KAAE,CAAC,GACzE,OAAO,CAAC,YAAY,EAAE,CAAC;CAQ3B"}