@asermax/tachikoma 2.0.0

package/dist/extensions/projects/processor.js

@@ -0,0 +1,63 @@
+import { join } from "node:path";
+import { commitAll } from "../git/commit.js";
+import { PUSH_SUCCESS, smartPush } from "../git/sync.js";
+import { isDirty, listSubmodules } from "./git.js";
+export const projectFallbackMessage = (name, now = new Date()) => `Update ${name} files (${now.toISOString().slice(0, 10)})`;
+const commitAndPush = async (workspaceRoot, side, path, log) => {
+    const repoPath = join(workspaceRoot, path);
+    const name = path.split("/").at(-1) ?? path;
+    const message = await commitAll({
+        cwd: repoPath,
+        side,
+        fallbackMessage: projectFallbackMessage(name),
+        log,
+    });
+    if (message != null)
+        log.info({ path, message }, "committed project changes");
+    const result = await smartPush(repoPath, "origin", "HEAD", log);
+    if (PUSH_SUCCESS.has(result)) {
+        log.info({ path, result }, "pushed project changes");
+    }
+    else {
+        log.warn({ path, result }, "push failed — changes remain committed locally");
+    }
+};
+/**
+ * Pre-finalize post-processor: commits and pushes every dirty registered
+ * project before the workspace commit runs, so submodule pointer updates land
+ * in the same workspace commit pass.
+ */
+export const createProjectsProcessor = ({ workspaceRoot, side, }) => ({
+    name: "projects-commit",
+    phase: "preFinalize",
+    async process({ log }) {
+        const submodulePaths = await listSubmodules(workspaceRoot);
+        if (submodulePaths.length === 0) {
+            log.debug("no submodules found — skipping project processing");
+            return;
+        }
+        const dirtyChecks = await Promise.allSettled(submodulePaths.map((path) => isDirty(join(workspaceRoot, path))));
+        const dirtyPaths = [];
+        for (const [index, check] of dirtyChecks.entries()) {
+            const path = submodulePaths[index];
+            if (check.status === "rejected") {
+                log.warn({ path, err: check.reason }, "failed to check submodule status");
+            }
+            else if (check.value) {
+                dirtyPaths.push(path);
+            }
+        }
+        if (dirtyPaths.length === 0) {
+            log.debug("no dirty submodules — skipping commit");
+            return;
+        }
+        log.info({ paths: dirtyPaths }, "processing dirty submodules");
+        const results = await Promise.allSettled(dirtyPaths.map((path) => commitAndPush(workspaceRoot, side, path, log)));
+        for (const [index, result] of results.entries()) {
+            if (result.status === "rejected") {
+                log.warn({ path: dirtyPaths[index], err: result.reason }, "failed to process submodule");
+            }
+        }
+    },
+});
+//# sourceMappingURL=processor.js.map

package/dist/extensions/projects/processor.js.map

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

package/dist/extensions/projects/tools.d.ts

@@ -0,0 +1,21 @@
+import type { ExtensionFactory } from "@earendil-works/pi-coding-agent";
+import { type Static, Type } from "typebox";
+import type { Logger } from "../../log.ts";
+export interface ProjectToolDeps {
+    workspaceRoot: string;
+    log: Logger;
+}
+export declare const RegisterProjectParams: Type.TObject<{
+    name: Type.TString;
+    url: Type.TString;
+}>;
+export declare const DeregisterProjectParams: Type.TObject<{
+    name: Type.TString;
+    force: Type.TOptional<Type.TBoolean>;
+}>;
+export declare const ListProjectsParams: Type.TObject<{}>;
+export declare const handleRegisterProject: ({ workspaceRoot, log }: ProjectToolDeps, args: Static<typeof RegisterProjectParams>) => Promise<string>;
+export declare const handleDeregisterProject: ({ workspaceRoot, log }: ProjectToolDeps, args: Static<typeof DeregisterProjectParams>) => Promise<string>;
+export declare const handleListProjects: ({ workspaceRoot }: ProjectToolDeps) => Promise<string>;
+/** pi extension factory exposing the project management tools to the agent. */
+export declare const createProjectsToolsFactory: (deps: ProjectToolDeps) => ExtensionFactory;

package/dist/extensions/projects/tools.js

