maestro-agent-sdk 0.1.0

package/dist/core/loop.js

@@ -0,0 +1,317 @@
+import { compressIfNeeded } from "../memory/compressor.js";
+import { StreamingContextScrubber, scrubString } from "../memory/scrubber.js";
+import { extractFileEvents } from "../media/file-events.js";
+import { logger } from "../platform/logger.js";
+/**
+ * Cap applied to the `content` field of `tool_result` UnifiedEvents emitted to
+ * the dispatcher. Matches the 200-char ceiling already enforced by
+ * claude-provider.ts:373 and codex-provider.ts's `summarizeMcpToolCallResult`.
+ * Downstream telegram renderers are sized for that ceiling — letting raw
+ * 16KB+ bash payloads or full MCP results through would break their layout
+ * assumptions.
+ *
+ * Critically, this cap applies ONLY to the surfaced UnifiedEvent. The
+ * `tool_result` block pushed back into `messages` for the next API turn keeps
+ * the full payload, so the model still sees complete tool output — same as
+ * claude/codex, where the SDK passes full results to the model and only the
+ * UnifiedEvent emit path truncates.
+ */
+const TOOL_RESULT_PREVIEW_MAX = 200;
+/**
+ * run_conversation — Maestro agent loop (TS port).
+ *
+ * Yields UnifiedEvents so the Clawgram dispatcher can stream them to telegram
+ * without caring about the underlying provider format.
+ *
+ * Multi-turn: the caller owns the `messages` array and passes it in
+ * pre-populated with prior history (loaded from `~/.maestro/sessions/<id>.jsonl`
+ * by `maestroProvider`) plus the new user prompt as the last entry. The loop
+ * mutates that array in place, appending assistant turns and tool-result
+ * user turns as the conversation progresses; once the generator drains, the
+ * caller persists the final `messages` back to disk for the next resume.
+ *
+ * This shape avoids returning the final history through the async iterator
+ * (which would either require a special "internal" UnifiedEvent variant or a
+ * companion side-channel — both worse than just sharing the array).
+ *
+ * Upstream reference: `run_agent.py::AIAgent.run_conversation` — same control
+ * flow, just `client.chat.completions.create` swapped for `provider.complete`
+ * and OpenAI message blocks swapped for Anthropic blocks.
+ */
+export async function* runConversation(agent, messages) {
+    let iterations = 0;
+    const maxIter = agent.config.maxIterations;
+    const usageAcc = {
+        inputTokens: 0,
+        outputTokens: 0,
+        cacheCreationInputTokens: 0,
+        cacheReadInputTokens: 0,
+    };
+    while (iterations < maxIter) {
+        if (agent.config.abortSignal?.aborted) {
+            yield { type: "error", content: "maestro loop aborted" };
+            return;
+        }
+        // Two-stage context shrink before the provider call:
+        //   1. compressIfNeeded — runs pruneMessages internally, then if still
+        //      over 80% of the context window dispatches the aux LLM (cheap
+        //      haiku) to summarize the middle into the Active Task template.
+        //      Returns the caller's array as-is when below threshold so the
+        //      common case is just a token-estimate pass.
+        //   2. compressIfNeeded already prunes — no second pruneMessages call.
+        //
+        // Pure with respect to `messages` (canonical history kept intact for
+        // resume); only the on-wire slice is reshaped. Anti-thrashing on the
+        // array reference (both in prune.ts and compressor.ts) keeps back-to-
+        // back iterations near-zero CPU once the conversation stabilizes.
+        //
+        // Aux provider is the same Provider instance as the agent's main
+        // provider — Anthropic adapter accepts the haiku model id directly,
+        // so no second client needed. Fallback inside compressIfNeeded handles
+        // aux LLM failure by dropping to prune-only.
+        const wireMessages = await compressIfNeeded(messages, {
+            auxProvider: agent.provider,
+            ...(agent.config.abortSignal ? { abortSignal: agent.config.abortSignal } : {}),
+        });
+        // Drive the API call via stream() when available so we can emit
+        // text_delta UnifiedEvents as the tokens arrive — matches claude/codex
+        // progressive typing UX. complete() stays as the fallback for providers
+        // that haven't implemented stream() yet (e.g. an early Phase 5 OpenAI
+        // adapter could ship stream() in a follow-up).
+        const callOpts = {
+            model: agent.config.model,
+            messages: wireMessages,
+            system: agent.config.systemPrompt,
+            tools: agent.tools.schemas(),
+            maxTokens: agent.config.maxTokens,
+            ...(agent.config.thinkingBudget ? { thinkingBudget: agent.config.thinkingBudget } : {}),
+            ...(agent.config.effort ? { effort: agent.config.effort } : {}),
+            ...(agent.config.abortSignal ? { abortSignal: agent.config.abortSignal } : {}),
+        };
+        let response;
+        let assistantText = "";
+        const toolUses = [];
+        const assistantBlocks = [];
+        if (agent.provider.stream) {
+            // Per-tool_use scratch: accumulate the JSON input arriving across
+            // multiple `tool_use_input_delta` chunks, then parse on _complete.
+            const toolInputBuffer = new Map();
+            let streamUsage = { inputTokens: 0, outputTokens: 0 };
+            let streamStopReason = "end_turn";
+            // Strip any `<compacted-history>...</compacted-history>` fence the
+            // model echoes from a prior compaction. The scrubber buffers up to a
+            // marker's worth of bytes across chunk boundaries so a split tag
+            // (`...<comp` | `acted-history>...`) still matches. See
+            // `memory/scrubber.ts` — also used as `scrubString` for the
+            // consolidated end-of-turn text below.
+            const scrubber = new StreamingContextScrubber();
+            for await (const chunk of agent.provider.stream(callOpts)) {
+                if (chunk.type === "text_delta") {
+                    const scrubbed = scrubber.feed(chunk.text);
+                    assistantText += scrubbed;
+                    if (scrubbed.length > 0)
+                        yield { type: "text_delta", content: scrubbed };
+                }
+                else if (chunk.type === "tool_use_start") {
+                    toolInputBuffer.set(chunk.id, { name: chunk.name, partial: "" });
+                }
+                else if (chunk.type === "tool_use_input_delta") {
+                    const buf = toolInputBuffer.get(chunk.id);
+                    if (buf)
+                        buf.partial += chunk.partial_json;
+                }
+                else if (chunk.type === "tool_use_complete") {
+                    const buf = toolInputBuffer.get(chunk.id);
+                    if (!buf)
+                        continue;
+                    let input = {};
+                    if (buf.partial.length > 0) {
+                        try {
+                            input = JSON.parse(buf.partial);
+                        }
+                        catch (e) {
+                            logger.warn({ err: e, toolName: chunk.name, raw: buf.partial.slice(0, 200) }, "maestro stream: tool_use input_json parse failed — using empty input");
+                        }
+                    }
+                    toolUses.push({ id: chunk.id, name: chunk.name, input });
+                    assistantBlocks.push({ type: "tool_use", id: chunk.id, name: chunk.name, input });
+                    yield { type: "tool_use", name: chunk.name, input };
+                    toolInputBuffer.delete(chunk.id);
+                }
+                else if (chunk.type === "thinking_complete") {
+                    assistantBlocks.push(chunk.block);
+                }
+                else if (chunk.type === "message_complete") {
+                    streamUsage = chunk.usage;
+                    streamStopReason = chunk.stopReason;
+                }
+            }
+            // Flush any bytes the scrubber was holding (matching-open buffer that
+            // turned out not to be a real marker). `finish()` is also where an
+            // unclosed `<compacted-history>` block gets silently dropped.
+            const tail = scrubber.finish();
+            if (tail.length > 0) {
+                assistantText += tail;
+                yield { type: "text_delta", content: tail };
+            }
+            // Reconstruct the text block(s) once at the end — the loop only
+            // needs a single concatenated block to push back into history, which
+            // matches what Anthropic's non-streaming response would have given us.
+            if (assistantText.length > 0) {
+                assistantBlocks.unshift({ type: "text", text: assistantText });
+            }
+            response = { content: assistantBlocks, stopReason: streamStopReason, usage: streamUsage };
+        }
+        else {
+            response = await agent.provider.complete(callOpts);
+            // Walk the assistant's content blocks once: emit text/tool_use events
+            // to the caller, build the assistant-turn message for the next
+            // iteration, and collect tool_use blocks that need dispatching.
+            for (const block of response.content) {
+                if (block.type === "text") {
+                    // Non-streaming path: scrub the whole block at once. Mirrors the
+                    // streaming scrubber so consumers see the same shape regardless
+                    // of which provider mode produced the response.
+                    const cleaned = scrubString(block.text);
+                    assistantText += cleaned;
+                    if (cleaned.length > 0) {
+                        assistantBlocks.push({ type: "text", text: cleaned });
+                    }
+                }
+                else if (block.type === "tool_use") {
+                    toolUses.push({ id: block.id, name: block.name, input: block.input });
+                    assistantBlocks.push(block);
+                    yield { type: "tool_use", name: block.name, input: block.input };
+                }
+                else if (block.type === "thinking" || block.type === "redacted_thinking") {
+                    assistantBlocks.push(block);
+                }
+            }
+        }
+        usageAcc.inputTokens += response.usage.inputTokens;
+        usageAcc.outputTokens += response.usage.outputTokens;
+        usageAcc.cacheCreationInputTokens += response.usage.cacheCreationInputTokens ?? 0;
+        usageAcc.cacheReadInputTokens += response.usage.cacheReadInputTokens ?? 0;
+        if (assistantText.length > 0) {
+            // Streaming emitted text_delta chunks during the run; this terminal
+            // `text` event is the consolidated assistant turn so non-streaming
+            // consumers (recorders, log archives) still see one canonical entry
+            // per turn — same shape claude-provider.ts surfaces.
+            yield { type: "text", content: assistantText };
+            // Surface [FILE:/abs/path] tags emitted mid-turn (e.g. assistant
+            // narrating a file before calling a tool) so the dispatcher sends them
+            // immediately, matching codex-provider.ts's agent_message extract.
+            yield* extractFileEvents(assistantText, "text");
+        }
+        // Persist the assistant turn into the shared history before we either
+        // exit (so the next resume sees it) or run tools and continue. Doing
+        // this even for the no-tool exit keeps the caller's persistence call
+        // schema-consistent: every successful provider.complete() lands in the
+        // history exactly once.
+        messages.push({ role: "assistant", content: assistantBlocks });
+        if (toolUses.length === 0) {
+            // No more tools — turn complete.
+            yield {
+                type: "result",
+                content: assistantText,
+                stopReason: response.stopReason,
+                usage: {
+                    inputTokens: usageAcc.inputTokens,
+                    outputTokens: usageAcc.outputTokens,
+                    ...(usageAcc.cacheCreationInputTokens > 0 && {
+                        cacheCreationInputTokens: usageAcc.cacheCreationInputTokens,
+                    }),
+                    ...(usageAcc.cacheReadInputTokens > 0 && {
+                        cacheReadInputTokens: usageAcc.cacheReadInputTokens,
+                    }),
+                },
+            };
+            // Final pass on the result text — matches claude-provider.ts:352 and
+            // codex-provider.ts's turn.completed extract so [FILE:...] tags in the
+            // final assistant message reach the send-file path.
+            yield* extractFileEvents(assistantText, "result");
+            return;
+        }
+        // Dispatch tools in two phases so independent reads / fetches run in
+        // parallel while side-effecting calls (Write/Edit/Bash/most MCP) stay
+        // sequential:
+        //   Phase A — every tool whose handler is `parallelSafe: true` runs via
+        //             Promise.all. dispatch() never throws (errors are wrapped as
+        //             {error: ...} strings) so the batch always settles.
+        //   Phase B — remaining tools run one-by-one in their original order so
+        //             write/edit ordering is deterministic and unrelated bash
+        //             invocations don't race on ports/files/env.
+        //
+        // `results` is indexed by the position in `toolUses` so the final yield
+        // + push order matches what the model emitted, regardless of completion
+        // order. Anthropic requires `tool_result` blocks in one user turn to
+        // align with their corresponding `tool_use` ids; preserving the order
+        // also keeps the conversation log easier to read.
+        const results = new Array(toolUses.length);
+        const parallelIndices = [];
+        const serialIndices = [];
+        for (let i = 0; i < toolUses.length; i++) {
+            if (agent.tools.isParallelSafe(toolUses[i].name)) {
+                parallelIndices.push(i);
+            }
+            else {
+                serialIndices.push(i);
+            }
+        }
+        if (parallelIndices.length > 0) {
+            const parallelResults = await Promise.all(parallelIndices.map((i) => agent.tools.dispatch(toolUses[i].name, toolUses[i].input)));
+            for (let k = 0; k < parallelIndices.length; k++) {
+                results[parallelIndices[k]] = parallelResults[k];
+            }
+        }
+        for (const i of serialIndices) {
+            results[i] = await agent.tools.dispatch(toolUses[i].name, toolUses[i].input);
+        }
+        // Cap the surfaced UnifiedEvent `content` at TOOL_RESULT_PREVIEW_MAX to
+        // match claude/codex, but push the FULL `result` into `toolResultBlocks`
+        // so the model sees complete tool output on the next turn — claude/codex
+        // do the same (SDK feeds full payload to model, UnifiedEvent emit is the
+        // only place truncation happens).
+        const toolResultBlocks = [];
+        for (let i = 0; i < toolUses.length; i++) {
+            const tu = toolUses[i];
+            const result = results[i];
+            const preview = result.length > TOOL_RESULT_PREVIEW_MAX ? result.slice(0, TOOL_RESULT_PREVIEW_MAX) : result;
+            yield { type: "tool_result", toolUseId: tu.id, content: preview };
+            toolResultBlocks.push({
+                type: "tool_result",
+                tool_use_id: tu.id,
+                content: result,
+            });
+        }
+        // Append a fresh `<system-reminder>` text block AFTER the tool_result
+        // blocks so the model's next turn sees an up-to-date "iterations
+        // remaining" line. Budget = `maxIter - (iterations + 1)` because we
+        // haven't bumped `iterations` for this turn yet — the value reflects
+        // what the model will have AFTER consuming this turn.
+        //
+        // Anthropic accepts mixed tool_result+text blocks in a single user
+        // message; the trailing text block reads as meta annotation rather
+        // than user intent (claude/codex use the same shape).
+        //
+        // Freezing the reminder into `messages` (rather than re-injecting at
+        // wire time each iteration) keeps prefix-cache hits intact: turn N's
+        // reminder is byte-stable across every subsequent call, so the cache
+        // boundary moves forward one turn at a time instead of invalidating
+        // on every API hit.
+        if (agent.config.buildIterReminder) {
+            const remaining = Math.max(0, maxIter - (iterations + 1));
+            const reminderText = agent.config.buildIterReminder(remaining);
+            if (reminderText && reminderText.length > 0) {
+                toolResultBlocks.push({ type: "text", text: reminderText });
+            }
+        }
+        messages.push({ role: "user", content: toolResultBlocks });
+        iterations++;
+    }
+    yield {
+        type: "error",
+        content: `maestro loop hit max_iterations (${maxIter}) without resolving`,
+    };
+}
+//# sourceMappingURL=loop.js.map

