@massa-ai/core 1.2.1

package/dist/services/hooks/observation-extractor.js

@@ -0,0 +1,364 @@
+/**
+ * ObservationExtractor — derives a semantic `category` from (source, payload).
+ *
+ * Ported fresh (NOT copied) from context-mode's extract.ts approach: a set of
+ * pure, side-effect-free classifier functions dispatched off the lifecycle
+ * `source` + the payload shape. Each classifier inspects the payload for
+ * tool-name / field-shape signals and returns an `ObservationCategory`.
+ *
+ * Design:
+ *  - Pure: (source, payload) → category. No IO, no state, never throws.
+ *  - Graceful: unknown payloads fall back to "lifecycle-raw".
+ *  - Backward-compatible: the 6 lifecycle `source` kinds are unchanged; the
+ *    category is an additive derived field.
+ *  - The category drives the compaction snapshot's table-of-contents sections.
+ */
+// ── Tool-name normalization ─────────────────────────────────────────────────
+// Different hosts emit different tool names for the same action. Normalize to
+// a canonical set so classifiers match regardless of source.
+const TOOL_NAME_NORMALIZE = {
+    // Claude Code canonical
+    Read: "Read",
+    Write: "Write",
+    Edit: "Edit",
+    MultiEdit: "MultiEdit",
+    Glob: "Glob",
+    Grep: "Grep",
+    Bash: "Bash",
+    Task: "Task",
+    TodoWrite: "TodoWrite",
+    WebFetch: "WebFetch",
+    WebSearch: "WebSearch",
+    // OpenCode / other hosts
+    run_shell_command: "Bash",
+    shell: "Bash",
+    write_file: "Write",
+    edit_file: "Edit",
+    list_files: "Glob",
+    search_files: "Grep",
+    grep: "Grep",
+    glob: "Glob",
+    // massa-ai MCP tools (note: read_file is ambiguous — Claude Code's Read
+    // and massa-ai's read_file tool. We normalize to "Read" for extraction
+    // purposes since both are file-read operations. Canonical names are
+    // un-prefixed.)
+    search: "search",
+    recall: "recall",
+    store_memory: "store_memory",
+    search_definitions: "search_definitions",
+    get_references: "get_references",
+    read_file: "Read",
+    compact_snapshot: "compact_snapshot",
+};
+function normalizeToolName(raw) {
+    if (typeof raw !== "string" || !raw)
+        return "";
+    return TOOL_NAME_NORMALIZE[raw] ?? raw;
+}
+// ── Payload field extractors (safe accessors) ───────────────────────────────
+function str(val) {
+    return typeof val === "string" ? val : "";
+}
+function lower(val) {
+    return str(val).toLowerCase();
+}
+/** Safely extract a field from a payload object. */
+function field(payload, key) {
+    return payload?.[key];
+}
+/**
+ * Classify a post-tool-use / pre-tool-use payload by its tool name.
+ * This is the primary classifier — most observations come from tool calls.
+ */
+const classifyToolCall = (_source, payload) => {
+    const toolName = normalizeToolName(field(payload, "tool_name") ?? field(payload, "toolName"));
+    switch (toolName) {
+        case "Read":
+            return "files-read";
+        case "Write":
+        case "Edit":
+        case "MultiEdit":
+            return "files-written";
+        case "Glob":
+        case "list_files":
+            return "file-search";
+        case "Grep":
+        case "search_files":
+        case "grep":
+            return "file-search";
+        case "Bash": {
+            const toolInput = field(payload, "tool_input");
+            const cmdRaw = field(payload, "command") ??
+                (toolInput && typeof toolInput === "object" ? toolInput.command : undefined);
+            const cmd = lower(cmdRaw);
+            if (cmd.startsWith("git ") || cmd.includes(" git ")) {
+                if (cmd.includes("commit") || cmd.includes("merge") || cmd.includes("rebase")) {
+                    return "git-changes";
+                }
+                return "git-changes";
+            }
+            return "tool-calls";
+        }
+        case "TodoWrite":
+        case "Task":
+            return "tasks";
+        case "WebFetch":
+            return "web-fetch";
+        case "WebSearch":
+            return "searches";
+        case "search":
+            return "searches";
+        case "search_definitions":
+            return "searches";
+        case "get_references":
+            return "searches";
+        case "recall":
+            return "searches";
+        case "store_memory":
+            return "memories-stored";
+        case "compact_snapshot":
+            return "compaction-snapshots";
+        case "Task": // subagent spawn
+            return "subagents-spawned";
+        default:
+            // MCP tool calls (namespaced like "mcp__server__tool")
+            if (toolName.startsWith("mcp__"))
+                return "mcp-calls";
+            return null;
+    }
+};
+/**
+ * Classify a user-prompt payload for decision/intent/goal/constraint signals.
+ * Ported from context-mode's UserPromptSubmit classifiers.
+ */
+const classifyUserPrompt = (source, payload) => {
+    if (source !== "user-prompt")
+        return null;
+    const prompt = str(field(payload, "prompt") ?? field(payload, "message") ?? field(payload, "text"));
+    const lowerPrompt = prompt.toLowerCase();
+    // Goal marker
+    if (lowerPrompt.startsWith("/goal") || lowerPrompt.startsWith("goal:") || lowerPrompt.startsWith("objective:")) {
+        return "goal";
+    }
+    // Plan marker
+    if (lowerPrompt.startsWith("/plan")) {
+        return "plan-changes";
+    }
+    // Decision signals
+    if (lowerPrompt.includes("let's go with") ||
+        lowerPrompt.includes("decide on") ||
+        lowerPrompt.includes("decision:") ||
+        lowerPrompt.includes("we'll use") ||
+        lowerPrompt.includes("chosen approach")) {
+        return "decisions";
+    }
+    // Constraint signals
+    if (lowerPrompt.includes("must not") ||
+        lowerPrompt.includes("constraint:") ||
+        lowerPrompt.includes("don't touch") ||
+        lowerPrompt.includes("never ") ||
+        lowerPrompt.includes("avoid ")) {
+        return "constraints";
+    }
+    // Rejected approach
+    if (lowerPrompt.includes("not that") ||
+        lowerPrompt.includes("rejected") ||
+        lowerPrompt.includes("don't do") ||
+        lowerPrompt.includes("instead of")) {
+        return "rejected-approaches";
+    }
+    // Blocked-on
+    if (lowerPrompt.includes("blocked on") ||
+        lowerPrompt.includes("waiting on") ||
+        lowerPrompt.includes("can't proceed") ||
+        lowerPrompt.includes("stuck on")) {
+        return "blocked-on";
+    }
+    // Role / persona
+    if (lowerPrompt.startsWith("/persona") ||
+        lowerPrompt.startsWith("act as") ||
+        lowerPrompt.startsWith("you are a")) {
+        return "role";
+    }
+    return "user-prompts";
+};
+/**
+ * Classify session-start for env / settings / cwd.
+ */
+const classifySessionStart = (source, payload) => {
+    if (source !== "session-start")
+        return null;
+    const hasCwd = !!field(payload, "cwd") || !!field(payload, "workingDirectory");
+    const hasEnv = !!field(payload, "env") || !!field(payload, "environment");
+    const hasSettings = !!field(payload, "settings") || !!field(payload, "model");
+    if (hasSettings)
+        return "session-settings";
+    if (hasCwd)
+        return "cwd-changes";
+    if (hasEnv)
+        return "env-changes";
+    return "session-settings";
+};
+/**
+ * Classify pre-compact as compaction-snapshots.
+ */
+const classifyPreCompact = (source) => {
+    if (source === "pre-compact")
+        return "compaction-snapshots";
+    return null;
+};
+/**
+ * Classify post-tool-use errors from tool_response.
+ */
+const classifyError = (source, payload) => {
+    if (source !== "post-tool-use")
+        return null;
+    const response = field(payload, "tool_response") ?? field(payload, "toolResponse");
+    if (response && typeof response === "object") {
+        const respObj = response;
+        const isError = respObj.is_error;
+        const error = respObj.error;
+        if (isError === true || error)
+            return "errors";
+    }
+    const stdout = str(field(payload, "stdout"));
+    if (stdout.toLowerCase().includes("error:") || stdout.toLowerCase().includes("failed:")) {
+        return "errors";
+    }
+    return null;
+};
+/**
+ * Classify CLAUDE.md / rules file reads.
+ */
+const classifyRuleFile = (_source, payload) => {
+    const toolName = normalizeToolName(field(payload, "tool_name"));
+    if (toolName !== "Read" && toolName !== "read_file")
+        return null;
+    const toolInput = field(payload, "tool_input");
+    const filePath = lower(field(payload, "file_path") ??
+        field(payload, "path") ??
+        (toolInput && typeof toolInput === "object"
+            ? toolInput.file_path
+            : undefined));
+    if (!filePath)
+        return null;
+    if (filePath.endsWith("claude.md") ||
+        filePath.endsWith("agents.md") ||
+        filePath.endsWith("cursorrules") ||
+        filePath.endsWith(".clinerules") ||
+        filePath.includes("claudemd") ||
+        filePath.endsWith("rtk.md")) {
+        return "rules";
+    }
+    return null;
+};
+/**
+ * Classify skill invocations from tool calls.
+ */
+const classifySkill = (_source, payload) => {
+    const toolName = normalizeToolName(field(payload, "tool_name"));
+    if (toolName === "Skill" || toolName === "skill")
+        return "skills-invoked";
+    // Also detect skill mentions in user prompts
+    return null;
+};
+/**
+ * Classify git operations from the payload directly (not just Bash).
+ */
+const classifyGitPayload = (_source, payload) => {
+    const cmd = lower(field(payload, "command"));
+    if (cmd.startsWith("git ")) {
+        if (cmd.includes("commit") || cmd.includes("merge") || cmd.includes("rebase") || cmd.includes("checkout") || cmd.includes("reset")) {
+            return "git-changes";
+        }
+    }
+    // Git diff / status in payload
+    const diff = field(payload, "diff") ?? field(payload, "git_diff");
+    if (diff)
+        return "git-changes";
+    return null;
+};
+// Ordered classifier pipeline — first match wins.
+const CLASSIFIERS = [
+    classifyRuleFile, // rules before files-read (CLAUDE.md reads)
+    classifyError, // errors before generic tool-calls
+    classifyGitPayload, // git before generic tool-calls
+    classifySkill, // skills before generic tool-calls
+    classifyToolCall, // primary tool-call classifier
+    classifyUserPrompt, // user-prompt-derived categories
+    classifySessionStart, // session-start-derived categories
+    classifyPreCompact, // pre-compact → compaction-snapshots
+];
+// ── Public API ──────────────────────────────────────────────────────────────
+/**
+ * Derive an `ObservationCategory` from (source, payload).
+ *
+ * Pure, never throws. Returns "lifecycle-raw" when no classifier matches
+ * (backward-compatible fallback for legacy/unknown payloads).
+ */
+export function extractCategory(source, payload) {
+    if (!payload || typeof payload !== "object")
+        return "lifecycle-raw";
+    for (const classifier of CLASSIFIERS) {
+        try {
+            const result = classifier(source, payload);
+            if (result)
+                return result;
+        }
+        catch {
+            // Classifiers must never throw; defend anyway.
+            continue;
+        }
+    }
+    // Source-based fallbacks for events with no payload-specific match.
+    switch (source) {
+        case "session-start":
+            return "session-settings";
+        case "session-end":
+            return "lifecycle-raw";
+        case "pre-compact":
+            return "compaction-snapshots";
+        default:
+            return "lifecycle-raw";
+    }
+}
+/**
+ * Human-readable label for a category (ported from context-mode analytics.ts).
+ * Used by the compaction snapshot's section headers.
+ */
+export const CATEGORY_LABELS = {
+    "files-read": "Files read",
+    "files-written": "Files written",
+    "file-search": "File searches",
+    "tool-calls": "Tool calls",
+    "git-changes": "Git operations",
+    tasks: "Tasks in progress",
+    "plan-changes": "Plan changes",
+    errors: "Errors caught",
+    "error-resolution": "Errors resolved",
+    "iteration-loop": "Retry loops detected",
+    decisions: "Decisions made",
+    constraints: "Constraints set",
+    "rejected-approaches": "Approaches rejected",
+    "user-prompts": "Your messages",
+    intent: "Session intent",
+    goal: "Session goal",
+    role: "Behavior rules",
+    "blocked-on": "Blockers logged",
+    rules: "Project rules (CLAUDE.md)",
+    "skills-invoked": "Skills used",
+    "subagents-spawned": "Delegated work",
+    "env-changes": "Environment changes",
+    "cwd-changes": "Working directory",
+    "session-settings": "Session settings",
+    "external-refs": "External references",
+    "web-fetch": "Web pages fetched",
+    searches: "Searches performed",
+    "memories-stored": "Memories stored",
+    "compaction-snapshots": "Compaction snapshots",
+    "mcp-calls": "MCP tool calls",
+    "agent-findings": "Agent findings",
+    "cost-telemetry": "Cost telemetry",
+    "lifecycle-raw": "Lifecycle events",
+};
+//# sourceMappingURL=observation-extractor.js.map

