@asermax/tachikoma 2.0.0

package/dist/extensions/detached-processes/tools.js

@@ -0,0 +1,243 @@
+import { constants } from "node:os";
+import { StringEnum } from "@earendil-works/pi-ai";
+import { truncateTail } from "@earendil-works/pi-coding-agent";
+import { Type } from "typebox";
+import { readOutputTail } from "./output.js";
+import { reconcileExit } from "./reconcile.js";
+import { isAlive, spawnProcess, terminate } from "./spawn.js";
+const reconcileDeps = (deps) => ({
+    repository: deps.repository,
+    processesDir: deps.processesDir,
+    notify: deps.notify,
+    log: deps.log,
+    now: deps.now,
+});
+export const DispatchProcessParams = Type.Object({
+    name: Type.String({ description: "Display label for the process (non-unique)" }),
+    command: Type.String({ description: "Shell command to run (supports pipes, &&, etc.)" }),
+    cwd: Type.Optional(Type.String({ description: "Working directory (defaults to Tachikoma's)" })),
+    env: Type.Optional(Type.Record(Type.String(), Type.String(), {
+        description: "Environment variable overrides merged onto the OS environment",
+    })),
+    memory_limit_mb: Type.Optional(Type.Number({ description: "Memory limit in MB (overrides the configured default)" })),
+});
+export const QueryProcessParams = Type.Object({
+    process_id: Type.Optional(Type.String({ description: "ID of a specific process to inspect; omit to list" })),
+    archived: Type.Optional(Type.Boolean({ description: "When listing, set true to show exited processes" })),
+});
+export const ReadProcessOutputParams = Type.Object({
+    process_id: Type.String({ description: "ID of the process" }),
+    stream: Type.Optional(StringEnum(["stdout", "stderr"], {
+        description: "Which output stream to read (default stdout)",
+    })),
+});
+export const TerminateProcessParams = Type.Object({
+    process_id: Type.String({ description: "ID of the process to terminate" }),
+    signal: Type.Optional(Type.String({ description: "Signal name (default SIGTERM), e.g. SIGTERM, SIGINT, SIGKILL" })),
+    grace_seconds: Type.Optional(Type.Number({
+        description: "Seconds before escalating to SIGKILL (default 10); 0 = signal and return",
+    })),
+});
+const notFound = (processId) => new Error(`Process '${processId}' not found.`);
+const describeProcess = (record) => {
+    const lines = [
+        `- [${record.id}] **${record.name}** (pid ${record.pid}) ${record.status}`,
+        `  Command: ${record.command}`,
+        `  Started: ${record.startedAt.toISOString()}`,
+    ];
+    if (record.exitedAt != null) {
+        lines.push(`  Exited: ${record.exitedAt.toISOString()} (code: ${record.exitCode ?? "unknown"})`);
+    }
+    lines.push("");
+    return lines;
+};
+export const handleDispatchProcess = async (deps, args) => {
+    if (args.memory_limit_mb != null && args.memory_limit_mb < 1) {
+        throw new Error(`Invalid memory_limit_mb: ${args.memory_limit_mb}. Minimum value is 1.`);
+    }
+    const record = await spawnProcess(deps, {
+        name: args.name,
+        command: args.command,
+        cwd: args.cwd,
+        env: args.env,
+        memoryLimitMb: args.memory_limit_mb ?? deps.defaultMemoryLimitMb,
+    });
+    return [
+        `Process '${record.name}' started.`,
+        `- ID: ${record.id}`,
+        `- PID: ${record.pid}`,
+        `- Stdout: ${record.stdoutPath}`,
+        `- Stderr: ${record.stderrPath}`,
+    ].join("\n");
+};
+export const handleQueryProcess = async (deps, args) => {
+    const { repository } = deps;
+    if (args.process_id != null) {
+        let record = repository.get(args.process_id);
+        if (record == null)
+            throw notFound(args.process_id);
+        if (record.status === "running" && !isAlive(record.pid)) {
+            await reconcileExit(reconcileDeps(deps), record.id);
+            record = repository.get(args.process_id);
+            if (record == null)
+                throw notFound(args.process_id);
+        }
+        const lines = [
+            `# ${record.name}`,
+            "",
+            `- ID: ${record.id}`,
+            `- Status: ${record.status}`,
+            `- PID: ${record.pid}`,
+            `- Command: ${record.command}`,
+            `- CWD: ${record.cwd}`,
+            `- Stdout: ${record.stdoutPath}`,
+            `- Stderr: ${record.stderrPath}`,
+            `- Started: ${record.startedAt.toISOString()}`,
+        ];
+        if (record.exitedAt != null) {
+            lines.push(`- Exited: ${record.exitedAt.toISOString()}`);
+            lines.push(`- Exit code: ${record.exitCode ?? "unknown"}`);
+        }
+        if (record.memoryLimitMb != null)
+            lines.push(`- Memory limit: ${record.memoryLimitMb}MB`);
+        return lines.join("\n");
+    }
+    let records;
+    if (args.archived === true) {
+        records = repository.listExited();
+    }
+    else {
+        records = [];
+        for (const record of repository.listRunning()) {
+            if (isAlive(record.pid)) {
+                records.push(record);
+            }
+            else {
+                await reconcileExit(reconcileDeps(deps), record.id);
+            }
+        }
+    }
+    if (records.length === 0) {
+        return `No ${args.archived === true ? "exited" : "running"} processes found.`;
+    }
+    return ["# Detached Processes", "", ...records.flatMap(describeProcess)].join("\n");
+};
+export const handleReadProcessOutput = async (deps, args) => {
+    const record = deps.repository.get(args.process_id);
+    if (record == null)
+        throw notFound(args.process_id);
+    const path = args.stream === "stderr" ? record.stderrPath : record.stdoutPath;
+    const raw = await readOutputTail(path);
+    if (raw == null || raw === "")
+        return "No output yet.";
+    const { content, truncated } = truncateTail(raw);
+    return truncated ? `[earlier output truncated]\n${content}` : content;
+};
+export const handleTerminateProcess = async (deps, args) => {
+    const { repository, log } = deps;
+    const graceSeconds = args.grace_seconds ?? 10;
+    let record = repository.get(args.process_id);
+    if (record == null)
+        throw notFound(args.process_id);
+    if (record.status === "running" && !isAlive(record.pid)) {
+        // Lazy reconcile — stop-initiated exits don't notify the user.
+        await reconcileExit(reconcileDeps(deps), record.id, { dispatchNotification: false });
+        record = repository.get(args.process_id);
+        if (record == null)
+            throw notFound(args.process_id);
+        return `Process '${record.name}' already stopped (exit code: ${record.exitCode ?? "unknown"}).`;
+    }
+    if (record.status === "exited") {
+        return `Process '${record.name}' already stopped (exit code: ${record.exitCode ?? "unknown"}).`;
+    }
+    const signal = (args.signal ?? "SIGTERM");
+    if (constants.signals[signal] == null)
+        throw new Error(`Unknown signal: ${args.signal}`);
+    try {
+        repository.markStopInitiated(record.id);
+    }
+    catch (error) {
+        log.error({ id: record.id, err: error }, "failed to mark stop initiated — signalling anyway");
+    }
+    try {
+        await terminate(record, log, { signal, graceSeconds });
+    }
+    catch (error) {
+        if (error.code === "EPERM") {
+            try {
+                repository.clearStopReason(record.id);
+            }
+            catch {
+                // Best effort — a stale stop reason only suppresses one notification.
+            }
+            throw new Error(`Permission denied: cannot signal process ${record.pid}.`);
+        }
+        throw error;
+    }
+    // grace 0 is fire-and-forget — the watcher will observe the exit.
+    if (graceSeconds === 0)
+        return `Signal sent to process '${record.name}'.`;
+    await reconcileExit(reconcileDeps(deps), record.id, { dispatchNotification: false });
+    const updated = repository.get(args.process_id);
+    return `Process '${record.name}' stopped (exit code: ${updated?.exitCode ?? "unknown"}).`;
+};
+const textResult = (text) => ({
+    content: [{ type: "text", text }],
+    details: undefined,
+});
+/** pi extension factory exposing the detached process management tools to the agent. */
+export const createProcessToolsFactory = (deps) => (pi) => {
+    pi.registerTool({
+        name: "dispatch_detached_process",
+        label: "Dispatch Detached Process",
+        description: "Start a detached shell command that runs independently of Tachikoma and survives restarts. Output is captured to per-process stdout/stderr log files. Returns the record ID, PID, and log paths.",
+        promptSnippet: "Run long-lived shell commands detached from the conversation",
+        promptGuidelines: [
+            "Use dispatch_detached_process for long-running work (servers, builds, downloads) instead of blocking on bash.",
+        ],
+        parameters: DispatchProcessParams,
+        async execute(_toolCallId, params) {
+            return textResult(await handleDispatchProcess(deps, params));
+        },
+    });
+    pi.registerTool({
+        name: "query_process",
+        label: "Query Process",
+        description: "Inspect detached processes. With process_id, returns full details for that process; without it, lists running processes (archived=true lists exited ones). Each entry includes the ID needed by the other process tools.",
+        promptSnippet: "List or inspect detached processes",
+        promptGuidelines: [
+            "Check query_process before dispatch_detached_process to avoid starting duplicate work.",
+        ],
+        parameters: QueryProcessParams,
+        async execute(_toolCallId, params) {
+            return textResult(await handleQueryProcess(deps, params));
+        },
+    });
+    pi.registerTool({
+        name: "read_process_output",
+        label: "Read Process Output",
+        description: "Read the tail of a detached process's captured output. Defaults to stdout; pass stream='stderr' for the error stream. Large logs are truncated to the most recent output.",
+        promptSnippet: "Read captured output of a detached process",
+        promptGuidelines: [
+            "Use read_process_output to check on a detached process's progress or failures.",
+        ],
+        parameters: ReadProcessOutputParams,
+        async execute(_toolCallId, params) {
+            return textResult(await handleReadProcessOutput(deps, params));
+        },
+    });
+    pi.registerTool({
+        name: "terminate_process",
+        label: "Terminate Process",
+        description: "Stop a running detached process: sends the signal (default SIGTERM) to its process group and escalates to SIGKILL after grace_seconds. Reports 'already stopped' without error when the process has exited.",
+        promptSnippet: "Stop a running detached process",
+        promptGuidelines: [
+            "Use terminate_process when the user asks to stop, cancel, or kill a detached process.",
+        ],
+        parameters: TerminateProcessParams,
+        async execute(_toolCallId, params) {
+            return textResult(await handleTerminateProcess(deps, params));
+        },
+    });
+};
+//# sourceMappingURL=tools.js.map

