pi-kot 0.1.21 → 0.1.22

package/server/extension-scanner.js

@@ -0,0 +1,107 @@
+/**
+ * Surface extension-contributed tools from the filesystem (no live
+ * session needed).
+ *
+ * Uses the pi SDK's DefaultPackageManager + discoverAndLoadExtensions
+ * to enumerate all registered tools from installed packages.
+ */
+import { discoverAndLoadExtensions, DefaultPackageManager, SettingsManager, } from "@earendil-works/pi-coding-agent";
+import { config } from "./config.js";
+/**
+ * Resolve extension-contributed tools visible to a session in `cwd`.
+ * Uses the SDK package manager to discover installed packages, then
+ * loads each extension to enumerate its registered tools.
+ *
+ * Failures inside individual packages surface as `errors[]` rather
+ * than throwing — a single broken extension must not block the
+ * tools listing.
+ */
+export async function discoverExtensionResources(cwd) {
+    const errors = [];
+    let extensionPathToPackage;
+    try {
+        const settingsManager = SettingsManager.create(cwd, config.piConfigDir);
+        await settingsManager.reload?.();
+        const packageManager = new DefaultPackageManager({
+            cwd,
+            agentDir: config.piConfigDir,
+            settingsManager,
+        });
+        const resolved = await packageManager.resolve();
+        extensionPathToPackage = new Map();
+        for (const r of resolved.extensions) {
+            if (!r.enabled)
+                continue;
+            const src = r.metadata.source;
+            if (typeof src !== "string" || src.length === 0)
+                continue;
+            // Normalize: strip npm: prefix so packageSource matches
+            // ext.package from the /extensions endpoint (e.g. both
+            // become "pi-web-access" instead of "npm:pi-web-access").
+            const normalized = src.replace(/^npm:/, "");
+            extensionPathToPackage.set(r.path, normalized);
+        }
+        // Also surface tools from extensions in the legacy extensions dir
+        // that aren't behind a package manager entry (e.g. hand-dropped
+        // extensions). Use their resolved path as the source name.
+        for (const r of resolved.extensions) {
+            if (!r.enabled)
+                continue;
+            const src = r.metadata.source;
+            if (typeof src === "string" && src.length > 0)
+                continue; // already mapped
+            // Unattributed extension — use its name as fallback
+            const name = r.path
+                .split(/[/\\]/)
+                .pop()
+                ?.replace(/\.\w+$/, "") ?? r.path;
+            if (!extensionPathToPackage.has(r.path)) {
+                extensionPathToPackage.set(r.path, name);
+            }
+        }
+    }
+    catch (err) {
+        errors.push({
+            path: "<package-manager>",
+            error: err instanceof Error ? err.message : String(err),
+        });
+        return { tools: [], errors };
+    }
+    if (extensionPathToPackage.size === 0) {
+        return { tools: [], errors };
+    }
+    let loaded;
+    try {
+        loaded = await discoverAndLoadExtensions(Array.from(extensionPathToPackage.keys()), cwd, config.piConfigDir);
+    }
+    catch (err) {
+        errors.push({
+            path: "<discoverAndLoadExtensions>",
+            error: err instanceof Error ? err.message : String(err),
+        });
+        return { tools: [], errors };
+    }
+    for (const e of loaded.errors) {
+        errors.push({ path: e.path, error: e.error });
+    }
+    const tools = [];
+    for (const ext of loaded.extensions) {
+        const pkgSource = extensionPathToPackage.get(ext.path) ??
+            extensionPathToPackage.get(ext.resolvedPath);
+        if (pkgSource === undefined)
+            continue;
+        for (const [, registered] of ext.tools) {
+            const def = registered.definition;
+            const info = {
+                name: def.name,
+                packageSource: pkgSource,
+                description: typeof def.description === "string" && def.description.length > 0
+                    ? def.description
+                    : "",
+            };
+            tools.push(info);
+        }
+    }
+    return { tools, errors };
+}
+//# sourceMappingURL=extension-scanner.js.map

package/server/extension-scanner.js.map

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