package/dist/services/hooks/observation-extractor.js.map

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

package/dist/services/hooks/search-session-hook.d.ts

@@ -0,0 +1,34 @@
+/**
+ * SearchSessionHook
+ *
+ * Subscribes to "search:completed" events on the EventBus and automatically
+ * stores a lightweight session memory for every search that returns results.
+ *
+ * This creates an "intermediate memory" layer that bridges ephemeral search
+ * context (lost on compaction) and explicit persistent memories (remember).
+ *
+ * Design decisions:
+ *  - Non-blocking: store failures are logged but never surfaced to callers.
+ *  - Dedup: same (sessionId, projectId, query) is not stored twice within DEDUP_TTL_MS.
+ *  - Low importance (0.3): the temporal score and access reinforcement in
+ *    MemoryService naturally elevate memories that are accessed repeatedly.
+ *  - Prunes the dedup map when it grows beyond MAX_DEDUP_ENTRIES to avoid leaks.
+ */
+export declare class SearchSessionHook {
+    private static instance;
+    private unsubscribe;
+    /** dedup key → last stored timestamp */
+    private readonly recentKeys;
+    private constructor();
+    static getInstance(): SearchSessionHook;
+    /** Register the hook. Safe to call multiple times — only registers once. */
+    register(): void;
+    /** Unregister the hook (useful in tests). */
+    unregisterHook(): void;
+    /** Reset singleton (test utility). */
+    static reset(): void;
+    private handleSearchCompleted;
+    private pruneDedup;
+}
+export declare const searchSessionHook: SearchSessionHook;
+//# sourceMappingURL=search-session-hook.d.ts.map