package/dist/extensions/detached-processes/tools.js.map

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

package/dist/extensions/detached-processes/watcher.d.ts

@@ -0,0 +1,7 @@
+import { type ReconcileDeps } from "./reconcile.ts";
+/**
+ * Polling watcher tick: check every running record for liveness and reconcile
+ * the dead ones. Per-record error isolation keeps one bad record from
+ * stopping the sweep.
+ */
+export declare const createWatcherTick: (deps: ReconcileDeps) => () => Promise<void>;

package/dist/extensions/detached-processes/watcher.js

@@ -0,0 +1,19 @@
+import { reconcileExit } from "./reconcile.js";
+import { isAlive } from "./spawn.js";
+/**
+ * Polling watcher tick: check every running record for liveness and reconcile
+ * the dead ones. Per-record error isolation keeps one bad record from
+ * stopping the sweep.
+ */
+export const createWatcherTick = (deps) => async () => {
+    for (const record of deps.repository.listRunning()) {
+        try {
+            if (!isAlive(record.pid))
+                await reconcileExit(deps, record.id);
+        }
+        catch (error) {
+            deps.log.error({ id: record.id, err: error }, "watcher: error checking record");
+        }
+    }
+};
+//# sourceMappingURL=watcher.js.map

package/dist/extensions/detached-processes/watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.js","sourceRoot":"","sources":["../../../src/extensions/detached-processes/watcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAAmB,EAAE,EAAE,CAAC,KAAK,IAAmB,EAAE;IAClF,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,CAAC;QACnD,IAAI,CAAC;YACH,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC;gBAAE,MAAM,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QACjE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,gCAAgC,CAAC,CAAC;QAClF,CAAC;IACH,CAAC;AACH,CAAC,CAAC"}

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

