poe-code 3.0.29 → 3.0.31

package/dist/cli/commands/mcp.js

@@ -0,0 +1,178 @@
+import { select, isCancel, cancel } from "@poe-code/design-system";
+import { loadCredentials } from "../../services/credentials.js";
+import { initializeClient } from "../../services/client-instance.js";
+import { runMcpServerWithTransport, formatMcpToolsDocs } from "../mcp-server.js";
+import { createExecutionResources, resolveCommandFlags } from "./shared.js";
+import { parseMcpOutputFormatPreferences } from "../mcp-output-format.js";
+import { throwCommandNotFound } from "../command-not-found.js";
+import { supportedAgents, configure, unconfigure, resolveAgentSupport } from "@poe-code/agent-mcp-config";
+import { getCurrentExecutionContext, toMcpServerCommand } from "../../utils/execution-context.js";
+const DEFAULT_MCP_AGENT = "claude-code";
+function createMcpServerEntry() {
+    const context = getCurrentExecutionContext(import.meta.url);
+    const mcpCommand = toMcpServerCommand(context.command, "mcp");
+    return {
+        name: "poe-code",
+        config: {
+            transport: "stdio",
+            command: mcpCommand.command,
+            args: [...mcpCommand.args, "serve"]
+        }
+    };
+}
+function buildHelpText() {
+    const server = createMcpServerEntry();
+    const lines = [
+        "",
+        "Configuration:",
+        JSON.stringify({ [server.name]: server.config }, null, 2),
+        "",
+        formatMcpToolsDocs()
+    ];
+    return lines.join("\n");
+}
+export function registerMcpCommand(program, container) {
+    const mcp = program
+        .command("mcp")
+        .description("MCP server commands")
+        .addHelpText("after", buildHelpText())
+        .action(function () {
+        if (this.args.length > 0) {
+            throwCommandNotFound({
+                container,
+                scope: "mcp",
+                unknownCommand: this.args.at(0) ?? "",
+                helpArgs: ["mcp", "--help"],
+                moduleUrl: import.meta.url
+            });
+        }
+        this.help();
+    });
+    mcp
+        .command("serve")
+        .description("Run MCP server on stdin/stdout")
+        .option("--output-format <format>", 'Preferred MCP media output format(s): "url", "base64", "markdown", or comma-separated list (default: "url"). Note: "markdown" cannot be combined with other formats.')
+        .addHelpText("after", buildHelpText())
+        .action(async (options) => {
+        await runMcpServer(container, { outputFormat: options.outputFormat });
+    });
+    mcp
+        .command("configure [agent]")
+        .description("Configure MCP client to use poe-code")
+        .option("-y, --yes", "Skip prompt, use claude-code")
+        .action(async (agentArg, options) => {
+        const flags = resolveCommandFlags(program);
+        const resources = createExecutionResources(container, flags, "mcp");
+        let agent = agentArg;
+        if (!agent) {
+            if (options.yes) {
+                agent = DEFAULT_MCP_AGENT;
+            }
+            else {
+                const selected = await select({
+                    message: "Select agent to configure:",
+                    options: supportedAgents.map((a) => ({ value: a, label: a }))
+                });
+                if (isCancel(selected)) {
+                    cancel("Operation cancelled");
+                    return;
+                }
+                agent = selected;
+            }
+        }
+        resources.logger.intro(`mcp configure ${agent}`);
+        const support = resolveAgentSupport(agent);
+        if (support.status === "unknown") {
+            resources.logger.error(`Unknown agent: ${agent}`);
+            return;
+        }
+        if (support.status === "unsupported") {
+            resources.logger.error(`MCP not supported for ${support.id}.`);
+            return;
+        }
+        const resolvedAgent = support.id ?? agent;
+        await configure(resolvedAgent, createMcpServerEntry(), {
+            fs: container.fs,
+            homeDir: container.env.homeDir,
+            platform: process.platform,
+            dryRun: flags.dryRun,
+            observers: {
+                onStart: (details) => {
+                    if (flags.dryRun) {
+                        resources.logger.dryRun(`Would ${details.label.toLowerCase()}`);
+                    }
+                },
+                onComplete: (details, outcome) => {
+                    if (!flags.dryRun && outcome.changed) {
+                        resources.logger.verbose(details.label);
+                    }
+                }
+            }
+        });
+        resources.context.complete({
+            success: `Configured MCP for ${resolvedAgent}.`,
+            dry: `Would configure MCP for ${resolvedAgent}.`
+        });
+        resources.context.finalize();
+    });
+    mcp
+        .command("unconfigure <agent>")
+        .description("Remove poe-code from MCP client")
+        .action(async (agent) => {
+        const flags = resolveCommandFlags(program);
+        const resources = createExecutionResources(container, flags, "mcp");
+        resources.logger.intro(`mcp unconfigure ${agent}`);
+        const support = resolveAgentSupport(agent);
+        if (support.status === "unknown") {
+            resources.logger.error(`Unknown agent: ${agent}`);
+            return;
+        }
+        if (support.status === "unsupported") {
+            resources.logger.error(`MCP not supported for ${support.id}.`);
+            return;
+        }
+        const resolvedAgent = support.id ?? agent;
+        await unconfigure(resolvedAgent, "poe-code", {
+            fs: container.fs,
+            homeDir: container.env.homeDir,
+            platform: process.platform,
+            dryRun: flags.dryRun,
+            observers: {
+                onStart: (details) => {
+                    if (flags.dryRun) {
+                        resources.logger.dryRun(`Would ${details.label.toLowerCase()}`);
+                    }
+                },
+                onComplete: (details, outcome) => {
+                    if (!flags.dryRun && outcome.changed) {
+                        resources.logger.verbose(details.label);
+                    }
+                }
+            }
+        });
+        resources.context.complete({
+            success: `Removed MCP configuration from ${resolvedAgent}.`,
+            dry: `Would remove MCP configuration from ${resolvedAgent}.`
+        });
+        resources.context.finalize();
+    });
+}
+async function runMcpServer(container, options) {
+    const outputFormatPreferences = parseMcpOutputFormatPreferences(options.outputFormat);
+    const apiKey = await loadCredentials({
+        fs: container.fs,
+        filePath: container.env.credentialsPath
+    });
+    if (!apiKey) {
+        process.stderr.write("No credentials found. Run 'poe-code login' first.\n");
+        process.exit(1);
+    }
+    await initializeClient({
+        fs: container.fs,
+        credentialsPath: container.env.credentialsPath,
+        baseUrl: container.env.poeApiBaseUrl,
+        httpClient: container.httpClient
+    });
+    await runMcpServerWithTransport(outputFormatPreferences);
+}
+//# sourceMappingURL=mcp.js.map