package/dist/services/hooks/search-session-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-session-hook.d.ts","sourceRoot":"","sources":["../../../src/services/hooks/search-session-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAUH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAkC;IAEzD,OAAO,CAAC,WAAW,CAA6B;IAChD,wCAAwC;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IAExD,OAAO;IAEP,MAAM,CAAC,WAAW,IAAI,iBAAiB;IAOvC,4EAA4E;IAC5E,QAAQ,IAAI,IAAI;IAQhB,6CAA6C;IAC7C,cAAc,IAAI,IAAI;IAMtB,sCAAsC;IACtC,MAAM,CAAC,KAAK,IAAI,IAAI;YAKN,qBAAqB;IAsDnC,OAAO,CAAC,UAAU;CAkBnB;AAED,eAAO,MAAM,iBAAiB,mBAAkC,CAAC"}

package/dist/services/hooks/search-session-hook.js

@@ -0,0 +1,121 @@
+/**
+ * SearchSessionHook
+ *
+ * Subscribes to "search:completed" events on the EventBus and automatically
+ * stores a lightweight session memory for every search that returns results.
+ *
+ * This creates an "intermediate memory" layer that bridges ephemeral search
+ * context (lost on compaction) and explicit persistent memories (remember).
+ *
+ * Design decisions:
+ *  - Non-blocking: store failures are logged but never surfaced to callers.
+ *  - Dedup: same (sessionId, projectId, query) is not stored twice within DEDUP_TTL_MS.
+ *  - Low importance (0.3): the temporal score and access reinforcement in
+ *    MemoryService naturally elevate memories that are accessed repeatedly.
+ *  - Prunes the dedup map when it grows beyond MAX_DEDUP_ENTRIES to avoid leaks.
+ */
+import { logger, MemoryType } from "@massa-ai/shared";
+import { eventBus } from "../events/event-bus.js";
+import { MemoryController } from "../../controllers/memory-controller.js";
+const DEDUP_TTL_MS = 60_000;
+const MAX_DEDUP_ENTRIES = 500;
+export class SearchSessionHook {
+    static instance = null;
+    unsubscribe = null;
+    /** dedup key → last stored timestamp */
+    recentKeys = new Map();
+    constructor() { }
+    static getInstance() {
+        if (!SearchSessionHook.instance) {
+            SearchSessionHook.instance = new SearchSessionHook();
+        }
+        return SearchSessionHook.instance;
+    }
+    /** Register the hook. Safe to call multiple times — only registers once. */
+    register() {
+        if (this.unsubscribe)
+            return;
+        this.unsubscribe = eventBus.subscribe("search:completed", (payload) => {
+            void this.handleSearchCompleted(payload);
+        });
+        logger.debug("SearchSessionHook registered");
+    }
+    /** Unregister the hook (useful in tests). */
+    unregisterHook() {
+        this.unsubscribe?.();
+        this.unsubscribe = null;
+        logger.debug("SearchSessionHook unregistered");
+    }
+    /** Reset singleton (test utility). */
+    static reset() {
+        SearchSessionHook.instance?.unregisterHook();
+        SearchSessionHook.instance = null;
+    }
+    async handleSearchCompleted(payload) {
+        const { query, projectId, sessionId, results, resultCount } = payload;
+        if (resultCount === 0)
+            return;
+        // Dedup: skip if same (session, project, query) was stored recently
+        const dedupKey = `${sessionId ?? ""}:${projectId}:${query}`;
+        const now = Date.now();
+        const lastStored = this.recentKeys.get(dedupKey);
+        if (lastStored !== undefined && now - lastStored < DEDUP_TTL_MS)
+            return;
+        this.recentKeys.set(dedupKey, now);
+        this.pruneDedup(now);
+        const top3 = results
+            .slice(0, 3)
+            .map((r) => r.filePath)
+            .join(", ");
+        const content = `Search[${projectId}]: "${query}" → ${top3}`;
+        try {
+            const stored = await MemoryController.getInstance().store({
+                content,
+                type: MemoryType.CONVERSATION,
+                projectId,
+                sessionId,
+                importance: 0.3,
+                tags: ["auto:search-session", "auto:search"],
+            });
+            logger.debug("SearchSessionHook: memory stored", {
+                projectId,
+                query: query.slice(0, 60),
+                resultCount,
+            });
+            eventBus.publish("memory:session-stored", {
+                memoryId: stored.memoryId,
+                projectId,
+                sessionId,
+                query,
+            });
+        }
+        catch (err) {
+            logger.warn("SearchSessionHook: store failed (best-effort)", {
+                error: err.message,
+                projectId,
+                query: query.slice(0, 60),
+            });
+        }
+    }
+    pruneDedup(now) {
+        if (this.recentKeys.size <= MAX_DEDUP_ENTRIES)
+            return;
+        // First pass: remove expired entries
+        for (const [k, ts] of this.recentKeys) {
+            if (now - ts > DEDUP_TTL_MS)
+                this.recentKeys.delete(k);
+        }
+        // Hard cap: if still over limit, evict oldest entries (insertion order)
+        if (this.recentKeys.size > MAX_DEDUP_ENTRIES) {
+            const excess = this.recentKeys.size - MAX_DEDUP_ENTRIES;
+            let evicted = 0;
+            for (const k of this.recentKeys.keys()) {
+                this.recentKeys.delete(k);
+                if (++evicted >= excess)
+                    break;
+            }
+        }
+    }
+}
+export const searchSessionHook = SearchSessionHook.getInstance();
+//# sourceMappingURL=search-session-hook.js.map

