@anthara/pi-claude 0.0.0-stage → 0.1.0

package/dist/extensions/plugin-command/index.js

@@ -0,0 +1,6 @@
+import { CommandLineGit } from '../../kernel/plugin-install/command-line-git.js';
+import { registerPluginCommand } from './plugin-command.js';
+export default function pluginCommandExtension(pi) {
+    registerPluginCommand(pi, new CommandLineGit());
+}
+//# sourceMappingURL=index.js.map

package/dist/extensions/plugin-command/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extensions/plugin-command/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,CAAC,OAAO,UAAU,sBAAsB,CAAC,EAAgB;IAC7D,qBAAqB,CAAC,EAAE,EAAE,IAAI,cAAc,EAAE,CAAC,CAAC;AAClD,CAAC"}

package/dist/extensions/plugin-command/masked-input.d.ts

@@ -0,0 +1,6 @@
+import type { ExtensionUIContext } from '@earendil-works/pi-coding-agent';
+export interface MaskedPrompt {
+    readonly title: string;
+    readonly description: string;
+}
+export declare function askMasked(ui: Pick<ExtensionUIContext, 'custom'>, prompt: MaskedPrompt): Promise<string | undefined>;

package/dist/extensions/plugin-command/masked-input.js

@@ -0,0 +1,47 @@
+import { Key, matchesKey, truncateToWidth } from '@earendil-works/pi-tui';
+import { withoutPasteMarkers } from '../../kernel/terminal-rows/bracketed-paste.js';
+import { singleLine } from '../../kernel/terminal-rows/single-line.js';
+const MASK = '•';
+const HINT = ' Enter to submit • Backspace to delete • Esc to cancel';
+const FIRST_PRINTABLE_CODE = 0x20;
+const DELETE_CODE = 0x7f;
+export async function askMasked(ui, prompt) {
+    return ui.custom((tui, theme, _keybindings, done) => new MaskedInput(prompt, tui, theme, done));
+}
+class MaskedInput {
+    #prompt;
+    #tui;
+    #theme;
+    #finish;
+    #typed = '';
+    constructor(prompt, tui, theme, finish) {
+        this.#prompt = prompt;
+        this.#tui = tui;
+        this.#theme = theme;
+        this.#finish = finish;
+    }
+    render(width) {
+        const rule = this.#theme.fg('accent', '─'.repeat(width));
+        const description = this.#prompt.description === '' ? [] : [this.#theme.fg('muted', ` ${singleLine(this.#prompt.description)}`)];
+        const rows = [rule, this.#theme.fg('text', ` ${singleLine(this.#prompt.title)}`), ...description, '', ` > ${MASK.repeat(Array.from(this.#typed).length)}`, '', this.#theme.fg('dim', HINT), rule];
+        return rows.map((row) => truncateToWidth(row, width));
+    }
+    handleInput(data) {
+        if (matchesKey(data, Key.enter)) {
+            this.#finish(this.#typed);
+        }
+        else if (matchesKey(data, Key.escape)) {
+            this.#finish(undefined);
+        }
+        else if (matchesKey(data, Key.backspace)) {
+            this.#typed = Array.from(this.#typed).slice(0, -1).join('');
+        }
+        else {
+            this.#typed += printableCharacters(withoutPasteMarkers(data));
+        }
+        this.#tui.requestRender();
+    }
+    invalidate() { }
+}
+const printableCharacters = (data) => Array.from(data).filter((character) => (character.codePointAt(0) ?? 0) >= FIRST_PRINTABLE_CODE && character !== String.fromCharCode(DELETE_CODE)).join('');
+//# sourceMappingURL=masked-input.js.map

package/dist/extensions/plugin-command/masked-input.js.map

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

package/dist/extensions/plugin-command/plugin-command.d.ts

@@ -0,0 +1,3 @@
+import { type ExtensionAPI } from '@earendil-works/pi-coding-agent';
+import type { GitClient } from '../../kernel/plugin-install/git-client.js';
+export declare function registerPluginCommand(pi: ExtensionAPI, git: GitClient): void;

package/dist/extensions/plugin-command/plugin-command.js

@@ -0,0 +1,41 @@
+import { homedir } from 'node:os';
+import { getAgentDir } from '@earendil-works/pi-coding-agent';
+import { AntharaError } from '../../errors/anthara-error.js';
+import { claudeConfigDir } from '../../kernel/claude-home/config-dir.js';
+import { unloadedInstallNotices } from '../../kernel/plugin-management/install-problems.js';
+import { runPluginSubcommand } from '../../kernel/plugin-management/plugin-subcommands.js';
+import { DialogOptionPrompter } from './configure-dialog.js';
+const PLUGIN_COMMAND = 'plugin';
+const SLASH_INVOCATION = `/${PLUGIN_COMMAND}`;
+const PLUGIN_COMMAND_DESCRIPTION = 'Add, update, remove, enable, disable and list Claude Code plugins';
+const WHITE_SPACE = /\s+/;
+export function registerPluginCommand(pi, git) {
+    pi.registerCommand(PLUGIN_COMMAND, {
+        description: PLUGIN_COMMAND_DESCRIPTION,
+        handler: (args, ctx) => runInSession(args, ctx, git),
+    });
+    pi.on('session_start', (_event, ctx) => {
+        reportUnloadedInstalls(ctx);
+    });
+}
+async function runInSession(args, ctx, git) {
+    try {
+        const output = await runPluginSubcommand(wordsOf(args), SLASH_INVOCATION, { git, ...sessionPluginPaths(), ...prompterFor(ctx) });
+        ctx.ui.notify(output.trimEnd(), 'info');
+    }
+    catch (error) {
+        if (!(error instanceof AntharaError)) {
+            throw error;
+        }
+        ctx.ui.notify(error.message, 'error');
+    }
+}
+const prompterFor = (ctx) => (ctx.hasUI ? { prompter: new DialogOptionPrompter(ctx.ui) } : {});
+function reportUnloadedInstalls(ctx) {
+    for (const notice of unloadedInstallNotices(sessionPluginPaths())) {
+        ctx.ui.notify(notice, 'warning');
+    }
+}
+const sessionPluginPaths = () => ({ agentDir: getAgentDir(), claudeDir: claudeConfigDir(process.env, homedir()) });
+const wordsOf = (args) => args.split(WHITE_SPACE).filter((word) => word !== '');
+//# sourceMappingURL=plugin-command.js.map

package/dist/extensions/plugin-command/plugin-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-command.js","sourceRoot":"","sources":["../../../src/extensions/plugin-command/plugin-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,WAAW,EAA4C,MAAM,iCAAiC,CAAC;AACxG,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AAEzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,oDAAoD,CAAC;AAE5F,OAAO,EAAE,mBAAmB,EAAE,MAAM,sDAAsD,CAAC;AAC3F,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,cAAc,GAAG,QAAQ,CAAC;AAChC,MAAM,gBAAgB,GAAG,IAAI,cAAc,EAAE,CAAC;AAC9C,MAAM,0BAA0B,GAAG,mEAAmE,CAAC;AACvG,MAAM,WAAW,GAAG,KAAK,CAAC;AAO1B,MAAM,UAAU,qBAAqB,CAAC,EAAgB,EAAE,GAAc;IACpE,EAAE,CAAC,eAAe,CAAC,cAAc,EAAE;QACjC,WAAW,EAAE,0BAA0B;QACvC,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC;KACrD,CAAC,CAAC;IACH,EAAE,CAAC,EAAE,CAAC,eAAe,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE;QACrC,sBAAsB,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,GAAqB,EAAE,GAAc;IAC7E,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,gBAAgB,EAAE,EAAE,GAAG,EAAE,GAAG,kBAAkB,EAAE,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjI,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,CAAC,KAAK,YAAY,YAAY,CAAC,EAAE,CAAC;YACrC,MAAM,KAAK,CAAC;QACd,CAAC;QACD,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;AACH,CAAC;AAED,MAAM,WAAW,GAAG,CAAC,GAAqB,EAAiC,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,oBAAoB,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAEhJ,SAAS,sBAAsB,CAAC,GAAqB;IACnD,KAAK,MAAM,MAAM,IAAI,sBAAsB,CAAC,kBAAkB,EAAE,CAAC,EAAE,CAAC;QAClE,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACnC,CAAC;AACH,CAAC;AAED,MAAM,kBAAkB,GAAG,GAAgB,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,SAAS,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;AAEhI,MAAM,OAAO,GAAG,CAAC,IAAY,EAAY,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC"}

package/dist/extensions/settings-env/index.d.ts

@@ -0,0 +1,2 @@
+import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';
+export default function settingsEnvExtension(pi: ExtensionAPI): void;

package/dist/extensions/settings-env/index.js

@@ -0,0 +1,35 @@
+import { homedir } from 'node:os';
+import { claudeConfigDir } from '../../kernel/claude-home/config-dir.js';
+import { projectFolders } from '../../kernel/claude-home/project-folders.js';
+import { projectSettingsFiles } from '../../kernel/claude-home/project-settings.js';
+import { reservedEnvKeys } from '../../kernel/claude-home/reserved-env-keys.js';
+import { userSettingsPath } from '../../kernel/claude-home/user-settings.js';
+import { projectTrustFor } from '../../kernel/project-trust/project-trust.js';
+import { applyEnv } from '../../kernel/settings-env/apply-env.js';
+import { readEnvBlocks } from '../../kernel/settings-env/env-blocks.js';
+import { OwnedEnvironment } from '../../kernel/settings-env/owned-environment.js';
+import { refusalNotice } from '../../kernel/settings-env/refusal-notice.js';
+// The one factory that works as pi loads it: the user block must be in the environment before any extension's
+// session_start.
+export default function settingsEnvExtension(pi) {
+    const environment = new OwnedEnvironment(process.env);
+    const reserved = reservedEnvKeys(process.env);
+    const userFiles = [userSettingsPath(claudeConfigDir(process.env, homedir()))];
+    const userRefusals = applyEnv(readEnvBlocks(userFiles), environment, reserved);
+    pi.on('session_start', async (_event, ctx) => {
+        report(userRefusals, ctx);
+        if ((await projectTrustFor(ctx)) === 'trusted') {
+            const projectFiles = projectSettingsFiles(projectFolders(ctx.cwd, homedir()));
+            report(applyEnv(readEnvBlocks(projectFiles), environment, reserved), ctx);
+        }
+    });
+    pi.on('session_shutdown', () => {
+        environment.restore();
+    });
+}
+function report(refusals, ctx) {
+    for (const refusal of refusals) {
+        ctx.ui.notify(refusalNotice(refusal), 'warning');
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/extensions/settings-env/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extensions/settings-env/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,6CAA6C,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AACpF,OAAO,EAAE,eAAe,EAAE,MAAM,+CAA+C,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAC;AAC9E,OAAO,EAAE,QAAQ,EAAmB,MAAM,wCAAwC,CAAC;AACnF,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gDAAgD,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAE5E,8GAA8G;AAC9G,iBAAiB;AACjB,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAAC,EAAgB;IAC3D,MAAM,WAAW,GAAG,IAAI,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,CAAC,gBAAgB,CAAC,eAAe,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9E,MAAM,YAAY,GAAG,QAAQ,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC/E,EAAE,CAAC,EAAE,CAAC,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;QAC3C,MAAM,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;QAC1B,IAAI,CAAC,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;YAC/C,MAAM,YAAY,GAAG,oBAAoB,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;YAC9E,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,YAAY,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,EAAE,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAC7B,WAAW,CAAC,OAAO,EAAE,CAAC;IACxB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,MAAM,CAAC,QAA+B,EAAE,GAAqB;IACpE,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,CAAC;IACnD,CAAC;AACH,CAAC"}

package/dist/extensions/skills/errors.d.ts

@@ -0,0 +1,13 @@
+import { AntharaError } from '../../errors/anthara-error.js';
+export declare class InvalidSkillReferenceError extends AntharaError {
+    constructor(raw: string);
+}
+export declare class UnknownSkillError extends AntharaError {
+    constructor(requested: string, closestNames: readonly string[]);
+}
+export declare class AmbiguousSkillError extends AntharaError {
+    constructor(requested: string, candidates: readonly string[]);
+}
+export declare class SkillNotModelInvocableError extends AntharaError {
+    constructor(qualifiedName: string);
+}

package/dist/extensions/skills/errors.js

@@ -0,0 +1,23 @@
+import { AntharaError } from '../../errors/anthara-error.js';
+export class InvalidSkillReferenceError extends AntharaError {
+    constructor(raw) {
+        super(`"${raw}" is not a skill name. Use <plugin>:<skill>, for example my-plugin:review, or just the skill name.`);
+    }
+}
+export class UnknownSkillError extends AntharaError {
+    constructor(requested, closestNames) {
+        const suggestion = closestNames.length === 0 ? 'No skills are available.' : `The closest skills are ${closestNames.join(', ')}.`;
+        super(`Unknown skill "${requested}". ${suggestion}`);
+    }
+}
+export class AmbiguousSkillError extends AntharaError {
+    constructor(requested, candidates) {
+        super(`The skill name "${requested}" matches several skills: ${candidates.join(', ')}. Use the plugin-qualified name.`);
+    }
+}
+export class SkillNotModelInvocableError extends AntharaError {
+    constructor(qualifiedName) {
+        super(`${qualifiedName} can only be run by the user. Ask the user to run /${qualifiedName}.`);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/extensions/skills/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/extensions/skills/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAE7D,MAAM,OAAO,0BAA2B,SAAQ,YAAY;IAC1D,YAAY,GAAW;QACrB,KAAK,CAAC,IAAI,GAAG,oGAAoG,CAAC,CAAC;IACrH,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,YAAY;IACjD,YAAY,SAAiB,EAAE,YAA+B;QAC5D,MAAM,UAAU,GACd,YAAY,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,0BAA0B,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;QAChH,KAAK,CAAC,kBAAkB,SAAS,MAAM,UAAU,EAAE,CAAC,CAAC;IACvD,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,YAAY;IACnD,YAAY,SAAiB,EAAE,UAA6B;QAC1D,KAAK,CAAC,mBAAmB,SAAS,6BAA6B,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;IAC1H,CAAC;CACF;AAED,MAAM,OAAO,2BAA4B,SAAQ,YAAY;IAC3D,YAAY,aAAqB;QAC/B,KAAK,CAAC,GAAG,aAAa,sDAAsD,aAAa,GAAG,CAAC,CAAC;IAChG,CAAC;CACF"}

package/dist/extensions/skills/fork-errors.d.ts

@@ -0,0 +1,7 @@
+import { AntharaError } from '../../errors/anthara-error.js';
+export declare class ForkedSkillUnavailableError extends AntharaError {
+    constructor(skill: string);
+}
+export declare class ForkedSkillFailedError extends AntharaError {
+    constructor(skill: string, reason: string);
+}

package/dist/extensions/skills/fork-errors.js

@@ -0,0 +1,12 @@
+import { AntharaError } from '../../errors/anthara-error.js';
+export class ForkedSkillUnavailableError extends AntharaError {
+    constructor(skill) {
+        super(`Skill ${skill} runs in a forked sub-agent, but this session has no sub-agent runner.`);
+    }
+}
+export class ForkedSkillFailedError extends AntharaError {
+    constructor(skill, reason) {
+        super(`The forked sub-agent of skill ${skill} failed: ${reason}`);
+    }
+}
+//# sourceMappingURL=fork-errors.js.map

package/dist/extensions/skills/fork-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fork-errors.js","sourceRoot":"","sources":["../../../src/extensions/skills/fork-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAE7D,MAAM,OAAO,2BAA4B,SAAQ,YAAY;IAC3D,YAAY,KAAa;QACvB,KAAK,CAAC,SAAS,KAAK,wEAAwE,CAAC,CAAC;IAChG,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,YAAY;IACtD,YAAY,KAAa,EAAE,MAAc;QACvC,KAAK,CAAC,iCAAiC,KAAK,YAAY,MAAM,EAAE,CAAC,CAAC;IACpE,CAAC;CACF"}

package/dist/extensions/skills/fork-skill.d.ts

@@ -0,0 +1,6 @@
+import type { ExtensionContext } from '@earendil-works/pi-coding-agent';
+import type { ParentContext } from '../../kernel/agent-runner/sub-agent-runner.js';
+import type { SkillInvocable } from '../../kernel/prompt-catalog/invocable.js';
+export type ForkContext = ParentContext & Pick<ExtensionContext, 'sessionManager'>;
+export declare const isForkedSkill: ({ fields }: SkillInvocable) => boolean;
+export declare function runForkedSkill(skill: SkillInvocable, prompt: string, ctx: ForkContext, signal: AbortSignal | undefined): Promise<string>;

package/dist/extensions/skills/fork-skill.js

@@ -0,0 +1,46 @@
+import { agentRunnerFor } from '../../kernel/agent-runner/agent-runner-slot.js';
+import { backgroundMailbox } from '../../kernel/background-mailbox/background-mailbox.js';
+import { isFlagSet, textField } from '../../kernel/frontmatter/frontmatter-fields.js';
+import { ForkedSkillFailedError, ForkedSkillUnavailableError } from './fork-errors.js';
+const FORK_CONTEXT = 'fork';
+const DEFAULT_AGENT = 'general-purpose';
+const FORK_RESULT_MESSAGE = 'anthara-skill-fork';
+export const isForkedSkill = ({ fields }) => textField(fields, 'context')?.toLowerCase() === FORK_CONTEXT;
+export async function runForkedSkill(skill, prompt, ctx, signal) {
+    const runner = runnerFor(skill, ctx);
+    const request = requestFor(skill, prompt);
+    return isFlagSet(skill.fields, 'background') ? startInBackground(skill, runner.run(request, ctx, undefined)) : finishInForeground(skill, await runner.run(request, ctx, signal));
+}
+function runnerFor(skill, ctx) {
+    const lookup = agentRunnerFor(ctx.sessionManager.getSessionId());
+    if (lookup.kind === 'unavailable') {
+        throw new ForkedSkillUnavailableError(skill.qualifiedName);
+    }
+    return lookup.runner;
+}
+const requestFor = ({ fields, qualifiedName }, prompt) => ({
+    subagentType: textField(fields, 'agent') ?? DEFAULT_AGENT,
+    description: qualifiedName,
+    prompt,
+});
+function finishInForeground(skill, outcome) {
+    if (outcome.kind === 'failed') {
+        throw new ForkedSkillFailedError(skill.qualifiedName, outcome.reason);
+    }
+    return skillResult(skill, `The skill ran in a forked sub-agent, which shared no conversation history. Its result:\n\n${outcome.text}`);
+}
+function startInBackground(skill, running) {
+    void running.then((outcome) => {
+        postToConversation(skill, outcome.kind === 'completed' ? finished(skill, outcome.text) : didNotFinish(skill, outcome.reason));
+    }, (error) => {
+        postToConversation(skill, didNotFinish(skill, error instanceof Error ? error.message : String(error)));
+    });
+    return skillResult(skill, 'The skill is running in a forked sub-agent in the background. Its result arrives in the conversation when it finishes; carry on with other work meanwhile.');
+}
+const finished = ({ qualifiedName }, text) => `The forked sub-agent of skill ${qualifiedName} finished. Its result:\n\n${text}`;
+const didNotFinish = ({ qualifiedName }, reason) => `The forked sub-agent of skill ${qualifiedName} did not finish: ${reason}`;
+const postToConversation = (skill, text) => {
+    backgroundMailbox().post({ customType: FORK_RESULT_MESSAGE, content: skillResult(skill, text) });
+};
+const skillResult = ({ name, filePath }, text) => `<skill name="${name}" location="${filePath}">\n${text}\n</skill>`;
+//# sourceMappingURL=fork-skill.js.map

package/dist/extensions/skills/fork-skill.js.map

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

package/dist/extensions/skills/index.d.ts

@@ -0,0 +1,2 @@
+import { type ExtensionAPI } from '@earendil-works/pi-coding-agent';
+export default function skillsExtension(pi: ExtensionAPI): void;

package/dist/extensions/skills/index.js

@@ -0,0 +1,55 @@
+import { getAgentDir } from '@earendil-works/pi-coding-agent';
+import { skillMirrorRoot } from '../../kernel/claude-home/skill-mirror-layout.js';
+import { releaseSessionPluginCatalog } from '../../kernel/plugin-catalog/catalog-slot.js';
+import { projectTrustFor } from '../../kernel/project-trust/project-trust.js';
+import { scopedHooks } from '../../kernel/scoped-hooks/scoped-hooks.js';
+import { announcePromptExpansion } from '../../kernel/prompt-expansion-events/prompt-expansion-events.js';
+import { SessionPromptCatalog } from '../../kernel/prompt-catalog/session-prompt-catalog.js';
+import { AntharaError } from '../../errors/anthara-error.js';
+import { expandTypedSkill } from './namespaced-input.js';
+import { piSkillPaths } from './pi-skill-paths.js';
+import { skillAutocompleteProvider } from './skill-autocomplete.js';
+import { SkillInvoker } from './skill-invoker.js';
+import { skillTool } from './skill-tool.js';
+import { UnreadableSkillReports } from './unreadable-skill-reports.js';
+export default function skillsExtension(pi) {
+    const session = new SessionPromptCatalog();
+    const invoker = new SkillInvoker(pi);
+    const unreadable = new UnreadableSkillReports();
+    pi.registerTool(skillTool(session, invoker));
+    pi.on('input', (event, ctx) => (event.source === 'extension' ? { action: 'continue' } : typedSkill(event.text, session.catalogFor(ctx), invoker, pi, ctx)));
+    pi.on('resources_discover', async (_event, ctx) => {
+        const catalog = session.refresh(ctx);
+        unreadable.report(catalog, ctx);
+        return { skillPaths: piSkillPaths(catalog, await projectTrustFor(ctx), skillMirrorRoot(getAgentDir())) };
+    });
+    pi.on('session_start', (_event, ctx) => {
+        if (ctx.hasUI) {
+            ctx.ui.addAutocompleteProvider((current) => skillAutocompleteProvider(current, () => session.catalogFor(ctx)));
+        }
+    });
+    pi.on('session_shutdown', (_event, ctx) => {
+        releaseSession(ctx.sessionManager.getSessionId());
+    });
+}
+function releaseSession(sessionId) {
+    releaseSessionPluginCatalog(sessionId);
+    scopedHooks().release(sessionId);
+}
+async function typedSkill(text, catalog, invoker, pi, ctx) {
+    try {
+        return await expandTypedSkill(text, catalog, async (skill, args) => {
+            const expanded = await invoker.invoke({ skill, args }, ctx);
+            announcePromptExpansion(pi.events, { commandName: skill.qualifiedName, commandArgs: args, commandSource: skill.scope, prompt: text });
+            return expanded;
+        });
+    }
+    catch (error) {
+        if (error instanceof AntharaError) {
+            ctx.ui.notify(error.message, 'error');
+            return { action: 'handled' };
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/extensions/skills/index.js.map

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

package/dist/extensions/skills/namespaced-input.d.ts

@@ -0,0 +1,4 @@
+import type { InputEventResult } from '@earendil-works/pi-coding-agent';
+import type { PromptCatalog, SkillInvocable } from '../../kernel/prompt-catalog/invocable.js';
+export type SkillRun = (skill: SkillInvocable, args: string) => Promise<string>;
+export declare function expandTypedSkill(text: string, catalog: PromptCatalog, run: SkillRun): Promise<InputEventResult>;

package/dist/extensions/skills/namespaced-input.js

@@ -0,0 +1,18 @@
+const TYPED_COMMAND = /^\s*\/(?<head>[^\s:/]+):(?<name>[^\s:/]+)(?=\s|$)(?<rest>[\s\S]*)$/;
+const PI_SKILL_COMMAND = 'skill';
+export async function expandTypedSkill(text, catalog, run) {
+    const typed = parseTypedSkill(text);
+    if (typed === undefined) {
+        return { action: 'continue' };
+    }
+    const lookup = catalog.find(typed.reference);
+    return lookup.kind === 'found' && lookup.invocable.kind === 'skill' ? { action: 'transform', text: await run(lookup.invocable, typed.args) } : { action: 'continue' };
+}
+function parseTypedSkill(text) {
+    const groups = TYPED_COMMAND.exec(text)?.groups;
+    if (groups === undefined) {
+        return undefined;
+    }
+    return { reference: groups.head === PI_SKILL_COMMAND ? groups.name : `${groups.head}:${groups.name}`, args: groups.rest.trim() };
+}
+//# sourceMappingURL=namespaced-input.js.map

package/dist/extensions/skills/namespaced-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespaced-input.js","sourceRoot":"","sources":["../../../src/extensions/skills/namespaced-input.ts"],"names":[],"mappings":"AAQA,MAAM,aAAa,GAAG,oEAAoE,CAAC;AAC3F,MAAM,gBAAgB,GAAG,OAAO,CAAC;AAIjC,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAY,EAAE,OAAsB,EAAE,GAAa;IACxF,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAChC,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC7C,OAAO,MAAM,CAAC,IAAI,KAAK,OAAO,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AACxK,CAAC;AAQD,SAAS,eAAe,CAAC,IAAY;IACnC,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAwC,CAAC;IAClF,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,IAAI,KAAK,gBAAgB,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;AACnI,CAAC"}

package/dist/extensions/skills/pi-skill-paths.d.ts

@@ -0,0 +1,3 @@
+import type { PromptCatalog } from '../../kernel/prompt-catalog/invocable.js';
+import type { TrustState } from '../../kernel/project-trust/trust-state.js';
+export declare function piSkillPaths(catalog: PromptCatalog, trust: TrustState, mirrorRoot: string): string[];

package/dist/extensions/skills/pi-skill-paths.js

@@ -0,0 +1,7 @@
+import { syncSkillMirrors } from './skill-mirrors/skill-mirrors.js';
+export function piSkillPaths(catalog, trust, mirrorRoot) {
+    const listed = catalog.skills().filter(({ scope }) => scope !== 'project' || trust === 'trusted');
+    const mirrored = syncSkillMirrors(listed, mirrorRoot);
+    return listed.map(({ filePath }) => mirrored.get(filePath) ?? filePath);
+}
+//# sourceMappingURL=pi-skill-paths.js.map

package/dist/extensions/skills/pi-skill-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-skill-paths.js","sourceRoot":"","sources":["../../../src/extensions/skills/pi-skill-paths.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEpE,MAAM,UAAU,YAAY,CAAC,OAAsB,EAAE,KAAiB,EAAE,UAAkB;IACxF,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC;IAClG,MAAM,QAAQ,GAAG,gBAAgB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACtD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,CAAC;AAC1E,CAAC"}

package/dist/extensions/skills/skill-autocomplete.d.ts

@@ -0,0 +1,3 @@
+import { type AutocompleteProvider } from '@earendil-works/pi-tui';
+import type { PromptCatalog } from '../../kernel/prompt-catalog/invocable.js';
+export declare function skillAutocompleteProvider(current: AutocompleteProvider, catalog: () => PromptCatalog): AutocompleteProvider;

package/dist/extensions/skills/skill-autocomplete.js

@@ -0,0 +1,33 @@
+import { fuzzyFilter, } from '@earendil-works/pi-tui';
+import { commandNameTypedAtLineStart, menuItemOf } from '../../kernel/prompt-catalog/slash-menu.js';
+const PI_SKILL_COMMAND_PREFIX = 'skill:';
+export function skillAutocompleteProvider(current, catalog) {
+    return {
+        getSuggestions: async (lines, cursorLine, cursorCol, options) => {
+            const inherited = withoutHiddenSkills(await current.getSuggestions(lines, cursorLine, cursorCol, options), catalog());
+            const typed = commandNameTypedAtLineStart(lines[cursorLine] ?? '', cursorCol, options);
+            if (typed === undefined) {
+                return inherited;
+            }
+            const own = matchingCommands(catalog(), typed);
+            return own.length === 0 ? inherited : mergeSuggestions(own, inherited, typed);
+        },
+        applyCompletion: (lines, cursorLine, cursorCol, item, prefix) => current.applyCompletion(lines, cursorLine, cursorCol, item, prefix),
+    };
+}
+function withoutHiddenSkills(suggestions, catalog) {
+    if (suggestions === null) {
+        return null;
+    }
+    const hidden = new Set(catalog.skills().filter(({ userInvocable }) => !userInvocable).map(({ name }) => PI_SKILL_COMMAND_PREFIX + name));
+    const items = suggestions.items.filter(({ value }) => !hidden.has(value.replace(/^\//, '')));
+    return items.length === suggestions.items.length ? suggestions : { ...suggestions, items };
+}
+function mergeSuggestions(own, inherited, typed) {
+    return { items: [...own, ...(inherited?.items ?? [])], prefix: inherited?.prefix ?? `/${typed}` };
+}
+function matchingCommands(catalog, typed) {
+    const menu = catalog.namespaced().filter(({ userInvocable }) => userInvocable);
+    return fuzzyFilter(menu, typed, ({ qualifiedName }) => qualifiedName).map(menuItemOf);
+}
+//# sourceMappingURL=skill-autocomplete.js.map

package/dist/extensions/skills/skill-autocomplete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-autocomplete.js","sourceRoot":"","sources":["../../../src/extensions/skills/skill-autocomplete.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,GAIZ,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,2BAA2B,EAAE,UAAU,EAAE,MAAM,2CAA2C,CAAC;AAEpG,MAAM,uBAAuB,GAAG,QAAQ,CAAC;AAEzC,MAAM,UAAU,yBAAyB,CAAC,OAA6B,EAAE,OAA4B;IACnG,OAAO;QACL,cAAc,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE;YAC9D,MAAM,SAAS,GAAG,mBAAmB,CAAC,MAAM,OAAO,CAAC,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;YACtH,MAAM,KAAK,GAAG,2BAA2B,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;YACvF,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,MAAM,GAAG,GAAG,gBAAgB,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,CAAC;YAC/C,OAAO,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QAChF,CAAC;QACD,eAAe,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAC9D,OAAO,CAAC,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC;KACtE,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,WAA2C,EAAE,OAAsB;IAC9F,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAAC,CAAC;IACzI,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7F,OAAO,KAAK,CAAC,MAAM,KAAK,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,GAAG,WAAW,EAAE,KAAK,EAAE,CAAC;AAC7F,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAuB,EAAE,SAAyC,EAAE,KAAa;IACzG,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,GAAG,EAAE,GAAG,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;AACpG,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAsB,EAAE,KAAa;IAC7D,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC;IAC/E,OAAO,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;AACxF,CAAC"}

package/dist/extensions/skills/skill-block.d.ts

@@ -0,0 +1,2 @@
+import type { Invocable } from '../../kernel/prompt-catalog/invocable.js';
+export declare const skillBlock: ({ name, filePath, dir }: Invocable, expanded: string) => string;

package/dist/extensions/skills/skill-block.js

@@ -0,0 +1,2 @@
+export const skillBlock = ({ name, filePath, dir }, expanded) => `<skill name="${name}" location="${filePath}">\nReferences are relative to ${dir}.\n\n${expanded}\n</skill>`;
+//# sourceMappingURL=skill-block.js.map

package/dist/extensions/skills/skill-block.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-block.js","sourceRoot":"","sources":["../../../src/extensions/skills/skill-block.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAa,EAAE,QAAgB,EAAU,EAAE,CACzF,gBAAgB,IAAI,eAAe,QAAQ,kCAAkC,GAAG,QAAQ,QAAQ,YAAY,CAAC"}

package/dist/extensions/skills/skill-hooks.d.ts

@@ -0,0 +1,2 @@
+import type { SkillInvocable } from '../../kernel/prompt-catalog/invocable.js';
+export declare function rememberSkillHooks({ fields, qualifiedName, scope }: SkillInvocable, sessionId: string): void;

package/dist/extensions/skills/skill-hooks.js

@@ -0,0 +1,8 @@
+import { isJsonObject } from '../../kernel/private-files/private-files.js';
+import { scopedHooks } from '../../kernel/scoped-hooks/scoped-hooks.js';
+export function rememberSkillHooks({ fields, qualifiedName, scope }, sessionId) {
+    if (isJsonObject(fields.hooks)) {
+        scopedHooks().add(sessionId, { name: `skill ${qualifiedName}`, fromProject: scope === 'project', hooks: fields.hooks });
+    }
+}
+//# sourceMappingURL=skill-hooks.js.map

package/dist/extensions/skills/skill-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-hooks.js","sourceRoot":"","sources":["../../../src/extensions/skills/skill-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,6CAA6C,CAAC;AAE3E,OAAO,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AAExE,MAAM,UAAU,kBAAkB,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,KAAK,EAAkB,EAAE,SAAiB;IACpG,IAAI,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,WAAW,EAAE,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,aAAa,EAAE,EAAE,WAAW,EAAE,KAAK,KAAK,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IAC1H,CAAC;AACH,CAAC"}

package/dist/extensions/skills/skill-invoker.d.ts

@@ -0,0 +1,16 @@
+import type { Invocable } from '../../kernel/prompt-catalog/invocable.js';
+import { type ExpansionApi, type ExpansionContext } from '../../kernel/prompt-expansion/expand-invocable.js';
+import { type ForkContext } from './fork-skill.js';
+type InvokerContext = ExpansionContext & ForkContext;
+export interface SkillCall {
+    readonly skill: Invocable;
+    readonly args: string;
+    readonly toolCallId?: string;
+    readonly signal?: AbortSignal | undefined;
+}
+export declare class SkillInvoker {
+    #private;
+    constructor(pi: ExpansionApi);
+    invoke(call: SkillCall, ctx: InvokerContext): Promise<string>;
+}
+export {};

package/dist/extensions/skills/skill-invoker.js

@@ -0,0 +1,24 @@
+import { isSubAgentToolCall } from '../../kernel/agent-runner/sub-agent-tool-calls.js';
+import { expandInvocable } from '../../kernel/prompt-expansion/expand-invocable.js';
+import { isForkedSkill, runForkedSkill } from './fork-skill.js';
+import { skillBlock } from './skill-block.js';
+import { rememberSkillHooks } from './skill-hooks.js';
+const isForked = (prompt) => prompt.kind === 'skill' && isForkedSkill(prompt);
+const isMadeByASubAgent = ({ toolCallId }) => toolCallId !== undefined && isSubAgentToolCall(toolCallId);
+// A sub-agent cannot start another one, so a forked skill that a sub-agent calls runs in the sub-agent's own context.
+const startsASubAgent = (call) => isForked(call.skill) && !isMadeByASubAgent(call);
+export class SkillInvoker {
+    #pi;
+    constructor(pi) {
+        this.#pi = pi;
+    }
+    async invoke(call, ctx) {
+        const { skill, args } = call;
+        if (skill.kind === 'skill') {
+            rememberSkillHooks(skill, ctx.sessionManager.getSessionId());
+        }
+        const block = skillBlock(skill, await expandInvocable(skill, args, this.#pi, ctx));
+        return startsASubAgent(call) ? runForkedSkill(call.skill, block, ctx, call.signal) : block;
+    }
+}
+//# sourceMappingURL=skill-invoker.js.map

package/dist/extensions/skills/skill-invoker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-invoker.js","sourceRoot":"","sources":["../../../src/extensions/skills/skill-invoker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AAEvF,OAAO,EAAE,eAAe,EAA4C,MAAM,mDAAmD,CAAC;AAC9H,OAAO,EAAE,aAAa,EAAE,cAAc,EAAoB,MAAM,iBAAiB,CAAC;AAClF,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAetD,MAAM,QAAQ,GAAG,CAAC,MAAiB,EAA4B,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;AAEnH,MAAM,iBAAiB,GAAG,CAAC,EAAE,UAAU,EAAa,EAAW,EAAE,CAAC,UAAU,KAAK,SAAS,IAAI,kBAAkB,CAAC,UAAU,CAAC,CAAC;AAE7H,sHAAsH;AACtH,MAAM,eAAe,GAAG,CAAC,IAAe,EAAuB,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;AAEnH,MAAM,OAAO,YAAY;IACd,GAAG,CAAe;IAE3B,YAAY,EAAgB;QAC1B,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAe,EAAE,GAAmB;QAC/C,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QAC7B,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC3B,kBAAkB,CAAC,KAAK,EAAE,GAAG,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,MAAM,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;QACnF,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC7F,CAAC;CACF"}

package/dist/extensions/skills/skill-mirrors/skill-mirror-store.d.ts

@@ -0,0 +1,13 @@
+export interface PluginSkillDir {
+    readonly plugin: string;
+    readonly skillName: string;
+    readonly dir: string;
+}
+export interface RepairedFrontmatter {
+    readonly markdown: string;
+}
+type RenameDirectory = (from: string, to: string) => void;
+export declare function writeSkillMirror(source: PluginSkillDir, repaired: RepairedFrontmatter, mirrorRoot: string, renameDirectory?: RenameDirectory): void;
+export declare function isSkillMirrorCurrent(source: PluginSkillDir, repaired: RepairedFrontmatter, mirrorRoot: string): boolean;
+export declare function removeStaleMirrors(mirrorRoot: string, keptMirrorDirs: readonly string[]): void;
+export {};