@hera-al/server 1.6.2 → 1.6.4

package/dist/pi-agent-provider/integration-example.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Integration Example: Using pi-agent-provider with Hera's SessionAgent
+ *
+ * This file shows exactly how to modify session-agent.ts to use piQuery()
+ * instead of the Claude Agent SDK's query().
+ *
+ * There are TWO integration strategies:
+ *
+ * 1. MINIMAL (recommended): Replace only the query() call in ensureInitialized()
+ *    - SessionAgent.processOutput() stays exactly the same
+ *    - All queue modes, debounce, cap, etc. work unchanged
+ *    - piQuery() yields the same SDKMessage types
+ *
+ * 2. FULL: Use pi-agent-core's Agent class with its own event loop
+ *    - More idiomatic pi-mono usage
+ *    - Requires more changes to SessionAgent
+ *    - Better streaming support
+ */
+import type { PiProviderConfig } from "./pi-types.js";
+/**
+ * Example configurations for different providers.
+ */
+export declare const PROVIDER_CONFIGS: Record<string, PiProviderConfig>;
+/**
+ * Here's the exact diff you'd apply to session-agent.ts:
+ *
+ * ```diff
+ * --- a/src/agent/session-agent.ts
+ * +++ b/src/agent/session-agent.ts
+ * @@ -36,1 +36,3 @@
+ * -import { query } from "@anthropic-ai/claude-agent-sdk";
+ * +// import { query } from "@anthropic-ai/claude-agent-sdk";
+ * +import { piQuery, createToolRegistryFromOptions } from "@hera-al/pi-agent-provider";
+ * +import type { PiProviderConfig, PiQueryHandle } from "@hera-al/pi-agent-provider";
+ *
+ * @@ -44,1 +46,1 @@
+ * -type QueryHandle = ReturnType<typeof query>;
+ * +type QueryHandle = PiQueryHandle;
+ *
+ * @@ -148,6 +150,8 @@
+ *  export class SessionAgent {
+ *    private queue: MessageQueue;
+ *    private queryHandle: QueryHandle | null = null;
+ * +  // Pi Agent provider configuration
+ * +  private piProviderConfig: PiProviderConfig;
+ *
+ * @@ -215,6 +219,8 @@
+ *    constructor(
+ *      private sessionKey: string,
+ *      private config: AppConfig,
+ * +    // NEW: Pi Agent provider config
+ * +    piProviderConfig: PiProviderConfig,
+ *      systemPrompt: string,
+ *      ...
+ *    ) {
+ * +    this.piProviderConfig = piProviderConfig;
+ *
+ * @@ -1143,7 +1149,10 @@
+ *    private ensureInitialized(): void {
+ *      if (this.initialized) return;
+ *      this.initialized = true;
+ * -    this.queryHandle = query({
+ * -      prompt: this.queue as any,
+ * -      options: this.opts,
+ * -    });
+ * +    // Create tool registry and start piQuery
+ * +    createToolRegistryFromOptions(this.opts).then((toolRegistry) => {
+ * +      this.queryHandle = piQuery(
+ * +        { prompt: this.queue, options: this.opts },
+ * +        this.piProviderConfig,
+ * +        toolRegistry,
+ * +      );
+ * +      this.processOutput();
+ * +    });
+ * -    this.processOutput();
+ * +    // Note: processOutput is called after async tool registry setup
+ *    }
+ * ```
+ *
+ * That's it. ~20 lines changed. processOutput() is 100% unchanged because
+ * piQuery() yields the exact same message types.
+ */
+//# sourceMappingURL=integration-example.d.ts.map

package/dist/pi-agent-provider/integration-example.js

@@ -0,0 +1 @@
+import{piQuery as e}from"./pi-query.js";import{createToolRegistryFromOptions as r}from"./pi-mcp-bridge.js";export const PROVIDER_CONFIGS={"openai-gpt4o":{provider:"openai",modelId:"gpt-4o",temperature:.7},"openai-gpt4o-mini":{provider:"openai",modelId:"gpt-4o-mini",temperature:.7},"anthropic-sonnet":{provider:"anthropic",modelId:"claude-sonnet-4-20250514",temperature:.7},"google-gemini":{provider:"google",modelId:"gemini-2.5-pro",temperature:.7},"openrouter-llama":{provider:"openrouter",modelId:"meta-llama/llama-3.1-405b-instruct",temperature:.7},"xai-grok":{provider:"xai",modelId:"grok-3",temperature:.7},"groq-llama":{provider:"groq",modelId:"llama-3.1-70b-versatile",temperature:.7}};

