@theihtisham/agent-shadow-brain 7.2.0 → 7.22.0

package/dist/brain/managed-project-skills.js

@@ -0,0 +1,230 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { createHash } from 'node:crypto';
+import { GlobalBrain } from './global-brain.js';
+import { MAX_PROJECT_SKILL_BYTES, PROJECT_SKILL_RECEIPT_DIR, replaceProjectFile, withProjectSkillWriteLock } from './project-kit.js';
+import { ensureProjectDirectory, projectLocalPath, projectRoot, readProjectFile } from './project-kit-paths.js';
+import { WORKFLOW_TARGETS } from './workflow-skills.js';
+const disabledDirectory = '.shadow-brain/disabled-project-skills';
+const hash = /^[a-f0-9]{64}$/u;
+const MAX_RECEIPT_BYTES = 4096;
+const MAX_RECEIPTS = 500;
+const hostRefreshNote = 'Reload or restart the coding client to refresh skill discovery. Existing chats may still contain previously loaded instructions.';
+const digest = (value) => createHash('sha256').update(value).digest('hex');
+export class ManagedSkillError extends Error {
+    constructor(code, message, status) {
+        super(message);
+        this.code = code;
+        this.status = status;
+        this.name = 'ManagedSkillError';
+    }
+}
+const conflict = (message) => { throw new ManagedSkillError('MANAGED_SKILL_CONFLICT', message, 409); };
+const invalid = () => { throw new ManagedSkillError('MANAGED_SKILL_INVALID', 'Choose a managed skill and a supported action.', 400); };
+const receiptPathOf = (id) => `${PROJECT_SKILL_RECEIPT_DIR}/${id}.json`;
+const disabledPathOf = (id) => `${disabledDirectory}/${id}.md`;
+const markerPathOf = (id) => `${PROJECT_SKILL_RECEIPT_DIR}/${id}.lifecycle.json`;
+const markerText = (action, sha256) => JSON.stringify({ action, sha256 });
+function parseRequest(raw, applying) {
+    const { id, action, planHash } = raw;
+    if (Object.keys(raw).some(key => !['id', 'action', ...(applying ? ['planHash'] : [])].includes(key)) ||
+        typeof id !== 'string' || !hash.test(id) || (action !== 'disable' && action !== 'enable' && action !== 'remove') ||
+        (applying && (typeof planHash !== 'string' || !hash.test(planHash))))
+        return invalid();
+    return { id, action, ...(typeof planHash === 'string' ? { planHash } : {}) };
+}
+function receipt(raw, projectId, id) {
+    let value;
+    try {
+        value = JSON.parse(raw.toString('utf8'));
+    }
+    catch {
+        return conflict('The ownership receipt is invalid.');
+    }
+    if (!value || value.schemaVersion !== 1 || value.projectId !== projectId || typeof value.relativePath !== 'string' ||
+        typeof value.sha256 !== 'string' || !hash.test(value.sha256) || digest(value.relativePath) !== id) {
+        return conflict('The ownership receipt does not match this project and skill.');
+    }
+    const [file, name] = value.relativePath.split('/').slice(-2).reverse();
+    if (file !== 'SKILL.md' || !name || name.length > 63 || !/^[a-z0-9]+(?:-[a-z0-9]+)*$/u.test(name) ||
+        /^(?:con|prn|aux|nul|com[1-9]|lpt[1-9])$/iu.test(name))
+        return conflict('The receipt does not point to a supported Project Kit skill path.');
+    const targets = Object.keys(WORKFLOW_TARGETS).filter(target => `${WORKFLOW_TARGETS[target].skillRoot}/${name}/SKILL.md` === value.relativePath);
+    if (!targets.length)
+        return conflict('The receipt does not point to a supported Project Kit skill path.');
+    return { value, targets, name };
+}
+function readEntry(root, projectId, id) {
+    const receiptPath = receiptPathOf(id), disabledPath = disabledPathOf(id);
+    const raw = readProjectFile(root, receiptPath, MAX_RECEIPT_BYTES);
+    if (!raw)
+        throw new ManagedSkillError('MANAGED_SKILL_NOT_FOUND', 'Project Kit did not record ownership of this skill.', 404);
+    const { value, targets, name } = receipt(raw, projectId, id);
+    const base = { id, name, targets, relativePath: value.relativePath, sha256: value.sha256 };
+    const receiptHash = digest(raw);
+    try {
+        const marker = readProjectFile(root, markerPathOf(id), MAX_RECEIPT_BYTES);
+        const operations = ['disable', 'enable', 'remove'];
+        const pending = marker ? operations.find(action => markerText(action, receiptHash) === marker.toString('utf8')) ?? null : null;
+        if (marker && !pending)
+            return conflict('The pending operation does not match this ownership receipt.');
+        const disabled = readProjectFile(root, disabledPath, MAX_PROJECT_SKILL_BYTES);
+        const disabledHash = disabled ? digest(disabled) : null;
+        const installedPath = projectLocalPath(root, value.relativePath);
+        const exists = fs.lstatSync(installedPath, { throwIfNoEntry: false }) !== undefined;
+        const install = exists && (!disabled || pending === 'disable' || pending === 'enable') ? readProjectFile(root, value.relativePath, MAX_PROJECT_SKILL_BYTES) : undefined;
+        const installedHash = install ? digest(install) : null;
+        const expected = value.sha256;
+        let state, reason;
+        if (disabled && exists) {
+            state = 'conflict';
+            reason = pending && installedHash === expected && disabledHash === expected ?
+                `A verified ${pending} operation is pending. Preview it again to finish.` : 'The disabled copy and its discovery destination both exist. Preserve both and resolve the destination before continuing.';
+        }
+        else if ((installedHash && installedHash !== expected) || (disabledHash && disabledHash !== expected)) {
+            state = 'edited';
+            reason = 'The skill bytes differ from the ownership receipt.';
+        }
+        else if (disabledHash === expected)
+            state = 'disabled';
+        else if (installedHash === expected)
+            state = 'enabled';
+        else {
+            state = 'missing';
+            reason = pending === 'remove' ? 'A verified removal is pending. Preview Remove to finish it.' : 'The managed skill file is missing.';
+        }
+        return { skill: { ...base, state, ownershipVerified: state === 'enabled' || state === 'disabled', ...(reason ? { reason } : {}),
+                ...(pending ? { pendingAction: pending } : {}) },
+            receiptPath, receiptHash, disabledPath, bytes: install ?? disabled, installedHash, disabledHash, pending };
+    }
+    catch {
+        return { skill: { ...base, state: 'conflict', ownershipVerified: false, reason: 'A managed path is unsafe or could not be verified.' },
+            receiptPath, receiptHash, disabledPath, installedHash: null, disabledHash: null, pending: null };
+    }
+}
+export function listManagedProjectSkills(directory) {
+    const root = projectRoot(directory), projectId = GlobalBrain.projectIdFor(root);
+    const dir = projectLocalPath(root, PROJECT_SKILL_RECEIPT_DIR);
+    const stat = fs.lstatSync(dir, { throwIfNoEntry: false });
+    if (!stat)
+        return { projectId, skills: [], invalidReceipts: 0 };
+    if (!stat.isDirectory())
+        return conflict('Project Kit receipts require an ordinary directory.');
+    const skills = [];
+    let invalidReceipts = 0, seen = 0;
+    const handle = fs.opendirSync(dir);
+    try {
+        for (let item = handle.readSync(); item; item = handle.readSync()) {
+            if (++seen > MAX_RECEIPTS * 4)
+                throw new ManagedSkillError('MANAGED_SKILL_LIMIT', 'Project Kit has too many files in its ownership directory.', 422);
+            const id = item.name.slice(0, -5);
+            if (!item.name.endsWith('.json') || !hash.test(id))
+                continue;
+            if (skills.length + invalidReceipts >= MAX_RECEIPTS)
+                throw new ManagedSkillError('MANAGED_SKILL_LIMIT', 'Project Kit has more than 500 ownership receipts.', 422);
+            try {
+                skills.push(readEntry(root, projectId, id).skill);
+            }
+            catch {
+                invalidReceipts++;
+            }
+        }
+    }
+    finally {
+        handle.closeSync();
+    }
+    return { projectId, skills: skills.sort((a, b) => a.relativePath.localeCompare(b.relativePath)), invalidReceipts };
+}
+function plan(root, projectId, input, entry) {
+    const { skill, receiptPath, disabledPath, receiptHash, installedHash, disabledHash, pending } = entry;
+    const { state, relativePath } = skill;
+    const bothVerified = installedHash === skill.sha256 && disabledHash === skill.sha256;
+    const ordinary = input.action === 'enable' ? state === 'disabled' : input.action === 'disable' ? state === 'enabled' : skill.ownershipVerified;
+    const recovering = pending === input.action && (input.action === 'remove' ? state === 'missing' || skill.ownershipVerified : bothVerified || skill.ownershipVerified);
+    const allowed = pending ? recovering : ordinary;
+    const conflicts = allowed ? [] : [skill.reason ?? `This skill is ${state}.`];
+    const exactPaths = input.action === 'remove' ? [
+        ...(installedHash ? [relativePath] : []), ...(disabledHash ? [disabledPath] : []), receiptPath,
+    ] : pending && (input.action === 'enable' ? state === 'enabled' : state === 'disabled') ? [] : [relativePath, disabledPath];
+    const expectedHashes = { receipt: receiptHash, installed: installedHash, disabled: disabledHash };
+    const effects = pending && !exactPaths.length ? ['Finish the verified operation already recorded on disk.'] : input.action === 'disable' ? ['Move the verified skill outside host discovery.'] : input.action === 'enable' ?
+        ['Restore the verified skill at its absent discovery path.'] : ['Remove the verified skill and its Project Kit ownership receipt.'];
+    const planHash = digest(JSON.stringify({ root, projectId, id: input.id, action: input.action, state, expectedHashes, exactPaths, conflicts, pending }));
+    return { projectId, skill, action: input.action, planHash, exactPaths, expectedHashes, conflicts, effects, hostRefreshNote };
+}
+export function previewManagedProjectSkill(directory, raw) {
+    const root = projectRoot(directory), projectId = GlobalBrain.projectIdFor(root), input = parseRequest(raw, false);
+    return plan(root, projectId, input, readEntry(root, projectId, input.id));
+}
+function unlinkVerified(root, relative, expected, limit) {
+    const value = readProjectFile(root, relative, limit);
+    if (!value || digest(value) !== expected)
+        return conflict('A managed file changed before it could be removed.');
+    fs.unlinkSync(projectLocalPath(root, relative));
+}
+export function applyManagedProjectSkill(directory, raw) {
+    const root = projectRoot(directory), projectId = GlobalBrain.projectIdFor(root), input = parseRequest(raw, true);
+    const initial = readEntry(root, projectId, input.id);
+    const initialPlan = plan(root, projectId, input, initial);
+    if (initialPlan.planHash !== input.planHash || initialPlan.conflicts.length)
+        return conflict(initialPlan.conflicts[0] ?? 'The skill changed. Create a new preview.');
+    return withProjectSkillWriteLock(root, () => {
+        const entry = readEntry(root, projectId, input.id);
+        const preview = plan(root, projectId, input, entry);
+        if (preview.planHash !== input.planHash || preview.conflicts.length)
+            return conflict(preview.conflicts[0] ?? 'The skill changed. Create a new preview.');
+        const { relativePath, sha256 } = entry.skill;
+        const { receiptPath, disabledPath, receiptHash, pending } = entry;
+        const marker = markerPathOf(input.id), record = markerText(input.action, receiptHash);
+        if (!pending)
+            replaceProjectFile(root, marker, record);
+        if (input.action !== 'remove') {
+            const restoring = input.action === 'enable';
+            const source = restoring ? disabledPath : relativePath, target = restoring ? relativePath : disabledPath;
+            const sourceHash = restoring ? entry.disabledHash : entry.installedHash;
+            const targetHash = restoring ? entry.installedHash : entry.disabledHash;
+            let copied = false;
+            try {
+                if (!targetHash) {
+                    ensureProjectDirectory(root, path.posix.dirname(target));
+                    replaceProjectFile(root, target, entry.bytes);
+                    copied = true;
+                }
+                if (sourceHash)
+                    unlinkVerified(root, source, sha256, MAX_PROJECT_SKILL_BYTES);
+            }
+            catch (error) {
+                try {
+                    if (copied)
+                        unlinkVerified(root, target, sha256, MAX_PROJECT_SKILL_BYTES);
+                    if (!pending)
+                        unlinkVerified(root, marker, digest(record), MAX_RECEIPT_BYTES);
+                }
+                catch { /* Preserve changed or recoverable copies. */ }
+                throw error;
+            }
+        }
+        else {
+            if (entry.skill.state !== 'missing')
+                unlinkVerified(root, entry.skill.state === 'disabled' ? disabledPath : relativePath, sha256, MAX_PROJECT_SKILL_BYTES);
+            // Replace the verified journal with the verified receipt. This atomically removes the active receipt,
+            // while keeping evidence of completion outside the inventory if the process stops during cleanup.
+            const verified = readProjectFile(root, receiptPath, MAX_RECEIPT_BYTES);
+            if (!verified || digest(verified) !== receiptHash)
+                return conflict('The ownership receipt changed before removal.');
+            const journal = readProjectFile(root, marker, MAX_RECEIPT_BYTES);
+            if (!journal || digest(journal) !== digest(record))
+                return conflict('The pending removal record changed.');
+            fs.renameSync(projectLocalPath(root, receiptPath), projectLocalPath(root, marker));
+            try {
+                unlinkVerified(root, marker, receiptHash, MAX_RECEIPT_BYTES);
+            }
+            catch { /* Active receipt removal committed. */ }
+        }
+        if (input.action !== 'remove')
+            unlinkVerified(root, marker, digest(record), MAX_RECEIPT_BYTES);
+        return { projectId, id: input.id, finalState: input.action === 'disable' ? 'disabled' : input.action === 'enable' ? 'enabled' : 'removed',
+            changedPaths: preview.exactPaths, preservedPaths: input.action === 'remove' ? [] : [receiptPath], hostRefreshNote };
+    });
+}
+//# sourceMappingURL=managed-project-skills.js.map

