@framers/agentos 0.13.64 → 0.13.66

package/dist/cognition/substrate/memory/wiki/WikiCompiler.js

@@ -1,6 +1,17 @@
 /** @fileoverview Folds new memory traces into wiki pages via LLM merge (merge-not-clobber). */
 import { extractWikiLinks } from './WikiPageCodec.js';
 import { assertWikiPageId, InvalidWikiPageIdError } from './WikiPageId.js';
+/**
+ * The codes of file system errors that come from the paths a page write uses, so writing the same page fails the
+ * same way on every compile: a name the file system will not take (`ENAMETOOLONG`, `EINVAL`), a file where a folder
+ * must be (`ENOTDIR`, `EEXIST`), a folder where a file must be (`EISDIR`), or a loop of links (`ELOOP`).
+ */
+const PAGE_PATH_ERRORS = new Set(['ENAMETOOLONG', 'EINVAL', 'ENOTDIR', 'EEXIST', 'EISDIR', 'ELOOP']);
+/** True for an error that writing the same page would raise again (see {@link PAGE_PATH_ERRORS}). */
+function isPagePathError(err) {
+    const code = err instanceof Error ? err.code : undefined;
+    return typeof code === 'string' && PAGE_PATH_ERRORS.has(code);
+}
 const MERGE_PROMPT = (currentBody, facts) => `You maintain a knowledge wiki page. Here is the CURRENT page, which may include human edits:\n\n` +
     `---\n${currentBody || '(empty page)'}\n---\n\n` +
     `Integrate these NEW facts without discarding existing content. Preserve voice and structure. ` +
