@brainmcp/brainmcp 0.1.12 → 0.1.13

package/dist/runtime/installer.js.map

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

package/dist/runtime/lock.d.ts

@@ -0,0 +1,19 @@
+export interface LockMetadata {
+    pid: number;
+    createdAt: number;
+    sessionId: string;
+    owner?: string;
+}
+export declare function getSessionLockPath(sessionId: string, baseDir?: string): string;
+export declare function isProcessAlive(pid: number): boolean;
+export declare function acquireSessionLock(sessionId: string, options?: {
+    baseDir?: string;
+    timeoutMs?: number;
+    now?: number;
+}): Promise<{
+    release: () => void;
+}>;
+export declare function withSessionLock<T>(sessionId: string, fn: () => Promise<T> | T, options?: {
+    baseDir?: string;
+    timeoutMs?: number;
+}): Promise<T>;

package/dist/runtime/lock.js

@@ -0,0 +1,116 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { ensureDirectory0700, assertNotSymlink, resolveStateDir } from './storage.js';
+const STALE_LOCK_MS = 5000;
+export function getSessionLockPath(sessionId, baseDir) {
+    const locksDir = path.join(resolveStateDir(baseDir), 'locks');
+    ensureDirectory0700(locksDir);
+    // Sanitize sessionId for safe filename
+    const safeSessionId = sessionId.replace(/[^a-zA-Z0-9_-]/g, '_');
+    return path.join(locksDir, `${safeSessionId}.lock`);
+}
+export function isProcessAlive(pid) {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        return err.code === 'EPERM'; // Exists but belongs to another user
+    }
+}
+export async function acquireSessionLock(sessionId, options) {
+    const lockPath = getSessionLockPath(sessionId, options?.baseDir);
+    const timeoutMs = options?.timeoutMs ?? 5000;
+    const startTime = Date.now();
+    const pollInterval = 20;
+    while (true) {
+        try {
+            assertNotSymlink(lockPath);
+            // Try atomic exclusive file creation (flag 'wx')
+            const metadata = {
+                pid: process.pid,
+                createdAt: Date.now(),
+                sessionId,
+                owner: randomUUID(),
+            };
+            fs.writeFileSync(lockPath, JSON.stringify(metadata), { flag: 'wx', mode: 0o600 });
+            // Acquired lock successfully
+            let released = false;
+            return {
+                release: () => {
+                    if (released)
+                        return;
+                    released = true;
+                    try {
+                        if (fs.existsSync(lockPath)) {
+                            // Verify we still own this lock before unlinking
+                            const content = fs.readFileSync(lockPath, 'utf8');
+                            const parsed = JSON.parse(content);
+                            if (parsed.owner === metadata.owner) {
+                                fs.unlinkSync(lockPath);
+                            }
+                        }
+                    }
+                    catch {
+                        // Ignore release errors
+                    }
+                },
+            };
+        }
+        catch (err) {
+            if (err.code === 'EEXIST') {
+                const now = Date.now();
+                try {
+                    const raw = fs.readFileSync(lockPath, 'utf8');
+                    const meta = JSON.parse(raw);
+                    const age = now - meta.createdAt;
+                    // Stale if older than STALE_LOCK_MS and process is dead, or older than 2x STALE_LOCK_MS
+                    if (age > STALE_LOCK_MS && !isProcessAlive(meta.pid)) {
+                        // Recover stale lock: remove it and retry immediately
+                        try {
+                            fs.unlinkSync(lockPath);
+                            continue;
+                        }
+                        catch {
+                            // Concurrently unlinked or retried
+                        }
+                    }
+                }
+                catch {
+                    // Corrupt lock file -> recover by removing
+                    try {
+                        // An exclusive creator may not yet have written its metadata.
+                        if (now - fs.lstatSync(lockPath).mtimeMs > STALE_LOCK_MS) {
+                            fs.unlinkSync(lockPath);
+                            continue;
+                        }
+                    }
+                    catch {
+                        // Ignore
+                    }
+                }
+                // Check if timeout reached
+                if (now - startTime > timeoutMs) {
+                    throw new Error(`Timed out waiting for session lock: ${sessionId} (waited ${now - startTime}ms)`);
+                }
+                // Asynchronously sleep before retrying
+                await new Promise((resolve) => setTimeout(resolve, pollInterval));
+                continue;
+            }
+            throw err;
+        }
+    }
+}
+export async function withSessionLock(sessionId, fn, options) {
+    const lock = await acquireSessionLock(sessionId, options);
+    try {
+        return await fn();
+    }
+    finally {
+        lock.release();
+    }
+}
+//# sourceMappingURL=lock.js.map