package/dist/pi-agent-provider/pi-context-compactor.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Pi Agent Context Compaction System
+ *
+ * Three-phase cascading compaction to manage the context window:
+ *
+ * Phase 1 — Observation Masking (deterministic, no LLM call)
+ *   Truncates large tool results keeping a header + first N chars.
+ *
+ * Phase 2 — Reference Compaction (deterministic, no LLM call)
+ *   Replaces tool results with minimal one-line references.
+ *
+ * Phase 3 — Structured Summarization (requires LLM call)
+ *   Replaces old messages with a structured summary.
+ *
+ * Key design: compaction happens at the START of each processUserMessage(),
+ * BEFORE the new user message is pushed. At that point, every message in the
+ * array is from previous user-request cycles — the model has already read and
+ * acted on those tool results. Within a single cycle (U→tools→R), all tool
+ * outputs remain full so the model can reason on them without loss.
+ */
+import type { PiMessage } from "./pi-message-adapter.js";
+export interface CompactionConfig {
+    /** Estimated max tokens for the model's context window (default: 128000) */
+    contextWindowTokens: number;
+    /** Phase 1: char threshold per tool result to trigger masking (default: 3000) */
+    maskCharThreshold: number;
+    /** Phase 1: chars to preserve at the head of masked content (default: 500) */
+    maskHeadChars: number;
+    /** Phase 2: token ratio threshold to trigger reference compaction (default: 0.60) */
+    referenceThresholdRatio: number;
+    /** Phase 3: token ratio threshold to trigger summarization (default: 0.90) */
+    summarizationThresholdRatio: number;
+    /** Number of recent messages to keep raw during Phase 3 summarization (default: 6) */
+    keepLastNMessages: number;
+    /** Tool names whose results should never be masked or compacted (substring match) */
+    preserveToolNames: string[];
+    /** Optional alternative model for Phase 3 summarization (format: "provider/modelId") */
+    summarizationModel?: string;
+}
+export interface CompactionResult {
+    phase: 0 | 1 | 2 | 3;
+    estimatedTokensBefore: number;
+    estimatedTokensAfter: number;
+    maskedResults: number;
+    compactedResults: number;
+    summarized: boolean;
+    /** If Phase 3 activated, contains the prompt for the summarization LLM call */
+    summarizationPrompt?: string;
+}
+export declare const DEFAULT_COMPACTION_CONFIG: CompactionConfig;
+/** Estimate total tokens for the session (chars/4 heuristic) */
+export declare function estimateSessionTokens(messages: PiMessage[], systemPrompt: string): number;
+/**
+ * Phase 1: Mask old tool results that exceed the char threshold.
+ * Preserves a header + first N chars of content.
+ * Modifies messages in-place.
+ *
+ * @param startIndex - Start scanning from this index (skip already-compacted segments)
+ * @param boundary - Stop scanning at this index (exclusive)
+ * @returns Number of results masked
+ */
+export declare function maskOldObservations(messages: PiMessage[], startIndex: number, boundary: number, opts: {
+    charThreshold: number;
+    headChars: number;
+    preserveToolNames: string[];
+}): number;
+/**
+ * Phase 2: Replace tool results with minimal one-line references.
+ * More aggressive than Phase 1. Modifies messages in-place.
+ *
+ * @param boundary - Only process messages at indices [0, boundary)
+ * @returns Number of results compacted
+ */
+export declare function compactToReferences(messages: PiMessage[], boundary: number, opts: {
+    preserveToolNames: string[];
+}): number;
+/**
+ * Build a rolling summarization prompt.
+ *
+ * Unlike a one-shot summarizer that truncates messages, this takes:
+ * - The existing rolling context (from previous summarization cycles)
+ * - A batch of messages IN FULL (no truncation)
+ *
+ * By the time Phase 3 runs, tool results have already been compacted by
+ * Phase 1+2, so the messages are mostly assistant reasoning + user text +
+ * one-liner tool references. Sending them in full preserves all information.
+ *
+ * @param rollingContext - Existing summary from previous cycles ("" if first time)
+ * @param messages - Full message array
+ * @param keepLastN - Number of recent messages to exclude from summarization
+ * @returns The summarization prompt, or empty string if nothing to summarize
+ */
+export declare function buildSummarizationPrompt(rollingContext: string, messages: PiMessage[], keepLastN: number): string;
+/**
+ * Apply the summarization result: replace old messages with a single
+ * user message containing the summary, keeping the last N messages raw.
+ */
+export declare function applySummarization(messages: PiMessage[], summary: string, keepLastN: number): void;
+/**
+ * Apply context compaction in cascading phases.
+ *
+ * Called at the start of processUserMessage(), BEFORE pushing the new user
+ * message. At that point every message in the array is from previous
+ * user-request cycles — the model has already read and acted on those tool
+ * results, so they are safe to compact.
+ *
+ * Within a single user-request cycle (U -> tool calls -> R), all tool
+ * outputs remain at full fidelity so the model can reason correctly.
+ *
+ * @param lastCompactedIndex - Index up to which Phase 1 was already applied
+ *   in a previous call. Phase 1 only scans [lastCompactedIndex, messages.length).
+ *   Phase 2 and 3 scan the full range but naturally skip already-compact results.
+ * @param rollingContext - Existing rolling summary from previous Phase 3 cycles.
+ */
+export declare function compactContext(messages: PiMessage[], systemPrompt: string, config: CompactionConfig, lastCompactedIndex?: number, rollingContext?: string): CompactionResult;
+//# sourceMappingURL=pi-context-compactor.d.ts.map

package/dist/pi-agent-provider/pi-context-compactor.js