package/dist/services/hooks/search-session-hook.js.map

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

package/dist/services/hooks/session-pin-store.d.ts

@@ -0,0 +1,32 @@
+/**
+ * session-pin-store — bounded, TTL-expiring in-memory map of
+ * `sessionId → projectId` for sticky hook attribution (HAR-04).
+ *
+ * Pins are an optimization, not a correctness dependency: process restart or
+ * eviction degrades attribution to containment/verbatim, both contract-legal.
+ * Bounds: `maxSize` entries (oldest-access evicted), `ttlMs` lazy expiry.
+ */
+export interface SessionPinStoreOptions {
+    /** Max pinned sessions. Default 1000. */
+    readonly maxSize?: number;
+    /** Pin TTL in ms. Default 24h. */
+    readonly ttlMs?: number;
+    /** Injectable clock for tests. */
+    readonly now?: () => number;
+}
+export declare class SessionPinStore {
+    private readonly maxSize;
+    private readonly ttlMs;
+    private readonly now;
+    private readonly pins;
+    constructor(options?: SessionPinStoreOptions);
+    /** Return the pinned id, refreshing recency, or undefined when absent/expired. */
+    get(sessionId: string): string | undefined;
+    /** Pin (or re-pin) a session to a project id, evicting oldest-access entries at the bound. */
+    set(sessionId: string, projectId: string): void;
+    /** Test/maintenance escape hatch. */
+    clear(): void;
+    /** @internal — exposed for tests. */
+    get size(): number;
+}
+//# sourceMappingURL=session-pin-store.d.ts.map

