maestro-agent-sdk 0.1.0

package/dist/providers/deepseek.js

@@ -0,0 +1,467 @@
+const DEEPSEEK_API_URL = "https://api.deepseek.com/v1/chat/completions";
+export class DeepseekProvider {
+    apiKey;
+    constructor(apiKey) {
+        this.apiKey = apiKey;
+    }
+    static fromEnv() {
+        const apiKey = process.env.DEEPSEEK_API_KEY;
+        if (!apiKey) {
+            throw new Error("Maestro DeepseekProvider: DEEPSEEK_API_KEY env var is not set");
+        }
+        return new DeepseekProvider(apiKey);
+    }
+    async complete(opts) {
+        const body = buildRequestBody(opts, false);
+        const init = {
+            method: "POST",
+            headers: this.headers(),
+            body: JSON.stringify(body),
+        };
+        if (opts.abortSignal)
+            init.signal = opts.abortSignal;
+        const response = await fetch(DEEPSEEK_API_URL, init);
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`DeepSeek API ${response.status}: ${text}`);
+        }
+        const data = (await response.json());
+        const choice = data.choices?.[0];
+        if (!choice) {
+            throw new Error("DeepSeek API: response missing choices");
+        }
+        return {
+            content: openAiChoiceToBlocks(choice),
+            stopReason: mapStopReason(choice.finish_reason),
+            usage: mapUsage(data.usage),
+        };
+    }
+    async *stream(opts) {
+        const body = buildRequestBody(opts, true);
+        const init = {
+            method: "POST",
+            headers: { ...this.headers(), accept: "text/event-stream" },
+            body: JSON.stringify(body),
+        };
+        if (opts.abortSignal)
+            init.signal = opts.abortSignal;
+        const response = await fetch(DEEPSEEK_API_URL, init);
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`DeepSeek API ${response.status}: ${text}`);
+        }
+        if (!response.body) {
+            throw new Error("DeepSeek API: streaming response missing body");
+        }
+        // OpenAI streams parallel tool calls keyed by `delta.tool_calls[*].index`
+        // (NOT the Anthropic content-block index — they're separate spaces). We
+        // accumulate per-index so a tool's arguments JSON survives across many
+        // chunks before we emit the matching `tool_use_complete`.
+        const toolAccum = new Map();
+        // Reasoning content arrives as `delta.reasoning_content` deltas. The
+        // base.ts contract only carries terminal `thinking_complete` blocks
+        // (Anthropic delivers thinking deltas inside a content block; we buffer
+        // here and emit one consolidated block before `message_complete`).
+        let reasoningBuf = "";
+        let reasoningSeen = false;
+        let stopReason = "end_turn";
+        let usage = { inputTokens: 0, outputTokens: 0 };
+        for await (const event of parseSseStream(response.body, opts.abortSignal)) {
+            const choice = event.choices?.[0];
+            if (!choice) {
+                // Some chunks (e.g. final usage-only) may lack choices — capture
+                // usage and move on.
+                if (event.usage)
+                    usage = mapUsage(event.usage);
+                continue;
+            }
+            const delta = choice.delta ?? {};
+            if (typeof delta.content === "string" && delta.content.length > 0) {
+                yield { type: "text_delta", text: delta.content };
+            }
+            if (typeof delta.reasoning_content === "string" && delta.reasoning_content.length > 0) {
+                reasoningSeen = true;
+                reasoningBuf += delta.reasoning_content;
+            }
+            if (Array.isArray(delta.tool_calls)) {
+                for (const tc of delta.tool_calls) {
+                    if (typeof tc?.index !== "number")
+                        continue;
+                    let entry = toolAccum.get(tc.index);
+                    if (!entry) {
+                        entry = { id: "", name: "", args: "", startEmitted: false };
+                        toolAccum.set(tc.index, entry);
+                    }
+                    if (typeof tc.id === "string" && tc.id.length > 0)
+                        entry.id = tc.id;
+                    if (typeof tc.function?.name === "string" && tc.function.name.length > 0) {
+                        entry.name = tc.function.name;
+                    }
+                    if (!entry.startEmitted && entry.id.length > 0 && entry.name.length > 0) {
+                        entry.startEmitted = true;
+                        yield { type: "tool_use_start", id: entry.id, name: entry.name };
+                    }
+                    if (typeof tc.function?.arguments === "string" && tc.function.arguments.length > 0) {
+                        entry.args += tc.function.arguments;
+                        if (entry.startEmitted) {
+                            yield {
+                                type: "tool_use_input_delta",
+                                id: entry.id,
+                                partial_json: tc.function.arguments,
+                            };
+                        }
+                    }
+                }
+            }
+            if (choice.finish_reason) {
+                stopReason = mapStopReason(choice.finish_reason);
+            }
+            if (event.usage)
+                usage = mapUsage(event.usage);
+        }
+        // Flush per-index tool buffers in the order their indexes appeared. If a
+        // tool's start was deferred because id/name arrived only in the final
+        // chunk, emit it now in [start, input_delta(full), complete] order so the
+        // loop's accumulator state machine still gets a coherent sequence.
+        const indexes = [...toolAccum.keys()].sort((a, b) => a - b);
+        for (const idx of indexes) {
+            const entry = toolAccum.get(idx);
+            if (!entry || entry.id.length === 0)
+                continue;
+            if (!entry.startEmitted) {
+                yield { type: "tool_use_start", id: entry.id, name: entry.name };
+                if (entry.args.length > 0) {
+                    yield {
+                        type: "tool_use_input_delta",
+                        id: entry.id,
+                        partial_json: entry.args,
+                    };
+                }
+            }
+            yield { type: "tool_use_complete", id: entry.id, name: entry.name };
+        }
+        // Emit thinking BEFORE message_complete so the loop pushes it into the
+        // assistant block list (loop.ts:155 appends thinking_complete blocks
+        // directly into assistantBlocks). Order in history: thinking → text →
+        // tool_use, matching Anthropic's interleaved-thinking convention.
+        if (reasoningSeen && reasoningBuf.length > 0) {
+            yield {
+                type: "thinking_complete",
+                block: { type: "thinking", thinking: reasoningBuf },
+            };
+        }
+        yield { type: "message_complete", stopReason, usage };
+    }
+    headers() {
+        return {
+            "content-type": "application/json",
+            authorization: `Bearer ${this.apiKey}`,
+        };
+    }
+}
+/**
+ * Build the JSON request body for both `complete` and `stream` paths. The
+ * `stream` flag flips streaming and adds the SSE include_usage option so the
+ * final chunk carries usage even on streaming.
+ */
+function buildRequestBody(opts, stream) {
+    const body = {
+        model: opts.model,
+        messages: translateMessagesToOpenAI(opts.system, opts.messages),
+        max_tokens: opts.maxTokens ?? 4096,
+    };
+    if (opts.tools && opts.tools.length > 0) {
+        body.tools = translateToolsToOpenAI(opts.tools);
+    }
+    if (stream) {
+        body.stream = true;
+        // Without `stream_options.include_usage` OpenAI-compatible servers send
+        // chunks with `usage: null`; this opt-in makes the terminal chunk include
+        // full token counts so the loop's token accounting stays accurate.
+        body.stream_options = { include_usage: true };
+    }
+    const effort = effortForDeepseek(opts.effort);
+    if (effort) {
+        body.reasoning_effort = effort;
+        // `extra_body` is the Python SDK convention; DeepSeek's HTTP API accepts
+        // the keys at the top level too. We keep top-level for HTTP simplicity.
+        body.thinking = { type: "enabled" };
+    }
+    return body;
+}
+/**
+ * Map the SDK's `EffortLevel` to DeepSeek's `reasoning_effort` string.
+ * DeepSeek's API ships four tiers (low/medium/high/max); maestro's
+ * `xhigh` and `max` both collapse onto DeepSeek `max` — the thinking
+ * depth is identical between them, but their maestro-side `maxIter` caps
+ * differ (xhigh=90, max=200), so the user-facing distinction is "how
+ * much rope before the loop strangles", not API-side reasoning depth.
+ *
+ * Returns undefined when effort is unset/unknown so the caller can skip
+ * thinking entirely.
+ */
+export function effortForDeepseek(e) {
+    switch (e) {
+        case "low":
+            return "low";
+        case "medium":
+            return "medium";
+        case "high":
+            return "high";
+        case "xhigh":
+            return "max";
+        case "max":
+            return "max";
+        default:
+            return undefined;
+    }
+}
+/**
+ * Map OpenAI `finish_reason` to the loose stop_reason string the loop and
+ * conversation log carry. The loop itself doesn't branch on the value — it
+ * just propagates it into the `result` event — but downstream consumers and
+ * tests assert on familiar Anthropic-style names, so we normalize here.
+ */
+export function mapStopReason(reason) {
+    switch (reason) {
+        case "tool_calls":
+            return "tool_use";
+        case "stop":
+            return "end_turn";
+        case "length":
+            return "max_tokens";
+        case "content_filter":
+            return "stop";
+        case null:
+        case undefined:
+        case "":
+            return "end_turn";
+        default:
+            return reason;
+    }
+}
+function mapUsage(u) {
+    if (!u)
+        return { inputTokens: 0, outputTokens: 0 };
+    const out = {
+        inputTokens: u.prompt_tokens ?? 0,
+        outputTokens: u.completion_tokens ?? 0,
+    };
+    if (u.prompt_cache_hit_tokens !== undefined) {
+        out.cacheReadInputTokens = u.prompt_cache_hit_tokens;
+    }
+    return out;
+}
+/**
+ * Translate a non-streaming OpenAI choice into the Anthropic-shaped content
+ * block list. Order: thinking → text → tool_use, matching the streaming path.
+ */
+function openAiChoiceToBlocks(choice) {
+    const blocks = [];
+    const msg = choice.message;
+    if (typeof msg.reasoning_content === "string" && msg.reasoning_content.length > 0) {
+        blocks.push({ type: "thinking", thinking: msg.reasoning_content });
+    }
+    if (typeof msg.content === "string" && msg.content.length > 0) {
+        blocks.push({ type: "text", text: msg.content });
+    }
+    if (Array.isArray(msg.tool_calls)) {
+        for (const tc of msg.tool_calls) {
+            let input = {};
+            if (tc.function?.arguments) {
+                try {
+                    input = JSON.parse(tc.function.arguments);
+                }
+                catch {
+                    // Defensive — malformed JSON arguments fall through with an empty
+                    // input. The loop's tool dispatcher then sees no args, same as
+                    // Anthropic's analogous failure mode.
+                }
+            }
+            blocks.push({
+                type: "tool_use",
+                id: tc.id,
+                name: tc.function?.name ?? "",
+                input,
+            });
+        }
+    }
+    return blocks;
+}
+/**
+ * Translate Maestro's Anthropic-shaped tool schemas into OpenAI function
+ * format. DeepSeek accepts the standard `{type:"function", function:{...}}`
+ * shape; we pass `input_schema` through as `parameters` (same JSON Schema
+ * subset, just renamed).
+ */
+export function translateToolsToOpenAI(tools) {
+    return tools.map((t) => ({
+        type: "function",
+        function: {
+            name: t.name,
+            description: t.description,
+            parameters: t.input_schema,
+        },
+    }));
+}
+/**
+ * Translate Maestro's Anthropic-shaped message history into the OpenAI chat
+ * shape DeepSeek expects.
+ *
+ * Key rules — these are the load-bearing parts of the translation, and the
+ * unit tests assert each one:
+ *
+ *   1. The shared `system` string becomes a leading `{role:"system"}` message.
+ *      Empty strings are dropped (no message at all).
+ *
+ *   2. Assistant messages aggregate text blocks into `content` and tool_use
+ *      blocks into `tool_calls`. `thinking` blocks become `reasoning_content`
+ *      ONLY when the same message also contains a tool_use; otherwise the
+ *      thinking is dropped per DeepSeek's multi-turn contract (sending back
+ *      reasoning_content for a final-answer turn produces a 400 on the next
+ *      request). `redacted_thinking` has no DeepSeek analog and is always
+ *      dropped.
+ *
+ *   3. User messages may carry `tool_result` blocks (Anthropic's convention
+ *      is to wrap them in a user-role message). In OpenAI shape these become
+ *      separate `{role:"tool", tool_call_id, content}` messages, one per
+ *      tool_result, emitted IN PLACE inside the message stream so the
+ *      ordering with surrounding user/assistant text is preserved. A user
+ *      message that's nothing but tool_results contributes no user message
+ *      itself — just the N tool messages.
+ *
+ *   4. Plain string `content` passes through unchanged.
+ */
+export function translateMessagesToOpenAI(system, messages) {
+    const out = [];
+    if (system && system.length > 0) {
+        out.push({ role: "system", content: system });
+    }
+    for (const msg of messages) {
+        if (typeof msg.content === "string") {
+            // Empty string content is allowed — preserves the slot but means the
+            // model emitted nothing. Both roles handled here.
+            out.push({ role: msg.role, content: msg.content });
+            continue;
+        }
+        if (msg.role === "user") {
+            // Split user content into text portion + per-tool_result messages,
+            // preserving the order the blocks appear in. tool_result blocks need
+            // their own role:"tool" messages with `tool_call_id`.
+            let userText = "";
+            for (const block of msg.content) {
+                if (block.type === "text") {
+                    userText += userText.length > 0 ? `\n${block.text}` : block.text;
+                }
+                else if (block.type === "tool_result") {
+                    // Flush any text accumulated before this tool_result so ordering
+                    // with the tool messages is preserved.
+                    if (userText.length > 0) {
+                        out.push({ role: "user", content: userText });
+                        userText = "";
+                    }
+                    out.push({
+                        role: "tool",
+                        tool_call_id: block.tool_use_id,
+                        content: block.content,
+                    });
+                }
+                // Other block types (tool_use, thinking) don't legally appear in
+                // user messages under our pipeline — silently skip if encountered.
+            }
+            if (userText.length > 0) {
+                out.push({ role: "user", content: userText });
+            }
+            continue;
+        }
+        // Assistant role: aggregate text, tool_uses, and (conditionally) thinking.
+        let assistantText = "";
+        const toolCalls = [];
+        let pendingThinking = "";
+        let hasToolUse = false;
+        for (const block of msg.content) {
+            if (block.type === "text") {
+                assistantText += assistantText.length > 0 ? `\n${block.text}` : block.text;
+            }
+            else if (block.type === "tool_use") {
+                hasToolUse = true;
+                toolCalls.push({
+                    id: block.id,
+                    type: "function",
+                    function: {
+                        name: block.name,
+                        arguments: JSON.stringify(block.input ?? {}),
+                    },
+                });
+            }
+            else if (block.type === "thinking") {
+                pendingThinking += pendingThinking.length > 0 ? `\n${block.thinking}` : block.thinking;
+            }
+            // `redacted_thinking` and `tool_result` are skipped.
+        }
+        const assistantMsg = { role: "assistant" };
+        // OpenAI requires either `content` or `tool_calls`. We always set
+        // `content` (empty string if nothing) so the request doesn't trip
+        // strict validators.
+        assistantMsg.content = assistantText;
+        if (toolCalls.length > 0) {
+            assistantMsg.tool_calls = toolCalls;
+        }
+        if (hasToolUse && pendingThinking.length > 0) {
+            assistantMsg.reasoning_content = pendingThinking;
+        }
+        out.push(assistantMsg);
+    }
+    return out;
+}
+/**
+ * Parse an OpenAI-compatible `text/event-stream` body into typed events.
+ * The format is identical to Anthropic's framing (`data: <json>\n\n`) except
+ * the terminator is the literal `data: [DONE]` line, after which we stop
+ * reading. Each `data:` payload's JSON is yielded as-is — the caller switches
+ * on `choices[0].finish_reason` and `delta` keys.
+ */
+async function* parseSseStream(body, abortSignal) {
+    const reader = body.getReader();
+    const decoder = new TextDecoder("utf-8");
+    let buf = "";
+    const onAbort = () => {
+        reader.cancel("aborted").catch(() => { });
+    };
+    abortSignal?.addEventListener("abort", onAbort, { once: true });
+    try {
+        while (true) {
+            const { value, done } = await reader.read();
+            if (done)
+                break;
+            buf += decoder.decode(value, { stream: true });
+            let idx = buf.indexOf("\n\n");
+            while (idx >= 0) {
+                const raw = buf.slice(0, idx);
+                buf = buf.slice(idx + 2);
+                const dataLine = raw
+                    .split("\n")
+                    .find((l) => l.startsWith("data:"))
+                    ?.slice("data:".length)
+                    .trim();
+                if (dataLine) {
+                    if (dataLine === "[DONE]")
+                        return;
+                    try {
+                        yield JSON.parse(dataLine);
+                    }
+                    catch {
+                        // Skip malformed frames — DeepSeek shouldn't emit them, and one
+                        // bad byte shouldn't kill a turn.
+                    }
+                }
+                idx = buf.indexOf("\n\n");
+            }
+        }
+    }
+    finally {
+        abortSignal?.removeEventListener("abort", onAbort);
+        reader.releaseLock();
+    }
+}
+//# sourceMappingURL=deepseek.js.map