@@ -0,0 +1 @@
+export const DEFAULT_COMPACTION_CONFIG={contextWindowTokens:128e3,maskCharThreshold:3e3,maskHeadChars:500,referenceThresholdRatio:.6,summarizationThresholdRatio:.9,keepLastNMessages:6,preserveToolNames:["memory_search","search_memories"]};export function estimateSessionTokens(e,t){let n=t.length;for(const t of e)if("user"===t.role)if("string"==typeof t.content)n+=t.content.length;else for(const e of t.content)"text"===e.type&&(n+=e.text.length),"image"===e.type&&(n+=4e3);else if("assistant"===t.role)for(const e of t.content)"text"===e.type&&(n+=e.text.length),"thinking"===e.type&&(n+=e.thinking.length),"toolCall"===e.type&&(n+=JSON.stringify(e.arguments).length+e.name.length);else if("toolResult"===t.role)for(const e of t.content)"text"===e.type&&(n+=e.text.length),"image"===e.type&&(n+=4e3);return Math.ceil(n/4)}function e(e,t){return t.some(t=>e===t||e.includes(t))}function t(e){return e.content.filter(e=>"text"===e.type).map(e=>e.text).join("\n")}function n(e){return t(e).length}function o(e,t,n){for(let o=n-1;o>=0;o--){const n=e[o];if("assistant"===n.role)for(const e of n.content)if("toolCall"===e.type&&e.id===t)return{name:e.name,args:e.arguments}}return null}function s(e,t,n){if(!t)return`[${e}: ${n} chars]`;switch(e){case"Read":{const e=t.file_path||t.path||"unknown",n=t.offset??1,o=t.limit;return`[Read: ${e}${o?`, lines ${n}-${Number(n)+Number(o)}`:""}]`}case"Grep":return`[Grep: "${t.pattern||"?"}" in ${t.path||"."}]`;case"Glob":return`[Glob: "${t.pattern||"?"}"]`;case"Bash":{const e=t.command||"?";return`[Bash: ${e.length>80?e.slice(0,77)+"...":e}]`}default:{const o=Object.values(t).find(e=>"string"==typeof e),s=o?o.slice(0,60):"";return`[${e}${s?": "+s:""}, ${n} chars]`}}}export function maskOldObservations(r,a,i,l){let c=0;for(let u=a;u<i&&u<r.length;u++){const a=r[u];if("toolResult"!==a.role)continue;if(e(a.toolName,l.preserveToolNames))continue;const i=n(a);if(i<=l.charThreshold)continue;const m=o(r,a.toolCallId,u),h=`${s(a.toolName,m?.args,i)}\n${t(a).slice(0,l.headChars)}\n... [truncated — ${i} chars total. Re-run tool to see full content]`;a.content=[{type:"text",text:h}],c++}return c}function r(e,t,n,o){if(n){return`[${e}] Error: ${o.slice(0,100)}`}if(!t)return`[${e}] Completed. Re-run to see results.`;switch(e){case"Read":return`[Read: ${t.file_path||t.path||"unknown"}] Content available via Read tool`;case"Grep":return`[Grep: "${t.pattern||"?"}" in ${t.path||"."}] ~${(o.match(/\n/g)||[]).length} matches. Re-run to see results`;case"Glob":return`[Glob: "${t.pattern||"?"}"] ~${(o.match(/\n/g)||[]).length} files matched. Re-run to see results`;case"Bash":{const e=t.command||"?",n=e.length>80?e.slice(0,77)+"...":e,s=o.match(/exit code[:\s]*(\d+)/i);return`[Bash: ${n}] Exit code: ${s?s[1]:"0"}`}case"Write":case"Edit":return`[${e}: ${t.file_path||t.path||"unknown"}] Success`;default:{const n=Object.values(t).find(e=>"string"==typeof e),o=n?n.slice(0,60):"";return`[${e}${o?": "+o:""}] Completed. Re-run to see results`}}}export function compactToReferences(s,a,i){let l=0;for(let c=0;c<a&&c<s.length;c++){const a=s[c];if("toolResult"!==a.role)continue;if(e(a.toolName,i.preserveToolNames))continue;if(n(a)<200)continue;const u=o(s,a.toolCallId,c),m=t(a),h=r(a.toolName,u?.args,a.isError,m);a.content=[{type:"text",text:h}],l++}return l}export function buildSummarizationPrompt(e,n,o){const s=Math.max(0,n.length-o),r=n.slice(0,s);if(0===r.length)return"";const a=[];for(const e of r)if("user"===e.role){const t="string"==typeof e.content?e.content:e.content.filter(e=>"text"===e.type).map(e=>e.text).join("\n");a.push(`USER: ${t}`)}else if("assistant"===e.role){const t=e.content.filter(e=>"text"===e.type).map(e=>e.text),n=e.content.filter(e=>"toolCall"===e.type).map(e=>`${e.name}(${JSON.stringify(e.arguments).slice(0,200)})`);t.length&&a.push(`ASSISTANT: ${t.join("\n")}`),n.length&&a.push(`TOOLS CALLED: ${n.join(", ")}`)}else if("toolResult"===e.role){const n=t(e);a.push(`TOOL RESULT [${e.toolName}]: ${n}`)}return`${e?`<existing_summary>\n${e}\n</existing_summary>\n\n`:""}Integrate the following conversation into ${e?"an updated":"a"} structured summary. Preserve all important details needed to continue the conversation. Be concise but do not lose critical information.\n\n<conversation>\n${a.join("\n")}\n</conversation>\n\nProvide the summary in this exact format:\n\n## Conversation Summary\n\n### Task & Intent\n[What the user is trying to accomplish]\n\n### Files Modified\n[List of files created, modified, or read with their current state]\n\n### Key Decisions & Errors\n[Important decisions made, errors encountered, approaches tried and discarded]\n\n### Current State\n[Where we are in the task, what remains to be done]`}export function applySummarization(e,t,n){const o=Math.max(0,e.length-n);if(o<=0)return;const s=e.slice(o),r={role:"user",content:`[Context Summary]\n\n${t}`,timestamp:Date.now()};e.length=0,e.push(r,...s)}export function compactContext(e,t,n,o=0,s=""){const r=e.length,a={phase:0,estimatedTokensBefore:estimateSessionTokens(e,t),estimatedTokensAfter:0,maskedResults:0,compactedResults:0,summarized:!1};if(0===r)return a.estimatedTokensAfter=a.estimatedTokensBefore,a;const i=maskOldObservations(e,o,r,{charThreshold:n.maskCharThreshold,headChars:n.maskHeadChars,preserveToolNames:n.preserveToolNames});i>0&&(a.phase=1,a.maskedResults=i);let l=estimateSessionTokens(e,t);if(l>n.contextWindowTokens*n.referenceThresholdRatio){const t=compactToReferences(e,r,{preserveToolNames:n.preserveToolNames});t>0&&(a.phase=2,a.compactedResults=t)}l=estimateSessionTokens(e,t);if(l>n.contextWindowTokens*n.summarizationThresholdRatio){const t=buildSummarizationPrompt(s,e,n.keepLastNMessages);t&&(a.phase=3,a.summarized=!0,a.summarizationPrompt=t)}return a.estimatedTokensAfter=estimateSessionTokens(e,t),a}

package/dist/pi-agent-provider/pi-mcp-bridge.d.ts

@@ -0,0 +1,38 @@
+/**
+ * MCP Bridge — connects Hera's MCP tool servers to the Pi Agent tool registry.
+ *
+ * The Claude Agent SDK natively understands MCP servers and routes tool calls
+ * to them. The Pi Agent provider doesn't have this built-in, so this bridge
+ * extracts tool definitions from MCP servers and creates tool executors that
+ * route calls back through the MCP transport.
+ *
+ * This module handles:
+ * 1. Extracting tool schemas from MCP SDK server instances
+ * 2. Routing tool execution through the MCP transport
+ * 3. Converting between MCP result format and pi-ai tool result format
+ */
+import { ToolRegistry, type PiTool, type PiToolResult } from "./pi-tool-adapter.js";
+import type { PiQueryOptions } from "./pi-types.js";
+/**
+ * Extract tool definitions from an MCP SDK server instance.
+ *
+ * MCP SDK servers created with createSdkMcpServer() have an internal
+ * structure we can introspect to get tool names, descriptions, and schemas.
+ * The exact method depends on the SDK version — we try multiple approaches.
+ */
+export declare function extractToolsFromMcpServer(serverName: string, serverInstance: unknown): Promise<PiTool[]>;
+/**
+ * Execute a tool call through an MCP server.
+ *
+ * Routes the call to the correct server based on the tool name prefix
+ * (mcp__<serverName>__<toolName>).
+ */
+export declare function executeMcpTool(fullToolName: string, toolCallId: string, args: Record<string, unknown>, mcpServers: Record<string, unknown>): Promise<PiToolResult>;
+/**
+ * Create a fully configured ToolRegistry from Hera's query options.
+ *
+ * This extracts tools from all MCP servers, adds built-in tools,
+ * and sets up executors that route calls to the right place.
+ */
+export declare function createToolRegistryFromOptions(options: PiQueryOptions): Promise<ToolRegistry>;
+//# sourceMappingURL=pi-mcp-bridge.d.ts.map

package/dist/pi-agent-provider/pi-mcp-bridge.js