package/dist/brain/managed-project-skills.js.map

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

package/dist/brain/mcp-presence.d.ts

@@ -0,0 +1,50 @@
+export declare const MCP_PRESENCE_FILE = "mcp-presence.sqlite";
+export declare const MCP_PRESENCE_LIMITS: Readonly<{
+    connections: 128;
+    renewMs: 10000;
+    ttlMs: 30000;
+    storeBytes: number;
+}>;
+export declare class MCPPresenceError extends Error {
+    readonly code: 'MCP_PRESENCE_UNAVAILABLE' | 'MCP_PRESENCE_LIMIT' | 'MCP_PRESENCE_BUSY';
+    readonly status = 503;
+    constructor(code: 'MCP_PRESENCE_UNAVAILABLE' | 'MCP_PRESENCE_LIMIT' | 'MCP_PRESENCE_BUSY', message: string);
+}
+export interface MCPConnectionIdentity {
+    id: string;
+    tool: string;
+}
+/** A local stdio connection heartbeat, independent of host or model execution. */
+export declare class MCPPresenceStore {
+    private readonly root;
+    private readonly projectId;
+    private readonly now;
+    constructor(root: string, projectId: string, now?: () => number);
+    private file;
+    private create;
+    private rows;
+    private access;
+    report(connection: MCPConnectionIdentity): void;
+    remove(connectionId: string): void;
+    read(enabled: boolean): {
+        projectId: string;
+        enabled: boolean;
+        count: number | null;
+        checkedAt: string;
+        expiresAfterMs: 30000;
+        connections: {
+            id: string;
+            tool: string;
+            startedAt: string;
+            lastSeenAt: string;
+            expiresAt: string;
+            ageMs: number;
+        }[];
+        tools: {
+            tool: string;
+            count: number;
+        }[];
+    };
+}
+export declare function startMCPPresence(store: MCPPresenceStore, connection: MCPConnectionIdentity, enabled: () => boolean): () => void;
+//# sourceMappingURL=mcp-presence.d.ts.map