package/dist/cli/commands/mcp.js.map

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

package/dist/cli/commands/models.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+import type { CliContainer } from "../container.js";
+export declare function registerModelsCommand(program: Command, container: CliContainer): void;

package/dist/cli/commands/models.js

@@ -0,0 +1,183 @@
+import { createExecutionResources, resolveCommandFlags } from "./shared.js";
+import { loadCredentials } from "../../services/credentials.js";
+import { AuthenticationError, ApiError } from "../errors.js";
+import { getTheme, renderTable } from "@poe-code/design-system";
+function formatTokenCount(tokens) {
+    if (tokens >= 1_048_576) {
+        const value = tokens / 1_048_576;
+        return `${Number.isInteger(value) ? value : value.toFixed(1)}M`;
+    }
+    if (tokens >= 1_024) {
+        const value = tokens / 1_024;
+        return `${Number.isInteger(value) ? value : value.toFixed(1)}K`;
+    }
+    return String(tokens);
+}
+function formatPrice(perToken) {
+    const perMTok = Math.round(perToken * 1_000_000 * 100) / 100;
+    return `$${perMTok.toFixed(2)}`;
+}
+function formatOptionalPrice(value) {
+    return value != null ? formatPrice(value) : "-";
+}
+function formatDate(ms) {
+    const date = new Date(ms);
+    const year = date.getUTCFullYear();
+    const month = String(date.getUTCMonth() + 1).padStart(2, "0");
+    const day = String(date.getUTCDate()).padStart(2, "0");
+    return `${year}-${month}-${day}`;
+}
+function hasFeature(model, feature) {
+    if (feature === "reasoning")
+        return model.reasoning != null;
+    return (model.supported_features ?? []).includes(feature);
+}
+export function registerModelsCommand(program, container) {
+    program
+        .command("models")
+        .description("List available Poe API models.")
+        .option("--provider <name>", "Filter by provider name")
+        .option("--model <name>", "Filter by model id")
+        .option("--feature <name>", "Filter by feature (tools, web_search, reasoning)")
+        .option("--input <modalities>", "Filter by input modalities (e.g. text,image)")
+        .option("--output <modalities>", "Filter by output modalities (e.g. text)")
+        .option("--view <name>", "Table view: capabilities or pricing", "capabilities")
+        .action(async function () {
+        const flags = resolveCommandFlags(program);
+        const resources = createExecutionResources(container, flags, "models");
+        const commandOptions = this.opts();
+        resources.logger.intro("models");
+        try {
+            const apiKey = await loadCredentials({
+                fs: container.fs,
+                filePath: container.env.credentialsPath
+            });
+            if (!apiKey) {
+                throw new AuthenticationError("Poe API key not found. Run 'poe-code login' first.");
+            }
+            if (flags.dryRun) {
+                resources.logger.dryRun("Dry run: would fetch models from Poe API.");
+                return;
+            }
+            const response = await container.httpClient(`${container.env.poeBaseUrl}/v1/models`, {
+                method: "GET",
+                headers: {
+                    Authorization: `Bearer ${apiKey}`
+                }
+            });
+            if (!response.ok) {
+                throw new ApiError(`Failed to fetch models (HTTP ${response.status})`, {
+                    httpStatus: response.status,
+                    endpoint: "/v1/models"
+                });
+            }
+            const result = (await response.json());
+            const allModels = result.data;
+            if (allModels.length === 0) {
+                resources.logger.info("No models found.");
+                return;
+            }
+            let filtered = allModels;
+            if (commandOptions.provider) {
+                const term = commandOptions.provider.toLowerCase();
+                filtered = filtered.filter((m) => m.owned_by.toLowerCase().includes(term));
+            }
+            if (commandOptions.model) {
+                const term = commandOptions.model.toLowerCase();
+                filtered = filtered.filter((m) => m.id.toLowerCase().includes(term));
+            }
+            if (commandOptions.feature) {
+                const feature = commandOptions.feature.toLowerCase();
+                filtered = filtered.filter((m) => hasFeature(m, feature));
+            }
+            if (commandOptions.input) {
+                const required = commandOptions.input.toLowerCase().split(",");
+                filtered = filtered.filter((m) => {
+                    const modalities = m.architecture?.input_modalities ?? [];
+                    return required.every((r) => modalities.includes(r));
+                });
+            }
+            if (commandOptions.output) {
+                const required = commandOptions.output.toLowerCase().split(",");
+                filtered = filtered.filter((m) => {
+                    const modalities = m.architecture?.output_modalities ?? [];
+                    return required.every((r) => modalities.includes(r));
+                });
+            }
+            if (filtered.length === 0) {
+                resources.logger.info("No models match the given filters.");
+                return;
+            }
+            filtered.sort((a, b) => b.created - a.created);
+            const theme = getTheme();
+            let columns;
+            let rows;
+            if (commandOptions.view === "pricing") {
+                columns = [
+                    { name: "Model", title: "Model", alignment: "left", maxLen: 35 },
+                    { name: "Context", title: "Context", alignment: "right", maxLen: 9 },
+                    { name: "Input", title: "Input $/MTok", alignment: "right", maxLen: 12 },
+                    { name: "Output", title: "Output $/MTok", alignment: "right", maxLen: 13 },
+                    { name: "CacheRead", title: "Cache Read", alignment: "right", maxLen: 10 },
+                    { name: "CacheWrite", title: "Cache Write", alignment: "right", maxLen: 11 },
+                    { name: "Request", title: "Request", alignment: "right", maxLen: 9 }
+                ];
+                rows = filtered.map((model) => {
+                    const pricing = model.pricing;
+                    return {
+                        Model: theme.accent(`${model.owned_by.toLowerCase()}/${model.id}`),
+                        Context: model.context_window?.context_length != null ? formatTokenCount(model.context_window.context_length) : "-",
+                        Input: formatOptionalPrice(pricing?.prompt ?? null),
+                        Output: formatOptionalPrice(pricing?.completion ?? null),
+                        CacheRead: formatOptionalPrice(pricing?.input_cache_read ?? null),
+                        CacheWrite: formatOptionalPrice(pricing?.input_cache_write ?? null),
+                        Request: formatOptionalPrice(pricing?.request ?? null)
+                    };
+                });
+            }
+            else {
+                const allFeatures = Array.from(new Set(filtered.flatMap((m) => m.supported_features ?? []))).sort();
+                columns = [
+                    { name: "Model", title: "Model", alignment: "left", maxLen: 35 },
+                    { name: "Date", title: "Date Added", alignment: "left", maxLen: 12 },
+                    { name: "Modality", title: "Modality", alignment: "left", maxLen: 18 },
+                    { name: "Context", title: "Context", alignment: "right", maxLen: 9 },
+                    { name: "Reasoning", title: "Reasoning", alignment: "left", maxLen: 9 },
+                    ...allFeatures.map((feature) => ({
+                        name: feature,
+                        title: feature,
+                        alignment: "left",
+                        maxLen: Math.max(feature.length, 3)
+                    }))
+                ];
+                rows = filtered.map((model) => {
+                    const row = {
+                        Model: theme.accent(`${model.owned_by.toLowerCase()}/${model.id}`),
+                        Date: theme.muted(formatDate(model.created)),
+                        Modality: model.architecture
+                            ? `${model.architecture.input_modalities.join(",")}->${model.architecture.output_modalities.join(",")}`
+                            : "-",
+                        Context: model.context_window?.context_length != null ? formatTokenCount(model.context_window.context_length) : "-",
+                        Reasoning: model.reasoning ? theme.success("✓") : ""
+                    };
+                    for (const feature of allFeatures) {
+                        row[feature] = (model.supported_features ?? []).includes(feature)
+                            ? theme.success("✓")
+                            : "";
+                    }
+                    return row;
+                });
+            }
+            resources.logger.info(renderTable({ theme, columns, rows }));
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                resources.logger.logException(error, "models", {
+                    operation: "fetch-models"
+                });
+            }
+            throw error;
+        }
+    });
+}
+//# sourceMappingURL=models.js.map