package/dist/runtime/lock.js.map

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

package/dist/runtime/orient.d.ts

@@ -0,0 +1,55 @@
+import { ApiClient } from '../lib/api-client.js';
+import type { StoredCredentials } from '../lib/credentials.js';
+export declare const SESSION_START_EVENTS: Set<string>;
+export declare function isSessionStartEvent(event: string): boolean;
+export declare function isUserPromptEvent(event: string): boolean;
+export interface OrientWorkspace {
+    id: string;
+    name?: string;
+    slug?: string;
+    isDefault?: boolean;
+}
+export declare function resolveOrientWorkspaceId(creds: StoredCredentials | null, listed?: OrientWorkspace[]): {
+    workspaceId: string | null;
+    reason: 'ok' | 'login' | 'select';
+};
+export declare function formatOrientAdditionalContext(payload: unknown): string;
+export declare function loginOrientationMessage(): string;
+export declare function selectWorkspaceOrientationMessage(): string;
+export type ProjectWorkspaceResolution = {
+    kind: 'none';
+} | {
+    kind: 'invalid';
+    configPath: string;
+} | {
+    kind: 'workspace';
+    configPath: string;
+    workspaceId: string;
+};
+/** Resolve only the nearest project policy file; malformed/symlinked files fail closed. */
+export declare function readProjectWorkspaceId(startDir?: string): ProjectWorkspaceResolution;
+export declare function readOrientCache(creds: StoredCredentials, workspaceId: string, options?: {
+    baseDir?: string;
+    now?: number;
+}): string | null;
+export declare function writeOrientCache(creds: StoredCredentials, workspaceId: string, context: string, options?: {
+    baseDir?: string;
+    now?: number;
+}): void;
+export declare function clearOrientCache(baseDir?: string): void;
+export declare function fetchSessionStartOrientation(input: {
+    apiClient: ApiClient;
+    creds: StoredCredentials | null;
+    signal?: AbortSignal;
+    baseDir?: string;
+    cwd?: string;
+    workspaceRoots?: string[];
+}): Promise<string>;
+export declare function safeSessionStartOrientation(input: {
+    apiClient?: ApiClient;
+    creds: StoredCredentials | null;
+    signal?: AbortSignal;
+    baseDir?: string;
+    cwd?: string;
+    workspaceRoots?: string[];
+}): Promise<string>;

package/dist/runtime/orient.js