@@ -0,0 +1,11 @@
+interface ExternalConfig {
+    sources: string[];
+}
+/**
+ * External extensions: loads Tachikoma extensions (defineExtension contract) from
+ * configured local sources and agent-installed records, registering each with the
+ * host. Install management tools clone git sources into `{dataDir}/extensions/<alias>`;
+ * installs, updates, and removals take effect on restart.
+ */
+declare const _default: import("../api.ts").TachikomaExtension<ExternalConfig>;
+export default _default;

package/dist/extensions/external/index.js

@@ -0,0 +1,40 @@
+import { isAbsolute, join } from "node:path";
+import { Type } from "typebox";
+import { expandHome } from "../../workspace.js";
+import { defineExtension } from "../api.js";
+import { InstallManager } from "./installs.js";
+import { loadExtensionModule } from "./loader.js";
+import { createExternalToolsFactory } from "./tools.js";
+/**
+ * External extensions: loads Tachikoma extensions (defineExtension contract) from
+ * configured local sources and agent-installed records, registering each with the
+ * host. Install management tools clone git sources into `{dataDir}/extensions/<alias>`;
+ * installs, updates, and removals take effect on restart.
+ */
+export default defineExtension({
+    name: "external",
+    configSchema: Type.Object({
+        sources: Type.Array(Type.String(), { default: [] }),
+    }),
+    async setup(app) {
+        const manager = new InstallManager({
+            state: app.state,
+            extensionsDir: join(app.workspace.dataDir, "extensions"),
+            log: app.log,
+        });
+        const configured = app.extensionConfig.sources.map((source) => {
+            const expanded = expandHome(source);
+            return isAbsolute(expanded) ? expanded : app.workspace.resolve(expanded);
+        });
+        const installed = Object.values(manager.list()).map((record) => record.path);
+        for (const source of new Set([...configured, ...installed])) {
+            const extension = await loadExtensionModule(source, app.log);
+            if (extension != null) {
+                app.registerExtension(extension);
+                app.log.info({ source, extension: extension.name }, "external extension registered");
+            }
+        }
+        app.agent.use(createExternalToolsFactory(manager));
+    },
+});
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extensions/external/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAMxD;;;;;GAKG;AACH,eAAe,eAAe,CAAiB;IAC7C,IAAI,EAAE,UAAU;IAEhB,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC;QACxB,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;KACpD,CAAC;IAEF,KAAK,CAAC,KAAK,CAAC,GAAG;QACb,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC;YACjC,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,aAAa,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE,YAAY,CAAC;YACxD,GAAG,EAAE,GAAG,CAAC,GAAG;SACb,CAAC,CAAC;QAEH,MAAM,UAAU,GAAG,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;YAC5D,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;YAEpC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC3E,CAAC,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAE7E,KAAK,MAAM,MAAM,IAAI,IAAI,GAAG,CAAC,CAAC,GAAG,UAAU,EAAE,GAAG,SAAS,CAAC,CAAC,EAAE,CAAC;YAC5D,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;YAE7D,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;gBACtB,GAAG,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;gBACjC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,IAAI,EAAE,EAAE,+BAA+B,CAAC,CAAC;YACvF,CAAC;QACH,CAAC;QAED,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,0BAA0B,CAAC,OAAO,CAAC,CAAC,CAAC;IACrD,CAAC;CACF,CAAC,CAAC"}

