@dsh-cc/memory 0.5.0

package/lib/scan.js

@@ -0,0 +1,70 @@
+/**
+ * Directory scan over a memdir through the optional `ctx.fs` seam: list topic
+ * files, parse their frontmatter, and read the always-loaded entrypoint. Used
+ * by the system-prompt section index and by recall.
+ * @module @dsh-cc/memory/scan
+ */
+import { parseMemoryFile } from "./parser.js";
+import { ENTRYPOINT_NAME } from "./truncate.js";
+/**
+ * Scan a memory directory for its entrypoint and topic files.
+ * A missing directory or entrypoint is not an error — the caller renders an
+ * empty section. Files are read with the caller's cancellation signal; the
+ * result contains only topics whose frontmatter parsed successfully.
+ * @param fs - the contiguous filesystem seam.
+ * @param dir - the memory directory to scan.
+ * @param signal - optional cancellation for the underlying fs reads.
+ * @returns the observed directory state, never throwing for absent files.
+ */
+export async function scanMemoryDirectory(fs, dir, signal) {
+    const topics = [];
+    let entrypoint;
+    let entries;
+    try {
+        const target = signal !== undefined
+            ? await fs.resolve(dir, { signal })
+            : await fs.resolve(dir);
+        entries = await fs.listDir(target, signal);
+    }
+    catch {
+        // Missing or unreadable memory directory: treat as empty.
+        return { dir, entrypoint: undefined, topics };
+    }
+    for (const entry of entries) {
+        if (entry.type !== 'file')
+            continue;
+        if (entry.name === ENTRYPOINT_NAME) {
+            entrypoint = await readOptionalText(fs, entry.target, signal);
+            continue;
+        }
+        if (!entry.name.endsWith('.md'))
+            continue;
+        const raw = await readOptionalText(fs, entry.target, signal);
+        if (raw === undefined)
+            continue;
+        const parsed = parseMemoryFile(raw);
+        if (parsed === undefined)
+            continue;
+        topics.push({ path: entry.target.displayPath, filename: entry.name, frontmatter: parsed.frontmatter });
+    }
+    topics.sort((a, b) => a.filename.localeCompare(b.filename));
+    return { dir, entrypoint, topics };
+}
+async function readOptionalText(fs, target, signal) {
+    try {
+        return await fs.readText(target, signal);
+    }
+    catch (error) {
+        if (isNotFound(error))
+            return undefined;
+        throw error;
+    }
+}
+function isNotFound(error) {
+    return typeof error === 'object' && error !== null
+        && 'code' in error
+        && (error.code === 'FS_NOT_FOUND'
+            || error.code === 'FS_NOT_DIRECTORY'
+            || error.code === 'ENOENT');
+}
+//# sourceMappingURL=scan.js.map

package/lib/scan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.js","sourceRoot":"","sources":["../src/scan.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAa/C;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,EAAc,EACd,GAAW,EACX,MAAoB;IAEpB,MAAM,MAAM,GAAuB,EAAE,CAAA;IACrC,IAAI,UAA8B,CAAA;IAClC,IAAI,OAAO,CAAA;IACX,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,KAAK,SAAS;YACjC,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC;YACnC,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QACzB,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,0DAA0D;QAC1D,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,CAAA;IAC/C,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;YAAE,SAAQ;QACnC,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;YACnC,UAAU,GAAG,MAAM,gBAAgB,CAAC,EAAE,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;YAC7D,SAAQ;QACV,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAQ;QACzC,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,EAAE,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAC5D,IAAI,GAAG,KAAK,SAAS;YAAE,SAAQ;QAC/B,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,CAAA;QACnC,IAAI,MAAM,KAAK,SAAS;YAAE,SAAQ;QAClC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAA;IACxG,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;IAC3D,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,CAAA;AACpC,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,EAAc,EACd,MAAgB,EAChB,MAAoB;IAEpB,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,UAAU,CAAC,KAAK,CAAC;YAAE,OAAO,SAAS,CAAA;QACvC,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;WAC7C,MAAM,IAAI,KAAK;WACf,CAAE,KAAiB,CAAC,IAAI,KAAK,cAAc;eACxC,KAAiB,CAAC,IAAI,KAAK,kBAAkB;eAC7C,KAA2B,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAA;AACxD,CAAC"}

