@zhixuan92/multi-model-agent-mcp 0.4.0 → 1.1.0

package/dist/routing/render-provider-routing-matrix.js

@@ -1,26 +1,19 @@
-import { getBaseCapabilities } from '@zhixuan92/multi-model-agent-core/routing/capabilities';
-import { findModelProfile, getEffectiveCostTier } from '@zhixuan92/multi-model-agent-core/routing/model-profiles';
+import { findModelCapabilities, findModelProfile } from '@zhixuan92/multi-model-agent-core/routing/model-profiles';
 const ROUTING_RECIPE = `How to route a task:
-1. Capability filter (HARD): exclude providers missing any required capability.
-2. Quality filter: exclude providers whose tier is below the task's tier.
-   Tier ordering: trivial < standard < reasoning.
-3. Cost preference (STRONG): among the remainder, prefer the cheapest tier.
-   If a 'free' provider qualifies, pick it. Only escalate to paid tiers when
-   the task tier or required capabilities demand it.
+1. Select the agent type based on required capabilities.
+2. If the selected agent lacks required capabilities, auto-escalate to the other agent type.
+3. Among available agents, prefer the one that meets capability requirements.
 
-Tier guidance for the consumer LLM:
-- 'trivial' — well-defined edits, lookups, formatting. One obvious answer.
+Agent guidance:
 - 'standard' — most code work. Clear spec, multiple valid approaches.
-- 'reasoning' — ambiguous, architectural, research, or high-stakes.
-  Use when requirements are unclear or judgment is required.
+- 'complex' — ambiguous, architectural, research, or high-stakes tasks requiring more reasoning.
 
 Optional 'effort' knob (per task):
-- Only providers marked 'effort: supported' in the matrix honor this field.
-- Use 'high' for reasoning-tier tasks when you want maximum depth,
+- Only agents marked 'effort: supported' in the matrix honor this field.
+- Use 'high' for complex tasks when you want maximum depth,
   'medium' for balanced, 'low' for fast-but-shallow, 'none' to disable
-  thinking entirely on providers that default it on. Omit the field on
-  providers that do not support it.`;
-const TOOL_NOTES = `Sub-agent tool notes (apply to every provider):
+  thinking entirely on agents that default it on.`;
+const TOOL_NOTES = `Sub-agent tool notes (apply to every agent):
 - 'grep' accepts a file OR a directory. When given a directory it searches
   recursively (output is prefixed file:line). Prefer one recursive grep over
   many readFile calls when the worker needs to find usages or patterns.
@@ -28,19 +21,18 @@ const TOOL_NOTES = `Sub-agent tool notes (apply to every provider):
   otherwise salvaged from a running scratchpad. You ALWAYS get text back,
   even on 'incomplete' / 'timeout' / 'api_error' / 'network_error' paths.
 - Tasks that need shell ('pnpm', 'pytest', 'tsc', 'git') only work on
-  providers configured with sandboxPolicy: 'none'. Otherwise keep shell
+  agents configured with sandboxPolicy: 'none'. Otherwise keep shell
   work on the parent session, not in a delegated sub-agent.
 
 Escalation, statuses, streaming, and batch helpers:
-- Auto-routed tasks (no 'provider' set) walk the full capability+tier
-  chain cheapest-first on failure. The chain stops at the first 'ok'.
-  If every provider fails, the best salvage is returned and the
-  per-task 'escalationLog' shows every attempt. Explicit pins
-  ('provider' set) run as a single attempt — pinning opts out.
+- Auto-routed tasks (no 'agentType' set) use 'standard' agent.
+- If the selected agent lacks required capabilities, auto-escalate to 'complex'.
+- If every agent fails, the best salvage is returned and the
+  per-task 'escalationLog' shows every attempt.
 - Status values: 'ok', 'incomplete', 'max_turns', 'timeout',
   'api_aborted', 'api_error', 'network_error', 'error'.
   'incomplete' = scratchpad salvage after a degenerate completion;
-  'api_aborted' = provider-side abort; 'api_error' = HTTP error with
+  'api_aborted' = agent-side abort; 'api_error' = HTTP error with
   a numeric .status; 'network_error' = transport failure
   (ECONNREFUSED / ENOTFOUND / /network/i).
 - Streaming: if your MCP client passes '_meta.progressToken' on the
@@ -59,22 +51,21 @@ Escalation, statuses, streaming, and batch helpers:
   shared across multiple tasks are sent to the parent session only
   once.
 