package/dist/extensions/external/installs.d.ts

@@ -0,0 +1,39 @@
+import type { KeyValueState } from "../../db/state.ts";
+import type { Logger } from "../../log.ts";
+export declare const ALIAS_PATTERN: RegExp;
+/** Git sources are cloned and updatable; anything else is a local path loaded in place. */
+export declare const isGitSource: (source: string) => boolean;
+export interface InstallRecord {
+    source: string;
+    installedAt: string;
+    path: string;
+}
+export interface UpdateResult {
+    status: "updated" | "skipped";
+    detail: string;
+}
+export type InstallsState = Pick<KeyValueState, "get" | "set">;
+export interface InstallManagerDeps {
+    state: InstallsState;
+    /** Where git sources are cloned: `{dataDir}/extensions/<alias>`. */
+    extensionsDir: string;
+    log: Logger;
+    now?: () => Date;
+}
+/**
+ * Agent-driven external extension installs. Git sources are cloned under the data dir and
+ * updated with `git pull`; local paths are recorded as-is (always current).
+ * Records live in the extension's KV state; loading happens on the next startup.
+ */
+export declare class InstallManager {
+    private readonly state;
+    private readonly extensionsDir;
+    private readonly log;
+    private readonly now;
+    constructor({ state, extensionsDir, log, now }: InstallManagerDeps);
+    list(): Record<string, InstallRecord>;
+    install(source: string, alias: string): Promise<InstallRecord>;
+    private cloneGitSource;
+    update(alias: string): Promise<UpdateResult>;
+    uninstall(alias: string): Promise<InstallRecord>;
+}

package/dist/extensions/external/installs.js

