@alanzhao/dsh-memory-lite 0.1.1

package/lib/config.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Configuration contracts for dsh-memory-lite. The schemastery `Config`
+ * validates the shape a user writes in cordis.yml (every field optional);
+ * `resolveConfig` performs explicit defaulting — the only place defaults
+ * are applied.
+ * @module dsh-memory-lite/src/config
+ */
+import z from '@deepseek-ai/schemastery';
+/** Default memory root; `~` expands against the user's home. */
+export declare const DEFAULT_MEMORY_ROOT = "~/.agent-memory";
+/** Default peer used for sessions without a usable cwd. */
+export declare const DEFAULT_PEER = "dsh-web";
+/** Default cap on catalog size, in approximate tokens. */
+export declare const DEFAULT_INDEX_MAX_TOKENS = 1200;
+/** Default session-header indicator slot order (ascending; -1 sits left of the built-in "Session log" capsule). */
+export declare const DEFAULT_HEADER_ORDER = -1;
+/** Per-session peer derivation from `SessionHeader.cwd`. */
+export interface WorkspacePeersConfig {
+    /** Derive the peer from each session's cwd. Defaults to true. */
+    enabled: boolean;
+    /** Reserved for Phase 2 extraction; peer derivation ignores it. Defaults to true. */
+    excludeSubagents: boolean;
+    /** Peer name used when a session has no cwd; the literal `default_peer` selects the default. Defaults to `default_peer`. */
+    cwdFallback: string;
+}
+/** L0 catalog sizing. */
+export interface IndexConfig {
+    /** Approximate token cap for the catalog; entries past the cap are truncated. Defaults to 1200. */
+    maxTokens: number;
+    /** Index sort order; `mtime` newest-first is the only supported value. Defaults to `mtime`. */
+    sortBy: 'mtime';
+}
+/** Tool-side switches. */
+export interface ToolsConfig {
+    /** Reserved; the tool schemas are minimal by construction. Defaults to true. */
+    schemaMinimal: boolean;
+}
+/** Browser-side indicator options. */
+export interface UiConfig {
+    /** Render order of the memory status indicator in the session-header utilities slot (ascending; smaller = further left, -1 sits left of the built-in "Session log" capsule). Defaults to -1. */
+    headerOrder: number;
+}
+/** One explicit cross-peer share: expose a target peer's memories at shared/<name>/... */
+export interface SharingMountConfig {
+    /** Path prefix exposed to this peer's sessions: shared/<name>/<file>.md. Must be a plain segment. */
+    name: string;
+    /** Target peer whose memories root is shared. */
+    peer: string;
+    /** Subpath inside the target peer's memories root; '' = the whole root. */
+    subpath: string;
+    /** Read-only mirror; write operations are rejected. Defaults to true. */
+    readonly: boolean;
+}
+/** Cross-peer sharing (Phase 3): explicit, not default. */
+export interface SharingConfig {
+    /** Master switch; when off, shared/ paths are rejected. Defaults to false. */
+    enabled: boolean;
+    /** Ordered mount declarations, visible to every peer except the target itself. */
+    mounts: SharingMountConfig[];
+}
+/** Extraction model selection: an explicit route wins; empty = the global default model (agent-default-model). */
+export interface ExtractionLlmConfig {
+    /** Combined "provider/model" route, e.g. 'deepseek-official/deepseek-v4-flash'. Empty = global default. */
+    route?: string;
+    /** Adapter-owned reasoning effort id (e.g. 'low'); empty = follow the global default selection. */
+    reasoningEffort?: string;
+    /** Legacy provider key (kept for compatibility with pre-§17 configs); superseded by route. */
+    provider?: string;
+    /** Legacy model id (kept for compatibility with pre-§17 configs); superseded by route. */
+    model?: string;
+}
+/** Background implicit extraction (Phase 2, channel B). */
+export interface ExtractionConfig {
+    /** incremental | explicit_only | off. Defaults to incremental. */
+    mode: 'incremental' | 'explicit_only' | 'off';
+    /** New surface messages >= this count triggers an extraction. Defaults to 20. */
+    windowTurns: number;
+    /** Idle minutes before the remaining window is extracted. Defaults to 30. */
+    idleTimeoutMin: number;
+    /** Max messages fed to the extraction LLM per run. Defaults to 20. */
+    maxMessages: number;
+    /** Which event kinds count and feed the window (fixed to the three surface types). */
+    messageScope: ('user' | 'assistant' | 'tool_result')[];
+    /** Per tool/result content truncation before feeding the LLM. Defaults to 2048. */
+    toolResultMaxBytes: number;
+    /** Carry the rolling session digest. Defaults to true. */
+    includeDigest: boolean;
+    /** Grep existing memories for dedup/contradiction. Defaults to true. */
+    dedup: boolean;
+    /** Extraction model selection; empty route = the global default model (agent-default-model). */
+    llm: ExtractionLlmConfig;
+    /** agent/turn-stopping backstop trigger. Defaults to true. */
+    turnStoppingTrigger: boolean;
+    /** session/flush last-resort trigger. Defaults to true. */
+    flushTrigger: boolean;
+    /** Minimum unextracted messages for a turn-boundary run. Defaults to 5. */
+    minTurnExtract: number;
+    /** Debounce window for turn-boundary extraction, ms. Defaults to 30000. */
+    turnDebounceMs: number;
+    /** Write audit entries to peers/{peer}/sessions/{id}.json. Defaults to true. */
+    auditLog: boolean;
+    /** Global cap on concurrent extraction LLM requests. Defaults to 1. */
+    maxConcurrentRequests: number;
+    /** On a failed JSON parse, one cheap repair call re-asks the model for valid JSON. Defaults to true. */
+    parseRetry: boolean;
+}
+/** Raw plugin configuration as written in cordis.yml; every field optional. */
+export interface MemoryConfig {
+    root?: string;
+    defaultPeer?: string;
+    workspacePeers?: Partial<WorkspacePeersConfig>;
+    index?: Partial<IndexConfig>;
+    tools?: Partial<ToolsConfig>;
+    extraction?: Partial<ExtractionConfig>;
+    sharing?: Partial<SharingConfig>;
+    ui?: Partial<UiConfig>;
+}
+/** Fully defaulted configuration after {@link resolveConfig}. */
+export interface ResolvedConfig {
+    /** Absolute, `~`-expanded memory root. */
+    root: string;
+    defaultPeer: string;
+    workspacePeers: WorkspacePeersConfig;
+    index: IndexConfig;
+    tools: ToolsConfig;
+    extraction: ExtractionConfig;
+    sharing: SharingConfig;
+    ui: UiConfig;
+}
+/** Validate the plugin configuration shape. Unknown keys are tolerated for forward compatibility. */
+export declare const Config: z<MemoryConfig>;
+/** Normalize and default a raw configuration; throws on invalid values. */
+export declare function resolveConfig(config?: MemoryConfig): ResolvedConfig;

