@namzu/cli 29.0.1 → 29.1.0

package/dist/skills/save.d.ts

@@ -0,0 +1,148 @@
+/**
+ * `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 { type ToolDefinition } from '@namzu/sdk';
+import type { SkillsConfig } from '../config/schema.js';
+export declare const SAVE_SKILL_TOOL_NAME = "save_skill";
+/** The built-in skill that interviews the operator and drafts a skill. */
+export declare const SKILL_CREATOR_SKILL = "skill-creator";
+/** What `/skills new [idea]` sends as the operator's prompt. */
+export declare function newSkillPrompt(idea: string): string;
+/**
+ * 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 declare function learnSkillPrompt(name?: string): string;
+/** The kernel loader's own limits, checked here so the operator is never shown a file it would refuse. */
+export declare const SKILL_NAME_MAX_CHARS = 64;
+export declare const SKILL_DESCRIPTION_MAX_CHARS = 1024;
+/** A skill body is instructions, not a document store. */
+export declare const SKILL_BODY_MAX_BYTES: number;
+export declare const SKILL_NAME_PATTERN: RegExp;
+export type SkillSaveScope = 'user' | 'project';
+export type SkillOrigin = 'created' | 'learned';
+/** What the model proposed, after validation. */
+export interface SkillDraft {
+    readonly name: string;
+    readonly description: string;
+    readonly body: string;
+    readonly origin: SkillOrigin;
+}
+/** Another `SKILL.md` of the same name, and what saving here does to it. */
+export interface SkillCollision {
+    /**
+     * `replaces`: the new file takes its place — the same path (overwritten)
+     * or a lower tier (shadowed). `hidden-by`: a higher tier's file keeps
+     * winning, so the saved skill would not be the one used.
+     */
+    readonly effect: 'replaces' | 'hidden-by';
+    /** The existing file's tier in the operator's words (`built-in`, `~/.namzu/skills`, …). */
+    readonly where: string;
+    readonly path: string;
+    /** True when it is the very file this save would overwrite. */
+    readonly overwrite: boolean;
+}
+export interface SkillSaveTarget {
+    readonly scope: SkillSaveScope;
+    /** The `SKILL.md` this choice writes. */
+    readonly path: string;
+    /** The same path as the operator would type it (`~/…`, `./…`). */
+    readonly displayPath: string;
+    readonly collisions: readonly SkillCollision[];
+}
+/** Everything the confirmation shows. Computed by the host, never taken from the model's words. */
+export interface SaveSkillRequest {
+    readonly draft: SkillDraft;
+    /** The file exactly as it would be written. */
+    readonly markdown: string;
+    /** `markdown` with invisible and control characters shown as `<U+XXXX>`. */
+    readonly revealed: string;
+    readonly targets: {
+        readonly user: SkillSaveTarget;
+        readonly project: SkillSaveTarget;
+    };
+    /** Where the model suggested it go; the screen marks it, nothing preselects it. */
+    readonly suggested: SkillSaveScope;
+    /** The conversation it came from, when there is one. */
+    readonly sessionId?: string;
+    /** Hidden characters, instructions to ignore instructions, secrets, exfiltration. */
+    readonly warnings: readonly string[];
+}
+export type SaveSkillAnswer = SkillSaveScope | 'cancel';
+export interface SaveSkillHost {
+    /** The session's working directory: the project tier is `<cwd>/.namzu/skills`. */
+    readonly cwd: () => string;
+    /** The operator's home directory. Absent: `NAMZU_HOME` and the OS home, as discovery reads them. */
+    readonly home?: () => string | undefined;
+    readonly config?: () => SkillsConfig | undefined;
+    readonly sessionId: () => string | undefined;
+    /**
+     * Ask the person. Anything but `user` or `project` — `cancel`, a thrown
+     * error, an aborted turn — writes nothing.
+     */
+    readonly confirm: (request: SaveSkillRequest, signal?: AbortSignal) => Promise<SaveSkillAnswer>;
+    /** Told after a file was written. */
+    readonly saved?: (result: {
+        readonly name: string;
+        readonly path: string;
+    }) => void;
+    /** The clock, for `namzu-created`. */
+    readonly now?: () => Date;
+}
+export declare class SkillDraftError extends Error {
+    readonly name = "SkillDraftError";
+}
+/**
+ * Normalise and check what the model proposed. Throws {@link SkillDraftError}
+ * naming the first problem.
+ */
+export declare function validateSkillDraft(input: {
+    readonly name: string;
+    readonly description: string;
+    readonly body: string;
+    readonly origin?: SkillOrigin;
+}): SkillDraft;
+/** The `SKILL.md` for a draft. Round-tripped through the reader before anyone sees it. */
+export declare function composeSkillMarkdown(draft: SkillDraft, meta: {
+    readonly sessionId?: string;
+    readonly createdAt: Date;
+}): string;
+/** Where each choice writes, and what already holds that name. */
+export declare function planSkillTargets(name: string, options: {
+    readonly cwd: string;
+    readonly home?: string;
+    readonly config?: SkillsConfig;
+}): {
+    readonly user: SkillSaveTarget;
+    readonly project: SkillSaveTarget;
+};
+/** One line per collision, as the confirmation and the tool result say it. */
+export declare function describeCollision(collision: SkillCollision, cwd: string): string;
+/** The prompt tripwire, worded for a skill. */
+export declare function skillWarnings(markdown: string): string[];
+/**
+ * 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 declare function writeFileAtomically(path: string, text: string): void;
+/**
+ * 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 declare function buildSaveSkillTool(host: SaveSkillHost): ToolDefinition;
+//# sourceMappingURL=save.d.ts.map

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

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

package/dist/skills/save.js

@@ -0,0 +1,344 @@
+/**
+ * `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

package/dist/skills/save.js.map

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