@@ -0,0 +1,98 @@
+import { execFile } from "node:child_process";
+import { mkdir, rm } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { promisify } from "node:util";
+import { expandHome } from "../../workspace.js";
+import { loadExtensionModule } from "./loader.js";
+const execFileAsync = promisify(execFile);
+export const ALIAS_PATTERN = /^[a-z0-9][a-z0-9-]*$/;
+const GIT_SOURCE_PATTERN = /^(https?:\/\/|git@|ssh:\/\/|file:\/\/)|\.git$/;
+/** Git sources are cloned and updatable; anything else is a local path loaded in place. */
+export const isGitSource = (source) => GIT_SOURCE_PATTERN.test(source);
+const INSTALLS_KEY = "installs";
+/**
+ * Agent-driven external extension installs. Git sources are cloned under the data dir and
+ * updated with `git pull`; local paths are recorded as-is (always current).
+ * Records live in the extension's KV state; loading happens on the next startup.
+ */
+export class InstallManager {
+    state;
+    extensionsDir;
+    log;
+    now;
+    constructor({ state, extensionsDir, log, now }) {
+        this.state = state;
+        this.extensionsDir = extensionsDir;
+        this.log = log;
+        this.now = now ?? (() => new Date());
+    }
+    list() {
+        return this.state.get(INSTALLS_KEY) ?? {};
+    }
+    async install(source, alias) {
+        if (!ALIAS_PATTERN.test(alias)) {
+            throw new Error(`Invalid alias '${alias}': must match [a-z0-9][a-z0-9-]*`);
+        }
+        const records = this.list();
+        if (records[alias] != null) {
+            throw new Error(`ExternalExtension '${alias}' is already installed. Uninstall it or pick another alias.`);
+        }
+        const fromGit = isGitSource(source);
+        const path = fromGit ? await this.cloneGitSource(source, alias) : resolve(expandHome(source));
+        if ((await loadExtensionModule(path, this.log)) == null) {
+            if (fromGit)
+                await rm(path, { recursive: true, force: true });
+            throw new Error(`Source '${source}' does not contain a valid Tachikoma extension module ` +
+                "(expected a .ts/.js file or an index.ts/index.js whose default export has 'name' and 'setup').");
+        }
+        const record = { source, installedAt: this.now().toISOString(), path };
+        this.state.set(INSTALLS_KEY, { ...records, [alias]: record });
+        this.log.info({ alias, source, path }, "external extension installed");
+        return record;
+    }
+    async cloneGitSource(source, alias) {
+        const target = join(this.extensionsDir, alias);
+        await mkdir(this.extensionsDir, { recursive: true });
+        await rm(target, { recursive: true, force: true });
+        try {
+            await execFileAsync("git", ["clone", source, target]);
+        }
+        catch (error) {
+            throw new Error(`git clone failed for '${source}': ${error}`);
+        }
+        return target;
+    }
+    async update(alias) {
+        const record = this.list()[alias];
+        if (record == null)
+            throw new Error(`ExternalExtension '${alias}' is not installed.`);
+        if (!isGitSource(record.source)) {
+            return {
+                status: "skipped",
+                detail: "Local external extensions load directly from their source path and are always current.",
+            };
+        }
+        try {
+            const { stdout } = await execFileAsync("git", ["pull", "--ff-only"], { cwd: record.path });
+            this.log.info({ alias }, "external extension updated");
+            return { status: "updated", detail: stdout.trim() };
+        }
+        catch (error) {
+            throw new Error(`git pull failed for '${alias}': ${error}`);
+        }
+    }
+    async uninstall(alias) {
+        const records = this.list();
+        const record = records[alias];
+        if (record == null)
+            throw new Error(`ExternalExtension '${alias}' is not installed.`);
+        // Only remove directories we cloned ourselves; local sources stay untouched.
+        if (isGitSource(record.source)) {
+            await rm(record.path, { recursive: true, force: true });
+        }
+        this.state.set(INSTALLS_KEY, Object.fromEntries(Object.entries(records).filter(([key]) => key !== alias)));
+        this.log.info({ alias }, "external extension uninstalled");
+        return record;
+    }
+}
+//# sourceMappingURL=installs.js.map

package/dist/extensions/external/installs.js.map

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

package/dist/extensions/external/loader.d.ts