package/lib/config.js

@@ -0,0 +1,173 @@
+/**
+ * Configuration contracts for dsh-memory-lite. The schemastery `Config`
+ * validates the shape a user writes in cordis.yml (every field optional);
+ * `resolveConfig` performs explicit defaulting — the only place defaults
+ * are applied.
+ * @module dsh-memory-lite/src/config
+ */
+import { resolve } from 'node:path';
+import z from '@deepseek-ai/schemastery';
+import { expandHomePath } from '@deepseek-ai/dsh-home-paths';
+/** Default memory root; `~` expands against the user's home. */
+export const DEFAULT_MEMORY_ROOT = '~/.agent-memory';
+/** Default peer used for sessions without a usable cwd. */
+export const DEFAULT_PEER = 'dsh-web';
+/** Default cap on catalog size, in approximate tokens. */
+export const DEFAULT_INDEX_MAX_TOKENS = 1200;
+/** Default session-header indicator slot order (ascending; -1 sits left of the built-in "Session log" capsule). */
+export const DEFAULT_HEADER_ORDER = -1;
+/** Validate the plugin configuration shape. Unknown keys are tolerated for forward compatibility. */
+export const Config = z.object({
+    root: z.string(),
+    defaultPeer: z.string(),
+    workspacePeers: z.object({
+        enabled: z.boolean(),
+        excludeSubagents: z.boolean(),
+        cwdFallback: z.string(),
+    }),
+    index: z.object({
+        maxTokens: z.number(),
+        sortBy: z.union([z.const('mtime')]),
+    }),
+    tools: z.object({
+        schemaMinimal: z.boolean(),
+    }),
+    extraction: z.object({
+        mode: z.union([z.const('incremental'), z.const('explicit_only'), z.const('off')]),
+        windowTurns: z.number(),
+        idleTimeoutMin: z.number(),
+        maxMessages: z.number(),
+        messageScope: z.array(z.union([z.const('user'), z.const('assistant'), z.const('tool_result')])),
+        toolResultMaxBytes: z.number(),
+        includeDigest: z.boolean(),
+        dedup: z.boolean(),
+        llm: z.object({
+            route: z.string(),
+            reasoningEffort: z.string(),
+            provider: z.string(),
+            model: z.string(),
+        }),
+        turnStoppingTrigger: z.boolean(),
+        flushTrigger: z.boolean(),
+        minTurnExtract: z.number(),
+        turnDebounceMs: z.number(),
+        auditLog: z.boolean(),
+        maxConcurrentRequests: z.number(),
+        parseRetry: z.boolean(),
+    }),
+    sharing: z.object({
+        enabled: z.boolean(),
+        mounts: z.array(z.object({
+            name: z.string(),
+            peer: z.string(),
+            subpath: z.string(),
+            readonly: z.boolean(),
+        })),
+    }),
+    ui: z.object({
+        headerOrder: z.number(),
+    }),
+});
+/** Normalize and default a raw configuration; throws on invalid values. */
+export function resolveConfig(config = {}) {
+    const root = resolve(expandHomePath(config.root ?? DEFAULT_MEMORY_ROOT));
+    const defaultPeer = config.defaultPeer ?? DEFAULT_PEER;
+    if (defaultPeer === '' || defaultPeer.includes('/') || defaultPeer.includes('\\') || defaultPeer === '.' || defaultPeer === '..') {
+        throw new Error(`dsh-memory-lite: defaultPeer must be a plain directory name, got ${JSON.stringify(defaultPeer)}`);
+    }
+    const workspacePeers = {
+        enabled: config.workspacePeers?.enabled ?? true,
+        excludeSubagents: config.workspacePeers?.excludeSubagents ?? true,
+        cwdFallback: config.workspacePeers?.cwdFallback ?? 'default_peer',
+    };
+    const index = {
+        maxTokens: config.index?.maxTokens ?? DEFAULT_INDEX_MAX_TOKENS,
+        sortBy: 'mtime',
+    };
+    if (!Number.isInteger(index.maxTokens) || index.maxTokens < 50) {
+        throw new Error(`dsh-memory-lite: index.maxTokens must be an integer >= 50, got ${index.maxTokens}`);
+    }
+    const extraction = {
+        mode: config.extraction?.mode ?? 'incremental',
+        windowTurns: config.extraction?.windowTurns ?? 20,
+        idleTimeoutMin: config.extraction?.idleTimeoutMin ?? 30,
+        maxMessages: config.extraction?.maxMessages ?? 20,
+        messageScope: config.extraction?.messageScope ?? ['user', 'assistant', 'tool_result'],
+        toolResultMaxBytes: config.extraction?.toolResultMaxBytes ?? 2048,
+        includeDigest: config.extraction?.includeDigest ?? true,
+        dedup: config.extraction?.dedup ?? true,
+        llm: {
+            route: config.extraction?.llm?.route ?? '',
+            reasoningEffort: config.extraction?.llm?.reasoningEffort ?? '',
+            provider: config.extraction?.llm?.provider,
+            model: config.extraction?.llm?.model,
+        },
+        turnStoppingTrigger: config.extraction?.turnStoppingTrigger ?? true,
+        flushTrigger: config.extraction?.flushTrigger ?? true,
+        minTurnExtract: config.extraction?.minTurnExtract ?? 5,
+        turnDebounceMs: config.extraction?.turnDebounceMs ?? 30000,
+        auditLog: config.extraction?.auditLog ?? true,
+        maxConcurrentRequests: config.extraction?.maxConcurrentRequests ?? 1,
+        parseRetry: config.extraction?.parseRetry ?? true,
+    };
+    for (const [key, value] of [
+        ['windowTurns', extraction.windowTurns],
+        ['maxMessages', extraction.maxMessages],
+        ['toolResultMaxBytes', extraction.toolResultMaxBytes],
+        ['minTurnExtract', extraction.minTurnExtract],
+        ['turnDebounceMs', extraction.turnDebounceMs],
+        ['maxConcurrentRequests', extraction.maxConcurrentRequests],
+        ['idleTimeoutMin', extraction.idleTimeoutMin],
+    ]) {
+        if (!Number.isInteger(value) || value < 0) {
+            throw new Error(`dsh-memory-lite: extraction.${key} must be a non-negative integer, got ${value}`);
+        }
+    }
+    const llmRoute = extraction.llm.route;
+    if (llmRoute !== '') {
+        // "provider/model-id": the model id itself may contain a slash (pi-ai
+        // routes like commandcode/deepseek/deepseek-v4-flash), so only the first
+        // segment is the provider and the rest is the model id.
+        const slash = llmRoute.indexOf('/');
+        if (slash <= 0 || slash === llmRoute.length - 1 || llmRoute.includes('\\')) {
+            throw new Error(`dsh-memory-lite: extraction.llm.route must be "provider/model", got ${JSON.stringify(llmRoute)}`);
+        }
+    }
+    const sharing = {
+        enabled: config.sharing?.enabled ?? false,
+        mounts: (config.sharing?.mounts ?? []).map(mount => ({
+            name: mount.name,
+            peer: mount.peer,
+            subpath: mount.subpath ?? '',
+            readonly: mount.readonly ?? true,
+        })),
+    };
+    for (const mount of sharing.mounts) {
+        if (mount.name === '' || /[\\/]/.test(mount.name) || mount.name === '.' || mount.name === '..') {
+            throw new Error('dsh-memory-lite: sharing mount name must be a plain segment, got ' + JSON.stringify(mount.name));
+        }
+        if (mount.peer === '' || mount.peer.includes('/') || mount.peer.includes('\\') || mount.peer === '.' || mount.peer === '..') {
+            throw new Error('dsh-memory-lite: sharing mount peer must be a plain directory name, got ' + JSON.stringify(mount.peer));
+        }
+        if (mount.subpath.startsWith('/') || mount.subpath.split('/').includes('..')) {
+            throw new Error('dsh-memory-lite: sharing mount subpath must not escape the memories root, got ' + JSON.stringify(mount.subpath));
+        }
+    }
+    const ui = {
+        headerOrder: config.ui?.headerOrder ?? DEFAULT_HEADER_ORDER,
+    };
+    if (!Number.isInteger(ui.headerOrder)) {
+        throw new Error(`dsh-memory-lite: ui.headerOrder must be an integer, got ${ui.headerOrder}`);
+    }
+    return {
+        root,
+        defaultPeer,
+        workspacePeers,
+        index,
+        tools: { schemaMinimal: config.tools?.schemaMinimal ?? true },
+        extraction,
+        sharing,
+        ui,
+    };
+}
+//# sourceMappingURL=config.js.map

