@s_s/harmonia 1.2.0 → 1.4.0

package/build/tools/role-dispatch.js

@@ -0,0 +1,508 @@
+/**
+ * MCP Tool: role_dispatch
+ *
+ * Prepare all data needed to hand off a task to a team member role.
+ * Returns: role prompt (with overrides injected), session guidance,
+ * input artifacts, task brief, and dispatch tracking info.
+ *
+ * Node-based architecture: validates against workflow node states.
+ * Accepts an optional node_id parameter to target a specific task node.
+ *
+ * Session/parallel behavior is enforced by Core:
+ * - session: none → never searches for idle sessions
+ * - session: persistent → searches for idle sessions, directs reuse
+ * - session: optional → searches for idle sessions, suggests reuse
+ * - parallel: true + running dispatch → forces new session
+ *
+ * Automatically:
+ * - Creates a dispatch record for tracking
+ * - Enforces session/parallel strategy from role frontmatter
+ * - Triggers a dispatch_requested engine event
+ * - Returns nextAction from the workflow engine
+ *
+ * This tool does NOT launch agents — it only prepares the data.
+ * The coordinator decides how to pass this to the team member.
+ */
+import { z } from 'zod';
+import { readArtifact, listArtifacts, resolveArtifactDir } from '../core/artifacts.js';
+import { getMergedOverrides, resolveRoleConfig } from '../core/overrides.js';
+import { createDispatch, findIdleSession, hasRunningDispatch } from '../core/dispatch.js';
+import { loadArtifactSchema, formatSchemaGuidance } from '../core/schema.js';
+import { resolveActive, isError, buildOverrideSection } from './utils.js';
+import { loadWorkflowForContext, processWorkflowEvent, formatNextAction, findTaskNode } from './engine-helpers.js';
+import { collectTaskNodes, findAncestorLoopId } from '../core/tree-utils.js';
+/**
+ * Find task nodes for a given role that are active or pending.
+ */
+function findDispatchableNodes(wf, state, role) {
+    const allTasks = collectTaskNodes(wf.definition.root);
+    // Include floating nodes
+    if (wf.definition.floatingNodes) {
+        allTasks.push(...wf.definition.floatingNodes);
+    }
+    return allTasks.filter((t) => {
+        if (t.role !== role)
+            return false;
+        const nodeState = state.nodes[t.id];
+        return nodeState && (nodeState.status === 'active' || nodeState.status === 'pending');
+    });
+}
+/**
+ * Build session guidance text.
+ *
+ * Incorporates session type behavior, parallel status, model, and agent info.
+ * This replaces the former separate "## Configuration" section — all dispatch
+ * configuration info is now part of Session Guidance.
+ */
+function buildSessionGuidance(params) {
+    const { idleSession, sessionType, model, agent, parallelForced } = params;
+    const lines = [];
+    // Consistent agent descriptor used across all Action lines
+    const agentDesc = agent ? `拉起 ${agent} 作为子 agent 执行任务` : '拉起子 agent 执行任务';
+    // Model/agent header
+    if (model) {
+        const agentSuffix = agent ? `，使用 ${agent}` : '';
+        lines.push(`**Model**: \`${model}\`${agentSuffix}`);
+    }
+    else if (agent) {
+        lines.push(`**Agent**: ${agent}`);
+    }
+    if (lines.length > 0)
+        lines.push('');
+    // Session guidance based on type and findings
+    if (parallelForced) {
+        // parallel=true and same role already has a running dispatch → force new session
+        lines.push(`**Session**: 该角色已有运行中的 dispatch，强制启动新会话（parallel 模式）`);
+        lines.push('');
+        lines.push(`**Action**: ${agentDesc}。`);
+    }
+    else if (idleSession) {
+        const agentId = idleSession.agentSessionId
+            ? `Agent session ID: \`${idleSession.agentSessionId}\``
+            : 'Agent session ID: not recorded';
+        const label = idleSession.label ? ` (${idleSession.label})` : '';
+        lines.push(`**Reusable session found**: ${idleSession.id}${label}`);
+        lines.push(`- ${agentId}`);
+        lines.push(`- Agent type: ${idleSession.agentType ?? 'unknown'}`);
+        lines.push(`- Last active: ${idleSession.lastActiveAt}`);
+        lines.push('');
+        if (sessionType === 'persistent') {
+            lines.push(`**Action**: 复用已有会话，而非启动新 agent。`);
+            lines.push(idleSession.agentSessionId
+                ? `使用 \`--resume ${idleSession.agentSessionId}\` 或 \`--session ${idleSession.agentSessionId}\` 恢复会话。`
+                : `注意: 该会话未记录 agent session ID，可能需要${agentDesc}。`);
+        }
+        else {
+            // optional — suggestion, not directive
+            lines.push(`**Suggestion**: 存在空闲会话，可复用也可启动新会话，由你决定。`);
+            if (idleSession.agentSessionId) {
+                lines.push(`如需复用: \`--resume ${idleSession.agentSessionId}\` 或 \`--session ${idleSession.agentSessionId}\``);
+            }
+        }
+    }
+    else {
+        // No idle session found (or session type is 'none')
+        if (sessionType === 'none') {
+            lines.push(`**Session**: 每次 dispatch 启动全新会话（session: none）`);
+        }
+        else {
+            lines.push(`**未找到可复用会话**`);
+            lines.push(`Session type: ${sessionType}`);
+        }
+        lines.push('');
+        lines.push(`**Action**: ${agentDesc}。`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Get file extension from artifact definition format.
+ * - 'html' → '.html'
+ * - 'json' → '.json'
+ * - 'md' or undefined → '.md'
+ */
+export function getFormatExtension(format) {
+    switch (format) {
+        case 'html':
+            return '.html';
+        case 'json':
+            return '.json';
+        default:
+            return '.md';
+    }
+}
+/**
+ * Resolve an artifact ID to a name + path reference.
+ *
+ * - Managed artifacts: resolves to full file path via format → extension mapping
+ * - Unmanaged artifacts: resolves to the output directory
+ * - Unknown artifacts: returns not-found
+ */
+export function resolveInputReference(artifactId, wf, ioCtx, existingArtifacts) {
+    const artifactDef = wf.artifactDefinitions[artifactId];
+    if (!artifactDef) {
+        return {
+            id: artifactId,
+            name: artifactId,
+            path: '',
+            found: false,
+        };
+    }
+    if (artifactDef.unmanaged) {
+        // Unmanaged: resolve to directory
+        const dir = resolveArtifactDir(artifactDef.output, ioCtx);
+        return {
+            id: artifactId,
+            name: artifactDef.name,
+            path: dir,
+            found: true, // unmanaged dirs are always "available"
+        };
+    }
+    // Managed: resolve to full file path via format → extension
+    const dir = resolveArtifactDir(artifactDef.output, ioCtx);
+    const ext = getFormatExtension(artifactDef.format);
+    const filePath = `${dir}/${artifactId}${ext}`;
+    return {
+        id: artifactId,
+        name: artifactDef.name,
+        path: filePath,
+        found: existingArtifacts.has(artifactId),
+    };
+}
+/**
+ * Build Artifact Requirements section for the dispatch data package.
+ * Only includes schemas for artifacts associated with the dispatched role
+ * (via the role's capabilities).
+ */
+async function buildArtifactRequirements(wf, workflowsDir, workflowName, role) {
+    const artifactDefs = wf.artifactDefinitions;
+    // Extract artifact IDs from role capabilities
+    const roleDef = wf.roles[role];
+    const roleArtifactIds = new Set();
+    if (roleDef?.frontmatter.capabilities) {
+        for (const cap of roleDef.frontmatter.capabilities) {
+            if (cap.artifact) {
+                roleArtifactIds.add(cap.artifact);
+            }
+        }
+    }
+    // If role has no artifact capabilities, skip
+    if (roleArtifactIds.size === 0)
+        return '';
+    const sections = [];
+    for (const artifactId of roleArtifactIds) {
+        const artifactDef = artifactDefs[artifactId];
+        if (!artifactDef || artifactDef.unmanaged)
+            continue;
+        // Load main schema
+        const schema = await loadArtifactSchema(workflowsDir, workflowName, artifactId);
+        // Load step schemas if artifact has steps
+        let stepSchemas;
+        if (artifactDef.steps && artifactDef.steps.length > 0) {
+            stepSchemas = [];
+            for (const step of artifactDef.steps) {
+                const stepSchema = await loadArtifactSchema(workflowsDir, workflowName, `${artifactId}.${step.id}`);
+                stepSchemas.push({ step, schema: stepSchema });
+            }
+        }
+        // Skip if no schema at all
+        if (!schema && (!stepSchemas || stepSchemas.every((s) => !s.schema)))
+            continue;
+        sections.push(formatSchemaGuidance(artifactId, artifactDef, schema, stepSchemas));
+    }
+    if (sections.length === 0)
+        return '';
+    return ['## Artifact Requirements', '', ...sections].join('\n');
+}
+export function registerDispatchRole(server, workflowsDir) {
+    server.tool('role_dispatch', "Prepare all data needed to dispatch a task to a team member. Returns the role's prompt (with capability overrides), configuration, input artifacts, task brief, and a dispatch tracking ID. Automatically searches for reusable sessions and provides guidance. Does NOT launch agents — you (coordinator) decide how to pass this to the team member. After launching, call dispatch_report to register the session.", {
+        project_name: z.string().describe('Project name'),
+        role: z.string().describe('Role ID to dispatch (e.g. architect, developer, tester)'),
+        task_brief: z
+            .string()
+            .describe('Task description for the team member — what they need to do, which tasks from the breakdown, specific instructions, etc.'),
+        node_id: z
+            .string()
+            .optional()
+            .describe('Target task node ID from the workflow tree. If omitted, automatically finds an active/pending task node for the specified role.'),
+        input_artifact_ids: z
+            .array(z.string())
+            .optional()
+            .describe('Supplementary artifact IDs to include as input references (name + path) for the team member. These are merged with the node-level inputArtifacts declaration. Note: only path references are provided, not content.'),
+    }, async ({ project_name, role, task_brief, node_id, input_artifact_ids }) => {
+        try {
+            const ctx = await resolveActive(project_name);
+            if (isError(ctx))
+                return ctx;
+            // Load project state and workflow plugin
+            const { wf, state } = await loadWorkflowForContext(workflowsDir, project_name, ctx);
+            // Validate role exists
+            const roleDef = wf.roles[role];
+            if (!roleDef) {
+                const available = Object.keys(wf.roles).join(', ');
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Role "${role}" not found. Available: ${available}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            // Resolve target task node
+            let targetNode;
+            if (node_id) {
+                // Explicit node_id — validate it
+                targetNode = findTaskNode(wf, node_id);
+                if (!targetNode) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Node "${node_id}" not found or is not a task node in the workflow.`,
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                if (targetNode.role !== role) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Node "${node_id}" is assigned to role "${targetNode.role}", not "${role}".`,
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                // Validate node state allows dispatch
+                const nodeState = state.nodes[node_id];
+                if (nodeState && nodeState.status !== 'active' && nodeState.status !== 'pending') {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Node "${node_id}" is in status "${nodeState.status}" — cannot dispatch. Only active or pending nodes can be dispatched.`,
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+            }
+            else {
+                // Auto-find: look for active/pending task nodes for this role
+                const candidates = findDispatchableNodes(wf, state, role);
+                if (candidates.length === 0) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `No active or pending task nodes found for role "${role}". Check project_status to see the current workflow state.`,
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                // Prefer active over pending
+                targetNode = candidates.find((t) => state.nodes[t.id]?.status === 'active') ?? candidates[0];
+            }
+            const targetNodeId = targetNode.id;
+            // Build I/O context for artifact path resolution
+            const ioCtx = {
+                contextDir: ctx.dir,
+                projectDir: ctx.entry.dir,
+                contextLabel: ctx.activeContext,
+            };
+            // Get merged overrides
+            const overrides = await getMergedOverrides(project_name);
+            // Build the full prompt with overrides injected
+            const overrideSection = buildOverrideSection(role, overrides);
+            let fullPrompt = overrideSection ? `${roleDef.prompt}\n${overrideSection}` : roleDef.prompt;
+            // Execute beforeDispatch hooks (if defined on the target node)
+            const hookInjections = [];
+            if (targetNode.beforeDispatch) {
+                // Collect static inject text
+                if (targetNode.beforeDispatch.inject) {
+                    hookInjections.push(...targetNode.beforeDispatch.inject);
+                }
+                // Execute registered actions
+                if (targetNode.beforeDispatch.actions && wf.actions) {
+                    const nodeState = state.nodes[targetNodeId];
+                    // Resolve loopIteration: find ancestor loop node and read its current iteration
+                    let loopIteration;
+                    const ancestorLoopId = findAncestorLoopId(wf.definition.root, targetNodeId);
+                    if (ancestorLoopId) {
+                        const loopState = state.nodes[ancestorLoopId];
+                        if (loopState) {
+                            loopIteration = loopState.currentIteration;
+                        }
+                    }
+                    const actionCtx = {
+                        nodeId: targetNodeId,
+                        role,
+                        retryCount: nodeState?.retryCount ?? 0,
+                        projectName: project_name,
+                        pluginConfig: wf.config,
+                        workflowState: state,
+                        artifacts: {
+                            read: (artifactId) => readArtifact(artifactId, ioCtx, wf.artifactDefinitions[artifactId]),
+                            list: () => listArtifacts(ioCtx, wf.artifactDefinitions),
+                        },
+                        loopIteration,
+                    };
+                    for (const actionName of targetNode.beforeDispatch.actions) {
+                        const handler = wf.actions[actionName];
+                        if (handler) {
+                            try {
+                                const result = await handler(actionCtx);
+                                if (result.inject) {
+                                    hookInjections.push(...result.inject);
+                                }
+                            }
+                            catch (err) {
+                                console.warn(`[harmonia] beforeDispatch action "${actionName}" failed:`, err);
+                            }
+                        }
+                        else {
+                            console.warn(`[harmonia] beforeDispatch action "${actionName}" not registered`);
+                        }
+                    }
+                }
+            }
+            // Append hook injections to the role prompt
+            if (hookInjections.length > 0) {
+                fullPrompt += '\n\n' + hookInjections.join('\n\n');
+            }
+            // Resolve input artifact references (merge node declaration + coordinator parameter)
+            const nodeInputIds = targetNode.inputArtifacts ?? [];
+            const paramInputIds = input_artifact_ids ?? [];
+            const mergedInputIds = [...new Set([...nodeInputIds, ...paramInputIds])];
+            // List existing artifacts for reference resolution
+            const existingArtifacts = new Set(await listArtifacts(ioCtx, wf.artifactDefinitions));
+            // Resolve all input references
+            const inputRefs = mergedInputIds.map((id) => resolveInputReference(id, wf, ioCtx, existingArtifacts));
+            const foundRefs = inputRefs.filter((r) => r.found);
+            const missingRefs = inputRefs.filter((r) => !r.found);
+            // Resolve agent/model: override takes precedence over frontmatter
+            const roleConfig = resolveRoleConfig(role, overrides);
+            const modelDisplay = roleConfig.model ?? roleDef.frontmatter.model;
+            const agentDisplay = roleConfig.agent ?? roleDef.frontmatter.agent;
+            const sessionType = roleDef.frontmatter.session;
+            // Determine session strategy based on session type + parallel field
+            let idleSession = null;
+            let parallelForced = false;
+            if (sessionType === 'none') {
+                // session: none → never look for idle sessions
+                idleSession = null;
+            }
+            else if (roleDef.frontmatter.parallel) {
+                // parallel=true → check if same role has running dispatches
+                const hasRunning = await hasRunningDispatch(project_name, ctx.number, role, ctx.dir);
+                if (hasRunning) {
+                    // Force new session — don't look for idle ones
+                    parallelForced = true;
+                    idleSession = null;
+                }
+                else {
+                    // No running dispatch → follow normal session behavior
+                    idleSession = await findIdleSession(project_name, ctx.number, role, ctx.dir);
+                }
+            }
+            else {
+                // session: persistent or optional → look for idle sessions
+                idleSession = await findIdleSession(project_name, ctx.number, role, ctx.dir);
+            }
+            // Create dispatch record
+            const dispatch = await createDispatch(project_name, ctx.number, role, task_brief, [], // expectedOutputs — determined dynamically by workflow engine
+            idleSession?.id, ctx.dir, targetNodeId);
+            // Trigger engine event: dispatch_requested
+            const engineResult = await processWorkflowEvent(workflowsDir, project_name, ctx, {
+                type: 'dispatch_requested',
+                nodeId: targetNodeId,
+            });
+            const nextActionText = formatNextAction(engineResult.nextAction);
+            // Build session guidance (now includes model/agent info — replaces ## Configuration)
+            const sessionGuidance = buildSessionGuidance({
+                idleSession,
+                sessionType,
+                model: modelDisplay,
+                agent: agentDisplay,
+                parallelForced,
+            });
+            // Build artifact requirements for expected outputs
+            const artifactRequirements = await buildArtifactRequirements(wf, workflowsDir, state.workflow, role);
+            const summary = [
+                `# Dispatch: ${role}`,
+                ``,
+                `## Dispatch Tracking`,
+                `- Dispatch ID: \`${dispatch.id}\``,
+                `- Status: ${dispatch.status}`,
+                `- Target Node: ${targetNodeId}`,
+                ``,
+                `## Session Guidance`,
+                sessionGuidance,
+                ``,
+                `## Task Brief`,
+                task_brief,
+                ``,
+                `## Project Context`,
+                `- Project: ${project_name}`,
+                `- Directory: ${state.projectDir}`,
+                `- Workflow: ${state.workflow}`,
+            ];
+            // Inject unmanaged artifact output path hints
+            const unmanagedHints = [];
+            for (const cap of roleDef.frontmatter.capabilities ?? []) {
+                if (!cap.artifact)
+                    continue;
+                const def = wf.artifactDefinitions[cap.artifact];
+                if (!def?.unmanaged)
+                    continue;
+                const outputDir = resolveArtifactDir(def.output, ioCtx);
+                unmanagedHints.push(`- **${cap.artifact}** (${def.name}): \`${outputDir}\``);
+            }
+            if (unmanagedHints.length > 0) {
+                summary.push(``, `## Unmanaged Artifact Output Paths`, `以下 artifact 由 agent 直接输出（非 artifact_write），请将产出写入对应路径:`, ...unmanagedHints);
+            }
+            summary.push(``, `## Input References (${foundRefs.length}${missingRefs.length > 0 ? `, ${missingRefs.length} missing` : ''})`);
+            if (foundRefs.length > 0) {
+                for (const ref of foundRefs) {
+                    summary.push(`- **${ref.id}** (${ref.name}): \`${ref.path}\``);
+                }
+            }
+            if (missingRefs.length > 0) {
+                summary.push(``, `### Missing`);
+                for (const ref of missingRefs) {
+                    summary.push(`- **${ref.id}** (${ref.name}): 未找到`);
+                }
+            }
+            summary.push(``, `## Next Step`, `After launching the agent, call \`dispatch_report\` with dispatch_id="${dispatch.id}" and the agent's session ID.`, `When the agent finishes, call \`dispatch_report\` again with status="completed" (or "failed").`);
+            if (artifactRequirements) {
+                summary.push(``, artifactRequirements);
+            }
+            summary.push(``, `## Role Prompt`, ``, fullPrompt);
+            summary.push(nextActionText);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: summary.join('\n'),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: ${err instanceof Error ? err.message : String(err)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=role-dispatch.js.map

package/build/tools/role-dispatch.js.map

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

package/build/tools/utils.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Shared utility for tool handlers — resolves the active context (iteration or patch)
+ * for a project. All tools that operate on iteration/patch-level data should use this
+ * instead of directly reading entry.currentIteration.
+ */
+import type { ProjectEntry } from '../core/registry.js';
+import type { OverrideConfig } from '../core/types.js';
+export interface ResolvedContext {
+    entry: ProjectEntry;
+    /** The iteration or patch number */
+    number: number;
+    /** "iteration" or "patch" */
+    type: 'iteration' | 'patch';
+    /** Absolute path to the context directory (iter-N/ or patch-N/) */
+    dir: string;
+    /** The raw activeContext string, e.g. "iter-1" or "patch-2" */
+    activeContext: string;
+}
+type ToolResult = {
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+    isError?: boolean;
+};
+/**
+ * Resolve the active context for a project. Returns either a ResolvedContext
+ * or a ToolResult error (to be returned directly from the tool handler).
+ */
+export declare function resolveActive(projectName: string): Promise<ResolvedContext | ToolResult>;
+/**
+ * Type guard: check if the result is an error (ToolResult) or a resolved context.
+ */
+export declare function isError(result: ResolvedContext | ToolResult): result is ToolResult;
+/**
+ * Build override instructions to inject into a role prompt.
+ * Shared by role-dispatch and get-role-prompt.
+ */
+export declare function buildOverrideSection(roleId: string, overrides: OverrideConfig): string;
+export {};

package/build/tools/utils.js

@@ -0,0 +1,97 @@
+/**
+ * Shared utility for tool handlers — resolves the active context (iteration or patch)
+ * for a project. All tools that operate on iteration/patch-level data should use this
+ * instead of directly reading entry.currentIteration.
+ */
+import { getProject, resolveContextDir } from '../core/registry.js';
+/**
+ * Resolve the active context for a project. Returns either a ResolvedContext
+ * or a ToolResult error (to be returned directly from the tool handler).
+ */
+export async function resolveActive(projectName) {
+    const entry = await getProject(projectName);
+    if (!entry) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `项目 "${projectName}" 未注册。请先调用 project_init 注册项目。`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    if (!entry.activeContext) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `项目 "${projectName}" 尚未开始迭代或补丁。请先调用 iteration_start 或 patch_start。`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    const resolved = resolveContextDir(projectName, entry.activeContext);
+    if (!resolved) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `项目 "${projectName}" 的 activeContext "${entry.activeContext}" 无法解析。数据可能已损坏。`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    return {
+        entry,
+        number: resolved.number,
+        type: resolved.type,
+        dir: resolved.dir,
+        activeContext: entry.activeContext,
+    };
+}
+/**
+ * Type guard: check if the result is an error (ToolResult) or a resolved context.
+ */
+export function isError(result) {
+    return 'content' in result && !('entry' in result);
+}
+/**
+ * Build override instructions to inject into a role prompt.
+ * Shared by role-dispatch and get-role-prompt.
+ */
+export function buildOverrideSection(roleId, overrides) {
+    const roleOverrides = overrides.roles?.[roleId]?.capabilities;
+    if (!roleOverrides || Object.keys(roleOverrides).length === 0) {
+        return '';
+    }
+    const lines = [
+        '',
+        '## Enhanced Capabilities',
+        '',
+        'The following capabilities have been configured to use external tools.',
+        'Use the specified tool instead of built-in behavior for these actions.',
+        '',
+    ];
+    for (const [capId, override] of Object.entries(roleOverrides)) {
+        const o = override;
+        const toolRef = o.type === 'mcp' && o.server
+            ? `\`${o.server}\` MCP server's \`${o.tool}\` tool`
+            : `\`${o.tool}\` skill tool`;
+        let instruction = `- **${capId}**: Use ${toolRef}`;
+        if (o.params && Object.keys(o.params).length > 0) {
+            const paramStr = Object.entries(o.params)
+                .map(([k, v]) => `${k}: ${JSON.stringify(v)}`)
+                .join(', ');
+            instruction += ` with fixed parameters: ${paramStr}`;
+        }
+        if (o.notes) {
+            instruction += `. Note: ${o.notes}`;
+        }
+        lines.push(instruction);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=utils.js.map