@anthara/pi-claude 0.0.0-stage → 0.1.0

package/dist/extensions/skills/skill-mirrors/skill-mirror-store.js

@@ -0,0 +1,113 @@
+import { randomUUID } from 'node:crypto';
+import { cpSync, existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, renameSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { SKILL_FILE, skillMirrorDir, skillMirrorStagingRoot } from '../../../kernel/claude-home/skill-mirror-layout.js';
+import { removeWithin } from '../../../kernel/private-files/confined-removal.js';
+import { isMissingPath, isOccupiedRenameTarget } from '../../../kernel/private-files/file-system-errors.js';
+import { sweepOldLeftovers, timestampedPrefix } from '../../../kernel/private-files/leftovers.js';
+const SOURCE_MARKER_FILE = '.mirrored-from';
+const STAGED_PREFIX = 'staged-';
+const RETIRED_PREFIX = 'retired-';
+const LEFTOVER_PREFIXES = [STAGED_PREFIX, RETIRED_PREFIX];
+// The mirror is built beside the mirror root and renamed into place, so a session reading it meets the old mirror or the
+// whole new one, never a half-written file. A failure part way leaves the old mirror in place, and every session runs
+// this on discovery, so another one publishing the same mirror at the same moment is not an error.
+export function writeSkillMirror(source, repaired, mirrorRoot, renameDirectory = renameSync) {
+    const mirrorDir = skillMirrorDir(mirrorRoot, source.plugin, source.skillName);
+    const placement = { mirrorDir, stagingRoot: skillMirrorStagingRoot(mirrorRoot), renameDirectory };
+    const staged = stageMirror(source, repaired, placement.stagingRoot);
+    try {
+        publishMirror(staged, placement);
+    }
+    catch (error) {
+        removeWithin(placement.stagingRoot, staged);
+        if (!isOccupiedRenameTarget(error) || !isSkillMirrorCurrent(source, repaired, mirrorRoot)) {
+            throw error;
+        }
+    }
+}
+function stageMirror(source, repaired, stagingRoot) {
+    mkdirSync(stagingRoot, { recursive: true });
+    sweepOldLeftovers(stagingRoot, LEFTOVER_PREFIXES);
+    const staged = mkdtempSync(join(stagingRoot, timestampedPrefix(STAGED_PREFIX)));
+    try {
+        cpSync(source.dir, staged, { recursive: true, filter: (path) => path !== join(source.dir, SKILL_FILE) });
+        writeFileSync(join(staged, SOURCE_MARKER_FILE), source.dir);
+        writeFileSync(join(staged, SKILL_FILE), repaired.markdown);
+        return staged;
+    }
+    catch (error) {
+        removeWithin(stagingRoot, staged);
+        throw error;
+    }
+}
+function publishMirror(staged, placement) {
+    mkdirSync(dirname(placement.mirrorDir), { recursive: true });
+    const retired = retireMirror(placement);
+    try {
+        placement.renameDirectory(staged, placement.mirrorDir);
+    }
+    catch (error) {
+        retired.forEach((retiredMirror) => {
+            restoreMirror(retiredMirror, placement);
+        });
+        throw error;
+    }
+    retired.forEach((retiredMirror) => {
+        removeWithin(placement.stagingRoot, retiredMirror);
+    });
+}
+// there is nothing to retire when there is no mirror yet, or when another session moved it aside first
+function retireMirror(placement) {
+    const retired = join(placement.stagingRoot, `${timestampedPrefix(RETIRED_PREFIX)}${randomUUID()}`);
+    try {
+        placement.renameDirectory(placement.mirrorDir, retired);
+        return [retired];
+    }
+    catch (error) {
+        if (isMissingPath(error)) {
+            return [];
+        }
+        throw error;
+    }
+}
+// the old mirror goes back in place, unless another session's publish already stands there
+function restoreMirror(retired, placement) {
+    try {
+        placement.renameDirectory(retired, placement.mirrorDir);
+    }
+    catch (error) {
+        if (!isOccupiedRenameTarget(error)) {
+            throw error;
+        }
+        removeWithin(placement.stagingRoot, retired);
+    }
+}
+// A mirror that still matches its source is never rewritten, so sessions that only discover resources leave it untouched.
+export function isSkillMirrorCurrent(source, repaired, mirrorRoot) {
+    const mirrorDir = skillMirrorDir(mirrorRoot, source.plugin, source.skillName);
+    return (readTextIfPresent(join(mirrorDir, SKILL_FILE)) === repaired.markdown &&
+        readTextIfPresent(join(mirrorDir, SOURCE_MARKER_FILE)) === source.dir);
+}
+export function removeStaleMirrors(mirrorRoot, keptMirrorDirs) {
+    if (!existsSync(mirrorRoot)) {
+        return;
+    }
+    for (const entry of readdirSync(mirrorRoot, { withFileTypes: true })) {
+        const entryPath = join(mirrorRoot, entry.name);
+        const stale = entry.isDirectory() ? staleInPluginDirectory(entryPath, keptMirrorDirs) : strayEntry(entryPath);
+        for (const path of stale) {
+            removeWithin(mirrorRoot, path);
+        }
+    }
+}
+const strayEntry = (entryPath) => [entryPath];
+function staleInPluginDirectory(pluginDir, kept) {
+    const skillDirs = readdirSync(pluginDir).map((name) => join(pluginDir, name));
+    const stale = skillDirs.filter((skillDir) => !kept.includes(skillDir));
+    return stale.length === skillDirs.length ? [pluginDir] : stale;
+}
+function readTextIfPresent(path) {
+    return existsSync(path) ? readFileSync(path, 'utf8') : undefined;
+}
+//# sourceMappingURL=skill-mirror-store.js.map

package/dist/extensions/skills/skill-mirrors/skill-mirror-store.js.map

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

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

@@ -0,0 +1,3 @@
+import type { SkillInvocable } from '../../../kernel/prompt-catalog/invocable.js';
+export type MirroredSkillFiles = ReadonlyMap<string, string>;
+export declare function syncSkillMirrors(skills: readonly SkillInvocable[], mirrorRoot: string): MirroredSkillFiles;

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

@@ -0,0 +1,21 @@
+import { basename, join } from 'node:path';
+import { SKILL_FILE, skillMirrorDir } from '../../../kernel/claude-home/skill-mirror-layout.js';
+import { isSkillMirrorCurrent, removeStaleMirrors, writeSkillMirror } from './skill-mirror-store.js';
+export function syncSkillMirrors(skills, mirrorRoot) {
+    const pending = skills.flatMap(mirrorNeededBy);
+    const mirrorDirOf = ({ source }) => skillMirrorDir(mirrorRoot, source.plugin, source.skillName);
+    removeStaleMirrors(mirrorRoot, pending.map(mirrorDirOf));
+    for (const { source, markdown } of pending) {
+        if (!isSkillMirrorCurrent(source, { markdown }, mirrorRoot)) {
+            writeSkillMirror(source, { markdown }, mirrorRoot);
+        }
+    }
+    return new Map(pending.map((mirror) => [join(mirror.source.dir, SKILL_FILE), join(mirrorDirOf(mirror), SKILL_FILE)]));
+}
+function mirrorNeededBy({ plugin, piMarkdown, dir }) {
+    if (plugin === undefined || piMarkdown === undefined || dir === plugin.root) {
+        return [];
+    }
+    return [{ source: { plugin: plugin.name, skillName: basename(dir), dir }, markdown: piMarkdown }];
+}
+//# sourceMappingURL=skill-mirrors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill-mirrors.js","sourceRoot":"","sources":["../../../../src/extensions/skills/skill-mirrors/skill-mirrors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAC;AAEhG,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,gBAAgB,EAAuB,MAAM,yBAAyB,CAAC;AAS1H,MAAM,UAAU,gBAAgB,CAAC,MAAiC,EAAE,UAAkB;IACpF,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAC/C,MAAM,WAAW,GAAG,CAAC,EAAE,MAAM,EAAiB,EAAU,EAAE,CAAC,cAAc,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IACvH,kBAAkB,CAAC,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC;IACzD,KAAK,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,OAAO,EAAE,CAAC;QAC3C,IAAI,CAAC,oBAAoB,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,EAAE,UAAU,CAAC,EAAE,CAAC;YAC5D,gBAAgB,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,EAAE,UAAU,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IACD,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AACxH,CAAC;AAED,SAAS,cAAc,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAkB;IACjE,IAAI,MAAM,KAAK,SAAS,IAAI,UAAU,KAAK,SAAS,IAAI,GAAG,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5E,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,CAAC,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC;AACpG,CAAC"}

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

@@ -0,0 +1,10 @@
+import { defineTool } from '@earendil-works/pi-coding-agent';
+import { Type } from 'typebox';
+import type { SkillInvoker } from './skill-invoker.js';
+import type { SessionPromptCatalog } from '../../kernel/prompt-catalog/session-prompt-catalog.js';
+declare const SkillParameters: Type.TObject<{
+    skill: Type.TString;
+    args: Type.TOptional<Type.TString>;
+}>;
+export declare function skillTool(session: SessionPromptCatalog, invoker: SkillInvoker): ReturnType<typeof defineTool<typeof SkillParameters>>;
+export {};

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

@@ -0,0 +1,44 @@
+import { defineTool } from '@earendil-works/pi-coding-agent';
+import { Type } from 'typebox';
+import { resultWithDetails } from '../../kernel/tool-results/tool-result.js';
+import { AmbiguousSkillError, InvalidSkillReferenceError, SkillNotModelInvocableError, UnknownSkillError } from './errors.js';
+const SKILL_DESCRIPTION = 'Execute a skill within the main conversation. Skills provide specialized capabilities and domain knowledge. ' +
+    'When the user asks for a task that a skill covers, or types a slash command such as /my-plugin:review, invoke this ' +
+    'tool with the skill name before doing anything else, and follow the instructions it returns. ' +
+    'Use the plugin-qualified name, for example "my-plugin:review"; a bare name works when exactly one skill has it.';
+const SkillParameters = Type.Object({
+    skill: Type.String({ description: 'The skill name, for example "my-plugin:review" or "review".' }),
+    args: Type.Optional(Type.String({ description: 'Optional arguments for the skill.' })),
+});
+export function skillTool(session, invoker) {
+    return defineTool({
+        name: 'Skill',
+        label: 'Skill',
+        description: SKILL_DESCRIPTION,
+        parameters: SkillParameters,
+        execute: async (toolCallId, { skill, args }, signal, _onUpdate, ctx) => {
+            const found = modelInvocable(foundSkill(session.catalogFor(ctx).find(skill), skill));
+            const text = await invoker.invoke({ skill: found, args: args ?? '', toolCallId, signal }, ctx);
+            return resultWithDetails(text, { skill: found.qualifiedName });
+        },
+    });
+}
+function foundSkill(lookup, requested) {
+    switch (lookup.kind) {
+        case 'found':
+            return lookup.invocable;
+        case 'ambiguous':
+            throw new AmbiguousSkillError(lookup.requested, lookup.candidates);
+        case 'unknown':
+            throw new UnknownSkillError(lookup.requested, lookup.closest);
+        case 'invalid':
+            throw new InvalidSkillReferenceError(requested);
+    }
+}
+function modelInvocable(skill) {
+    if (!skill.modelInvocable) {
+        throw new SkillNotModelInvocableError(skill.qualifiedName);
+    }
+    return skill;
+}
+//# sourceMappingURL=skill-tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill-tool.js","sourceRoot":"","sources":["../../../src/extensions/skills/skill-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA6B,MAAM,iCAAiC,CAAC;AACxF,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAI9H,MAAM,iBAAiB,GACrB,8GAA8G;IAC9G,qHAAqH;IACrH,+FAA+F;IAC/F,iHAAiH,CAAC;AAEpH,MAAM,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC;IAClC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,6DAA6D,EAAE,CAAC;IAClG,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,mCAAmC,EAAE,CAAC,CAAC;CACvF,CAAC,CAAC;AAEH,MAAM,UAAU,SAAS,CAAC,OAA6B,EAAC,OAAqB;IAC3E,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,OAAO;QACd,WAAW,EAAE,iBAAiB;QAC9B,UAAU,EAAE,eAAe;QAC3B,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,GAAyB,EAAE,EAAE;YAC3F,MAAM,KAAK,GAAG,cAAc,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;YACrF,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,GAAG,CAAC,CAAC;YAC/F,OAAO,iBAAiB,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC;QACjE,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,UAAU,CAAC,MAAuB,EAAE,SAAiB;IAC5D,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,OAAO;YACV,OAAO,MAAM,CAAC,SAAS,CAAC;QAC1B,KAAK,WAAW;YACd,MAAM,IAAI,mBAAmB,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;QACrE,KAAK,SAAS;YACZ,MAAM,IAAI,iBAAiB,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QAChE,KAAK,SAAS;YACZ,MAAM,IAAI,0BAA0B,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,KAAgB;IACtC,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC;QAC1B,MAAM,IAAI,2BAA2B,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/extensions/skills/unreadable-skill-reports.d.ts

@@ -0,0 +1,6 @@
+import type { ExtensionContext } from '@earendil-works/pi-coding-agent';
+import type { PromptCatalog } from '../../kernel/prompt-catalog/invocable.js';
+export declare class UnreadableSkillReports {
+    #private;
+    report(catalog: PromptCatalog, ctx: Pick<ExtensionContext, 'ui'>): void;
+}

package/dist/extensions/skills/unreadable-skill-reports.js

@@ -0,0 +1,12 @@
+export class UnreadableSkillReports {
+    #reported = new Set();
+    report(catalog, ctx) {
+        for (const { filePath, reason } of catalog.unreadable()) {
+            if (!this.#reported.has(filePath)) {
+                this.#reported.add(filePath);
+                ctx.ui.notify(`Cannot read the skill file ${filePath}: ${reason}`, 'warning');
+            }
+        }
+    }
+}
+//# sourceMappingURL=unreadable-skill-reports.js.map

package/dist/extensions/skills/unreadable-skill-reports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unreadable-skill-reports.js","sourceRoot":"","sources":["../../../src/extensions/skills/unreadable-skill-reports.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,sBAAsB;IACxB,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IAEvC,MAAM,CAAC,OAAsB,EAAE,GAAiC;QAC9D,KAAK,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;YACxD,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAClC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBAC7B,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,8BAA8B,QAAQ,KAAK,MAAM,EAAE,EAAE,SAAS,CAAC,CAAC;YAChF,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/extensions/todo-write/index.d.ts

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

package/dist/extensions/todo-write/index.js

@@ -0,0 +1,48 @@
+import { defineTool } from '@earendil-works/pi-coding-agent';
+import { textResult } from '../../kernel/tool-results/tool-result.js';
+import { assertReplaceable } from '../../kernel/todo-list/todo-list-rules.js';
+import { TODO_WRITTEN_TEXT } from '../../kernel/todo-list/todo-result-text.js';
+import { TodoWriteParams } from '../../kernel/todo-list/todo-schema.js';
+import { TODO_WRITE_DESCRIPTION } from '../../kernel/todo-list/todo-write-description.js';
+import { todoListText } from './todo-list-text.js';
+import { panelLines } from './todo-panel.js';
+import { TodoStore } from './todo-store.js';
+const PANEL_KEY = 'todos';
+const PANEL_OPTIONS = { placement: 'aboveEditor' };
+export default function todoWriteExtension(pi) {
+    const store = new TodoStore(pi);
+    pi.registerTool(buildTodoWriteTool(store));
+    pi.registerCommand('todos', {
+        description: 'Show every todo of this session, grouped by status',
+        handler: (_args, ctx) => {
+            ctx.ui.notify(todoListText(store.current()), 'info');
+            return Promise.resolve();
+        },
+    });
+    pi.on('session_start', (_event, ctx) => {
+        store.restore(ctx.sessionManager.getEntries());
+        drawPanel(ctx, store.current());
+    });
+}
+function buildTodoWriteTool(store) {
+    return defineTool({
+        name: 'TodoWrite',
+        label: 'TodoWrite',
+        description: TODO_WRITE_DESCRIPTION,
+        parameters: TodoWriteParams,
+        execute: async (_toolCallId, { todos }, _signal, _onUpdate, ctx) => Promise.resolve(replaceTodoList(store, todos, ctx)),
+    });
+}
+function replaceTodoList(store, todos, ctx) {
+    assertReplaceable(todos);
+    store.replace(todos);
+    drawPanel(ctx, store.current());
+    return textResult(TODO_WRITTEN_TEXT);
+}
+function drawPanel(ctx, items) {
+    if (!ctx.hasUI) {
+        return;
+    }
+    ctx.ui.setWidget(PANEL_KEY, items.length === 0 ? undefined : panelLines(items, ctx.ui.theme), PANEL_OPTIONS);
+}
+//# sourceMappingURL=index.js.map

package/dist/extensions/todo-write/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extensions/todo-write/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA4C,MAAM,iCAAiC,CAAC;AACvG,OAAO,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAiB,MAAM,uCAAuC,CAAC;AACvF,OAAO,EAAE,sBAAsB,EAAE,MAAM,kDAAkD,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,SAAS,GAAG,OAAO,CAAC;AAC1B,MAAM,aAAa,GAAG,EAAE,SAAS,EAAE,aAAa,EAAW,CAAC;AAE5D,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAC,EAAgB;IACzD,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,EAAE,CAAC,CAAC;IAChC,EAAE,CAAC,YAAY,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3C,EAAE,CAAC,eAAe,CAAC,OAAO,EAAE;QAC1B,WAAW,EAAE,oDAAoD;QACjE,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YACtB,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;YACrD,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;KACF,CAAC,CAAC;IACH,EAAE,CAAC,EAAE,CAAC,eAAe,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE;QACrC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,UAAU,EAAE,CAAC,CAAC;QAC/C,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAgB;IAC1C,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,WAAW;QAClB,WAAW,EAAE,sBAAsB;QACnC,UAAU,EAAE,eAAe;QAC3B,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;KACxH,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CAAC,KAAgB,EAAE,KAA0B,EAAE,GAAqB;IAC1F,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACzB,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACrB,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAChC,OAAO,UAAU,CAAC,iBAAiB,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,SAAS,CAAC,GAAqB,EAAE,KAA0B;IAClE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;QACf,OAAO;IACT,CAAC;IACD,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,CAAC;AAC/G,CAAC"}

package/dist/extensions/todo-write/todo-list-text.d.ts

@@ -0,0 +1,3 @@
+import type { TodoItem } from '../../kernel/todo-list/todo-schema.js';
+export declare const NO_TODOS_TEXT = "No todos.";
+export declare function todoListText(items: readonly TodoItem[]): string;

package/dist/extensions/todo-write/todo-list-text.js

@@ -0,0 +1,14 @@
+export const NO_TODOS_TEXT = 'No todos.';
+const GROUPS = [
+    { status: 'in_progress', heading: 'In progress', mark: '◐' },
+    { status: 'pending', heading: 'Pending', mark: '○' },
+    { status: 'completed', heading: 'Completed', mark: '✓' },
+];
+export function todoListText(items) {
+    const sections = GROUPS.flatMap((group) => sectionOf(group, items.filter(({ status }) => status === group.status)));
+    return sections.length === 0 ? NO_TODOS_TEXT : sections.join('\n\n');
+}
+function sectionOf({ heading, mark }, items) {
+    return items.length === 0 ? [] : [[heading, ...items.map(({ content }) => `${mark} ${content}`)].join('\n')];
+}
+//# sourceMappingURL=todo-list-text.js.map

package/dist/extensions/todo-write/todo-list-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo-list-text.js","sourceRoot":"","sources":["../../../src/extensions/todo-write/todo-list-text.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAC;AAQzC,MAAM,MAAM,GAA2B;IACrC,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,EAAE;IAC5D,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE;IACpD,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,EAAE;CACzD,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,KAA0B;IACrD,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACpH,OAAO,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,EAAe,EAAE,KAA0B;IAC3E,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAC/G,CAAC"}

package/dist/extensions/todo-write/todo-panel.d.ts

@@ -0,0 +1,3 @@
+import type { Theme } from '@earendil-works/pi-coding-agent';
+import type { TodoItem } from '../../kernel/todo-list/todo-schema.js';
+export declare function panelLines(items: readonly TodoItem[], theme: Theme): string[];

package/dist/extensions/todo-write/todo-panel.js

@@ -0,0 +1,58 @@
+import { singleLine } from '../../kernel/terminal-rows/single-line.js';
+// pi draws at most ten lines of a widget; the heading and the spacer below the panel take two of them
+const ROW_LIMIT = 8;
+const ROW_LIMIT_WITH_SUMMARY = ROW_LIMIT - 1;
+const MARK_BY_STATUS = {
+    completed: { mark: '✓', color: 'success' },
+    in_progress: { mark: '◐', color: 'accent' },
+    pending: { mark: '○', color: 'dim' },
+};
+export function panelLines(items, theme) {
+    const { shown, hiddenCount } = rowsThatFit(items);
+    const rows = shown.map((item, index) => rowLine(item, index === shown.length - 1 && hiddenCount === 0, theme));
+    return [headingLine(items, theme), ...rows, ...summaryLines(hiddenCount, theme), ''];
+}
+function headingLine(items, theme) {
+    const finished = items.filter(isFinished).length;
+    const allFinished = finished === items.length;
+    const count = `(${String(finished)}/${String(items.length)})`;
+    return theme.fg(allFinished ? 'dim' : 'accent', `${allFinished ? '○' : '●'} Todos ${count}`);
+}
+function rowLine(item, isLast, theme) {
+    const connector = theme.fg('dim', isLast ? '└─' : '├─');
+    return `${connector} ${markOf(item.status, theme)} ${labelOf(item, theme)}`;
+}
+function summaryLines(hiddenCount, theme) {
+    if (hiddenCount === 0) {
+        return [];
+    }
+    const more = theme.fg('dim', `+${String(hiddenCount)} more`);
+    return [`${theme.fg('dim', '└─')} ${more}`];
+}
+function rowsThatFit(items) {
+    if (items.length <= ROW_LIMIT) {
+        return { shown: items, hiddenCount: 0 };
+    }
+    const shown = keptWithin(items, ROW_LIMIT_WITH_SUMMARY);
+    return { shown, hiddenCount: items.length - shown.length };
+}
+function keptWithin(items, limit) {
+    const keptOpen = new Set(items.filter((item) => !isFinished(item)).slice(0, limit));
+    const keptFinished = new Set(items.filter(isFinished).slice(0, limit - keptOpen.size));
+    return items.filter((item) => keptOpen.has(item) || keptFinished.has(item));
+}
+const isFinished = ({ status }) => status === 'completed';
+function markOf(status, theme) {
+    const { mark, color } = MARK_BY_STATUS[status];
+    return theme.fg(color, mark);
+}
+function labelOf({ status, content, activeForm }, theme) {
+    if (status === 'completed') {
+        return theme.fg('dim', singleLine(content));
+    }
+    if (status === 'in_progress') {
+        return theme.fg('text', singleLine(activeForm));
+    }
+    return theme.fg('muted', singleLine(content));
+}
+//# sourceMappingURL=todo-panel.js.map

package/dist/extensions/todo-write/todo-panel.js.map

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

package/dist/extensions/todo-write/todo-store.d.ts

@@ -0,0 +1,10 @@
+import type { ExtensionAPI, SessionEntry } from '@earendil-works/pi-coding-agent';
+import { type TodoItem } from '../../kernel/todo-list/todo-schema.js';
+export declare class TodoStore {
+    private todos;
+    private readonly pi;
+    constructor(pi: ExtensionAPI);
+    replace(items: readonly TodoItem[]): void;
+    restore(entries: readonly SessionEntry[]): void;
+    current(): readonly TodoItem[];
+}

package/dist/extensions/todo-write/todo-store.js

@@ -0,0 +1,29 @@
+import { Value } from 'typebox/value';
+import { TodoWriteParams } from '../../kernel/todo-list/todo-schema.js';
+const SAVED_LIST_KIND = 'anthara-todos';
+export class TodoStore {
+    todos = [];
+    pi;
+    constructor(pi) {
+        this.pi = pi;
+    }
+    replace(items) {
+        this.todos = items;
+        this.pi.appendEntry(SAVED_LIST_KIND, { todos: this.todos });
+    }
+    restore(entries) {
+        this.todos = latestSavedList(entries);
+    }
+    current() {
+        return this.todos;
+    }
+}
+function latestSavedList(entries) {
+    return entries.flatMap(savedListIn).at(-1) ?? [];
+}
+function savedListIn(entry) {
+    return entry.type === 'custom' && entry.customType === SAVED_LIST_KIND && Value.Check(TodoWriteParams, entry.data)
+        ? [entry.data.todos]
+        : [];
+}
+//# sourceMappingURL=todo-store.js.map

package/dist/extensions/todo-write/todo-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo-store.js","sourceRoot":"","sources":["../../../src/extensions/todo-write/todo-store.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,eAAe,EAAiB,MAAM,uCAAuC,CAAC;AAEvF,MAAM,eAAe,GAAG,eAAe,CAAC;AAExC,MAAM,OAAO,SAAS;IACZ,KAAK,GAAwB,EAAE,CAAC;IACvB,EAAE,CAAe;IAElC,YAAY,EAAgB;QAC1B,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,CAAC;IAED,OAAO,CAAC,KAA0B;QAChC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,eAAe,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO,CAAC,OAAgC;QACtC,IAAI,CAAC,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF;AAED,SAAS,eAAe,CAAC,OAAgC;IACvD,OAAO,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACnD,CAAC;AAED,SAAS,WAAW,CAAC,KAAmB;IACtC,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,KAAK,eAAe,IAAI,KAAK,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,IAAI,CAAC;QAChH,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;QACpB,CAAC,CAAC,EAAE,CAAC;AACT,CAAC"}

package/dist/extensions/tool-search/errors.d.ts

@@ -0,0 +1,4 @@
+import { AntharaError } from '../../errors/anthara-error.js';
+export declare class EmptyToolQueryError extends AntharaError {
+    constructor();
+}

package/dist/extensions/tool-search/errors.js

@@ -0,0 +1,7 @@
+import { AntharaError } from '../../errors/anthara-error.js';
+export class EmptyToolQueryError extends AntharaError {
+    constructor() {
+        super('The query is empty. Use select:<Tool>,<Tool> to load tools by name, or give keywords such as "+chrome-devtools screenshot".');
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/extensions/tool-search/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/extensions/tool-search/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAE7D,MAAM,OAAO,mBAAoB,SAAQ,YAAY;IACnD;QACE,KAAK,CAAC,6HAA6H,CAAC,CAAC;IACvI,CAAC;CACF"}

package/dist/extensions/tool-search/index.d.ts

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

package/dist/extensions/tool-search/index.js

@@ -0,0 +1,49 @@
+import { Type } from 'typebox';
+import { resultWithDetails } from '../../kernel/tool-results/tool-result.js';
+import { describeTools } from './tool-listing.js';
+import { resolveQuery } from './tool-matcher.js';
+import { parseToolQuery } from './tool-query.js';
+const DEFAULT_MAX_RESULTS = 5;
+const MAX_RESULTS_CEILING = 50;
+const TOOL_SEARCH_DESCRIPTION = [
+    'Fetches full definitions for tools that are not loaded yet, so that they can be called.',
+    'Until a tool has been returned by this tool, only its name is known and it cannot be invoked.',
+    'Once ToolSearch returns a tool, it is callable like any other tool in the same turn.',
+    'Query forms:',
+    '- "select:AskUserQuestion,WebSearch" loads exactly those tools by name; names that do not exist are reported.',
+    '- "notebook jupyter" searches by keyword and returns up to max_results of the best matches.',
+    '- "+chrome-devtools screenshot" requires "chrome-devtools" in the tool name or description and ranks the rest by the other words.',
+].join('\n');
+const ToolSearchParameters = Type.Object({
+    query: Type.String({ description: 'Query to find tools: "select:<name>,<name>", or keywords, optionally with +required terms.' }),
+    max_results: Type.Optional(Type.Integer({
+        minimum: 1,
+        maximum: MAX_RESULTS_CEILING,
+        description: `Maximum number of tools to return by keyword search (default ${String(DEFAULT_MAX_RESULTS)}).`,
+    })),
+});
+export default function toolSearchExtension(pi) {
+    pi.registerTool({
+        name: 'ToolSearch',
+        label: 'ToolSearch',
+        description: TOOL_SEARCH_DESCRIPTION,
+        parameters: ToolSearchParameters,
+        // plugin MCP tools are registered while their servers connect in the background, so a call may reach any of them
+        reachesTools: () => 'all',
+        execute: async (_toolCallId, params) => Promise.resolve(searchTools(pi, params)),
+    });
+}
+function searchTools(pi, { query, max_results: maxResults }) {
+    const { found, unknown } = resolveQuery(parseToolQuery(query), pi.getAllTools(), maxResults ?? DEFAULT_MAX_RESULTS);
+    const foundNames = found.map(({ name }) => name);
+    makeCallable(pi, foundNames);
+    return resultWithDetails(describeTools(found, unknown), { found: foundNames, unknown });
+}
+function makeCallable(pi, toolNames) {
+    const active = pi.getActiveTools();
+    const inactive = toolNames.filter((name) => !active.includes(name));
+    if (inactive.length > 0) {
+        pi.setActiveTools([...active, ...inactive]);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/extensions/tool-search/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extensions/tool-search/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAe,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAC9B,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAE/B,MAAM,uBAAuB,GAAG;IAC9B,yFAAyF;IACzF,+FAA+F;IAC/F,sFAAsF;IACtF,cAAc;IACd,+GAA+G;IAC/G,6FAA6F;IAC7F,mIAAmI;CACpI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,oBAAoB,GAAG,IAAI,CAAC,MAAM,CAAC;IACvC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,4FAA4F,EAAE,CAAC;IACjI,WAAW,EAAE,IAAI,CAAC,QAAQ,CACxB,IAAI,CAAC,OAAO,CAAC;QACX,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,mBAAmB;QAC5B,WAAW,EAAE,gEAAgE,MAAM,CAAC,mBAAmB,CAAC,IAAI;KAC7G,CAAC,CACH;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,EAAgB;IAC1D,EAAE,CAAC,YAAY,CAAC;QACd,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,uBAAuB;QACpC,UAAU,EAAE,oBAAoB;QAChC,iHAAiH;QACjH,YAAY,EAAE,GAAG,EAAE,CAAC,KAAK;QACzB,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;KACjF,CAAC,CAAC;AACL,CAAC;AAOD,SAAS,WAAW,CAClB,EAAgB,EAChB,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAuC;IAEvE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,YAAY,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,WAAW,EAAE,EAAE,UAAU,IAAI,mBAAmB,CAAC,CAAC;IACpH,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;IACjD,YAAY,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IAC7B,OAAO,iBAAiB,CAAC,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;AAC1F,CAAC;AAED,SAAS,YAAY,CAAC,EAAgB,EAAE,SAA4B;IAClE,MAAM,MAAM,GAAG,EAAE,CAAC,cAAc,EAAE,CAAC;IACnC,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IACpE,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,EAAE,CAAC,cAAc,CAAC,CAAC,GAAG,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC"}

package/dist/extensions/tool-search/tool-listing.d.ts

@@ -0,0 +1,2 @@
+import type { ToolInfo } from '@earendil-works/pi-coding-agent';
+export declare function describeTools(found: readonly ToolInfo[], unknown: readonly string[]): string;

package/dist/extensions/tool-search/tool-listing.js

@@ -0,0 +1,18 @@
+const NOTHING_FOUND = 'No matching tools found.';
+export function describeTools(found, unknown) {
+    const sections = [functionsBlock(found), unknownNames(unknown)].filter((section) => section !== '');
+    return sections.length === 0 ? NOTHING_FOUND : sections.join('\n\n');
+}
+function functionsBlock(found) {
+    if (found.length === 0) {
+        return '';
+    }
+    const definitions = found.map(({ name, description, parameters }) => {
+        return `<function>${JSON.stringify({ description, name, parameters })}</function>`;
+    });
+    return ['<functions>', ...definitions, '</functions>'].join('\n');
+}
+function unknownNames(unknown) {
+    return unknown.length === 0 ? '' : `Unknown tool names: ${unknown.join(', ')}.`;
+}
+//# sourceMappingURL=tool-listing.js.map

package/dist/extensions/tool-search/tool-listing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-listing.js","sourceRoot":"","sources":["../../../src/extensions/tool-search/tool-listing.ts"],"names":[],"mappings":"AAEA,MAAM,aAAa,GAAG,0BAA0B,CAAC;AAEjD,MAAM,UAAU,aAAa,CAAC,KAA0B,EAAE,OAA0B;IAClF,MAAM,QAAQ,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC;IACpG,OAAO,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,cAAc,CAAC,KAA0B;IAChD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,EAAE;QAClE,OAAO,aAAa,IAAI,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,aAAa,CAAC;IACrF,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,aAAa,EAAE,GAAG,WAAW,EAAE,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpE,CAAC;AAED,SAAS,YAAY,CAAC,OAA0B;IAC9C,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,uBAAuB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AAClF,CAAC"}

package/dist/extensions/tool-search/tool-matcher.d.ts

@@ -0,0 +1,10 @@
+import type { ToolInfo } from '@earendil-works/pi-coding-agent';
+import type { KeywordQuery, SelectQuery, ToolQuery } from './tool-query.js';
+interface ToolSelection {
+    readonly found: readonly ToolInfo[];
+    readonly unknown: readonly string[];
+}
+export declare function resolveQuery(query: ToolQuery, tools: readonly ToolInfo[], limit: number): ToolSelection;
+export declare function selectTools(query: SelectQuery, tools: readonly ToolInfo[]): ToolSelection;
+export declare function rankTools(query: KeywordQuery, tools: readonly ToolInfo[], limit: number): ToolInfo[];
+export {};

package/dist/extensions/tool-search/tool-matcher.js

@@ -0,0 +1,45 @@
+import { foldMcpName, toPiToolName } from '../../kernel/vocabulary/claude-tool-names.js';
+const LOADABLE_EXPOSURES = new Set(['deferred', 'codemode']);
+const NAME_HIT_WEIGHT = 3;
+const DESCRIPTION_HIT_WEIGHT = 1;
+export function resolveQuery(query, tools, limit) {
+    switch (query.kind) {
+        case 'select':
+            return selectTools(query, tools);
+        case 'keyword':
+            return { found: rankTools(query, tools, limit), unknown: [] };
+    }
+}
+export function selectTools(query, tools) {
+    const reachable = reachableTools(tools);
+    const resolved = query.names.map((name) => ({ name, tool: reachable.find((tool) => sameName(tool.name, toPiToolName(name))) }));
+    return {
+        found: unique(resolved.flatMap(({ tool }) => (tool === undefined ? [] : [tool]))),
+        unknown: resolved.filter(({ tool }) => tool === undefined).map(({ name }) => name),
+    };
+}
+// only tools that still have to be loaded are searched; the ones the model already holds are callable as they are
+export function rankTools(query, tools, limit) {
+    const terms = [...query.required, ...query.terms];
+    return tools
+        .filter(({ exposure }) => LOADABLE_EXPOSURES.has(exposure))
+        .filter((tool) => query.required.every((term) => mentions(tool, term)))
+        .map((tool) => ({ tool, score: terms.reduce((total, term) => total + hitsOf(tool, term), 0) }))
+        .filter(({ score }) => score > 0)
+        .sort((a, b) => b.score - a.score || a.tool.name.localeCompare(b.tool.name))
+        .slice(0, limit)
+        .map(({ tool }) => tool);
+}
+const reachableTools = (tools) => tools.filter(({ exposure }) => exposure !== 'hidden');
+const sameName = (a, b) => a.toLowerCase() === b.toLowerCase();
+const unique = (tools) => [...new Set(tools)];
+function hitsOf(tool, term) {
+    return ((contains(tool.name, term) ? NAME_HIT_WEIGHT : 0) + (contains(tool.description, term) ? DESCRIPTION_HIT_WEIGHT : 0));
+}
+const mentions = (tool, term) => hitsOf(tool, term) > 0;
+// pi folds hyphens out of MCP tool names, so a term such as chrome-devtools is also looked for folded
+function contains(text, term) {
+    const lowered = text.toLowerCase();
+    return lowered.includes(term.toLowerCase()) || lowered.includes(foldMcpName(term).toLowerCase());
+}
+//# sourceMappingURL=tool-matcher.js.map