@namzu/sdk 0.5.0 → 1.0.0

package/dist/session/workspace/shared-run.d.ts

@@ -0,0 +1,81 @@
+import type { SharedRunWorkspaceAgentRecord, SharedRunWorkspaceManifest, SharedRunWorkspacePlan, SharedRunWorkspaceRefs, SharedRunWorkspaceSource } from '../../types/workspace/shared-run.js';
+export interface SharedRunWorkspaceConfig {
+    /**
+     * Host-visible `_work` directory. The runtime creates and mutates files
+     * here before/while agents execute.
+     */
+    hostRoot: string;
+    /**
+     * Agent-visible `_work` directory. In container sandboxes this is usually
+     * `/mnt/user-data/outputs/_work`; in local mode it can be the same
+     * relative path agents receive in their runtime notes.
+     */
+    runtimeRoot?: string;
+    label?: string;
+    now?: Date;
+}
+export interface RegisterSharedRunPlanInput {
+    id?: string;
+    briefText: string;
+    status?: SharedRunWorkspacePlan['status'];
+}
+export declare class SharedRunWorkspace {
+    private readonly config;
+    readonly hostRoot: string;
+    readonly runtimeRoot: string;
+    private manifestWriteQueue;
+    private constructor();
+    static create(config: SharedRunWorkspaceConfig): Promise<SharedRunWorkspace>;
+    refs(): SharedRunWorkspaceRefs;
+    hostPath(...segments: string[]): string;
+    runtimePath(...segments: string[]): string;
+    ensure(): Promise<void>;
+    readManifest(): Promise<SharedRunWorkspaceManifest>;
+    writeManifest(update: (manifest: SharedRunWorkspaceManifest) => SharedRunWorkspaceManifest): Promise<SharedRunWorkspaceManifest>;
+    writeSourceInventory(sources: readonly SharedRunWorkspaceSource[]): Promise<string>;
+    /**
+     * Write the canonical task-context file (`_work/01_task_context.md`).
+     * This is the single place the original user request lives in full; child
+     * workers read this path instead of receiving the request inline in their
+     * prompts.
+     */
+    writeTaskContext(text: string): Promise<string>;
+    /**
+     * Write the shared coordination packet (`_work/02_shared_context.md`).
+     * This is intentionally smaller and more operational than the task context:
+     * workers read it first, then open the full task context or source inventory
+     * only when their assignment needs raw wording or source-file details.
+     */
+    writeSharedContext(text: string): Promise<string>;
+    /**
+     * Write a per-worker brief at `agents/<agentId>/<taskId>/00_brief.md`.
+     * Returns the runtime-visible path. Pair with `registerAgentWork` so the
+     * agent record and the brief sit under the same scratch directory.
+     */
+    writeAgentBrief(input: {
+        agentId: string;
+        taskId?: string;
+        briefText: string;
+    }): Promise<string>;
+    /**
+     * Append a section to an existing per-worker brief, creating the file if
+     * it doesn't yet exist. Use for follow-up turns / continue flows so the
+     * brief stays authoritative across resumes — workers re-reading the brief
+     * on every entry will see the latest assignment delta, not just the seed
+     * text from initial dispatch.
+     */
+    appendAgentBrief(input: {
+        agentId: string;
+        taskId?: string;
+        sectionText: string;
+    }): Promise<string>;
+    seedSupervisorBrief(input: RegisterSharedRunPlanInput): Promise<string>;
+    registerAgentWork(input: {
+        agentId: string;
+        taskId?: string;
+        status?: SharedRunWorkspaceAgentRecord['status'];
+    }): Promise<string>;
+    private initialManifest;
+    private nowIso;
+}
+//# sourceMappingURL=shared-run.d.ts.map

