@maadb/core 0.0.1 → 0.7.9

package/dist/mcp/transport/telemetry.js

@@ -0,0 +1,97 @@
+// ============================================================================
+// Transport telemetry — process-level counters surfaced by maad_health.
+//
+// Holds the transport posture (kind/host/port/startedAt) decided at boot and
+// session lifecycle counters fed by the HTTP transport. Stdio initializes the
+// transport block with kind=stdio and leaves the session counters at zero —
+// stdio is a single implicit session so open/close events aren't emitted.
+// ============================================================================
+import { getAuditLog, getOpsLog } from '../../logging.js';
+let state = null;
+export function initTransportTelemetry(info) {
+    const now = Date.now();
+    state = {
+        info: {
+            kind: info.kind,
+            host: info.host,
+            port: info.port,
+            socketPath: info.socketPath,
+            startedAt: new Date(now).toISOString(),
+        },
+        startedAtMs: now,
+        counters: {
+            openedTotal: 0,
+            closedTotal: 0,
+            lastOpenedAt: null,
+            lastClosedAt: null,
+            idleSweepLastRunAt: null,
+        },
+        openedAtMsBySession: new Map(),
+    };
+}
+/**
+ * Test hook — resets telemetry state so each test starts clean.
+ */
+export function __resetTransportTelemetry() {
+    state = null;
+}
+export function recordSessionOpen(fields) {
+    // Safe no-op when telemetry is uninitialized. Test harnesses exercise the
+    // transport in isolation without calling startServer — they shouldn't have
+    // to bootstrap telemetry just to run a smoke test.
+    if (!state)
+        return;
+    const now = Date.now();
+    state.counters.openedTotal += 1;
+    state.counters.lastOpenedAt = new Date(now).toISOString();
+    state.openedAtMsBySession.set(fields.session_id, now);
+    getAuditLog().info(fields, 'session_open');
+}
+export function recordSessionClose(args) {
+    if (!state)
+        return;
+    const now = Date.now();
+    const openedAt = state.openedAtMsBySession.get(args.session_id);
+    const durationMs = openedAt !== undefined ? now - openedAt : 0;
+    if (openedAt !== undefined)
+        state.openedAtMsBySession.delete(args.session_id);
+    state.counters.closedTotal += 1;
+    state.counters.lastClosedAt = new Date(now).toISOString();
+    const fields = {
+        session_id: args.session_id,
+        reason: args.reason,
+        duration_ms: durationMs,
+    };
+    getAuditLog().info(fields, 'session_close');
+}
+export function recordIdleSweep(fields) {
+    if (!state)
+        return;
+    state.counters.idleSweepLastRunAt = new Date().toISOString();
+    getOpsLog().info(fields, 'idle_sweep');
+}
+export function getTransportSnapshot(activeSessions, pinnedSessions = 0) {
+    if (!state)
+        throw new Error('transport telemetry not initialized');
+    const s = state;
+    const kind = s.info.kind;
+    const uptimeSeconds = Math.max(0, Math.floor((Date.now() - s.startedAtMs) / 1000));
+    const transport = kind === 'http'
+        ? { kind, host: s.info.host, port: s.info.port, uptimeSeconds }
+        : kind === 'unix'
+            ? { kind, socketPath: s.info.socketPath, uptimeSeconds }
+            : { kind, uptimeSeconds };
+    // Stdio is a single implicit session — cap reported active at 1 regardless
+    // of registry state so the contract in the spec holds. Pinned is always 0
+    // on stdio (header plumbing is HTTP-only).
+    const active = kind === 'stdio' ? Math.min(1, activeSessions) : activeSessions;
+    const pinned = kind === 'stdio' ? 0 : pinnedSessions;
+    return {
+        transport,
+        sessions: { active, pinned, ...s.counters },
+    };
+}
+export function isInitialized() {
+    return state !== null;
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/mcp/transport/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../../src/mcp/transport/telemetry.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,wEAAwE;AACxE,EAAE;AACF,6EAA6E;AAC7E,8EAA8E;AAC9E,4EAA4E;AAC5E,0EAA0E;AAC1E,+EAA+E;AAG/E,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAkD1D,IAAI,KAAK,GAAiB,IAAI,CAAC;AAE/B,MAAM,UAAU,sBAAsB,CAAC,IAKtC;IACC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,KAAK,GAAG;QACN,IAAI,EAAE;YACJ,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,SAAS,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE;SACvC;QACD,WAAW,EAAE,GAAG;QAChB,QAAQ,EAAE;YACR,WAAW,EAAE,CAAC;YACd,WAAW,EAAE,CAAC;YACd,YAAY,EAAE,IAAI;YAClB,YAAY,EAAE,IAAI;YAClB,kBAAkB,EAAE,IAAI;SACzB;QACD,mBAAmB,EAAE,IAAI,GAAG,EAAE;KAC/B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB;IACvC,KAAK,GAAG,IAAI,CAAC;AACf,CAAC;AAkBD,MAAM,UAAU,iBAAiB,CAAC,MAAyB;IACzD,0EAA0E;IAC1E,2EAA2E;IAC3E,mDAAmD;IACnD,IAAI,CAAC,KAAK;QAAE,OAAO;IACnB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,KAAK,CAAC,QAAQ,CAAC,WAAW,IAAI,CAAC,CAAC;IAChC,KAAK,CAAC,QAAQ,CAAC,YAAY,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAC1D,KAAK,CAAC,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IACtD,WAAW,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAC7C,CAAC;AAQD,MAAM,UAAU,kBAAkB,CAAC,IAAwD;IACzF,IAAI,CAAC,KAAK;QAAE,OAAO;IACnB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,QAAQ,GAAG,KAAK,CAAC,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAChE,MAAM,UAAU,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,IAAI,QAAQ,KAAK,SAAS;QAAE,KAAK,CAAC,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9E,KAAK,CAAC,QAAQ,CAAC,WAAW,IAAI,CAAC,CAAC;IAChC,KAAK,CAAC,QAAQ,CAAC,YAAY,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAC1D,MAAM,MAAM,GAAuB;QACjC,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,WAAW,EAAE,UAAU;KACxB,CAAC;IACF,WAAW,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAC9C,CAAC;AAOD,MAAM,UAAU,eAAe,CAAC,MAAuB;IACrD,IAAI,CAAC,KAAK;QAAE,OAAO;IACnB,KAAK,CAAC,QAAQ,CAAC,kBAAkB,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC7D,SAAS,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,cAAsB,EAAE,cAAc,GAAG,CAAC;IAC7E,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACnE,MAAM,CAAC,GAAG,KAAK,CAAC;IAChB,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IACzB,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IACnF,MAAM,SAAS,GACb,IAAI,KAAK,MAAM;QACb,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,EAAE;QAC/D,CAAC,CAAC,IAAI,KAAK,MAAM;YACf,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,EAAE;YACxD,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;IAChC,2EAA2E;IAC3E,0EAA0E;IAC1E,2CAA2C;IAC3C,MAAM,MAAM,GAAG,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC;IAC/E,MAAM,MAAM,GAAG,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC;IACrD,OAAO;QACL,SAAS;QACT,QAAQ,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,QAAQ,EAAE;KAC5C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,KAAK,KAAK,IAAI,CAAC;AACxB,CAAC"}

package/dist/mcp/with-session.d.ts

@@ -0,0 +1,26 @@
+import type { MaadEngine } from '../engine.js';
+import type { InstanceCtx } from './ctx.js';
+interface CallContext {
+    engine: MaadEngine;
+    projectName: string;
+    projectRoot: string;
+    sessionId: string;
+    requestId: string;
+    /**
+     * 0.7.0 — Identity snapshot for audit + commit propagation. `role` is the
+     * effective role resolved for this (session × project). `token` is
+     * populated when the session was authenticated via the HTTP+registry path;
+     * undefined for stdio / synthetic mode.
+     */
+    role: string;
+    token?: import('../auth/types.js').TokenRecord;
+}
+type McpToolResponse = {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+};
+export declare function withEngine(ctx: InstanceCtx, extra: unknown, toolName: string, args: Record<string, unknown> | undefined, handler: (call: CallContext) => Promise<McpToolResponse> | McpToolResponse): Promise<McpToolResponse>;
+export {};
+//# sourceMappingURL=with-session.d.ts.map

package/dist/mcp/with-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-session.d.ts","sourceRoot":"","sources":["../../src/mcp/with-session.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAmB5C,UAAU,WAAW;IACnB,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,kBAAkB,EAAE,WAAW,CAAC;CAChD;AAED,KAAK,eAAe,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC;AAa1E,wBAAsB,UAAU,CAC9B,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EACzC,OAAO,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,GACzE,OAAO,CAAC,eAAe,CAAC,CA+N1B"}

package/dist/mcp/with-session.js

@@ -0,0 +1,275 @@
+// ============================================================================
+// withEngine — the routing helper every project-level tool wraps around.
+//
+// Resolves the correct engine for the current MCP call:
+//   1. Pull/create the session from the request's sessionId.
+//   2. In legacy (synthetic) mode, auto-bind to the single project on first
+//      call so existing 0.2.x clients work unchanged.
+//   3. In real instance mode, require the client to have already bound via
+//      maad_use_project(s).
+//   4. Pick the project (activeProject in single mode, args.project in multi).
+//   5. Gate by tool's minimum role vs the session's effective role.
+//   6. Load/cache the engine via EnginePool.
+//   7. Hand engine + project meta to the inner handler.
+// ============================================================================
+import { randomUUID } from 'node:crypto';
+import { resolveSessionId } from '../instance/session.js';
+import { getMinRoleForTool, roleSatisfies } from './roles.js';
+import { errorResponse, attachMeta } from './response.js';
+import { getRateLimiter } from './rate-limit.js';
+import { logToolCall, getOpsLog } from '../logging.js';
+import { isShuttingDown } from './shutdown.js';
+import { getKindForTool, isEngineLess } from './kinds.js';
+import { isCommitIdentityEnabled } from '../git/commit.js';
+const DEFAULT_REQUEST_TIMEOUT_MS = 30_000;
+function getRequestTimeoutMs() {
+    const env = process.env.MAAD_REQUEST_TIMEOUT_MS;
+    if (env && !Number.isNaN(Number(env)))
+        return Number(env);
+    return DEFAULT_REQUEST_TIMEOUT_MS;
+}
+// Wrap a tool handler so it runs against the engine chosen by the current
+// session. Call this inside every project-level tool registration.
+//
+// Every call gets a fresh request_id (UUID). It is:
+//   - stamped onto the response as _meta.request_id
+//   - emitted on the ops log in the trailing tool_call line
+//   - passed into the handler (so audit logs and idempotency can reference it)
+//
+// The function has several early-return points (session errors, role, payload,
+// concurrent). All of them flow through `finalize()` so every response — success
+// or rejection — is logged uniformly.
+export async function withEngine(ctx, extra, toolName, args, handler) {
+    const requestId = randomUUID();
+    const startedMs = Date.now();
+    const sessionId = resolveSessionId(extra);
+    const payloadBytes = args ? Buffer.byteLength(JSON.stringify(args), 'utf8') : 0;
+    let projectForLog = null;
+    let roleForLog = null;
+    // finalize() is called once per request, on the single return path. It
+    // attaches _meta.request_id (opt-in via MAAD_EMIT_REQUEST_ID=true since
+    // 0.7.0), inspects the response body for logging, and emits the tool_call
+    // ops line. The log line always carries request_id regardless of stamping
+    // — emission only affects the wire response, not diagnostics.
+    const emitRequestId = process.env.MAAD_EMIT_REQUEST_ID === 'true';
+    const finalize = (response) => {
+        const stamped = emitRequestId ? attachMeta(response, { request_id: requestId }) : response;
+        const latencyMs = Date.now() - startedMs;
+        const { result, errorCode } = inspectResponse(stamped);
+        logToolCall({
+            request_id: requestId,
+            session_id: sessionId,
+            project: projectForLog,
+            tool: toolName,
+            role: roleForLog,
+            payload_size: payloadBytes,
+            latency_ms: latencyMs,
+            result,
+            error_code: errorCode,
+        });
+        return stamped;
+    };
+    // Reject new work during shutdown before any other check.
+    if (isShuttingDown()) {
+        return finalize(mcpError('SHUTTING_DOWN', 'Server is shutting down; retry against a healthy instance.'));
+    }
+    let state = ctx.sessions.get(sessionId);
+    if (!state)
+        state = ctx.sessions.create(sessionId);
+    // Session cancelled by instance-reload (its bound project was removed, or
+    // its multi-mode whitelist drained to empty). Emit the error once, then
+    // destroy so the client reconnects cleanly.
+    if (state.cancelled) {
+        const boundProject = state.activeProject ?? state.whitelist?.[0] ?? 'unknown';
+        ctx.sessions.destroy(sessionId, 'transport');
+        return finalize(mcpError('SESSION_CANCELLED', `Session was cancelled because its bound project "${boundProject}" was removed by an instance reload. Reconnect to continue.`));
+    }
+    // Legacy single-project instance: auto-bind to 'default' on first call.
+    if (state.mode === null && ctx.instance.source === 'synthetic') {
+        const bindResult = ctx.sessions.bindSingle(sessionId, 'default');
+        if (!bindResult.ok)
+            return finalize(errorResponse(bindResult.errors));
+        state = bindResult.value;
+    }
+    if (state.mode === null) {
+        return finalize(mcpError('SESSION_UNBOUND', 'No project bound for this session. Call maad_use_project(s) first.'));
+    }
+    // Pick project
+    const projectName = resolveProjectName(state, args);
+    if (typeof projectName !== 'string')
+        return finalize(projectName); // error response
+    projectForLog = projectName;
+    // Role check
+    const effectiveRole = state.effectiveRoles.get(projectName);
+    if (!effectiveRole) {
+        return finalize(mcpError('PROJECT_NOT_WHITELISTED', `Session is not bound to project "${projectName}".`));
+    }
+    roleForLog = effectiveRole;
+    const minRole = getMinRoleForTool(toolName);
+    if (minRole && !roleSatisfies(effectiveRole, minRole)) {
+        return finalize(mcpError('INSUFFICIENT_ROLE', `Tool ${toolName} requires role "${minRole}" but session has "${effectiveRole}" for project "${projectName}".`));
+    }
+    // Payload size cap. Oversize args are rejected without touching the engine.
+    const rl = getRateLimiter();
+    const payloadRejection = rl.checkPayloadSize(payloadBytes);
+    if (payloadRejection) {
+        return finalize(mcpErrorWithDetails('RATE_LIMITED', 'Payload exceeds limit', {
+            reason: payloadRejection.reason,
+            limit: payloadRejection.limit,
+            retryAfterMs: payloadRejection.retryAfterMs,
+            size: payloadBytes,
+        }));
+    }
+    // Concurrent-in-flight cap. Released in the `finally` below so an engine
+    // error never leaks a slot.
+    const slot = rl.tryAcquireConcurrent(sessionId);
+    if (!slot.ok) {
+        return finalize(mcpErrorWithDetails('RATE_LIMITED', 'Concurrent in-flight limit reached', {
+            reason: slot.rejection.reason,
+            limit: slot.rejection.limit,
+            retryAfterMs: slot.rejection.retryAfterMs,
+        }));
+    }
+    let acquiredProject = null;
+    try {
+        // Resolve engine
+        const poolResult = await ctx.pool.get(projectName);
+        if (!poolResult.ok)
+            return finalize(errorResponse(poolResult.errors));
+        // 0.7.3 — refcount the engine for the duration of this handler so the
+        // idle sweeper cannot evict mid-call. Released in finally below.
+        ctx.pool.acquire(projectName);
+        acquiredProject = projectName;
+        const project = ctx.instance.projects.find((p) => p.name === projectName);
+        // Operation kind dispatch. Reads invoke the handler directly; writes
+        // acquire the per-engine write mutex via engine.runExclusive so
+        // mutations across tools, sessions, and transports all serialize
+        // through a single chokepoint. An unclassified tool that reaches
+        // withEngine (i.e. not in kinds.ts) is a bug — fail fast with a clear
+        // code rather than silently running a write without the mutex.
+        const kind = getKindForTool(toolName);
+        if (kind === null && !isEngineLess(toolName)) {
+            return finalize(mcpError('MISSING_OPERATION_KIND', `Tool "${toolName}" has no OperationKind registered in src/mcp/kinds.ts. ` +
+                `Every engine-bound tool must be listed as read or write.`));
+        }
+        // Per-request timeout via Promise.race. The handler continues running
+        // on timeout (cooperative cancellation into engine stages is deferred to
+        // 0.8.5 — documented in docs/gaps.md). Its eventual completion emits a
+        // delayed `tool_call_overrun` log line so operators can see what the
+        // slow work was doing.
+        const timeoutMs = getRequestTimeoutMs();
+        const callCtx = {
+            engine: poolResult.value,
+            projectName,
+            projectRoot: project.path,
+            sessionId,
+            requestId,
+            role: effectiveRole,
+        };
+        if (state.token !== undefined)
+            callCtx.token = state.token;
+        const invokeHandler = () => Promise.resolve(handler(callCtx));
+        // 0.7.0 — For writes under an authenticated session with the identity
+        // flag on, set the engine's pending commit-identity slot inside the
+        // write mutex. This survives the full handler scope; cleared in finally.
+        // AsyncLocalStorage-based reentrancy means inner engine.createDocument
+        // calls reuse the already-held mutex, so the slot is safe.
+        const runWithIdentity = async () => {
+            const engine = poolResult.value;
+            if (state.token && isCommitIdentityEnabled()) {
+                const identity = { role: effectiveRole };
+                identity.tokenId = state.token.id;
+                if (state.token.agentId !== undefined)
+                    identity.agentId = state.token.agentId;
+                if (state.token.userId !== undefined)
+                    identity.userId = state.token.userId;
+                engine.setCommitIdentity(identity);
+            }
+            try {
+                return await invokeHandler();
+            }
+            finally {
+                engine.setCommitIdentity(undefined);
+            }
+        };
+        const handlerPromise = kind === 'write'
+            ? poolResult.value.runExclusive(toolName, runWithIdentity)
+            : invokeHandler();
+        let timedOut = false;
+        let timeoutHandle = null;
+        const timeoutPromise = new Promise((resolve) => {
+            timeoutHandle = setTimeout(() => {
+                timedOut = true;
+                resolve(mcpErrorWithDetails('REQUEST_TIMEOUT', `Tool ${toolName} exceeded per-request timeout of ${timeoutMs}ms`, { tool: toolName, limitMs: timeoutMs }));
+            }, timeoutMs);
+            // Don't keep the event loop alive for a pending request timer —
+            // process exit stays clean when all real work is done.
+            timeoutHandle.unref?.();
+        });
+        let response;
+        try {
+            response = await Promise.race([handlerPromise, timeoutPromise]);
+        }
+        finally {
+            // Clear the timer on the happy path so we don't keep ~30s of dead
+            // closures around per request under sustained load.
+            if (timeoutHandle)
+                clearTimeout(timeoutHandle);
+        }
+        if (timedOut) {
+            // Observe the handler's eventual completion and log the overrun.
+            // Keep the observation unhandled-rejection-safe.
+            void handlerPromise.then(() => {
+                getOpsLog().warn({ event: 'tool_call_overrun', request_id: requestId, tool: toolName, limit_ms: timeoutMs }, 'tool_call_overrun');
+            }, (err) => {
+                getOpsLog().warn({ event: 'tool_call_overrun', request_id: requestId, tool: toolName, limit_ms: timeoutMs, error: String(err) }, 'tool_call_overrun');
+            });
+        }
+        return finalize(response);
+    }
+    finally {
+        slot.release();
+        // 0.7.3 — release engine refcount. Paired with acquiredProject above;
+        // null when pool.get failed and acquire was never called.
+        if (acquiredProject !== null)
+            ctx.pool.release(acquiredProject);
+    }
+}
+function inspectResponse(response) {
+    const first = response.content[0];
+    if (!first || first.type !== 'text')
+        return { result: 'error', errorCode: null };
+    try {
+        const parsed = JSON.parse(first.text);
+        if (parsed.ok === true)
+            return { result: 'ok', errorCode: null };
+        const code = parsed.errors?.[0]?.code ?? null;
+        return { result: 'error', errorCode: code };
+    }
+    catch {
+        return { result: 'error', errorCode: null };
+    }
+}
+function resolveProjectName(state, args) {
+    if (state.mode === 'single') {
+        return state.activeProject;
+    }
+    // multi mode
+    const raw = args && typeof args.project === 'string' ? args.project : undefined;
+    if (!raw) {
+        return mcpError('PROJECT_REQUIRED', 'Multi-project session requires `project=<name>` on every call.');
+    }
+    if (!state.whitelist.includes(raw)) {
+        return mcpError('PROJECT_NOT_WHITELISTED', `Project "${raw}" is not in this session's whitelist: [${state.whitelist.join(', ')}]`);
+    }
+    return raw;
+}
+function mcpError(code, message) {
+    const err = { code: code, message };
+    return errorResponse([err]);
+}
+function mcpErrorWithDetails(code, message, details) {
+    const err = { code: code, message, details };
+    return errorResponse([err]);
+}
+//# sourceMappingURL=with-session.js.map

package/dist/mcp/with-session.js.map

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

package/dist/parser/annotations.d.ts

@@ -0,0 +1,3 @@
+import type { FilePath, InlineAnnotation, Primitive, VerbatimZone } from '../types.js';
+export declare function extractAnnotations(body: string, bodyStartLine: number, filePath: FilePath, subtypeMap: Record<string, Primitive>, verbatimZones: VerbatimZone[]): InlineAnnotation[];
+//# sourceMappingURL=annotations.d.ts.map

package/dist/parser/annotations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.d.ts","sourceRoot":"","sources":["../../src/parser/annotations.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAMvF,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EACrC,aAAa,EAAE,YAAY,EAAE,GAC5B,gBAAgB,EAAE,CAoCpB"}

package/dist/parser/annotations.js

@@ -0,0 +1,41 @@
+// ============================================================================
+// Inline Annotation Extractor
+// Extracts [[type:value|label]] annotations from markdown body.
+// Resolves subtype -> primitive via the subtype map.
+// Skips matches inside verbatim zones.
+// ============================================================================
+import { resolvePrimitive } from '../types.js';
+import { isInVerbatimZone } from './verbatim.js';
+const ANNOTATION_REGEX = /\[\[([a-zA-Z_][a-zA-Z0-9_]*):([^|]+)\|([^\]]+)\]\]/g;
+export function extractAnnotations(body, bodyStartLine, filePath, subtypeMap, verbatimZones) {
+    const annotations = [];
+    const lines = body.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const absoluteLine = bodyStartLine + i;
+        let match;
+        ANNOTATION_REGEX.lastIndex = 0;
+        while ((match = ANNOTATION_REGEX.exec(line)) !== null) {
+            const col = match.index;
+            if (isInVerbatimZone(absoluteLine, col, verbatimZones))
+                continue;
+            const rawType = match[1];
+            const value = match[2].trim();
+            const label = match[3].trim();
+            const primitive = resolvePrimitive(rawType, subtypeMap);
+            annotations.push({
+                rawType,
+                primitive,
+                value,
+                label,
+                location: {
+                    file: filePath,
+                    line: absoluteLine,
+                    col,
+                },
+            });
+        }
+    }
+    return annotations;
+}
+//# sourceMappingURL=annotations.js.map