package/server/extension-ui-bridge.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Extension UI Bridge — adapts extension `ctx.ui` interactions (select, confirm,
+ * notify) to the WebSocket/SSE + REST model of pi-kot's web GUI.
+ *
+ * When the extension calls `ctx.ui.select("Rewind to checkpoint:", items)`, this
+ * bridge sends an `extension_ui_select` SSE event to the browser, creating a
+ * pending request. The browser renders the selector and responds via
+ * `POST /api/v1/sessions/:id/extension-ui/respond`, which resolves the promise
+ * and lets the extension continue.
+ *
+ * Unused TUI-specific methods (setWidget, setFooter, setHeader, custom, …) are
+ * no-ops so that any extension command works unmodified through the bridge.
+ */
+import type { ExtensionUIContext } from "@earendil-works/pi-coding-agent";
+import type { SSEClient } from "./session-store.js";
+/**
+ * Resolve a pending select/confirm/input request.
+ * Called from `POST /api/v1/sessions/:id/extension-ui/respond`.
+ */
+export declare function resolveExtensionUIRequest(requestId: string, value: unknown): boolean;
+/**
+ * Cancel all pending requests (e.g., when the command is aborted or session
+ * is disposed). Each pending promise rejects so the extension handler sees
+ * a cancelled/interrupted state.
+ */
+export declare function cancelAllPendingRequests(): void;
+/**
+ * Create an `ExtensionUIContext` that bridges extension UI interactions
+ * to the browser GUI via SSE events + REST callbacks.
+ *
+ * @param clients - The live session's connected SSE clients.
+ * @param sessionId - The session ID, included in SSE events for routing.
+ */
+export declare function createBridgeUIContext(clients: Set<SSEClient>, sessionId: string): ExtensionUIContext;
+//# sourceMappingURL=extension-ui-bridge.d.ts.map

package/server/extension-ui-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-ui-bridge.d.ts","sourceRoot":"","sources":["../src/extension-ui-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EACV,kBAAkB,EAInB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAiBpD;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,OAAO,GACb,OAAO,CA0BT;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAiB/C;AAOD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC,EACvB,SAAS,EAAE,MAAM,GAChB,kBAAkB,CAqLpB"}

package/server/extension-ui-bridge.js