package/dist/services/hooks/session-pin-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-pin-store.d.ts","sourceRoot":"","sources":["../../../src/services/hooks/session-pin-store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,sBAAsB;IACrC,yCAAyC;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,kCAAkC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B;AAUD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA+B;gBAExC,OAAO,GAAE,sBAA2B;IAMhD,kFAAkF;IAClF,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAa1C,8FAA8F;IAC9F,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAW/C,qCAAqC;IACrC,KAAK,IAAI,IAAI;IAIb,qCAAqC;IACrC,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/services/hooks/session-pin-store.js

@@ -0,0 +1,57 @@
+/**
+ * session-pin-store — bounded, TTL-expiring in-memory map of
+ * `sessionId → projectId` for sticky hook attribution (HAR-04).
+ *
+ * Pins are an optimization, not a correctness dependency: process restart or
+ * eviction degrades attribution to containment/verbatim, both contract-legal.
+ * Bounds: `maxSize` entries (oldest-access evicted), `ttlMs` lazy expiry.
+ */
+const DEFAULT_MAX_SIZE = 1_000;
+const DEFAULT_TTL_MS = 24 * 60 * 60 * 1_000;
+export class SessionPinStore {
+    maxSize;
+    ttlMs;
+    now;
+    pins = new Map();
+    constructor(options = {}) {
+        this.maxSize = options.maxSize ?? DEFAULT_MAX_SIZE;
+        this.ttlMs = options.ttlMs ?? DEFAULT_TTL_MS;
+        this.now = options.now ?? Date.now;
+    }
+    /** Return the pinned id, refreshing recency, or undefined when absent/expired. */
+    get(sessionId) {
+        const entry = this.pins.get(sessionId);
+        if (!entry)
+            return undefined;
+        if (entry.expiresAt <= this.now()) {
+            this.pins.delete(sessionId);
+            return undefined;
+        }
+        // Refresh recency (Map preserves insertion order on re-set).
+        this.pins.delete(sessionId);
+        this.pins.set(sessionId, entry);
+        return entry.projectId;
+    }
+    /** Pin (or re-pin) a session to a project id, evicting oldest-access entries at the bound. */
+    set(sessionId, projectId) {
+        if (this.maxSize < 1)
+            return;
+        this.pins.delete(sessionId);
+        while (this.pins.size >= this.maxSize) {
+            const oldest = this.pins.keys().next();
+            if (oldest.done)
+                break;
+            this.pins.delete(oldest.value);
+        }
+        this.pins.set(sessionId, { projectId, expiresAt: this.now() + this.ttlMs });
+    }
+    /** Test/maintenance escape hatch. */
+    clear() {
+        this.pins.clear();
+    }
+    /** @internal — exposed for tests. */
+    get size() {
+        return this.pins.size;
+    }
+}
+//# sourceMappingURL=session-pin-store.js.map