package/dist/parser/annotations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.js","sourceRoot":"","sources":["../../src/parser/annotations.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,8BAA8B;AAC9B,gEAAgE;AAChE,qDAAqD;AACrD,uCAAuC;AACvC,+EAA+E;AAG/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,gBAAgB,GAAG,qDAAqD,CAAC;AAE/E,MAAM,UAAU,kBAAkB,CAChC,IAAY,EACZ,aAAqB,EACrB,QAAkB,EAClB,UAAqC,EACrC,aAA6B;IAE7B,MAAM,WAAW,GAAuB,EAAE,CAAC;IAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACvB,MAAM,YAAY,GAAG,aAAa,GAAG,CAAC,CAAC;QAEvC,IAAI,KAA6B,CAAC;QAClC,gBAAgB,CAAC,SAAS,GAAG,CAAC,CAAC;QAE/B,OAAO,CAAC,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACtD,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC;YAExB,IAAI,gBAAgB,CAAC,YAAY,EAAE,GAAG,EAAE,aAAa,CAAC;gBAAE,SAAS;YAEjE,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;YAC/B,MAAM,SAAS,GAAG,gBAAgB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;YAExD,WAAW,CAAC,IAAI,CAAC;gBACf,OAAO;gBACP,SAAS;gBACT,KAAK;gBACL,KAAK;gBACL,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,YAAY;oBAClB,GAAG;iBACJ;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/parser/blocks.d.ts