package/lib/section.d.ts

@@ -0,0 +1,129 @@
+/**
+ * The `memory` system-prompt section: save-channel guidance plus one layer
+ * per memory scope — the workspace-private directory, the global directory,
+ * and (when `teamEnabled`) the workspace's team directory. Plugins mount once
+ * on the root context, so a single global section serves every agent: the
+ * text callback receives the assembling agent through `AssembleContext.scope`
+ * (the agent loop passes `scope: agent`) and renders that agent's workspace
+ * layer. Delegated children (`delegationDepth > 0`) render an empty string so
+ * the section drops out of the child prompt. Directory scans run in the
+ * background through `ctx.fs`; rendered per-layer fragments are cached and
+ * `system-prompt/change` fires only when a fragment actually changed. The
+ * section always renders for a top-level agent (a memoryless layer shows a
+ * placeholder) so the save guidance never disappears.
+ * @module @dsh-cc/memory/section
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { Agent } from '@deepseek-ai/dsh-agent';
+import type { MemoryDirectoryState } from './scan.ts';
+/** Default order slot for the memory section (before tool guidance). */
+export declare const MEMORY_SECTION_ORDER = 90;
+/** The section's unique name. */
+export declare const MEMORY_SECTION_NAME = "memory";
+/** A memory layer surfaced in the section. */
+export interface MemoryLayer {
+    /** Scope tag shown in the combined index. */
+    scope: 'workspace' | 'global' | 'team';
+    /** Heading label for the layer's entrypoint block. */
+    label: string;
+    /** The layer's directory. */
+    dir: string;
+    /** The last scanned state, or `undefined` while the first scan is pending. */
+    state: MemoryDirectoryState | undefined;
+}
+/**
+ * Owner of the cached `memory` section text. Holds one scanned state per
+ * memory directory so the synchronous section provider can compose the text,
+ * and refreshes states from disk.
+ */
+export declare class MemorySection {
+    private readonly ctx;
+    private readonly home;
+    private readonly states;
+    private readonly fragments;
+    private readonly refreshers;
+    private readonly teamEnabled;
+    /**
+     * Create a cache holder bounded to a memory home.
+     * @param ctx - the host context whose `fs` seam and `system-prompt/change`
+     *   channel drive refresh.
+     * @param home - the memory home: the global layer's directory, and the root
+     *   under which each workspace's private directory lives (`projects/<slug>`).
+     * @param options - when `teamEnabled` is set, each workspace also surfaces
+     *   its shared team directory (`<workspaceDir>/team`).
+     */
+    constructor(ctx: Context, home: string, options?: {
+        teamEnabled?: boolean;
+    });
+    /** Register the `memory` section, its assemble-waterfall reconciliation,
+     * and start the global layer's first scan.
+     *
+     * The waterfall listener removes the first-assembly placeholder jitter:
+     * `systemPrompt.assemble()` runs BEFORE the agent pre-step, so the section
+     * text callback cannot await the directory scans — but the waterfall can.
+     * After the base assembly, a scope with unscanned layers joins the
+     * in-flight `refresh(agent)` (bounded by {@linkcode READINESS_BUDGET_MS};
+     * per-directory refreshers self-deduplicate, so this is the same promise
+     * the background scan already started) and re-renders the section with the
+     * same render function the section callback uses, so the first assembly
+     * already carries the scanned text and no later request sees a different
+     * prefix. Timeout or failure keeps the placeholder; the scan lands on a
+     * later assembly through `system-prompt/change`. */
+    start(): void;
+    /**
+     * The layers an agent's section renders: its workspace directory plus the
+     * global directory, and the workspace's team directory when enabled.
+     */
+    private layersFor;
+    /** Compose the section text for the agent behind an assemble scope. */
+    private render;
+    /**
+     * Re-scan the global directory plus the agent's workspace (and team)
+     * directories. Overlapping scans of one directory share a single background
+     * promise. Emits `system-prompt/change` only when a rendered fragment
+     * actually changed, so an unchanged disk does not churn reassembly.
+     * @param agent - whose workspace layers to refresh; omitted = global only.
+     */
+    refresh(agent?: Agent): Promise<void>;
+    private refreshDir;
+    private scanDir;
+}
+/**
+ * The save-channel guidance every memory section carries. It names the ONLY
+ * working save path: direct write/edit calls aimed at a memory directory are
+ * fenced by the fs sandbox (memory directories live outside every session
+ * workspace), so the model must call `memory_save` instead. Without this line
+ * a memoryless session presents no guidance at all and the model falls back
+ * to its Claude Code prior (`~/.claude/projects/<slug>/memory/`), whose
+ * writes fail the same fence.
+ * @param workspaceDir - the workspace memory directory, when known.
+ * @param globalDir - the global memory directory.
+ * @returns the guidance lines.
+ */
+export declare function saveGuidance(workspaceDir: string | undefined, globalDir: string): string[];
+/**
+ * Render the memory section from the observed layers (workspace + global).
+ * The section is ALWAYS present (even with no memories) so the save guidance
+ * is stable model-visible context; an unscanned or empty layer renders a
+ * placeholder entrypoint body.
+ * @param globalDir - the global memory directory.
+ * @param workspaceDir - this workspace's private memory directory.
+ * @param globalState - the scanned global state, if available.
+ * @param workspaceState - the scanned workspace state, if available.
+ * @returns the rendered section.
+ */
+export declare function renderMemorySection(globalDir: string, workspaceDir: string, globalState?: MemoryDirectoryState, workspaceState?: MemoryDirectoryState): string;
+/**
+ * Render the combined section with the workspace's team layer added.
+ * @param globalDir - the global memory directory.
+ * @param workspaceDir - this workspace's private memory directory.
+ * @param teamDir - this workspace's shared team directory.
+ * @param globalState - the scanned global state, if available.
+ * @param workspaceState - the scanned workspace state, if available.
+ * @param teamState - the scanned team state, if available.
+ * @returns the rendered section.
+ */
+export declare function renderTeamMemorySection(globalDir: string, workspaceDir: string, teamDir: string, globalState?: MemoryDirectoryState, workspaceState?: MemoryDirectoryState, teamState?: MemoryDirectoryState): string;
+/** Compose the full section text from the observed layers. */
+export declare function renderLayers(layers: readonly MemoryLayer[]): string;
+//# sourceMappingURL=section.d.ts.map

