@namzu/cli 35.0.0 → 36.1.0

package/dist/skills/catalog.js

@@ -1,226 +0,0 @@
-/**
- * The skills a session offers the MODEL.
- *
- * `store.ts` discovers `SKILL.md` files for the operator. Until this module
- * existed those files reached the model only when the operator pasted one in
- * (`/skills <name>`, `exec --skills`): the kernel's manifest and its `skill`
- * tool were wired for plugin skills alone. This builds one SDK
- * `SkillRegistry` per session from the discovered tiers and, per turn, merges
- * it with the plugin runtime's registry into what the turn receives:
- *
- *   - `registry` — what the `skill` tool loads from (and lists, paged);
- *   - `manifest` — the skills described in the prompt's `<available_skills>`;
- *   - `overflowNote` — the names that did not fit the manifest's budget.
- *
- * Metadata only until the model asks: a skill's body is read when the `skill`
- * tool loads it, never at session start.
- *
- * ## Gating
- *
- * A skill whose `metadata.namzu-requires-tools` names a tool the turn does
- * not have is hidden from both the manifest and the tool — instructions for a
- * capability the session lacks read as a capability to go looking for.
- *
- * ## Budget
- *
- * The manifest costs prompt on every request, so it is capped at
- * min(2% of the context window, 4 KB). Skills that do not fit are named in
- * one line and stay loadable; the `skill` tool lists them with descriptions,
- * paged, when called without a name.
- */
-import { dirname } from 'node:path';
-import { SKILL_TOOL_NAME, SkillRegistry, isInvocableBy, } from '@namzu/sdk';
-import { SKILL_TIERS, discoverSkills, parseRequiredTools, } from './store.js';
-/** The manifest never costs more than this many characters. */
-export const SKILL_MANIFEST_MAX_CHARS = 4096;
-/** Share of the context window the manifest may take. */
-export const SKILL_MANIFEST_WINDOW_SHARE = 0.02;
-/** The kernel's own chars-per-token estimate. */
-const CHARS_PER_TOKEN = 4;
-/** min(2% of the window, 4 KB), in characters. */
-export function skillManifestBudget(contextWindowTokens) {
-    const share = Math.floor(contextWindowTokens * SKILL_MANIFEST_WINDOW_SHARE * CHARS_PER_TOKEN);
-    return Math.max(0, Math.min(SKILL_MANIFEST_MAX_CHARS, share));
-}
-/**
- * What one skill's `<skill>` entry costs in the manifest. Mirrors the
- * kernel's `renderSkillsSection` entry closely enough to budget with; the
- * section's fixed preamble is not counted — it is paid once whatever fits.
- */
-export function manifestEntryChars(skill) {
-    const m = skill.metadata;
-    let chars = '<skill>\n<name></name>\n<description></description>\n<location>/SKILL.md</location>\n</skill>\n'
-        .length +
-        m.name.length +
-        m.description.trim().length +
-        skill.dirPath.length;
-    if (m.compatibility)
-        chars += '<compatibility></compatibility>\n'.length + m.compatibility.length;
-    if (m.license)
-        chars += '<license></license>\n'.length + m.license.length;
-    if (m.allowedTools)
-        chars += '<allowed_tools></allowed_tools>\n'.length + m.allowedTools.length;
-    return chars;
-}
-/** The tools a skill says the session must have; see the module comment. */
-export function requiredToolsOf(skill) {
-    const metadata = skill.metadata.metadata;
-    const declared = metadata && Object.hasOwn(metadata, 'namzu-requires-tools')
-        ? metadata['namzu-requires-tools']
-        : undefined;
-    return parseRequiredTools(declared) ?? [];
-}
-/**
- * Discover the file tiers and register each usable winner's metadata; every
- * turn discovers again, so the catalog follows the files.
- *
- * A file the kernel loader refuses (a name that does not match its
- * directory, a missing description, a contradictory `invocation`) is left
- * out of the model's catalog with a warning; the operator still sees it in
- * `/skills list` and can still activate it by name.
- */
-export async function createSessionSkillCatalog(options) {
-    const discovery = {
-        cwd: options.cwd,
-        ...(options.home !== undefined ? { home: options.home } : {}),
-        ...(options.config ? { config: options.config } : {}),
-        ...(options.systemDir !== undefined ? { systemDir: options.systemDir } : {}),
-    };
-    const files = new SkillRegistry(options.log);
-    let registered = [];
-    /** The path each registered name was read from, to notice a new winner. */
-    const registeredPaths = new Map();
-    let order = [];
-    // Re-run every turn: a skill written while the session runs (`save_skill`,
-    // or the operator's editor) reaches the next turn, a new winner in a
-    // higher tier replaces the one it shadows, and a removed file is dropped.
-    // Discovery reads a handful of small files; a turn costs far more.
-    const sync = async () => {
-        const candidates = discoverSkills(discovery)
-            .filter((skill) => skill.problem === undefined && skill.disabled !== true)
-            // Highest precedence first: when the budget runs out, the project's own
-            // skills are the last to lose their description.
-            .sort((a, b) => SKILL_TIERS.indexOf(b.tier) - SKILL_TIERS.indexOf(a.tier) || a.name.localeCompare(b.name));
-        const next = [];
-        const seen = new Set();
-        for (const skill of candidates) {
-            seen.add(skill.name);
-            if (registeredPaths.get(skill.name) === skill.path) {
-                next.push(skill);
-                continue;
-            }
-            try {
-                await files.register(dirname(skill.path), 'metadata');
-                registeredPaths.set(skill.name, skill.path);
-                next.push(skill);
-            }
-            catch (error) {
-                if (registeredPaths.delete(skill.name))
-                    files.unregister(skill.name);
-                options.log?.warn('skill not offered to the model', {
-                    'namzu.skill.name': skill.name,
-                    'namzu.skill.path': skill.path,
-                    'namzu.skill.reason': error instanceof Error ? error.message : String(error),
-                });
-            }
-        }
-        for (const name of [...registeredPaths.keys()]) {
-            if (seen.has(name))
-                continue;
-            registeredPaths.delete(name);
-            files.unregister(name);
-        }
-        registered = next;
-        order = next.map((skill) => skill.name);
-    };
-    await sync();
-    return {
-        get fileSkills() {
-            return registered;
-        },
-        get hasFileSkills() {
-            return registered.length > 0;
-        },
-        async forTurn(input) {
-            await sync();
-            const tools = new Set(input.toolNames);
-            const gated = (skill) => requiredToolsOf(skill).every((name) => tools.has(name));
-            // `load` re-reads a changed file and drops a deleted one, so an edit
-            // made while the session runs reaches the next turn.
-            const fileSkills = [];
-            for (const name of order) {
-                const loaded = await files.load(name, 'metadata');
-                if (!loaded || !gated(loaded.skill))
-                    continue;
-                // Metadata only. The registry keeps a body once the model has loaded
-                // it, and the kernel pastes any body it is handed into the prompt
-                // under "Loaded Skills" — every later request would then carry a
-                // second copy of what the tool result already put in the history.
-                const { body: _body, ...metadataOnly } = loaded.skill;
-                fileSkills.push(metadataOnly);
-            }
-            const offered = new Set(fileSkills.map((skill) => skill.metadata.name));
-            const plugins = input.pluginSkills;
-            const pluginSkills = [];
-            if (plugins) {
-                for (const name of plugins.names()) {
-                    const loaded = await plugins.load(name, 'metadata');
-                    if (loaded)
-                        pluginSkills.push(loaded.skill);
-                }
-            }
-            const all = [...fileSkills, ...pluginSkills];
-            if (all.length === 0) {
-                return { registry: undefined, manifest: undefined, overflowNote: null, overflow: [] };
-            }
-            const budget = skillManifestBudget(input.contextWindowTokens);
-            const manifest = [];
-            const overflow = [];
-            let spent = 0;
-            for (const skill of all) {
-                // Operator-only skills are not in the manifest at all; the kernel
-                // filters them too, and they must not use up its budget.
-                if (!isInvocableBy(skill, 'model')) {
-                    manifest.push(skill);
-                    continue;
-                }
-                const cost = manifestEntryChars(skill);
-                if (overflow.length === 0 && spent + cost <= budget) {
-                    manifest.push(skill);
-                    spent += cost;
-                }
-                else {
-                    overflow.push(skill.metadata.name);
-                }
-            }
-            const registry = {
-                names: () => [...offered, ...(plugins ? plugins.names() : [])],
-                async catalog() {
-                    const fileEntries = (await files.catalog()).filter((entry) => offered.has(entry.registeredName));
-                    const pluginEntries = plugins ? await plugins.catalog() : [];
-                    return [...fileEntries, ...pluginEntries];
-                },
-                async load(name) {
-                    if (offered.has(name))
-                        return files.load(name);
-                    if (plugins?.has(name))
-                        return plugins.load(name);
-                    return undefined;
-                },
-            };
-            return {
-                registry,
-                manifest: manifest.length > 0 ? manifest : undefined,
-                overflowNote: overflowNote(overflow),
-                overflow,
-            };
-        },
-    };
-}
-/** The one line naming skills the manifest had no room to describe. */
-export function overflowNote(names) {
-    if (names.length === 0)
-        return null;
-    return `More skills are available than the skills manifest describes: ${names.join(', ')}. Call the \`${SKILL_TOOL_NAME}\` tool without a name to list them with descriptions, or with a name to load one when the task matches it.`;
-}
-//# sourceMappingURL=catalog.js.map