@@ -0,0 +1,3 @@
+import { type ParsedBlock } from '../types.js';
+export declare function parseBlocks(body: string, bodyStartLine: number): ParsedBlock[];
+//# sourceMappingURL=blocks.d.ts.map

package/dist/parser/blocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../../src/parser/blocks.ts"],"names":[],"mappings":"AAMA,OAAO,EAAyB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAMtE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,WAAW,EAAE,CAiG9E"}

package/dist/parser/blocks.js

@@ -0,0 +1,99 @@
+// ============================================================================
+// Block Parser
+// Splits a markdown body into heading-delimited sections.
+// Detects {#custom_id} anchors. Skips headings inside fenced code blocks.
+// ============================================================================
+import { blockId } from '../types.js';
+const ATX_HEADING_REGEX = /^(#{1,6})\s+(.+)$/;
+const ANCHOR_REGEX = /\s*\{#([a-zA-Z0-9_-]+)\}\s*$/;
+const FENCE_OPEN_REGEX = /^(`{3,}|~{3,})/;
+export function parseBlocks(body, bodyStartLine) {
+    const lines = body.split('\n');
+    const blocks = [];
+    let inFence = false;
+    let fenceChar = '';
+    let fenceLen = 0;
+    const headings = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const absoluteLine = bodyStartLine + i;
+        // Track fenced code blocks
+        const fenceMatch = FENCE_OPEN_REGEX.exec(line.trimStart());
+        if (fenceMatch) {
+            const matchedFence = fenceMatch[1];
+            if (!inFence) {
+                inFence = true;
+                fenceChar = matchedFence[0];
+                fenceLen = matchedFence.length;
+            }
+            else if (line.trimStart().startsWith(fenceChar.repeat(fenceLen)) && line.trim().length <= fenceLen + 1) {
+                // Closing fence: same char, at least same length, nothing else on line
+                inFence = false;
+            }
+            continue;
+        }
+        if (inFence)
+            continue;
+        // Check for ATX heading
+        const headingMatch = ATX_HEADING_REGEX.exec(line);
+        if (headingMatch) {
+            const level = headingMatch[1].length;
+            let headingText = headingMatch[2].trim();
+            let id = null;
+            // Extract {#custom_id} anchor
+            const anchorMatch = ANCHOR_REGEX.exec(headingText);
+            if (anchorMatch) {
+                id = blockId(anchorMatch[1]);
+                headingText = headingText.slice(0, anchorMatch.index).trim();
+            }
+            else {
+                // Auto-generate ID by slugifying the heading
+                id = blockId(slugify(headingText));
+            }
+            headings.push({
+                id,
+                heading: headingText,
+                level,
+                startLine: absoluteLine,
+                contentStartIndex: i + 1,
+            });
+        }
+    }
+    // If there's content before the first heading, create a preamble block
+    const firstHeadingIndex = headings.length > 0 ? headings[0].contentStartIndex - 1 : lines.length;
+    if (firstHeadingIndex > 0) {
+        const preambleContent = lines.slice(0, firstHeadingIndex).join('\n').trim();
+        if (preambleContent.length > 0) {
+            blocks.push({
+                id: null,
+                heading: '',
+                level: 0,
+                startLine: bodyStartLine,
+                endLine: bodyStartLine + firstHeadingIndex - 1,
+            });
+        }
+    }
+    // Build blocks from headings
+    for (let h = 0; h < headings.length; h++) {
+        const current = headings[h];
+        const nextIndex = h + 1 < headings.length ? headings[h + 1].contentStartIndex - 1 : lines.length;
+        const endLine = bodyStartLine + nextIndex - 1;
+        blocks.push({
+            id: current.id,
+            heading: current.heading,
+            level: current.level,
+            startLine: current.startLine,
+            endLine,
+        });
+    }
+    return blocks;
+}
+function slugify(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9\s-]/g, '')
+        .replace(/\s+/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+//# sourceMappingURL=blocks.js.map

package/dist/parser/blocks.js.map

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

package/dist/parser/frontmatter.d.ts

@@ -0,0 +1,9 @@
+import { type Result } from '../errors.js';
+import type { FilePath } from '../types.js';
+export interface FrontmatterResult {
+    frontmatter: Record<string, unknown>;
+    body: string;
+    bodyStartLine: number;
+}
+export declare function parseFrontmatter(raw: string, filePath: FilePath): Result<FrontmatterResult>;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/parser/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/parser/frontmatter.ts"],"names":[],"mappings":"AAMA,OAAO,EAAiB,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC,iBAAiB,CAAC,CA4B3F"}

package/dist/parser/frontmatter.js

@@ -0,0 +1,33 @@
+// ============================================================================
+// Frontmatter Parser
+// Extracts YAML frontmatter from a markdown file using gray-matter.
+// ============================================================================
+import { parseMatter } from './matter.js';
+import { ok, singleErr } from '../errors.js';
+export function parseFrontmatter(raw, filePath) {
+    try {
+        const parsed = parseMatter(raw);
+        if (typeof parsed.data !== 'object' || parsed.data === null || Array.isArray(parsed.data)) {
+            return singleErr('PARSE_ERROR', 'Frontmatter must be a YAML mapping', { file: filePath, line: 1, col: 1 });
+        }
+        const frontmatter = parsed.data;
+        // Calculate bodyStartLine: count lines in the raw content up to where the body begins
+        // gray-matter.matter gives us the raw frontmatter string between the --- delimiters
+        let bodyStartLine = 1;
+        if (parsed.matter && parsed.matter.length > 0) {
+            // Opening --- (line 1) + frontmatter lines + closing ---
+            const fmLines = parsed.matter.split('\n').length;
+            bodyStartLine = fmLines + 2; // +1 for opening ---, +1 for closing ---
+        }
+        return ok({
+            frontmatter,
+            body: parsed.content,
+            bodyStartLine,
+        });
+    }
+    catch (e) {
+        const message = e instanceof Error ? e.message : 'Unknown parse error';
+        return singleErr('PARSE_ERROR', `Failed to parse frontmatter: ${message}`, { file: filePath, line: 1, col: 1 });
+    }
+}
+//# sourceMappingURL=frontmatter.js.map