package/lib/section.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"section.d.ts","sourceRoot":"","sources":["../src/section.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AAInD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAIrD,wEAAwE;AACxE,eAAO,MAAM,oBAAoB,KAAK,CAAA;AAEtC,iCAAiC;AACjC,eAAO,MAAM,mBAAmB,WAAW,CAAA;AAwB3C,8CAA8C;AAC9C,MAAM,WAAW,WAAW;IAC1B,6CAA6C;IAC7C,KAAK,EAAE,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAA;IACtC,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAA;IACb,6BAA6B;IAC7B,GAAG,EAAE,MAAM,CAAA;IACX,8EAA8E;IAC9E,KAAK,EAAE,oBAAoB,GAAG,SAAS,CAAA;CACxC;AAcD;;;;GAIG;AACH,qBAAa,aAAa;IAgBtB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAhBvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;IACjE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4B;IACtD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmC;IAC9D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IAErC;;;;;;;;OAQG;gBAEgB,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,MAAM,EAC7B,OAAO,GAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAO;IAKzC;;;;;;;;;;;;;wDAaoD;IACpD,KAAK,IAAI,IAAI;IA8Bb;;;OAGG;IACH,OAAO,CAAC,SAAS;IA6BjB,uEAAuE;IACvE,OAAO,CAAC,MAAM;IAgBd;;;;;;OAMG;IACG,OAAO,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3C,OAAO,CAAC,UAAU;YAcJ,OAAO;CAatB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAU1F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,oBAAoB,EAClC,cAAc,CAAC,EAAE,oBAAoB,GACpC,MAAM,CAKR;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,oBAAoB,EAClC,cAAc,CAAC,EAAE,oBAAoB,EACrC,SAAS,CAAC,EAAE,oBAAoB,GAC/B,MAAM,CAMR;AAWD,8DAA8D;AAC9D,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,GAAG,MAAM,CA+BnE"}