package/dist/session/workspace/shared-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-run.d.ts","sourceRoot":"","sources":["../../../src/session/workspace/shared-run.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACX,6BAA6B,EAC7B,0BAA0B,EAC1B,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,MAAM,qCAAqC,CAAA;AAE5C,MAAM,WAAW,wBAAwB;IACxC;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,IAAI,CAAA;CACV;AAED,MAAM,WAAW,0BAA0B;IAC1C,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,sBAAsB,CAAC,QAAQ,CAAC,CAAA;CACzC;AAED,qBAAa,kBAAkB;IAKV,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJ3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,OAAO,CAAC,kBAAkB,CAAmC;IAE7D,OAAO;WAKM,MAAM,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAWlF,IAAI,IAAI,sBAAsB;IAY9B,QAAQ,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM;IAIvC,WAAW,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM;IAKpC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IASvB,YAAY,IAAI,OAAO,CAAC,0BAA0B,CAAC;IAMnD,aAAa,CAClB,MAAM,EAAE,CAAC,QAAQ,EAAE,0BAA0B,KAAK,0BAA0B,GAC1E,OAAO,CAAC,0BAA0B,CAAC;IAmBhC,oBAAoB,CAAC,OAAO,EAAE,SAAS,wBAAwB,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IA+BzF;;;;;OAKG;IACG,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAOrD;;;;;OAKG;IACG,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAOvD;;;;OAIG;IACG,eAAe,CAAC,KAAK,EAAE;QAC5B,OAAO,EAAE,MAAM,CAAA;QACf,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,SAAS,EAAE,MAAM,CAAA;KACjB,GAAG,OAAO,CAAC,MAAM,CAAC;IAQnB;;;;;;OAMG;IACG,gBAAgB,CAAC,KAAK,EAAE;QAC7B,OAAO,EAAE,MAAM,CAAA;QACf,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,WAAW,EAAE,MAAM,CAAA;KACnB,GAAG,OAAO,CAAC,MAAM,CAAC;IAcb,mBAAmB,CAAC,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,MAAM,CAAC;IAoBvE,iBAAiB,CAAC,KAAK,EAAE;QAC9B,OAAO,EAAE,MAAM,CAAA;QACf,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,MAAM,CAAC,EAAE,6BAA6B,CAAC,QAAQ,CAAC,CAAA;KAChD,GAAG,OAAO,CAAC,MAAM,CAAC;IAmBnB,OAAO,CAAC,eAAe;IAsBvB,OAAO,CAAC,MAAM;CAGd"}

package/dist/session/workspace/shared-run.js