package/lib/config.js.map

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

package/lib/extract/checkpoint.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Checkpoint + audit document for one peer/session, persisted at
+ * peers/{peer}/sessions/{session-id}.json. The checkpoint records the last
+ * extracted log seq (resume gap-filling); the audit records each run's inputs
+ * and outcome so extraction is reproducible from the session log.
+ * @module dsh-memory-lite/src/extract/checkpoint
+ */
+export interface AuditEntry {
+    /** ISO timestamp of the run. */
+    readonly at: string;
+    /** Included window seq range [start, end]. */
+    readonly windowSeq: readonly [number, number];
+    /** Grep hits fed as existing memory context. */
+    readonly grepHits: readonly string[];
+    /** Provider/model route used, when resolvable. */
+    readonly route?: {
+        readonly provider: string;
+        readonly model: string;
+    };
+    /** maxTokens sent on the extraction request. */
+    readonly maxTokens?: number;
+    /** The parsed decision kind, or the failure note. */
+    readonly decision: string;
+    /** Target memory path when the decision addressed one. */
+    readonly path?: string;
+    /** The log seq the checkpoint advanced to after this run. */
+    readonly seq: number;
+    /** Failure/retry context (successful runs omit it). */
+    readonly note?: string;
+    /** Number of LLM stream calls made for this run (1, or 2 when a repair ran). */
+    readonly llmCalls?: number;
+    /** Total input tokens (real stream usage when available, else bytes/3 estimate). */
+    readonly inputTokens?: number;
+    /** Total output tokens (real stream usage when available, else bytes/3 estimate). */
+    readonly outputTokens?: number;
+    /** Cache-read tokens reported by the provider. */
+    readonly cacheReadTokens?: number;
+    /** Cache-write tokens reported by the provider. */
+    readonly cacheWriteTokens?: number;
+    /** Run wall-clock duration in ms. */
+    readonly durationMs?: number;
+}
+export interface CheckpointFile {
+    readonly version: 1;
+    readonly checkpoint: {
+        readonly seq: number;
+    };
+    readonly digest: string;
+    readonly audit: readonly AuditEntry[];
+}
+export declare const CHECKPOINT_VERSION = 1;
+/** Cap on retained audit entries per session, bounding file size. */
+export declare const MAX_AUDIT_ENTRIES = 50;
+export declare function emptyCheckpoint(): CheckpointFile;
+/** Append an audit entry and advance the checkpoint; returns a new document. */
+export declare function withRun(state: CheckpointFile, seq: number, entry: Omit<AuditEntry, 'seq'>): CheckpointFile;
+/** Serialize the document for atomic write. */
+export declare function renderCheckpoint(state: CheckpointFile): string;
+/** Parse a persisted document; tolerant of malformed input (degrades to empty). */
+export declare function parseCheckpoint(text: string): CheckpointFile;