@@ -0,0 +1 @@
+import{ToolRegistry as t,BUILTIN_TOOL_DEFINITIONS as e}from"./pi-tool-adapter.js";import{executeBuiltinTool as o}from"./pi-tool-executor.js";export async function extractToolsFromMcpServer(t,e){const o=[];if(!e||"object"!=typeof e)return o;const r=e;if("function"==typeof r.getTools)try{const e=await r.getTools();for(const r of e)o.push({name:`mcp__${t}__${r.name}`,description:r.description||"",parameters:r.inputSchema||r.parameters||{type:"object",properties:{}}});return o}catch{}if(r.tools&&Array.isArray(r.tools)){for(const e of r.tools)o.push({name:`mcp__${t}__${e.name}`,description:e.description||"",parameters:e.inputSchema||e.parameters||{type:"object",properties:{}}});return o}if(r._tools&&"object"==typeof r._tools){const e=r._tools,n=e instanceof Map?Array.from(e.entries()):Object.entries(e);for(const[e,r]of n)o.push({name:`mcp__${t}__${e}`,description:r.description||"",parameters:r.inputSchema||r.parameters||{type:"object",properties:{}}});return o}if("function"==typeof r.handleRequest)try{const e=await r.handleRequest({method:"tools/list",params:{}});if(e?.tools&&Array.isArray(e.tools)){for(const r of e.tools)o.push({name:`mcp__${t}__${r.name}`,description:r.description||"",parameters:r.inputSchema||{type:"object",properties:{}}});return o}}catch{}if(r.instance&&"object"==typeof r.instance)return extractToolsFromMcpServer(t,r.instance);if(r.server&&"object"==typeof r.server){const e=r.server._requestHandlers;if(e instanceof Map&&e.has("tools/list"))try{const r=e.get("tools/list"),n=await r({method:"tools/list",params:{}});if(n?.tools&&Array.isArray(n.tools)){for(const e of n.tools)o.push({name:`mcp__${t}__${e.name}`,description:e.description||"",parameters:e.inputSchema||{type:"object",properties:{}}});return o}}catch{}}return o}export async function executeMcpTool(t,e,o,n){const s=t.split("__");if(s.length<3||"mcp"!==s[0])return{content:[{type:"text",text:`Invalid MCP tool name: ${t}`}],isError:!0};const c=s[1],i=s.slice(2).join("__"),a=n[c];if(!a)return{content:[{type:"text",text:`MCP server not found: ${c}`}],isError:!0};const p=a;if("function"==typeof p.handleRequest)try{return r(await p.handleRequest({method:"tools/call",params:{name:i,arguments:o}}))}catch(t){return{content:[{type:"text",text:`MCP tool execution error: ${t}`}],isError:!0}}if("function"==typeof p.executeTool)try{return r(await p.executeTool(i,o))}catch(t){return{content:[{type:"text",text:`MCP tool execution error: ${t}`}],isError:!0}}if(p.instance)return executeMcpTool(t,e,o,{[c]:p.instance});if(p.server&&"object"==typeof p.server){const t=p.server._requestHandlers;if(t instanceof Map&&t.has("tools/call"))try{const e=t.get("tools/call");return r(await e({method:"tools/call",params:{name:i,arguments:o}}))}catch(t){return{content:[{type:"text",text:`MCP tool execution error: ${t}`}],isError:!0}}}return{content:[{type:"text",text:`Cannot execute tool on MCP server ${c}: no known execution method`}],isError:!0}}function r(t){if(!t)return{content:[{type:"text",text:"(no response)"}],isError:!1};const e=!0===t.isError;if(t.content&&Array.isArray(t.content)){return{content:t.content.map(t=>"text"===t.type?{type:"text",text:t.text||""}:"image"===t.type?{type:"image",data:t.data||"",mimeType:t.mimeType||"image/png"}:{type:"text",text:JSON.stringify(t)}),isError:e}}return"string"==typeof t?{content:[{type:"text",text:t}],isError:e}:{content:[{type:"text",text:JSON.stringify(t,null,2)}],isError:e}}export async function createToolRegistryFromOptions(r){const n=new t;n.registerTools(e);const s=r.mcpServers??{};for(const[t,e]of Object.entries(s))try{const o=await extractToolsFromMcpServer(t,e);o.length>0?(n.registerTools(o),console.log(`[PiAgent] Registered ${o.length} tools from MCP server "${t}": ${o.map(t=>t.name).join(", ")}`)):console.warn(`[PiAgent] MCP server "${t}" exposed 0 tools (extraction found nothing)`)}catch(e){console.error(`[PiAgent] Failed to extract tools from MCP server ${t}: ${e}`)}return r.canUseTool&&n.setPermissionChecker(r.canUseTool),n.setExecutor(async(t,e,n)=>{if(t.startsWith("mcp__"))return executeMcpTool(t,e,n,s);const c=await o(t,n,r.cwd);return c||{content:[{type:"text",text:`Unknown tool: ${t}`}],isError:!0}}),n}

package/dist/pi-agent-provider/pi-message-adapter.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Message format adapters between Hera's SDK-style messages and pi-ai's message types.
+ *
+ * Hera's SessionAgent uses Anthropic SDK message format (SDKUserMessage, SDKAssistantMessage).
+ * Pi-ai uses its own UserMessage/AssistantMessage/ToolResultMessage format.
+ * This module bridges the two.
+ */
+import type { SDKUserMessage, SDKAssistantMessage } from "./pi-types.js";
+export interface PiTextContent {
+    type: "text";
+    text: string;
+    textSignature?: string;
+}
+export interface PiImageContent {
+    type: "image";
+    data: string;
+    mimeType: string;
+}
+export interface PiThinkingContent {
+    type: "thinking";
+    thinking: string;
+    thinkingSignature?: string;
+}
+export interface PiToolCall {
+    type: "toolCall";
+    id: string;
+    name: string;
+    arguments: Record<string, any>;
+    thoughtSignature?: string;
+}
+export interface PiUsage {
+    input: number;
+    output: number;
+    cacheRead: number;
+    cacheWrite: number;
+    totalTokens: number;
+    cost: {
+        input: number;
+        output: number;
+        cacheRead: number;
+        cacheWrite: number;
+        total: number;
+    };
+}
+export interface PiUserMessage {
+    role: "user";
+    content: string | (PiTextContent | PiImageContent)[];
+    timestamp: number;
+}
+export interface PiAssistantMessage {
+    role: "assistant";
+    content: (PiTextContent | PiThinkingContent | PiToolCall)[];
+    api: string;
+    provider: string;
+    model: string;
+    usage: PiUsage;
+    stopReason: "stop" | "length" | "toolUse" | "error" | "aborted";
+    errorMessage?: string;
+    timestamp: number;
+}
+export interface PiToolResultMessage {
+    role: "toolResult";
+    toolCallId: string;
+    toolName: string;
+    content: (PiTextContent | PiImageContent)[];
+    details?: any;
+    isError: boolean;
+    timestamp: number;
+}
+export type PiMessage = PiUserMessage | PiAssistantMessage | PiToolResultMessage;
+/**
+ * Convert an SDK-format user message (from Hera's MessageQueue) to a pi-ai UserMessage.
+ */
+export declare function sdkUserToPiUser(sdkMsg: SDKUserMessage): PiUserMessage;
+/**
+ * Convert a pi-ai AssistantMessage to the SDK format that SessionAgent.processOutput() expects.
+ */
+export declare function piAssistantToSdk(piMsg: PiAssistantMessage): SDKAssistantMessage;
+/**
+ * Convert pi-ai Usage to the SDK's modelUsage format for result messages.
+ */
+export declare function piUsageToModelUsage(modelId: string, usage: PiUsage): Record<string, {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadInputTokens: number;
+    cacheCreationInputTokens: number;
+    costUSD: number;
+}>;
+/**
+ * Extract plain text from an SDK assistant message's content blocks.
+ */
+export declare function extractTextFromSdkAssistant(msg: SDKAssistantMessage): string;
+//# sourceMappingURL=pi-message-adapter.d.ts.map