@@ -0,0 +1,118 @@
+import { access } from "node:fs/promises";
+import { join } from "node:path";
+import { Type } from "typebox";
+import { addSubmodule, checkoutBranch, describeProjectState, listSubmodules, projectState, removeSubmodule, resolveDefaultBranch, uncommittedChangesDetail, } from "./git.js";
+export const RegisterProjectParams = Type.Object({
+    name: Type.String({ description: "Project name — becomes the directory under projects/" }),
+    url: Type.String({ description: "Git remote URL to clone the project from" }),
+});
+export const DeregisterProjectParams = Type.Object({
+    name: Type.String({ description: "Name of the registered project to remove" }),
+    force: Type.Optional(Type.Boolean({
+        description: "Remove even when the project has uncommitted changes (they will be lost)",
+    })),
+});
+export const ListProjectsParams = Type.Object({});
+const exists = async (path) => access(path).then(() => true, () => false);
+export const handleRegisterProject = async ({ workspaceRoot, log }, args) => {
+    if (args.name === "")
+        throw new Error("'name' is required");
+    if (args.url === "")
+        throw new Error("'url' is required");
+    const projectPath = join(workspaceRoot, "projects", args.name);
+    if (await exists(projectPath))
+        throw new Error(`Project '${args.name}' already exists`);
+    try {
+        await addSubmodule(workspaceRoot, args.name, args.url);
+        const defaultBranch = await resolveDefaultBranch(projectPath);
+        await checkoutBranch(projectPath, defaultBranch);
+        log.info({ name: args.name, url: args.url, branch: defaultBranch }, "project registered");
+        return (`Registered project '${args.name}' (branch: ${defaultBranch}). ` +
+            `The project is now available under projects/${args.name}. ` +
+            "Changes will be committed to the workspace at session end.");
+    }
+    catch (error) {
+        if (await exists(projectPath)) {
+            try {
+                await removeSubmodule(workspaceRoot, args.name);
+            }
+            catch {
+                // Partial-state cleanup is best-effort; the original error matters more.
+            }
+        }
+        log.warn({ name: args.name, err: error }, "project registration failed");
+        throw new Error(`Error registering project: ${error.message}`);
+    }
+};
+export const handleDeregisterProject = async ({ workspaceRoot, log }, args) => {
+    if (args.name === "")
+        throw new Error("'name' is required");
+    const projectPath = join(workspaceRoot, "projects", args.name);
+    if (!(await exists(projectPath)))
+        throw new Error(`Project '${args.name}' not found`);
+    const force = args.force ?? false;
+    const changes = await uncommittedChangesDetail(projectPath);
+    if (changes != null && !force) {
+        throw new Error(`Project '${args.name}' has uncommitted changes:\n${changes}\n\n` +
+            "Use force=true to remove anyway (changes will be lost).");
+    }
+    await removeSubmodule(workspaceRoot, args.name);
+    log.info({ name: args.name, force }, "project deregistered");
+    return (`Deregistered project '${args.name}'. ` +
+        "Changes will be committed to the workspace at session end.");
+};
+export const handleListProjects = async ({ workspaceRoot }) => {
+    const submodulePaths = await listSubmodules(workspaceRoot);
+    if (submodulePaths.length === 0) {
+        return "No projects registered. Use register_project to add one.";
+    }
+    const lines = await Promise.all(submodulePaths.map(async (path) => describeProjectState(await projectState(workspaceRoot, path))));
+    return `# Registered Projects\n\n${lines.join("\n")}`;
+};
+const textResult = (text) => ({
+    content: [{ type: "text", text }],
+    details: undefined,
+});
+/** pi extension factory exposing the project management tools to the agent. */
+export const createProjectsToolsFactory = (deps) => (pi) => {
+    pi.registerTool({
+        name: "register_project",
+        label: "Register Project",
+        description: "Register an external git repository as a project: clones it as a submodule under projects/<name> and checks out its default branch. Project changes are committed and pushed automatically at session end.",
+        promptSnippet: "Register an external git repository as a tracked project",
+        promptGuidelines: [
+            "Use register_project when the user wants to work on an external repository inside the workspace.",
+        ],
+        parameters: RegisterProjectParams,
+        async execute(_toolCallId, params) {
+            return textResult(await handleRegisterProject(deps, params));
+        },
+    });
+    pi.registerTool({
+        name: "deregister_project",
+        label: "Deregister Project",
+        description: "Remove a registered project from the workspace. Fails when the project has uncommitted changes unless force=true is passed (those changes are lost).",
+        promptSnippet: "Remove a registered project from the workspace",
+        promptGuidelines: [
+            "Confirm with the user before calling deregister_project with force=true — uncommitted work is lost.",
+        ],
+        parameters: DeregisterProjectParams,
+        async execute(_toolCallId, params) {
+            return textResult(await handleDeregisterProject(deps, params));
+        },
+    });
+    pi.registerTool({
+        name: "list_projects",
+        label: "List Projects",
+        description: "List the registered projects with their current branch (or detached commit) and uncommitted-change counts.",
+        promptSnippet: "List registered projects and their git state",
+        promptGuidelines: [
+            "Check list_projects before register_project to avoid registering a duplicate.",
+        ],
+        parameters: ListProjectsParams,
+        async execute() {
+            return textResult(await handleListProjects(deps));
+        },
+    });
+};
+//# sourceMappingURL=tools.js.map

