maestro-flow 0.5.35 → 0.5.37

package/dist/src/agents/api-explore/llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../../../../src/agents/api-explore/llm.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAE3G,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE/C,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;CACtD;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,CAAC;CACnB,CAMA;AAMD,wBAAsB,OAAO,CAC3B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,0BAA0B,EAAE,EACtC,KAAK,EAAE,kBAAkB,EAAE,GAC1B,OAAO,CAAC,WAAW,CAAC,CAKtB"}

package/dist/src/agents/api-explore/llm.js

@@ -0,0 +1,184 @@
+import OpenAI from 'openai';
+export function createClient(params) {
+    const client = new OpenAI({
+        apiKey: params.apiKey,
+        baseURL: params.baseUrl,
+    });
+    return { client, config: params };
+}
+// ---------------------------------------------------------------------------
+// Unified call dispatcher
+// ---------------------------------------------------------------------------
+export async function callLlm(client, config, messages, tools) {
+    if (config.format === 'anthropic') {
+        return callAnthropic(config, messages, tools);
+    }
+    return callOpenAi(client, config, messages, tools);
+}
+// ---------------------------------------------------------------------------
+// OpenAI-compatible provider (existing logic)
+// ---------------------------------------------------------------------------
+async function callOpenAi(client, config, messages, tools) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const body = {
+        model: config.model,
+        messages,
+        max_completion_tokens: 2_000,
+        temperature: 0.2,
+        ...config.extraBody,
+    };
+    if (tools.length > 0) {
+        body.tools = tools;
+        body.tool_choice = 'auto';
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const response = await client.chat.completions.create(body);
+    const choice = response.choices?.[0];
+    if (!choice) {
+        throw new Error('No choices returned from LLM API.');
+    }
+    const msg = choice.message;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const toolCalls = (msg.tool_calls ?? [])
+        .filter((tc) => tc.type === 'function')
+        .map((tc) => ({
+        id: tc.id,
+        name: tc.function.name,
+        arguments: tc.function.arguments,
+    }));
+    return {
+        content: msg.content,
+        toolCalls,
+        usage: {
+            inputTokens: response.usage?.prompt_tokens ?? 0,
+            outputTokens: response.usage?.completion_tokens ?? 0,
+        },
+    };
+}
+function openaiToolsToAnthropic(tools) {
+    return tools
+        .filter(t => t.type === 'function')
+        .map(t => ({
+        name: t.function.name,
+        description: t.function.description ?? '',
+        input_schema: (t.function.parameters ?? { type: 'object', properties: {} }),
+    }));
+}
+function openaiMessagesToAnthropic(messages) {
+    let system = '';
+    const result = [];
+    for (const msg of messages) {
+        if (msg.role === 'system') {
+            system += (typeof msg.content === 'string' ? msg.content : '') + '\n';
+            continue;
+        }
+        if (msg.role === 'user') {
+            result.push({ role: 'user', content: typeof msg.content === 'string' ? msg.content : '' });
+            continue;
+        }
+        if (msg.role === 'assistant') {
+            const blocks = [];
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const m = msg;
+            if (m.content) {
+                blocks.push({ type: 'text', text: m.content });
+            }
+            if (m.tool_calls) {
+                for (const tc of m.tool_calls) {
+                    blocks.push({
+                        type: 'tool_use',
+                        id: tc.id,
+                        name: tc.function.name,
+                        input: safeParseJson(tc.function.arguments),
+                    });
+                }
+            }
+            result.push({ role: 'assistant', content: blocks });
+            continue;
+        }
+        if (msg.role === 'tool') {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const m = msg;
+            const toolResult = {
+                type: 'tool_result',
+                tool_use_id: m.tool_call_id,
+                content: typeof m.content === 'string' ? m.content : '',
+            };
+            // Anthropic expects tool_result inside a user message
+            const last = result[result.length - 1];
+            if (last?.role === 'user' && Array.isArray(last.content)) {
+                last.content.push(toolResult);
+            }
+            else {
+                result.push({ role: 'user', content: [toolResult] });
+            }
+            continue;
+        }
+    }
+    return { system: system.trim(), messages: result };
+}
+async function callAnthropic(config, messages, tools) {
+    const { system, messages: anthropicMessages } = openaiMessagesToAnthropic(messages);
+    const anthropicTools = openaiToolsToAnthropic(tools);
+    const baseUrl = config.baseUrl.replace(/\/$/, '');
+    const url = `${baseUrl}/v1/messages`;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const body = {
+        model: config.model,
+        max_tokens: 2000,
+        messages: anthropicMessages,
+        ...config.extraBody,
+    };
+    if (system)
+        body.system = system;
+    if (anthropicTools.length > 0) {
+        body.tools = anthropicTools;
+        body.tool_choice = { type: 'auto' };
+    }
+    const response = await fetch(url, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'x-api-key': config.apiKey,
+            'anthropic-version': '2023-06-01',
+        },
+        body: JSON.stringify(body),
+    });
+    if (!response.ok) {
+        const text = await response.text();
+        throw new Error(`Anthropic API ${response.status}: ${text}`);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const data = await response.json();
+    let content = null;
+    const toolCalls = [];
+    for (const block of data.content ?? []) {
+        if (block.type === 'text') {
+            content = (content ?? '') + block.text;
+        }
+        else if (block.type === 'tool_use') {
+            toolCalls.push({
+                id: block.id,
+                name: block.name,
+                arguments: JSON.stringify(block.input),
+            });
+        }
+    }
+    return {
+        content,
+        toolCalls,
+        usage: {
+            inputTokens: data.usage?.input_tokens ?? 0,
+            outputTokens: data.usage?.output_tokens ?? 0,
+        },
+    };
+}
+function safeParseJson(str) {
+    try {
+        return JSON.parse(str);
+    }
+    catch {
+        return {};
+    }
+}
+//# sourceMappingURL=llm.js.map