-RESPONSE SHAPE (v0.3+): Every delegate_tasks response includes a top-level
+RESPONSE SHAPE (v1.0+): Every delegate_tasks response includes a top-level
 batchId, mode ('full' or 'summary'), timings ({wallClockMs, sumOfTaskMs,
 estimatedParallelSavingsMs}), batchProgress ({totalTasks, completedTasks,
 incompleteTasks, failedTasks, successPercent}), and aggregateCost
-({totalActualCostUSD, totalSavedCostUSD, actualCostUnavailableTasks,
-savedCostUnavailableTasks}). If the combined output across tasks is small,
+({totalActualCostUSD, totalSavedCostUSD}). If the combined output across tasks is small,
 mode: 'full' with inline outputs; if it exceeds the server's threshold
 (default 64 KB, configurable via env MULTI_MODEL_LARGE_RESPONSE_THRESHOLD_CHARS
 / config defaults.largeResponseThresholdChars / buildMcpServer option),
-mode: 'summary' with per-task outputLength + outputSha256 + _fetchOutputWith
-hint — fetch individual outputs with get_task_output({ batchId, taskIndex }),
-or per-task metadata with get_task_detail({ batchId, taskIndex }).
+mode: 'summary' with per-task outputLength + outputSha256 + _fetchWith
+hint — fetch individual outputs with get_batch_slice({ batchId, slice: 'output', taskIndex }),
+or per-task details with get_batch_slice({ batchId, slice: 'detail', taskIndex }).
 Set responseMode: 'full' to force inline, 'summary' to force summary, or
 omit for auto-escape.
 
-COVERAGE DECLARATION (v0.3+): For tasks with enumerable deliverables
+COVERAGE DECLARATION (v1.0+): For tasks with enumerable deliverables
 (multi-file refactors, test generation across many functions, multi-PR
 review, per-endpoint reports, per-function test stubs, audit checklists),
 set expectedCoverage on the task spec with either minSections: N,
@@ -86,7 +77,7 @@ Do NOT set expectedCoverage for one-shot tasks (bug fixes, single
 implementations, prose, creative writing) — the field is opt-in and has
 no meaning for deliverables you can't enumerate ahead of time.
 