package/dist/extensions/projects/tools.js.map

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

package/dist/extensions/registrations.d.ts

@@ -0,0 +1,21 @@
+import type { ExtensionFactory } from "@earendil-works/pi-coding-agent";
+import type { Channel } from "../channels/types.ts";
+import type { SessionRecord } from "../db/core-schema.ts";
+import type { ContextProvider, ExchangeProcessor, InboundMiddleware, PostProcessor } from "./api.ts";
+export interface BootstrapHook {
+    name: string;
+    hook: () => void | Promise<void>;
+}
+/** Mutable registries filled by extensions during setup and read by core at runtime. */
+export interface Registrations {
+    piFactories: ExtensionFactory[];
+    systemPromptBuilders: (() => string)[];
+    contextProviders: ContextProvider[];
+    exchangeProcessors: ExchangeProcessor[];
+    postProcessors: PostProcessor[];
+    inboundMiddleware: InboundMiddleware[];
+    sessionOpenHooks: ((session: SessionRecord) => void | Promise<void>)[];
+    channels: Map<string, Channel>;
+    bootstrapHooks: BootstrapHook[];
+}
+export declare const createRegistrations: () => Registrations;

package/dist/extensions/registrations.js

@@ -0,0 +1,12 @@
+export const createRegistrations = () => ({
+    piFactories: [],
+    systemPromptBuilders: [],
+    contextProviders: [],
+    exchangeProcessors: [],
+    postProcessors: [],
+    inboundMiddleware: [],
+    sessionOpenHooks: [],
+    channels: new Map(),
+    bootstrapHooks: [],
+});
+//# sourceMappingURL=registrations.js.map

package/dist/extensions/registrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registrations.js","sourceRoot":"","sources":["../../src/extensions/registrations.ts"],"names":[],"mappings":"AA6BA,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAkB,EAAE,CAAC,CAAC;IACvD,WAAW,EAAE,EAAE;IACf,oBAAoB,EAAE,EAAE;IACxB,gBAAgB,EAAE,EAAE;IACpB,kBAAkB,EAAE,EAAE;IACtB,cAAc,EAAE,EAAE;IAClB,iBAAiB,EAAE,EAAE;IACrB,gBAAgB,EAAE,EAAE;IACpB,QAAQ,EAAE,IAAI,GAAG,EAAE;IACnB,cAAc,EAAE,EAAE;CACnB,CAAC,CAAC"}

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

@@ -0,0 +1,2 @@
+declare const _default: import("../api.ts").TachikomaExtension<unknown>;
+export default _default;

package/dist/extensions/repl/index.js