package/dist/skills/catalog.js.map

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

package/dist/skills/directory.js

@@ -1,51 +0,0 @@
-/**
- * The directory the model can open for a skill, in this CLI.
- *
- * The `skill` tool loads a body from the path the CLI discovered it at, and a
- * body that says "run scripts/render.sh" needs a directory the model's own
- * tools can open. On the host that is the same path. Inside the sandbox it
- * is only sometimes: the local sandbox mounts its root (the working directory,
- * or a disposable directory for an `ephemeral` workspace) and, with the
- * working directory, the added directories, each at its own canonical path,
- * and nothing else. The sandbox's file API refuses every other path, links
- * followed. So:
- *
- *   - a project skill (`<cwd>/.namzu/skills`, `<cwd>/.agents/skills`,
- *     `<cwd>/skills`) is reachable, and so is one under an added directory;
- *   - a user skill (`~/.namzu/skills`, `~/.agents/skills`), a built-in skill
- *     (inside the installed package), a plugin skill outside the project, one
- *     in `.agents/skills` above `<cwd>`, and a project skill whose directory
- *     is a link to somewhere unmounted are not, and are answered `undefined`
- *     rather than with a path that would fail;
- *   - under an `ephemeral` workspace nothing of the host is mounted, so every
- *     skill is `undefined`.
- *
- * The bwrap tier also binds `/usr`, `/opt` and the Node prefix read-only for
- * commands to run. A built-in skill of a CLI installed under one of them can
- * be `cat` from `bash` there, but the `read` tool refuses it and the macOS
- * and namespace tiers differ again, so it is not offered as reachable.
- */
-import { resolveWithinReal } from '@namzu/sdk';
-export function createSkillDirectoryResolver(options) {
-    return async (skill, context) => {
-        if (skill.directory === undefined)
-            return undefined;
-        // On the host the model's tools open the path the CLI read the skill
-        // from: a path outside the working directory is a permission question,
-        // not a wall.
-        if (!context.sandbox)
-            return skill.directory;
-        for (const root of [context.sandbox.rootDir, ...options.sandboxMounts()]) {
-            try {
-                // Canonical, because that is the path each root is mounted at;
-                // a link out of the root throws, and its target is not mounted.
-                return await resolveWithinReal(root, skill.directory);
-            }
-            catch {
-                // Not under this root; try the next.
-            }
-        }
-        return undefined;
-    };
-}
-//# sourceMappingURL=directory.js.map