package/lib/extract/checkpoint.js

@@ -0,0 +1,42 @@
+/**
+ * Checkpoint + audit document for one peer/session, persisted at
+ * peers/{peer}/sessions/{session-id}.json. The checkpoint records the last
+ * extracted log seq (resume gap-filling); the audit records each run's inputs
+ * and outcome so extraction is reproducible from the session log.
+ * @module dsh-memory-lite/src/extract/checkpoint
+ */
+export const CHECKPOINT_VERSION = 1;
+/** Cap on retained audit entries per session, bounding file size. */
+export const MAX_AUDIT_ENTRIES = 50;
+export function emptyCheckpoint() {
+    return { version: CHECKPOINT_VERSION, checkpoint: { seq: 0 }, digest: '', audit: [] };
+}
+/** Append an audit entry and advance the checkpoint; returns a new document. */
+export function withRun(state, seq, entry) {
+    const audit = [...state.audit, { ...entry, seq }];
+    if (audit.length > MAX_AUDIT_ENTRIES)
+        audit.splice(0, audit.length - MAX_AUDIT_ENTRIES);
+    return { version: CHECKPOINT_VERSION, checkpoint: { seq }, digest: state.digest, audit };
+}
+/** Serialize the document for atomic write. */
+export function renderCheckpoint(state) {
+    return JSON.stringify(state, null, 2) + '\n';
+}
+/** Parse a persisted document; tolerant of malformed input (degrades to empty). */
+export function parseCheckpoint(text) {
+    try {
+        const value = JSON.parse(text);
+        if (typeof value !== 'object' || value === null)
+            return emptyCheckpoint();
+        const record = value;
+        const checkpoint = record.checkpoint;
+        const seq = typeof checkpoint?.seq === 'number' && Number.isSafeInteger(checkpoint.seq) ? checkpoint.seq : 0;
+        const digest = typeof record.digest === 'string' ? record.digest : '';
+        const audit = Array.isArray(record.audit) ? record.audit : [];
+        return { version: CHECKPOINT_VERSION, checkpoint: { seq }, digest, audit: audit };
+    }
+    catch {
+        return emptyCheckpoint();
+    }
+}
+//# sourceMappingURL=checkpoint.js.map

