common-memory-core 0.2.0

package/dist/v2/canonical.js

@@ -0,0 +1,321 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { closeSync, constants, existsSync, fstatSync, fsyncSync, lstatSync, mkdirSync, openSync, readFileSync, readdirSync, renameSync, rmSync, writeFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+export function digest(content) { return createHash('sha256').update(content).digest('hex'); }
+export function syncDirectory(path) { if (process.platform === 'win32')
+    return; const fd = openSync(path, 'r'); try {
+    fsyncSync(fd);
+}
+finally {
+    closeSync(fd);
+} }
+/** Reject symlinks in every existing ancestor, including the configured root. */
+export function safeDirectory(path) {
+    const absolute = resolve(path);
+    const parent = dirname(absolute);
+    if (parent !== absolute)
+        safeDirectory(parent);
+    if (!existsSync(absolute)) {
+        try {
+            mkdirSync(absolute, { mode: 0o700 });
+            syncDirectory(parent);
+        }
+        catch (error) {
+            if (!existsSync(absolute))
+                throw error;
+        }
+    }
+    const stat = lstatSync(absolute);
+    if (stat.isSymbolicLink() || !stat.isDirectory())
+        throw new Error('Unsafe directory');
+}
+/** Validate existing ancestors without creating storage on consumer read paths. */
+function existingDirectory(path) {
+    const absolute = resolve(path);
+    const parent = dirname(absolute);
+    if (parent !== absolute && !existingDirectory(parent))
+        return false;
+    try {
+        const stat = lstatSync(absolute);
+        if (stat.isSymbolicLink() || !stat.isDirectory())
+            throw new Error('Unsafe directory');
+        return true;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return false;
+        throw error;
+    }
+}
+export function readRegular(path, options = {}) {
+    if (options.createParents === false) {
+        if (!existingDirectory(dirname(path)))
+            return null;
+    }
+    else
+        safeDirectory(dirname(path));
+    try {
+        const stat = lstatSync(path);
+        if (!stat.isFile() || stat.isSymbolicLink() || stat.nlink !== 1 || stat.size > 1024 * 1024)
+            throw new Error('Unsafe file');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return null;
+        throw error;
+    }
+    const fd = openSync(path, constants.O_RDONLY | constants.O_NOFOLLOW);
+    try {
+        const stat = fstatSync(fd);
+        if (!stat.isFile() || stat.nlink !== 1 || stat.size > 1024 * 1024)
+            throw new Error('Unsafe file');
+        return readFileSync(fd, 'utf8');
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+export function atomicWrite(path, content) {
+    readRegular(path);
+    const temporary = join(dirname(path), `.write-${randomUUID()}`);
+    const fd = openSync(temporary, 'wx', 0o600);
+    try {
+        writeFileSync(fd, content);
+        fsyncSync(fd);
+    }
+    finally {
+        closeSync(fd);
+    }
+    renameSync(temporary, path);
+    syncDirectory(dirname(path));
+}
+function hashFile(path) { const content = readRegular(path); return content === null ? 'missing' : digest(content); }
+function parse(content, expectedTitle, hardLimitBytes) {
+    if (Buffer.byteLength(content) > hardLimitBytes)
+        throw new Error('Document hard limit exceeded');
+    const lines = content.match(/[^\n]*\n|[^\n]+$/g) ?? [];
+    let offset = 0;
+    let fence;
+    let h1 = false;
+    const sections = [];
+    const titles = new Set();
+    for (const line of lines) {
+        const text = line.replace(/\r?\n$/, '');
+        const marker = /^ {0,3}(`{3,}|~{3,})(.*)$/.exec(text);
+        if (marker) {
+            const token = marker[1];
+            if (!fence)
+                fence = { char: token[0], size: token.length };
+            else if (token[0] === fence.char && token.length >= fence.size && !marker[2].trim())
+                fence = undefined;
+            offset += line.length;
+            continue;
+        }
+        if (!fence) {
+            if (/^ {0,3}#(?:\s|$)/.test(text)) {
+                if (h1 || offset !== 0 || text !== `# ${expectedTitle}`)
+                    throw new Error('Invalid document H1');
+                h1 = true;
+            }
+            else if (/^ {0,3}##(?:\s|$)/.test(text)) {
+                const match = /^## ([^\r\n]+)$/.exec(text);
+                const title = match?.[1];
+                if (!h1 || !title || title.trim() !== title || titles.has(title))
+                    throw new Error('Invalid or duplicate section');
+                titles.add(title);
+                if (sections.length)
+                    sections.at(-1).end = offset;
+                sections.push({ ref: `s${sections.length + 1}`, title, body: '', start: offset, end: content.length });
+            }
+            else if (!sections.length && text.trim())
+                throw new Error('Content outside sections');
+            else if (/^ {0,3}(?:=+|-+)\s*$/.test(text) && text.trim().length > 0 && sections.length)
+                throw new Error('Setext headings are not supported');
+        }
+        offset += line.length;
+    }
+    if (!h1 || fence)
+        throw new Error('Invalid Markdown structure');
+    for (const section of sections) {
+        const newline = content.indexOf('\n', section.start);
+        section.body = newline < 0 ? '' : content.slice(newline + 1, section.end);
+    }
+    return sections;
+}
+export function targetInfo(target) {
+    if (target === 'profile')
+        return { relative: 'memory/profile.md', title: 'Profile' };
+    if (target === 'preferences')
+        return { relative: 'memory/preferences.md', title: 'Preferences' };
+    const match = /^project:([A-Za-z0-9_-]{1,128})$/.exec(target);
+    if (!match)
+        throw new Error('Invalid target');
+    return { relative: `memory/projects/${match[1]}.md`, title: 'Project' };
+}
+export class CanonicalStore {
+    root;
+    hardLimitBytes;
+    #checkpoint;
+    constructor(dataRoot, options = {}) { this.hardLimitBytes = options.hardLimitBytes ?? 16384; if (!Number.isSafeInteger(this.hardLimitBytes) || this.hardLimitBytes < 64 || this.hardLimitBytes > 1048576)
+        throw new Error('Invalid document limit'); this.#checkpoint = options.checkpoint ?? (() => { }); this.root = resolve(dataRoot); safeDirectory(this.root); for (const path of ['memory/projects', 'runtime/receipts', 'runtime/transactions'])
+        safeDirectory(join(this.root, path)); }
+    snapshot(projectIds = []) {
+        return [...new Set(['profile', 'preferences', ...projectIds.map(id => `project:${id}`)])].map(target => {
+            const info = targetInfo(target);
+            const path = join(this.root, info.relative);
+            const raw = readRegular(path);
+            const content = raw ?? `# ${info.title}\n\n`;
+            return { target, path, content, hash: raw === null ? 'missing' : digest(raw), sections: parse(content, info.title, this.hardLimitBytes).map(({ ref, title, body }) => ({ ref, title, body })) };
+        });
+    }
+    apply(snapshot, operations) {
+        const updates = new Map();
+        const grouped = new Map();
+        for (const operation of operations) {
+            if (!snapshot.some(doc => doc.target === operation.target))
+                throw new Error('Unauthorized target');
+            const group = grouped.get(operation.target) ?? [];
+            group.push(operation);
+            grouped.set(operation.target, group);
+        }
+        for (const [target, group] of grouped) {
+            const doc = snapshot.find(item => item.target === target);
+            const info = targetInfo(target);
+            const sections = parse(doc.content, info.title, this.hardLimitBytes);
+            const edits = [];
+            const touched = new Set();
+            let appended = '';
+            for (const operation of group) {
+                const section = operation.section === null ? undefined : sections.find(item => item.ref === operation.section);
+                if (operation.section !== null && (!section || touched.has(operation.section)))
+                    throw new Error('Invalid or duplicate section reference');
+                if (section)
+                    touched.add(section.ref);
+                if (operation.op === 'remove_section') {
+                    if (!section)
+                        throw new Error('Removal requires section');
+                    edits.push({ start: section.start, end: section.end, text: '' });
+                }
+                else if (operation.op === 'put_section') {
+                    const { title, body } = operation;
+                    if (!title || title.trim() !== title || /[\r\n]/.test(title) || body === undefined)
+                        throw new Error('Invalid section payload');
+                    const text = `## ${title}\n${body}${body.endsWith('\n') ? '' : '\n'}`;
+                    const validation = parse(`# ${info.title}\n\n${text}`, info.title, this.hardLimitBytes);
+                    if (validation.length !== 1)
+                        throw new Error('Undeclared section in body');
+                    if (section)
+                        edits.push({ start: section.start, end: section.end, text });
+                    else
+                        appended += text;
+                }
+                else
+                    throw new Error('Invalid operation');
+            }
+            let result = doc.content;
+            for (const edit of edits.sort((a, b) => b.start - a.start))
+                result = result.slice(0, edit.start) + edit.text + result.slice(edit.end);
+            if (appended)
+                result += (result.endsWith('\n') ? '' : '\n') + appended;
+            parse(result, info.title, this.hardLimitBytes);
+            updates.set(target, result);
+        }
+        return updates;
+    }
+    commit(snapshot, updates, receipt, beforePublish = () => { }) {
+        if (!/^[A-Za-z0-9_-]{1,128}$/.test(receipt.id))
+            throw new Error('Invalid receipt id');
+        this.recover();
+        for (const doc of snapshot) {
+            const path = join(this.root, targetInfo(doc.target).relative);
+            if (doc.path !== path || hashFile(path) !== doc.hash)
+                throw new Error('STALE_REVISION');
+        }
+        const receiptPath = `runtime/receipts/${receipt.id}.json`;
+        if (readRegular(join(this.root, receiptPath)) !== null)
+            throw new Error('Receipt already committed');
+        const files = [];
+        for (const [target, content] of updates) {
+            if (!snapshot.some(doc => doc.target === target))
+                throw new Error('Unauthorized target');
+            const info = targetInfo(target);
+            parse(content, info.title, this.hardLimitBytes);
+            files.push({ path: info.relative, content });
+        }
+        files.push({ path: receiptPath, content: JSON.stringify(receipt) + '\n' });
+        const id = randomUUID();
+        const directory = join(this.root, 'runtime/transactions', id);
+        safeDirectory(directory);
+        const journal = { id, files: files.map((file, index) => { const stage = `stage-${index}`; atomicWrite(join(directory, stage), file.content); return { path: file.path, stage, before: snapshot.find(doc => targetInfo(doc.target).relative === file.path)?.hash ?? 'missing', after: digest(file.content) }; }) };
+        atomicWrite(join(directory, 'journal.json'), JSON.stringify(journal));
+        this.#checkpoint('staged');
+        for (const doc of snapshot)
+            if (hashFile(doc.path) !== doc.hash)
+                throw new Error('STALE_REVISION');
+        beforePublish();
+        atomicWrite(join(directory, 'COMMITTING'), 'v2\n');
+        this.#checkpoint('commit-marker');
+        this.recover();
+    }
+    recover() {
+        const root = join(this.root, 'runtime/transactions');
+        safeDirectory(root);
+        for (const id of readdirSync(root)) {
+            if (/^done\.[a-f0-9-]{36}$/.test(id)) {
+                const completed = join(root, id);
+                safeDirectory(completed);
+                rmSync(completed, { recursive: true });
+                syncDirectory(root);
+                continue;
+            }
+            if (!/^[a-f0-9-]{36}$/.test(id))
+                throw new Error('Unsafe transaction identity');
+            const directory = join(root, id);
+            safeDirectory(directory);
+            const marker = readRegular(join(directory, 'COMMITTING'));
+            if (marker === null) {
+                rmSync(directory, { recursive: true });
+                syncDirectory(root);
+                continue;
+            }
+            if (marker !== 'v2\n')
+                throw new Error('Invalid commit marker');
+            const journal = JSON.parse(readRegular(join(directory, 'journal.json')) ?? 'null');
+            if (!journal || journal.id !== id || !Array.isArray(journal.files) || !journal.files.length)
+                throw new Error('Invalid transaction');
+            const paths = new Set();
+            for (const file of journal.files) {
+                if (!file || typeof file.path !== 'string' || typeof file.stage !== 'string' || !/^(?:missing|[a-f0-9]{64})$/.test(file.before) || !/^[a-f0-9]{64}$/.test(file.after) || !/^(?:memory\/(?:profile|preferences)\.md|memory\/projects\/[A-Za-z0-9_-]{1,128}\.md|runtime\/receipts\/[A-Za-z0-9_-]{1,128}\.json)$/.test(file.path) || !/^stage-\d+$/.test(file.stage) || paths.has(file.path))
+                    throw new Error('Unsafe transaction path');
+                paths.add(file.path);
+                const staged = readRegular(join(directory, file.stage));
+                if (staged === null || digest(staged) !== file.after)
+                    throw new Error('Corrupt transaction');
+                const current = hashFile(join(this.root, file.path));
+                if (current !== file.before && current !== file.after)
+                    throw new Error('Recovery conflict: external modification');
+            }
+            for (const file of journal.files) {
+                const path = join(this.root, file.path);
+                if (hashFile(path) !== file.after) {
+                    atomicWrite(path, readRegular(join(directory, file.stage)));
+                    this.#checkpoint(`target:${file.path}`);
+                }
+            }
+            this.#checkpoint('before-cleanup');
+            const completed = join(root, `done.${id}`);
+            renameSync(directory, completed);
+            syncDirectory(root);
+            rmSync(completed, { recursive: true });
+            syncDirectory(root);
+        }
+    }
+    receipts() {
+        const root = join(this.root, 'runtime/receipts');
+        safeDirectory(root);
+        return readdirSync(root).map(name => { if (!/^[A-Za-z0-9_-]{1,128}\.json$/.test(name))
+            throw new Error('Unsafe receipt'); const value = JSON.parse(readRegular(join(root, name))); if (value.id !== name.slice(0, -5))
+            throw new Error('Invalid receipt'); return value; });
+    }
+}
+//# sourceMappingURL=canonical.js.map

package/dist/v2/canonical.js.map

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

package/dist/v2/contract.d.ts

@@ -0,0 +1,34 @@
+import type { DocumentSnapshot } from './canonical.js';
+export interface SectionOperation {
+    op: 'put_section' | 'remove_section';
+    target: string;
+    section: string | null;
+    title?: string;
+    body?: string;
+}
+interface CommonDecision {
+    applicability: 'global' | 'project' | 'uncertain';
+    confidence: number;
+    evidence: string[];
+    reason: string;
+}
+export type Decision = CommonDecision & ({
+    kind: 'retain';
+    admission: 'remember' | 'update' | 'correct';
+    lifetime: 'stable' | 'until_changed';
+    operations: SectionOperation[];
+} | {
+    kind: 'forget' | 'maintain';
+    operations: SectionOperation[];
+} | {
+    kind: 'ignore';
+});
+export interface MaintenanceDecision {
+    version: 'memory_maintenance_v2';
+    request_id: string;
+    decisions: Decision[];
+}
+export declare const maintenanceSchema: Readonly<Record<string, unknown>>;
+export declare function validateDecision(body: unknown, requestId: string, documents: DocumentSnapshot[], evidenceScopes: Map<string, string>): MaintenanceDecision;
+export {};
+//# sourceMappingURL=contract.d.ts.map

package/dist/v2/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/v2/contract.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,MAAM,WAAW,gBAAgB;IAAG,EAAE,EAAE,aAAa,GAAG,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;AACjJ,UAAU,cAAc;IAAG,aAAa,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AACtI,MAAM,MAAM,QAAQ,GAAG,cAAc,GAAG,CACpC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,SAAS,EAAE,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;IAAC,QAAQ,EAAE,QAAQ,GAAG,eAAe,CAAC;IAAC,UAAU,EAAE,gBAAgB,EAAE,CAAA;CAAE,GACtI;IAAE,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAC;IAAC,UAAU,EAAE,gBAAgB,EAAE,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CACrB,CAAC;AACF,MAAM,WAAW,mBAAmB;IAAG,OAAO,EAAE,uBAAuB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,QAAQ,EAAE,CAAA;CAAE;AAQpH,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAS/D,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,EAAE,EAAE,cAAc,EAAE,GAAG,CAAC,MAAM,EAAC,MAAM,CAAC,GAAG,mBAAmB,CAuBzJ"}

package/dist/v2/contract.js

@@ -0,0 +1,53 @@
+import { Ajv2020 } from 'ajv/dist/2020.js';
+// Explicit types on string const/enum fields preserve their value domain and satisfy strict remote schema parsers.
+const string = { type: 'string' };
+const operationSchema = { anyOf: [
+        { type: 'object', additionalProperties: false, required: ['op', 'target', 'section', 'title', 'body'], properties: { op: { type: 'string', const: 'put_section' }, target: string, section: { type: ['string', 'null'] }, title: string, body: string } },
+        { type: 'object', additionalProperties: false, required: ['op', 'target', 'section'], properties: { op: { type: 'string', const: 'remove_section' }, target: string, section: string } },
+    ] };
+const common = { applicability: { type: 'string', enum: ['global', 'project', 'uncertain'] }, confidence: { type: 'number', minimum: 0, maximum: 1 }, evidence: { type: 'array', items: string, maxItems: 128 }, reason: { type: 'string', maxLength: 4000 } };
+export const maintenanceSchema = {
+    type: 'object', additionalProperties: false, required: ['version', 'request_id', 'decisions'], properties: {
+        version: { type: 'string', const: 'memory_maintenance_v2' }, request_id: string,
+        decisions: { type: 'array', minItems: 1, maxItems: 64, items: { anyOf: [
+                    { type: 'object', additionalProperties: false, required: ['kind', 'applicability', 'confidence', 'evidence', 'reason', 'admission', 'lifetime', 'operations'], properties: { ...common, kind: { type: 'string', const: 'retain' }, admission: { type: 'string', enum: ['remember', 'update', 'correct'] }, lifetime: { type: 'string', enum: ['stable', 'until_changed'] }, operations: { type: 'array', minItems: 1, maxItems: 32, items: operationSchema } } },
+                    ...['forget', 'maintain'].map(kind => ({ type: 'object', additionalProperties: false, required: ['kind', 'applicability', 'confidence', 'evidence', 'reason', 'operations'], properties: { ...common, kind: { type: 'string', const: kind }, operations: { type: 'array', minItems: 1, maxItems: 32, items: operationSchema } } })),
+                    { type: 'object', additionalProperties: false, required: ['kind', 'applicability', 'confidence', 'evidence', 'reason'], properties: { ...common, kind: { type: 'string', const: 'ignore' } } },
+                ] } },
+    },
+};
+const validate = new Ajv2020({ strict: false, allErrors: true }).compile(maintenanceSchema);
+export function validateDecision(body, requestId, documents, evidenceScopes) {
+    if (!validate(body))
+        throw new Error('INVALID_DECISION');
+    const result = body;
+    if (result.request_id !== requestId)
+        throw new Error('INVALID_REQUEST_REFERENCE');
+    const touched = new Set();
+    for (const decision of result.decisions) {
+        if (decision.evidence.some(ref => !evidenceScopes.has(ref)))
+            throw new Error('INVALID_EVIDENCE_REFERENCE');
+        if ((decision.kind === 'retain' || decision.kind === 'forget') && !decision.evidence.length)
+            throw new Error('MISSING_EVIDENCE');
+        if (decision.kind === 'ignore')
+            continue;
+        for (const op of decision.operations) {
+            const doc = documents.find(doc => doc.target === op.target);
+            if (!doc || op.section !== null && !doc.sections.some(s => s.ref === op.section))
+                throw new Error('INVALID_TARGET_REFERENCE');
+            // Applicability describes the destination; evidence scopes describe origin only.
+            const projectTarget = op.target.startsWith('project:');
+            if (decision.applicability !== (projectTarget ? 'project' : 'global'))
+                throw new Error('UNAUTHORIZED_SCOPE');
+            // Check the whole batch, including maintain decisions with no evidence.
+            if (projectTarget && (!evidenceScopes.size || [...evidenceScopes.values()].some(scope => scope !== op.target)))
+                throw new Error('UNAUTHORIZED_SCOPE');
+            const key = `${op.target}\0${op.section ?? op.title}`;
+            if (touched.has(key))
+                throw new Error('DUPLICATE_SECTION_OPERATION');
+            touched.add(key);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=contract.js.map

package/dist/v2/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../src/v2/contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAU3C,mHAAmH;AACnH,MAAM,MAAM,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAClC,MAAM,eAAe,GAAG,EAAE,KAAK,EAAE;QAC/B,EAAE,IAAI,EAAE,QAAQ,EAAE,oBAAoB,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAC,QAAQ,EAAC,SAAS,EAAC,OAAO,EAAC,MAAM,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAC,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;QACpP,EAAE,IAAI,EAAE,QAAQ,EAAE,oBAAoB,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAC,QAAQ,EAAC,SAAS,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,gBAAgB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE;KACvL,EAAE,CAAC;AACJ,MAAM,MAAM,GAAG,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAC,SAAS,EAAC,WAAW,CAAC,EAAE,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC;AAC7P,MAAM,CAAC,MAAM,iBAAiB,GAAsC;IAClE,IAAI,EAAE,QAAQ,EAAE,oBAAoB,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,SAAS,EAAC,YAAY,EAAC,WAAW,CAAC,EAAE,UAAU,EAAE;QACvG,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,uBAAuB,EAAE,EAAE,UAAU,EAAE,MAAM;QAC/E,SAAS,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE;oBACrE,EAAE,IAAI,EAAE,QAAQ,EAAE,oBAAoB,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAC,eAAe,EAAC,YAAY,EAAC,UAAU,EAAC,QAAQ,EAAC,WAAW,EAAC,UAAU,EAAC,YAAY,CAAC,EAAE,UAAU,EAAE,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,UAAU,EAAC,QAAQ,EAAC,SAAS,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAC,eAAe,CAAC,EAAE,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,EAAE,EAAE;oBACtb,GAAG,CAAC,QAAQ,EAAC,UAAU,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,oBAAoB,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAC,eAAe,EAAC,YAAY,EAAC,UAAU,EAAC,QAAQ,EAAC,YAAY,CAAC,EAAE,UAAU,EAAE,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC,CAAC;oBAC7T,EAAE,IAAI,EAAE,QAAQ,EAAE,oBAAoB,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAC,eAAe,EAAC,YAAY,EAAC,UAAU,EAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE;iBAC3L,EAAE,EAAE;KACN;CACF,CAAC;AACF,MAAM,QAAQ,GAAG,IAAI,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAC5F,MAAM,UAAU,gBAAgB,CAAC,IAAa,EAAE,SAAiB,EAAE,SAA6B,EAAE,cAAkC;IAClI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,IAA2B,CAAC;IAC3C,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAClF,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACxC,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAC3G,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACjI,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ;YAAE,SAAS;QACzC,KAAK,MAAM,EAAE,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;YACrC,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,EAAE,CAAC,MAAM,CAAC,CAAC;YAC5D,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,OAAO,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC,OAAO,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;YAC9H,iFAAiF;YACjF,MAAM,aAAa,GAAG,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;YACvD,IAAI,QAAQ,CAAC,aAAa,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;YAC7G,wEAAwE;YACxE,IAAI,aAAa,IAAI,CAAC,CAAC,cAAc,CAAC,IAAI,IAAI,CAAC,GAAG,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC,MAAM,CAAC,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;YACtJ,MAAM,GAAG,GAAG,GAAG,EAAE,CAAC,MAAM,KAAK,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC;YACtD,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;YACrE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/v2/document-import.d.ts

@@ -0,0 +1,100 @@
+import type { RuntimeStore } from './runtime.js';
+/**
+ * Input preprocessing for a user-chosen local Markdown file. It reads, validates, and splits the
+ * material into structural chunks that the unchanged Writer receives as `document_import`
+ * observations. It never decides what is worth remembering, never summarizes, never strips
+ * headings, quotes, qualifiers or code, and never executes or follows anything in the file.
+ */
+export declare const DOCUMENT_AUTHORS: readonly ["user", "agent", "third_party", "mixed", "unknown"];
+export type DocumentAuthor = typeof DOCUMENT_AUTHORS[number];
+/** One chunk must fit the same per-item budget as an Init understanding; the Writer request cap still applies. */
+export declare const MAX_DOCUMENT_CHUNK_BYTES = 32768;
+/** Whole-file cap for the first version: larger files are rejected up front, never truncated. */
+export declare const MAX_DOCUMENT_BYTES = 262144;
+export declare const DOCUMENT_EXTENSIONS: readonly [".md", ".markdown"];
+/** Queue-key format of the chunk envelope; a change in chunking rules starts a new import rather than a stuck resume. */
+export declare const DOCUMENT_IMPORT_FORMAT = "v1";
+export interface MarkdownChunk {
+    headingPath: string[];
+    text: string;
+}
+export interface DocumentImportChunk {
+    importId: string;
+    sourceLabel: string;
+    declaredAuthor: DocumentAuthor;
+    fileName: string;
+    contentDigest: string;
+    part: {
+        index: number;
+        count: number;
+    };
+    headingPath: string[];
+    text: string;
+}
+export interface PreparedDocumentImport {
+    importId: string;
+    fileName: string;
+    bytes: number;
+    contentDigest: string;
+    sourceLabel: string;
+    declaredAuthor: DocumentAuthor;
+    chunks: {
+        entryId: string;
+        text: string;
+        headingPath: string[];
+        bytes: number;
+    }[];
+}
+/** Read one regular Markdown file: no symlinks, no directories, strict UTF-8, bounded size. */
+export declare function readMarkdownFile(path: string): {
+    path: string;
+    fileName: string;
+    text: string;
+    bytes: number;
+};
+/**
+ * Split at Markdown structure only. A chunk is a run of whole paragraphs; headings start new units,
+ * fenced code is never split, blank lines inside fences are not boundaries. Sections stay whole when
+ * they fit. `headingPath` is the ancestor heading stack at the chunk start, so a chunk that begins
+ * under "## Examples" still says so. One unit larger than the budget rejects the whole import.
+ */
+export declare function chunkMarkdown(text: string, budget?: number): MarkdownChunk[];
+/** Deterministic envelope: identical content, label and author digest identically so retries deduplicate. */
+export declare function encodeDocumentChunk(chunk: DocumentImportChunk): string;
+export declare function decodeDocumentChunk(text: string): DocumentImportChunk | null;
+/**
+ * Validate, chunk and safety-scan a file without touching any store. The import identity is the
+ * content digest: the same bytes under another name are the same import, changed bytes are a new one.
+ * The scan is the Writer's own outbound preflight run early, so a rejected file is reported before
+ * anything is queued (the Writer repeats it before any network call).
+ */
+export declare function prepareDocumentImport(path: string, options?: {
+    label?: string | undefined;
+    author?: DocumentAuthor | undefined;
+    maxTotalBytes?: number | undefined;
+}): PreparedDocumentImport;
+/** The queue namespace for local Markdown imports; the same content into two scopes is two items. */
+export declare function documentImportSession(importId: string, contextId: string): string;
+/**
+ * Admit every chunk of one import in a single transaction and request a prompt flush, exactly like Init.
+ * Identity is the content digest within the scope: re-importing identical bytes (under any file name,
+ * label or declared author) is a duplicate of the existing material and queues nothing new; the
+ * original metadata stays. Different bytes are a different import.
+ */
+export declare function admitDocumentImport(store: RuntimeStore, prepared: PreparedDocumentImport, contextId: string): {
+    importId: string;
+    duplicate: boolean;
+    parts: number;
+};
+export interface DocumentImportOutcome {
+    importId: string;
+    contextId: string;
+    complete: boolean;
+    parts: (import("./runtime.js").ObservationOutcome & {
+        part: number;
+    })[];
+    retainedIn: string[];
+}
+/** Per-part state without bodies; `complete` only when every part was processed. */
+export declare function documentImportOutcome(store: RuntimeStore, importId: string, contextId: string, count: number): DocumentImportOutcome;
+//# sourceMappingURL=document-import.d.ts.map

package/dist/v2/document-import.d.ts.map

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