package/dist/core/loop.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * maestro-agent-sdk — public API.
+ *
+ * Provider-agnostic agent loop with built-in tools, skills, memory, and MCP.
+ * See README.md for a quick start.
+ *
+ * Originally derived from Nous Research's hermes-agent (MIT); see NOTICE.
+ */
+export declare const MAESTRO_SDK_VERSION: "0.1.0";
+export declare const MAESTRO_UPSTREAM_SNAPSHOT: "v0.13.0 (2026-05-07)";
+export { AIAgent, type AIAgentConfig } from "./core/agent.js";
+export { runConversation } from "./core/loop.js";
+export { ToolRegistry, type ToolHandler, type HookRegistration, type PreToolUseHook, type PostToolUseHook, type PreToolUseContext, type PreToolUseDecision, type PostToolUseContext, type PostToolUseResult, } from "./tools/registry.js";
+export { bashTool } from "./tools/builtin/bash.js";
+export { createReadTool } from "./tools/builtin/read.js";
+export { createWriteTool } from "./tools/builtin/write.js";
+export { createEditTool } from "./tools/builtin/edit.js";
+export { createTodoWriteTool } from "./tools/builtin/todo_write.js";
+export { createSkillViewTool } from "./tools/builtin/skill_view.js";
+export { createAgentTool } from "./tools/builtin/agent.js";
+export { isSandboxEnabled, checkFilesystemAccess } from "./tools/builtin/sandbox.js";
+export { createSandboxFsHook } from "./tools/hooks/sandbox-fs.js";
+export { getFileStateTracker, dropFileStateTracker } from "./tools/file-state.js";
+export type { Provider, ProviderToolSchema, ProviderMessage, ProviderContentBlock, ProviderResponse, ProviderStreamChunk, ProviderCompleteOptions, } from "./providers/base.js";
+export { AnthropicProvider, effortToThinkingBudget, effortToMaxIter, applyThinkingBudget, buildCacheableSystem, buildCacheableTools, buildCacheableMessages, } from "./providers/anthropic.js";
+export { DeepseekProvider, effortForDeepseek, translateToolsToOpenAI, translateMessagesToOpenAI, } from "./providers/deepseek.js";
+export { maestroRegistry } from "./registry.js";
+export { maestroProvider, providerForModel, isAbortError, iterationBudgetLine } from "./provider.js";
+export { loadSkillsCached, findSkillByName, type SkillEntry } from "./skills/loader.js";
+export { buildSkillsIndex } from "./skills/index-builder.js";
+export { curateSkills } from "./skills/curator.js";
+export { loadUsage, bumpView, type SkillCounters } from "./skills/usage.js";
+export { compressIfNeeded } from "./memory/compressor.js";
+export { estimateTokens } from "./memory/token-estimate.js";
+export { buildSystemReminder } from "./memory/reminder.js";
+export { hashToolContent } from "./memory/hash.js";
+export { ACTIVE_TASK_TEMPLATE, wrapCompactedSummary } from "./memory/active-task-template.js";
+export { getTodoStore, dropTodoStore } from "./state/todos.js";
+export type { MaestroMcpServerSpec, MaestroMcpClient, MaestroMcpTool } from "./mcp/client.js";
+export { deleteMaestroSession } from "./session-store.js";
+export { setLogger, type Logger, type LogFn } from "./platform/logger.js";
+export { onShutdown, runShutdown } from "./platform/lifecycle.js";
+export { setMcpResolver, type McpResolver, type McpServerMap } from "./platform/mcp-config.js";
+export { setConversationReader, type ConversationReader } from "./storage/conversations.js";
+export type { TokenUsage, EffortLevel, AgentKind, AgentQueryOptions, UnifiedEvent, } from "./types.js";
+export { MAESTRO_EFFORT_VALUES, SUPPORTED_AGENTS, FALLBACK_AGENT, isAgentKind, } from "./types.js";
+export type { ConversationEntry } from "./storage/conversations.js";
+export type { AgentRegistry, WriteRolloutOptions, WriteRolloutResult, ForkRegistryOptions, ForkRegistryResult, CleanupRolloutsOptions, } from "./agents/contracts.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,53 @@
+/**
+ * maestro-agent-sdk — public API.
+ *
+ * Provider-agnostic agent loop with built-in tools, skills, memory, and MCP.
+ * See README.md for a quick start.
+ *
+ * Originally derived from Nous Research's hermes-agent (MIT); see NOTICE.
+ */
+export const MAESTRO_SDK_VERSION = "0.1.0";
+export const MAESTRO_UPSTREAM_SNAPSHOT = "v0.13.0 (2026-05-07)";
+// ─── Core agent loop ─────────────────────────────────────────────────────────
+export { AIAgent } from "./core/agent.js";
+export { runConversation } from "./core/loop.js";
+// ─── Tool registry + hook surface ────────────────────────────────────────────
+export { ToolRegistry, } from "./tools/registry.js";
+// ─── Built-in tools ──────────────────────────────────────────────────────────
+export { bashTool } from "./tools/builtin/bash.js";
+export { createReadTool } from "./tools/builtin/read.js";
+export { createWriteTool } from "./tools/builtin/write.js";
+export { createEditTool } from "./tools/builtin/edit.js";
+export { createTodoWriteTool } from "./tools/builtin/todo_write.js";
+export { createSkillViewTool } from "./tools/builtin/skill_view.js";
+export { createAgentTool } from "./tools/builtin/agent.js";
+export { isSandboxEnabled, checkFilesystemAccess } from "./tools/builtin/sandbox.js";
+export { createSandboxFsHook } from "./tools/hooks/sandbox-fs.js";
+export { getFileStateTracker, dropFileStateTracker } from "./tools/file-state.js";
+export { AnthropicProvider, effortToThinkingBudget, effortToMaxIter, applyThinkingBudget, buildCacheableSystem, buildCacheableTools, buildCacheableMessages, } from "./providers/anthropic.js";
+export { DeepseekProvider, effortForDeepseek, translateToolsToOpenAI, translateMessagesToOpenAI, } from "./providers/deepseek.js";
+// ─── Maestro registry + top-level provider entry point ───────────────────────
+export { maestroRegistry } from "./registry.js";
+export { maestroProvider, providerForModel, isAbortError, iterationBudgetLine } from "./provider.js";
+// ─── Skills ──────────────────────────────────────────────────────────────────
+export { loadSkillsCached, findSkillByName } from "./skills/loader.js";
+export { buildSkillsIndex } from "./skills/index-builder.js";
+export { curateSkills } from "./skills/curator.js";
+export { loadUsage, bumpView } from "./skills/usage.js";
+// ─── Memory / compression ────────────────────────────────────────────────────
+export { compressIfNeeded } from "./memory/compressor.js";
+export { estimateTokens } from "./memory/token-estimate.js";
+export { buildSystemReminder } from "./memory/reminder.js";
+export { hashToolContent } from "./memory/hash.js";
+export { ACTIVE_TASK_TEMPLATE, wrapCompactedSummary } from "./memory/active-task-template.js";
+// ─── State (todos) ───────────────────────────────────────────────────────────
+export { getTodoStore, dropTodoStore } from "./state/todos.js";
+// ─── Session store ───────────────────────────────────────────────────────────
+export { deleteMaestroSession } from "./session-store.js";
+// ─── Host integration points (dependency injection) ──────────────────────────
+export { setLogger } from "./platform/logger.js";
+export { onShutdown, runShutdown } from "./platform/lifecycle.js";
+export { setMcpResolver } from "./platform/mcp-config.js";
+export { setConversationReader } from "./storage/conversations.js";
+export { MAESTRO_EFFORT_VALUES, SUPPORTED_AGENTS, FALLBACK_AGENT, isAgentKind, } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,OAAgB,CAAC;AACpD,MAAM,CAAC,MAAM,yBAAyB,GAAG,sBAA+B,CAAC;AAEzE,gFAAgF;AAChF,OAAO,EAAE,OAAO,EAAsB,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,gFAAgF;AAChF,OAAO,EACL,YAAY,GASb,MAAM,kBAAkB,CAAC;AAE1B,gFAAgF;AAChF,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAa/E,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAE9B,gFAAgF;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAElG,gFAAgF;AAChF,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAmB,MAAM,iBAAiB,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAsB,MAAM,gBAAgB,CAAC;AAEzE,gFAAgF;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAE3F,gFAAgF;AAChF,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAK5D,gFAAgF;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,gFAAgF;AAChF,OAAO,EAAE,SAAS,EAA2B,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAuC,MAAM,uBAAuB,CAAC;AAC5F,OAAO,EAAE,qBAAqB,EAA2B,MAAM,yBAAyB,CAAC;AAUzF,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,WAAW,GACZ,MAAM,SAAS,CAAC"}