@@ -0,0 +1,228 @@
+/**
+ * Extension UI Bridge — adapts extension `ctx.ui` interactions (select, confirm,
+ * notify) to the WebSocket/SSE + REST model of pi-kot's web GUI.
+ *
+ * When the extension calls `ctx.ui.select("Rewind to checkpoint:", items)`, this
+ * bridge sends an `extension_ui_select` SSE event to the browser, creating a
+ * pending request. The browser renders the selector and responds via
+ * `POST /api/v1/sessions/:id/extension-ui/respond`, which resolves the promise
+ * and lets the extension continue.
+ *
+ * Unused TUI-specific methods (setWidget, setFooter, setHeader, custom, …) are
+ * no-ops so that any extension command works unmodified through the bridge.
+ */
+import { randomUUID } from "node:crypto";
+const pendingSelects = new Map();
+const pendingConfirms = new Map();
+const pendingInputs = new Map();
+const REQUEST_TIMEOUT_MS = 120_000; // 2 minutes
+/**
+ * Resolve a pending select/confirm/input request.
+ * Called from `POST /api/v1/sessions/:id/extension-ui/respond`.
+ */
+export function resolveExtensionUIRequest(requestId, value) {
+    // Try select
+    const sel = pendingSelects.get(requestId);
+    if (sel !== undefined) {
+        clearTimeout(sel.timer);
+        sel.resolve(typeof value === "string" ? value : undefined);
+        pendingSelects.delete(requestId);
+        return true;
+    }
+    // Try confirm
+    const con = pendingConfirms.get(requestId);
+    if (con !== undefined) {
+        clearTimeout(con.timer);
+        con.resolve(value === true || value === "true" || value === "yes");
+        pendingConfirms.delete(requestId);
+        return true;
+    }
+    // Try input
+    const inp = pendingInputs.get(requestId);
+    if (inp !== undefined) {
+        clearTimeout(inp.timer);
+        inp.resolve(typeof value === "string" ? value : undefined);
+        pendingInputs.delete(requestId);
+        return true;
+    }
+    return false;
+}
+/**
+ * Cancel all pending requests (e.g., when the command is aborted or session
+ * is disposed). Each pending promise rejects so the extension handler sees
+ * a cancelled/interrupted state.
+ */
+export function cancelAllPendingRequests() {
+    const err = new Error("Extension UI request cancelled");
+    for (const [id, req] of pendingSelects) {
+        clearTimeout(req.timer);
+        req.reject(err);
+        pendingSelects.delete(id);
+    }
+    for (const [id, req] of pendingConfirms) {
+        clearTimeout(req.timer);
+        req.reject(err);
+        pendingConfirms.delete(id);
+    }
+    for (const [id, req] of pendingInputs) {
+        clearTimeout(req.timer);
+        req.reject(err);
+        pendingInputs.delete(id);
+    }
+}
+/**
+ * Create an `ExtensionUIContext` that bridges extension UI interactions
+ * to the browser GUI via SSE events + REST callbacks.
+ *
+ * @param clients - The live session's connected SSE clients.
+ * @param sessionId - The session ID, included in SSE events for routing.
+ */
+export function createBridgeUIContext(clients, sessionId) {
+    /** Send a typed SSE event to all connected clients. */
+    function send(type, extra = {}) {
+        const payload = {
+            type,
+            sessionId,
+            ...extra,
+        };
+        for (const client of clients) {
+            try {
+                client.send(payload);
+            }
+            catch {
+                clients.delete(client);
+            }
+        }
+    }
+    return {
+        // ── Interactive methods (bridge to GUI) ──
+        select: async (title, options, _opts) => {
+            return new Promise((resolve, reject) => {
+                const requestId = randomUUID();
+                send("extension_ui_select", { requestId, title, options });
+                const timer = setTimeout(() => {
+                    pendingSelects.delete(requestId);
+                    reject(new Error(`Extension UI select timed out: ${title}`));
+                }, REQUEST_TIMEOUT_MS);
+                pendingSelects.set(requestId, { requestId, resolve, reject, timer });
+            });
+        },
+        confirm: async (title, message, _opts) => {
+            return new Promise((resolve, reject) => {
+                const requestId = randomUUID();
+                send("extension_ui_confirm", { requestId, title, message });
+                const timer = setTimeout(() => {
+                    pendingConfirms.delete(requestId);
+                    reject(new Error(`Extension UI confirm timed out: ${title}`));
+                }, REQUEST_TIMEOUT_MS);
+                pendingConfirms.set(requestId, { requestId, resolve, reject, timer });
+            });
+        },
+        input: async (title, placeholder, _opts) => {
+            return new Promise((resolve, reject) => {
+                const requestId = randomUUID();
+                send("extension_ui_input", {
+                    requestId,
+                    title,
+                    placeholder: placeholder ?? "",
+                });
+                const timer = setTimeout(() => {
+                    pendingInputs.delete(requestId);
+                    reject(new Error(`Extension UI input timed out: ${title}`));
+                }, REQUEST_TIMEOUT_MS);
+                pendingInputs.set(requestId, { requestId, resolve, reject, timer });
+            });
+        },
+        notify: (message, notificationType) => {
+            send("extension_ui_notify", {
+                message,
+                notificationType: notificationType ?? "info",
+            });
+        },
+        // ── No-ops (TUI-specific, not applicable in web GUI) ──
+        onTerminalInput: (_handler) => {
+            return () => { };
+        },
+        setStatus: (_key, _text) => {
+            // Status bar is managed by the GUI.
+        },
+        setWorkingMessage: (_message) => {
+            // Working message is managed by the GUI.
+        },
+        setWorkingVisible: (_visible) => {
+            // Working indicator visibility is managed by the GUI.
+        },
+        setWorkingIndicator: (_options) => {
+            // Working indicator animation is managed by the GUI.
+        },
+        setHiddenThinkingLabel: (_label) => {
+            // Hidden thinking label is managed by the GUI.
+        },
+        setWidget: (_key, 
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        _content, _options) => {
+            // Widgets are TUI-specific.
+        },
+        setFooter: (
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        _factory) => {
+            // Footer is TUI-specific.
+        },
+        setHeader: (
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        _factory) => {
+            // Header is TUI-specific.
+        },
+        setTitle: (_title) => {
+            // Title is managed by the browser tab.
+        },
+        // custom is intentionally undefined so that extensions which check
+        // `if (!ctx.ui.custom)` fall back to `ctx.ui.select()` / `ctx.ui.confirm()`
+        // instead of calling the TUI custom component factory and getting nothing.
+        // This fixes pi-rewind's `/rewind` command which would exit silently
+        // when `custom` returned `Promise.resolve(undefined)` immediately.
+        custom: undefined,
+        pasteToEditor: (_text) => {
+            // Editor paste is not supported in bridge mode.
+        },
+        setEditorText: (_text) => {
+            // Editor text is managed by the GUI.
+        },
+        getEditorText: () => {
+            return "";
+        },
+        editor: async (_title, _prefill) => {
+            // Multi-line editor is not supported in bridge mode.
+            return undefined;
+        },
+        addAutocompleteProvider: (_factory) => {
+            // Autocomplete is managed by the GUI.
+        },
+        setEditorComponent: (_factory) => {
+            // Editor component is managed by the GUI.
+        },
+        getEditorComponent: () => {
+            return undefined;
+        },
+        get theme() {
+            // Return a minimal theme stub — the server doesn't have a TUI theme.
+            return {};
+        },
+        getAllThemes: () => {
+            return [];
+        },
+        getTheme: () => {
+            return undefined;
+        },
+        setTheme: () => {
+            return { success: false, error: "Theme switching not supported via bridge" };
+        },
+        getToolsExpanded: () => {
+            return true;
+        },
+        setToolsExpanded: () => {
+            // Tool expansion is managed by the GUI.
+        },
+    };
+}
+//# sourceMappingURL=extension-ui-bridge.js.map