package/dist/skills/directory.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"directory.js","sourceRoot":"","sources":["../../src/skills/directory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAA+B,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAW3E,MAAM,UAAU,4BAA4B,CAC3C,OAAsC;IAEtC,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAC/B,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS;YAAE,OAAO,SAAS,CAAA;QACnD,qEAAqE;QACrE,uEAAuE;QACvE,cAAc;QACd,IAAI,CAAC,OAAO,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC,SAAS,CAAA;QAC5C,KAAK,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,EAAE,CAAC;YAC1E,IAAI,CAAC;gBACJ,+DAA+D;gBAC/D,gEAAgE;gBAChE,OAAO,MAAM,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,CAAA;YACtD,CAAC;YAAC,MAAM,CAAC;gBACR,qCAAqC;YACtC,CAAC;QACF,CAAC;QACD,OAAO,SAAS,CAAA;IACjB,CAAC,CAAA;AACF,CAAC"}

package/dist/skills/save.js

@@ -1,344 +0,0 @@
-/**
- * `save_skill`: the model proposes a `SKILL.md`, the operator decides.
- *
- * The tool exists only in the interactive TUI (the App hands it to its own
- * session through `extraTools`; `exec`, `drain`, a scheduled run and every
- * sub-agent build their registries without it). Nothing is written until a
- * person picks a target on a screen drawn from what this module computes —
- * the exact file, with invisible characters shown, where it would go, and
- * which existing skill it would replace or be hidden by. That question is
- * the host's own (`SaveSkillHost.confirm`), not the permission gate's, so no
- * permission mode answers it: `auto` still asks.
- *
- * A saved skill is a single `SKILL.md`, written atomically (a temporary
- * beside it, then `rename`). The session catalog discovers again every turn,
- * so the model is offered it from the next turn on.
- */
-import { randomBytes } from 'node:crypto';
-import { closeSync, fsyncSync, mkdirSync, openSync, renameSync, rmSync, writeSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { dirname, join, relative, sep } from 'node:path';
-import { defineTool, mcpJsonSchemaToZod, revealHiddenCharacters, scanSchedulePrompt, } from '@namzu/sdk';
-import { SKILL_TIERS, discoverSkillRoster, parseSkillMarkdown, projectSkillsDir, skillTierLabel, userSkillsDir, } from './store.js';
-export const SAVE_SKILL_TOOL_NAME = 'save_skill';
-/** The built-in skill that interviews the operator and drafts a skill. */
-export const SKILL_CREATOR_SKILL = 'skill-creator';
-/** What `/skills new [idea]` sends as the operator's prompt. */
-export function newSkillPrompt(idea) {
-    const what = idea.trim();
-    return [
-        `Help me create a new skill. Load the ${SKILL_CREATOR_SKILL} skill with the skill tool and follow it: interview me, show me the draft, and save it with save_skill only after I agree. Write the skill in the language of my own messages, not in English by default (namzu writes this request in English; it does not count).`,
-        what ? `What the skill should do: ${what}` : 'Start by asking what the skill should do.',
-    ].join(' ');
-}
-/**
- * What `/skills save [name]` sends: one turn, in the conversation whose work
- * it saves, that ends on the `save_skill` screen. The screen shows the whole
- * file and saves nothing until the operator picks a place, so the model is
- * told to go straight to it rather than ask in a reply first.
- */
-export function learnSkillPrompt(name) {
-    return [
-        `Save what we just did in this conversation as a reusable skill. Load the ${SKILL_CREATOR_SKILL} skill with the skill tool and follow its "from this conversation" mode: generalise the task, replace this run's names, paths, values and dates with placeholders, leave out secrets and personal data, and never copy tool, file or page output into it.`,
-        name
-            ? `Name it ${name}.`
-            : 'Choose a short name for the kind of task, not for this instance of it.',
-        'Write the description and instructions in the language of my own earlier messages in this conversation, not in English by default (namzu writes this request in English; it does not count). The name stays lowercase ASCII with dashes.',
-        'The save_skill confirmation screen is my review of the draft: call save_skill with origin "learned" in this turn, without asking me in a reply first. If I cancel, ask what to change.',
-    ].join(' ');
-}
-/** The kernel loader's own limits, checked here so the operator is never shown a file it would refuse. */
-export const SKILL_NAME_MAX_CHARS = 64;
-export const SKILL_DESCRIPTION_MAX_CHARS = 1024;
-/** A skill body is instructions, not a document store. */
-export const SKILL_BODY_MAX_BYTES = 64 * 1024;
-export const SKILL_NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
-export class SkillDraftError extends Error {
-    name = 'SkillDraftError';
-}
-/**
- * Normalise and check what the model proposed. Throws {@link SkillDraftError}
- * naming the first problem.
- */
-export function validateSkillDraft(input) {
-    const name = input.name.trim();
-    if (name.length === 0 || name.length > SKILL_NAME_MAX_CHARS || !SKILL_NAME_PATTERN.test(name)) {
-        throw new SkillDraftError(`name "${name}" must be 1–${SKILL_NAME_MAX_CHARS} lowercase letters, digits and single hyphens (like "release-notes").`);
-    }
-    // One line: the frontmatter holds a single-line value, and a description
-    // is read by the model as one sentence or two anyway.
-    const description = input.description.replace(/\s+/g, ' ').trim();
-    if (description.length === 0)
-        throw new SkillDraftError('description must not be empty.');
-    if (description.length > SKILL_DESCRIPTION_MAX_CHARS) {
-        throw new SkillDraftError(`description is ${description.length} characters; at most ${SKILL_DESCRIPTION_MAX_CHARS}.`);
-    }
-    const body = input.body.replace(/\r\n?/g, '\n').trim();
-    if (body.length === 0)
-        throw new SkillDraftError('body must not be empty.');
-    const bytes = Buffer.byteLength(body, 'utf8');
-    if (bytes > SKILL_BODY_MAX_BYTES) {
-        throw new SkillDraftError(`body is ${bytes} bytes; at most ${SKILL_BODY_MAX_BYTES}.`);
-    }
-    if (/^---[ \t]*$/m.test(body.split('\n', 1)[0] ?? '')) {
-        throw new SkillDraftError('body must be the instructions only; pass name and description as fields, not as frontmatter.');
-    }
-    return { name, description, body, origin: input.origin ?? 'created' };
-}
-/** The `SKILL.md` for a draft. Round-tripped through the reader before anyone sees it. */
-export function composeSkillMarkdown(draft, meta) {
-    const lines = [
-        '---',
-        `name: ${draft.name}`,
-        `description: "${draft.description}"`,
-        'metadata:',
-        `  namzu-origin: ${draft.origin}`,
-        ...(meta.sessionId ? [`  namzu-session: "${meta.sessionId}"`] : []),
-        `  namzu-created: "${meta.createdAt.toISOString()}"`,
-        '---',
-        '',
-        draft.body,
-        '',
-    ];
-    const markdown = lines.join('\n');
-    let parsed;
-    try {
-        parsed = parseSkillMarkdown(markdown);
-    }
-    catch (error) {
-        throw new SkillDraftError(`the file would not load: ${error instanceof Error ? error.message : String(error)}`);
-    }
-    if (parsed.name !== draft.name || parsed.description !== draft.description) {
-        throw new SkillDraftError('the description would read back differently from what was written; drop leading or trailing quotes and brackets.');
-    }
-    return markdown;
-}
-function displayPath(path, cwd) {
-    const rel = relative(cwd, path);
-    if (rel && !rel.startsWith('..') && !rel.startsWith(sep))
-        return `./${rel.split(sep).join('/')}`;
-    const home = homedir();
-    const fromHome = relative(home, path);
-    if (fromHome && !fromHome.startsWith('..'))
-        return `~/${fromHome.split(sep).join('/')}`;
-    return path;
-}
-/** Where each choice writes, and what already holds that name. */
-export function planSkillTargets(name, options) {
-    const roster = discoverSkillRoster({
-        cwd: options.cwd,
-        ...(options.home !== undefined ? { home: options.home } : {}),
-        // Every tier, the built-in one included even when the config turns it
-        // off: "replaces" is about files, and the file is there.
-        config: { ...(options.config ?? {}), builtin: true, disabled: [] },
-    });
-    const existing = [
-        ...roster.skills.filter((skill) => skill.name === name),
-        ...roster.shadowed.filter((skill) => skill.name === name),
-    ];
-    const target = (scope) => {
-        const tier = scope;
-        const dir = scope === 'user' ? userSkillsDir(options.home) : projectSkillsDir(options.cwd);
-        const path = join(dir, name, 'SKILL.md');
-        const rank = SKILL_TIERS.indexOf(tier);
-        const collisions = existing
-            .map((skill) => {
-            const overwrite = skill.path === path;
-            const higher = !overwrite && SKILL_TIERS.indexOf(skill.tier) > rank;
-            return {
-                effect: higher ? 'hidden-by' : 'replaces',
-                where: skillTierLabel(skill.tier),
-                path: skill.path,
-                overwrite,
-            };
-        })
-            .sort((a, b) => Number(b.overwrite) - Number(a.overwrite));
-        return { scope, path, displayPath: displayPath(path, options.cwd), collisions };
-    };
-    return { user: target('user'), project: target('project') };
-}
-/** One line per collision, as the confirmation and the tool result say it. */
-export function describeCollision(collision, cwd) {
-    const where = displayPath(collision.path, cwd);
-    if (collision.overwrite)
-        return `replaces ${collision.where} skill ${where} (overwrites it)`;
-    return collision.effect === 'replaces'
-        ? `replaces ${collision.where} skill ${where}`
-        : `hidden by ${collision.where} skill ${where}, which keeps winning`;
-}
-/** The prompt tripwire, worded for a skill. */
-export function skillWarnings(markdown) {
-    return scanSchedulePrompt(markdown).map((finding) => finding.replace(/^The prompt/, 'The skill'));
-}
-/**
- * Write `text` to `path` so a reader sees the old file or the new one, never
- * part of either: a temporary beside it, flushed, then renamed over it.
- */
-export function writeFileAtomically(path, text) {
-    mkdirSync(dirname(path), { recursive: true });
-    const temporary = join(dirname(path), `.SKILL.md.${process.pid}.${randomBytes(6).toString('hex')}.tmp`);
-    try {
-        const fd = openSync(temporary, 'wx', 0o644);
-        try {
-            writeSync(fd, text);
-            fsyncSync(fd);
-        }
-        finally {
-            closeSync(fd);
-        }
-        renameSync(temporary, path);
-    }
-    catch (error) {
-        rmSync(temporary, { force: true });
-        throw error;
-    }
-}
-const inputSchema = mcpJsonSchemaToZod({
-    type: 'object',
-    properties: {
-        name: {
-            type: 'string',
-            minLength: 1,
-            maxLength: 128,
-            description: 'Directory and skill name: lowercase letters, digits and single hyphens, at most 64.',
-        },
-        description: {
-            type: 'string',
-            minLength: 1,
-            maxLength: 4096,
-            description: 'One or two sentences saying WHEN to use the skill (the task and the words a user would use), at most 1024 characters. The model decides to load a skill from this alone.',
-        },
-        body: {
-            type: 'string',
-            minLength: 1,
-            maxLength: 200_000,
-            description: 'The instructions: markdown, no frontmatter. Steps, constraints, examples.',
-        },
-        scope: {
-            type: 'string',
-            enum: ['user', 'project'],
-            description: 'Where you suggest it go: user (~/.namzu/skills, every project) or project (./.namzu/skills). The operator chooses.',
-        },
-        replaces: {
-            type: 'string',
-            description: 'The name of the existing skill this updates, when it is one. Must equal name.',
-        },
-        origin: {
-            type: 'string',
-            enum: ['created', 'learned'],
-            description: 'created: written with the operator; learned: generalised from this conversation.',
-        },
-    },
-    required: ['name', 'description', 'body'],
-    additionalProperties: false,
-});
-function refuse(error) {
-    return { success: false, output: '', error };
-}
-/**
- * The `save_skill` tool over a {@link SaveSkillHost}. Register it only where a
- * person is present to confirm — the interactive TUI's own session.
- */
-export function buildSaveSkillTool(host) {
-    return defineTool({
-        name: SAVE_SKILL_TOOL_NAME,
-        description: 'Propose a reusable skill (a SKILL.md: name, description, instructions) for the operator to save. The operator sees the whole file and where it would go, and picks user, project or cancel; nothing is written without that. Use it only when the operator asked for a skill (the skill-creator skill describes how to draft one).',
-        inputSchema,
-        category: 'custom',
-        permissions: ['file_write'],
-        readOnly: false,
-        destructive: false,
-        concurrencySafe: false,
-        // A person reads the whole file before answering; the default two
-        // minutes would close the question on them.
-        timeoutMs: 30 * 60_000,
-        presentCall: (input) => ({
-            kind: 'generic',
-            label: `Propose skill ${typeof input.name === 'string' ? input.name : ''}`.trim(),
-            presentation: 'activity',
-        }),
-        // The operator's No on the tool's own screen is not a failure.
-        presentResult: (_input, result) => !result.success && result.data?.cancelled === true
-            ? { kind: 'generic', label: 'Cancelled — nothing was saved', outcome: 'cancelled' }
-            : undefined,
-        async execute(raw, context) {
-            const input = raw;
-            let draft;
-            try {
-                draft = validateSkillDraft({
-                    name: input.name,
-                    description: input.description,
-                    body: input.body,
-                    ...(input.origin ? { origin: input.origin } : {}),
-                });
-            }
-            catch (error) {
-                return refuse(`save_skill: ${error instanceof Error ? error.message : String(error)}`);
-            }
-            if (input.replaces !== undefined && input.replaces.trim() !== draft.name) {
-                return refuse(`save_skill: replaces "${input.replaces}" must equal name "${draft.name}"; a skill is updated under its own name, not renamed.`);
-            }
-            const sessionId = host.sessionId();
-            let markdown;
-            try {
-                markdown = composeSkillMarkdown(draft, {
-                    ...(sessionId ? { sessionId } : {}),
-                    createdAt: (host.now ?? (() => new Date()))(),
-                });
-            }
-            catch (error) {
-                return refuse(`save_skill: ${error instanceof Error ? error.message : String(error)}`);
-            }
-            const cwd = host.cwd();
-            const home = host.home?.();
-            const config = host.config?.();
-            const targets = planSkillTargets(draft.name, {
-                cwd,
-                ...(home !== undefined ? { home } : {}),
-                ...(config ? { config } : {}),
-            });
-            const request = {
-                draft,
-                markdown,
-                revealed: revealHiddenCharacters(markdown),
-                targets,
-                suggested: input.scope ?? 'user',
-                ...(sessionId ? { sessionId } : {}),
-                warnings: skillWarnings(markdown),
-            };
-            let answer;
-            try {
-                answer = await host.confirm(request, context.abortSignal);
-            }
-            catch {
-                answer = 'cancel';
-            }
-            if (context.abortSignal?.aborted)
-                answer = 'cancel';
-            if (answer !== 'user' && answer !== 'project') {
-                return {
-                    ...refuse('The operator cancelled; nothing was written. Ask what to change, or leave it.'),
-                    data: { cancelled: true },
-                };
-            }
-            const target = targets[answer];
-            try {
-                writeFileAtomically(target.path, markdown);
-            }
-            catch (error) {
-                return refuse(`save_skill: could not write ${target.path}: ${error instanceof Error ? error.message : String(error)}`);
-            }
-            host.saved?.({ name: draft.name, path: target.path });
-            const notes = target.collisions.map((c) => describeCollision(c, cwd));
-            return {
-                success: true,
-                output: [
-                    `Saved skill "${draft.name}" to ${target.displayPath}.${notes.length > 0 ? ` It ${notes.join('; ')}.` : ''}`,
-                    `It is offered to the model from the next turn; the operator can activate it now with /skills ${draft.name}.`,
-                ].join(' '),
-                data: { name: draft.name, path: target.path, scope: answer },
-            };
-        },
-    });
-}
-//# sourceMappingURL=save.js.map