package/dist/cli/commands/models.js.map

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

package/dist/cli/commands/ralph-worktree.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+import type { CliContainer } from "../container.js";
+export declare function registerRalphWorktreeCommand(ralph: Command, container: CliContainer): void;

package/dist/cli/commands/ralph-worktree.js

@@ -0,0 +1,73 @@
+import path from "node:path";
+import { execSync } from "node:child_process";
+import { log } from "@poe-code/design-system";
+import { listWorktrees, updateWorktreeStatus } from "@poe-code/worktree";
+import { spawnInteractive } from "@poe-code/agent-spawn";
+import { renderTemplate } from "@poe-code/config-mutations";
+import { ValidationError } from "../errors.js";
+export function registerRalphWorktreeCommand(ralph, container) {
+    ralph
+        .command("worktree")
+        .description("Merge a completed worktree back into the main branch.")
+        .argument("<name>", "Name of the worktree to merge")
+        .option("--agent <name>", "Agent to use for the merge")
+        .action(async function (name) {
+        const cwd = container.env.cwd;
+        const registryFile = path.join(cwd, ".poe-code-ralph", "worktrees.yaml");
+        const worktrees = await listWorktrees(cwd, registryFile, {
+            fs: {
+                readFile: (p, enc) => container.fs.readFile(p, enc),
+                writeFile: (p, data, opts) => container.fs.writeFile(p, data, opts),
+                mkdir: (p, opts) => container.fs.mkdir(p, opts)
+            },
+            exec: (command, opts) => Promise.resolve({
+                stdout: execSync(command, {
+                    cwd: opts?.cwd,
+                    encoding: "utf8",
+                    stdio: ["ignore", "pipe", "pipe"]
+                }),
+                stderr: ""
+            })
+        });
+        const entry = worktrees.find((w) => w.name === name);
+        if (!entry) {
+            throw new ValidationError(`Worktree "${name}" not found in registry.`);
+        }
+        if (entry.status !== "done" && entry.status !== "failed") {
+            throw new ValidationError(`Worktree "${name}" has status "${entry.status}" and is not mergeable. Only "done" or "failed" worktrees can be merged.`);
+        }
+        if (!entry.gitExists) {
+            throw new ValidationError(`Worktree directory does not exist for "${name}". It may have been manually removed.`);
+        }
+        const options = this.opts();
+        const { default: mergeTemplate } = await import("../../templates/ralph/PROMPT_worktree_merge.md");
+        const renderedPrompt = renderTemplate(mergeTemplate, {
+            WORKTREE_NAME: entry.name,
+            WORKTREE_PATH: entry.path,
+            WORKTREE_BRANCH: entry.branch,
+            BASE_BRANCH: entry.baseBranch,
+            MAIN_CWD: cwd,
+            PLAN_PATH: entry.planPath ?? "",
+            STORY_ID: entry.storyId ?? ""
+        });
+        const agent = options.agent?.trim() || entry.agent;
+        const result = await spawnInteractive(agent, {
+            prompt: renderedPrompt,
+            cwd
+        });
+        const fsAdapter = {
+            readFile: (p, enc) => container.fs.readFile(p, enc),
+            writeFile: (p, data, opts) => container.fs.writeFile(p, data, opts),
+            mkdir: (p, opts) => container.fs.mkdir(p, opts)
+        };
+        if (result.exitCode === 0) {
+            await updateWorktreeStatus(registryFile, entry.name, "done", { fs: fsAdapter });
+            log.success(`Worktree "${entry.name}" merged successfully.`);
+        }
+        else {
+            await updateWorktreeStatus(registryFile, entry.name, "failed", { fs: fsAdapter });
+            log.error(`Agent exited with code ${result.exitCode}. Worktree "${entry.name}" marked as failed.`);
+        }
+    });
+}
+//# sourceMappingURL=ralph-worktree.js.map

package/dist/cli/commands/ralph-worktree.js.map

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

package/dist/cli/commands/ralph.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+import type { CliContainer } from "../container.js";
+export declare function registerRalphCommand(program: Command, container: CliContainer): void;