package/lib/extract/checkpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.js","sourceRoot":"","sources":["../../src/extract/checkpoint.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA0CH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAA;AACnC,qEAAqE;AACrE,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAA;AAEnC,MAAM,UAAU,eAAe;IAC7B,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAA;AACvF,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,OAAO,CAAC,KAAqB,EAAE,GAAW,EAAE,KAA8B;IACxF,MAAM,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,EAAE,EAAE,GAAG,KAAK,EAAE,GAAG,EAAE,CAAC,CAAA;IACjD,IAAI,KAAK,CAAC,MAAM,GAAG,iBAAiB;QAAE,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,iBAAiB,CAAC,CAAA;IACvF,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,CAAA;AAC1F,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,gBAAgB,CAAC,KAAqB;IACpD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAA;AAC9C,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,IAAI,CAAC;QACH,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACvC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,eAAe,EAAE,CAAA;QACzE,MAAM,MAAM,GAAG,KAAgC,CAAA;QAC/C,MAAM,UAAU,GAAG,MAAM,CAAC,UAAiD,CAAA;QAC3E,MAAM,GAAG,GAAG,OAAO,UAAU,EAAE,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QAC5G,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAA;QACrE,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;QAC7D,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,KAAqB,EAAE,CAAA;IACnG,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,eAAe,EAAE,CAAA;IAC1B,CAAC;AACH,CAAC"}