package/dist/mcp/client.d.ts

@@ -0,0 +1,79 @@
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import type { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
+import type { ProviderToolSchema } from "../providers/base.js";
+/**
+ * Maestro MCP client wrapper.
+ *
+ * Wraps `@modelcontextprotocol/sdk` Client so the Maestro loop can spawn /
+ * connect / list_tools / call_tool / close in a single namespace, mirroring
+ * what `@anthropic-ai/claude-agent-sdk` and `@openai/codex-sdk` do internally
+ * for the claude / codex providers.
+ *
+ * Unlike claude/codex, Maestro hits Anthropic's Messages API directly via
+ * fetch (see `providers/anthropic.ts`) — no SDK manages MCP for us, so we
+ * spawn the servers ourselves and surface their tools through Maestro's
+ * existing `ToolRegistry`.
+ */
+/** Raw spawn shape — matches `getMcpServersForQuery()` output (Claude-SDK shape). */
+export interface MaestroMcpServerSpec {
+    /** stdio servers. */
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    /** sse servers. */
+    type?: "sse";
+    url?: string;
+}
+/** One tool resolved from an MCP server, ready to register with a ToolRegistry. */
+export interface MaestroMcpTool {
+    /** Name exposed to the model (`mcp__<server>__<tool>`). */
+    publicName: string;
+    /** Original MCP tool name — used in `client.callTool`. */
+    originalName: string;
+    /** Owning MCP server name. */
+    serverName: string;
+    /** Anthropic-style tool schema for the API `tools` array. */
+    schema: ProviderToolSchema;
+}
+export declare class MaestroMcpClient {
+    readonly name: string;
+    private readonly spec;
+    /**
+     * Test-only override: when supplied, `start()` connects to this transport
+     * instead of building one from `spec`. Production callers pass two args.
+     */
+    private readonly transportOverride?;
+    readonly client: Client;
+    private transport?;
+    private started;
+    constructor(name: string, spec: MaestroMcpServerSpec, 
+    /**
+     * Test-only override: when supplied, `start()` connects to this transport
+     * instead of building one from `spec`. Production callers pass two args.
+     */
+    transportOverride?: Transport | undefined);
+    start(): Promise<void>;
+    /** Fetch `tools/list` and convert to Maestro/Anthropic shape with prefixed names. */
+    listTools(): Promise<MaestroMcpTool[]>;
+    /**
+     * Invoke an MCP tool. Returns the FULL rendered payload string for the
+     * Maestro tool_result block — the model needs to see complete tool output on
+     * the next turn, matching how claude/codex SDKs feed full payloads back.
+     * The 200-char cap that claude-provider.ts:373 and codex-provider.ts apply
+     * is a UnifiedEvent display concern only; Maestro enforces it inside the
+     * agent loop (`loop.ts:TOOL_RESULT_PREVIEW_MAX`) at the emit site, not here.
+     *
+     * Optional `abortSignal` propagates the Maestro-level abort down into the
+     * SDK's JSON-RPC request, so an in-flight `tools/call` is cancelled instead
+     * of left blocking on a dead server.
+     */
+    callTool(originalName: string, input: Record<string, unknown>, abortSignal?: AbortSignal): Promise<string>;
+    close(): Promise<void>;
+    private buildTransport;
+}
+/**
+ * Public MCP tool name. Mirrors Claude SDK's `mcp__<server>__<tool>` convention
+ * so the model sees consistent names across providers in the same topic.
+ */
+export declare function makePublicName(server: string, tool: string): string;
+//# sourceMappingURL=client.d.ts.map

package/dist/mcp/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/mcp/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAGnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC/E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAG3D;;;;;;;;;;;;GAYG;AAEH,qFAAqF;AACrF,MAAM,WAAW,oBAAoB;IACnC,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,mBAAmB;IACnB,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,mFAAmF;AACnF,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,YAAY,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,MAAM,EAAE,kBAAkB,CAAC;CAC5B;AAED,qBAAa,gBAAgB;IAMzB,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IAXrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,SAAS,CAAC,CAAY;IAC9B,OAAO,CAAC,OAAO,CAAS;gBAGb,IAAI,EAAE,MAAM,EACJ,IAAI,EAAE,oBAAoB;IAC3C;;;OAGG;IACc,iBAAiB,CAAC,EAAE,SAAS,YAAA;IAK1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B,qFAAqF;IAC/E,SAAS,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAsB5C;;;;;;;;;;;OAWG;IACG,QAAQ,CACZ,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,MAAM,CAAC;IASZ,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAU5B,OAAO,CAAC,cAAc;CAwBvB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnE"}