package/dist/src/agents/api-explore/llm.js.map

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

package/dist/src/agents/api-explore/prompt-parser.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Structured prompt format for maestro explore:
+ *
+ *   FIND: <what to search for — the core query>
+ *   SCOPE: <file patterns, directories, or modules>
+ *   EXCLUDE: <what to skip — files, patterns, false positives>
+ *   ATTENTION: <caveats, edge cases, things to watch for>
+ *   EXPECTED: <output format — evidence list, summary, JSON>
+ *
+ * Also accepts plain text (passed through unchanged).
+ * Legacy fields PURPOSE/FOCUS/CONSTRAINTS map to FIND/ATTENTION/EXCLUDE.
+ */
+export interface StructuredPrompt {
+    find: string;
+    scope?: string;
+    exclude?: string;
+    attention?: string;
+    expected?: string;
+}
+export declare function isStructuredPrompt(text: string): boolean;
+export declare function parseStructuredPrompt(text: string): StructuredPrompt;
+export declare function buildExplorePrompt(input: string | StructuredPrompt): string;
+//# sourceMappingURL=prompt-parser.d.ts.map

package/dist/src/agents/api-explore/prompt-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-parser.d.ts","sourceRoot":"","sources":["../../../../src/agents/api-explore/prompt-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAmBD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CA6BpE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,GAAG,MAAM,CAY3E"}

package/dist/src/agents/api-explore/prompt-parser.js

@@ -0,0 +1,73 @@
+/**
+ * Structured prompt format for maestro explore:
+ *
+ *   FIND: <what to search for — the core query>
+ *   SCOPE: <file patterns, directories, or modules>
+ *   EXCLUDE: <what to skip — files, patterns, false positives>
+ *   ATTENTION: <caveats, edge cases, things to watch for>
+ *   EXPECTED: <output format — evidence list, summary, JSON>
+ *
+ * Also accepts plain text (passed through unchanged).
+ * Legacy fields PURPOSE/FOCUS/CONSTRAINTS map to FIND/ATTENTION/EXCLUDE.
+ */
+const FIELD_MAP = {
+    FIND: 'find',
+    SCOPE: 'scope',
+    EXCLUDE: 'exclude',
+    ATTENTION: 'attention',
+    EXPECTED: 'expected',
+    // Legacy aliases
+    PURPOSE: 'find',
+    FOCUS: 'attention',
+    CONSTRAINTS: 'exclude',
+};
+const FIELD_PATTERN = new RegExp(`^(${Object.keys(FIELD_MAP).join('|')})\\s*:\\s*(.*)`, 'i');
+export function isStructuredPrompt(text) {
+    return /^(FIND|PURPOSE)\s*:/im.test(text);
+}
+export function parseStructuredPrompt(text) {
+    const fields = {};
+    let currentKey = null;
+    const lines = [];
+    for (const line of text.split('\n')) {
+        const match = line.match(FIELD_PATTERN);
+        if (match) {
+            if (currentKey && lines.length > 0) {
+                fields[currentKey] = lines.join('\n').trim();
+                lines.length = 0;
+            }
+            currentKey = FIELD_MAP[match[1].toUpperCase()] ?? null;
+            if (match[2].trim())
+                lines.push(match[2].trim());
+        }
+        else if (currentKey) {
+            lines.push(line);
+        }
+    }
+    if (currentKey && lines.length > 0) {
+        fields[currentKey] = lines.join('\n').trim();
+    }
+    return {
+        find: fields.find ?? text.trim(),
+        scope: fields.scope,
+        exclude: fields.exclude,
+        attention: fields.attention,
+        expected: fields.expected,
+    };
+}
+export function buildExplorePrompt(input) {
+    const parsed = typeof input === 'string'
+        ? (isStructuredPrompt(input) ? parseStructuredPrompt(input) : { find: input })
+        : input;
+    const parts = [`Find: ${parsed.find}`];
+    if (parsed.scope)
+        parts.push(`Scope: ${parsed.scope}`);
+    if (parsed.exclude)
+        parts.push(`Exclude: ${parsed.exclude}`);
+    if (parsed.attention)
+        parts.push(`Attention: ${parsed.attention}`);
+    if (parsed.expected)
+        parts.push(`Expected output: ${parsed.expected}`);
+    return parts.join('\n');
+}
+//# sourceMappingURL=prompt-parser.js.map