package/dist/brain/mcp-presence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-presence.d.ts","sourceRoot":"","sources":["../../src/brain/mcp-presence.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,iBAAiB,wBAAwB,CAAC;AACvD,eAAO,MAAM,mBAAmB;;;;;EAA+F,CAAC;AAQhI,qBAAa,gBAAiB,SAAQ,KAAK;IAE7B,QAAQ,CAAC,IAAI,EAAE,0BAA0B,GAAG,oBAAoB,GAAG,mBAAmB;IADlG,QAAQ,CAAC,MAAM,OAAO;gBACD,IAAI,EAAE,0BAA0B,GAAG,oBAAoB,GAAG,mBAAmB,EAAE,OAAO,EAAE,MAAM;CACpH;AAID,MAAM,WAAW,qBAAqB;IAAG,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AAGnE,kFAAkF;AAClF,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAU,OAAO,CAAC,QAAQ,CAAC,SAAS;IAAU,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAtE,IAAI,EAAE,MAAM,EAAmB,SAAS,EAAE,MAAM,EAAmB,GAAG,eAAW;IAE9G,OAAO,CAAC,IAAI;IAqBZ,OAAO,CAAC,MAAM;IAiBd,OAAO,CAAC,IAAI;IAYZ,OAAO,CAAC,MAAM;IAwBd,MAAM,CAAC,UAAU,EAAE,qBAAqB,GAAG,IAAI;IAe/C,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAOlC,IAAI,CAAC,OAAO,EAAE,OAAO;;;;;;;;;;;;;;;;;;;CAetB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,OAAO,GAAG,MAAM,IAAI,CA2B/H"}