package/dist/pi-agent-provider/pi-message-adapter.js

@@ -0,0 +1 @@
+export function sdkUserToPiUser(t){const e=t.message.content;if("string"==typeof e)return{role:"user",content:e,timestamp:Date.now()};const n=[];for(const t of e)"text"===t.type?n.push({type:"text",text:t.text}):"image"===t.type&&n.push({type:"image",data:t.source.data,mimeType:t.source.media_type});return{role:"user",content:n.length>0?n:"",timestamp:Date.now()}}export function piAssistantToSdk(e){const n=[];for(const t of e.content)"text"===t.type?n.push({type:"text",text:t.text}):"toolCall"===t.type&&n.push({type:"tool_use",id:t.id,name:t.name,input:t.arguments});return{type:"assistant",message:{content:n,model:e.model,role:"assistant",stop_reason:t(e.stopReason),usage:{input_tokens:e.usage.input,output_tokens:e.usage.output,cache_read_input_tokens:e.usage.cacheRead,cache_creation_input_tokens:e.usage.cacheWrite}}}}function t(t){switch(t){case"stop":return"end_turn";case"length":return"max_tokens";case"toolUse":return"tool_use";case"error":return"error";case"aborted":return"aborted";default:return t}}export function piUsageToModelUsage(t,e){return{[t]:{inputTokens:e.input,outputTokens:e.output,cacheReadInputTokens:e.cacheRead,cacheCreationInputTokens:e.cacheWrite,costUSD:e.cost.total}}}export function extractTextFromSdkAssistant(t){return t.message.content.filter(t=>"text"===t.type).map(t=>t.text).join("")}

package/dist/pi-agent-provider/pi-query.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Pi Agent query() — Drop-in replacement for the Claude Agent SDK's query().
+ *
+ * This function replicates the exact interface of the Claude Agent SDK's query()
+ * function, but uses @mariozechner/pi-ai (stream/complete) under the hood.
+ *
+ * The key contract:
+ * - Accepts an AsyncIterable<UserMessage> as `prompt` (the MessageQueue)
+ * - Returns an AsyncIterable<SDKMessage> (the output stream)
+ * - The output stream yields: system(init), assistant, tool_progress, result messages
+ * - Has .interrupt(), .setModel(), .close(), .supportedModels() methods
+ *
+ * Architecture:
+ * - For each user message from the prompt iterable, runs a pi-ai agent loop
+ * - The agent loop handles tool calling internally
+ * - Results are mapped to SDK message format and yielded
+ * - Session state (conversation history) is maintained in-memory
+ */
+import type { SDKMessage, SDKUserMessage, PiQueryOptions, PiProviderConfig } from "./pi-types.js";
+import { ToolRegistry } from "./pi-tool-adapter.js";
+export interface PiQueryHandle extends AsyncIterable<SDKMessage> {
+    /** Interrupt the current processing. */
+    interrupt(): Promise<void>;
+    /** Change the model mid-session. */
+    setModel(model: string): Promise<void>;
+    /** Close the query handle. */
+    close(): void;
+    /** List supported models. */
+    supportedModels(): Promise<Array<{
+        id: string;
+        name: string;
+    }>>;
+}
+export interface PiQueryInput {
+    prompt: AsyncIterable<SDKUserMessage>;
+    options: PiQueryOptions;
+}
+/**
+ * Create a Pi Agent query handle.
+ *
+ * This is the drop-in replacement for the Claude Agent SDK's `query()`.
+ * It consumes user messages from the prompt iterable, runs them through
+ * pi-ai's LLM API with tool execution, and yields SDK-compatible messages.
+ *
+ * IMPORTANT: Always pass a pre-built ToolRegistry (via createToolRegistryFromOptions)
+ * to ensure MCP tools are available. Without it, only built-in tools work.
+ */
+export declare function piQuery(input: PiQueryInput, providerConfig: PiProviderConfig, toolRegistry?: ToolRegistry): PiQueryHandle;
+//# sourceMappingURL=pi-query.d.ts.map

package/dist/pi-agent-provider/pi-query.js