@@ -0,0 +1,255 @@
+import { createHash } from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+import { ensureDirectory0700, writeAtomic0600, readSafeJson, resolveStateDir, } from './storage.js';
+import { logRuntimeEvent } from './diagnostics.js';
+const ORIENT_CACHE_TTL_MS = 10 * 60 * 1000;
+const ORIENT_CONTEXT_MAX_CHARS = 2_400;
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+export const SESSION_START_EVENTS = new Set([
+    'SessionStart',
+    'sessionStart',
+    'session_start',
+    'startup',
+]);
+export function isSessionStartEvent(event) {
+    return SESSION_START_EVENTS.has(event);
+}
+export function isUserPromptEvent(event) {
+    return event === 'UserPromptSubmit' || event === 'UserPrompt' || event === 'prompt' || event === 'beforeSubmitPrompt';
+}
+export function resolveOrientWorkspaceId(creds, listed) {
+    if (!creds || creds.authType !== 'oauth' || !creds.accessToken) {
+        return { workspaceId: null, reason: 'login' };
+    }
+    if (creds.defaultWorkspaceId && UUID_RE.test(creds.defaultWorkspaceId)) {
+        return { workspaceId: creds.defaultWorkspaceId, reason: 'ok' };
+    }
+    const fromCreds = (creds.workspaces ?? []).filter((id) => UUID_RE.test(id));
+    if (fromCreds.length === 1) {
+        return { workspaceId: fromCreds[0], reason: 'ok' };
+    }
+    if (listed) {
+        const defaults = listed.filter((ws) => ws.isDefault);
+        if (defaults.length === 1 && UUID_RE.test(defaults[0].id)) {
+            return { workspaceId: defaults[0].id, reason: 'ok' };
+        }
+        if (listed.length === 1 && UUID_RE.test(listed[0].id)) {
+            return { workspaceId: listed[0].id, reason: 'ok' };
+        }
+        if (listed.length !== 1) {
+            return { workspaceId: null, reason: 'select' };
+        }
+    }
+    if (fromCreds.length !== 1) {
+        return { workspaceId: null, reason: fromCreds.length === 0 ? 'select' : 'select' };
+    }
+    return { workspaceId: null, reason: 'select' };
+}
+export function formatOrientAdditionalContext(payload) {
+    if (!payload || typeof payload !== 'object') {
+        return 'BrainMCP orientation is available. Call brain_workspace_overview before non-trivial work.';
+    }
+    const data = payload;
+    const lines = ['BrainMCP orientation (no user prompt was sent).'];
+    const workspace = data.workspace && typeof data.workspace === 'object'
+        ? data.workspace
+        : undefined;
+    if (typeof workspace?.name === 'string') {
+        lines.push(`Workspace: ${workspace.name}`);
+    }
+    const review = data.review && typeof data.review === 'object'
+        ? data.review
+        : undefined;
+    if (typeof review?.writePath === 'string') {
+        lines.push(`Write path: ${review.writePath}`);
+    }
+    if (review?.humanReviewRequired === true) {
+        lines.push('Human review is required before graph writes apply.');
+    }
+    if (typeof data.pendingProposalCount === 'number' && data.pendingProposalCount > 0) {
+        lines.push(`Pending proposals: ${data.pendingProposalCount}`);
+    }
+    if (typeof data.dueWorkflowCount === 'number' && data.dueWorkflowCount > 0) {
+        lines.push(`Due workflows: ${data.dueWorkflowCount}`);
+    }
+    const rules = data.rules && typeof data.rules === 'object'
+        ? data.rules
+        : undefined;
+    for (const rule of rules?.items?.slice(0, 3) ?? []) {
+        if (typeof rule.body === 'string' && rule.body.trim()) {
+            lines.push(`Rule: ${rule.body.trim().slice(0, 280)}`);
+        }
+    }
+    if (typeof data.writeBackHint === 'string' && data.writeBackHint.trim()) {
+        lines.push(data.writeBackHint.trim());
+    }
+    else {
+        lines.push('Propose only new durable project knowledge with brain_change_propose after meaningful work.');
+    }
+    const text = lines.join('\n');
+    return text.length > ORIENT_CONTEXT_MAX_CHARS ? `${text.slice(0, ORIENT_CONTEXT_MAX_CHARS - 1)}…` : text;
+}
+export function loginOrientationMessage() {
+    return 'BrainMCP CLI is not signed in. Run `brainmcp login`, then retry orientation. No remote request was made.';
+}
+export function selectWorkspaceOrientationMessage() {
+    return 'BrainMCP has more than one authorized workspace. Pass workspaceId or set a default before orientation. No workspace was guessed.';
+}
+/** Resolve only the nearest project policy file; malformed/symlinked files fail closed. */
+export function readProjectWorkspaceId(startDir) {
+    if (!startDir)
+        return { kind: 'none' };
+    let dir = path.resolve(startDir);
+    for (let depth = 0; depth < 16; depth += 1) {
+        const configPath = path.join(dir, '.brainmcp.json');
+        if (fs.existsSync(configPath)) {
+            try {
+                const stat = fs.lstatSync(configPath);
+                if (!stat.isFile() || stat.isSymbolicLink() || stat.size > 64 * 1024) {
+                    return { kind: 'invalid', configPath };
+                }
+                const parsed = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+                const workspaceId = typeof parsed.workspaceId === 'string' ? parsed.workspaceId.trim() : '';
+                return UUID_RE.test(workspaceId)
+                    ? { kind: 'workspace', configPath, workspaceId }
+                    : { kind: 'invalid', configPath };
+            }
+            catch {
+                return { kind: 'invalid', configPath };
+            }
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return { kind: 'none' };
+}
+function invalidProjectWorkspaceMessage() {
+    return 'BrainMCP found an invalid nearest `.brainmcp.json` workspaceId and did not guess another workspace. Fix or remove that project policy file.';
+}
+function cacheKey(creds, workspaceId) {
+    const scopes = [...(creds.scopes ?? [])].sort().join(' ');
+    const identity = creds.authorizationId
+        || createHash('sha256')
+            .update(creds.refreshToken || creds.accessToken || creds.serviceToken || creds.clientId || '')
+            .digest('hex');
+    return createHash('sha256')
+        .update(JSON.stringify({
+        authorizationId: identity,
+        scopes,
+        workspaceId,
+        contract: '2026-09-02.orient-v1',
+    }))
+        .digest('hex');
+}
+function cachePath(baseDir, key) {
+    const dir = path.join(resolveStateDir(baseDir), 'cache');
+    ensureDirectory0700(dir);
+    return path.join(dir, `orient-${key.slice(0, 24)}.json`);
+}
+export function readOrientCache(creds, workspaceId, options) {
+    const key = cacheKey(creds, workspaceId);
+    const record = readSafeJson(cachePath(options?.baseDir, key));
+    if (!record || record.key !== key)
+        return null;
+    const storedAt = Date.parse(record.storedAt);
+    if (!Number.isFinite(storedAt))
+        return null;
+    if ((options?.now ?? Date.now()) - storedAt > ORIENT_CACHE_TTL_MS)
+        return null;
+    return record.context;
+}
+export function writeOrientCache(creds, workspaceId, context, options) {
+    const key = cacheKey(creds, workspaceId);
+    writeAtomic0600(cachePath(options?.baseDir, key), JSON.stringify({
+        key,
+        storedAt: new Date(options?.now ?? Date.now()).toISOString(),
+        context,
+    }));
+}
+export function clearOrientCache(baseDir) {
+    const dir = path.join(resolveStateDir(baseDir), 'cache');
+    if (!fs.existsSync(dir))
+        return;
+    for (const entry of fs.readdirSync(dir)) {
+        if (!entry.startsWith('orient-') || !entry.endsWith('.json'))
+            continue;
+        try {
+            fs.unlinkSync(path.join(dir, entry));
+        }
+        catch {
+            // Best-effort account-switch isolation.
+        }
+    }
+}
+export async function fetchSessionStartOrientation(input) {
+    const initial = resolveOrientWorkspaceId(input.creds);
+    if (initial.reason === 'login') {
+        return loginOrientationMessage();
+    }
+    const roots = (input.workspaceRoots?.length ? input.workspaceRoots : input.cwd ? [input.cwd] : [])
+        .filter((root, index, all) => Boolean(root) && all.indexOf(root) === index);
+    const projectResolutions = roots.map((root) => readProjectWorkspaceId(root));
+    if (projectResolutions.some((resolution) => resolution.kind === 'invalid')) {
+        return invalidProjectWorkspaceMessage();
+    }
+    const projectWorkspaceIds = projectResolutions
+        .filter((resolution) => resolution.kind === 'workspace')
+        .map((resolution) => resolution.workspaceId);
+    const hasUnboundRoot = roots.length === 0 || projectResolutions.some((resolution) => resolution.kind === 'none');
+    let fallbackWorkspaceId = initial.workspaceId;
+    if (hasUnboundRoot && !fallbackWorkspaceId) {
+        try {
+            const listed = await input.apiClient.request('/api/mcp/workspaces', { timeoutMs: 800, signal: input.signal });
+            const next = resolveOrientWorkspaceId(input.creds, listed.workspaces ?? []);
+            fallbackWorkspaceId = next.workspaceId;
+        }
+        catch {
+            fallbackWorkspaceId = null;
+        }
+    }
+    const workspaceIds = [...new Set([
+            ...projectWorkspaceIds,
+            ...(hasUnboundRoot && fallbackWorkspaceId ? [fallbackWorkspaceId] : []),
+        ])];
+    if (workspaceIds.length === 0)
+        return selectWorkspaceOrientationMessage();
+    const results = await Promise.allSettled(workspaceIds.map(async (workspaceId) => {
+        const payload = await input.apiClient.request(`/api/workspaces/${workspaceId}/orient`, { timeoutMs: 800, signal: input.signal });
+        return formatOrientAdditionalContext(payload);
+    }));
+    const contexts = results
+        .filter((result) => result.status === 'fulfilled')
+        .map((result) => result.value);
+    if (contexts.length === 0) {
+        throw new Error('No project workspace orientation request succeeded.');
+    }
+    if (hasUnboundRoot && !fallbackWorkspaceId) {
+        contexts.push('One or more workspace roots have no resolvable project/default workspace; no workspace was guessed for those roots.');
+    }
+    // Correctness first: pending proposals, due workflows, decisions, rules, and
+    // active-ref guidance must be fresh. The exported cache helpers remain only
+    // for a future stable-section cache; complete orientation responses are
+    // never read from or written to disk by the hook path.
+    const combined = contexts.join('\n\n---\n\n');
+    return combined.length > ORIENT_CONTEXT_MAX_CHARS
+        ? `${combined.slice(0, ORIENT_CONTEXT_MAX_CHARS - 1)}…`
+        : combined;
+}
+export async function safeSessionStartOrientation(input) {
+    if (!input.apiClient) {
+        return input.creds?.authType === 'oauth'
+            ? selectWorkspaceOrientationMessage()
+            : loginOrientationMessage();
+    }
+    try {
+        return await fetchSessionStartOrientation(input);
+    }
+    catch (error) {
+        logRuntimeEvent('warn', 'orient_fetch_failed', { error: error instanceof Error ? error.message : String(error) }, input.baseDir);
+        return 'BrainMCP orientation is temporarily unavailable. Continue locally and retry brain_workspace_overview when possible.';
+    }
+}
+//# sourceMappingURL=orient.js.map

package/dist/runtime/orient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orient.js","sourceRoot":"","sources":["../../src/runtime/orient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,mBAAmB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAC3C,MAAM,wBAAwB,GAAG,KAAK,CAAC;AACvC,MAAM,OAAO,GAAG,iEAAiE,CAAC;AAElF,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IAC1C,cAAc;IACd,cAAc;IACd,eAAe;IACf,SAAS;CACV,CAAC,CAAC;AAEH,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,OAAO,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAO,KAAK,KAAK,kBAAkB,IAAI,KAAK,KAAK,YAAY,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,oBAAoB,CAAC;AACxH,CAAC;AASD,MAAM,UAAU,wBAAwB,CACtC,KAA+B,EAC/B,MAA0B;IAE1B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QAC/D,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAChD,CAAC;IACD,IAAI,KAAK,CAAC,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACvE,OAAO,EAAE,WAAW,EAAE,KAAK,CAAC,kBAAkB,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACjE,CAAC;IACD,MAAM,SAAS,GAAG,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5E,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC,CAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACtD,CAAC;IACD,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;QACrD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,EAAE,CAAC,EAAE,CAAC;YAC3D,OAAO,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACxD,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,EAAE,CAAC,EAAE,CAAC;YACvD,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,CAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACtD,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QACjD,CAAC;IACH,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IACrF,CAAC;IACD,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,OAAgB;IAC5D,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5C,OAAO,2FAA2F,CAAC;IACrG,CAAC;IACD,MAAM,IAAI,GAAG,OAAkC,CAAC;IAChD,MAAM,KAAK,GAAa,CAAC,iDAAiD,CAAC,CAAC;IAE5E,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ;QACpE,CAAC,CAAE,IAAI,CAAC,SAAqC;QAC7C,CAAC,CAAC,SAAS,CAAC;IACd,IAAI,OAAO,SAAS,EAAE,IAAI,KAAK,QAAQ,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,cAAc,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ;QAC3D,CAAC,CAAE,IAAI,CAAC,MAAkC;QAC1C,CAAC,CAAC,SAAS,CAAC;IACd,IAAI,OAAO,MAAM,EAAE,SAAS,KAAK,QAAQ,EAAE,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,MAAM,EAAE,mBAAmB,KAAK,IAAI,EAAE,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;IACpE,CAAC;IAED,IAAI,OAAO,IAAI,CAAC,oBAAoB,KAAK,QAAQ,IAAI,IAAI,CAAC,oBAAoB,GAAG,CAAC,EAAE,CAAC;QACnF,KAAK,CAAC,IAAI,CAAC,sBAAsB,IAAI,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,OAAO,IAAI,CAAC,gBAAgB,KAAK,QAAQ,IAAI,IAAI,CAAC,gBAAgB,GAAG,CAAC,EAAE,CAAC;QAC3E,KAAK,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ;QACxD,CAAC,CAAE,IAAI,CAAC,KAA8C;QACtD,CAAC,CAAC,SAAS,CAAC;IACd,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACnD,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YACtD,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED,IAAI,OAAO,IAAI,CAAC,aAAa,KAAK,QAAQ,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,CAAC;QACxE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,6FAA6F,CAAC,CAAC;IAC5G,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,IAAI,CAAC,MAAM,GAAG,wBAAwB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,wBAAwB,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3G,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAO,0GAA0G,CAAC;AACpH,CAAC;AAED,MAAM,UAAU,iCAAiC;IAC/C,OAAO,kIAAkI,CAAC;AAC5I,CAAC;AAOD,2FAA2F;AAC3F,MAAM,UAAU,sBAAsB,CAAC,QAAiB;IACtD,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACvC,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,EAAE,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;QACpD,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;gBACtC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,cAAc,EAAE,IAAI,IAAI,CAAC,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;oBACrE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;gBACzC,CAAC;gBACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAA4B,CAAC;gBAC1F,MAAM,WAAW,GAAG,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5F,OAAO,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC;oBAC9B,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE;oBAChD,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;YACtC,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;YACzC,CAAC;QACH,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QAC1B,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC1B,CAAC;AAED,SAAS,8BAA8B;IACrC,OAAO,6IAA6I,CAAC;AACvJ,CAAC;AAQD,SAAS,QAAQ,CAAC,KAAwB,EAAE,WAAmB;IAC7D,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,KAAK,CAAC,eAAe;WACjC,UAAU,CAAC,QAAQ,CAAC;aACpB,MAAM,CAAC,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;aAC7F,MAAM,CAAC,KAAK,CAAC,CAAC;IACnB,OAAO,UAAU,CAAC,QAAQ,CAAC;SACxB,MAAM,CACL,IAAI,CAAC,SAAS,CAAC;QACb,eAAe,EAAE,QAAQ;QACzB,MAAM;QACN,WAAW;QACX,QAAQ,EAAE,sBAAsB;KACjC,CAAC,CACH;SACA,MAAM,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC;AAED,SAAS,SAAS,CAAC,OAA2B,EAAE,GAAW;IACzD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IACzD,mBAAmB,CAAC,GAAG,CAAC,CAAC;IACzB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,KAAwB,EACxB,WAAmB,EACnB,OAA4C;IAE5C,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,YAAY,CAAoB,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;IACjF,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,GAAG,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC7C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,QAAQ,GAAG,mBAAmB;QAAE,OAAO,IAAI,CAAC;IAC/E,OAAO,MAAM,CAAC,OAAO,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,KAAwB,EACxB,WAAmB,EACnB,OAAe,EACf,OAA4C;IAE5C,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IACzC,eAAe,CACb,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,EAChC,IAAI,CAAC,SAAS,CAAC;QACb,GAAG;QACH,QAAQ,EAAE,IAAI,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE;QAC5D,OAAO;KACR,CAAC,CACH,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IACzD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO;IAChC,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;QACxC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,SAAS;QACvE,IAAI,CAAC;YACH,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,wCAAwC;QAC1C,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,KAOlD;IACC,MAAM,OAAO,GAAG,wBAAwB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACtD,IAAI,OAAO,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAC/B,OAAO,uBAAuB,EAAE,CAAC;IACnC,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SAC/F,MAAM,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC;IAC9E,MAAM,kBAAkB,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7E,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,KAAK,SAAS,CAAC,EAAE,CAAC;QAC3E,OAAO,8BAA8B,EAAE,CAAC;IAC1C,CAAC;IACD,MAAM,mBAAmB,GAAG,kBAAkB;SAC3C,MAAM,CAAC,CAAC,UAAU,EAA4E,EAAE,CAAC,UAAU,CAAC,IAAI,KAAK,WAAW,CAAC;SACjI,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IAC/C,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IAEjH,IAAI,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;IAC9C,IAAI,cAAc,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC3C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,OAAO,CAC1C,qBAAqB,EACrB,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CACzC,CAAC;YACF,MAAM,IAAI,GAAG,wBAAwB,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;YAC5E,mBAAmB,GAAG,IAAI,CAAC,WAAW,CAAC;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,mBAAmB,GAAG,IAAI,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC;YAC/B,GAAG,mBAAmB;YACtB,GAAG,CAAC,cAAc,IAAI,mBAAmB,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SACxE,CAAC,CAAC,CAAC;IACJ,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,iCAAiC,EAAE,CAAC;IAE1E,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE;QACrC,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,OAAO,CAC3C,mBAAmB,WAAW,SAAS,EACvC,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CACzC,CAAC;QACF,OAAO,6BAA6B,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC,CAAC,CACH,CAAC;IACF,MAAM,QAAQ,GAAG,OAAO;SACrB,MAAM,CAAC,CAAC,MAAM,EAA4C,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,WAAW,CAAC;SAC3F,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,cAAc,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC3C,QAAQ,CAAC,IAAI,CAAC,qHAAqH,CAAC,CAAC;IACvI,CAAC;IACD,6EAA6E;IAC7E,4EAA4E;IAC5E,wEAAwE;IACxE,uDAAuD;IACvD,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC9C,OAAO,QAAQ,CAAC,MAAM,GAAG,wBAAwB;QAC/C,CAAC,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,wBAAwB,GAAG,CAAC,CAAC,GAAG;QACvD,CAAC,CAAC,QAAQ,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,KAOjD;IACC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO;YACtC,CAAC,CAAC,iCAAiC,EAAE;YACrC,CAAC,CAAC,uBAAuB,EAAE,CAAC;IAChC,CAAC;IACD,IAAI,CAAC;QACH,OAAO,MAAM,4BAA4B,CAAC,KAOzC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,eAAe,CACb,MAAM,EACN,qBAAqB,EACrB,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EACjE,KAAK,CAAC,OAAO,CACd,CAAC;QACF,OAAO,qHAAqH,CAAC;IAC/H,CAAC;AACH,CAAC"}

package/dist/runtime/queue.d.ts

@@ -0,0 +1,7 @@
+import { type QueueItemRecord } from '../lib/cli-contracts.js';
+export declare function getQueueDir(baseDir?: string): string;
+export declare function getQueueItemPath(digestId: string, baseDir?: string): string;
+export declare function enqueueCaptureItem(item: Omit<QueueItemRecord, 'version' | 'createdAt' | 'updatedAt' | 'attempts' | 'status'>, baseDir?: string): QueueItemRecord;
+export declare function listQueueItems(baseDir?: string): QueueItemRecord[];
+export declare function updateQueueItem(digestId: string, updates: Partial<Pick<QueueItemRecord, 'status' | 'attempts' | 'nextRetryAt' | 'lastError' | 'deliveredAt' | 'deliveryLease'>>, baseDir?: string): QueueItemRecord | null;
+export declare function removeQueueItem(digestId: string, baseDir?: string): boolean;

package/dist/runtime/queue.js

@@ -0,0 +1,80 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { QUEUE_SCHEMA_VERSION, validateQueueItemRecord, } from '../lib/cli-contracts.js';
+import { ensureDirectory0700, writeAtomic0600, readSafeJson, assertNotSymlink, resolveStateDir, } from './storage.js';
+export function getQueueDir(baseDir) {
+    const queueDir = path.join(resolveStateDir(baseDir), 'queue');
+    ensureDirectory0700(queueDir);
+    return queueDir;
+}
+export function getQueueItemPath(digestId, baseDir) {
+    const queueDir = getQueueDir(baseDir);
+    const safeId = digestId.replace(/[^a-zA-Z0-9_-]/g, '_');
+    return path.join(queueDir, `${safeId}.json`);
+}
+export function enqueueCaptureItem(item, baseDir) {
+    const now = new Date().toISOString();
+    const record = {
+        version: QUEUE_SCHEMA_VERSION,
+        digestId: item.digestId,
+        workspaceId: item.workspaceId,
+        captureTrigger: item.captureTrigger,
+        policyVersion: item.policyVersion,
+        digestText: item.digestText,
+        authorizationId: item.authorizationId,
+        consentRevision: item.consentRevision,
+        status: 'pending',
+        attempts: 0,
+        createdAt: now,
+        updatedAt: now,
+    };
+    const filePath = getQueueItemPath(record.digestId, baseDir);
+    writeAtomic0600(filePath, JSON.stringify(record, null, 2));
+    return record;
+}
+export function listQueueItems(baseDir) {
+    const queueDir = getQueueDir(baseDir);
+    const entries = fs.readdirSync(queueDir);
+    const items = [];
+    for (const entry of entries) {
+        if (!entry.endsWith('.json'))
+            continue;
+        const filePath = path.join(queueDir, entry);
+        try {
+            assertNotSymlink(filePath);
+            const item = readSafeJson(filePath, validateQueueItemRecord);
+            if (item) {
+                items.push(item);
+            }
+        }
+        catch {
+            // Corrupted items skipped in listing
+        }
+    }
+    // Sort by createdAt ascending
+    return items.sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+}
+export function updateQueueItem(digestId, updates, baseDir) {
+    const filePath = getQueueItemPath(digestId, baseDir);
+    const existing = readSafeJson(filePath, validateQueueItemRecord);
+    if (!existing) {
+        return null;
+    }
+    const updated = {
+        ...existing,
+        ...updates,
+        updatedAt: new Date().toISOString(),
+    };
+    writeAtomic0600(filePath, JSON.stringify(updated, null, 2));
+    return updated;
+}
+export function removeQueueItem(digestId, baseDir) {
+    const filePath = getQueueItemPath(digestId, baseDir);
+    if (fs.existsSync(filePath)) {
+        assertNotSymlink(filePath);
+        fs.unlinkSync(filePath);
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=queue.js.map

package/dist/runtime/queue.js.map

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

package/dist/runtime/retention.d.ts

@@ -0,0 +1,26 @@
+export interface PruneOptions {
+    baseDir?: string;
+    maxQueueAgeMs?: number;
+    maxSessionAgeMs?: number;
+    maxLogSizeBytes?: number;
+    now?: number;
+}
+export interface PruneResult {
+    prunedQueueCount: number;
+    prunedSessionCount: number;
+    prunedLockCount: number;
+    logRotated: boolean;
+}
+export interface CapturePurgePreview {
+    queueItems: number;
+    sessionLedgers: number;
+    orientationCacheFiles: number;
+}
+export declare function previewCapturePurge(baseDir?: string): CapturePurgePreview;
+/** Delete only BrainMCP-owned queue, session-ledger, and orientation-cache files. */
+export declare function purgeCaptureLocalState(baseDir?: string): CapturePurgePreview;
+/**
+ * Safely prunes expired queue items, old session ledgers, stale locks, and trims logs (AHI-058).
+ * Never touches active credentials or installed runtime files.
+ */
+export declare function pruneLocalState(options?: PruneOptions): PruneResult;