package/dist/brain/mcp-presence.js

@@ -0,0 +1,214 @@
+import { randomUUID } from 'node:crypto';
+import { closeSync, linkSync, lstatSync, openSync, unlinkSync } from 'node:fs';
+import { join } from 'node:path';
+import { DatabaseSync } from 'node:sqlite';
+import { ensureProjectDirectory, projectLocalPath } from './project-kit-paths.js';
+export const MCP_PRESENCE_FILE = 'mcp-presence.sqlite';
+export const MCP_PRESENCE_LIMITS = Object.freeze({ connections: 128, renewMs: 10000, ttlMs: 30000, storeBytes: 1024 * 1024 });
+const directory = '.shadow-brain';
+const identity = /^mcp-[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/u;
+const label = /^[A-Za-z0-9][A-Za-z0-9_. -]{0,63}$/u;
+const time = (value) => typeof value === 'number' && Number.isSafeInteger(value) && value >= 0 && value <= 8.64e15 - MCP_PRESENCE_LIMITS.ttlMs;
+const pause = new Int32Array(new SharedArrayBuffer(4));
+const startupRetryMs = [100, 300, 900];
+export class MCPPresenceError extends Error {
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.status = 503;
+        this.name = 'MCPPresenceError';
+    }
+}
+const unavailable = () => new MCPPresenceError('MCP_PRESENCE_UNAVAILABLE', 'MCP connection presence could not be read or updated.');
+const busy = () => new MCPPresenceError('MCP_PRESENCE_BUSY', 'MCP connection presence is busy. Retry shortly.');
+/** A local stdio connection heartbeat, independent of host or model execution. */
+export class MCPPresenceStore {
+    constructor(root, projectId, now = Date.now) {
+        this.root = root;
+        this.projectId = projectId;
+        this.now = now;
+    }
+    file() {
+        const parent = projectLocalPath(this.root, directory);
+        const stat = lstatSync(parent, { throwIfNoEntry: false });
+        if (stat && (!stat.isDirectory() || stat.isSymbolicLink()))
+            throw unavailable();
+        const filename = join(parent, MCP_PRESENCE_FILE);
+        for (const suffix of ['-journal', '-wal', '-shm']) {
+            const sidecar = lstatSync(filename + suffix, { throwIfNoEntry: false });
+            if (sidecar && (!sidecar.isFile() || sidecar.isSymbolicLink() || sidecar.nlink !== 1 || sidecar.size > MCP_PRESENCE_LIMITS.storeBytes))
+                throw unavailable();
+        }
+        const deadline = performance.now() + 100;
+        for (;;) {
+            const entry = lstatSync(filename, { throwIfNoEntry: false });
+            if (!entry)
+                return { filename, exists: false };
+            if (!entry.isFile() || entry.isSymbolicLink() || entry.size > MCP_PRESENCE_LIMITS.storeBytes)
+                throw unavailable();
+            if (entry.nlink === 1)
+                return { filename, exists: true };
+            if (performance.now() >= deadline)
+                throw unavailable();
+            // A competing first writer briefly links a fully initialized database into place.
+            Atomics.wait(pause, 0, 0, 4);
+        }
+    }
+    create(filename) {
+        const temporary = projectLocalPath(this.root, `${directory}/${MCP_PRESENCE_FILE}.${randomUUID()}.tmp`);
+        closeSync(openSync(temporary, 'wx', 0o600));
+        try {
+            const db = new DatabaseSync(temporary, { allowExtension: false });
+            try {
+                db.exec(`PRAGMA trusted_schema=OFF; BEGIN IMMEDIATE;
+          CREATE TABLE metadata (project TEXT PRIMARY KEY, version INTEGER NOT NULL) STRICT;
+          CREATE TABLE leases (id TEXT PRIMARY KEY, tool TEXT NOT NULL, startedAt INTEGER NOT NULL, lastSeenAt INTEGER NOT NULL) STRICT;`);
+                db.prepare('INSERT INTO metadata VALUES (?,1)').run(this.projectId);
+                db.exec('COMMIT');
+            }
+            finally {
+                db.close();
+            }
+            try {
+                linkSync(temporary, filename);
+            }
+            catch (error) {
+                if (error.code !== 'EEXIST')
+                    throw error;
+            }
+        }
+        finally {
+            unlinkSync(temporary);
+        }
+    }
+    rows(db) {
+        const metadata = db.prepare('SELECT project,version FROM metadata LIMIT 2').all();
+        if (metadata.length !== 1 || metadata[0].project !== this.projectId || metadata[0].version !== 1)
+            throw unavailable();
+        const rows = db.prepare('SELECT id,tool,startedAt,lastSeenAt FROM leases LIMIT ?').all(MCP_PRESENCE_LIMITS.connections + 1);
+        if (rows.length > MCP_PRESENCE_LIMITS.connections)
+            throw unavailable();
+        return rows.map(row => {
+            if (typeof row.id !== 'string' || !identity.test(row.id) || typeof row.tool !== 'string' || !label.test(row.tool) ||
+                !time(row.startedAt) || !time(row.lastSeenAt) || Number(row.startedAt) > Number(row.lastSeenAt))
+                throw unavailable();
+            return { id: row.id, tool: row.tool, startedAt: Number(row.startedAt), lastSeenAt: Number(row.lastSeenAt) };
+        });
+    }
+    access(mode, absent, use) {
+        let db;
+        try {
+            const target = this.file();
+            if (!target.exists && mode !== 'report')
+                return absent;
+            if (!target.exists) {
+                ensureProjectDirectory(this.root, directory);
+                this.create(target.filename);
+                if (!this.file().exists)
+                    throw unavailable();
+            }
+            db = new DatabaseSync(target.filename, { readOnly: mode === 'read', allowExtension: false });
+            db.exec('PRAGMA busy_timeout=100; PRAGMA trusted_schema=OFF; ' + (mode === 'read' ? 'BEGIN;' : 'BEGIN IMMEDIATE;'));
+            const result = use(db, this.rows(db));
+            db.exec('COMMIT');
+            return result;
+        }
+        catch (error) {
+            // Closing a failed transaction rolls it back before returning an unavailable result.
+            if (error instanceof MCPPresenceError)
+                throw error;
+            const sqliteCode = error?.errcode;
+            if (typeof sqliteCode === 'number' && [5, 6].includes(sqliteCode & 0xff))
+                throw busy();
+            throw unavailable();
+        }
+        finally {
+            db?.close();
+        }
+    }
+    report(connection) {
+        if (!identity.test(connection.id) || !label.test(connection.tool))
+            throw unavailable();
+        this.access('report', undefined, (db, rows) => {
+            const now = this.now();
+            if (!time(now))
+                throw unavailable();
+            const oldest = now - MCP_PRESENCE_LIMITS.ttlMs;
+            const retained = rows.filter(row => row.lastSeenAt > oldest);
+            const current = retained.find(row => row.id === connection.id);
+            if ((current && current.tool !== connection.tool) || (current && current.lastSeenAt > now))
+                throw unavailable();
+            if (!current && retained.length >= MCP_PRESENCE_LIMITS.connections)
+                throw new MCPPresenceError('MCP_PRESENCE_LIMIT', 'The project reached its reporting connection limit.');
+            db.prepare('DELETE FROM leases WHERE lastSeenAt<=?').run(oldest);
+            db.prepare(`INSERT INTO leases VALUES (?,?,?,?) ON CONFLICT(id) DO UPDATE SET lastSeenAt=excluded.lastSeenAt`).run(connection.id, connection.tool, now, now);
+        });
+    }
+    remove(connectionId) {
+        if (!identity.test(connectionId))
+            throw unavailable();
+        this.access('remove', undefined, (db, rows) => {
+            if (rows.some(row => row.id === connectionId))
+                db.prepare('DELETE FROM leases WHERE id=?').run(connectionId);
+        });
+    }
+    read(enabled) {
+        const rows = enabled ? this.access('read', [], (_db, stored) => stored) : [];
+        // Sample the clock after the snapshot, so a parallel write cannot look newer than the read.
+        const checkedAt = this.now();
+        if (!time(checkedAt))
+            throw unavailable();
+        const connections = rows.filter(row => row.lastSeenAt <= checkedAt && checkedAt - row.lastSeenAt < MCP_PRESENCE_LIMITS.ttlMs)
+            .sort((a, b) => a.tool.localeCompare(b.tool) || a.id.localeCompare(b.id)).map(row => ({ id: row.id, tool: row.tool,
+            startedAt: new Date(row.startedAt).toISOString(), lastSeenAt: new Date(row.lastSeenAt).toISOString(),
+            expiresAt: new Date(row.lastSeenAt + MCP_PRESENCE_LIMITS.ttlMs).toISOString(), ageMs: checkedAt - row.lastSeenAt }));
+        const counts = new Map();
+        for (const connection of connections)
+            counts.set(connection.tool, (counts.get(connection.tool) ?? 0) + 1);
+        return { projectId: this.projectId, enabled, count: enabled ? connections.length : null, checkedAt: new Date(checkedAt).toISOString(),
+            expiresAfterMs: MCP_PRESENCE_LIMITS.ttlMs, connections, tools: [...counts].map(([tool, count]) => ({ tool, count })) };
+    }
+}
+export function startMCPPresence(store, connection, enabled) {
+    let recorded = false;
+    let retry;
+    const remove = () => {
+        if (!recorded)
+            return;
+        try {
+            store.remove(connection.id);
+            recorded = false;
+        }
+        catch { /* Expiry remains the fallback. */ }
+    };
+    const renew = () => {
+        let active;
+        try {
+            active = enabled();
+        }
+        catch {
+            active = false;
+        }
+        try {
+            if (!active) {
+                remove();
+                return;
+            }
+            store.report(connection);
+            recorded = true;
+        }
+        catch (error) {
+            // Presence must not affect the MCP transport.
+            return error instanceof MCPPresenceError && error.code === 'MCP_PRESENCE_BUSY';
+        }
+    };
+    const start = (attempt) => {
+        if (renew() && attempt < startupRetryMs.length) {
+            retry = setTimeout(() => start(attempt + 1), startupRetryMs[attempt]).unref();
+        }
+    };
+    start(0);
+    const timer = setInterval(renew, MCP_PRESENCE_LIMITS.renewMs).unref();
+    return () => { clearInterval(timer); clearTimeout(retry); remove(); };
+}
+//# sourceMappingURL=mcp-presence.js.map