package/lib/extract/decision.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Parse the extraction LLM's structured output into a concrete memory
+ * mutation decision. The model answers in JSON; the parser is tolerant of
+ * code fences and prose, normalizes full-width braces/quotes, salvages
+ * broken-brace JSON from key:value pairs, and rejects anything outside the
+ * closed vocabulary.
+ * @module dsh-memory-lite/src/extract/decision
+ */
+export type ExtractionDecisionKind = 'create' | 'merge' | 'update' | 'skip';
+export interface CreateDecision {
+    readonly kind: 'create';
+    readonly category: string;
+    readonly title: string;
+    readonly content: string;
+}
+export interface PathDecision {
+    readonly kind: 'merge' | 'update';
+    readonly path: string;
+    readonly content: string;
+}
+export interface SkipDecision {
+    readonly kind: 'skip';
+    readonly reason?: string;
+}
+export type ExtractionDecision = CreateDecision | PathDecision | SkipDecision;
+export declare const DECISION_KINDS: readonly ExtractionDecisionKind[];
+/** Extraction decisions never delete; `forget` stays a user-only tool. */
+export declare const DECISION_ALLOWED: Set<string>;
+/** Locate and parse the JSON object in the model's answer. */
+export declare function parseDecision(text: string): ExtractionDecision;
+/**
+ * The first balanced `{...}` region in the answer (fence-free). When the
+ * braces are broken (truncated or unbalanced output), falls back to rebuilding
+ * a JSON object from `"key": "value"` pairs; throws only when neither works.
+ */
+export declare function extractJsonObject(text: string): string;

package/lib/extract/decision.js

