mindweave 0.0.1 → 2.1.2

package/dist/memory/session.js

@@ -0,0 +1,472 @@
+/**
+ * session.ts — create a fresh session or resume a saved one.
+ *
+ * A `Session` bundles the transcript, the tool context (live cwd + read ledger),
+ * and the project memory. This is the client-side init that does the disk reads
+ * (MINDWEAVE.md, a saved transcript); the engine receives a ready Session and never
+ * touches the filesystem itself.
+ */
+import { promises as fs, existsSync } from "node:fs";
+import { randomUUID } from "node:crypto";
+import { resolvePath, nextTouch, canonicalRoot } from "../tools/paths.js";
+import { latestSession, listSessions, loadMeta, loadTranscript, loadSessionNotes } from "./store.js";
+import { startChassis } from "../alternator/lane.js";
+import { BackgroundShells } from "../tools/backgroundShells.js";
+import { Checkpoints } from "../tools/checkpoints.js";
+import { projectContextText } from "../project/context.js";
+import { loadGovernance, governanceStamp } from "../governor/index.js";
+import { createRuleScope } from "../governor/scope.js";
+import { loadModelConfig } from "../dynamo/model.js";
+import { ensureMemoryDir, loadMemoryIndex, memoryDir } from "./autoMemory.js";
+import { loadMcpConfig } from "../mcp/config.js";
+import { McpManager } from "../mcp/manager.js";
+import { assembleNotes } from "./projectNotes.js";
+/**
+ * Read the project's notes: MINDWEAVE.md, the user's own, and everything they import.
+ *
+ * The layers and their rules live in projectNotes.ts. This is only the seam the
+ * session uses, kept as a single string because that is what the cached prefix takes.
+ */
+async function loadProjectMemory(cwd) {
+    return (await assembleNotes(cwd)).text;
+}
+/**
+ * Re-read MINDWEAVE.md into the live session, but only when it is FREE to do so.
+ *
+ * The model maintains MINDWEAVE.md, so it edits the file mid-session; `projectMemory`
+ * is frozen into the cached system prompt at session start. Re-reading it every turn
+ * kept the two in step, at a price that turned out to be the single most expensive
+ * line in prompt assembly: changing the system prompt string invalidates the WHOLE
+ * cached prefix — base prompt, tool schemas, project snapshot, governance — and the
+ * next request pays a full cache rewrite at 1.25x normal input rate. One edit to a
+ * small markdown file re-billed everything.
+ *
+ * The codebase already knew this hazard: standing rules were deliberately moved OUT of
+ * the cached prefix precisely so a mid-session remember_rule could not bust it. This
+ * does the same thing for the same reason.
+ *
+ * Serving the frozen copy is safe because of where the fresh copy already is. The model
+ * that just edited MINDWEAVE.md has the new content in its own transcript — it wrote it
+ * — so nothing is hidden from it. The frozen prefix is only how the NEXT session starts,
+ * and it refreshes at points where the cache is being thrown away regardless: after a
+ * compaction (which rewrites the transcript, taking the edit with it), and at session
+ * start.
+ */
+export async function reloadProjectMemory(session, opts = {}) {
+    if (!opts.force && !session.projectMemoryStale)
+        return;
+    session.projectMemory = await loadProjectMemory(session.cwd);
+    session.projectMemoryStale = false;
+}
+/**
+ * Attach the MCP server pool to a session.
+ *
+ * Deliberately NOT awaited. Servers are third-party processes and a slow one would sit
+ * between the user pressing enter and the first paint, so the pool comes up in the
+ * background and its tools appear once they are ready. Failures are already states
+ * rather than exceptions, so nothing here can reject; the `catch` is belt and braces.
+ *
+ * The cost of not awaiting is that a server landing mid-session changes the tool list
+ * and invalidates the cached prompt prefix. That cost is real and it is NOT designed
+ * away: tool schemas are a structural API field rendered before every provider's cache
+ * breakpoint, so there is no volatile tail to move them into (docs/mcp-plan.md §6, which
+ * corrects an earlier claim that there was). What Phase 3 actually bought is a stable
+ * catalog and one frozen snapshot per turn, so the cost lands once per real change
+ * instead of once per turn — which is cheap enough that the fast start is worth keeping.
+ */
+function attachMcp(ctx, cwd) {
+    const manager = new McpManager();
+    ctx.mcp = manager;
+    // Before anything connects: a tool can be dispatched as soon as its server is up, and
+    // spilled results have to land in this project's state dir rather than wherever the
+    // process happened to start.
+    manager.setProjectRoot(cwd);
+    void loadMcpConfig(cwd)
+        .then(async (configs) => {
+        await manager.start(configs);
+        // Governance is applied AFTER connecting, because both gates are about the tools
+        // a server actually turned out to advertise: a forbidden name only matters once
+        // it exists, and a changed description can only be noticed against a live one.
+        manager.setForbidden(ctx.governance?.forbidden.mcpTools ?? []);
+        // Rug-pull check. `requestApproval` may not be attached yet (the CLI wires it
+        // just after session creation), in which case `verifyTrust` fails closed and
+        // changed tools stay blocked until the next session — the safe direction.
+        await manager.verifyTrust(cwd, ctx.requestApproval);
+    })
+        .catch(() => { });
+}
+/**
+ * Seed the read-ledger with MINDWEAVE.md when it exists on disk, so the model can UPDATE
+ * the project's own memory file without a redundant read_file first. MINDWEAVE.md's content
+ * is already loaded into the system prompt (projectMemory), so the read-before-edit gate
+ * would otherwise trip on a file the model effectively already has — surfacing the
+ * confusing "MINDWEAVE.md has not been read this session" error on routine housekeeping.
+ * Keyed via resolvePath so it matches exactly what the edit gate looks up. Recorded
+ * full:false (the model works from a window, never a held whole-file copy) so it can
+ * never wrongly short-circuit a genuine read_file. Best-effort; no MINDWEAVE.md => no-op.
+ */
+async function seedProjectMemoryRead(ctx, projectMemory) {
+    if (!projectMemory)
+        return;
+    const abs = resolvePath(ctx, "MINDWEAVE.md");
+    try {
+        const st = await fs.stat(abs);
+        ctx.reads.set(abs, { mtimeMs: st.mtimeMs, size: st.size, full: false, touchedAt: nextTouch() });
+    }
+    catch {
+        // No MINDWEAVE.md on disk — nothing to seed.
+    }
+}
+/** Ensure the memory dir exists (so the model never mkdirs) and read its index. */
+async function loadMemory(cwd) {
+    await ensureMemoryDir(cwd);
+    return loadMemoryIndex(cwd);
+}
+function freshToolContext(cwd, governance, roots) {
+    // Start the alternator: one code map per root warms up in the background while
+    // the session is already usable. The forbidden config + skill catalog come from
+    // the governor so the tools can enforce/invoke them.
+    const chassisByRoot = new Map(roots.map((root) => [root, startChassis(root)]));
+    return {
+        cwd,
+        roots,
+        reads: new Map(),
+        chassis: chassisByRoot.get(cwd), // the primary root's map (drives the auto-map)
+        chassisByRoot,
+        backgroundShells: new BackgroundShells(),
+        checkpoints: new Checkpoints(),
+        todos: [],
+        // Deferred tools the model has surfaced via find_tools become callable from then on
+        // (registry.toolSchemas). Empty at start; grows as the model searches; restored from
+        // meta on resume.
+        activatedTools: new Set(),
+        // Same governance object as Session.governance — shared so mid-session edits
+        // (a new rule, a new forbidden path) are visible to both the tools and the
+        // engine's prompt without a reload.
+        governance,
+        // Which glob-scoped rules this session has activated. Filled as paths are touched
+        // (governor/scope.ts) rather than re-derived on every model call.
+        ruleScope: createRuleScope(),
+    };
+}
+/** The framing prepended to a sub-agent's task — it works alone and reports back. */
+const SUBAGENT_PREAMBLE = "You are a focused sub-agent spawned by the main Mindweave agent to complete ONE task and report back. " +
+    "Work autonomously with your tools — you cannot ask the user questions, and you do not see the main " +
+    "conversation, so rely only on the task below. Do EXACTLY what it asks and stay inside its boundaries — " +
+    "don't widen the scope, and don't change files the task didn't name. Stop as soon as the objective is met " +
+    "rather than exploring further. When finished, reply with a DISTILLED result — the answer the main agent " +
+    "needs, with concrete file:line references, and nothing else (no play-by-play). If the task specifies an " +
+    "output format, follow it exactly. Keep it tight (aim for well under a page): the main agent sees only " +
+    "your final message, not your intermediate steps.\n\nTask:\n";
+/**
+ * A scoped child session for a sub-agent. It gets its OWN transcript (seeded with
+ * the task) and its OWN read ledger + todo list, so its work is isolated and never
+ * pollutes the parent's working set. It SHARES the parent's code map, checkpoints
+ * (so its edits are undoable too) and governance by reference — everything the parent
+ * already stood up. What it does NOT get is anything the user granted in person: the
+ * approval channel, session permission grants, and the parent's approved plan all stop
+ * here. Only the child's final reply crosses back to the parent, through the spawn tool.
+ */
+export function forkSession(parent, task, opts = {}) {
+    const p = parent.toolContext;
+    const id = randomUUID();
+    const childContext = {
+        ...p,
+        reads: new Map(),
+        todos: [],
+        // Its OWN activation set, seeded with the parent's so it can call what is already
+        // active. Without the copy the spread would share the parent's Set by reference, and a
+        // sub-agent's find_tools would silently change the parent's advertised list.
+        activatedTools: new Set(p.activatedTools),
+        // Its own id, not the parent's. The spread carries `sessionId`, so a child asking
+        // "which conversation am I?" answered with the parent's — harmless while nothing
+        // writes session-scoped state from a child, and wrong the moment something does.
+        sessionId: id,
+        subagentDepth: (p.subagentDepth ?? 0) + 1,
+        readOnlyTools: opts.readOnly === true ? true : p.readOnlyTools,
+        // CLEARED, not inherited. This line used to copy the parent's value under a
+        // comment claiming it cleared it, and the engine's gate is
+        // `guarded && !guardAllowed.has(tool)` — so an inherited grant skipped the check
+        // outright. Combined with the missing approval channel below, a sub-agent the user
+        // never saw start could edit files with no prompt at all, while SECURITY.md
+        // promised Sentinel "covers every tool including sub-agent edits".
+        //
+        // "Allow all" is a judgement the user made about work they could see. It does not
+        // transfer to an agent they did not know would run. A guarded child has no channel
+        // to ask through, so its mutating tools are refused and it reports back instead —
+        // which is the failing direction to pick.
+        guardAllowed: undefined,
+        // Cleared for the same reason, and it was missed when this one was added: a folder
+        // the user allowed writing to is a judgement about work they were watching. Claude
+        // Code draws the identical line when it scopes a child — it keeps the permissions
+        // given on the command line and clears the SESSION ones, "to prevent unintended
+        // leakage".
+        allowedOutsideDirs: undefined,
+        // The parent's approved plan is NOT the child's work. Two things go wrong when it
+        // rides along: the child is handed a binding instruction to follow a plan it was not
+        // spawned for, on top of the one task it was given — and because a child runs the
+        // same turn loop, its turn ending settles that plan, marking the artifact DONE on
+        // disk while the parent is still in the middle of carrying it out.
+        //
+        // Empty string, not undefined: undefined means "not looked for yet" and would send
+        // the child to load the plan straight back off disk.
+        activePlan: "",
+        activePlanApprovedAt: undefined,
+        // A child CANNOT reach the user. The spread above inherited the parent's approval
+        // channel, so `ask_user` (which is read-only, and therefore offered even to a
+        // read-only child) put a question on screen from an agent the user never saw start
+        // — and a parallel fan-out could stack several, none of them attributable. It also
+        // made spawn_subagent's own briefing advice false: "write a COMPLETE, standalone
+        // task" only holds if the child truly cannot come back and ask.
+        // Every consumer of this channel already degrades correctly without it: ask_user
+        // tells the child to assume a sensible default and state it, and the guards fail
+        // closed. The child's findings reach the user through its result, where the parent
+        // can weigh them.
+        requestApproval: undefined,
+    };
+    return {
+        ...parent,
+        id,
+        createdAt: Date.now(),
+        transcript: [{ role: "user", content: SUBAGENT_PREAMBLE + task }],
+        toolContext: childContext,
+    };
+}
+/** A brand-new session rooted at `cwd` (defaults to the process cwd). */
+/**
+ * A brand-new session.
+ *
+ * `carryRoots` is for starting over WITHOUT losing the workspace: `/clear` builds a
+ * fresh session in the same folder, and the folders someone added with `/include` or
+ * `/link` belong to the folder they are working in, not to the conversation they just
+ * ended. Dropping them was silent — every tool quietly narrowed to one root and
+ * nothing said so. Missing folders are filtered and the primary is de-duplicated, the
+ * same way `resumeSession` treats the roots it restores.
+ */
+export async function createSession(rawCwd = process.cwd(), carryRoots = []) {
+    // Canonicalise the root ONCE, here, before anything derives from it. run_command
+    // reports where it ended up as a physical path, and on macOS a great deal sits
+    // behind symlinks (/tmp, and all of os.tmpdir()), so a session opened at a logical
+    // path would compare unequal to its own cwd after the first command. See
+    // canonicalRoot. Doing it at the single point of entry is what keeps every root,
+    // every recorded cwd, and every relativized path speaking the same form.
+    const cwd = await canonicalRoot(rawCwd);
+    const [projectMemory, memoryIndex, projectContext, governance, stamp, modelConfig, earlier] = await Promise.all([
+        loadProjectMemory(cwd),
+        loadMemory(cwd),
+        projectContextText(cwd),
+        loadGovernance(cwd),
+        governanceStamp(cwd),
+        loadModelConfig(cwd),
+        listSessions(cwd),
+    ]);
+    const id = randomUUID();
+    // Canonicalised BEFORE comparing. `cwd` has already been through canonicalRoot, so a
+    // raw string comparison misses the primary root arriving in another spelling — an 8.3
+    // short path, a symlinked temp directory, different drive-letter case — and adds it a
+    // second time. CI caught exactly that: its temp directory canonicalises differently
+    // from the path handed in, so the workspace came back with the same folder twice.
+    const carried = await Promise.all(carryRoots.map((r) => canonicalRoot(r)));
+    const seenRoot = new Set([cwd]);
+    const extra = carried.filter((r) => {
+        if (seenRoot.has(r) || !existsSync(r))
+            return false;
+        seenRoot.add(r);
+        return true;
+    });
+    const toolContext = freshToolContext(cwd, governance, [cwd, ...extra]);
+    // So the session tools can exclude this conversation from "your past sessions".
+    toolContext.sessionId = id;
+    attachMcp(toolContext, cwd);
+    await seedProjectMemoryRead(toolContext, projectMemory);
+    return {
+        id,
+        cwd,
+        createdAt: Date.now(),
+        transcript: [],
+        toolContext,
+        projectMemory,
+        memoryDir: memoryDir(cwd),
+        memoryIndex,
+        // Everything already saved predates this brand-new session.
+        priorSessions: earlier.length,
+        projectContext,
+        governance,
+        // Stamped at load so the first turn's freshness check settles instead of reloading
+        // what was just read. See governor/freshness.ts.
+        governanceStamp: stamp,
+        modelConfig,
+    };
+}
+/**
+ * Resume the most recent saved session for `cwd` (or a specific `id`), returning
+ * a live Session with its transcript loaded. Returns null when there's nothing
+ * to resume. The tool context starts fresh — the model re-reads files before it
+ * edits them (that's the read-before-edit contract), so a resumed session simply
+ * re-reads as needed rather than trusting a stale ledger.
+ */
+/**
+ * Repair a transcript that was cut off mid-tool. If the session was closed between the
+ * model issuing tool calls and their results being recorded (PC shutdown, force-kill,
+ * crash), some `tool_calls` have no matching `tool` result — which the provider rejects
+ * (breaking /continue) and which hides that the tool never finished. For every
+ * unanswered call we insert a synthetic result, right after its assistant message so the
+ * tool group stays contiguous, marking it interrupted so the model re-checks the real
+ * state before trusting or repeating it. Pure; returns a new array (unchanged if nothing
+ * was dangling). Exported for tests.
+ */
+/**
+ * Move anything that got wedged BETWEEN a `tool_calls` message and its results back
+ * out to after them. Pure; returns a new array (unchanged when nothing is stranded).
+ *
+ * Providers require a message carrying `tool_calls` to be followed immediately by one
+ * `tool` message per call. A build of Mindweave briefly appended its narration nudge
+ * the moment it judged the fault — right after the assistant message and before any
+ * result — so sessions written in that window hold a permanently invalid order and
+ * every resume of one dies on the first request:
+ *
+ *   assistant(tool_calls) → user(nudge) → tool → tool        ← rejected
+ *   assistant(tool_calls) → tool → tool → user(nudge)        ← what it should be
+ *
+ * The engine no longer produces this, but a fix that only stops NEW corruption leaves
+ * the already-saved sessions unopenable, and those hold the user's actual work. The
+ * stranded message is MOVED rather than dropped: it may be something the person typed,
+ * and repair is not a licence to lose it.
+ */
+export function repairToolCallOrder(transcript) {
+    const out = [];
+    let moved = false;
+    let i = 0;
+    while (i < transcript.length) {
+        const entry = transcript[i];
+        out.push(entry);
+        i++;
+        if (entry.role !== "assistant" || !entry.toolCalls?.length)
+            continue;
+        const owed = new Set(entry.toolCalls.map((c) => c.id));
+        const results = [];
+        const stranded = [];
+        // Walk forward while results are still outstanding, keeping them in order and
+        // setting aside anything that does not belong inside the group. A new assistant
+        // message means the group was abandoned — stop and let reconcile fill the gaps.
+        while (i < transcript.length && owed.size > 0) {
+            const next = transcript[i];
+            if (next.role === "assistant")
+                break;
+            if (next.role === "tool" && owed.has(next.toolCallId)) {
+                owed.delete(next.toolCallId);
+                results.push(next);
+            }
+            else {
+                stranded.push(next);
+                moved = true;
+            }
+            i++;
+        }
+        out.push(...results, ...stranded);
+    }
+    return moved ? out : transcript;
+}
+export function reconcileInterruptedTools(transcript) {
+    const answered = new Set();
+    for (const e of transcript)
+        if (e.role === "tool")
+            answered.add(e.toolCallId);
+    let repaired = false;
+    const out = [];
+    for (const e of transcript) {
+        out.push(e);
+        if (e.role === "assistant" && e.toolCalls?.length) {
+            for (const call of e.toolCalls) {
+                if (answered.has(call.id))
+                    continue;
+                answered.add(call.id); // guard against a (malformed) duplicate id
+                repaired = true;
+                out.push({
+                    role: "tool",
+                    toolCallId: call.id,
+                    content: `[interrupted] '${call.name}' did not finish — the session was closed before this tool ` +
+                        `returned, so its effect on disk/state is unknown. Re-check the current state (files, ` +
+                        `processes, installs) before relying on it or running it again.`,
+                    summary: `${call.name} — interrupted (session closed)`,
+                    isError: true,
+                });
+            }
+        }
+    }
+    return repaired ? out : transcript;
+}
+export async function resumeSession(cwd = process.cwd(), id) {
+    const meta = id ? await loadMeta(cwd, id) : await latestSession(cwd);
+    if (!meta)
+        return null;
+    const loaded = await loadTranscript(cwd, meta.id);
+    if (!loaded || loaded.length === 0)
+        return null;
+    // A session closed mid-tool (PC shutdown, force-kill) leaves the model's tool_calls
+    // with no results — invalid to replay and silent about what didn't finish. Repair it
+    // so /continue resumes cleanly and the model re-checks the interrupted step.
+    // Order first, then fill gaps: reconcile inserts results right after their assistant
+    // message, so it must see a group that is already contiguous.
+    const transcript = reconcileInterruptedTools(repairToolCallOrder(loaded));
+    const [projectMemory, memoryIndex, projectContext, governance, stamp, modelConfig, sessionMemory, saved] = await Promise.all([
+        loadProjectMemory(cwd),
+        loadMemory(cwd),
+        projectContextText(cwd),
+        loadGovernance(cwd),
+        governanceStamp(cwd),
+        loadModelConfig(cwd),
+        loadSessionNotes(cwd, meta.id),
+        listSessions(cwd),
+    ]);
+    // Restore any added roots that still exist on disk (primary first).
+    const extra = (meta.extraRoots ?? []).filter((r) => existsSync(r));
+    const roots = [cwd, ...extra];
+    const toolContext = freshToolContext(cwd, governance, roots);
+    // Undo history is in-memory, so a resumed session starts with none even though the
+    // earlier turns really did change files. Marking it lets /undo explain that rather
+    // than claim nothing has happened.
+    toolContext.checkpoints?.noteResumed();
+    toolContext.sessionId = meta.id;
+    // Re-advertise the deferred tools this session had already surfaced, so a continued
+    // session keeps them callable instead of stripping a tool the model was mid-use of.
+    if (meta.activatedTools && meta.activatedTools.length > 0) {
+        toolContext.activatedTools = new Set(meta.activatedTools);
+    }
+    attachMcp(toolContext, cwd);
+    await seedProjectMemoryRead(toolContext, projectMemory);
+    return {
+        id: meta.id,
+        cwd,
+        createdAt: meta.createdAt ?? Date.now(),
+        transcript,
+        toolContext,
+        projectMemory,
+        memoryDir: memoryDir(cwd),
+        memoryIndex,
+        // The session being resumed is not "prior" to itself.
+        priorSessions: Math.max(0, saved.filter((m) => m.id !== meta.id).length),
+        projectContext,
+        governance,
+        // Stamped at load so the first turn's freshness check settles instead of reloading
+        // what was just read. See governor/freshness.ts.
+        governanceStamp: stamp,
+        modelConfig,
+        // The maintained session notes survive a resume, so a continued session keeps its
+        // crisp running state. The watermark starts fresh; it'll refresh as it grows again.
+        ...(sessionMemory ? { sessionMemory, sessionMemoryInit: true } : {}),
+        // What the session has already cost, and the per-call detail behind it.
+        //
+        // Restored, not restarted. Leaving these out did not merely forget the earlier
+        // turns — the next save OVERWRITES the meta file, so a resumed session replaced a
+        // true running total with a smaller one and the earlier spend was gone for good. A
+        // session's cost is the cost of the whole session; `/continue` is not a new session.
+        //
+        // Deliberately unlike `prefixPrint`, which is NOT restored: that one asserts the
+        // provider still holds a cache, and after a resume it does not. These are records of
+        // what happened, and what happened does not stop being true.
+        ...(meta.spend ? { spend: meta.spend } : {}),
+        ...(meta.callLog ? { callLog: meta.callLog } : {}),
+    };
+}
+//# sourceMappingURL=session.js.map

