draken 0.1.5 → 0.2.0

package/dist/memory/stamps.js

@@ -0,0 +1,101 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sourceStamps = sourceStamps;
+exports.saveSourceCheckpoint = saveSourceCheckpoint;
+exports.loadSourceCheckpoint = loadSourceCheckpoint;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const crypto_1 = require("crypto");
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+const KEY = 'background-source-stamps-v1';
+const hash = (value) => (0, crypto_1.createHash)('sha256').update(JSON.stringify(value)).digest('hex');
+/** One counter slot per original source entry, not per session/alias/snapshot.
+ * Distinct frozen projections join that entry's fingerprint rather than counting
+ * the same original again. No bodies are reconstructed or retained here. */
+function sourceStamps(db, before) {
+    const since = db.prepare("SELECT value FROM sync_settings WHERE key='history_since'").get()?.value || '';
+    const sessions = new Set(db.prepare('SELECT s.id FROM agent_sessions s JOIN agent_sources a ON a.id=s.agent WHERE s.included=1 AND s.missing=0 AND a.enabled=1').all().map(row => row.id));
+    const groups = new Map();
+    const add = (key, projection) => {
+        const id = hash(key), versions = groups.get(id) || new Set();
+        versions.add(hash(projection));
+        groups.set(id, versions);
+    };
+    const allowed = (session, at) => sessions.has(session) && at >= since && (!before || at <= before);
+    const projection = (agent, name, cwd, role, at, pointer) => [agent, name || cwd, cwd, role, at, pointer.original.record_hash, pointer.normalization,
+        pointer.edit ? [pointer.edit.record_hash, pointer.edit.normalization] : null, pointer.clip || null];
+    for (const row of db.prepare(`SELECT e.*,s.agent,s.name,s.cwd,edit.record_hash AS edit_hash,edit.normalization AS edit_normalization
+    FROM agent_entries e JOIN agent_sessions s ON s.id=e.session_id LEFT JOIN agent_entries edit ON edit.id=e.effective_id
+    WHERE e.active=1 AND e.present=1 AND e.is_activity=1 AND e.effective_length>0 ORDER BY e.id`).iterate()) {
+        if (!allowed(row.session_id, row.timestamp))
+            continue;
+        add(['entry', row.session_id, row.entry_id], projection(row.agent, row.name, row.cwd, row.role, row.timestamp, { original: row, normalization: row.normalization, ...(row.edit_hash ? { edit: { record_hash: row.edit_hash, normalization: row.edit_normalization } } : {}) }));
+    }
+    const frozen = (item) => {
+        if (!allowed(item.session_id, item.timestamp))
+            return;
+        if (!item.source_pointer)
+            throw new Error('Background checkpoint requires verified frozen pointers');
+        add(['entry', item.session_id, item.entry_id], projection(item.agent || 'pi', item.session_name, item.cwd, item.role, item.timestamp, item.source_pointer));
+    };
+    for (const row of db.prepare("SELECT i.evidence_json FROM sync_items i JOIN syncs s ON s.id=i.sync_id WHERE s.status!='discarded' ORDER BY i.rowid").iterate())
+        frozen(JSON.parse(row.evidence_json));
+    for (const row of db.prepare("SELECT id,status,completed_at,context_json,decisions,carry_forward FROM syncs WHERE status!='discarded' ORDER BY id").iterate()) {
+        for (const item of JSON.parse(row.context_json))
+            frozen(item);
+        const at = row.status === 'completed' ? row.completed_at : null;
+        if (before && (!at || at > before))
+            continue; // Same cutoff admission as prepare().
+        for (const kind of ['decisions', 'carry_forward'])
+            if (row[kind].trim())
+                add([kind, row.id], [row[kind], at, row.status === 'completed']);
+    }
+    for (const row of db.prepare("SELECT m.id,m.content,m.role,m.created_at FROM sync_messages m JOIN syncs s ON s.id=m.sync_id WHERE s.status!='discarded' ORDER BY m.id").iterate()) {
+        if (row.content.trim() && (!before || row.created_at <= before))
+            add(['message', row.id], [row.content, row.role, row.created_at]);
+    }
+    return new Map([...groups].sort(([a], [b]) => a.localeCompare(b)).map(([key, values]) => [key, hash([...values].sort())]));
+}
+/** Write only after successful unscoped preparation. Hashes are scheduling hints,
+ * never evidence or authorization to skip fresh source verification. */
+function saveSourceCheckpoint(db, stamps) {
+    const value = JSON.stringify([...stamps]);
+    const prior = db.prepare('SELECT value FROM meta WHERE key=?').get(KEY);
+    if (prior?.value !== value)
+        db.prepare('INSERT INTO meta(key,value) VALUES(?,?) ON CONFLICT(key) DO UPDATE SET value=excluded.value').run(KEY, value);
+}
+/** No file/DB/model creation. Older indexes without a checkpoint need one
+ * foreground preparation; treating the whole cached archive as new would let
+ * a small tail bypass the minimum after a restart. */
+function loadSourceCheckpoint(directory) {
+    const file = path_1.default.join(directory, 'memory', 'index.sqlite');
+    if (!fs_1.default.existsSync(file))
+        return new Map();
+    const db = new better_sqlite3_1.default(file, { readonly: true, fileMustExist: true });
+    try {
+        db.pragma('query_only = ON');
+        db.pragma('busy_timeout = 5000');
+        if (!db.prepare("SELECT 1 FROM sqlite_master WHERE type='table'").get())
+            return new Map(); // Interrupted brand-new initialization.
+        const size = db.prepare('SELECT length(value) AS size FROM meta WHERE key=?').get(KEY);
+        if (!size)
+            return undefined;
+        if (size.size > 33554432)
+            throw new Error('Oversized background checkpoint');
+        const row = db.prepare('SELECT value FROM meta WHERE key=?').get(KEY);
+        const pairs = JSON.parse(row.value);
+        if (!Array.isArray(pairs) || pairs.some(pair => !Array.isArray(pair) || pair.length !== 2 || pair.some(value => typeof value !== 'string' || !/^[a-f0-9]{64}$/.test(value))))
+            throw new Error('Invalid background checkpoint');
+        const result = new Map(pairs);
+        if (result.size !== pairs.length)
+            throw new Error('Duplicate background checkpoint identity');
+        return result;
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=stamps.js.map

package/dist/memory/stamps.js.map

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

package/dist/memory/storage.d.ts

@@ -0,0 +1,5 @@
+import type Database from 'better-sqlite3';
+/** One physical passage/vector, many scoped occurrences. `chunks` and
+ * `embedding_cache` are read views, not additional text/vector stores. */
+export declare function initHistoryStorage(db: Database.Database, fingerprint: string): void;
+//# sourceMappingURL=storage.d.ts.map

package/dist/memory/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/memory/storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C;0EAC0E;AAC1E,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAwFnF"}

package/dist/memory/storage.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initHistoryStorage = initHistoryStorage;
+/** One physical passage/vector, many scoped occurrences. `chunks` and
+ * `embedding_cache` are read views, not additional text/vector stores. */
+function initHistoryStorage(db, fingerprint) {
+    const version = 'history-index-v3-contentless';
+    db.exec("CREATE TABLE IF NOT EXISTS meta(key TEXT PRIMARY KEY,value TEXT NOT NULL)");
+    const prior = db.prepare("SELECT value FROM meta WHERE key='schema'").get()?.value;
+    if ((prior && !['history-index-v1', 'history-index-v2-pointers', version].includes(prior)) || (!prior && db.prepare("SELECT 1 FROM sqlite_schema WHERE name IN ('records','chunks','vectors','passages')").get()))
+        throw new Error('Unknown history storage version; existing data was not reset');
+    db.transaction(() => {
+        db.exec(`
+      CREATE TABLE IF NOT EXISTS records(ref TEXT PRIMARY KEY,json TEXT NOT NULL,session_id TEXT,sync_id INTEGER,at TEXT,group_id TEXT NOT NULL,position INTEGER NOT NULL);
+      CREATE INDEX IF NOT EXISTS records_group ON records(group_id,at,position);
+      CREATE TABLE IF NOT EXISTS passages(id INTEGER PRIMARY KEY AUTOINCREMENT,hash TEXT NOT NULL UNIQUE,body TEXT,embedded INTEGER NOT NULL DEFAULT 0);
+      CREATE TABLE IF NOT EXISTS chunk_links(id INTEGER PRIMARY KEY AUTOINCREMENT,ref TEXT NOT NULL REFERENCES records(ref) ON DELETE CASCADE,offset INTEGER NOT NULL,passage_id INTEGER NOT NULL REFERENCES passages(id));
+      CREATE INDEX IF NOT EXISTS links_ref ON chunk_links(ref);
+      CREATE INDEX IF NOT EXISTS links_passage ON chunk_links(passage_id);
+      CREATE VIRTUAL TABLE IF NOT EXISTS passage_vectors USING vec0(embedding float[384] distance_metric=cosine);
+    `);
+        if (prior === 'history-index-v1') {
+            const sequence = db.prepare("SELECT seq FROM sqlite_sequence WHERE name='chunks'").get()?.seq || 0;
+            const insert = db.prepare('INSERT OR IGNORE INTO passages(hash,body) VALUES(?,?)');
+            const id = db.prepare('SELECT id,body FROM passages WHERE hash=?');
+            const link = db.prepare('INSERT INTO chunk_links(id,ref,offset,passage_id) VALUES(?,?,?,?)');
+            for (const row of db.prepare('SELECT * FROM chunks ORDER BY id').all()) {
+                insert.run(row.hash, row.body);
+                const passage = id.get(row.hash);
+                if (passage.body !== row.body)
+                    throw new Error('Conflicting passage hash');
+                link.run(row.id, row.ref, row.offset, passage.id);
+            }
+            if (!db.prepare("UPDATE sqlite_sequence SET seq=MAX(seq,?) WHERE name='chunk_links'").run(sequence).changes && sequence)
+                db.prepare('INSERT INTO sqlite_sequence(name,seq) VALUES(?,?)').run('chunk_links', sequence);
+            const cache = db.prepare('SELECT embedding FROM embedding_cache WHERE hash=?');
+            const vector = db.prepare('SELECT embedding FROM vectors WHERE rowid=?');
+            const save = db.prepare('INSERT INTO passage_vectors(rowid,embedding) VALUES(?,?)');
+            // Cache-only rows are retained too; ordinary admission refresh may later
+            // prune genuinely unreferenced data, just as before this migration.
+            for (const row of db.prepare('SELECT hash FROM embedding_cache').all())
+                insert.run(row.hash, null);
+            for (const passage of db.prepare('SELECT id,hash FROM passages ORDER BY id').all()) {
+                let bytes = cache.get(passage.hash)?.embedding;
+                for (const row of db.prepare('SELECT id FROM chunks WHERE hash=? AND embedded=1').all(passage.hash)) {
+                    const saved = vector.get(BigInt(row.id))?.embedding;
+                    if (!saved || (bytes && !saved.equals(bytes)))
+                        throw new Error('Existing embeddings disagree; migration refused');
+                    bytes ||= saved;
+                }
+                if (!bytes)
+                    continue;
+                if (bytes.length !== 1536 || [...new Float32Array(Uint8Array.from(bytes).buffer)].some(value => !Number.isFinite(value)))
+                    throw new Error('Invalid retained embedding');
+                save.run(BigInt(passage.id), bytes);
+                db.prepare('UPDATE passages SET embedded=1 WHERE id=?').run(passage.id);
+            }
+            // Preserve the external-content FTS index and occurrence IDs, including
+            // its document frequencies. Only its backing table becomes a join view.
+            db.exec('DROP TRIGGER IF EXISTS chunks_insert; DROP TRIGGER IF EXISTS chunks_delete; DROP TABLE chunks; DROP TABLE vectors; DROP TABLE embedding_cache');
+            if (!db.prepare("SELECT 1 FROM meta WHERE key='covered-tails-removed'").get()) {
+                const remove = db.prepare('DELETE FROM chunk_links WHERE id=?');
+                for (const row of db.prepare(`SELECT c.id,c.offset,r.json FROM chunk_links c JOIN records r ON r.ref=c.ref
+          WHERE c.offset>0 AND NOT EXISTS(SELECT 1 FROM chunk_links n WHERE n.ref=c.ref AND n.offset>c.offset)
+          AND EXISTS(SELECT 1 FROM chunk_links p WHERE p.ref=c.ref AND p.offset=c.offset-700)`).all()) {
+                    const text = JSON.parse(row.json).text;
+                    if (typeof text === 'string' && row.offset + 100 >= text.length) {
+                        // External-content FTS needs an explicit delete before its link is removed.
+                        const body = db.prepare('SELECT body FROM passages p JOIN chunk_links c ON p.id=c.passage_id WHERE c.id=?').get(row.id).body;
+                        db.prepare("INSERT INTO words(words,rowid,body) VALUES('delete',?,?)").run(row.id, body);
+                        remove.run(row.id);
+                    }
+                }
+            }
+            db.exec("UPDATE records SET json=json_remove(json,'$.text')");
+        }
+        if (db.pragma('table_info(passages)').some(column => column.name === 'body')) {
+            if (db.prepare('SELECT 1 FROM chunk_links c JOIN passages p ON p.id=c.passage_id WHERE p.body IS NULL LIMIT 1').get())
+                throw new Error('A stored search passage is missing; conversion refused');
+            // FTS retains token postings/positions, not original passage strings.
+            // Re-tokenize existing inputs only; vector bytes and IDs do not change.
+            db.exec(`CREATE VIRTUAL TABLE words_source USING fts5(body,content='',contentless_delete=1);
+        INSERT INTO words_source(rowid,body) SELECT c.id,p.body FROM chunk_links c JOIN passages p ON p.id=c.passage_id;
+        DROP TRIGGER IF EXISTS links_insert; DROP TRIGGER IF EXISTS links_delete;
+        DROP VIEW IF EXISTS chunks; DROP TABLE IF EXISTS words;
+        ALTER TABLE words_source RENAME TO words;
+        ALTER TABLE passages DROP COLUMN body;`);
+        }
+        db.exec(`
+      CREATE VIEW IF NOT EXISTS chunks AS SELECT c.id,c.ref,c.offset,p.hash,p.embedded FROM chunk_links c JOIN passages p ON p.id=c.passage_id;
+      CREATE VIEW IF NOT EXISTS embedding_cache AS SELECT p.hash,v.embedding FROM passages p JOIN passage_vectors v ON v.rowid=p.id;
+      CREATE VIRTUAL TABLE IF NOT EXISTS words USING fts5(body,content='',contentless_delete=1);
+      CREATE TRIGGER IF NOT EXISTS links_delete AFTER DELETE ON chunk_links BEGIN DELETE FROM words WHERE rowid=old.id; END;
+      CREATE TRIGGER IF NOT EXISTS passage_delete AFTER DELETE ON passages BEGIN DELETE FROM passage_vectors WHERE rowid=old.id; END;
+    `);
+        const oldModel = db.prepare("SELECT value FROM meta WHERE key='model'").get()?.value;
+        if (oldModel && oldModel !== fingerprint) {
+            // A real fingerprint change invalidates derived passages, never canonical records.
+            db.exec('DELETE FROM records; DELETE FROM passages');
+        }
+        const metadata = db.prepare('INSERT INTO meta(key,value) VALUES(?,?) ON CONFLICT(key) DO UPDATE SET value=excluded.value WHERE meta.value!=excluded.value');
+        metadata.run('schema', version);
+        metadata.run('model', fingerprint);
+        db.prepare("INSERT OR IGNORE INTO meta VALUES('covered-tails-removed','1')").run();
+    })();
+}
+//# sourceMappingURL=storage.js.map

package/dist/memory/storage.js.map

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

package/dist/memory/types.d.ts

@@ -0,0 +1,68 @@
+export interface HistoryRecord {
+    ref: string;
+    kind: 'session' | 'snapshot' | 'discussion' | 'decisions' | 'carry_forward';
+    session_id: string | null;
+    sync_id: number | null;
+    origin_ref: string | null;
+    title: string;
+    workspace: string;
+    role: string;
+    at: string | null;
+    qualification: string;
+    text: string;
+}
+export interface HistoryQuery {
+    question: string;
+    session_id?: string;
+    sync_id?: number;
+    before?: string;
+}
+export interface HistoryResults {
+    mode: 'hybrid';
+    results: (HistoryRecord & {
+        offset: number;
+        score: number;
+    })[];
+    limitations: string;
+}
+export interface HistoryPage {
+    record: HistoryRecord;
+    offset: number;
+    total: number;
+    neighbors: HistoryRecord[];
+}
+export interface HistoryUpdate {
+    stage: 'scanning' | 'downloading' | 'loading' | 'indexing' | 'searching' | 'reading';
+    completed: number;
+    total: number;
+    reused: number;
+    parallelism?: {
+        workers: number;
+        threads: number;
+    };
+    remaining_seconds: number | null;
+    downloaded_bytes: number;
+    download_total_bytes: number;
+}
+export interface HistoryProgress {
+    active: boolean;
+    background?: boolean;
+    queued: number;
+    elapsed_ms: number;
+    updated_at: number | null;
+    work: HistoryUpdate | null;
+}
+export type ReportHistory = (update: HistoryUpdate) => void;
+export declare const historyUpdate: (stage: HistoryUpdate["stage"], fields?: Partial<Omit<HistoryUpdate, "stage">>) => HistoryUpdate;
+export interface Embedder {
+    readonly fingerprint: string;
+    ready(): boolean;
+    setup(report?: ReportHistory): Promise<void>;
+    embed(text: string, query: boolean): Promise<Float32Array>;
+    embedMany?(texts: string[], parallel?: boolean): Promise<Float32Array[]>;
+    readonly parallelism?: {
+        workers: number;
+        threads: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/memory/types.d.ts.map

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

package/dist/memory/types.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.historyUpdate = void 0;
+const historyUpdate = (stage, fields = {}) => ({
+    stage, completed: 0, total: 0, reused: 0, remaining_seconds: null, downloaded_bytes: 0, download_total_bytes: 0, ...fields,
+});
+exports.historyUpdate = historyUpdate;
+//# sourceMappingURL=types.js.map

package/dist/memory/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/memory/types.ts"],"names":[],"mappings":";;;AAiDO,MAAM,aAAa,GAAG,CAAC,KAA6B,EAAE,SAAgD,EAAE,EAAiB,EAAE,CAAC,CAAC;IAClI,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,EAAE,oBAAoB,EAAE,CAAC,EAAE,GAAG,MAAM;CAC3H,CAAC,CAAC;AAFU,QAAA,aAAa,iBAEvB"}

package/dist/memory/worker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=worker.d.ts.map

package/dist/memory/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/memory/worker.ts"],"names":[],"mappings":""}

package/dist/memory/worker.js

@@ -0,0 +1,82 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+const index_1 = require("./index");
+const embedding_pool_1 = require("./embedding-pool");
+const types_1 = require("./types");
+const registry_1 = require("../sources/registry");
+// A private IPC child, not an HTTP service or tool runner. Native SQLite/vector
+// work and embedding WASM cannot block the dashboard or audio event loop.
+process.umask(0o077);
+const directory = process.argv[2];
+if (!process.send || !directory || !path_1.default.isAbsolute(directory) || !process.argv[3])
+    process.exit(1);
+const roots = (0, registry_1.sourceRoots)(JSON.parse(process.argv[3]));
+const folder = path_1.default.join(directory, 'memory');
+fs_1.default.mkdirSync(folder, { recursive: true, mode: 0o700 });
+const source = new better_sqlite3_1.default(path_1.default.join(directory, 'draken.db'), { readonly: true, fileMustExist: true });
+source.pragma('query_only = ON');
+source.pragma('busy_timeout = 5000');
+const file = path_1.default.join(folder, 'index.sqlite'), db = new better_sqlite3_1.default(file);
+fs_1.default.chmodSync(file, 0o600);
+const model = new embedding_pool_1.EmbeddingPool(path_1.default.join(folder, 'model'));
+const index = new index_1.HistoryIndex(db, source, model, roots);
+let busy = false;
+process.on('message', async (message) => {
+    if (busy || !message || !Number.isSafeInteger(message.id))
+        return;
+    busy = true;
+    try {
+        let lastSent = 0, stage = '';
+        const report = progress => {
+            const now = Date.now();
+            if (progress.stage !== stage || now - lastSent >= 250 || (progress.total > 0 && progress.completed === progress.total)) {
+                stage = progress.stage;
+                lastSent = now;
+                process.send?.({ id: message.id, progress });
+            }
+        };
+        let value;
+        if (message.method === 'prepare') {
+            await index.prepare({ before: message.before }, report, true);
+            value = null;
+        }
+        else if (message.method === 'search')
+            value = await index.search(message.query, report);
+        else if (message.method === 'read') {
+            report((0, types_1.historyUpdate)('reading'));
+            value = index.read(message.ref, message.offset);
+        }
+        else
+            throw new Error('Unknown history operation');
+        process.send?.({ id: message.id, value });
+    }
+    catch {
+        // Never emit private source text, a model input, filesystem error or rejected
+        // request diagnostics. The parent provides action-specific recovery wording.
+        process.send?.({ id: message.id, error: true });
+    }
+    finally {
+        busy = false;
+    }
+});
+async function close() {
+    // Let SQLite finish its normal checkpoint on orderly retirement. Abrupt exit
+    // still leaves committed WAL work recoverable; no VACUUM or history pruning.
+    try {
+        await model.close();
+        db.close();
+        source.close();
+    }
+    finally {
+        process.exit(0);
+    }
+}
+process.once('SIGTERM', close);
+process.once('disconnect', close);
+//# sourceMappingURL=worker.js.map

package/dist/memory/worker.js.map

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

package/dist/npm-cli.d.ts

@@ -0,0 +1,4 @@
+/** Run npm's JS entry under the current Node, never a Windows command shim or
+ * a shell command. Paths with spaces/metacharacters remain individual argv. */
+export declare function npmCli(env?: NodeJS.ProcessEnv, node?: string): string;
+//# sourceMappingURL=npm-cli.d.ts.map

package/dist/npm-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm-cli.d.ts","sourceRoot":"","sources":["../src/npm-cli.ts"],"names":[],"mappings":"AAGA;+EAC+E;AAC/E,wBAAgB,MAAM,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,EAAE,IAAI,SAAmB,GAAG,MAAM,CAkB5F"}

package/dist/npm-cli.js

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.npmCli = npmCli;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+/** Run npm's JS entry under the current Node, never a Windows command shim or
+ * a shell command. Paths with spaces/metacharacters remain individual argv. */
+function npmCli(env = process.env, node = process.execPath) {
+    const candidates = [env.npm_execpath,
+        path_1.default.join(path_1.default.dirname(node), 'node_modules/npm/bin/npm-cli.js'),
+        path_1.default.resolve(path_1.default.dirname(node), '../lib/node_modules/npm/bin/npm-cli.js')];
+    for (const directory of (env.PATH || '').split(path_1.default.delimiter).filter(Boolean)) {
+        for (const name of ['npm', 'npm.cmd']) {
+            try {
+                const file = fs_1.default.realpathSync(path_1.default.join(directory, name));
+                candidates.push(file, path_1.default.join(path_1.default.dirname(file), 'node_modules/npm/bin/npm-cli.js'), path_1.default.join(directory, 'node_modules/npm/bin/npm-cli.js'));
+            }
+            catch { /* Try the other known npm installation layouts. */ }
+        }
+    }
+    const found = candidates.find(file => {
+        try {
+            return file && path_1.default.basename(file) === 'npm-cli.js' && fs_1.default.statSync(file).isFile();
+        }
+        catch {
+            return false;
+        }
+    });
+    if (!found)
+        throw new Error('npm was not found. Install Node.js 22.19+ with npm, then run setup again.');
+    return found;
+}
+//# sourceMappingURL=npm-cli.js.map

package/dist/npm-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm-cli.js","sourceRoot":"","sources":["../src/npm-cli.ts"],"names":[],"mappings":";;;;;AAKA,wBAkBC;AAvBD,4CAAoB;AACpB,gDAAwB;AAExB;+EAC+E;AAC/E,SAAgB,MAAM,CAAC,MAAyB,OAAO,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,QAAQ;IAClF,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,YAAY;QAClC,cAAI,CAAC,IAAI,CAAC,cAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,iCAAiC,CAAC;QAChE,cAAI,CAAC,OAAO,CAAC,cAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,wCAAwC,CAAC,CAAC,CAAC;IAC9E,KAAK,MAAM,SAAS,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,cAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/E,KAAK,MAAM,IAAI,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,YAAE,CAAC,YAAY,CAAC,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;gBACzD,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,cAAI,CAAC,IAAI,CAAC,cAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,iCAAiC,CAAC,EACpF,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,iCAAiC,CAAC,CAAC,CAAC;YAC7D,CAAC;YAAC,MAAM,CAAC,CAAC,mDAAmD,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACnC,IAAI,CAAC;YAAC,OAAO,IAAI,IAAI,cAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,YAAY,IAAI,YAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,KAAK,CAAC;QAAC,CAAC;IACpH,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;IACzG,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/pi/runtime.d.ts

@@ -0,0 +1,34 @@
+export declare const PI_VERSION = "1.5.0";
+export declare const PI_PACKAGE = "@earendil-works/pi-coding-agent";
+export declare const isolatedFlags: string[];
+import type { PiSetupStatus } from '../types';
+export declare function piPaths(): {
+    root: string;
+    agent: string;
+    home: string;
+    work: string;
+    selected: string;
+};
+export declare function managedEnvironment(): NodeJS.ProcessEnv;
+/** Refuse symlinked private subdirectories, without creating anything during GET/status. */
+export declare function privateDirectory(directory: string, create?: boolean): void;
+export declare function executable(name: string): string | undefined;
+export declare function selectedPi(): {
+    source: "managed";
+    binary: string;
+    prefix: string[];
+    env: NodeJS.ProcessEnv;
+    agent: string;
+} | {
+    source: "external";
+    binary: string;
+    prefix: string[];
+    env: {
+        [key: string]: string | undefined;
+        TZ?: string | undefined;
+    };
+    agent: string;
+};
+export declare function stopPiChecks(): Promise<void>;
+export declare function piSetupStatus(fresh?: boolean): Promise<PiSetupStatus>;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/pi/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/pi/runtime.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,UAAU,UAAU,CAAC;AAClC,eAAO,MAAM,UAAU,oCAAoC,CAAC;AAC5D,eAAO,MAAM,aAAa,UAA0K,CAAC;AACrM,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,wBAAgB,OAAO;;;;;;EAGtB;AAKD,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,UAAU,CAKtD;AAED,4FAA4F;AAC5F,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,IAAI,CAUxE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAK3D;AAED,wBAAgB,UAAU;;;;;;;;;;;;;;;EA0BzB;AAID,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAMlD;AAmDD,wBAAgB,aAAa,CAAC,KAAK,UAAQ,GAAG,OAAO,CAAC,aAAa,CAAC,CAOnE"}