package/dist/src/agents/api-explore/prompt-parser.js.map

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

package/dist/src/agents/api-explore/runner.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Parallel explore runner.
+ *
+ * Execution model: serial within same endpoint, parallel across endpoints.
+ * Each endpoint gets its own queue; jobs in the same queue run one-by-one.
+ * Different endpoint queues run concurrently.
+ *
+ * Per-endpoint concurrency can be raised via `endpointConcurrency` option
+ * (default 1 = fully serial per endpoint).
+ */
+import { type LlmConfig } from './llm.js';
+export interface ExploreJob {
+    id: string;
+    prompt: string;
+    endpointName: string;
+    llmConfig: LlmConfig;
+    /** Per-endpoint maxTurns override */
+    maxTurns?: number;
+}
+export interface ExploreResult {
+    id: string;
+    prompt: string;
+    endpointName: string;
+    model: string;
+    content: string | null;
+    error?: string;
+    durationMs: number;
+}
+export interface RunnerOptions {
+    jobs: ExploreJob[];
+    cwd: string;
+    maxTurns: number;
+    /** Max concurrent endpoint queues (default: number of distinct endpoints) */
+    concurrency: number;
+    /** Max concurrent jobs within the same endpoint (default: 1 = serial) */
+    endpointConcurrency?: number;
+    onProgress?: (msg: string) => void;
+    onJobStart?: (job: ExploreJob) => void;
+    onJobDone?: (result: ExploreResult) => void;
+}
+/**
+ * Run explore jobs: serial within same endpoint, parallel across endpoints.
+ */
+export declare function runExploreJobs(opts: RunnerOptions): Promise<ExploreResult[]>;
+export interface PromptEntry {
+    prompt: string;
+    endpoint?: string;
+}
+type NamedEndpoint = {
+    name: string;
+    llmConfig: LlmConfig;
+    maxTurns?: number;
+};
+/**
+ * Build job list from prompt entries. Default: 1 prompt = 1 agent (first endpoint).
+ * Per-prompt `endpoint` field overrides the global endpoint selection.
+ */
+export declare function buildJobsFromEntries(entries: PromptEntry[], globalEndpoints: NamedEndpoint[], allEndpoints: NamedEndpoint[]): ExploreJob[];
+/**
+ * Build job list from prompts × endpoints cartesian product.
+ * Used when --all flag fans one prompt to every endpoint.
+ */
+export declare function buildJobs(prompts: string[], endpoints: NamedEndpoint[]): ExploreJob[];
+export {};
+//# sourceMappingURL=runner.d.ts.map

package/dist/src/agents/api-explore/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../../src/agents/api-explore/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAgB,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAMxD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,SAAS,CAAC;IACrB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,WAAW,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,CAAC;IACvC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,CAAC;CAC7C;AAuGD;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAyDlF;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,KAAK,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/E;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,WAAW,EAAE,EACtB,eAAe,EAAE,aAAa,EAAE,EAChC,YAAY,EAAE,aAAa,EAAE,GAC5B,UAAU,EAAE,CAkCd;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,EAAE,aAAa,EAAE,GACzB,UAAU,EAAE,CAkBd"}