package/dist/memory/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/memory/session.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAE1E,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACrG,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAc,MAAM,mBAAmB,CAAC;AAE9D;;;;;GAKG;AACH,KAAK,UAAU,iBAAiB,CAAC,GAAW;IAC1C,OAAO,CAAC,MAAM,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AACzC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAAgB,EAAE,OAA4B,EAAE;IACxF,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,kBAAkB;QAAE,OAAO;IACvD,OAAO,CAAC,aAAa,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7D,OAAO,CAAC,kBAAkB,GAAG,KAAK,CAAC;AACrC,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,SAAS,SAAS,CAAC,GAAgB,EAAE,GAAW;IAC9C,MAAM,OAAO,GAAG,IAAI,UAAU,EAAE,CAAC;IACjC,GAAG,CAAC,GAAG,GAAG,OAAO,CAAC;IAClB,sFAAsF;IACtF,oFAAoF;IACpF,6BAA6B;IAC7B,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;IAC5B,KAAK,aAAa,CAAC,GAAG,CAAC;SACpB,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACtB,MAAM,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7B,iFAAiF;QACjF,gFAAgF;QAChF,+EAA+E;QAC/E,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,SAAS,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;QAC/D,8EAA8E;QAC9E,6EAA6E;QAC7E,0EAA0E;QAC1E,MAAM,OAAO,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,eAAe,CAAC,CAAC;IACtD,CAAC,CAAC;SACD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;AACrB,CAAC;AAED;;;;;;;;;GASG;AACH,KAAK,UAAU,qBAAqB,CAAC,GAAgB,EAAE,aAAqB;IAC1E,IAAI,CAAC,aAAa;QAAE,OAAO;IAC3B,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAC7C,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9B,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;IAClG,CAAC;IAAC,MAAM,CAAC;QACP,6CAA6C;IAC/C,CAAC;AACH,CAAC;AAED,mFAAmF;AACnF,KAAK,UAAU,UAAU,CAAC,GAAW;IACnC,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;IAC3B,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAW,EAAE,UAAsB,EAAE,KAAe;IAC5E,+EAA+E;IAC/E,gFAAgF;IAChF,qDAAqD;IACrD,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,CAAU,CAAC,CAAC,CAAC;IACxF,OAAO;QACL,GAAG;QACH,KAAK;QACL,KAAK,EAAE,IAAI,GAAG,EAAE;QAChB,OAAO,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,+CAA+C;QAChF,aAAa;QACb,gBAAgB,EAAE,IAAI,gBAAgB,EAAE;QACxC,WAAW,EAAE,IAAI,WAAW,EAAE;QAC9B,KAAK,EAAE,EAAE;QACT,oFAAoF;QACpF,qFAAqF;QACrF,kBAAkB;QAClB,cAAc,EAAE,IAAI,GAAG,EAAU;QACjC,6EAA6E;QAC7E,2EAA2E;QAC3E,oCAAoC;QACpC,UAAU;QACV,kFAAkF;QAClF,kEAAkE;QAClE,SAAS,EAAE,eAAe,EAAE;KAC7B,CAAC;AACJ,CAAC;AAED,qFAAqF;AACrF,MAAM,iBAAiB,GACrB,wGAAwG;IACxG,qGAAqG;IACrG,yGAAyG;IACzG,2GAA2G;IAC3G,0GAA0G;IAC1G,0GAA0G;IAC1G,wGAAwG;IACxG,6DAA6D,CAAC;AAEhE;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,MAAe,EAAE,IAAY,EAAE,OAA+B,EAAE;IAC1F,MAAM,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC;IAC7B,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;IACxB,MAAM,YAAY,GAAgB;QAChC,GAAG,CAAC;QACJ,KAAK,EAAE,IAAI,GAAG,EAAE;QAChB,KAAK,EAAE,EAAE;QACT,kFAAkF;QAClF,uFAAuF;QACvF,6EAA6E;QAC7E,cAAc,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC;QACzC,kFAAkF;QAClF,iFAAiF;QACjF,iFAAiF;QACjF,SAAS,EAAE,EAAE;QACb,aAAa,EAAE,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC,GAAG,CAAC;QACzC,aAAa,EAAE,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa;QAC9D,4EAA4E;QAC5E,2DAA2D;QAC3D,iFAAiF;QACjF,mFAAmF;QACnF,4EAA4E;QAC5E,mEAAmE;QACnE,EAAE;QACF,kFAAkF;QAClF,mFAAmF;QACnF,kFAAkF;QAClF,0CAA0C;QAC1C,YAAY,EAAE,SAAS;QACvB,mFAAmF;QACnF,mFAAmF;QACnF,kFAAkF;QAClF,gFAAgF;QAChF,YAAY;QACZ,kBAAkB,EAAE,SAAS;QAC7B,kFAAkF;QAClF,qFAAqF;QACrF,kFAAkF;QAClF,kFAAkF;QAClF,mEAAmE;QACnE,EAAE;QACF,mFAAmF;QACnF,qDAAqD;QACrD,UAAU,EAAE,EAAE;QACd,oBAAoB,EAAE,SAAS;QAC/B,kFAAkF;QAClF,8EAA8E;QAC9E,mFAAmF;QACnF,mFAAmF;QACnF,iFAAiF;QACjF,gEAAgE;QAChE,iFAAiF;QACjF,iFAAiF;QACjF,mFAAmF;QACnF,kBAAkB;QAClB,eAAe,EAAE,SAAS;KAC3B,CAAC;IACF,OAAO;QACL,GAAG,MAAM;QACT,EAAE;QACF,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI,EAAE,CAAC;QACjE,WAAW,EAAE,YAAY;KAC1B,CAAC;AACJ,CAAC;AAED,yEAAyE;AACzE;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,SAAiB,OAAO,CAAC,GAAG,EAAE,EAC9B,aAAgC,EAAE;IAElC,iFAAiF;IACjF,+EAA+E;IAC/E,mFAAmF;IACnF,yEAAyE;IACzE,iFAAiF;IACjF,yEAAyE;IACzE,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,CAAC,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC9G,iBAAiB,CAAC,GAAG,CAAC;QACtB,UAAU,CAAC,GAAG,CAAC;QACf,kBAAkB,CAAC,GAAG,CAAC;QACvB,cAAc,CAAC,GAAG,CAAC;QACnB,eAAe,CAAC,GAAG,CAAC;QACpB,eAAe,CAAC,GAAG,CAAC;QACpB,YAAY,CAAC,GAAG,CAAC;KAClB,CAAC,CAAC;IACH,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;IACxB,qFAAqF;IACrF,sFAAsF;IACtF,sFAAsF;IACtF,oFAAoF;IACpF,kFAAkF;IAClF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3E,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACjC,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QACpD,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IACH,MAAM,WAAW,GAAG,gBAAgB,CAAC,GAAG,EAAE,UAAU,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC;IACvE,gFAAgF;IAChF,WAAW,CAAC,SAAS,GAAG,EAAE,CAAC;IAC3B,SAAS,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;IAC5B,MAAM,qBAAqB,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IACxD,OAAO;QACL,EAAE;QACF,GAAG;QACH,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,UAAU,EAAE,EAAE;QACd,WAAW;QACX,aAAa;QACb,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC;QACzB,WAAW;QACX,4DAA4D;QAC5D,aAAa,EAAE,OAAO,CAAC,MAAM;QAC7B,cAAc;QACd,UAAU;QACV,mFAAmF;QACnF,iDAAiD;QACjD,eAAe,EAAE,KAAK;QACtB,WAAW;KACZ,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH;;;;;;;;;GASG;AACH;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAmB;IACrD,MAAM,GAAG,GAAY,EAAE,CAAC;IACxB,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,IAAI,CAAC,GAAG,CAAC,CAAC;IAEV,OAAO,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAE,CAAC;QAC7B,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,EAAE,CAAC;QACJ,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM;YAAE,SAAS;QAErE,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACvD,MAAM,OAAO,GAAY,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAY,EAAE,CAAC;QAC7B,8EAA8E;QAC9E,gFAAgF;QAChF,gFAAgF;QAChF,OAAO,CAAC,GAAG,UAAU,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YAC9C,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAE,CAAC;YAC5B,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW;gBAAE,MAAM;YACrC,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;gBACtD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBAC7B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACpB,KAAK,GAAG,IAAI,CAAC;YACf,CAAC;YACD,CAAC,EAAE,CAAC;QACN,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,GAAG,OAAO,EAAE,GAAG,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,UAAmB;IAC3D,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,KAAK,MAAM,CAAC,IAAI,UAAU;QAAE,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM;YAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAE9E,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,MAAM,GAAG,GAAY,EAAE,CAAC;IACxB,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACZ,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;YAClD,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;gBAC/B,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;oBAAE,SAAS;gBACpC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,2CAA2C;gBAClE,QAAQ,GAAG,IAAI,CAAC;gBAChB,GAAG,CAAC,IAAI,CAAC;oBACP,IAAI,EAAE,MAAM;oBACZ,UAAU,EAAE,IAAI,CAAC,EAAE;oBACnB,OAAO,EACL,kBAAkB,IAAI,CAAC,IAAI,6DAA6D;wBACxF,uFAAuF;wBACvF,gEAAgE;oBAClE,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,iCAAiC;oBACtD,OAAO,EAAE,IAAI;iBACd,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC;AACrC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAc,OAAO,CAAC,GAAG,EAAE,EAC3B,EAAW;IAEX,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,aAAa,CAAC,GAAG,CAAC,CAAC;IACrE,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvB,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IAClD,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAChD,oFAAoF;IACpF,qFAAqF;IACrF,6EAA6E;IAC7E,qFAAqF;IACrF,8DAA8D;IAC9D,MAAM,UAAU,GAAG,yBAAyB,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC;IAE1E,MAAM,CAAC,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,KAAK,CAAC,GACtG,MAAM,OAAO,CAAC,GAAG,CAAC;QAChB,iBAAiB,CAAC,GAAG,CAAC;QACtB,UAAU,CAAC,GAAG,CAAC;QACf,kBAAkB,CAAC,GAAG,CAAC;QACvB,cAAc,CAAC,GAAG,CAAC;QACnB,eAAe,CAAC,GAAG,CAAC;QACpB,eAAe,CAAC,GAAG,CAAC;QACpB,gBAAgB,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC;QAC9B,YAAY,CAAC,GAAG,CAAC;KAClB,CAAC,CAAC;IACL,oEAAoE;IACpE,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACnE,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC;IAC9B,MAAM,WAAW,GAAG,gBAAgB,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;IAC7D,mFAAmF;IACnF,mFAAmF;IACnF,mCAAmC;IACnC,WAAW,CAAC,WAAW,EAAE,WAAW,EAAE,CAAC;IACvC,WAAW,CAAC,SAAS,GAAG,IAAI,CAAC,EAAE,CAAC;IAChC,oFAAoF;IACpF,oFAAoF;IACpF,IAAI,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1D,WAAW,CAAC,cAAc,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC5D,CAAC;IACD,SAAS,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;IAC5B,MAAM,qBAAqB,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IACxD,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,GAAG;QACH,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE;QACvC,UAAU;QACV,WAAW;QACX,aAAa;QACb,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC;QACzB,WAAW;QACX,sDAAsD;QACtD,aAAa,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC;QACxE,cAAc;QACd,UAAU;QACV,mFAAmF;QACnF,iDAAiD;QACjD,eAAe,EAAE,KAAK;QACtB,WAAW;QACX,kFAAkF;QAClF,oFAAoF;QACpF,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,wEAAwE;QACxE,EAAE;QACF,+EAA+E;QAC/E,kFAAkF;QAClF,mFAAmF;QACnF,qFAAqF;QACrF,EAAE;QACF,iFAAiF;QACjF,qFAAqF;QACrF,6DAA6D;QAC7D,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5C,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACnD,CAAC;AACJ,CAAC"}