@@ -0,0 +1,251 @@
+import { mkdir, readFile, rename, writeFile } from 'node:fs/promises';
+import { dirname, join, normalize, relative, sep } from 'node:path';
+import { posix } from 'node:path';
+export class SharedRunWorkspace {
+    config;
+    hostRoot;
+    runtimeRoot;
+    manifestWriteQueue = Promise.resolve();
+    constructor(config) {
+        this.config = config;
+        this.hostRoot = config.hostRoot;
+        this.runtimeRoot = trimTrailingSlash(config.runtimeRoot);
+    }
+    static async create(config) {
+        const workspace = new SharedRunWorkspace({
+            hostRoot: config.hostRoot,
+            runtimeRoot: config.runtimeRoot ?? config.hostRoot,
+            label: config.label ?? '',
+            now: config.now ?? new Date(),
+        });
+        await workspace.ensure();
+        return workspace;
+    }
+    refs() {
+        return {
+            rootPath: this.runtimePath(),
+            manifestPath: this.runtimePath('manifest.json'),
+            sharedContextPath: this.runtimePath('02_shared_context.md'),
+            sourceInventoryPath: this.runtimePath('sources', 'inventory.md'),
+            supervisorBriefPath: this.runtimePath('00_supervisor_brief.md'),
+            taskContextPath: this.runtimePath('01_task_context.md'),
+            agentsPath: this.runtimePath('agents'),
+        };
+    }
+    hostPath(...segments) {
+        return safeJoin(this.hostRoot, segments);
+    }
+    runtimePath(...segments) {
+        if (segments.length === 0)
+            return this.runtimeRoot;
+        return posix.join(this.runtimeRoot, ...segments.map((segment) => segment.split(sep).join('/')));
+    }
+    async ensure() {
+        await Promise.all([
+            mkdir(this.hostPath('sources'), { recursive: true }),
+            mkdir(this.hostPath('plans', 'root'), { recursive: true }),
+            mkdir(this.hostPath('agents'), { recursive: true }),
+        ]);
+        await this.writeManifest((manifest) => manifest);
+    }
+    async readManifest() {
+        const content = await readFile(this.hostPath('manifest.json'), 'utf8').catch(() => '');
+        if (!content.trim())
+            return this.initialManifest();
+        return JSON.parse(content);
+    }
+    async writeManifest(update) {
+        const operation = this.manifestWriteQueue
+            .catch(() => undefined)
+            .then(async () => {
+            const current = await this.readManifest().catch(() => this.initialManifest());
+            const next = update({
+                ...current,
+                updatedAt: this.nowIso(),
+            });
+            await writeJsonAtomic(this.hostPath('manifest.json'), next);
+            return next;
+        });
+        this.manifestWriteQueue = operation.then(() => undefined, () => undefined);
+        return operation;
+    }
+    async writeSourceInventory(sources) {
+        const lines = [
+            '# Source Inventory',
+            '',
+            sources.length
+                ? 'These are the canonical input references for this run. Prefer this inventory and targeted source reads over rediscovering uploads in every worker.'
+                : 'No user-uploaded source files were registered for this run.',
+            '',
+            ...sources.map((source) => [
+                `## ${source.label}`,
+                '',
+                `- id: ${source.id}`,
+                `- path: ${source.path}`,
+                source.kind ? `- kind: ${source.kind}` : null,
+                typeof source.sizeBytes === 'number' ? `- sizeBytes: ${source.sizeBytes}` : null,
+                '',
+            ]
+                .filter((line) => line !== null)
+                .join('\n')),
+        ];
+        const content = `${lines.join('\n').trimEnd()}\n`;
+        await writeFile(this.hostPath('sources', 'inventory.md'), content, 'utf8');
+        await this.writeManifest((manifest) => ({
+            ...manifest,
+            sources: [...sources],
+        }));
+        return this.runtimePath('sources', 'inventory.md');
+    }
+    /**
+     * Write the canonical task-context file (`_work/01_task_context.md`).
+     * This is the single place the original user request lives in full; child
+     * workers read this path instead of receiving the request inline in their
+     * prompts.
+     */
+    async writeTaskContext(text) {
+        const relativePath = ['01_task_context.md'];
+        await mkdir(dirnameFor(this.hostPath(...relativePath)), { recursive: true });
+        await writeFile(this.hostPath(...relativePath), ensureTrailingNewline(text), 'utf8');
+        return this.runtimePath(...relativePath);
+    }
+    /**
+     * Write the shared coordination packet (`_work/02_shared_context.md`).
+     * This is intentionally smaller and more operational than the task context:
+     * workers read it first, then open the full task context or source inventory
+     * only when their assignment needs raw wording or source-file details.
+     */
+    async writeSharedContext(text) {
+        const relativePath = ['02_shared_context.md'];
+        await mkdir(dirnameFor(this.hostPath(...relativePath)), { recursive: true });
+        await writeFile(this.hostPath(...relativePath), ensureTrailingNewline(text), 'utf8');
+        return this.runtimePath(...relativePath);
+    }
+    /**
+     * Write a per-worker brief at `agents/<agentId>/<taskId>/00_brief.md`.
+     * Returns the runtime-visible path. Pair with `registerAgentWork` so the
+     * agent record and the brief sit under the same scratch directory.
+     */
+    async writeAgentBrief(input) {
+        const taskPart = input.taskId ?? 'pending';
+        const relativePath = ['agents', input.agentId, taskPart, '00_brief.md'];
+        await mkdir(dirnameFor(this.hostPath(...relativePath)), { recursive: true });
+        await writeFile(this.hostPath(...relativePath), ensureTrailingNewline(input.briefText), 'utf8');
+        return this.runtimePath(...relativePath);
+    }
+    /**
+     * Append a section to an existing per-worker brief, creating the file if
+     * it doesn't yet exist. Use for follow-up turns / continue flows so the
+     * brief stays authoritative across resumes — workers re-reading the brief
+     * on every entry will see the latest assignment delta, not just the seed
+     * text from initial dispatch.
+     */
+    async appendAgentBrief(input) {
+        const taskPart = input.taskId ?? 'pending';
+        const relativePath = ['agents', input.agentId, taskPart, '00_brief.md'];
+        await mkdir(dirnameFor(this.hostPath(...relativePath)), { recursive: true });
+        const target = this.hostPath(...relativePath);
+        const existing = await readFile(target, 'utf8').catch(() => '');
+        const trimmedExisting = existing.replace(/\n*$/, '');
+        const next = trimmedExisting
+            ? `${trimmedExisting}\n\n${ensureTrailingNewline(input.sectionText)}`
+            : ensureTrailingNewline(input.sectionText);
+        await writeFile(target, next, 'utf8');
+        return this.runtimePath(...relativePath);
+    }
+    async seedSupervisorBrief(input) {
+        const id = input.id ?? 'root';
+        const relativePath = id === 'root' ? ['00_supervisor_brief.md'] : ['plans', id, 'supervisor_brief.md'];
+        await mkdir(dirnameFor(this.hostPath(...relativePath)), { recursive: true });
+        await writeFile(this.hostPath(...relativePath), ensureTrailingNewline(input.briefText), 'utf8');
+        const briefPath = this.runtimePath(...relativePath);
+        const now = this.nowIso();
+        await this.writeManifest((manifest) => ({
+            ...manifest,
+            plans: upsertBy(manifest.plans, (plan) => plan.id, {
+                id,
+                briefPath,
+                status: input.status ?? 'seeded',
+                updatedAt: now,
+            }),
+        }));
+        return briefPath;
+    }
+    async registerAgentWork(input) {
+        const taskPart = input.taskId ?? 'pending';
+        const relativePath = ['agents', input.agentId, taskPart];
+        await mkdir(this.hostPath(...relativePath), { recursive: true });
+        const workPath = this.runtimePath(...relativePath);
+        const now = this.nowIso();
+        await this.writeManifest((manifest) => ({
+            ...manifest,
+            agents: upsertBy(manifest.agents, (record) => `${record.agentId}:${record.taskId ?? ''}`, {
+                agentId: input.agentId,
+                ...(input.taskId ? { taskId: input.taskId } : {}),
+                workPath,
+                status: input.status ?? 'assigned',
+                updatedAt: now,
+            }),
+        }));
+        return workPath;
+    }
+    initialManifest() {
+        const now = this.config.now.toISOString();
+        return {
+            schemaVersion: 1,
+            kind: 'shared-run-workspace',
+            createdAt: now,
+            updatedAt: now,
+            ...(this.config.label ? { label: this.config.label } : {}),
+            paths: {
+                root: this.runtimePath(),
+                manifest: this.runtimePath('manifest.json'),
+                sharedContext: this.runtimePath('02_shared_context.md'),
+                sources: this.runtimePath('sources'),
+                plans: this.runtimePath('plans'),
+                agents: this.runtimePath('agents'),
+            },
+            sources: [],
+            plans: [],
+            agents: [],
+        };
+    }
+    nowIso() {
+        return new Date().toISOString();
+    }
+}
+function safeJoin(root, segments) {
+    const fullPath = normalize(join(root, ...segments));
+    const rel = relative(root, fullPath);
+    if (rel === '' || (!rel.startsWith('..') && !rel.includes(`..${sep}`)))
+        return fullPath;
+    throw new Error(`SharedRunWorkspace path escapes root: ${segments.join('/')}`);
+}
+function trimTrailingSlash(value) {
+    if (value === '/')
+        return value;
+    return value.replace(/\/+$/, '');
+}
+function ensureTrailingNewline(value) {
+    return value.endsWith('\n') ? value : `${value}\n`;
+}
+async function writeJsonAtomic(path, value) {
+    const tmpPath = `${path}.${process.pid}.${Date.now()}.tmp`;
+    await writeFile(tmpPath, `${JSON.stringify(value, null, 2)}\n`, 'utf8');
+    await rename(tmpPath, path);
+}
+function dirnameFor(path) {
+    return dirname(path);
+}
+function upsertBy(items, key, next) {
+    const nextKey = key(next);
+    let replaced = false;
+    const updated = items.map((item) => {
+        if (key(item) !== nextKey)
+            return item;
+        replaced = true;
+        return next;
+    });
+    return replaced ? updated : [...updated, next];
+}
+//# sourceMappingURL=shared-run.js.map