@@ -0,0 +1 @@
+import{sdkUserToPiUser as e,piAssistantToSdk as t,extractTextFromSdkAssistant as o}from"./pi-message-adapter.js";import{ToolRegistry as s,BUILTIN_TOOL_DEFINITIONS as n}from"./pi-tool-adapter.js";import{executeBuiltinTool as r}from"./pi-tool-executor.js";import{createToolRegistryFromOptions as a}from"./pi-mcp-bridge.js";import{buildSkillsAndCommandsBlock as i}from"./pi-skill-loader.js";import{compactContext as c,applySummarization as l,DEFAULT_COMPACTION_CONFIG as d}from"./pi-context-compactor.js";import{randomUUID as u}from"node:crypto";let m=null;async function p(){if(!m)try{const e=await import("@mariozechner/pi-ai");m={stream:e.stream,complete:e.complete,getModel:e.getModel,getModels:e.getModels,getProviders:e.getProviders}}catch(e){throw new Error(`Failed to load @mariozechner/pi-ai. Install it with: npm install @mariozechner/pi-ai\n${e}`)}return m}const g=new Map;const h=setInterval(function(){const e=Date.now();for(const[t,o]of g)e-o.lastAccessTime>864e5&&g.delete(t)},6e5);"function"==typeof h.unref&&h.unref();export function piQuery(m,h,k){const{prompt:T,options:b}=m;let _=new AbortController,v=!1,P=!1,$=h.modelId,C=h.provider;const M=b.resume||u();let R=g.get(M);if(!R){let e="";if("string"==typeof b.systemPrompt)e=b.systemPrompt;else if(b.systemPrompt&&"object"==typeof b.systemPrompt){const t=b.systemPrompt.preset,o=b.systemPrompt.append||"";e="claude_code"===t?"You are an AI coding assistant. You have access to tools for reading, writing, and editing files, running shell commands, searching code, and more. Use these tools to help the user with their coding tasks.\n\nKey behaviors:\n- Read files before editing them\n- Use Grep and Glob to explore the codebase\n- Run tests after making changes\n- Be thorough but concise in explanations\n- When writing code, follow existing patterns and conventions in the codebase\n\n"+o:o}R={id:M,messages:[],systemPrompt:e,totalCostUsd:0,totalInputTokens:0,totalOutputTokens:0,totalTurns:0,startTime:Date.now(),lastAccessTime:Date.now(),lastCompactedIndex:0,compactionCount:0,rollingContext:""},g.set(M,R)}R.lastAccessTime=Date.now();const I=k??new s;if(k||(I.registerTools(n),b.mcpServers&&Object.keys(b.mcpServers).length>0&&a(b).then(e=>{for(const t of e.getTools())t.name.startsWith("mcp__")&&I.registerTool(t)}).catch(e=>{console.error(`[PiAgent] Failed to bridge MCP tools: ${e}`)})),b.canUseTool&&I.setPermissionChecker(b.canUseTool),!k){const e=b.mcpServers??{};I.setExecutor(async(t,o,s)=>{if(t.startsWith("mcp__")){const{executeMcpTool:n}=await import("./pi-mcp-bridge.js");return n(t,o,s,e)}const n=await r(t,s,b.cwd,M);return n||{content:[{type:"text",text:`Unknown tool: ${t}`}],isError:!0}})}async function*W(s){if(P)return;let n=R.systemPrompt;const r=i(b.cwd||"");if(r&&(n+="\n\n"+r),R.messages.length>0){const e=c(R.messages,n,{...d,contextWindowTokens:h.contextWindowTokens??128e3},R.lastCompactedIndex,R.rollingContext);if(e.phase>0&&(R.compactionCount++,console.log(`[pi-query] Context compacted (cycle #${R.compactionCount}): phase=${e.phase}, tokens ${e.estimatedTokensBefore}->${e.estimatedTokensAfter}, masked=${e.maskedResults}, compacted=${e.compactedResults}`)),e.summarized&&e.summarizationPrompt)try{const t=await p();if(t){const o={...d,contextWindowTokens:h.contextWindowTokens??128e3};let s=C,n=$;if(o.summarizationModel){const e=o.summarizationModel.split("/",2);2===e.length?(s=e[0],n=e[1]):n=e[0]}const r=t.getModel(s,n),a=t.stream(r,{systemPrompt:"You are a conversation summarizer. Be concise and structured.",messages:[{role:"user",content:e.summarizationPrompt,timestamp:Date.now()}]},{...h.apiKey?{apiKey:h.apiKey}:{},...h.headers?{headers:h.headers}:{},temperature:.3,maxTokens:1024});for await(const e of a);const i=await a.result(),c=i.content?.filter(e=>"text"===e.type).map(e=>e.text).join("\n");c&&(R.rollingContext=c,l(R.messages,c,d.keepLastNMessages),console.log(`[pi-query] Phase 3 rolling summary applied, messages reduced to ${R.messages.length}`))}}catch(e){console.warn(`[pi-query] Phase 3 summarization failed (non-fatal): ${e}`)}R.lastCompactedIndex=R.messages.length}const a=e(s);R.messages.push(a),R.lastAccessTime=Date.now();const u=b.maxTurns??25;let m=0,g="",k="end_turn",T={input:0,output:0,cacheRead:0,cacheWrite:0,totalTokens:0,cost:{input:0,output:0,cacheRead:0,cacheWrite:0,total:0}};const M=Date.now();for(;m<u&&!P&&!v;){m++;const e=I.getFilteredTools(b.allowedTools,b.disallowedTools);let s,r;try{s=await p()}catch(e){return void(yield y(R,"error_during_execution",g,k,$,M,T,[`${e}`]))}try{r=s.getModel(C,$)}catch(e){return void(yield y(R,"error_during_execution",g,k,$,M,T,[`Model not found: ${C}/${$}. ${e}`]))}const a={systemPrompt:n,messages:R.messages.map(x),tools:e.length>0?e:void 0},i={signal:_.signal};let c;h.apiKey&&(i.apiKey=h.apiKey),void 0!==h.temperature&&(i.temperature=h.temperature),void 0!==h.maxTokens&&(i.maxTokens=h.maxTokens),h.headers&&(i.headers=h.headers),h.reasoning&&"off"!==h.reasoning&&(i.reasoning=h.reasoning);try{const e=s.stream(r,a,i);for await(const t of e)if(P||v||_.signal.aborted)break;if("function"!=typeof e.result)throw new Error("Stream did not return a .result() method — ensure @mariozechner/pi-ai is correctly installed");c=await e.result()}catch(e){return v||_.signal.aborted?(v=!1,void(yield y(R,"error_during_execution",g,k,$,M,T,["aborted"]))):void(yield y(R,"error_during_execution",g,k,$,M,T,[`${e}`]))}w(T,c.usage),k=f(c.stopReason);const l=t(c);yield l,R.messages.push(c);const d=o(l);if(d&&(g=d),"toolUse"!==c.stopReason)break;const u=c.content.filter(e=>"toolCall"===e.type);if(0===u.length)break;for(const e of u){if(P||v||_.signal.aborted)break;const t=await I.checkPermission(e.name,e.arguments);if("deny"===t.behavior){const o={role:"toolResult",toolCallId:e.id,toolName:e.name,content:[{type:"text",text:`Permission denied: ${t.message}`}],isError:!0,timestamp:Date.now()};R.messages.push(o);continue}const o="allow"===t.behavior&&t.updatedInput?t.updatedInput:e.arguments,s=Date.now();let n;try{n=await I.execute(e.name,e.id,o)}catch(e){n={content:[{type:"text",text:`Tool execution error: ${e}`}],isError:!0}}const r=(Date.now()-s)/1e3;yield{type:"tool_progress",tool_name:e.name,elapsed_time_seconds:r};const a={role:"toolResult",toolCallId:e.id,toolName:e.name,content:n.content,isError:n.isError,timestamp:Date.now()};R.messages.push(a)}if(P||v||_.signal.aborted)return v=!1,void(yield y(R,"error_during_execution",g,k,$,M,T,["aborted"]))}m>=u&&!P?yield y(R,"error_max_turns",g,k,$,M,T):(v=!1,yield y(R,"success",g,k,$,M,T))}const D=async function*(){yield{type:"system",subtype:"init",slash_commands:[],session_id:M};try{for await(const e of T){if(P)break;(v||_.signal.aborted)&&(v=!1,_=new AbortController);for await(const t of W(e)){if(P)break;yield t}}}catch(e){P||(yield{type:"result",subtype:"error_during_execution",session_id:M,result:"",errors:[`${e}`]})}}();return{[Symbol.asyncIterator]:()=>D,async interrupt(){v=!0,_.abort()},async setModel(e){if(e.includes("/")){const[t,o]=e.split("/",2);C=t,$=o}else $=e},close(){P=!0,_.abort(),g.delete(M)},async supportedModels(){try{const e=await p();if(!e)return[];const t=e.getProviders(),o=[];for(const s of t)try{const t=e.getModels(s);for(const e of t)o.push({id:`${s}/${e.id}`,name:e.name||e.id})}catch{}return o}catch{return[]}}}}function f(e){switch(e){case"stop":return"end_turn";case"length":return"max_tokens";case"toolUse":return"tool_use";case"error":return"error";case"aborted":return"aborted";default:return e}}function y(e,t,o,s,n,r,a,i){const c=Date.now()-r;return e.totalCostUsd+=a.cost.total,e.totalTurns++,{type:"result",subtype:t,session_id:e.id,result:"success"===t?o:void 0,stop_reason:"success"===t?s:null,total_cost_usd:a.cost.total,duration_ms:c,num_turns:1,modelUsage:{[n]:{inputTokens:a.input,outputTokens:a.output,cacheReadInputTokens:a.cacheRead,cacheCreationInputTokens:a.cacheWrite,costUSD:a.cost.total}},...i?{errors:i}:{}}}function w(e,t){e.input+=t.input,e.output+=t.output,e.cacheRead+=t.cacheRead,e.cacheWrite+=t.cacheWrite,e.totalTokens+=t.totalTokens,e.cost.input+=t.cost.input,e.cost.output+=t.cost.output,e.cost.cacheRead+=t.cost.cacheRead,e.cost.cacheWrite+=t.cost.cacheWrite,e.cost.total+=t.cost.total}function x(e){return e}