package/dist/services/hooks/session-pin-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-pin-store.js","sourceRoot":"","sources":["../../../src/services/hooks/session-pin-store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAC/B,MAAM,cAAc,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;AAO5C,MAAM,OAAO,eAAe;IACT,OAAO,CAAS;IAChB,KAAK,CAAS;IACd,GAAG,CAAe;IAClB,IAAI,GAAG,IAAI,GAAG,EAAoB,CAAC;IAEpD,YAAY,UAAkC,EAAE;QAC9C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,gBAAgB,CAAC;QACnD,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,cAAc,CAAC;QAC7C,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IACrC,CAAC;IAED,kFAAkF;IAClF,GAAG,CAAC,SAAiB;QACnB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAC7B,IAAI,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAClC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC5B,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,6DAA6D;QAC7D,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC5B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAChC,OAAO,KAAK,CAAC,SAAS,CAAC;IACzB,CAAC;IAED,8FAA8F;IAC9F,GAAG,CAAC,SAAiB,EAAE,SAAiB;QACtC,IAAI,IAAI,CAAC,OAAO,GAAG,CAAC;YAAE,OAAO;QAC7B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACtC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;YACvC,IAAI,MAAM,CAAC,IAAI;gBAAE,MAAM;YACvB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED,qCAAqC;IACrC,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;IAED,qCAAqC;IACrC,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC;CACF"}