mirror of
https://github.com/badlogic/pi-mono.git
synced 2026-11-05 23:37:25 +00:00
This adds codemode and MCP support to pi. Codemode (packages/codemode) runs model-written JavaScript in a QuickJS wasm VM inside a worker. From there the script calls pi's tools as async functions, uses a per-session store, and can read the model catalog and run classifiers. The codemode tool in coding-agent is compatible with Codex's exec tool, and codemode.mode works like Codex's tool modes (on or only). Large results are written to a JSON temp file. MCP (packages/mcp) is a standalone client for stdio and streamable HTTP servers, with OAuth. The core only gets general mechanisms; codemode, tool_search and MCP are built-in extensions that use them. Other extensions can replace these built-ins. Tools declare an exposure: direct, model-only, codemode, deferred or hidden. prepareLoadout() lets an orchestrating tool change which tool declarations the model sees. ctx.executeTool() runs nested calls through validation and the tool_call/tool_result hooks. Those calls emit events with parentToolCallId and are recorded as bounded nestedCalls on the parent result, which compaction and HTML export use. Tools can also return structuredContent with an outputSchema, and can report errors with isError instead of throwing. MCP servers come from mcp.json (global, or per project after the project is trusted) or from pi.registerMcpServer(). They are managed with /mcp and pi mcp list|login|logout, and their runtimes load on first use. Closes #10040
50 lines
1.9 KiB
TypeScript
50 lines
1.9 KiB
TypeScript
/**
|
|
* An Agent with the tools of an MCP server plus a codemode tool that calls them from JavaScript.
|
|
*
|
|
* ANTHROPIC_API_KEY=... node packages/agent/examples/mcp-codemode/main.ts \
|
|
* npx -y @modelcontextprotocol/server-filesystem .
|
|
*
|
|
* The arguments are the command that starts a stdio MCP server.
|
|
*/
|
|
|
|
import { Agent } from "@earendil-works/pi-agent-core";
|
|
import { createModels } from "@earendil-works/pi-ai";
|
|
import { anthropicProvider } from "@earendil-works/pi-ai/providers/anthropic";
|
|
import { McpClient, StdioTransport } from "@earendil-works/pi-mcp";
|
|
import { createCodemodeTool, createMcpTools, createNestedToolRunner } from "./tools.ts";
|
|
|
|
const [command, ...args] = process.argv.slice(2);
|
|
if (!command) {
|
|
console.error("Usage: main.ts <mcp server command> [args...]");
|
|
process.exit(1);
|
|
}
|
|
|
|
const models = createModels();
|
|
models.setProvider(anthropicProvider());
|
|
const model = models.getModel("anthropic", "claude-sonnet-4-6");
|
|
if (!model) throw new Error("Model not found");
|
|
|
|
const client = new McpClient({ name: "pi-agent-example", version: "1.0.0" });
|
|
await client.connect(new StdioTransport({ command, args }));
|
|
|
|
try {
|
|
const agent = new Agent({
|
|
initialState: { systemPrompt: "You are a helpful assistant.", model },
|
|
streamFn: models.streamSimple.bind(models),
|
|
});
|
|
const mcpTools = await createMcpTools(client, "mcp");
|
|
// The model can call the MCP tools directly or batch them in one codemode script.
|
|
agent.state.tools = [...mcpTools, createCodemodeTool(mcpTools, createNestedToolRunner(agent))];
|
|
|
|
agent.subscribe((event) => {
|
|
if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
|
|
process.stdout.write(event.assistantMessageEvent.delta);
|
|
} else if (event.type === "tool_execution_start") {
|
|
console.log(`\n[${event.toolName}]`);
|
|
}
|
|
});
|
|
await agent.prompt("Use codemode to list what the MCP tools can do, then summarize it in two sentences.");
|
|
console.log();
|
|
} finally {
|
|
await client.close();
|
|
}
|