package/dist/providers/deepseek.js.map

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

package/dist/registry.d.ts

@@ -0,0 +1,3 @@
+import type { AgentRegistry } from "./agents/contracts.js";
+export declare const maestroRegistry: AgentRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAsCxD,eAAO,MAAM,eAAe,EAAE,aAmE7B,CAAC"}

package/dist/registry.js

@@ -0,0 +1,94 @@
+import { unlinkSync } from "node:fs";
+import { maestroSessionPath, writeMaestroRollout } from "./session-store.js";
+import { MODEL_DEEPSEEK_V4_FLASH, MODEL_DEEPSEEK_V4_PRO, MODEL_SONNET, } from "./platform/config.js";
+import { logger } from "./platform/logger.js";
+import { readConversation } from "./storage/conversations.js";
+import { MAESTRO_EFFORT_VALUES } from "./types.js";
+/**
+ * Maestro registry — wired for multi-turn sessions + cross-agent bridging.
+ *
+ * Default model stays `sonnet` (Anthropic adapter is the original surface).
+ * `deepseek` family aliases land on V4-Flash by default — same model as the
+ * default `deepseek-chat` (V3.2-Exp non-thinking) successor, but cheap and
+ * fast for general use. Switch via `set_model deepseek-pro` per topic when
+ * heavier reasoning is wanted.
+ *
+ * Session persistence lives at `~/.maestro/sessions/<sessionId>.jsonl` —
+ * one ProviderMessage per line. Unlike claude/codex (which delegate
+ * persistence to their SDKs), maestro owns its own store, but the
+ * `writeRollout` / `forkSession` / `cleanupRollouts` contracts behave
+ * identically from the caller's perspective.
+ */
+const ALIAS_MAP = {
+    sonnet: MODEL_SONNET,
+    deepseek: MODEL_DEEPSEEK_V4_FLASH,
+    "deepseek-flash": MODEL_DEEPSEEK_V4_FLASH,
+    "deepseek-pro": MODEL_DEEPSEEK_V4_PRO,
+};
+const VALID_ALIASES = new Set(Object.keys(ALIAS_MAP));
+const VALID_FULL_IDS = new Set(Object.values(ALIAS_MAP));
+const VALID_EFFORTS = new Set(MAESTRO_EFFORT_VALUES);
+export const maestroRegistry = {
+    kind: "maestro",
+    defaultModel: "sonnet",
+    defaultEffort: "medium",
+    expandModelAlias(s) {
+        return ALIAS_MAP[s] ?? s;
+    },
+    validateModel(s) {
+        return VALID_ALIASES.has(s) || VALID_FULL_IDS.has(s);
+    },
+    validEfforts: MAESTRO_EFFORT_VALUES,
+    validateEffort(s) {
+        return VALID_EFFORTS.has(s);
+    },
+    footerLabel(model, effort) {
+        return effort ? `${model} · ${effort}` : model;
+    },
+    // `reuseSessionId` (if any) keeps the same file path across set_agent
+    // round-trips so prompt-cache continuity and the "one continuous
+    // conversation" UX work the same way they do for claude/codex.
+    writeRollout(opts) {
+        const { sessionId, rolloutPath } = writeMaestroRollout({
+            cwd: opts.cwd,
+            entries: opts.entries,
+            ...(opts.reuseSessionId ? { sessionId: opts.reuseSessionId } : {}),
+        });
+        return { sessionId, rolloutPath };
+    },
+    // Maestro has no SDK fork API. We synthesize a session file from the
+    // provider-agnostic conversation log (same path as `set_agent` cross-agent
+    // bridging). Caveat mirrors codex: extractChatPairs folds tool_use /
+    // tool_result into assistant text as `[Tool: ...]` annotations, so
+    // structural tool history is lost. Acceptable trade-off — the fork starts
+    // with text-level context and the model still sees what ran.
+    async forkSession({ cwd, userId, topicName, groupId }) {
+        const entries = readConversation(userId, topicName, groupId);
+        const { sessionId, rolloutPath } = writeMaestroRollout({ cwd, entries });
+        return { forkId: sessionId, rolloutPath };
+    },
+    // Per-session unlink — no globbing needed since paths are flat under
+    // `~/.maestro/sessions/`. ENOENT is ignored; other I/O errors collect into
+    // an AggregateError so `purgeTopicLogs` can surface them.
+    async cleanupRollouts({ sessionIds }) {
+        if (sessionIds.length === 0)
+            return;
+        const failures = [];
+        for (const sid of sessionIds) {
+            const path = maestroSessionPath(sid);
+            try {
+                unlinkSync(path);
+            }
+            catch (e) {
+                if (e?.code !== "ENOENT") {
+                    logger.warn({ err: e, path }, "maestro cleanupRollouts: unlink failed");
+                    failures.push(e);
+                }
+            }
+        }
+        if (failures.length > 0) {
+            throw new AggregateError(failures, "maestro cleanupRollouts failed");
+        }
+    },
+};
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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