pi-kot 0.1.0

package/dist/server/extension-manager.js

@@ -0,0 +1,401 @@
+/**
+ * Extension manager — runtime discovery + install for pi.dev extensions.
+ * Scans ~/.pi/agent/ for installed extensions, agents, and packages,
+ * and exposes a curated recommendation catalog optimised for pi-kot.
+ *
+ * Architecture adapted from pi-forge's extension dynamic detection pattern:
+ *   detect → activate — UI features light up based on what's installed.
+ */
+import { readFile, readdir } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { execSync } from "node:child_process";
+// ── Path helpers ────────────────────────────────────────────────────
+function piAgentDir() {
+    // getAgentDir in pi SDK defaults to ~/.pi/agent
+    return join(homedir(), ".pi", "agent");
+}
+function extensionsDir() {
+    return join(piAgentDir(), "extensions");
+}
+function agentsDir() {
+    return join(piAgentDir(), "agents");
+}
+function settingsPath() {
+    return join(piAgentDir(), "settings.json");
+}
+function npmPackagePath() {
+    return join(piAgentDir(), "npm", "package.json");
+}
+// ── Known extension registry (curated) ──────────────────────────────
+const knownExtensions = [
+    // ── Orchestration ──
+    {
+        id: "pi-subagents",
+        name: "pi-subagents",
+        description: "Delegates tasks to specialised subagents (scout, planner, worker, reviewer) with isolated context windows. The core multi-agent extension.",
+        package: "npm:pi-subagents",
+        category: "orchestration",
+        providesAgentTypes: ["scout", "planner", "worker", "reviewer"],
+        enablesFeatures: [
+            "Agent type config (planner/reviewer/scout/worker models)",
+            "Orchestration panel agent detail view",
+        ],
+        icon: "🧩",
+    },
+    {
+        id: "pi-orchestration",
+        name: "pi-orchestration",
+        description: "Agnostic subagent orchestration with depth limiting, worktree isolation, and per-agent model selection. Supports chain and parallel execution.",
+        package: "npm:pi-orchestration",
+        category: "orchestration",
+        providesAgentTypes: ["scout", "specialist", "worker", "reviewer", "coordinator"],
+        enablesFeatures: [
+            "Advanced orchestration with depth limits",
+            "Worktree isolation for parallel agents",
+        ],
+        icon: "⚡",
+    },
+    // ── Tools ──
+    {
+        id: "pi-web-access",
+        name: "pi-web-access",
+        description: "Web search, content extraction, and API interaction tools for pi. Essential for research-aware coding sessions.",
+        package: "npm:pi-web-access",
+        category: "tools",
+        enablesFeatures: ["Web search in agent sessions"],
+        icon: "🌐",
+    },
+    {
+        id: "pi-playwright",
+        name: "pi-playwright",
+        description: "Automated browser testing and web scraping via Playwright. Steer the agent through real web UI.",
+        package: "npm:pi-playwright",
+        category: "tools",
+        enablesFeatures: ["Browser automation in agent sessions"],
+        icon: "🎭",
+    },
+    {
+        id: "pi-kilocode",
+        name: "pi-kilocode",
+        description: "Kilo Code integration for structured output, code analysis, and AI-powered code transformations.",
+        package: "npm:pi-kilocode",
+        category: "tools",
+        enablesFeatures: ["Structured code analysis"],
+        icon: "📐",
+    },
+    // ── Productivity ──
+    {
+        id: "pi-rewind",
+        name: "pi-rewind",
+        description: "Session history navigation — checkpoint, rewind, and branch from any prior state. Like undo for your agent.",
+        package: "npm:@ayulab/pi-rewind",
+        category: "productivity",
+        verified: true,
+        enablesFeatures: ["Checkpoint/rewind in session history"],
+        icon: "⏪",
+    },
+    {
+        id: "pi-processes",
+        name: "pi-processes",
+        description: "Long-running background processes (dev servers, watchers, builds) that outlive a single turn. Log capture, regex watches, exit alerts.",
+        package: "npm:pi-processes",
+        category: "productivity",
+        enablesFeatures: ["Background process management"],
+        icon: "⚙️",
+    },
+    // ── Integration ──
+    {
+        id: "@ifi/pi-extension-subagents",
+        name: "pi-extension-subagents (ifi)",
+        description: "Alternative subagent implementation with built-in agent configs, conversation viewer, and cross-extension RPC.",
+        package: "npm:@ifi/pi-extension-subagents",
+        category: "orchestration",
+        providesAgentTypes: [
+            "scout",
+            "planner",
+            "worker",
+            "reviewer",
+            "context-builder",
+            "researcher",
+            "artist",
+            "frontend-designer",
+        ],
+        enablesFeatures: ["Built-in agent configs", "Conversation overlay UI"],
+        icon: "🔧",
+    },
+];
+// ── Discovery ───────────────────────────────────────────────────────
+/** Get installed npm packages from ~/.pi/agent/npm/package.json */
+async function readInstalledPackages() {
+    const installed = new Set();
+    try {
+        const pkg = JSON.parse(await readFile(npmPackagePath(), "utf-8"));
+        for (const name of Object.keys(pkg.dependencies || {})) {
+            installed.add(`npm:${name}`);
+            installed.add(name);
+        }
+    }
+    catch {
+        // No npm dir yet — that's fine
+    }
+    return installed;
+}
+/** Scan ~/.pi/agent/extensions/ for *.ts files and subdirectories */
+async function scanExtensionsDir() {
+    const results = [];
+    try {
+        const dir = extensionsDir();
+        if (!existsSync(dir))
+            return results;
+        const entries = await readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.name.endsWith(".ts")) {
+                const name = entry.name.replace(/\.ts$/, "");
+                const desc = await extractDescriptionFromExtension(join(dir, entry.name));
+                results.push({
+                    name,
+                    description: desc || `Custom extension at ~/.pi/agent/extensions/${entry.name}`,
+                    source: "extensions_dir",
+                    enablesFeatures: ["Custom extension loaded"],
+                });
+            }
+            else if (entry.isDirectory()) {
+                results.push({
+                    name: entry.name,
+                    description: `Extension directory at ~/.pi/agent/extensions/${entry.name}/`,
+                    source: "extensions_dir",
+                    enablesFeatures: ["Custom extension loaded"],
+                });
+            }
+        }
+    }
+    catch {
+        // No extensions dir
+    }
+    return results;
+}
+/** Scan ~/.pi/agent/agents/ for *.md agent definitions */
+async function scanAgentsDir() {
+    const agents = [];
+    try {
+        const dir = agentsDir();
+        if (!existsSync(dir))
+            return agents;
+        const entries = await readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.name.endsWith(".md"))
+                continue;
+            const content = await readFile(join(dir, entry.name), "utf-8");
+            const name = entry.name.replace(/\.md$/, "");
+            // Parse YAML frontmatter (basic, no external dep)
+            const fM = parseFrontmatter(content);
+            agents.push({
+                name: fM.name || name,
+                description: fM.description || `Agent definition from ~/.pi/agent/agents/${entry.name}`,
+                model: fM.model,
+                tools: fM.tools?.split(",").map((t) => t.trim()).filter(Boolean),
+                source: "file",
+            });
+        }
+    }
+    catch {
+        // No agents dir
+    }
+    return agents;
+}
+/** Crude frontmatter parser — enough for YAML name/desc/model/tools */
+function parseFrontmatter(content) {
+    const result = {};
+    const match = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!match)
+        return result;
+    for (const line of match[1].split("\n")) {
+        const sep = line.indexOf(":");
+        if (sep === -1)
+            continue;
+        const key = line.slice(0, sep).trim();
+        const value = line.slice(sep + 1).trim().replace(/^["']|["']$/g, "");
+        result[key] = value;
+    }
+    return result;
+}
+/** Try to grab a one-liner description from an extension file */
+async function extractDescriptionFromExtension(filePath) {
+    try {
+        const content = await readFile(filePath, "utf-8");
+        const lines = content.split("\n").slice(0, 30);
+        for (const line of lines) {
+            const trimmed = line.trim();
+            // Look for description in JSDoc
+            if (trimmed.startsWith("*") && !trimmed.startsWith("* "))
+                continue;
+            if (trimmed.startsWith("* ") && trimmed.length > 5) {
+                const text = trimmed.replace(/^\*\s?/, "");
+                if (text.length > 10)
+                    return text;
+            }
+        }
+    }
+    catch {
+        // ignore
+    }
+    return null;
+}
+/** Read settings.json for configured packages */
+async function readConfiguredPackages() {
+    try {
+        const raw = await readFile(settingsPath(), "utf-8");
+        const settings = JSON.parse(raw);
+        return settings.packages || [];
+    }
+    catch {
+        return [];
+    }
+}
+// ── Main API ────────────────────────────────────────────────────────
+export async function discoverExtensions() {
+    const installed = await readInstalledPackages();
+    const configured = new Set(await readConfiguredPackages());
+    // Scan filesystem
+    const [extFiles, agents] = await Promise.all([
+        scanExtensionsDir(),
+        scanAgentsDir(),
+    ]);
+    // Build detected list from packages
+    const detectedPkgs = [];
+    for (const pkg of configured) {
+        // Look up known info
+        const known = knownExtensions.find((k) => k.package === pkg);
+        detectedPkgs.push({
+            name: known?.name ?? pkg.replace("npm:", ""),
+            description: known?.description ?? `Installed package: ${pkg}`,
+            source: "package",
+            version: known ? undefined : undefined,
+            package: pkg,
+            agentTypes: known?.providesAgentTypes,
+            enablesFeatures: known?.enablesFeatures,
+        });
+    }
+    // Build recommended list with install status
+    const allInstalled = new Set();
+    for (const pkg of configured)
+        allInstalled.add(pkg);
+    installed.forEach((p) => allInstalled.add(p));
+    // Also check if agents dir has the agent types
+    const agentNames = new Set(agents.map((a) => a.name));
+    for (const ext of extFiles)
+        allInstalled.add(ext.name);
+    const recommended = knownExtensions.map((k) => ({
+        ...k,
+        installed: allInstalled.has(k.package) ||
+            allInstalled.has(k.id) ||
+            allInstalled.has(k.package.replace("npm:", "").replace("@", "")) ||
+            (k.providesAgentTypes?.some((t) => agentNames.has(t)) ?? false),
+    }));
+    return {
+        detected: [...detectedPkgs, ...extFiles],
+        recommended,
+        agents,
+    };
+}
+export async function uninstallExtension(packageName) {
+    try {
+        const npmName = packageName.replace(/^npm:/, "");
+        const pkgEntry = packageName.startsWith("npm:") ? packageName : `npm:${npmName}`;
+        // Remove from settings.json packages array
+        const settingsRaw = await readFile(settingsPath(), "utf-8");
+        const settings = JSON.parse(settingsRaw);
+        if (settings.packages) {
+            settings.packages = settings.packages.filter((p) => p !== pkgEntry);
+        }
+        // Write settings back atomically
+        const tmpPath = settingsPath() + ".tmp";
+        const { writeFile, rename } = await import("node:fs/promises");
+        await writeFile(tmpPath, JSON.stringify(settings, null, 2), "utf-8");
+        await rename(tmpPath, settingsPath());
+        // Uninstall via npm in the agent dir (keep settings clean even if npm uninstall fails)
+        const npmDir = join(piAgentDir(), "npm");
+        try {
+            execSync(`npm uninstall ${npmName}`, {
+                cwd: npmDir,
+                stdio: "pipe",
+                timeout: 60_000,
+            });
+        }
+        catch {
+            // npm uninstall may fail if the package isn't actually installed
+            // but we already cleaned the settings — best effort
+        }
+        return { success: true };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { success: false, error: message };
+    }
+}
+export async function installExtension(packageName) {
+    try {
+        // Strip npm: prefix if present
+        const npmName = packageName.replace(/^npm:/, "");
+        // Add to settings.json packages array
+        const settingsRaw = await readFile(settingsPath(), "utf-8");
+        const settings = JSON.parse(settingsRaw);
+        if (!settings.packages)
+            settings.packages = [];
+        const pkgEntry = packageName.startsWith("npm:") ? packageName : `npm:${npmName}`;
+        if (!settings.packages.includes(pkgEntry)) {
+            settings.packages.push(pkgEntry);
+        }
+        // Write settings back atomically
+        const tmpPath = settingsPath() + ".tmp";
+        const { writeFile, rename } = await import("node:fs/promises");
+        await writeFile(tmpPath, JSON.stringify(settings, null, 2), "utf-8");
+        await rename(tmpPath, settingsPath());
+        // Install via npm in the agent dir
+        const npmDir = join(piAgentDir(), "npm");
+        execSync(`npm install ${npmName}`, {
+            cwd: npmDir,
+            stdio: "pipe",
+            timeout: 120_000,
+        });
+        return { success: true };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { success: false, error: message };
+    }
+}
+/** Built-in agent definitions (builtin defaults like pi-subagents examples) */
+export const builtinAgentDefs = [
+    {
+        name: "scout",
+        description: "Fast codebase recon — returns compressed context for handoff to other agents",
+        model: "claude-haiku-4-5",
+        tools: ["read", "grep", "find", "ls", "bash"],
+        source: "builtin",
+    },
+    {
+        name: "planner",
+        description: "Creates implementation plans with structured analysis",
+        model: "claude-sonnet-4-5",
+        tools: ["read", "grep", "find", "ls"],
+        source: "builtin",
+    },
+    {
+        name: "reviewer",
+        description: "Code review & quality assurance — checks for issues, security, and style",
+        model: "claude-sonnet-4-5",
+        tools: ["read", "grep", "find", "ls", "bash"],
+        source: "builtin",
+    },
+    {
+        name: "worker",
+        description: "General-purpose task execution with full capabilities",
+        model: "claude-sonnet-4-5",
+        tools: [],
+        source: "builtin",
+    },
+];
+//# sourceMappingURL=extension-manager.js.map

package/dist/server/extension-manager.js.map

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

package/dist/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-registry.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/dist/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,uBAAuB,CAAC;AAiBvD;;;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"}