package/dist/pi-agent-provider/pi-skill-loader.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Pi Skill & Command Loader
+ *
+ * Discovers installed skills and custom commands from the workspace
+ * and builds a text block to append to the pi-agent system prompt.
+ *
+ * This compensates for the pi engine not having the built-in Skill tool
+ * that the Claude Agent SDK provides.
+ */
+/**
+ * Build the skills and commands block to append to the pi-agent system prompt.
+ * Returns an empty string if no skills or commands are found.
+ */
+export declare function buildSkillsAndCommandsBlock(workspacePath: string): string;
+//# sourceMappingURL=pi-skill-loader.d.ts.map

package/dist/pi-agent-provider/pi-skill-loader.js

@@ -0,0 +1 @@
+import{readFileSync as t,readdirSync as n,existsSync as e,statSync as i}from"fs";import{join as o,relative as s,extname as c}from"path";function r(t){const n={};if(!t.startsWith("---"))return n;const e=t.indexOf("\n---",3);if(-1===e)return n;const i=t.slice(4,e);for(const t of i.split("\n")){const e=t.indexOf(":");if(-1===e)continue;const i=t.slice(0,e).trim();let o=t.slice(e+1).trim();(o.startsWith('"')&&o.endsWith('"')||o.startsWith("'")&&o.endsWith("'"))&&(o=o.slice(1,-1)),n[i]=o}return n}function a(t){const s=[];if(!e(t))return s;let r;try{r=n(t)}catch{return s}for(const n of r){const e=o(t,n);try{const t=i(e);t.isDirectory()?s.push(...a(e)):t.isFile()&&".md"===c(n)&&s.push(e)}catch{continue}}return s}function l(n){const i=o(n,".claude","commands");if(!e(i))return[];const c=a(i),l=[];for(const e of c){let o;try{o=t(e,"utf-8")}catch{continue}const c=r(o).description||"",a="/"+s(i,e).replace(/\.md$/,"").replace(/\\/g,"/"),u=s(n,e);l.push({commandName:a,description:c,relativePath:u})}return l}export function buildSkillsAndCommandsBlock(i){if(!i)return"";const c=function(i){const c=o(i,".claude","skills");if(!e(c))return[];const a=[];let l;try{l=n(c)}catch{return[]}for(const n of l){const l=o(c,n,"SKILL.md");if(!e(l))continue;let u;try{u=t(l,"utf-8")}catch{continue}const f=r(u);if("false"===f["user-invocable"])continue;const m=f.name||n,d=f.description||"",h=s(i,l);a.push({name:m,description:d,relativePath:h})}return a}(i),a=l(i);if(0===c.length&&0===a.length)return"";const u=[];if(c.length>0){const t=["## Installed Skills","","Skills are available in `.claude/skills/`. To use a skill, read its SKILL.md file first for instructions.",""];for(const n of c)t.push(`- **${n.name}**${n.description?": "+n.description:""} → \`${n.relativePath}\``);u.push(t.join("\n"))}if(a.length>0){const t=["## Custom Commands","","Custom commands are available in `.claude/commands/`. To execute a command, read its .md file for the prompt template.",""];for(const n of a)t.push(`- **${n.commandName}**${n.description?": "+n.description:""} → \`${n.relativePath}\``);u.push(t.join("\n"))}return u.join("\n\n")}