@@ -0,0 +1,85 @@
+import { createInterface } from "node:readline";
+import { textMessage } from "../../domain/message.js";
+import { defineExtension } from "../api.js";
+const DIM = "\x1b[2m";
+const RED = "\x1b[31m";
+const RESET = "\x1b[0m";
+class ReplChannel {
+    name = "repl";
+    readline = null;
+    async start(runtime) {
+        this.readline = createInterface({
+            input: process.stdin,
+            output: process.stdout,
+            prompt: "you> ",
+        });
+        this.readline.on("line", (line) => {
+            const text = line.trim();
+            if (text.length > 0) {
+                runtime.submit(textMessage(this.name, text));
+            }
+            else {
+                this.readline?.prompt();
+            }
+        });
+        this.readline.on("close", () => {
+            // Pending exchanges must not touch the closed interface while shutdown runs.
+            this.readline = null;
+            process.kill(process.pid, "SIGINT");
+        });
+        this.readline.prompt();
+    }
+    async respond({ events }) {
+        let inText = false;
+        for await (const event of events) {
+            switch (event.kind) {
+                case "text":
+                    process.stdout.write(event.text);
+                    inText = true;
+                    break;
+                case "tool-start":
+                    if (inText)
+                        process.stdout.write("\n");
+                    process.stdout.write(`${DIM}⚙ ${event.toolName}${RESET}\n`);
+                    inText = false;
+                    break;
+                case "status":
+                    if (inText)
+                        process.stdout.write("\n");
+                    process.stdout.write(`${DIM}${event.text}${RESET}\n`);
+                    inText = false;
+                    break;
+                case "error":
+                    if (inText)
+                        process.stdout.write("\n");
+                    process.stdout.write(`${RED}error: ${event.message}${RESET}\n`);
+                    inText = false;
+                    break;
+                case "result":
+                    process.stdout.write("\n");
+                    this.readline?.prompt();
+                    break;
+                default:
+                    break;
+            }
+        }
+    }
+    async deliver(delivery) {
+        process.stdout.write(`\n📥 ${delivery.text}\n`);
+        this.readline?.prompt();
+    }
+    status(text) {
+        process.stdout.write(`${DIM}· ${text}${RESET}\n`);
+    }
+    async stop() {
+        this.readline?.close();
+        this.readline = null;
+    }
+}
+export default defineExtension({
+    name: "repl",
+    setup(app) {
+        app.channels.register(new ReplChannel());
+    },
+});
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,17 @@
+import type { Logger } from "../../log.ts";
+export interface SkillAgent {
+    /** Namespaced as "<skill>/<agent>" to prevent collisions across skills. */
+    name: string;
+    description: string;
+    tools: string[] | null;
+    systemPrompt: string;
+    skill: string;
+}
+/**
+ * Discover agent definitions bundled inside skill packages: markdown files under
+ * each skill's agents/ directory, with frontmatter metadata (description required;
+ * name and tools optional) and the body as the agent's system prompt.
+ *
+ * Invalid agent files are logged and skipped so one bad definition never blocks the rest.
+ */
+export declare const discoverSkillAgents: (skillsRoot: string, log: Logger) => SkillAgent[];

package/dist/extensions/skills/agents.js