package/server/extension-ui-bridge.js.map

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

package/server/file-manager.d.ts

@@ -0,0 +1,79 @@
+import type { Readable } from "node:stream";
+export declare class PathOutsideRootError extends Error {
+    constructor(target: string, root: string);
+}
+export declare class NotFoundError extends Error {
+    constructor(path: string);
+}
+export declare class NotAFileError extends Error {
+    constructor(path: string);
+}
+export declare class FileTooLargeError extends Error {
+    readonly size: number;
+    readonly limit: number;
+    constructor(path: string, size: number, limit: number);
+}
+export declare class DirectoryNotEmptyError extends Error {
+    constructor(path: string);
+}
+export declare class InvalidNameError extends Error {
+    constructor(message?: string);
+}
+export declare class ChecksumMismatchError extends Error {
+    readonly target: string;
+    readonly expected: string;
+    readonly actual: string;
+    constructor(target: string, expected: string, actual: string);
+}
+export declare class TargetExistsError extends Error {
+    constructor(path: string);
+}
+export declare const MAX_READ_BYTES: number;
+export declare const SEARCH_SKIP_DIRS: ReadonlySet<string>;
+export declare function assertInsideRoot(target: string, root: string): string;
+export interface TreeNode {
+    name: string;
+    path: string;
+    type: "file" | "directory";
+    children?: TreeNode[];
+    truncated?: boolean;
+}
+export interface GetTreeOptions {
+    maxDepth?: number;
+}
+export declare function getTree(rootPath: string, opts?: GetTreeOptions): Promise<TreeNode>;
+export declare function listAllFiles(rootPath: string): Promise<string[]>;
+export interface ReadResult {
+    path: string;
+    content: string;
+    size: number;
+    language: string;
+    binary: boolean;
+}
+export declare function readFile(absPath: string, root: string): Promise<ReadResult>;
+export declare function writeFile(absPath: string, root: string, content: string): Promise<void>;
+export declare function downloadStream(absPath: string, root: string): Promise<{
+    kind: "file";
+    filename: string;
+    size: number;
+    stream: Readable;
+} | {
+    kind: "directory";
+    filename: string;
+    stream: Readable;
+}>;
+export declare function writeFileBytes(parentAbsPath: string, name: string, root: string, source: AsyncIterable<Buffer | Uint8Array>, opts?: {
+    expectedSha256?: string;
+    overwrite?: boolean;
+}): Promise<{
+    path: string;
+    size: number;
+    sha256: string;
+}>;
+export declare function makeDirectory(parentAbsPath: string, root: string, name: string): Promise<string>;
+export declare function renameEntry(absPath: string, root: string, newName: string): Promise<string>;
+export declare function moveEntry(srcAbsPath: string, destAbsPath: string, root: string): Promise<string>;
+export declare function deleteEntry(absPath: string, root: string, opts?: {
+    recursive?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=file-manager.d.ts.map

package/server/file-manager.d.ts.map

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