-COST + TIME VISIBILITY (v0.3+): Set parentModel on the task spec (e.g.
+COST + TIME VISIBILITY (v1.0+): Set parentModel on the task spec (e.g.
 'claude-opus-4-6') to get usage.savedCostUSD — the ESTIMATED cost
 difference vs running the same token volume on that parent model.
 Positive means delegation was cheaper. Both usage.costUSD (actual) and
@@ -98,39 +89,17 @@ serial for-loop. batchProgress.successPercent is a clean-success rate
 (the batch is always 100% done by the time you see the response —
 successPercent measures how many finished cleanly, NOT progress).
 
-PROGRESS TRACE (v0.3+): Set includeProgressTrace: true on the task spec
-to receive a bounded, priority-trimmed trace of the execution timeline
-in the final RunResult.progressTrace. Useful for post-hoc debugging of
-long-running tasks — did the worker loop through supervision retries,
-where did it stall, did it escalate across providers. The trace is
-trimmed at 80 events and 16 KB; text_emission and tool_call events are
-dropped first under pressure (their content is already in output /
-toolCalls). Boundary events (turn_start, turn_complete, escalation_start,
-injection, done) are never dropped. If trimming fired, a synthetic
-_trimmed marker at the end of the trace reports the dropped count and
-per-kind histogram.
-
-NOTE: progress-events at the MCP protocol level (notifications/progress)
-are emitted correctly by the server and delivered to the MCP client.
-Whether your client renders them live depends on the client — some
-render them as in-flight tool-call status lines, others don't surface
-them to the calling LLM at all. includeProgressTrace gives you the
-full timeline post-hoc regardless of your client's live-rendering
-behavior.
-
 AVAILABLE TOOLS: delegate_tasks (this one), register_context_block
 (stash reusable brief content referenced via TaskSpec.contextBlockIds),
 retry_tasks (re-dispatch specific indices from a previous batch),
-get_task_output (fetch individual task outputs when a response was in
-summary mode).`;
-function renderProviderBlock(name, config, capabilities, profile, costSource) {
-    const cost = getEffectiveCostTier(config);
-    const costSuffix = costSource === 'config' ? ' (from config)' : '';
+get_batch_slice (fetch outputs/details/telemetry when a response was in
+summary mode or for per-task introspection).`;
+function renderAgentBlock(name, config, capabilities, profile) {
     const effortLabel = profile.supportsEffort ? 'supported' : 'not supported';
     const lines = [
         `${name} (${config.model})`,
-        `  tools: ${capabilities.join(', ')}`,
-        `  tier: ${profile.tier} | cost: ${cost}${costSuffix} | effort: ${effortLabel}`,
+        `  capabilities: ${capabilities.join(', ') || '(none)'}`,
+        `  cost: ${profile.defaultCost} | effort: ${effortLabel}`,
         `  best for: ${profile.bestFor}`,
     ];
     if (profile.notes) {
@@ -143,20 +112,22 @@ function renderProviderBlock(name, config, capabilities, profile, costSource) {
 }
 /**
  * Renders the full routing matrix for the MCP tool description.
- * Helps the consuming LLM understand provider capabilities and routing rules.
+ * Helps the consuming LLM understand agent capabilities and routing rules.
  */
 export function renderProviderRoutingMatrix(config) {
-    const blocks = Object.entries(config.providers).map(([name, providerConfig]) => {
-        const capabilities = getBaseCapabilities(providerConfig);
-        const profile = findModelProfile(providerConfig.model);
-        const costSource = providerConfig.costTier ? 'config' : 'default';
-        return renderProviderBlock(name, providerConfig, capabilities, profile, costSource);
+    if (!config.agents) {
+        return 'No agents configured.';
+    }
+    const blocks = Object.entries(config.agents).map(([name, agentConfig]) => {
+        const capabilities = agentConfig.capabilities ?? findModelCapabilities(agentConfig.model);
+        const profile = findModelProfile(agentConfig.model);
+        return renderAgentBlock(name, agentConfig, capabilities, profile);
     });
     return [
-        'Delegate tasks to sub-agents running on different LLM providers.',
+        'Delegate tasks to sub-agents running on different LLM models.',
         'All tasks execute concurrently.',
         '',
-        'Available providers:',
+        'Available agents:',
         '',
         blocks.join('\n\n'),
         '',

package/dist/routing/render-provider-routing-matrix.js.map

@@ -1 +1 @@
-{"version":3,"file":"render-provider-routing-matrix.js","sourceRoot":"","sources":["../../src/routing/render-provider-routing-matrix.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wDAAwD,CAAC;AAC7F,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,0DAA0D,CAAC;AAGlH,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;oCAmBa,CAAC;AAErC,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eAsGJ,CAAC;AAEhB,SAAS,mBAAmB,CAC1B,IAAY,EACZ,MAAsB,EACtB,YAA0B,EAC1B,OAAqB,EACrB,UAAgC;IAEhC,MAAM,IAAI,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,UAAU,GAAG,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,MAAM,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,eAAe,CAAC;IAC3E,MAAM,KAAK,GAAG;QACZ,GAAG,IAAI,KAAK,MAAM,CAAC,KAAK,GAAG;QAC3B,YAAY,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACrC,WAAW,OAAO,CAAC,IAAI,YAAY,IAAI,GAAG,UAAU,cAAc,WAAW,EAAE;QAC/E,eAAe,OAAO,CAAC,OAAO,EAAE;KACjC,CAAC;IACF,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,gBAAgB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAAwB;IAClE,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,EAAE;QAC7E,MAAM,YAAY,GAAG,mBAAmB,CAAC,cAAc,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,gBAAgB,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QACvD,MAAM,UAAU,GAAyB,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;QACxF,OAAO,mBAAmB,CAAC,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,kEAAkE;QAClE,iCAAiC;QACjC,EAAE;QACF,sBAAsB;QACtB,EAAE;QACF,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;QACnB,EAAE;QACF,cAAc;QACd,EAAE;QACF,UAAU;KACX,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}
+{"version":3,"file":"render-provider-routing-matrix.js","sourceRoot":"","sources":["../../src/routing/render-provider-routing-matrix.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,0DAA0D,CAAC;AAGnH,MAAM,cAAc,GAAG;;;;;;;;;;;;;kDAa2B,CAAC;AAEnD,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6CAgF0B,CAAC;AAE9C,SAAS,gBAAgB,CACvB,IAAY,EACZ,MAAmB,EACnB,YAA4C,EAC5C,OAAqB;IAErB,MAAM,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,eAAe,CAAC;IAC3E,MAAM,KAAK,GAAG;QACZ,GAAG,IAAI,KAAK,MAAM,CAAC,KAAK,GAAG;QAC3B,mBAAmB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE;QACxD,WAAW,OAAO,CAAC,WAAW,cAAc,WAAW,EAAE;QACzD,eAAe,OAAO,CAAC,OAAO,EAAE;KACjC,CAAC;IACF,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,gBAAgB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAAwB;IAClE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO,uBAAuB,CAAC;IACjC,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,EAAE;QACvE,MAAM,YAAY,GAAG,WAAW,CAAC,YAAY,IAAI,qBAAqB,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAC1F,MAAM,OAAO,GAAG,gBAAgB,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACpD,OAAO,gBAAgB,CAAC,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,+DAA+D;QAC/D,iCAAiC;QACjC,EAAE;QACF,mBAAmB;QACnB,EAAE;QACF,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;QACnB,EAAE;QACF,cAAc;QACd,EAAE;QACF,UAAU;KACX,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/tools/audit-document.d.ts

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { MultiModelConfig } from '@zhixuan92/multi-model-agent-core';
+export declare const auditDocumentSchema: z.ZodObject<{
+    filePaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    cwd: z.ZodOptional<z.ZodString>;
+    contextBlockIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tools: z.ZodOptional<z.ZodEnum<{
+        readonly: "readonly";
+        none: "none";
+        full: "full";
+    }>>;
+    document: z.ZodOptional<z.ZodString>;
+    auditType: z.ZodUnion<readonly [z.ZodEnum<{
+        security: "security";
+        performance: "performance";
+        correctness: "correctness";
+        style: "style";
+        general: "general";
+    }>, z.ZodArray<z.ZodEnum<{
+        security: "security";
+        performance: "performance";
+        correctness: "correctness";
+        style: "style";
+    }>>]>;
+    outputFormat: z.ZodOptional<z.ZodEnum<{
+        json: "json";
+        markdown: "markdown";
+    }>>;
+    agentType: z.ZodOptional<z.ZodEnum<{
+        standard: "standard";
+        complex: "complex";
+    }>>;
+}, z.core.$strip>;
+export type AuditDocumentParams = z.infer<typeof auditDocumentSchema>;
+export declare function registerAuditDocument(server: McpServer, config: MultiModelConfig): void;
+//# sourceMappingURL=audit-document.d.ts.map

package/dist/tools/audit-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-document.d.ts","sourceRoot":"","sources":["../../src/tools/audit-document.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAY,MAAM,mCAAmC,CAAC;AAapF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAU9B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAyBtE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,QAmDhF"}

package/dist/tools/audit-document.js

@@ -0,0 +1,76 @@
+import { z } from 'zod';
+import { runTasks } from '@zhixuan92/multi-model-agent-core/run-tasks';
+import { commonToolFields, validateInput, resolveDispatchMode, buildMetadataBlock, buildFilePathsPrompt, buildPerFilePrompt, applyCommonFields, } from './shared.js';
+import { buildFanOutResponse } from './batch-response.js';
+export const auditDocumentSchema = z.object({
+    document: z.string().optional().describe('Inline document content to audit'),
+    auditType: z.union([
+        z.enum(['security', 'performance', 'correctness', 'style', 'general']),
+        z.array(z.enum(['security', 'performance', 'correctness', 'style'])).min(1),
+    ]).describe('Audit focus. Single string or array of types. "general" = all four categories.'),
+    outputFormat: z.enum(['json', 'markdown']).optional()
+        .describe('Output format. json returns structured findings array.'),
+    agentType: z.enum(['standard', 'complex']).optional(),
+    ...commonToolFields,
+});
+function resolveAuditTypeText(auditType) {
+    if (auditType === 'general')
+        return 'security, performance, correctness, and style';
+    if (Array.isArray(auditType))
+        return auditType.join(', ');
+    return auditType;
+}
+function buildAuditPrompt(auditTypeText, document, filePaths, outputFormat) {
+    const parts = [`Audit for ${auditTypeText} issues.`];
+    if (outputFormat === 'json') {
+        parts.push('Return findings as a JSON array of objects with keys: severity, category, finding, recommendation.');
+    }
+    if (document)
+        parts.push(`Document:\n\n${document}`);
+    const fileSection = buildFilePathsPrompt(filePaths);
+    if (fileSection)
+        parts.push(fileSection);
+    parts.push('Provide a structured audit report with findings and severity.');
+    return parts.join('\n\n');
+}
+export function registerAuditDocument(server, config) {
+    server.tool('audit_document', 'Audit documents or files for issues. Accepts inline content or file paths \u2014 multiple files are audited in parallel, each as a separate task. Preset: complex agent, no review pipeline. Use this for any audit task. Use delegate_tasks only for custom pipeline config or tasks that don\'t match a specialized tool.', auditDocumentSchema.shape, async (params) => {
+        const validation = validateInput(params.document, params.filePaths);
+        if (!validation.valid) {
+            return { content: [{ type: 'text', text: `Error: ${validation.message}` }], isError: true };
+        }
+        const agentType = params.agentType ?? 'complex';
+        const auditTypeText = resolveAuditTypeText(params.auditType);
+        const baseTaskSpec = applyCommonFields({
+            agentType,
+            reviewPolicy: 'off',
+            ...(params.outputFormat && { formatConstraints: { outputFormat: params.outputFormat } }),
+        }, params);
+        try {
+            const mode = resolveDispatchMode(params.document, params.filePaths);
+            if (mode === 'fan_out') {
+                const validPaths = params.filePaths.filter(p => p.trim().length > 0);
+                const promptTemplate = buildAuditPrompt(auditTypeText, undefined, undefined, params.outputFormat);
+                const tasks = validPaths.map(fp => ({
+                    ...baseTaskSpec,
+                    prompt: buildPerFilePrompt(fp, promptTemplate),
+                }));
+                const startMs = Date.now();
+                const results = await runTasks(tasks, config);
+                return { content: [buildFanOutResponse(results, tasks, Date.now() - startMs)] };
+            }
+            // Single-task mode
+            const prompt = buildAuditPrompt(auditTypeText, params.document, params.filePaths, params.outputFormat);
+            const results = await runTasks([{ ...baseTaskSpec, prompt }], config);
+            const result = results[0];
+            return { content: [{ type: 'text', text: result.output }, buildMetadataBlock(result)] };
+        }
+        catch (err) {
+            return {
+                content: [{ type: 'text', text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=audit-document.js.map

package/dist/tools/audit-document.js.map

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

package/dist/tools/batch-response.d.ts

@@ -0,0 +1,21 @@
+import type { RunResult, TaskSpec, BatchTimings, BatchProgress, BatchAggregateCost } from '@zhixuan92/multi-model-agent-core';
+/**
+ * Compute per-batch timing metrics.
+ */
+export declare function computeTimings(wallClockMs: number, results: RunResult[]): BatchTimings;
+/**
+ * Compute per-batch progress summary.
+ */
+export declare function computeBatchProgress(results: RunResult[]): BatchProgress;
+/**
+ * Compute aggregate cost across all tasks.
+ */
+export declare function computeAggregateCost(results: RunResult[]): BatchAggregateCost;
+/**
+ * Build a fan-out response for specialized tools. No batchId (not cache-backed).
+ */
+export declare function buildFanOutResponse(results: RunResult[], tasks: TaskSpec[], wallClockMs: number): {
+    type: 'text';
+    text: string;
+};
+//# sourceMappingURL=batch-response.d.ts.map

package/dist/tools/batch-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-response.d.ts","sourceRoot":"","sources":["../../src/tools/batch-response.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,kBAAkB,EACnB,MAAM,mCAAmC,CAAC;AAE3C;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,YAAY,CAItF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,aAAa,CAgBxE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,kBAAkB,CAiB7E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,SAAS,EAAE,EACpB,KAAK,EAAE,QAAQ,EAAE,EACjB,WAAW,EAAE,MAAM,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAiChC"}

package/dist/tools/batch-response.js

@@ -0,0 +1,78 @@
+/**
+ * Compute per-batch timing metrics.
+ */
+export function computeTimings(wallClockMs, results) {
+    const sumOfTaskMs = results.reduce((sum, r) => sum + (r.durationMs ?? 0), 0);
+    const estimatedParallelSavingsMs = Math.max(0, sumOfTaskMs - wallClockMs);
+    return { wallClockMs, sumOfTaskMs, estimatedParallelSavingsMs };
+}
+/**
+ * Compute per-batch progress summary.
+ */
+export function computeBatchProgress(results) {
+    const totalTasks = results.length;
+    const completedTasks = results.filter((r) => r.status === 'ok').length;
+    const incompleteTasks = results.filter((r) => r.status === 'incomplete' || r.status === 'max_turns' || r.status === 'timeout').length;
+    const failedTasks = results.filter((r) => r.status === 'error' ||
+        r.status === 'api_aborted' ||
+        r.status === 'api_error' ||
+        r.status === 'network_error').length;
+    const successPercent = totalTasks === 0 ? 0 : Math.round((completedTasks / totalTasks) * 1000) / 10;
+    return { totalTasks, completedTasks, incompleteTasks, failedTasks, successPercent };
+}
+/**
+ * Compute aggregate cost across all tasks.
+ */
+export function computeAggregateCost(results) {
+    let totalActualCostUSD = 0;
+    let totalSavedCostUSD = 0;
+    for (const r of results) {
+        if (r.usage.costUSD !== null && r.usage.costUSD !== undefined) {
+            totalActualCostUSD += r.usage.costUSD;
+        }
+        if (r.usage.savedCostUSD !== null && r.usage.savedCostUSD !== undefined) {
+            totalSavedCostUSD += r.usage.savedCostUSD;
+        }
+    }
+    return {
+        totalActualCostUSD,
+        totalSavedCostUSD,
+    };
+}
+/**
+ * Build a fan-out response for specialized tools. No batchId (not cache-backed).
+ */
+export function buildFanOutResponse(results, tasks, wallClockMs) {
+    const timings = computeTimings(wallClockMs, results);
+    const batchProgress = computeBatchProgress(results);
+    const aggregateCost = computeAggregateCost(results);
+    return {
+        type: 'text',
+        text: JSON.stringify({
+            schemaVersion: '1.0.0',
+            mode: 'fan_out',
+            timings,
+            batchProgress,
+            aggregateCost,
+            results: results.map((r, i) => ({
+                agentType: tasks[i]?.agentType ?? '(auto)',
+                status: r.status,
+                output: r.output,
+                turns: r.turns,
+                durationMs: r.durationMs,
+                filesRead: r.filesRead,
+                filesWritten: r.filesWritten,
+                directoriesListed: r.directoriesListed,
+                toolCalls: r.toolCalls,
+                escalationLog: r.escalationLog,
+                usage: r.usage,
+                workerStatus: r.workerStatus,
+                specReviewStatus: r.specReviewStatus,
+                qualityReviewStatus: r.qualityReviewStatus,
+                agents: r.agents,
+                ...(r.error && { error: r.error }),
+            })),
+        }, null, 2),
+    };
+}
+//# sourceMappingURL=batch-response.js.map

package/dist/tools/batch-response.js.map

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

package/dist/tools/debug-task.d.ts

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { MultiModelConfig } from '@zhixuan92/multi-model-agent-core';
+export declare const debugTaskSchema: z.ZodObject<{
+    filePaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    cwd: z.ZodOptional<z.ZodString>;
+    contextBlockIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tools: z.ZodOptional<z.ZodEnum<{
+        readonly: "readonly";
+        none: "none";
+        full: "full";
+    }>>;
+    problem: z.ZodString;
+    context: z.ZodOptional<z.ZodString>;
+    hypothesis: z.ZodOptional<z.ZodString>;
+    agentType: z.ZodOptional<z.ZodEnum<{
+        standard: "standard";
+        complex: "complex";
+    }>>;
+}, z.core.$strip>;
+export type DebugTaskParams = z.infer<typeof debugTaskSchema>;
+export declare function registerDebugTask(server: McpServer, config: MultiModelConfig): void;
+//# sourceMappingURL=debug-task.d.ts.map

package/dist/tools/debug-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-task.d.ts","sourceRoot":"","sources":["../../src/tools/debug-task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAY,MAAM,mCAAmC,CAAC;AASpF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;iBAM1B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,QAgC5E"}

package/dist/tools/debug-task.js

@@ -0,0 +1,38 @@
+import { z } from 'zod';
+import { runTasks } from '@zhixuan92/multi-model-agent-core/run-tasks';
+import { commonToolFields, buildMetadataBlock, buildFilePathsPrompt, applyCommonFields, } from './shared.js';
+export const debugTaskSchema = z.object({
+    problem: z.string().describe('Description of the problem to debug'),
+    context: z.string().optional().describe('Additional context about the problem'),
+    hypothesis: z.string().optional().describe('Initial hypothesis about the cause'),
+    agentType: z.enum(['standard', 'complex']).optional(),
+    ...commonToolFields,
+});
+export function registerDebugTask(server, config) {
+    server.tool('debug_task', 'Debug a problem using hypothesis-driven investigation. Always single-task \u2014 file paths provide context for the investigation. Preset: complex agent, 1 review round. Use delegate_tasks only for custom pipeline config.', debugTaskSchema.shape, async (params) => {
+        const agentType = params.agentType ?? 'complex';
+        const parts = [`Debug this problem:\n\n${params.problem}`];
+        if (params.context)
+            parts.push(`Context: ${params.context}`);
+        if (params.hypothesis)
+            parts.push(`Initial hypothesis: ${params.hypothesis}`);
+        const fileSection = buildFilePathsPrompt(params.filePaths);
+        if (fileSection)
+            parts.push(fileSection);
+        parts.push('Use hypothesis-driven debugging: identify root cause, propose fix, verify.');
+        const prompt = parts.join('\n\n');
+        const taskSpec = applyCommonFields({ agentType, reviewPolicy: 'full', maxReviewRounds: 1 }, params);
+        try {
+            const results = await runTasks([{ ...taskSpec, prompt }], config);
+            const result = results[0];
+            return { content: [{ type: 'text', text: result.output }, buildMetadataBlock(result)] };
+        }
+        catch (err) {
+            return {
+                content: [{ type: 'text', text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=debug-task.js.map

package/dist/tools/debug-task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-task.js","sourceRoot":"","sources":["../../src/tools/debug-task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,QAAQ,EAAE,MAAM,6CAA6C,CAAC;AACvE,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAErB,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IACnE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IAC/E,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IAChF,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE;IACrD,GAAG,gBAAgB;CACpB,CAAC,CAAC;AAIH,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,MAAwB;IAC3E,MAAM,CAAC,IAAI,CACT,YAAY,EACZ,+NAA+N,EAC/N,eAAe,CAAC,KAAK,EACrB,KAAK,EAAE,MAAuB,EAAE,EAAE;QAChC,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,SAAS,CAAC;QAChD,MAAM,KAAK,GAAa,CAAC,0BAA0B,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QACrE,IAAI,MAAM,CAAC,OAAO;YAAE,KAAK,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7D,IAAI,MAAM,CAAC,UAAU;YAAE,KAAK,CAAC,IAAI,CAAC,uBAAuB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QAC9E,MAAM,WAAW,GAAG,oBAAoB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC3D,IAAI,WAAW;YAAE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC,4EAA4E,CAAC,CAAC;QACzF,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAElC,MAAM,QAAQ,GAAsB,iBAAiB,CACnD,EAAE,SAAS,EAAE,YAAY,EAAE,MAAe,EAAE,eAAe,EAAE,CAAC,EAAE,EAChE,MAAM,CACP,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAc,CAAC,EAAE,MAAM,CAAC,CAAC;YAC9E,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YAC1B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;QACnG,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACxG,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/review-code.d.ts

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { MultiModelConfig } from '@zhixuan92/multi-model-agent-core';
+export declare const reviewCodeSchema: z.ZodObject<{
+    filePaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    cwd: z.ZodOptional<z.ZodString>;
+    contextBlockIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tools: z.ZodOptional<z.ZodEnum<{
+        readonly: "readonly";
+        none: "none";
+        full: "full";
+    }>>;
+    code: z.ZodOptional<z.ZodString>;
+    focus: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        security: "security";
+        performance: "performance";
+        correctness: "correctness";
+        style: "style";
+    }>>>;
+    outputFormat: z.ZodOptional<z.ZodEnum<{
+        json: "json";
+        markdown: "markdown";
+    }>>;
+    agentType: z.ZodOptional<z.ZodEnum<{
+        standard: "standard";
+        complex: "complex";
+    }>>;
+}, z.core.$strip>;
+export type ReviewCodeParams = z.infer<typeof reviewCodeSchema>;
+export declare function registerReviewCode(server: McpServer, config: MultiModelConfig): void;
+//# sourceMappingURL=review-code.d.ts.map

package/dist/tools/review-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-code.d.ts","sourceRoot":"","sources":["../../src/tools/review-code.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAY,MAAM,mCAAmC,CAAC;AAapF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;iBAM3B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAoBhE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,QAiD7E"}

package/dist/tools/review-code.js

@@ -0,0 +1,65 @@
+import { z } from 'zod';
+import { runTasks } from '@zhixuan92/multi-model-agent-core/run-tasks';
+import { commonToolFields, validateInput, resolveDispatchMode, buildMetadataBlock, buildFilePathsPrompt, buildPerFilePrompt, applyCommonFields, } from './shared.js';
+import { buildFanOutResponse } from './batch-response.js';
+export const reviewCodeSchema = z.object({
+    code: z.string().optional().describe('Inline code to review'),
+    focus: z.array(z.enum(['security', 'performance', 'correctness', 'style'])).optional(),
+    outputFormat: z.enum(['json', 'markdown']).optional(),
+    agentType: z.enum(['standard', 'complex']).optional(),
+    ...commonToolFields,
+});
+function buildReviewPrompt(code, filePaths, focus, outputFormat) {
+    const parts = ['Review this code:'];
+    if (code)
+        parts.push(`\`\`\`\n${code}\n\`\`\``);
+    const fileSection = buildFilePathsPrompt(filePaths);
+    if (fileSection)
+        parts.push(fileSection);
+    if (focus && focus.length > 0)
+        parts.push(`Focus areas: ${focus.join(', ')}.`);
+    if (outputFormat === 'json') {
+        parts.push('Return findings as a JSON array of objects with keys: severity, category, file, line, finding, recommendation.');
+    }
+    parts.push('Provide a structured review with findings and recommendations.');
+    return parts.join('\n\n');
+}
+export function registerReviewCode(server, config) {
+    server.tool('review_code', 'Review code with the full quality pipeline (spec review + quality review). Accepts inline code or file paths \u2014 multiple files are reviewed in parallel. Preset: complex agent, full review. Use this when code needs thorough review. Use delegate_tasks only for custom pipeline config.', reviewCodeSchema.shape, async (params) => {
+        const validation = validateInput(params.code, params.filePaths);
+        if (!validation.valid) {
+            return { content: [{ type: 'text', text: `Error: ${validation.message}` }], isError: true };
+        }
+        const agentType = params.agentType ?? 'complex';
+        const baseTaskSpec = applyCommonFields({
+            agentType,
+            reviewPolicy: 'full',
+            ...(params.outputFormat && { formatConstraints: { outputFormat: params.outputFormat } }),
+        }, params);
+        try {
+            const mode = resolveDispatchMode(params.code, params.filePaths);
+            if (mode === 'fan_out') {
+                const validPaths = params.filePaths.filter(p => p.trim().length > 0);
+                const promptTemplate = buildReviewPrompt(undefined, undefined, params.focus, params.outputFormat);
+                const tasks = validPaths.map(fp => ({
+                    ...baseTaskSpec,
+                    prompt: buildPerFilePrompt(fp, promptTemplate),
+                }));
+                const startMs = Date.now();
+                const results = await runTasks(tasks, config);
+                return { content: [buildFanOutResponse(results, tasks, Date.now() - startMs)] };
+            }
+            const prompt = buildReviewPrompt(params.code, params.filePaths, params.focus, params.outputFormat);
+            const results = await runTasks([{ ...baseTaskSpec, prompt }], config);
+            const result = results[0];
+            return { content: [{ type: 'text', text: result.output }, buildMetadataBlock(result)] };
+        }
+        catch (err) {
+            return {
+                content: [{ type: 'text', text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=review-code.js.map

package/dist/tools/review-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-code.js","sourceRoot":"","sources":["../../src/tools/review-code.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,QAAQ,EAAE,MAAM,6CAA6C,CAAC;AACvE,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IAC7D,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACtF,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE;IACrD,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE;IACrD,GAAG,gBAAgB;CACpB,CAAC,CAAC;AAIH,SAAS,iBAAiB,CACxB,IAAwB,EACxB,SAA+B,EAC/B,KAA2B,EAC3B,YAAgC;IAEhC,MAAM,KAAK,GAAa,CAAC,mBAAmB,CAAC,CAAC;IAC9C,IAAI,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,UAAU,CAAC,CAAC;IAChD,MAAM,WAAW,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;IACpD,IAAI,WAAW;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACzC,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/E,IAAI,YAAY,KAAK,MAAM,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,gHAAgH,CAAC,CAAC;IAC/H,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;IAC7E,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAiB,EAAE,MAAwB;IAC5E,MAAM,CAAC,IAAI,CACT,aAAa,EACb,gSAAgS,EAChS,gBAAgB,CAAC,KAAK,EACtB,KAAK,EAAE,MAAwB,EAAE,EAAE;QACjC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QAChE,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;YACtB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACvG,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,SAAS,CAAC;QAChD,MAAM,YAAY,GAAsB,iBAAiB,CACvD;YACE,SAAS;YACT,YAAY,EAAE,MAAe;YAC7B,GAAG,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,iBAAiB,EAAE,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,EAAE,CAAC;SACzF,EACD,MAAM,CACP,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,mBAAmB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;YAEhE,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,MAAM,UAAU,GAAG,MAAM,CAAC,SAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBACtE,MAAM,cAAc,GAAG,iBAAiB,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;gBAClG,MAAM,KAAK,GAAe,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;oBAC9C,GAAG,YAAY;oBACf,MAAM,EAAE,kBAAkB,CAAC,EAAE,EAAE,cAAc,CAAC;iBAClC,CAAA,CAAC,CAAC;gBAEhB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAC3B,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;gBAC9C,OAAO,EAAE,OAAO,EAAE,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;YAClF,CAAC;YAED,MAAM,MAAM,GAAG,iBAAiB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;YACnG,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,CAAC,EAAE,GAAG,YAAY,EAAE,MAAM,EAAc,CAAC,EAAE,MAAM,CAAC,CAAC;YAClF,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YAC1B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;QACnG,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACxG,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}