@framers/agentos 0.13.65 → 0.13.67

package/dist/cognition/emergent/SkillExporter.js

@@ -15,10 +15,21 @@
  * - `writeSkillFile()` — writes a single SKILL.md to disk
  * - `exportToolAsSkillPack()` — writes both SKILL.md and CAPABILITY.yaml (a full
  *   capability directory ready for scanner pickup)
+ *
+ * The two that write name the tool's folder after the tool, so they hold the
+ * name to the rule every name built from data meets and write only when the
+ * folder resolves inside the output directory (`resolveToolFolder`). A tool
+ * whose name fails either check is refused with an `InvalidToolNameError`
+ * before any folder is made or file written. Below the output directory they
+ * make the tool's folder and write its files never through a link, and only
+ * into regular files with one name (`core/utils/linkFreeWrite`); anything else
+ * there is refused with a `SkillExportRefusedError`, and nothing is written.
  */
 import * as fs from 'node:fs/promises';
 import * as path from 'node:path';
 import YAML from 'yaml';
+import { lookOutsideLinks, makeFoldersOutsideLinks, openFileOutsideLinks, } from '../../core/utils/linkFreeWrite.js';
+import { resolveToolFolder } from './ToolName.js';
 // ============================================================================
 // FRONTMATTER HELPERS
 // ============================================================================