package/dist/src/agents/api-explore/runner.js

@@ -0,0 +1,196 @@
+/**
+ * Parallel explore runner.
+ *
+ * Execution model: serial within same endpoint, parallel across endpoints.
+ * Each endpoint gets its own queue; jobs in the same queue run one-by-one.
+ * Different endpoint queues run concurrently.
+ *
+ * Per-endpoint concurrency can be raised via `endpointConcurrency` option
+ * (default 1 = fully serial per endpoint).
+ */
+import { readdirSync } from 'node:fs';
+import { createClient } from './llm.js';
+import { TOOL_SCHEMAS } from './tools.js';
+import { buildSystemPrompt } from './system-prompt.js';
+import { agentLoop } from './agent-loop.js';
+import { buildExplorePrompt } from './prompt-parser.js';
+function getDirListing(cwd) {
+    try {
+        return readdirSync(cwd)
+            .filter(name => !name.startsWith('.'))
+            .slice(0, 50)
+            .join('\n');
+    }
+    catch {
+        return '(unable to list directory)';
+    }
+}
+async function runSingleJob(job, cwd, globalMaxTurns, dirListing) {
+    const start = Date.now();
+    const maxTurns = job.maxTurns ?? globalMaxTurns;
+    try {
+        const { client, config } = createClient(job.llmConfig);
+        const systemPrompt = buildSystemPrompt(cwd, dirListing);
+        const prompt = buildExplorePrompt(job.prompt);
+        const content = await agentLoop({
+            prompt,
+            systemPrompt,
+            client,
+            llmConfig: config,
+            toolSchemas: TOOL_SCHEMAS,
+            maxTurns,
+            cwd,
+        });
+        return {
+            id: job.id,
+            prompt: job.prompt,
+            endpointName: job.endpointName,
+            model: job.llmConfig.model,
+            content,
+            durationMs: Date.now() - start,
+        };
+    }
+    catch (err) {
+        return {
+            id: job.id,
+            prompt: job.prompt,
+            endpointName: job.endpointName,
+            model: job.llmConfig.model,
+            content: null,
+            error: err instanceof Error ? err.message : String(err),
+            durationMs: Date.now() - start,
+        };
+    }
+}
+/**
+ * Drain a queue of jobs with a per-queue concurrency limit.
+ * concurrency=1 means strict serial within this queue.
+ */
+async function drainQueue(queue, concurrency, cwd, maxTurns, dirListing, totalJobs, jobIndexMap, callbacks) {
+    const results = [];
+    let nextIdx = 0;
+    async function runSlot() {
+        while (nextIdx < queue.length) {
+            const localIdx = nextIdx++;
+            const job = queue[localIdx];
+            const globalIdx = jobIndexMap.get(job.id) ?? localIdx;
+            callbacks.onJobStart?.(job);
+            callbacks.onProgress?.(`[${globalIdx + 1}/${totalJobs}] ${job.endpointName}:${job.llmConfig.model} — starting`);
+            const result = await runSingleJob(job, cwd, maxTurns, dirListing);
+            results.push(result);
+            callbacks.onJobDone?.(result);
+            const status = result.error
+                ? `ERROR: ${result.error}`
+                : `done (${(result.durationMs / 1000).toFixed(1)}s)`;
+            callbacks.onProgress?.(`[${globalIdx + 1}/${totalJobs}] ${job.endpointName}:${job.llmConfig.model} — ${status}`);
+        }
+    }
+    const slots = Math.min(concurrency, queue.length);
+    await Promise.allSettled(Array.from({ length: slots }, () => runSlot()));
+    return results;
+}
+/**
+ * Run explore jobs: serial within same endpoint, parallel across endpoints.
+ */
+export async function runExploreJobs(opts) {
+    const { jobs, cwd, maxTurns, concurrency, endpointConcurrency = 1, onProgress, onJobStart, onJobDone, } = opts;
+    if (jobs.length === 0)
+        return [];
+    const dirListing = getDirListing(cwd);
+    // Group jobs by endpoint
+    const queues = new Map();
+    const jobIndexMap = new Map();
+    for (let i = 0; i < jobs.length; i++) {
+        const job = jobs[i];
+        jobIndexMap.set(job.id, i);
+        let q = queues.get(job.endpointName);
+        if (!q) {
+            q = [];
+            queues.set(job.endpointName, q);
+        }
+        q.push(job);
+    }
+    const endpointNames = [...queues.keys()];
+    onProgress?.(`Scheduling: ${endpointNames.length} endpoint(s), ${endpointConcurrency} job(s)/endpoint, ${concurrency} max parallel`);
+    // Suppress stream-json-emitter NDJSON stdout writes
+    const origStdoutWrite = process.stdout.write.bind(process.stdout);
+    process.stdout.write = (() => true);
+    // Run endpoint queues in parallel, capped by concurrency
+    const allResults = [];
+    const queueEntries = [...queues.entries()];
+    let nextQueue = 0;
+    async function runEndpointSlot() {
+        while (nextQueue < queueEntries.length) {
+            const idx = nextQueue++;
+            const [, queue] = queueEntries[idx];
+            const results = await drainQueue(queue, endpointConcurrency, cwd, maxTurns, dirListing, jobs.length, jobIndexMap, { onProgress, onJobStart, onJobDone });
+            allResults.push(...results);
+        }
+    }
+    const endpointSlots = Math.min(concurrency, queueEntries.length);
+    await Promise.allSettled(Array.from({ length: endpointSlots }, () => runEndpointSlot()));
+    process.stdout.write = origStdoutWrite;
+    // Return in original job order
+    const resultMap = new Map(allResults.map(r => [r.id, r]));
+    return jobs.map(j => resultMap.get(j.id)).filter(Boolean);
+}
+/**
+ * Build job list from prompt entries. Default: 1 prompt = 1 agent (first endpoint).
+ * Per-prompt `endpoint` field overrides the global endpoint selection.
+ */
+export function buildJobsFromEntries(entries, globalEndpoints, allEndpoints) {
+    const jobs = [];
+    let counter = 0;
+    const endpointMap = new Map();
+    for (const ep of allEndpoints)
+        endpointMap.set(ep.name, ep);
+    for (const ep of globalEndpoints)
+        endpointMap.set(ep.name, ep);
+    for (const entry of entries) {
+        let targets;
+        if (entry.endpoint) {
+            const names = entry.endpoint.split(',').map(s => s.trim()).filter(Boolean);
+            targets = names
+                .map(n => endpointMap.get(n))
+                .filter((ep) => ep !== undefined);
+            if (targets.length === 0)
+                targets = [globalEndpoints[0]];
+        }
+        else {
+            targets = [globalEndpoints[0]];
+        }
+        for (const ep of targets) {
+            counter++;
+            jobs.push({
+                id: `explore-${counter}`,
+                prompt: entry.prompt,
+                endpointName: ep.name,
+                llmConfig: ep.llmConfig,
+                maxTurns: ep.maxTurns,
+            });
+        }
+    }
+    return jobs;
+}
+/**
+ * Build job list from prompts × endpoints cartesian product.
+ * Used when --all flag fans one prompt to every endpoint.
+ */
+export function buildJobs(prompts, endpoints) {
+    const jobs = [];
+    let counter = 0;
+    for (const prompt of prompts) {
+        for (const ep of endpoints) {
+            counter++;
+            jobs.push({
+                id: `explore-${counter}`,
+                prompt,
+                endpointName: ep.name,
+                llmConfig: ep.llmConfig,
+                maxTurns: ep.maxTurns,
+            });
+        }
+    }
+    return jobs;
+}
+//# sourceMappingURL=runner.js.map

package/dist/src/agents/api-explore/runner.js.map

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

package/dist/src/agents/api-explore/session.d.ts

@@ -0,0 +1,23 @@
+import type { ExploreResult } from './runner.js';
+export interface ExploreSession {
+    id: string;
+    startedAt: string;
+    cwd: string;
+    prompts: string[];
+    endpoints: string[];
+    totalJobs: number;
+    concurrency: number;
+    maxTurns: number;
+    durationMs: number;
+    results: ExploreResult[];
+}
+export declare function generateSessionId(): string;
+export declare function saveSession(session: ExploreSession, outputDir?: string): string;
+export declare function loadSession(cwd: string, sessionId: string, outputDir?: string): ExploreSession | null;
+export declare function listSessions(cwd: string, outputDir?: string): Array<{
+    id: string;
+    startedAt: string;
+    prompts: number;
+    durationMs: number;
+}>;
+//# sourceMappingURL=session.d.ts.map

package/dist/src/agents/api-explore/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../../src/agents/api-explore/session.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAMD,wBAAgB,iBAAiB,IAAI,MAAM,CAa1C;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,cAAc,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAO/E;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CASrG;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAgB3I"}