package/dist/memory/sessionMemory.js

@@ -0,0 +1,142 @@
+import { estimateEntriesTokens, estimateTokens, formatTranscriptForSummary } from "./compaction.js";
+import { activeDriver } from "../drivers/registry.js";
+const env = (name, fallback) => {
+    const v = Number(process.env[name]);
+    return Number.isFinite(v) && v > 0 ? v : fallback;
+};
+/**
+ * First update once the transcript passes this (let a session warm up first).
+ *
+ * Deliberately LOW. At 10K a session could do a whole piece of real work and end
+ * having never written a note, so a later `read_session` found nothing and fell back
+ * to the raw transcript — a worse answer, for more tokens, after an extra round trip.
+ * The bar only exists so a two-message session doesn't pay for a model call; 4K is
+ * enough warm-up for that and cheap enough that ordinary sessions get real notes.
+ */
+const INIT_THRESHOLD = env("MINDWEAVE_SESSION_MEMORY_INIT", 4_000);
+/** Refresh the notes after this much further growth (token-gated). */
+const UPDATE_THRESHOLD = env("MINDWEAVE_SESSION_MEMORY_UPDATE", 12_000);
+/** How many recent transcript entries feed an update (the notes carry the older state). */
+const RECENT_ENTRIES = env("MINDWEAVE_SESSION_MEMORY_RECENT", 40);
+/** Hard cap on the notes so they can't themselves bloat context (~12K tokens total,
+ *  ~2K per section). */
+export const SESSION_MEMORY_MAX_TOKENS = env("MINDWEAVE_SESSION_MEMORY_MAX_TOKENS", 12_000);
+/** Per-section soft budget — condense a section past this (~2K/section). */
+export const SESSION_MEMORY_SECTION_TOKENS = env("MINDWEAVE_SESSION_MEMORY_SECTION_TOKENS", 2_000);
+/** The structured skeleton the model fills in and keeps current. The
+ *  italic _descriptions_ are template instructions (kept intact); the model only fills
+ *  the content beneath each. "Current State" is first-class: it's what lets the model
+ *  pick up cleanly after a compaction. */
+export const SESSION_MEMORY_TEMPLATE = `# Session Title
+_A short and distinctive 5-10 word descriptive title for the session. Super info dense, no filler_
+
+# Current State
+_What is actively being worked on right now? Pending tasks not yet completed. Immediate next steps._
+
+# Task specification
+_What did the user ask to build? Any design decisions or other explanatory context_
+
+# Files and Functions
+_What are the important files? In short, what do they contain and why are they relevant?_
+
+# Workflow
+_What commands are usually run and in what order? How to interpret their output if not obvious?_
+
+# Errors & Corrections
+_Errors encountered and how they were fixed. What did the user correct? What approaches failed and should not be tried again?_
+
+# Codebase and System Documentation
+_What are the important system components? How do they work/fit together?_
+
+# Learnings
+_What has worked well? What has not? What to avoid? Do not duplicate items from other sections_
+
+# Key results
+_If the user asked a specific output such as an answer to a question, a table, or other document, repeat the exact result here_
+
+# Worklog
+_Step by step, what was attempted, done? Very terse summary for each step_`;
+const UPDATE_SYSTEM = "You maintain a running notes document that captures the live state of a software " +
+    "engineering session, so work can continue seamlessly across context compaction. You " +
+    "will be given the CURRENT notes and the RECENT conversation. Return the COMPLETE updated " +
+    "notes document. Rules:\n" +
+    "- Keep EVERY section header exactly, and keep the italic _description_ line under each " +
+    "header intact (those are template instructions, not content) — only update the content " +
+    "beneath them.\n" +
+    "- Fold new activity into the right sections; write DENSE, specific content (file paths, " +
+    "function names, exact commands, error messages, decisions).\n" +
+    `- Keep each section under ~${SESSION_MEMORY_SECTION_TOKENS} tokens: when one grows past that, ` +
+    "CYCLE OUT the least important details while preserving the most critical.\n" +
+    "- Leave a section unchanged if there's nothing substantial to add (no filler like 'N/A').\n" +
+    "- ALWAYS keep 'Current State' accurate to the latest turn — it's what continues the work " +
+    "after compaction.\n" +
+    "Output ONLY the notes document — no preamble, no commentary, no code fences.";
+const UPDATE_REQUEST = "Update the notes with anything new from the recent conversation, then output the full " +
+    "updated notes document (same section headers and italic descriptions, dense, concise).";
+/**
+ * Whether to refresh the notes now (pure). The token threshold is ALWAYS the gate,
+ * so updates don't fire too often; before the first update we wait for the
+ * session to warm past the init bar.
+ */
+export function shouldUpdateSessionMemory(currentTokens, lastUpdateTokens, initialized) {
+    if (!initialized)
+        return currentTokens >= INIT_THRESHOLD;
+    return currentTokens - lastUpdateTokens >= UPDATE_THRESHOLD;
+}
+/** The injected block (volatile tail — it changes as it's refreshed, so it must NOT
+ *  sit in the cached prefix). "" when there are no notes yet. */
+export function renderSessionMemory(notes) {
+    const trimmed = notes.trim();
+    if (!trimmed)
+        return "";
+    return ("Your maintained notes on THIS session's state (kept current across compaction — " +
+        "trust these for what's done, what's in flight, and what already failed):\n" +
+        `<session_memory>\n${trimmed}\n</session_memory>`);
+}
+/** Keep the notes under budget: if the model over-produces, trim to the cap (pure). */
+export function boundSessionMemory(notes, maxTokens = SESSION_MEMORY_MAX_TOKENS) {
+    if (estimateTokens(notes) <= maxTokens)
+        return notes;
+    const maxChars = Math.floor(maxTokens * 3.5);
+    return notes.slice(0, maxChars).trimEnd() + "\n\n(notes truncated to stay within budget)";
+}
+/**
+ * Refresh the session notes from the recent transcript (one cheap model call, thinking
+ * off). Mutates `session.sessionMemory` + the token watermark IN MEMORY only — the CLI
+ * persists the notes file, keeping the engine filesystem-pure. Degrade-safe: on any
+ * failure the previous notes are kept untouched.
+ */
+export async function updateSessionMemory(session) {
+    const recent = session.transcript.slice(-RECENT_ENTRIES);
+    if (recent.length === 0)
+        return false;
+    const current = session.sessionMemory?.trim() || SESSION_MEMORY_TEMPLATE;
+    try {
+        const { content } = await activeDriver().toolTurn({
+            system: UPDATE_SYSTEM,
+            messages: [
+                {
+                    role: "user",
+                    content: `CURRENT NOTES:\n${current}\n\n` +
+                        `RECENT CONVERSATION:\n${formatTranscriptForSummary(recent)}\n\n${UPDATE_REQUEST}`,
+                },
+            ],
+            model: { ...session.modelConfig, thinking: false },
+        });
+        const notes = content.trim();
+        if (!notes)
+            return false;
+        session.sessionMemory = boundSessionMemory(notes);
+        session.sessionMemoryTokens = estimateEntriesTokens(session.transcript);
+        // The boundary compaction-from-notes splits on: everything up to here is written
+        // down, everything after it has to be kept verbatim. Recorded at the same moment
+        // as the notes so the two can never describe different transcripts.
+        session.sessionMemoryEntries = session.transcript.length;
+        session.sessionMemoryInit = true;
+        return true;
+    }
+    catch {
+        return false; // keep the last good notes
+    }
+}
+//# sourceMappingURL=sessionMemory.js.map

package/dist/memory/sessionMemory.js.map

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