@@ -0,0 +1,19 @@
+import type { Logger } from "../../log.ts";
+import type { TachikomaExtension } from "../api.ts";
+/** Resolve a source (file or directory) to its extension module file, or null. */
+export declare const resolveExtensionModule: (source: string) => string | null;
+export type ExtensionValidation = {
+    ok: true;
+    extension: TachikomaExtension<never>;
+} | {
+    ok: false;
+    reason: string;
+};
+/** Check that a module's default export satisfies the defineExtension contract. */
+export declare const validateExtensionShape: (value: unknown) => ExtensionValidation;
+/**
+ * Load a Tachikoma extension from a source path: resolve the module file,
+ * import it natively, and validate its default export. Invalid sources are
+ * logged and skipped (null) so one bad external extension never aborts startup.
+ */
+export declare const loadExtensionModule: (source: string, log: Logger) => Promise<TachikomaExtension<never> | null>;

package/dist/extensions/external/loader.js

@@ -0,0 +1,70 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { existsSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+const INDEX_CANDIDATES = ["index.ts", "index.js"];
+/** Resolve a source (file or directory) to its extension module file, or null. */
+export const resolveExtensionModule = (source) => {
+    if (!existsSync(source))
+        return null;
+    if (statSync(source).isFile()) {
+        return source.endsWith(".ts") || source.endsWith(".js") ? source : null;
+    }
+    for (const candidate of INDEX_CANDIDATES) {
+        const path = join(source, candidate);
+        if (existsSync(path))
+            return path;
+    }
+    return null;
+};
+/** Check that a module's default export satisfies the defineExtension contract. */
+export const validateExtensionShape = (value) => {
+    if (value == null || typeof value !== "object") {
+        return { ok: false, reason: "default export is not an object" };
+    }
+    const candidate = value;
+    if (typeof candidate.name !== "string" || candidate.name.trim() === "") {
+        return { ok: false, reason: "missing a non-empty 'name' string" };
+    }
+    if (typeof candidate.setup !== "function") {
+        return { ok: false, reason: "missing a 'setup' function" };
+    }
+    if (candidate.configSchema != null && typeof candidate.configSchema !== "object") {
+        return { ok: false, reason: "'configSchema' must be a TypeBox schema object" };
+    }
+    return { ok: true, extension: candidate };
+};
+/**
+ * Load a Tachikoma extension from a source path: resolve the module file,
+ * import it natively, and validate its default export. Invalid sources are
+ * logged and skipped (null) so one bad external extension never aborts startup.
+ */
+export const loadExtensionModule = async (source, log) => {
+    const modulePath = resolveExtensionModule(source);
+    if (modulePath == null) {
+        log.warn({ source }, "external extension source has no loadable extension module (.ts/.js) — skipping");
+        return null;
+    }
+    let module;
+    try {
+        module = await import(__rewriteRelativeImportExtension(pathToFileURL(modulePath).href));
+    }
+    catch (error) {
+        log.warn({ source: modulePath, err: error }, "external extension module failed to import — skipping");
+        return null;
+    }
+    const validation = validateExtensionShape(module.default);
+    if (!validation.ok) {
+        log.warn({ source: modulePath, reason: validation.reason }, "invalid external extension — skipping");
+        return null;
+    }
+    return validation.extension;
+};
+//# sourceMappingURL=loader.js.map

package/dist/extensions/external/loader.js.map

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

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

@@ -0,0 +1,17 @@
+import type { ExtensionFactory } from "@earendil-works/pi-coding-agent";
+import { type Static, Type } from "typebox";
+import { type InstallManager } from "./installs.ts";
+export declare const InstallPluginParams: Type.TObject<{
+    source: Type.TString;
+    alias: Type.TString;
+}>;
+export declare const PluginAliasParams: Type.TObject<{
+    alias: Type.TString;
+}>;
+export declare const ListInstalledPluginsParams: Type.TObject<{}>;
+export declare const handleInstallExternalExtension: (manager: InstallManager, args: Static<typeof InstallPluginParams>) => Promise<string>;
+export declare const handleUpdateExternalExtension: (manager: InstallManager, args: Static<typeof PluginAliasParams>) => Promise<string>;
+export declare const handleListInstalledPlugins: (manager: InstallManager) => string;
+export declare const handleUninstallExtension: (manager: InstallManager, args: Static<typeof PluginAliasParams>) => Promise<string>;
+/** pi extension factory exposing the extension install management tools to the agent. */
+export declare const createExternalToolsFactory: (manager: InstallManager) => ExtensionFactory;