@@ -0,0 +1,118 @@
+/**
+ * Parse the extraction LLM's structured output into a concrete memory
+ * mutation decision. The model answers in JSON; the parser is tolerant of
+ * code fences and prose, normalizes full-width braces/quotes, salvages
+ * broken-brace JSON from key:value pairs, and rejects anything outside the
+ * closed vocabulary.
+ * @module dsh-memory-lite/src/extract/decision
+ */
+export const DECISION_KINDS = ['create', 'merge', 'update', 'skip'];
+/** Extraction decisions never delete; `forget` stays a user-only tool. */
+export const DECISION_ALLOWED = new Set(['create', 'merge', 'update', 'skip']);
+/** Locate and parse the JSON object in the model's answer. */
+export function parseDecision(text) {
+    const json = extractJsonObject(text);
+    const parsed = JSON.parse(json);
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+        throw new Error(`extraction decision is not an object: ${json.slice(0, 200)}`);
+    }
+    const record = parsed;
+    const kind = typeof record.decision === 'string' ? record.decision : '';
+    if (!DECISION_ALLOWED.has(kind)) {
+        throw new Error(`extraction decision must be one of ${DECISION_KINDS.join('/')}, got ${JSON.stringify(kind)}`);
+    }
+    switch (kind) {
+        case 'create': {
+            const category = str(record.category);
+            const title = str(record.title);
+            const content = str(record.content);
+            if (category === '' || title === '' || content === '') {
+                throw new Error('create decision requires category, title, and content');
+            }
+            return { kind, category, title, content };
+        }
+        case 'merge':
+        case 'update': {
+            const path = str(record.path);
+            const content = str(record.content);
+            if (path === '' || content === '') {
+                throw new Error(`${kind} decision requires path and content`);
+            }
+            return { kind, path, content };
+        }
+        default: {
+            const reason = str(record.reason);
+            return { kind: 'skip', ...(reason === '' ? {} : { reason }) };
+        }
+    }
+}
+/** Normalize full-width brace/quote characters the model may emit. */
+function normalizeFullWidth(text) {
+    return text
+        .replaceAll('｛', '{')
+        .replaceAll('｝', '}')
+        .replaceAll('\uFF02', '"');
+}
+/**
+ * The first balanced `{...}` region in the answer (fence-free). When the
+ * braces are broken (truncated or unbalanced output), falls back to rebuilding
+ * a JSON object from `"key": "value"` pairs; throws only when neither works.
+ */
+export function extractJsonObject(text) {
+    const normalized = normalizeFullWidth(text);
+    const balanced = scanBalanced(normalized);
+    if (balanced !== undefined)
+        return balanced;
+    const rebuilt = rebuildFromPairs(normalized);
+    if (rebuilt !== undefined)
+        return rebuilt;
+    throw new Error('extraction answer contains no JSON object');
+}
+/** The first balanced `{...}` region, or undefined when unbalanced. */
+function scanBalanced(text) {
+    const start = text.indexOf('{');
+    if (start === -1)
+        return undefined;
+    let depth = 0;
+    let inString = false;
+    let escaped = false;
+    for (let i = start; i < text.length; i += 1) {
+        const ch = text[i];
+        if (inString) {
+            if (escaped)
+                escaped = false;
+            else if (ch === '\\')
+                escaped = true;
+            else if (ch === '"')
+                inString = false;
+            continue;
+        }
+        if (ch === '"')
+            inString = true;
+        else if (ch === '{')
+            depth += 1;
+        else if (ch === '}') {
+            depth -= 1;
+            if (depth === 0)
+                return text.slice(start, i + 1);
+        }
+    }
+    return undefined;
+}
+/** Rebuild a JSON object from complete `"key": "value"` pairs (no braces). */
+function rebuildFromPairs(text) {
+    const pairRe = /"([A-Za-z_][A-Za-z0-9_]*)":\s*("(?:\\.|[^"\\])*"|true|false|null|-?\d+(?:\.\d+)?)/g;
+    const pairs = [];
+    let match;
+    while ((match = pairRe.exec(text)) !== null) {
+        pairs.push([match[1], match[2]]);
+        pairRe.lastIndex = match.index + match[0].length;
+    }
+    if (pairs.length === 0)
+        return undefined;
+    return '{' + pairs.map(([key, value]) => JSON.stringify(key) + ':' + value).join(',') + '}';
+}
+function str(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+//# sourceMappingURL=decision.js.map

package/lib/extract/decision.js.map

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

package/lib/extract/digest.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Rolling session digest: a bounded ~100-token summary carried between
+ * extraction runs so later windows can resolve cross-window references.
+ * Token length is approximated as bytes/3 (CJK 1 token, ASCII ~4 chars).
+ * @module dsh-memory-lite/src/extract/digest
+ */
+/** Rough token-length estimate for mixed CJK/ASCII text. */
+export declare function digestApproxTokens(text: string): number;
+/** Shrink the digest until it fits `maxTokens` (progressive halving). */
+export declare function truncateDigest(text: string, maxTokens: number): string;
+/** Roll the digest forward: previous digest + this window, re-truncated. */
+export declare function rollDigest(prev: string, windowText: string, maxTokens: number): string;

package/lib/extract/digest.js

@@ -0,0 +1,25 @@
+/**
+ * Rolling session digest: a bounded ~100-token summary carried between
+ * extraction runs so later windows can resolve cross-window references.
+ * Token length is approximated as bytes/3 (CJK 1 token, ASCII ~4 chars).
+ * @module dsh-memory-lite/src/extract/digest
+ */
+/** Rough token-length estimate for mixed CJK/ASCII text. */
+export function digestApproxTokens(text) {
+    const bytes = Buffer.byteLength(text, 'utf8');
+    return Math.ceil(bytes / 3);
+}
+/** Shrink the digest until it fits `maxTokens` (progressive halving). */
+export function truncateDigest(text, maxTokens) {
+    let current = text.trim();
+    while (current.length > 0 && digestApproxTokens(current) > maxTokens) {
+        current = current.slice(0, Math.floor(current.length * 0.8)).trim();
+    }
+    return current;
+}
+/** Roll the digest forward: previous digest + this window, re-truncated. */
+export function rollDigest(prev, windowText, maxTokens) {
+    const combined = prev === '' ? windowText : `${prev}\n${windowText}`;
+    return truncateDigest(combined, maxTokens);
+}
+//# sourceMappingURL=digest.js.map

package/lib/extract/digest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"digest.js","sourceRoot":"","sources":["../../src/extract/digest.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,4DAA4D;AAC5D,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;AAC7B,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,SAAiB;IAC5D,IAAI,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;IACzB,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,kBAAkB,CAAC,OAAO,CAAC,GAAG,SAAS,EAAE,CAAC;QACrE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IACrE,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,UAAkB,EAAE,SAAiB;IAC5E,MAAM,QAAQ,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,UAAU,EAAE,CAAA;IACpE,OAAO,cAAc,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;AAC5C,CAAC"}