package/dist/pi-agent-provider/pi-tool-adapter.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Tool adapter: bridges MCP tool servers to pi-ai AgentTools.
+ *
+ * The Claude Agent SDK uses MCP servers for tools. Pi-ai uses AgentTool objects
+ * with inline execute() functions. This adapter extracts tool definitions from
+ * MCP servers and creates pi-ai compatible AgentTools that route execution
+ * back through the MCP transport.
+ *
+ * Since we don't have direct access to MCP server internals from this library,
+ * tools are registered declaratively and executed via a callback mechanism.
+ */
+import type { PiTextContent, PiImageContent } from "./pi-message-adapter.js";
+/**
+ * Simplified Tool definition compatible with pi-ai.
+ * Uses plain JSON Schema instead of TypeBox to avoid the dependency.
+ */
+export interface PiTool {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+}
+/**
+ * Tool execution result in pi-ai format.
+ */
+export interface PiToolResult {
+    content: (PiTextContent | PiImageContent)[];
+    isError: boolean;
+}
+/**
+ * Callback for executing a tool. The provider implements this to route
+ * tool calls to the appropriate MCP server or built-in handler.
+ */
+export type ToolExecutor = (toolName: string, toolCallId: string, args: Record<string, unknown>) => Promise<PiToolResult>;
+/**
+ * Callback for checking tool permissions via canUseTool.
+ */
+export type ToolPermissionChecker = (toolName: string, input: Record<string, unknown>) => Promise<{
+    behavior: "allow";
+    updatedInput: unknown;
+} | {
+    behavior: "deny";
+    message: string;
+}>;
+/**
+ * Registry that holds tool definitions and routes execution.
+ * This is the bridge between the pi-ai agent loop and Hera's MCP infrastructure.
+ */
+export declare class ToolRegistry {
+    private tools;
+    private executor;
+    private permissionChecker;
+    /**
+     * Register a tool definition.
+     */
+    registerTool(tool: PiTool): void;
+    /**
+     * Register multiple tools at once.
+     */
+    registerTools(tools: PiTool[]): void;
+    /**
+     * Set the tool executor callback.
+     */
+    setExecutor(executor: ToolExecutor): void;
+    /**
+     * Set the permission checker callback.
+     */
+    setPermissionChecker(checker: ToolPermissionChecker): void;
+    /**
+     * Get all registered tools as pi-ai Tool objects.
+     */
+    getTools(): PiTool[];
+    /**
+     * Get a specific tool by name.
+     */
+    getTool(name: string): PiTool | undefined;
+    /**
+     * Check if a tool is allowed to execute.
+     */
+    checkPermission(toolName: string, input: Record<string, unknown>): Promise<{
+        behavior: "allow";
+        updatedInput: unknown;
+    } | {
+        behavior: "deny";
+        message: string;
+    }>;
+    /**
+     * Execute a tool call.
+     */
+    execute(toolName: string, toolCallId: string, args: Record<string, unknown>): Promise<PiToolResult>;
+    /**
+     * Check if a tool name matches any allowed tool pattern.
+     * Supports glob patterns like "mcp__server-tools__*".
+     */
+    static matchesPattern(toolName: string, patterns: string[]): boolean;
+    /**
+     * Filter tools based on allowed/disallowed lists.
+     */
+    getFilteredTools(allowedTools?: string[], disallowedTools?: string[]): PiTool[];
+}
+/**
+ * Built-in tools that the Claude Agent SDK provides.
+ * These need to be emulated in the pi-agent provider.
+ */
+export declare const BUILTIN_TOOL_DEFINITIONS: PiTool[];
+//# sourceMappingURL=pi-tool-adapter.d.ts.map

package/dist/pi-agent-provider/pi-tool-adapter.js

@@ -0,0 +1 @@
+export class ToolRegistry{tools=new Map;executor=null;permissionChecker=null;registerTool(e){this.tools.set(e.name,e)}registerTools(e){for(const t of e)this.registerTool(t)}setExecutor(e){this.executor=e}setPermissionChecker(e){this.permissionChecker=e}getTools(){return Array.from(this.tools.values())}getTool(e){return this.tools.get(e)}async checkPermission(e,t){return this.permissionChecker?this.permissionChecker(e,t):{behavior:"allow",updatedInput:t}}async execute(e,t,r){return this.executor?this.executor(e,t,r):{content:[{type:"text",text:`No executor registered for tool: ${e}`}],isError:!0}}static matchesPattern(e,t){for(const r of t){if(r===e)return!0;if(r.endsWith("*")){const t=r.slice(0,-1);if(e.startsWith(t))return!0}}return!1}getFilteredTools(e,t){let r=this.getTools();return e&&e.length>0&&(r=r.filter(t=>ToolRegistry.matchesPattern(t.name,e))),t&&t.length>0&&(r=r.filter(e=>!ToolRegistry.matchesPattern(e.name,t))),r}}export const BUILTIN_TOOL_DEFINITIONS=[{name:"Read",description:"Read a file from the filesystem. Returns file content with line numbers.",parameters:{type:"object",properties:{file_path:{type:"string",description:"Absolute path to the file"},offset:{type:"number",description:"Line number to start from"},limit:{type:"number",description:"Number of lines to read"}},required:["file_path"]}},{name:"Write",description:"Write content to a file, creating or overwriting it.",parameters:{type:"object",properties:{file_path:{type:"string",description:"Absolute path to the file"},content:{type:"string",description:"Content to write"}},required:["file_path","content"]}},{name:"Edit",description:"Perform exact string replacements in a file.",parameters:{type:"object",properties:{file_path:{type:"string",description:"Absolute path to the file"},old_string:{type:"string",description:"Text to replace"},new_string:{type:"string",description:"Replacement text"},replace_all:{type:"boolean",description:"Replace all occurrences"}},required:["file_path","old_string","new_string"]}},{name:"Bash",description:"Execute a bash command.",parameters:{type:"object",properties:{command:{type:"string",description:"The command to execute"},timeout:{type:"number",description:"Timeout in milliseconds"},description:{type:"string",description:"Description of the command"}},required:["command"]}},{name:"Glob",description:"Find files matching a glob pattern.",parameters:{type:"object",properties:{pattern:{type:"string",description:"Glob pattern"},path:{type:"string",description:"Directory to search in"}},required:["pattern"]}},{name:"Grep",description:"Search file contents using regex patterns.",parameters:{type:"object",properties:{pattern:{type:"string",description:"Regex pattern"},path:{type:"string",description:"File or directory to search"},glob:{type:"string",description:"Glob pattern to filter files"},output_mode:{type:"string",enum:["content","files_with_matches","count"]}},required:["pattern"]}},{name:"WebSearch",description:"Search the web for information.",parameters:{type:"object",properties:{query:{type:"string",description:"Search query"}},required:["query"]}},{name:"WebFetch",description:"Fetch and process content from a URL.",parameters:{type:"object",properties:{url:{type:"string",description:"URL to fetch"},prompt:{type:"string",description:"Prompt for processing content"}},required:["url","prompt"]}},{name:"AskUserQuestion",description:"Ask the user questions during execution.",parameters:{type:"object",properties:{questions:{type:"array",items:{type:"object",properties:{question:{type:"string"},header:{type:"string"},options:{type:"array",items:{type:"object",properties:{label:{type:"string"},description:{type:"string"}},required:["label"]}},multiSelect:{type:"boolean"}},required:["question","header","options","multiSelect"]}}},required:["questions"]}},{name:"TodoWrite",description:"Create and manage a structured task list.",parameters:{type:"object",properties:{todos:{type:"array",items:{type:"object",properties:{content:{type:"string"},status:{type:"string",enum:["pending","in_progress","completed"]},activeForm:{type:"string"}},required:["content","status","activeForm"]}}},required:["todos"]}}];