@@ -276,16 +287,113 @@ export function buildCapabilityYaml(tool) {
 // ============================================================================
 // FILE I/O
 // ============================================================================
+/**
+ * Thrown by `writeSkillFile` and `exportToolAsSkillPack` when something below
+ * the output directory is not written through: a symbolic link at the tool's
+ * folder or at one of its files, a second name (a hard link) for one of its
+ * files, or anything but a regular file at a file's place. Nothing is written.
+ */
+export class SkillExportRefusedError extends Error {
+    /**
+     * @param problem - `link` for a symbolic link or a second name, `special` for anything but a regular file.
+     * @param target - The absolute path of the folder or file refused.
+     */
+    constructor(problem, target) {
+        super(`skill export refused: ${problem === 'link' ? 'a link' : 'something other than a regular file'} is at ${target}`);
+        this.problem = problem;
+        this.target = target;
+        /** A stable code for callers that branch on the kind of failure. */
+        this.code = 'SKILL_EXPORT_REFUSED';
+        this.name = 'SkillExportRefusedError';
+    }
+}
+/**
+ * Write a tool's files into its own folder under `outputDir`, all of them or
+ * none. The folder is resolved by `resolveToolFolder`, which refuses a name that
+ * is not a safe folder name or a folder outside `outputDir`. The output
+ * directory is the caller's: it is made when missing and used as it is, even
+ * when it is a link. Below it, the tool's folder is made never through a link;
+ * every file's place is looked at before any file is opened, and every file is
+ * opened and checked before any is written.
+ *
+ * @param tool - The tool whose files are written.
+ * @param outputDir - The folder the tool's folder is made in.
+ * @param files - Each file's name in the tool's folder and its content.
+ * @returns The absolute path of each file, in the order given.
+ * @throws {InvalidToolNameError} When the name is refused. Nothing is written.
+ * @throws {SkillExportRefusedError} When a link or anything but a regular file
+ *   is in the way. Nothing is written.
+ */
+async function writeToolFiles(tool, outputDir, files) {
+    const folder = resolveToolFolder(outputDir, tool.name);
+    const root = path.resolve(outputDir);
+    await fs.mkdir(root, { recursive: true });
+    if (!(await makeFoldersOutsideLinks(root, path.relative(root, folder)))) {
+        throw new SkillExportRefusedError('link', folder);
+    }
+    // Every file's place is looked at before any file is opened, so a link or a special file already there refuses
+    // the export before an open makes a missing file.
+    const paths = files.map((file) => path.join(folder, file.name));
+    for (const file of paths) {
+        const refusal = await lookOutsideLinks(file);
+        if (refusal)
+            throw new SkillExportRefusedError(refusal, file);
+    }
+    const opened = await Promise.allSettled(paths.map((file) => openFileOutsideLinks(file)));
+    const handles = [];
+    for (const outcome of opened) {
+        if (outcome.status !== 'fulfilled')
+            continue;
+        const value = outcome.value;
+        if (typeof value !== 'string')
+            handles.push(value.handle);
+    }
+    let failure;
+    try {
+        const ready = [];
+        for (let index = 0; index < opened.length; index++) {
+            const outcome = opened[index];
+            if (outcome.status === 'rejected')
+                throw outcome.reason;
+            const value = outcome.value;
+            if (typeof value === 'string')
+                throw new SkillExportRefusedError(value, paths[index]);
+            ready.push({ handle: value.handle, content: files[index].content });
+        }
+        await Promise.all(ready.map(async ({ handle, content }) => {
+            await handle.truncate(0);
+            await handle.writeFile(content, 'utf8');
+        }));
+    }
+    catch (error) {
+        failure = { error };
+    }
+    // A file whose close fails may not hold what was written, so that fails the export too.
+    for (const closed of await Promise.allSettled(handles.map((handle) => handle.close()))) {
+        if (closed.status === 'rejected')
+            failure ?? (failure = { error: closed.reason });
+    }
+    if (failure)
+        throw failure.error;
+    return paths;
+}
 /**
  * Writes a SKILL.md file to disk for an emergent tool.
  *
  * Creates the output directory if it does not exist. The file is written to
- * `<outputDir>/<tool.name>/SKILL.md`.
+ * `<outputDir>/<tool.name>/SKILL.md`. The tool's name must be a safe folder
+ * name and its folder must resolve inside `outputDir`, and below `outputDir`
+ * the file is written through no link and only into a regular file; otherwise
+ * nothing is written.
  *
  * @param tool - The emergent tool to export.
  * @param outputDir - Base directory where the skill subdirectory will be created.
  * @returns Absolute path to the written SKILL.md file.
  *
+ * @throws {InvalidToolNameError} If the tool's name is not a safe folder name
+ *   or its folder would lie outside `outputDir`. Nothing is written.
+ * @throws {SkillExportRefusedError} If a link, a second name or anything but a
+ *   regular file is at the tool's folder or at SKILL.md. Nothing is written.
  * @throws {Error} If the filesystem write fails (permissions, disk full, etc.).
  *
  * @example
@@ -295,11 +403,9 @@ export function buildCapabilityYaml(tool) {
  * ```
  */
 export async function writeSkillFile(tool, outputDir) {
-    const skillDir = path.join(outputDir, tool.name);
-    await fs.mkdir(skillDir, { recursive: true });
-    const skillPath = path.join(skillDir, 'SKILL.md');
-    const content = exportToolAsSkill(tool);
-    await fs.writeFile(skillPath, content, 'utf-8');
+    const [skillPath] = await writeToolFiles(tool, outputDir, [
+        { name: 'SKILL.md', content: exportToolAsSkill(tool) },
+    ]);
     return skillPath;
 }
 /**
@@ -309,12 +415,19 @@ export async function writeSkillFile(tool, outputDir) {
  * files. This directory structure is compatible with the
  * capability manifest scanner and can be placed in any scan directory
  * (`~/.wunderland/capabilities/`, `./.wunderland/capabilities/`, etc.) for
- * automatic discovery.
+ * automatic discovery. The tool's name must be a safe folder name and its
+ * folder must resolve inside `outputDir`, and below `outputDir` the files are
+ * written through no link and only into regular files; otherwise nothing is
+ * written.
  *
  * @param tool - The emergent tool to export.
  * @param outputDir - Base directory where the skill subdirectory will be created.
- * @returns Paths to the written SKILL.md and CAPABILITY.yaml files.
+ * @returns Absolute paths to the written SKILL.md and CAPABILITY.yaml files.
  *
+ * @throws {InvalidToolNameError} If the tool's name is not a safe folder name
+ *   or its folder would lie outside `outputDir`. Nothing is written.
+ * @throws {SkillExportRefusedError} If a link, a second name or anything but a
+ *   regular file is at the tool's folder or at either file. Nothing is written.
  * @throws {Error} If the filesystem writes fail (permissions, disk full, etc.).
  *
  * @example
@@ -328,16 +441,9 @@ export async function writeSkillFile(tool, outputDir) {
  * ```
  */
 export async function exportToolAsSkillPack(tool, outputDir) {
-    const skillDir = path.join(outputDir, tool.name);
-    await fs.mkdir(skillDir, { recursive: true });
-    // Write both files in parallel — they are independent
-    const skillContent = exportToolAsSkill(tool);
-    const capabilityContent = buildCapabilityYaml(tool);
-    const skillPath = path.join(skillDir, 'SKILL.md');
-    const capabilityPath = path.join(skillDir, 'CAPABILITY.yaml');
-    await Promise.all([
-        fs.writeFile(skillPath, skillContent, 'utf-8'),
-        fs.writeFile(capabilityPath, capabilityContent, 'utf-8'),
+    const [skillPath, capabilityPath] = await writeToolFiles(tool, outputDir, [
+        { name: 'SKILL.md', content: exportToolAsSkill(tool) },
+        { name: 'CAPABILITY.yaml', content: buildCapabilityYaml(tool) },
     ]);
     return { skillPath, capabilityPath };
 }

package/dist/cognition/emergent/SkillExporter.js.map

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

package/dist/cognition/emergent/ToolName.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @fileoverview The name rule for a forged tool, and the folder a tool is exported to.
+ *
+ * A model names the tool it forges, and the skill exporter names a folder after the tool. The forge holds the name
+ * to the rule every name built from data meets (`pathNameProblem` in `core/utils/pathName`) and to an identifier
+ * pattern. The exporter checks the name against the first rule again and writes only inside its output folder, so
+ * a tool the forge did not check, such as one loaded from a stored row or one a host builds itself, is checked as
+ * well.
+ *
+ * @module agentos/emergent/ToolName
+ */
+import * as path from 'node:path';
+import { type PathNameProblem } from '../../core/utils/pathName.js';
+/**
+ * The identifier pattern for a name a model gives: a forged tool's name, and a synthesised agent's role
+ * (`EmergentAgentForge`), which names its `delegate_to_<role>` tool. An ASCII letter, then ASCII letters, digits,
+ * underscores and hyphens.
+ */
+export declare const IDENTIFIER_PATTERN: RegExp;
+/**
+ * Why a tool's name was refused:
+ * - `'type'`: the name is not a string.
+ * - `'empty'`, `'character'`, `'dot'`, `'edge'` and `'length'`: the name breaks the rule every name built from
+ *   data meets (`PathNameProblem` in `core/utils/pathName`). It is empty; it holds a slash, a backslash, a colon,
+ *   one of `"`, `*`, `<`, `>`, `?` and `|`, or a control character; it starts with a dot; it starts or ends with a
+ *   space, or ends with a dot; or it holds more than 200 bytes in UTF-8.
+ * - `'identifier'`: the forge's own rule. The name is not an ASCII letter followed by ASCII letters, digits,
+ *   underscores and hyphens ({@link IDENTIFIER_PATTERN}).
+ * - `'outside'`: the tool's folder would not lie inside the output folder.
+ */
+export type ToolNameProblem = 'type' | PathNameProblem | 'identifier' | 'outside';
+/** Reported or thrown when a tool's name is refused. Nothing is forged or written for the refused name. */
+export declare class InvalidToolNameError extends Error {
+    readonly problem: ToolNameProblem;
+    /** A stable code for callers that branch on the kind of failure. */
+    readonly code = "INVALID_TOOL_NAME";
+    /**
+     * @param problem - The part of the name rule the name breaks.
+     * @param name - The refused name. The message shows at most its first 64 characters, escaped.
+     */
+    constructor(problem: ToolNameProblem, name: unknown);
+}
+/**
+ * The part of the forge's name rule `name` breaks, or null when a tool may be forged under it. The name is held to
+ * the rule every name built from data meets, then to {@link IDENTIFIER_PATTERN}. A name the forge accepts is
+ * therefore one the skill exporter accepts.
+ *
+ * @param name - The name a forge request gives the tool.
+ */
+export declare function forgedToolNameProblem(name: unknown): ToolNameProblem | null;
+/**
+ * The folder that a tool named `name` is exported to under `outputDir`, resolved. The name is held to the rule
+ * every name built from data meets. Then the resolved folder must lie inside the resolved output folder, a second
+ * guard should a platform's path rules ever place the folder of an accepted name elsewhere.
+ *
+ * @param outputDir - The folder the tool's own folder is made in.
+ * @param name - The tool's name.
+ * @param paths - The path functions to resolve with: the platform's by default, `path.win32` or `path.posix` to pick one.
+ * @returns The absolute path of the tool's folder.
+ * @throws InvalidToolNameError when the name is refused or its folder would be outside `outputDir`.
+ */
+export declare function resolveToolFolder(outputDir: string, name: unknown, paths?: Pick<path.PlatformPath, 'resolve' | 'sep'>): string;
+//# sourceMappingURL=ToolName.d.ts.map

package/dist/cognition/emergent/ToolName.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolName.d.ts","sourceRoot":"","sources":["../../../src/cognition/emergent/ToolName.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAKL,KAAK,eAAe,EACrB,MAAM,8BAA8B,CAAC;AAEtC;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,QAA6B,CAAC;AAE7D;;;;;;;;;;GAUG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,eAAe,GAAG,YAAY,GAAG,SAAS,CAAC;AAclF,2GAA2G;AAC3G,qBAAa,oBAAqB,SAAQ,KAAK;IAS3C,QAAQ,CAAC,OAAO,EAAE,eAAe;IARnC,oEAAoE;IACpE,QAAQ,CAAC,IAAI,uBAAuB;IAEpC;;;OAGG;gBAEQ,OAAO,EAAE,eAAe,EACjC,IAAI,EAAE,OAAO;CAKhB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAG3E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,OAAO,EACb,KAAK,GAAE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,KAAK,CAAQ,GACvD,MAAM,CAOR"}

package/dist/cognition/emergent/ToolName.js

@@ -0,0 +1,79 @@
+/**
+ * @fileoverview The name rule for a forged tool, and the folder a tool is exported to.
+ *
+ * A model names the tool it forges, and the skill exporter names a folder after the tool. The forge holds the name
+ * to the rule every name built from data meets (`pathNameProblem` in `core/utils/pathName`) and to an identifier
+ * pattern. The exporter checks the name against the first rule again and writes only inside its output folder, so
+ * a tool the forge did not check, such as one loaded from a stored row or one a host builds itself, is checked as
+ * well.
+ *
+ * @module agentos/emergent/ToolName
+ */
+import * as path from 'node:path';
+import { MAX_PATH_NAME_BYTES, describeRefusedName, pathNameProblem, resolveInsideFolder, } from '../../core/utils/pathName.js';
+/**
+ * The identifier pattern for a name a model gives: a forged tool's name, and a synthesised agent's role
+ * (`EmergentAgentForge`), which names its `delegate_to_<role>` tool. An ASCII letter, then ASCII letters, digits,
+ * underscores and hyphens.
+ */
+export const IDENTIFIER_PATTERN = /^[a-zA-Z][a-zA-Z0-9_-]*$/;
+/** The part of the rule each problem breaks, as the error message words it. */
+const RULE_BROKEN = {
+    type: 'a tool name is a string',
+    empty: 'a tool name is not empty',
+    character: 'a tool name holds no slash, no backslash, no colon, none of " * < > ? | and no control character',
+    dot: 'a tool name does not start with a dot',
+    edge: 'a tool name does not start or end with a space, or end with a dot',
+    length: `a tool name is at most ${MAX_PATH_NAME_BYTES} bytes in UTF-8`,
+    identifier: 'a forged tool name is an ASCII letter followed by ASCII letters, digits, underscores and hyphens',
+    outside: "the tool's folder would be outside the output folder",
+};
+/** Reported or thrown when a tool's name is refused. Nothing is forged or written for the refused name. */
+export class InvalidToolNameError extends Error {
+    /**
+     * @param problem - The part of the name rule the name breaks.
+     * @param name - The refused name. The message shows at most its first 64 characters, escaped.
+     */
+    constructor(problem, name) {
+        super(`tool name ${describeRefusedName(name)} refused: ${RULE_BROKEN[problem]}`);
+        this.problem = problem;
+        /** A stable code for callers that branch on the kind of failure. */
+        this.code = 'INVALID_TOOL_NAME';
+        this.name = 'InvalidToolNameError';
+    }
+}
+/**
+ * The part of the forge's name rule `name` breaks, or null when a tool may be forged under it. The name is held to
+ * the rule every name built from data meets, then to {@link IDENTIFIER_PATTERN}. A name the forge accepts is
+ * therefore one the skill exporter accepts.
+ *
+ * @param name - The name a forge request gives the tool.
+ */
+export function forgedToolNameProblem(name) {
+    if (typeof name !== 'string')
+        return 'type';
+    return pathNameProblem(name) ?? (IDENTIFIER_PATTERN.test(name) ? null : 'identifier');
+}
+/**
+ * The folder that a tool named `name` is exported to under `outputDir`, resolved. The name is held to the rule
+ * every name built from data meets. Then the resolved folder must lie inside the resolved output folder, a second
+ * guard should a platform's path rules ever place the folder of an accepted name elsewhere.
+ *
+ * @param outputDir - The folder the tool's own folder is made in.
+ * @param name - The tool's name.
+ * @param paths - The path functions to resolve with: the platform's by default, `path.win32` or `path.posix` to pick one.
+ * @returns The absolute path of the tool's folder.
+ * @throws InvalidToolNameError when the name is refused or its folder would be outside `outputDir`.
+ */
+export function resolveToolFolder(outputDir, name, paths = path) {
+    if (typeof name !== 'string')
+        throw new InvalidToolNameError('type', name);
+    const problem = pathNameProblem(name);
+    if (problem)
+        throw new InvalidToolNameError(problem, name);
+    const folder = resolveInsideFolder(outputDir, [name], paths);
+    if (folder === null)
+        throw new InvalidToolNameError('outside', name);
+    return folder;
+}
+//# sourceMappingURL=ToolName.js.map

package/dist/cognition/emergent/ToolName.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolName.js","sourceRoot":"","sources":["../../../src/cognition/emergent/ToolName.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,mBAAmB,GAEpB,MAAM,8BAA8B,CAAC;AAEtC;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,0BAA0B,CAAC;AAe7D,+EAA+E;AAC/E,MAAM,WAAW,GAAoC;IACnD,IAAI,EAAE,yBAAyB;IAC/B,KAAK,EAAE,0BAA0B;IACjC,SAAS,EAAE,kGAAkG;IAC7G,GAAG,EAAE,uCAAuC;IAC5C,IAAI,EAAE,mEAAmE;IACzE,MAAM,EAAE,0BAA0B,mBAAmB,iBAAiB;IACtE,UAAU,EAAE,kGAAkG;IAC9G,OAAO,EAAE,sDAAsD;CAChE,CAAC;AAEF,2GAA2G;AAC3G,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAI7C;;;OAGG;IACH,YACW,OAAwB,EACjC,IAAa;QAEb,KAAK,CAAC,aAAa,mBAAmB,CAAC,IAAI,CAAC,aAAa,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAHxE,YAAO,GAAP,OAAO,CAAiB;QARnC,oEAAoE;QAC3D,SAAI,GAAG,mBAAmB,CAAC;QAWlC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAa;IACjD,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC;IAC5C,OAAO,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;AACxF,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAC/B,SAAiB,EACjB,IAAa,EACb,QAAoD,IAAI;IAExD,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,MAAM,IAAI,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC3E,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,OAAO;QAAE,MAAM,IAAI,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;IAC7D,IAAI,MAAM,KAAK,IAAI;QAAE,MAAM,IAAI,oBAAoB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACrE,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/cognition/emergent/index.d.ts

@@ -35,7 +35,9 @@ export { EmergentCapabilityEngine } from './EmergentCapabilityEngine.js';
 export type { EmergentCapabilityEngineDeps, EmergentExecutableTool, FailedToolLoad, LoadedToolOutcome, LoadPersistedToolsOptions, LoadPersistedToolsResult, } from './EmergentCapabilityEngine.js';
 export { ForgeToolMetaTool } from './ForgeToolMetaTool.js';
 export type { ForgeToolInput } from './ForgeToolMetaTool.js';
-export { exportToolAsSkill, buildCapabilityYaml, writeSkillFile, exportToolAsSkillPack, } from './SkillExporter.js';
+export { exportToolAsSkill, buildCapabilityYaml, writeSkillFile, exportToolAsSkillPack, SkillExportRefusedError, } from './SkillExporter.js';
+export { InvalidToolNameError } from './ToolName.js';
+export type { ToolNameProblem } from './ToolName.js';
 export { AdaptPersonalityTool } from './AdaptPersonalityTool.js';
 export { ManageSkillsTool } from './ManageSkillsTool.js';
 export { CreateWorkflowTool } from './CreateWorkflowTool.js';

package/dist/cognition/emergent/index.d.ts.map

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

package/dist/cognition/emergent/index.js

@@ -25,7 +25,8 @@ export { EMERGENT_TOOL_PACKAGE_SCHEMA_VERSION, buildEmergentToolPackage, seriali
 export { EmergentJudge } from './EmergentJudge.js';
 export { EmergentCapabilityEngine } from './EmergentCapabilityEngine.js';
 export { ForgeToolMetaTool } from './ForgeToolMetaTool.js';
-export { exportToolAsSkill, buildCapabilityYaml, writeSkillFile, exportToolAsSkillPack, } from './SkillExporter.js';
+export { exportToolAsSkill, buildCapabilityYaml, writeSkillFile, exportToolAsSkillPack, SkillExportRefusedError, } from './SkillExporter.js';
+export { InvalidToolNameError } from './ToolName.js';
 export { AdaptPersonalityTool } from './AdaptPersonalityTool.js';
 export { ManageSkillsTool } from './ManageSkillsTool.js';
 export { CreateWorkflowTool } from './CreateWorkflowTool.js';

package/dist/cognition/emergent/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cognition/emergent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAA8B,+BAA+B,EAAE,MAAM,4BAA4B,CAAC;AACzG,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAElH,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAE1G,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC5G,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhI,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAKjE,OAAO,EACL,oCAAoC,EACpC,wBAAwB,EACxB,4BAA4B,EAC5B,wBAAwB,EACxB,kCAAkC,GACnC,MAAM,kBAAkB,CAAC;AAQ1B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AASzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAIzE,qEAAqE;AACrE,wEAAwE;AACxE,mEAAmE;AACnE,eAAe;AACf,OAAO,EACL,sBAAsB,GAEvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,kBAAkB,GAEnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,wBAAwB,GAEzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,aAAa,GAId,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,oBAAoB,EACpB,eAAe,GAEhB,MAAM,2BAA2B,CAAC;AAEnC,oEAAoE;AACpE,0EAA0E;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAM7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cognition/emergent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAA8B,+BAA+B,EAAE,MAAM,4BAA4B,CAAC;AACzG,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAElH,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAE1G,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC5G,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhI,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAKjE,OAAO,EACL,oCAAoC,EACpC,wBAAwB,EACxB,4BAA4B,EAC5B,wBAAwB,EACxB,kCAAkC,GACnC,MAAM,kBAAkB,CAAC;AAQ1B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AASzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAIzE,qEAAqE;AACrE,wEAAwE;AACxE,mEAAmE;AACnE,eAAe;AACf,OAAO,EACL,sBAAsB,GAEvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,kBAAkB,GAEnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,wBAAwB,GAEzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,aAAa,GAId,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,oBAAoB,EACpB,eAAe,GAEhB,MAAM,2BAA2B,CAAC;AAEnC,oEAAoE;AACpE,0EAA0E;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAM7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/cognition/memory/io/MarkdownExporter.d.ts

@@ -13,11 +13,14 @@
  * to the name rule in `core/utils/pathName` before anything is written, and the
  * file's resolved path must lie inside the export folder. Below the export
  * folder no folder or file is made or written through a link, symbolic or
- * hard, and two traces whose files would be one where names ignore case are
- * not both written. A trace that fails any of these is left out and reported
- * in the export's result. The checks run as each folder is made and each file
- * opened; Node has no `openat`, so a process that swaps a folder below the
- * export folder for a link while the export runs is outside what they stop.
+ * hard, and nothing but a regular file is written, a named pipe at a file's
+ * place refused at once, never waited on (`core/utils/linkFreeWrite`). Two
+ * traces whose files would be one, where names ignore case or by the file
+ * system's own reckoning, are not both written. A trace that fails any of these is left
+ * out and reported in the export's result. The checks run as each folder is
+ * made and each file opened; Node has no `openat`, so a process that swaps a
+ * folder below the export folder for a link while the export runs is outside
+ * what they stop.
  *
  * ## Folder layout
  * ```
@@ -47,6 +50,11 @@ interface TraceRow {
     created_at: number;
     tags: string;
 }
+/**
+ * The most trace files one export holds open at once. The files are opened, checked and written a batch of this many
+ * at a time, in export order, so a large export does not run out of file descriptors.
+ */
+export declare const MAX_OPEN_TRACE_FILES = 64;
 /**
  * Exports memory traces as Markdown files with YAML front-matter.
  *
@@ -69,13 +77,19 @@ export declare class MarkdownExporter {
      * written, and is reported in the result, when its scope, type or id is not
      * a safe file or folder name, when its file would lie outside `outputDir`,
      * when a folder or file in its place under `outputDir` is a symbolic link or
-     * its file has a second name (a hard link), or when an older trace's file is
-     * the same file where names ignore case. Every other trace is written.
+     * its file has a second name (a hard link), when something other than a
+     * regular file holds its file's place (a folder, a named pipe, a socket, a
+     * device), or when an older trace's file is the same file, where names
+     * ignore case or by the file system's own reckoning. Every other trace is
+     * written. At most {@link MAX_OPEN_TRACE_FILES} files are open at once.
      *
      * @param outputDir - Root directory to write the Markdown vault into.
      * @param _options  - Optional export configuration (currently unused but
      *   accepted for API consistency with other exporters).
      * @returns The traces left out, with the reason for each.
+     * @throws The first error met opening or writing a file for a reason other
+     *   than the refusals above, such as a full disk, once every other trace has
+     *   been tried.
      */
     export(outputDir: string, _options?: ExportOptions): Promise<ExportResult>;
     /**
@@ -112,18 +126,14 @@ export declare class MarkdownExporter {
      */
     private _placeTrace;
     /**
-     * Write a single trace to disk, into a folder already made, and never
-     * through a link. 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 file with a second name (a hard link) is the same file as
-     * that name, which may be outside the export folder, so the open file is
-     * refused before it is emptied.
+     * Write a trace into its file, opened and checked by `openFileOutsideLinks`
+     * and claimed for this trace alone: the content is built, then the file is
+     * emptied and written.
      *
-     * @param file  - Absolute path of the trace's file, inside the output directory.
-     * @param trace - Trace row to serialise.
-     * @returns The refusal when a link holds the file's place, or null once the file is written.
+     * @param handle - The trace's open file.
+     * @param trace  - Trace row to serialise.
      */
-    private _writeTrace;
+    private _fillTrace;
 }
 export {};
 //# sourceMappingURL=MarkdownExporter.d.ts.map

package/dist/cognition/memory/io/MarkdownExporter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MarkdownExporter.d.ts","sourceRoot":"","sources":["../../../../src/cognition/memory/io/MarkdownExporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAsB,MAAM,mBAAmB,CAAC;AACzF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAQzD,oDAAoD;AACpD,UAAU,QAAQ;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAiCD;;;;;;;;GAQG;AACH,qBAAa,gBAAgB;IAIf,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK;IAH3C;;OAEG;gBAC4B,KAAK,EAAE,KAAK;IAM3C;;;;;;;;;;;;;;OAcG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAwDhF;;;;;;;;OAQG;IACH,SAAS,CAAC,gBAAgB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM;IAoBnD;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,iBAAiB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM;IAQpD;;;;;;;OAOG;IACH,OAAO,CAAC,WAAW;IAWnB;;;;;;;;;;;OAWG;YACW,WAAW;CAiB1B"}
+{"version":3,"file":"MarkdownExporter.d.ts","sourceRoot":"","sources":["../../../../src/cognition/memory/io/MarkdownExporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAsB,MAAM,mBAAmB,CAAC;AACzF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AASzD,oDAAoD;AACpD,UAAU,QAAQ;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAKD;;;GAGG;AACH,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAiBvC;;;;;;;;GAQG;AACH,qBAAa,gBAAgB;IAIf,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK;IAH3C;;OAEG;gBAC4B,KAAK,EAAE,KAAK;IAM3C;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAyGhF;;;;;;;;OAQG;IACH,SAAS,CAAC,gBAAgB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM;IAoBnD;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,iBAAiB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM;IAQpD;;;;;;;OAOG;IACH,OAAO,CAAC,WAAW;IAWnB;;;;;;;OAOG;YACW,UAAU;CAKzB"}