package/dist/session/workspace/shared-run.js.map

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

package/dist/skills/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/skills/loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEX,oBAAoB,EACpB,eAAe,EAEf,MAAM,0BAA0B,CAAA;AAyGjC,wBAAsB,SAAS,CAC9B,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,oBAAiC,GACtC,OAAO,CAAC,eAAe,CAAC,CA4B1B;AAED,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAsBzE"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/skills/loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEX,oBAAoB,EACpB,eAAe,EAEf,MAAM,0BAA0B,CAAA;AAwIjC,wBAAsB,SAAS,CAC9B,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,oBAAiC,GACtC,OAAO,CAAC,eAAe,CAAC,CA4B1B;AAED,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAsBzE"}

package/dist/skills/loader.js

@@ -21,13 +21,31 @@ function parseSkillMd(raw, dirPath) {
 function parseFlatYaml(raw, dirPath) {
     const lines = raw.split('\n');
     const kv = {};
+    const metadata = {};
+    let section;
     for (const line of lines) {
+        if (!line.trim() || line.trimStart().startsWith('#'))
+            continue;
+        if (/^\s/.test(line)) {
+            if (section !== 'metadata')
+                continue;
+            const colonIdx = line.indexOf(':');
+            if (colonIdx === -1)
+                continue;
+            const key = line.slice(0, colonIdx).trim();
+            const value = normalizeYamlScalar(line.slice(colonIdx + 1).trim());
+            if (key && value)
+                metadata[key] = value;
+            continue;
+        }
         const colonIdx = line.indexOf(':');
         if (colonIdx === -1)
             continue;
         const key = line.slice(0, colonIdx).trim();
-        const value = line.slice(colonIdx + 1).trim();
-        kv[key] = value.replace(/^["']|["']$/g, '');
+        const value = normalizeYamlScalar(line.slice(colonIdx + 1).trim());
+        section = key === 'metadata' ? 'metadata' : undefined;
+        if (value)
+            kv[key] = value;
     }
     if (!kv.name) {
         throw new Error(`SKILL.md at "${dirPath}" missing required field: name`);
@@ -37,17 +55,29 @@ function parseFlatYaml(raw, dirPath) {
     }
     validateSkillName(kv.name, dirPath);
     validateDescription(kv.description, dirPath);
-    const metadata = {
+    const skillMetadata = {
         name: kv.name,
         description: kv.description,
     };
+    if (kv.license) {
+        skillMetadata.license = kv.license;
+    }
     if (kv.compatibility) {
         if (kv.compatibility.length > 500) {
             throw new Error(`SKILL.md at "${dirPath}": compatibility exceeds 500 characters`);
         }
-        metadata.compatibility = kv.compatibility;
+        skillMetadata.compatibility = kv.compatibility;
+    }
+    if (kv['allowed-tools']) {
+        skillMetadata.allowedTools = kv['allowed-tools'];
     }
-    return metadata;
+    if (Object.keys(metadata).length > 0) {
+        skillMetadata.metadata = metadata;
+    }
+    return skillMetadata;
+}
+function normalizeYamlScalar(value) {
+    return value.replace(/^["']|["']$/g, '').trim();
 }
 const SKILL_NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
 function validateSkillName(name, dirPath) {
@@ -120,6 +150,6 @@ export async function discoverSkills(parentDir) {
     catch {
         logger.debug('Skills directory not found', { parentDir });
     }
-    return dirs;
+    return dirs.sort();
 }
 //# sourceMappingURL=loader.js.map

package/dist/skills/loader.js.map

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

package/dist/skills/loader.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=loader.test.d.ts.map

package/dist/skills/loader.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.test.d.ts","sourceRoot":"","sources":["../../src/skills/loader.test.ts"],"names":[],"mappings":""}

package/dist/skills/loader.test.js

@@ -0,0 +1,65 @@
+import { mkdir, mkdtemp, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { describe, expect, it } from 'vitest';
+import { discoverSkills, loadSkill } from './loader.js';
+async function writeSkill(parent, name, content) {
+    const dir = join(parent, name);
+    await mkdir(dir, { recursive: true });
+    await writeFile(join(dir, 'SKILL.md'), content, 'utf8');
+    return dir;
+}
+describe('Agent Skills loader', () => {
+    it('parses standard Agent Skills frontmatter fields', async () => {
+        const root = await mkdtemp(join(tmpdir(), 'namzu-skills-'));
+        const dir = await writeSkill(root, 'project-documents', [
+            '---',
+            'name: project-documents',
+            'description: Draft and edit grounded project documents.',
+            'license: MIT',
+            'compatibility: Requires filesystem tools',
+            'allowed-tools: read write edit',
+            'metadata:',
+            '  owner: vandal',
+            '  version: "1.0"',
+            '---',
+            'Use grounded sources before drafting.',
+            '',
+        ].join('\n'));
+        const result = await loadSkill(dir, 'metadata');
+        expect(result.skill.metadata).toEqual({
+            name: 'project-documents',
+            description: 'Draft and edit grounded project documents.',
+            license: 'MIT',
+            compatibility: 'Requires filesystem tools',
+            allowedTools: 'read write edit',
+            metadata: {
+                owner: 'vandal',
+                version: '1.0',
+            },
+        });
+        expect(result.skill.body).toBeUndefined();
+    });
+    it('loads the body only when the requested disclosure level is full', async () => {
+        const root = await mkdtemp(join(tmpdir(), 'namzu-skills-'));
+        const dir = await writeSkill(root, 'long-form-files', [
+            '---',
+            'name: long-form-files',
+            'description: Create long files with bounded edit chunks.',
+            '---',
+            'Use skeleton-first writes.',
+            '',
+        ].join('\n'));
+        const metadataOnly = await loadSkill(dir, 'metadata');
+        const full = await loadSkill(dir, 'full');
+        expect(metadataOnly.skill.body).toBeUndefined();
+        expect(full.skill.body).toBe('Use skeleton-first writes.');
+    });
+    it('discovers one-level skill directories deterministically', async () => {
+        const root = await mkdtemp(join(tmpdir(), 'namzu-skills-'));
+        const a = await writeSkill(root, 'a-skill', ['---', 'name: a-skill', 'description: A skill.', '---', 'A'].join('\n'));
+        const b = await writeSkill(root, 'b-skill', ['---', 'name: b-skill', 'description: B skill.', '---', 'B'].join('\n'));
+        expect(await discoverSkills(root)).toEqual([a, b]);
+    });
+});
+//# sourceMappingURL=loader.test.js.map

package/dist/skills/loader.test.js.map

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

package/dist/streaming/coalesce.test.js

@@ -87,7 +87,7 @@ describe('coalesce()', () => {
                 iteration: 0,
                 messageId: MID,
                 toolUseId: TUID,
-                toolName: 'Read',
+                toolName: 'read',
             },
             { type: 'text_delta', runId: RID, iteration: 0, messageId: MID, text: 'c' },
         ];

package/dist/tools/builtins/__tests__/edit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=edit.test.d.ts.map

package/dist/tools/builtins/__tests__/edit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.test.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtins/__tests__/edit.test.ts"],"names":[],"mappings":""}

package/dist/tools/builtins/__tests__/edit.test.js

@@ -0,0 +1,38 @@
+import { mkdtempSync, readFileSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { describe, expect, it } from 'vitest';
+import { EditTool } from '../edit.js';
+function makeContext(workingDirectory) {
+    return {
+        runId: 'run_test',
+        workingDirectory,
+        abortSignal: new AbortController().signal,
+        env: {},
+        log: () => { },
+    };
+}
+describe('EditTool', () => {
+    it('accepts oldStr/newStr aliases for string replacement', async () => {
+        const dir = mkdtempSync(join(tmpdir(), 'namzu-edit-'));
+        writeFileSync(join(dir, 'doc.md'), 'alpha\nbeta\n');
+        const result = await EditTool.execute({ path: 'doc.md', oldStr: 'beta', newStr: 'gamma', replace_all: false }, makeContext(dir));
+        expect(result.success).toBe(true);
+        expect(readFileSync(join(dir, 'doc.md'), 'utf-8')).toBe('alpha\ngamma\n');
+    });
+    it('inserts content after a 1-indexed line number', async () => {
+        const dir = mkdtempSync(join(tmpdir(), 'namzu-edit-'));
+        writeFileSync(join(dir, 'doc.md'), 'alpha\nbeta\n');
+        const result = await EditTool.execute({ path: 'doc.md', insertLine: 1, newStr: 'inserted', replace_all: false }, makeContext(dir));
+        expect(result.success).toBe(true);
+        expect(readFileSync(join(dir, 'doc.md'), 'utf-8')).toBe('alpha\ninserted\nbeta\n');
+    });
+    it('inserts content at the end with insertLine=end', async () => {
+        const dir = mkdtempSync(join(tmpdir(), 'namzu-edit-'));
+        writeFileSync(join(dir, 'doc.md'), 'alpha\n');
+        const result = await EditTool.execute({ path: 'doc.md', insertLine: 'end', newStr: 'omega', replace_all: false }, makeContext(dir));
+        expect(result.success).toBe(true);
+        expect(readFileSync(join(dir, 'doc.md'), 'utf-8')).toBe('alpha\nomega\n');
+    });
+});
+//# sourceMappingURL=edit.test.js.map

package/dist/tools/builtins/__tests__/edit.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.test.js","sourceRoot":"","sources":["../../../../src/tools/builtins/__tests__/edit.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE7C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAErC,SAAS,WAAW,CAAC,gBAAwB;IAC5C,OAAO;QACN,KAAK,EAAE,UAAkC;QACzC,gBAAgB;QAChB,WAAW,EAAE,IAAI,eAAe,EAAE,CAAC,MAAM;QACzC,GAAG,EAAE,EAAE;QACP,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC;KACb,CAAA;AACF,CAAC;AAED,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;IACzB,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,aAAa,CAAC,CAAC,CAAA;QACtD,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,eAAe,CAAC,CAAA;QAEnD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CACpC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,EACvE,WAAW,CAAC,GAAG,CAAC,CAChB,CAAA;QAED,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACjC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;IAC1E,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,aAAa,CAAC,CAAC,CAAA;QACtD,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,eAAe,CAAC,CAAA;QAEnD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CACpC,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,EAAE,EACzE,WAAW,CAAC,GAAG,CAAC,CAChB,CAAA;QAED,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACjC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAA;IACnF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC/D,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,aAAa,CAAC,CAAC,CAAA;QACtD,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,SAAS,CAAC,CAAA;QAE7C,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CACpC,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,EAC1E,WAAW,CAAC,GAAG,CAAC,CAChB,CAAA;QAED,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACjC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;IAC1E,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA"}

package/dist/tools/builtins/__tests__/payload-budget.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=payload-budget.test.d.ts.map

package/dist/tools/builtins/__tests__/payload-budget.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload-budget.test.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtins/__tests__/payload-budget.test.ts"],"names":[],"mappings":""}

package/dist/tools/builtins/__tests__/payload-budget.test.js

@@ -0,0 +1,22 @@
+import { describe, expect, it } from 'vitest';
+import { EditTool } from '../edit.js';
+import { getBuiltinTools } from '../index.js';
+import { WriteFileTool } from '../write-file.js';
+describe('filesystem tool payload budgeting', () => {
+    it('does not hard-fail oversized write/edit payloads at schema validation', () => {
+        const oversized = 'x'.repeat(12_500);
+        expect(() => WriteFileTool.inputSchema.parse({ path: 'outputs/long.md', content: oversized })).not.toThrow();
+        expect(() => EditTool.inputSchema.parse({
+            path: 'outputs/long.md',
+            oldStr: '{{SECTION}}',
+            newStr: oversized,
+            replace_all: false,
+        })).not.toThrow();
+    });
+    it('keeps append out of the default builtin toolset', () => {
+        const names = getBuiltinTools().map((tool) => tool.name);
+        expect(names).toContain('edit');
+        expect(names).not.toContain('append');
+    });
+});
+//# sourceMappingURL=payload-budget.test.js.map