package/lib/section.js

@@ -0,0 +1,353 @@
+/**
+ * The `memory` system-prompt section: save-channel guidance plus one layer
+ * per memory scope — the workspace-private directory, the global directory,
+ * and (when `teamEnabled`) the workspace's team directory. Plugins mount once
+ * on the root context, so a single global section serves every agent: the
+ * text callback receives the assembling agent through `AssembleContext.scope`
+ * (the agent loop passes `scope: agent`) and renders that agent's workspace
+ * layer. Delegated children (`delegationDepth > 0`) render an empty string so
+ * the section drops out of the child prompt. Directory scans run in the
+ * background through `ctx.fs`; rendered per-layer fragments are cached and
+ * `system-prompt/change` fires only when a fragment actually changed. The
+ * section always renders for a top-level agent (a memoryless layer shows a
+ * placeholder) so the save guidance never disappears.
+ * @module @dsh-cc/memory/section
+ */
+import { delegationDepthOf } from '@deepseek-ai/dsh-subagent';
+import { ENTRYPOINT_NAME, truncateEntrypointContent } from "./truncate.js";
+import { scanMemoryDirectory } from "./scan.js";
+import { cwdOf, resolveWorkspaceMemoryDir } from "./paths.js";
+import { resolveTeamMemoryRoot } from "./team.js";
+/** Default order slot for the memory section (before tool guidance). */
+export const MEMORY_SECTION_ORDER = 90;
+/** The section's unique name. */
+export const MEMORY_SECTION_NAME = 'memory';
+/**
+ * How long the assemble waterfall may wait for a workspace's in-flight first
+ * scan before giving up and shipping the placeholder. Bounded so a slow or
+ * wedged scan delays the first request by at most this much; the background
+ * `system-prompt/change` path remains the fallback.
+ */
+const READINESS_BUDGET_MS = 500;
+/**
+ * Join `promise`, but reject after `ms` milliseconds either way. The loser
+ * keeps running in the background (its eventual rejection is contained); the
+ * caller gets a rejection to degrade on.
+ */
+function withinBudget(promise, ms) {
+    let timer;
+    const budget = new Promise((_resolve, reject) => {
+        timer = setTimeout(() => reject(new Error(`readiness budget of ${ms}ms expired`)), ms);
+    });
+    budget.catch(() => { });
+    return Promise.race([promise, budget]).finally(() => clearTimeout(timer));
+}
+/**
+ * Extract the assembling agent from an `AssembleContext`. The agent loop
+ * assembles with `scope: agent` (a runtime contract; `ScopeKey` is opaque),
+ * so the scope IS the agent whenever a session drives the assembly.
+ */
+function agentFromScope(scope) {
+    if (typeof scope === 'object' && scope !== null && 'session' in scope) {
+        return scope;
+    }
+    return undefined;
+}
+/**
+ * Owner of the cached `memory` section text. Holds one scanned state per
+ * memory directory so the synchronous section provider can compose the text,
+ * and refreshes states from disk.
+ */
+export class MemorySection {
+    ctx;
+    home;
+    states = new Map();
+    fragments = new Map();
+    refreshers = new Map();
+    teamEnabled;
+    /**
+     * Create a cache holder bounded to a memory home.
+     * @param ctx - the host context whose `fs` seam and `system-prompt/change`
+     *   channel drive refresh.
+     * @param home - the memory home: the global layer's directory, and the root
+     *   under which each workspace's private directory lives (`projects/<slug>`).
+     * @param options - when `teamEnabled` is set, each workspace also surfaces
+     *   its shared team directory (`<workspaceDir>/team`).
+     */
+    constructor(ctx, home, options = {}) {
+        this.ctx = ctx;
+        this.home = home;
+        this.teamEnabled = options.teamEnabled ?? false;
+    }
+    /** Register the `memory` section, its assemble-waterfall reconciliation,
+     * and start the global layer's first scan.
+     *
+     * The waterfall listener removes the first-assembly placeholder jitter:
+     * `systemPrompt.assemble()` runs BEFORE the agent pre-step, so the section
+     * text callback cannot await the directory scans — but the waterfall can.
+     * After the base assembly, a scope with unscanned layers joins the
+     * in-flight `refresh(agent)` (bounded by {@linkcode READINESS_BUDGET_MS};
+     * per-directory refreshers self-deduplicate, so this is the same promise
+     * the background scan already started) and re-renders the section with the
+     * same render function the section callback uses, so the first assembly
+     * already carries the scanned text and no later request sees a different
+     * prefix. Timeout or failure keeps the placeholder; the scan lands on a
+     * later assembly through `system-prompt/change`. */
+    start() {
+        this.ctx.systemPrompt.section({
+            name: MEMORY_SECTION_NAME,
+            order: MEMORY_SECTION_ORDER,
+            text: (context) => this.render(context.scope),
+        });
+        this.ctx.on('system-prompt/assemble', async (_assembly, context, next) => {
+            const result = await next();
+            const agent = agentFromScope(context.scope);
+            if (agent === undefined)
+                return result;
+            if (!isTopLevel(agent))
+                return result;
+            if (!this.layersFor(agent).some(layer => layer.state === undefined))
+                return result;
+            try {
+                await withinBudget(this.refresh(agent), READINESS_BUDGET_MS);
+            }
+            catch (error) {
+                this.ctx.logger.warn(`memory: first-assembly scan did not land within ${READINESS_BUDGET_MS}ms: ${String(error)}; keeping the placeholder`);
+                return result;
+            }
+            return {
+                ...result,
+                sections: result.sections.map(section => section.name === MEMORY_SECTION_NAME
+                    ? { ...section, text: this.render(agent) }
+                    : section),
+            };
+        });
+        void this.refresh();
+    }
+    /**
+     * The layers an agent's section renders: its workspace directory plus the
+     * global directory, and the workspace's team directory when enabled.
+     */
+    layersFor(agent) {
+        const layers = [];
+        if (agent !== undefined) {
+            const workspaceDir = resolveWorkspaceMemoryDir(this.home, cwdOf(agent));
+            layers.push({
+                scope: 'workspace',
+                label: 'this workspace',
+                dir: workspaceDir,
+                state: this.states.get(workspaceDir),
+            });
+            if (this.teamEnabled) {
+                const teamDir = resolveTeamMemoryRoot(workspaceDir);
+                layers.push({
+                    scope: 'team',
+                    label: 'team',
+                    dir: teamDir,
+                    state: this.states.get(teamDir),
+                });
+            }
+        }
+        layers.push({
+            scope: 'global',
+            label: 'global',
+            dir: this.home,
+            state: this.states.get(this.home),
+        });
+        return layers;
+    }
+    /** Compose the section text for the agent behind an assemble scope. */
+    render(scope) {
+        const agent = agentFromScope(scope);
+        // Delegated children start fresh (CC Task isolation). The parent prompt
+        // must pass any facts the child needs; dumping MEMORY.md into every
+        // subagent is the token cost this mute removes. Fail closed: a throw
+        // from reading depth treats the agent as a child.
+        if (agent !== undefined && !isTopLevel(agent))
+            return '';
+        if (agent !== undefined) {
+            // First assembly for this workspace: render placeholders now and scan
+            // its directories in the background so the next step sees real content.
+            const unknown = this.layersFor(agent).some(layer => layer.state === undefined);
+            if (unknown)
+                void this.refresh(agent);
+        }
+        return renderLayers(this.layersFor(agent));
+    }
+    /**
+     * Re-scan the global directory plus the agent's workspace (and team)
+     * directories. Overlapping scans of one directory share a single background
+     * promise. Emits `system-prompt/change` only when a rendered fragment
+     * actually changed, so an unchanged disk does not churn reassembly.
+     * @param agent - whose workspace layers to refresh; omitted = global only.
+     */
+    async refresh(agent) {
+        const dirs = this.layersFor(agent).map(layer => layer.dir);
+        const scans = dirs.map(dir => this.refreshDir(dir));
+        await Promise.all(scans);
+    }
+    refreshDir(dir) {
+        const previous = this.refreshers.get(dir);
+        if (previous !== undefined) {
+            previous.catch(() => { });
+            return previous;
+        }
+        const current = this.scanDir(dir);
+        this.refreshers.set(dir, current);
+        void current.finally(() => {
+            if (this.refreshers.get(dir) === current)
+                this.refreshers.delete(dir);
+        });
+        return current;
+    }
+    async scanDir(dir) {
+        const fileSystem = this.ctx.get('fs');
+        if (fileSystem === undefined)
+            return;
+        const state = await scanMemoryDirectory(fileSystem, dir);
+        const fragment = renderLayerFragment({ scope: 'global', label: '', dir, state });
+        if (fragment === this.fragments.get(dir)) {
+            this.states.set(dir, state);
+            return;
+        }
+        this.states.set(dir, state);
+        this.fragments.set(dir, fragment);
+        this.ctx.emit('system-prompt/change');
+    }
+}
+/**
+ * The save-channel guidance every memory section carries. It names the ONLY
+ * working save path: direct write/edit calls aimed at a memory directory are
+ * fenced by the fs sandbox (memory directories live outside every session
+ * workspace), so the model must call `memory_save` instead. Without this line
+ * a memoryless session presents no guidance at all and the model falls back
+ * to its Claude Code prior (`~/.claude/projects/<slug>/memory/`), whose
+ * writes fail the same fence.
+ * @param workspaceDir - the workspace memory directory, when known.
+ * @param globalDir - the global memory directory.
+ * @returns the guidance lines.
+ */
+export function saveGuidance(workspaceDir, globalDir) {
+    const target = workspaceDir !== undefined
+        ? `this workspace's directory (\`${workspaceDir}\`)`
+        : 'the current workspace\'s directory';
+    return [
+        `To save a durable fact, call the \`memory_save\` tool — it writes the topic file and updates ${ENTRYPOINT_NAME} for you. `
+            + `By default the memory lands in ${target}, visible only to sessions of this workspace; `
+            + `pass \`scope: "global"\` for facts useful across ALL workspaces (saved to \`${globalDir}\`).`,
+        'Never write or edit files under a memory directory directly: the sandbox fences writes outside the session workspace, so direct writes always fail.',
+    ];
+}
+/**
+ * Render the memory section from the observed layers (workspace + global).
+ * The section is ALWAYS present (even with no memories) so the save guidance
+ * is stable model-visible context; an unscanned or empty layer renders a
+ * placeholder entrypoint body.
+ * @param globalDir - the global memory directory.
+ * @param workspaceDir - this workspace's private memory directory.
+ * @param globalState - the scanned global state, if available.
+ * @param workspaceState - the scanned workspace state, if available.
+ * @returns the rendered section.
+ */
+export function renderMemorySection(globalDir, workspaceDir, globalState, workspaceState) {
+    return renderLayers([
+        { scope: 'workspace', label: 'this workspace', dir: workspaceDir, state: workspaceState },
+        { scope: 'global', label: 'global', dir: globalDir, state: globalState },
+    ]);
+}
+/**
+ * Render the combined section with the workspace's team layer added.
+ * @param globalDir - the global memory directory.
+ * @param workspaceDir - this workspace's private memory directory.
+ * @param teamDir - this workspace's shared team directory.
+ * @param globalState - the scanned global state, if available.
+ * @param workspaceState - the scanned workspace state, if available.
+ * @param teamState - the scanned team state, if available.
+ * @returns the rendered section.
+ */
+export function renderTeamMemorySection(globalDir, workspaceDir, teamDir, globalState, workspaceState, teamState) {
+    return renderLayers([
+        { scope: 'workspace', label: 'this workspace', dir: workspaceDir, state: workspaceState },
+        { scope: 'team', label: 'team', dir: teamDir, state: teamState },
+        { scope: 'global', label: 'global', dir: globalDir, state: globalState },
+    ]);
+}
+/** Render one layer's entrypoint block (heading + truncated body). */
+function renderLayerFragment(layer) {
+    const entry = layer.state?.entrypoint?.trim();
+    const body = entry !== undefined && entry.length > 0
+        ? truncateEntrypointContent(entry).content
+        : '(no memories yet)';
+    return `## ${ENTRYPOINT_NAME} (${layer.label})\n\n${body}`;
+}
+/** Compose the full section text from the observed layers. */
+export function renderLayers(layers) {
+    const workspace = layers.find(layer => layer.scope === 'workspace');
+    const global = layers.find(layer => layer.scope === 'global');
+    const team = layers.find(layer => layer.scope === 'team');
+    const globalDir = global?.dir ?? '';
+    const lines = [
+        '# Memory',
+        '',
+        'You have a persistent, file-based memory system. Use it to recall context across conversations and to save durable facts.',
+        '',
+        'There are two scope levels:',
+        `- workspace: memories private to the current workspace${workspace !== undefined ? `, stored at \`${workspace.dir}\`` : ''}.`,
+        `- global: memories shared by every workspace${global !== undefined ? `, stored at \`${global.dir}\`` : ''}.`,
+    ];
+    if (team !== undefined) {
+        lines.push(`- team: memories shared with and contributed by all users of this project, stored at \`${team.dir}\`.`);
+    }
+    lines.push('', 'Each directory keeps its own index and topic files. Save each memory to the directory matching its scope; never write memory content directly into a MEMORY.md.', '', ...saveGuidance(workspace?.dir, globalDir), '');
+    const ordered = [workspace, team, global].filter((layer) => layer !== undefined);
+    lines.push(ordered.map(layer => renderLayerFragment(layer)).join('\n\n'));
+    const index = renderCombinedIndex(ordered);
+    if (index.length > 0)
+        lines.push('', ...index);
+    const search = renderSearch(ordered);
+    if (search.length > 0)
+        lines.push('', ...search);
+    return lines.join('\n');
+}
+/** A combined topic index with each layer's scope tagged, sorted by filename. */
+function renderCombinedIndex(layers) {
+    const combined = layers.flatMap(layer => (layer.state?.topics ?? []).map(topic => ({ ...topic, scope: layer.scope })));
+    if (combined.length === 0)
+        return [];
+    combined.sort((a, b) => a.filename.localeCompare(b.filename));
+    const lines = combined.map((topic) => {
+        const type = topic.frontmatter.type === undefined ? '' : ` [${topic.frontmatter.type}]`;
+        return `- [${escapeLinkText(topic.frontmatter.name)}](${topic.filename}) — ${topic.frontmatter.description} (${topic.scope})${type}`;
+    });
+    return ['## Memory index', '', ...lines];
+}
+function renderSearch(layers) {
+    const populated = layers.filter(layer => (layer.state?.topics.length ?? 0) > 0);
+    if (populated.length === 0)
+        return [];
+    const dirs = populated.map(layer => `${layer.dir}/`).join(' ');
+    return [
+        '## Searching past context',
+        'When a MEMORY.md entry is not enough, search topic files and the transcript log with narrow terms (error messages, file paths, function names):',
+        '```',
+        `grep -rn "<search term>" ${dirs} --include="*.md"`,
+        '```',
+    ];
+}
+function escapeLinkText(name) {
+    return name.replace(/[\\[\]]/g, '\\$&');
+}
+/**
+ * Whether an assembling agent is top-level (not a delegated subagent).
+ * Fail closed: any throw from reading depth treats the agent as a child so
+ * the section never dumps MEMORY.md into a mis-stamped child.
+ */
+function isTopLevel(agent) {
+    try {
+        return delegationDepthOf(agent) === 0;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=section.js.map

package/lib/section.js.map

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