package/dist/brain/mcp-presence.js.map

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

package/dist/brain/mcp-server.d.ts

@@ -1,12 +1,31 @@
 import { MCPRequest, MCPResponse, MCPServerOptions } from '../types.js';
+import type { GlobalBrain } from './global-brain.js';
+import type { FeatureSettingsStore } from './feature-settings.js';
+export interface MCPMemoryDependencies {
+    brain?: GlobalBrain;
+    settings?: FeatureSettingsStore;
+    projectDir?: string;
+    projectId?: string;
+    localProject?: boolean;
+}
 export declare class MCPServer {
+    private readonly dependencies;
     private orchestrator;
     private options;
     private server;
     private sseClients;
     private lastHealthScore;
     private toolHandlers;
-    constructor(orchestrator: any, options?: MCPServerOptions);
+    private readonly telemetrySession;
+    private telemetryAgent;
+    private reportedSessionTool;
+    private telemetryInitialized;
+    private telemetryWarning;
+    private stopStdioPresence?;
+    private hub?;
+    private hubClosing;
+    private readonly hubRequests;
+    constructor(orchestrator: any, options?: MCPServerOptions, dependencies?: MCPMemoryDependencies);
     private handleSubagentSliver;
     private handleSubagentQuarantineList;
     private handleSubagentGraduate;
@@ -46,11 +65,19 @@ export declare class MCPServer {
     private handleSubconsciousInject;
     private handleGlobalRecall;
     private handleGlobalRecallScored;
+    private recallView;
+    private readProjectPolicy;
+    private assertToolParticipates;
+    private hiddenMemories;
+    private handleProjectPolicy;
     private handleGlobalStats;
     private handleGlobalStorageHealth;
     private handleWorkflowAnalyze;
     private handleWorkflowSkills;
     private handleContextPack;
+    private handleMemoryEvidence;
+    private handleMemoryInspect;
+    private handleMemoryHealth;
     private handleFeatureFlags;
     private handleAttachStatus;
     private handleGlobalTimeline;
@@ -63,6 +90,18 @@ export declare class MCPServer {
     start(): Promise<void>;
     stop(): Promise<void>;
     handleRequest(request: MCPRequest): Promise<MCPResponse>;
+    private handleProjectKit;
+    private hubAvailable;
+    private handleProjectHub;
+    private handleProjectSession;
+    private telemetryProject;
+    private recordMeasured;
+    /** Activated by a completed stdio handshake, separately from JSON-RPC initialize. */
+    startStdioPresence(): (() => void) | undefined;
+    finishMemorySession(): Promise<void>;
+    private handleUsageReport;
+    private handleActivityReport;
+    private validateMemoryArguments;
     private handleInitialize;
     private handleAnalyze;
     private handleHealth;

package/dist/brain/mcp-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../src/brain/mcp-server.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAW,gBAAgB,EAAc,MAAM,aAAa,CAAC;AAO7F,qBAAa,SAAS;IACpB,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,UAAU,CAAqC;IACvD,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,YAAY,CAAwE;gBAEhF,YAAY,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,gBAAgB;YAwF3C,oBAAoB;YAapB,4BAA4B;YAK5B,sBAAsB;YAItB,oBAAoB;YAIpB,gBAAgB;YAIhB,iBAAiB;YAIjB,qBAAqB;YAIrB,sBAAsB;YAYtB,mBAAmB;YAKnB,cAAc;YAId,eAAe;YAKf,oBAAoB;YAWpB,qBAAqB;YAKrB,qBAAqB;YAKrB,eAAe;YAIf,kBAAkB;YAIlB,iBAAiB;YAIjB,sBAAsB;YAQtB,kBAAkB;YAUlB,kBAAkB;YAIlB,uBAAuB;YAIvB,oBAAoB;YAIpB,uBAAuB;YAWvB,uBAAuB;YAKvB,kBAAkB;YAKlB,kBAAkB;YAKlB,mBAAmB;YAKnB,oBAAoB;YAKpB,uBAAuB;YAIvB,kBAAkB;YAIlB,oBAAoB;YAIpB,sBAAsB;YAUtB,oBAAoB;YAYpB,oBAAoB;YAIpB,kBAAkB;YAIlB,gBAAgB;YAoDhB,wBAAwB;YAcxB,kBAAkB;YAclB,wBAAwB;YAexB,iBAAiB;YAWjB,yBAAyB;YAKzB,qBAAqB;YASrB,oBAAoB;YAMpB,iBAAiB;YAmBjB,kBAAkB;YAKlB,kBAAkB;YAOlB,oBAAoB;YAapB,mBAAmB;YAWnB,kBAAkB;IAYhC,OAAO,CAAC,qBAAqB;YAMf,qBAAqB;YAUrB,oBAAoB;YASpB,wBAAwB;IAahC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAuEtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsBrB,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IAoD9D,OAAO,CAAC,gBAAgB;YAiBV,aAAa;YAgBb,YAAY;YAwBZ,WAAW;YAgBX,aAAa;YAeb,cAAc;YAmBd,UAAU;YAeV,WAAW;YAWX,YAAY;YAkCZ,YAAY;YAsBZ,eAAe;YAyBf,WAAW;YAkBX,WAAW;YAkBX,eAAe;YAkBf,oBAAoB;YAkBpB,aAAa;YAUb,SAAS;YAuCT,YAAY;YAQZ,aAAa;YAgCb,gBAAgB;IAqB9B,OAAO,CAAC,kBAAkB;YA0VZ,oBAAoB;IA2BlC,OAAO,CAAC,mBAAmB;IAoB3B,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,eAAe;IAwBvB,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,SAAS;CAGlB"}
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../src/brain/mcp-server.ts"],"names":[],"mappings":"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"}