@@ -13,7 +24,11 @@ export class WikiCompiler {
     /**
      * Fold traces into the pages the cluster step assigns them to. An assignment whose page id the wiki
      * refuses (see `isWikiPageId`) is not read, merged or written: it is reported in `conflicts`, with the
-     * reason as its note, and the other assignments go on.
+     * reason as its note, and the other assignments go on. An assignment whose page the file system refuses
+     * for its path, such as a name too long or a file where a folder must be, is reported there too: writing
+     * it would fail the same way on every compile. Its traces are not counted as consumed. Any other failed
+     * write, such as a full disk or a missing permission, rejects the compile, so a caller that keeps a
+     * watermark compiles the same traces again.
      */
     async compile(input) {
         const result = { pagesWritten: [], tracesConsumed: 0, conflicts: [] };
@@ -43,15 +58,25 @@ export class WikiCompiler {
             const mergedBody = (await this.opts.llm(MERGE_PROMPT(current?.body ?? '', facts))).trim();
             const type = current?.type ?? inferType(a.pageId);
             const newSources = [...new Set([...(current?.sources ?? []), ...a.traceIds])];
-            await this.opts.store.writePage({
-                id: a.pageId,
-                type,
-                summary: current?.summary ?? facts[0].slice(0, 120),
-                updated: now(),
-                sources: newSources,
-                body: mergedBody,
-                links: extractWikiLinks(mergedBody),
-            });
+            try {
+                await this.opts.store.writePage({
+                    id: a.pageId,
+                    type,
+                    summary: current?.summary ?? facts[0].slice(0, 120),
+                    updated: now(),
+                    sources: newSources,
+                    body: mergedBody,
+                    links: extractWikiLinks(mergedBody),
+                });
+            }
+            catch (err) {
+                // A page the file system refuses for its path would stop every later compile at the same batch, so it is
+                // reported and the compile goes on. Any other failure may pass, so it stops the compile.
+                if (!isPagePathError(err))
+                    throw err;
+                result.conflicts.push({ pageId: a.pageId, note: `write failed: ${err.message}` });
+                continue;
+            }
             result.pagesWritten.push(a.pageId);
             result.tracesConsumed += a.traceIds.length;
         }

package/dist/cognition/substrate/memory/wiki/WikiCompiler.js.map

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

package/dist/cognition/substrate/memory/wiki/WikiMemoryStore.d.ts

@@ -1,4 +1,23 @@
+import * as path from 'node:path';
 import type { WikiPage, MetaIndex, IndexResult } from './types.js';
+/** One entry of a folder's listing: its name, and whether it is a folder. `fs.Dirent` has this shape. */
+export interface WikiFolderEntry {
+    name: string;
+    isDirectory(): boolean;
+}
+/**
+ * List the page ids under `memoryDir`: each `.md` file's path under the folder without `.md`, with `/` between
+ * folders on every platform, the form the compiler writes and `readPage` takes. Every file or folder whose name
+ * starts with a dot (`.meta/` among them) is skipped, and so is every file whose path makes no valid page id,
+ * `index.md` among them, so every id listed is one `readPage` accepts.
+ *
+ * @param memoryDir - The wiki's folder.
+ * @param readDir - Lists one folder, given its path. A folder it cannot list is skipped.
+ * @param paths - The path functions that build a folder's path from `memoryDir` and its names: the platform's by
+ *   default.
+ * @returns The ids, sorted.
+ */
+export declare function listWikiPageIds(memoryDir: string, readDir: (dir: string) => Promise<readonly WikiFolderEntry[]>, paths?: Pick<path.PlatformPath, 'join'>): Promise<string[]>;
 /** The slice of the Memory facade the store depends on (injected for testability). */
 export interface MemoryIndexPort {
     remember(content: string, options?: Record<string, unknown>): Promise<{
@@ -42,12 +61,12 @@ export declare class WikiMemoryStore {
     writePage(page: WikiPage): Promise<void>;
     getCatalog(): Promise<string>;
     private refreshCatalog;
+    /** The page ids under memory/ (see `listWikiPageIds`). */
+    private listPageIds;
     /**
-     * Recursively list page ids (the path under memory/ with `/` between folders, no extension), skipping
-     * index.md and every file or folder whose name starts with a dot (`.meta/` among them). A file whose path
-     * does not make a valid page id is not a page, so every id listed is one `readPage` accepts.
+     * Read `.meta/index.json`, or an empty index when it is missing or unreadable. Its page entries are held in an
+     * object with no prototype (see `pageEntries`), so any page id is safe to look up.
      */
-    private listPageIds;
     protected readMeta(): Promise<MetaIndex>;
     protected writeMeta(meta: MetaIndex): Promise<void>;
     /** Incremental: re-embed only pages whose body hash changed since the last index. */

package/dist/cognition/substrate/memory/wiki/WikiMemoryStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WikiMemoryStore.d.ts","sourceRoot":"","sources":["../../../../../src/cognition/substrate/memory/wiki/WikiMemoryStore.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEnE,sFAAsF;AACtF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtF,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkB;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,IAAI,EAAE,sBAAsB;IAMxC;;;;;OAKG;IACH,OAAO,CAAC,QAAQ;IAIhB,qHAAqH;IAC/G,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAUjC;;;;OAIG;IACG,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAUpD;;;;OAIG;IACG,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAOxC,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;YAQrB,cAAc;IAK5B;;;;OAIG;YACW,WAAW;cA0BT,QAAQ,IAAI,OAAO,CAAC,SAAS,CAAC;cAS9B,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzD,qFAAqF;IAC/E,KAAK,CAAC,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IAkD7D,gEAAgE;IAC1D,YAAY,IAAI,OAAO,CAAC,WAAW,CAAC;IAS1C,yEAAyE;IACnE,iBAAiB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIjD,gEAAgE;IAC1D,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMpD,SAAS,KAAK,QAAQ,IAAI,MAAM,CAE/B;IACD,SAAS,KAAK,KAAK,IAAI,eAAe,CAErC;CACF"}
+{"version":3,"file":"WikiMemoryStore.d.ts","sourceRoot":"","sources":["../../../../../src/cognition/substrate/memory/wiki/WikiMemoryStore.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAIlC,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEnE,yGAAyG;AACzG,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,IAAI,OAAO,CAAC;CACxB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC,EAC7D,KAAK,GAAE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAQ,GAC5C,OAAO,CAAC,MAAM,EAAE,CAAC,CAsBnB;AAkBD,sFAAsF;AACtF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtF,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkB;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,IAAI,EAAE,sBAAsB;IAMxC;;;;;OAKG;IACH,OAAO,CAAC,QAAQ;IAIhB,qHAAqH;IAC/G,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAUjC;;;;OAIG;IACG,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAUpD;;;;OAIG;IACG,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAOxC,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;YAQrB,cAAc;IAK5B,0DAA0D;YAC5C,WAAW;IAIzB;;;OAGG;cACa,QAAQ,IAAI,OAAO,CAAC,SAAS,CAAC;cAY9B,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzD,qFAAqF;IAC/E,KAAK,CAAC,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IAkD7D,gEAAgE;IAC1D,YAAY,IAAI,OAAO,CAAC,WAAW,CAAC;IAS1C,yEAAyE;IACnE,iBAAiB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIjD,gEAAgE;IAC1D,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMpD,SAAS,KAAK,QAAQ,IAAI,MAAM,CAE/B;IACD,SAAS,KAAK,KAAK,IAAI,eAAe,CAErC;CACF"}

package/dist/cognition/substrate/memory/wiki/WikiMemoryStore.js

@@ -4,6 +4,61 @@ import * as path from 'node:path';
 import { createHash } from 'node:crypto';
 import { parsePage, serializePage, renderCatalog } from './WikiPageCodec.js';
 import { isWikiPageId, resolveWikiPagePath } from './WikiPageId.js';
+/**
+ * List the page ids under `memoryDir`: each `.md` file's path under the folder without `.md`, with `/` between
+ * folders on every platform, the form the compiler writes and `readPage` takes. Every file or folder whose name
+ * starts with a dot (`.meta/` among them) is skipped, and so is every file whose path makes no valid page id,
+ * `index.md` among them, so every id listed is one `readPage` accepts.
+ *
+ * @param memoryDir - The wiki's folder.
+ * @param readDir - Lists one folder, given its path. A folder it cannot list is skipped.
+ * @param paths - The path functions that build a folder's path from `memoryDir` and its names: the platform's by
+ *   default.
+ * @returns The ids, sorted.
+ */
+export async function listWikiPageIds(memoryDir, readDir, paths = path) {
+    const out = [];
+    const walk = async (names) => {
+        let entries;
+        try {
+            entries = await readDir(paths.join(memoryDir, ...names));
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            if (e.name.startsWith('.'))
+                continue;
+            if (e.isDirectory()) {
+                await walk([...names, e.name]);
+            }
+            else if (e.name.endsWith('.md')) {
+                // Ids join folders with `/` on every platform, never with the platform's separator.
+                const id = [...names, e.name.slice(0, -3)].join('/');
+                if (isWikiPageId(id))
+                    out.push(id);
+            }
+        }
+    };
+    await walk([]);
+    return out.sort();
+}
+/**
+ * The page entries of `.meta/index.json` in an object with no prototype, so a page id that names a member every
+ * object has (`constructor`, `toString`, `__proto__`) finds only its own entry. An entry with no list of trace ids
+ * is dropped, and its page is indexed again.
+ */
+function pageEntries(pages) {
+    const entries = Object.create(null);
+    if (pages === null || typeof pages !== 'object' || Array.isArray(pages))
+        return entries;
+    for (const [id, entry] of Object.entries(pages)) {
+        if (entry !== null && typeof entry === 'object' && Array.isArray(entry.traceIds)) {
+            entries[id] = entry;
+        }
+    }
+    return entries;
+}
 export class WikiMemoryStore {
     constructor(opts) {
         this.memoryDir = opts.memoryDir;
@@ -68,48 +123,24 @@ export class WikiMemoryStore {
         const pages = await this.load();
         await fs.writeFile(path.join(this.memoryDir, 'index.md'), renderCatalog(pages));
     }
-    /**
-     * Recursively list page ids (the path under memory/ with `/` between folders, no extension), skipping
-     * index.md and every file or folder whose name starts with a dot (`.meta/` among them). A file whose path
-     * does not make a valid page id is not a page, so every id listed is one `readPage` accepts.
-     */
+    /** The page ids under memory/ (see `listWikiPageIds`). */
     async listPageIds() {
-        const out = [];
-        const walk = async (relDir) => {
-            const abs = path.join(this.memoryDir, relDir);
-            let entries;
-            try {
-                entries = await fs.readdir(abs, { withFileTypes: true });
-            }
-            catch {
-                return;
-            }
-            for (const e of entries) {
-                if (e.name.startsWith('.'))
-                    continue;
-                // Ids join folders with `/` on every platform, the form the compiler writes and readPage takes.
-                const rel = relDir ? `${relDir}/${e.name}` : e.name;
-                if (e.isDirectory()) {
-                    await walk(rel);
-                }
-                else if (e.name.endsWith('.md') && rel !== 'index.md') {
-                    const id = rel.slice(0, -3);
-                    if (isWikiPageId(id))
-                        out.push(id);
-                }
-            }
-        };
-        await walk('');
-        return out.sort();
+        return listWikiPageIds(this.memoryDir, (dir) => fs.readdir(dir, { withFileTypes: true }));
     }
+    /**
+     * Read `.meta/index.json`, or an empty index when it is missing or unreadable. Its page entries are held in an
+     * object with no prototype (see `pageEntries`), so any page id is safe to look up.
+     */
     async readMeta() {
+        let parsed = null;
         try {
-            const raw = await fs.readFile(path.join(this.memoryDir, '.meta', 'index.json'), 'utf8');
-            return JSON.parse(raw);
+            parsed = JSON.parse(await fs.readFile(path.join(this.memoryDir, '.meta', 'index.json'), 'utf8'));
         }
         catch {
-            return { lastCompiledAt: null, pages: {} };
+            // No index yet, or one that does not parse: start from an empty one.
         }
+        const meta = parsed !== null && typeof parsed === 'object' && !Array.isArray(parsed) ? parsed : {};
+        return { ...meta, lastCompiledAt: meta.lastCompiledAt ?? null, pages: pageEntries(meta.pages) };
     }
     async writeMeta(meta) {
         const metaDir = path.join(this.memoryDir, '.meta');

package/dist/cognition/substrate/memory/wiki/WikiMemoryStore.js.map

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

package/dist/cognition/substrate/memory/wiki/WikiPageId.d.ts

@@ -6,9 +6,11 @@ export declare const MAX_WIKI_PAGE_ID_LENGTH = 512;
  * Why a wiki page id was refused:
  * - `'type'`: the id is not a string.
  * - `'empty'`: the id is an empty string.
- * - `'length'`: the id is longer than {@link MAX_WIKI_PAGE_ID_LENGTH} characters.
- * - `'character'`: the id holds a backslash, a colon or a control character (U+0000 to U+001F, or U+007F), a NUL
- *   byte among them. On Windows a backslash separates folders and a colon names a drive or a file's stream.
+ * - `'length'`: the id is longer than {@link MAX_WIKI_PAGE_ID_LENGTH} characters, or a name in it holds more than
+ *   200 bytes in UTF-8, the most a name built from data may hold (`MAX_PATH_NAME_BYTES` in `core/utils/pathName`).
+ * - `'character'`: the id holds a backslash, a colon, one of `"`, `*`, `<`, `>`, `?` and `|`, or a control
+ *   character (U+0000 to U+001F, or U+007F), a NUL byte among them. On Windows a backslash separates folders, a
+ *   colon names a drive or a file's stream, and the other six are refused in a name.
  * - `'segment'`: a name between slashes is empty: the id starts or ends with `/`, or holds `//`.
  * - `'dot'`: a name starts with a dot, `.` and `..` among them.
  * - `'edge'`: a name starts or ends with a space, or ends with a dot. Windows drops those from a name, so the
@@ -33,10 +35,10 @@ export declare class InvalidWikiPageIdError extends Error {
  * True when `id` has the wiki's id form: the page's path under `memory/` without `.md`, one or more names
  * joined by `/` (`entities/johnny` is `memory/entities/johnny.md`). No name is empty or starts with a dot,
  * so `.` and `..` are never names, and no name starts or ends with a space or ends with a dot, which
- * Windows drops from a name; the id holds no backslash, no colon and no control character, a NUL
- * byte among them; it is at most {@link MAX_WIKI_PAGE_ID_LENGTH} characters; and it is not `index` in any
- * case, the catalog's own id. Every id the store lists, and every id the default clusterer of
- * `attachMemoryWiki` makes, has this form.
+ * Windows drops from a name; the id holds no backslash, no colon, none of `"`, `*`, `<`, `>`, `?` and `|`,
+ * and no control character, a NUL byte among them; it is at most {@link MAX_WIKI_PAGE_ID_LENGTH} characters,
+ * and each name in it at most 200 bytes in UTF-8; and it is not `index` in any case, the catalog's own id.
+ * Every id the store lists, and every id the default clusterer of `attachMemoryWiki` makes, has this form.
  */
 export declare function isWikiPageId(id: unknown): id is string;
 /**

package/dist/cognition/substrate/memory/wiki/WikiPageId.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WikiPageId.d.ts","sourceRoot":"","sources":["../../../../../src/cognition/substrate/memory/wiki/WikiPageId.ts"],"names":[],"mappings":"AAAA,uHAAuH;AACvH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,mDAAmD;AACnD,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAW3C;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,iBAAiB,GACzB,MAAM,GACN,OAAO,GACP,QAAQ,GACR,WAAW,GACX,SAAS,GACT,KAAK,GACL,MAAM,GACN,UAAU,GACV,SAAS,CAAC;AAwBd,4FAA4F;AAC5F,qBAAa,sBAAuB,SAAQ,KAAK;IAS7C,QAAQ,CAAC,OAAO,EAAE,iBAAiB;IARrC,oEAAoE;IACpE,QAAQ,CAAC,IAAI,0BAA0B;IAEvC;;;OAGG;gBAEQ,OAAO,EAAE,iBAAiB,EACnC,EAAE,EAAE,OAAO;CAKd;AAmBD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,OAAO,GAAG,EAAE,IAAI,MAAM,CAEtD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC,EAAE,IAAI,MAAM,CAGlE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,OAAO,EACX,KAAK,GAAE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,KAAK,CAAQ,GACvD,MAAM,CAOR"}
+{"version":3,"file":"WikiPageId.d.ts","sourceRoot":"","sources":["../../../../../src/cognition/substrate/memory/wiki/WikiPageId.ts"],"names":[],"mappings":"AAAA,uHAAuH;AACvH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AASlC,mDAAmD;AACnD,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAK3C;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,iBAAiB,GACzB,MAAM,GACN,OAAO,GACP,QAAQ,GACR,WAAW,GACX,SAAS,GACT,KAAK,GACL,MAAM,GACN,UAAU,GACV,SAAS,CAAC;AAiBd,4FAA4F;AAC5F,qBAAa,sBAAuB,SAAQ,KAAK;IAS7C,QAAQ,CAAC,OAAO,EAAE,iBAAiB;IARrC,oEAAoE;IACpE,QAAQ,CAAC,IAAI,0BAA0B;IAEvC;;;OAGG;gBAEQ,OAAO,EAAE,iBAAiB,EACnC,EAAE,EAAE,OAAO;CAKd;AAqBD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,OAAO,GAAG,EAAE,IAAI,MAAM,CAEtD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC,EAAE,IAAI,MAAM,CAGlE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,OAAO,EACX,KAAK,GAAE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,KAAK,CAAQ,GACvD,MAAM,CAKR"}

package/dist/cognition/substrate/memory/wiki/WikiPageId.js

@@ -1,33 +1,23 @@
 /** @fileoverview The id rule for wiki pages: an id names a file inside memory/, checked before any file is touched. */
 import * as path from 'node:path';
+import { MAX_PATH_NAME_BYTES, describeRefusedName, isRefusedPathCharacter, pathNameProblem, resolveInsideFolder, } from '../../../../core/utils/pathName.js';
 /** The most characters a wiki page id may hold. */
 export const MAX_WIKI_PAGE_ID_LENGTH = 512;
 /** The id of the catalog file, `index.md`, which the store writes itself and never lists as a page. */
 const CATALOG_ID = 'index';
-/** The backslash's code: a folder separator on Windows. */
-const BACKSLASH = 0x5c;
-/** The colon's code: on Windows it names a drive (`C:page`) or a file's stream (`page:stream`). */
-const COLON = 0x3a;
 /** The part of the rule each problem breaks, as the error message words it. */
 const RULE_BROKEN = {
     type: 'a page id is a string',
     empty: 'a page id is not empty',
-    length: `a page id is at most ${MAX_WIKI_PAGE_ID_LENGTH} characters`,
-    character: 'a page id holds no backslash, no colon and no control character',
+    length: `a page id is at most ${MAX_WIKI_PAGE_ID_LENGTH} characters, ` +
+        `and each name in it at most ${MAX_PATH_NAME_BYTES} bytes in UTF-8`,
+    character: 'a page id holds no backslash, no colon, none of " * < > ? | and no control character',
     segment: 'a page id is names joined by single slashes, with no slash at its start or end',
     dot: 'no name in a page id starts with a dot',
     edge: 'no name in a page id starts or ends with a space or ends with a dot',
     reserved: 'the id index, in any case, names the catalog, index.md, which is not a page',
     outside: "the page's file would be outside the memory folder",
 };
-/** The most characters of a refused id that its error message shows. */
-const SHOWN_ID_CHARACTERS = 64;
-/** The refused id as the message shows it: quoted and escaped, cut to its first characters. */
-function describeId(id) {
-    if (typeof id !== 'string')
-        return `of type ${id === null ? 'null' : typeof id}`;
-    return JSON.stringify(id.length > SHOWN_ID_CHARACTERS ? `${id.slice(0, SHOWN_ID_CHARACTERS)}...` : id);
-}
 /** Thrown when a wiki page id is refused. Nothing is read or written for the refused id. */
 export class InvalidWikiPageIdError extends Error {
     /**
@@ -35,14 +25,17 @@ export class InvalidWikiPageIdError extends Error {
      * @param id - The refused id. The message shows at most its first 64 characters, escaped.
      */
     constructor(problem, id) {
-        super(`wiki page id ${describeId(id)} refused: ${RULE_BROKEN[problem]}`);
+        super(`wiki page id ${describeRefusedName(id)} refused: ${RULE_BROKEN[problem]}`);
         this.problem = problem;
         /** A stable code for callers that branch on the kind of failure. */
         this.code = 'INVALID_WIKI_PAGE_ID';
         this.name = 'InvalidWikiPageIdError';
     }
 }
-/** The part of the id rule `id` breaks, or null when the rule accepts it. */
+/**
+ * The part of the id rule `id` breaks, or null when the rule accepts it. Each name between slashes is held to the
+ * rule every name built from data is held to (`pathNameProblem`), after the whole id is checked.
+ */
 function problemOf(id) {
     if (typeof id !== 'string')
         return 'type';
@@ -51,17 +44,14 @@ function problemOf(id) {
     if (id.length > MAX_WIKI_PAGE_ID_LENGTH)
         return 'length';
     for (let i = 0; i < id.length; i++) {
-        const code = id.charCodeAt(i);
-        if (code <= 0x1f || code === 0x7f || code === BACKSLASH || code === COLON)
+        if (isRefusedPathCharacter(id.charCodeAt(i)))
             return 'character';
     }
     for (const name of id.split('/')) {
-        if (name.length === 0)
-            return 'segment';
-        if (name.startsWith('.'))
-            return 'dot';
-        if (name.startsWith(' ') || name.endsWith(' ') || name.endsWith('.'))
-            return 'edge';
+        const problem = pathNameProblem(name);
+        // An empty name sits between two slashes, or at the id's start or end.
+        if (problem)
+            return problem === 'empty' ? 'segment' : problem;
     }
     return id.toLowerCase() === CATALOG_ID ? 'reserved' : null;
 }
@@ -69,10 +59,10 @@ function problemOf(id) {
  * True when `id` has the wiki's id form: the page's path under `memory/` without `.md`, one or more names
  * joined by `/` (`entities/johnny` is `memory/entities/johnny.md`). No name is empty or starts with a dot,
  * so `.` and `..` are never names, and no name starts or ends with a space or ends with a dot, which
- * Windows drops from a name; the id holds no backslash, no colon and no control character, a NUL
- * byte among them; it is at most {@link MAX_WIKI_PAGE_ID_LENGTH} characters; and it is not `index` in any
- * case, the catalog's own id. Every id the store lists, and every id the default clusterer of
- * `attachMemoryWiki` makes, has this form.
+ * Windows drops from a name; the id holds no backslash, no colon, none of `"`, `*`, `<`, `>`, `?` and `|`,
+ * and no control character, a NUL byte among them; it is at most {@link MAX_WIKI_PAGE_ID_LENGTH} characters,
+ * and each name in it at most 200 bytes in UTF-8; and it is not `index` in any case, the catalog's own id.
+ * Every id the store lists, and every id the default clusterer of `attachMemoryWiki` makes, has this form.
  */
 export function isWikiPageId(id) {
     return problemOf(id) === null;
@@ -101,10 +91,8 @@ export function assertWikiPageId(id) {
  */
 export function resolveWikiPagePath(memoryDir, id, paths = path) {
     assertWikiPageId(id);
-    const root = paths.resolve(memoryDir);
-    const file = paths.resolve(root, `${id}.md`);
-    const inside = root.endsWith(paths.sep) ? root : root + paths.sep;
-    if (!file.startsWith(inside))
+    const file = resolveInsideFolder(memoryDir, [`${id}.md`], paths);
+    if (file === null)
         throw new InvalidWikiPageIdError('outside', id);
     return file;
 }

package/dist/cognition/substrate/memory/wiki/WikiPageId.js.map

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

package/dist/core/utils/linkFreeWrite.d.ts

@@ -0,0 +1,66 @@
+/**
+ * @fileoverview Writing below a folder whose contents another process may change: folders are made one name at a
+ * time and never through a link, and a file is opened for writing never through a link, never waiting, and only
+ * when it is a regular file with one name.
+ *
+ * The Markdown and Obsidian memory exporters write a file per trace below an export folder, and the skill exporter
+ * writes a tool's files below a skills folder. Whoever can write below such a folder could put there a link that
+ * leads elsewhere, a second name for a file elsewhere, or a named pipe that holds a writer up, so both write
+ * through the functions here. The folder itself is the caller's and may be a link. The checks run as each folder
+ * is made and each file opened; Node has no `openat`, so a process that swaps a folder for a link between a check
+ * and the write is outside what they stop.
+ *
+ * @module agentos/core/utils/linkFreeWrite
+ */
+import { type FileHandle } from 'node:fs/promises';
+/**
+ * Why a file was not opened: `link` when a symbolic link holds its place or the file has a second name (a hard
+ * link), and `special` when something other than a regular file holds its place (a folder, a named pipe, a socket,
+ * a device).
+ */
+export type OpenRefusal = 'link' | 'special';
+/** A file open for writing and checked, and the identity of the file the open reached. */
+export interface OpenedFile {
+    /** The open file. Nothing has been emptied or written. */
+    handle: FileHandle;
+    /**
+     * The file's device and inode numbers, or null when the file system reports an inode of 0, which names no file.
+     * Two names that open one file give the same identity.
+     */
+    identity: string | null;
+}
+/**
+ * Make the folders `relative` names under `root`, one name at a time, and stop at a link. A folder this makes is
+ * never a link, so a file written into it stays under `root`.
+ *
+ * @param root     - The folder the others are made in. It may itself be a link.
+ * @param relative - The folders' path under `root`.
+ * @returns True when every folder is in place and none of them is a link.
+ */
+export declare function makeFoldersOutsideLinks(root: string, relative: string): Promise<boolean>;
+/**
+ * Look at a file's place without opening it. A caller that writes several files, all of them or none, looks at
+ * every place before it opens any file, so a refusal makes no file. The look does not see a change made after it;
+ * {@link openFileOutsideLinks} checks again.
+ *
+ * @param file - Absolute path of the file.
+ * @returns `link` when a symbolic link holds the place or the file there has a second name, `special` when
+ *   something other than a regular file holds it, or null when the place is free or holds a regular file with one
+ *   name.
+ * @throws Any error the look meets other than a missing file.
+ */
+export declare function lookOutsideLinks(file: string): Promise<OpenRefusal | null>;
+/**
+ * Open a file for writing, in a folder already made, and check what the open reached. A symbolic link in the
+ * file's place is refused before the open, and where the platform has `O_NOFOLLOW` the open refuses one put there
+ * since. A folder fails the open, and where the platform has `O_NONBLOCK` so does a named pipe that no process
+ * reads, at once. An open file that is not a regular file (a named pipe that a process reads, a device) is refused,
+ * and so is a file with a second name (a hard link), which is the same file as that name and may lie outside the
+ * folder. Nothing is emptied or written here; a refused file is closed.
+ *
+ * @param file - Absolute path of the file.
+ * @returns The open file and its identity, or the refusal.
+ * @throws Any other error the look or the open meets.
+ */
+export declare function openFileOutsideLinks(file: string): Promise<OpenedFile | OpenRefusal>;
+//# sourceMappingURL=linkFreeWrite.d.ts.map

package/dist/core/utils/linkFreeWrite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linkFreeWrite.d.ts","sourceRoot":"","sources":["../../../src/core/utils/linkFreeWrite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAW,EAAE,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AA2BvD;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC;AAE7C,0FAA0F;AAC1F,MAAM,WAAW,UAAU;IACzB,0DAA0D;IAC1D,MAAM,EAAE,UAAU,CAAC;IACnB;;;OAGG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAkB9F;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAMhF;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,WAAW,CAAC,CAmB1F"}