@@ -0,0 +1,77 @@
+import { readdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { parseFrontmatter } from "@earendil-works/pi-coding-agent";
+const listDirectories = (path) => {
+    try {
+        return readdirSync(path, { withFileTypes: true })
+            .filter((entry) => entry.isDirectory())
+            .map((entry) => entry.name);
+    }
+    catch {
+        return [];
+    }
+};
+const listMarkdownFiles = (path) => {
+    try {
+        return readdirSync(path, { withFileTypes: true })
+            .filter((entry) => (entry.isFile() || entry.isSymbolicLink()) && entry.name.endsWith(".md"))
+            .map((entry) => entry.name);
+    }
+    catch {
+        return [];
+    }
+};
+// Accepts both a YAML list and the comma-separated string used by pi's subagent example.
+const parseTools = (raw) => {
+    if (raw == null)
+        return null;
+    if (typeof raw === "string") {
+        const tools = raw
+            .split(",")
+            .map((tool) => tool.trim())
+            .filter((tool) => tool.length > 0);
+        return tools.length > 0 ? tools : null;
+    }
+    if (Array.isArray(raw) && raw.every((tool) => typeof tool === "string")) {
+        return raw.length > 0 ? raw : null;
+    }
+    return null;
+};
+/**
+ * Discover agent definitions bundled inside skill packages: markdown files under
+ * each skill's agents/ directory, with frontmatter metadata (description required;
+ * name and tools optional) and the body as the agent's system prompt.
+ *
+ * Invalid agent files are logged and skipped so one bad definition never blocks the rest.
+ */
+export const discoverSkillAgents = (skillsRoot, log) => {
+    const agents = [];
+    for (const skill of listDirectories(skillsRoot)) {
+        const agentsDir = join(skillsRoot, skill, "agents");
+        for (const file of listMarkdownFiles(agentsDir)) {
+            try {
+                const { frontmatter, body } = parseFrontmatter(readFileSync(join(agentsDir, file), "utf8"));
+                if (typeof frontmatter.description !== "string" || frontmatter.description.length === 0) {
+                    log.warn({ skill, agent: file }, "skill agent missing description — skipped");
+                    continue;
+                }
+                const stem = file.slice(0, -".md".length);
+                const name = typeof frontmatter.name === "string" && frontmatter.name.length > 0
+                    ? frontmatter.name
+                    : stem;
+                agents.push({
+                    name: `${skill}/${name}`,
+                    description: frontmatter.description,
+                    tools: parseTools(frontmatter.tools),
+                    systemPrompt: body,
+                    skill,
+                });
+            }
+            catch (error) {
+                log.warn({ err: error, skill, agent: file }, "failed to load skill agent — skipped");
+            }
+        }
+    }
+    return agents;
+};
+//# sourceMappingURL=agents.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../../src/extensions/skills/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAanE,MAAM,eAAe,GAAG,CAAC,IAAY,EAAY,EAAE;IACjD,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;aAC9C,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;aACtC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAAY,EAAE;IACnD,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;aAC9C,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;aAC3F,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC,CAAC;AAEF,yFAAyF;AACzF,MAAM,UAAU,GAAG,CAAC,GAAY,EAAmB,EAAE;IACnD,IAAI,GAAG,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAE7B,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,GAAG;aACd,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;aAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAErC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IACzC,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,EAAE,CAAC;QACxF,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IACrC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,UAAkB,EAAE,GAAW,EAAgB,EAAE;IACnF,MAAM,MAAM,GAAiB,EAAE,CAAC;IAEhC,KAAK,MAAM,KAAK,IAAI,eAAe,CAAC,UAAU,CAAC,EAAE,CAAC;QAChD,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;QAEpD,KAAK,MAAM,IAAI,IAAI,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC;YAChD,IAAI,CAAC;gBACH,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;gBAE5F,IAAI,OAAO,WAAW,CAAC,WAAW,KAAK,QAAQ,IAAI,WAAW,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACxF,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,2CAA2C,CAAC,CAAC;oBAC9E,SAAS;gBACX,CAAC;gBAED,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBAC1C,MAAM,IAAI,GACR,OAAO,WAAW,CAAC,IAAI,KAAK,QAAQ,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;oBACjE,CAAC,CAAC,WAAW,CAAC,IAAI;oBAClB,CAAC,CAAC,IAAI,CAAC;gBAEX,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,GAAG,KAAK,IAAI,IAAI,EAAE;oBACxB,WAAW,EAAE,WAAW,CAAC,WAAW;oBACpC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,KAAK,CAAC;oBACpC,YAAY,EAAE,IAAI;oBAClB,KAAK;iBACN,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,sCAAsC,CAAC,CAAC;YACvF,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

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

@@ -0,0 +1,22 @@
+import { type ToolDefinition } from "@earendil-works/pi-coding-agent";
+import { Type } from "typebox";
+import type { SideRunner } from "../../agent/side-run.ts";
+import type { Logger } from "../../log.ts";
+import type { SkillAgent } from "./agents.ts";
+export type AgentRunner = Pick<SideRunner, "run">;
+export interface DelegateToolOptions {
+    /** Called once for the tool description and again on every execution (skills can change). */
+    discover: () => SkillAgent[];
+    runner: AgentRunner;
+    log: Logger;
+}
+declare const DelegateParams: Type.TObject<{
+    agent: Type.TString;
+    task: Type.TString;
+}>;
+/**
+ * `delegate_to_agent`: run a skill-bundled agent definition headlessly with its own
+ * system prompt and tool set, returning the agent's final answer.
+ */
+export declare const createDelegateTool: ({ discover, runner, log, }: DelegateToolOptions) => ToolDefinition<typeof DelegateParams>;
+export {};

package/dist/extensions/skills/delegate.js

@@ -0,0 +1,54 @@
+import { truncateTail } from "@earendil-works/pi-coding-agent";
+import { Type } from "typebox";
+const DEFAULT_AGENT_TOOLS = ["read", "grep", "find", "ls"];
+const DelegateParams = Type.Object({
+    agent: Type.String({
+        description: "Agent to delegate to, exactly as listed in the tool description",
+    }),
+    task: Type.String({
+        description: "Complete, self-contained task description — the agent has no access to this conversation",
+    }),
+});
+const renderAgentList = (agents) => agents.length > 0
+    ? agents.map((agent) => `- ${agent.name}: ${agent.description}`).join("\n")
+    : "(none discovered)";
+/**
+ * `delegate_to_agent`: run a skill-bundled agent definition headlessly with its own
+ * system prompt and tool set, returning the agent's final answer.
+ */
+export const createDelegateTool = ({ discover, runner, log, }) => ({
+    name: "delegate_to_agent",
+    label: "Delegate to agent",
+    description: [
+        "Delegate a focused task to a specialized agent bundled with a skill.",
+        "The agent runs in an isolated context with its own system prompt and tools,",
+        "and returns its final answer as the tool result.",
+        "",
+        "Available agents:",
+        renderAgentList(discover()),
+    ].join("\n"),
+    promptSnippet: "delegate_to_agent: hand a focused task to a specialized skill-bundled agent",
+    promptGuidelines: [
+        "Use delegate_to_agent when a skill ships an agent suited to the task; pass a complete, self-contained task description.",
+    ],
+    parameters: DelegateParams,
+    async execute(_toolCallId, params) {
+        const agents = discover();
+        const agent = agents.find((candidate) => candidate.name === params.agent);
+        if (agent == null) {
+            throw new Error(`Unknown agent "${params.agent}". Available agents:\n${renderAgentList(agents)}`);
+        }
+        log.debug({ agent: agent.name }, "delegating task to skill agent");
+        const result = await runner.run({
+            system: agent.systemPrompt,
+            tools: agent.tools ?? DEFAULT_AGENT_TOOLS,
+            prompt: params.task,
+        });
+        const { content, truncated } = truncateTail(result.text);
+        return {
+            content: [{ type: "text", text: truncated ? `${content}\n\n[output truncated]` : content }],
+            details: undefined,
+        };
+    },
+});
+//# sourceMappingURL=delegate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delegate.js","sourceRoot":"","sources":["../../../src/extensions/skills/delegate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpF,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAe/B,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;AAE3D,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC;IACjC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC;QACjB,WAAW,EAAE,iEAAiE;KAC/E,CAAC;IACF,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;QAChB,WAAW,EACT,0FAA0F;KAC7F,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,eAAe,GAAG,CAAC,MAAoB,EAAU,EAAE,CACvD,MAAM,CAAC,MAAM,GAAG,CAAC;IACf,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAC3E,CAAC,CAAC,mBAAmB,CAAC;AAE1B;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,EACjC,QAAQ,EACR,MAAM,EACN,GAAG,GACiB,EAAyC,EAAE,CAAC,CAAC;IACjE,IAAI,EAAE,mBAAmB;IACzB,KAAK,EAAE,mBAAmB;IAE1B,WAAW,EAAE;QACX,sEAAsE;QACtE,6EAA6E;QAC7E,kDAAkD;QAClD,EAAE;QACF,mBAAmB;QACnB,eAAe,CAAC,QAAQ,EAAE,CAAC;KAC5B,CAAC,IAAI,CAAC,IAAI,CAAC;IAEZ,aAAa,EAAE,6EAA6E;IAC5F,gBAAgB,EAAE;QAChB,yHAAyH;KAC1H;IAED,UAAU,EAAE,cAAc;IAE1B,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM;QAC/B,MAAM,MAAM,GAAG,QAAQ,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC;QAE1E,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CACb,kBAAkB,MAAM,CAAC,KAAK,yBAAyB,eAAe,CAAC,MAAM,CAAC,EAAE,CACjF,CAAC;QACJ,CAAC;QAED,GAAG,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,gCAAgC,CAAC,CAAC;QAEnE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC;YAC9B,MAAM,EAAE,KAAK,CAAC,YAAY;YAC1B,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,mBAAmB;YACzC,MAAM,EAAE,MAAM,CAAC,IAAI;SACpB,CAAC,CAAC;QAEH,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAEzD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,OAAO,wBAAwB,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YAC3F,OAAO,EAAE,SAAS;SACnB,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,11 @@
+interface SkillsConfig {
+    enabled: boolean;
+}
+/**
+ * Workspace skills: contributes the workspace skills directory as a pi skill source.
+ * pi natively handles discovery, progressive disclosure, and /skill commands, so the
+ * extension only wires the source and exposes skill-bundled agent definitions through
+ * a delegate_to_agent tool.
+ */
+declare const _default: import("../api.ts").TachikomaExtension<SkillsConfig>;
+export default _default;

package/dist/extensions/skills/index.js

@@ -0,0 +1,43 @@
+import { mkdir } from "node:fs/promises";
+import { resolve } from "node:path";
+import { Type } from "typebox";
+import { defineExtension } from "../api.js";
+import { discoverSkillAgents } from "./agents.js";
+import { createDelegateTool } from "./delegate.js";
+import { registerReload } from "./reload.js";
+// Built-in authoring skills ship inside the repo's skills/ directory, three levels
+// up from this module (src/extensions/skills → repo root).
+const builtinSkillsDir = resolve(import.meta.dirname, "../../../skills");
+/**
+ * Workspace skills: contributes the workspace skills directory as a pi skill source.
+ * pi natively handles discovery, progressive disclosure, and /skill commands, so the
+ * extension only wires the source and exposes skill-bundled agent definitions through
+ * a delegate_to_agent tool.
+ */
+export default defineExtension({
+    name: "skills",
+    configSchema: Type.Object({
+        enabled: Type.Boolean({ default: true }),
+    }),
+    setup(app) {
+        if (!app.extensionConfig.enabled) {
+            app.log.info("skills disabled by configuration");
+            return;
+        }
+        const skillsDir = app.workspace.resolve("skills");
+        app.bootstrap("ensure-skills-dir", async () => {
+            await mkdir(skillsDir, { recursive: true });
+        });
+        app.agent.use((pi) => {
+            pi.on("resources_discover", () => ({ skillPaths: [skillsDir, builtinSkillsDir] }));
+            registerReload(pi);
+            // Discovery runs per agent session, so new skill agents appear on the next
+            // session without a restart. No tool is advertised when no agents exist.
+            const discover = () => discoverSkillAgents(skillsDir, app.log);
+            if (discover().length > 0) {
+                pi.registerTool(createDelegateTool({ discover, runner: app.agent.side, log: app.log }));
+            }
+        });
+    },
+});
+//# 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":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAM7C,mFAAmF;AACnF,2DAA2D;AAC3D,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;AAEzE;;;;;GAKG;AACH,eAAe,eAAe,CAAe;IAC3C,IAAI,EAAE,QAAQ;IAEd,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC;QACxB,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;KACzC,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;YACjC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;YACjD,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAElD,GAAG,CAAC,SAAS,CAAC,mBAAmB,EAAE,KAAK,IAAI,EAAE;YAC5C,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;QAEH,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;YACnB,EAAE,CAAC,EAAE,CAAC,oBAAoB,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,SAAS,EAAE,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC;YAEnF,cAAc,CAAC,EAAE,CAAC,CAAC;YAEnB,2EAA2E;YAC3E,yEAAyE;YACzE,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,mBAAmB,CAAC,SAAS,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;YAE/D,IAAI,QAAQ,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1B,EAAE,CAAC,YAAY,CAAC,kBAAkB,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YAC1F,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,8 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+/**
+ * Mid-session resource reload, pi-style: a /reload command (reload must run in
+ * command context) plus a tool that queues it, so the agent can refresh skills
+ * itself when the user mentions adding or editing one. New sessions always
+ * rediscover skills regardless — this covers the live session.
+ */
+export declare const registerReload: (pi: ExtensionAPI) => void;