@compass-ai/nova 1.0.73 → 1.0.74

package/dist/tools/skill-tools.js

@@ -0,0 +1,244 @@
+/**
+ * Skill invocation tools
+ *
+ * Tools for the model to invoke skills automatically.
+ * Skills are directory-based prompts that can be executed inline
+ * or in a forked subagent context.
+ */
+import { ActionType } from '../services/action-logger.js';
+import { getSkill, processSkill, getSkillsForModelInvocation, } from '../services/skill-service.js';
+import { runSDKQuery } from '../services/sdk-runner.js';
+import { logger } from '../utils/logger.js';
+/**
+ * Registers skill-related tools with the tool registry.
+ */
+export async function registerSkillTools(registry) {
+    // ============================================================
+    // INVOKE_SKILL - Model-triggered skill execution
+    // ============================================================
+    registry.registerTool('invoke_skill', `Invokes a skill by name with optional arguments.
+
+Skills are reusable prompts defined in .compass/skills/ directories.
+Use this tool when the user's request matches a skill's purpose.
+
+## How to Use
+
+1. Check available skills using list_skills or from system prompt
+2. Call invoke_skill with the skill name and any arguments
+3. The skill will be processed and executed
+
+## Execution Modes
+
+Skills can run in two modes based on their configuration:
+- **inline**: Executes in the current conversation context (default)
+- **fork**: Executes in an isolated subagent with its own context
+
+Fork mode is useful for skills that need clean context or different tool access.
+
+## Arguments
+
+Arguments are substituted into the skill content:
+- $ARGUMENTS - All arguments as a single string
+- $1, $2, etc. - Individual positional arguments
+
+Example: invoke_skill("deploy", ["production"])
+  → $ARGUMENTS = "production", $1 = "production"`, {
+        type: 'object',
+        properties: {
+            skill_name: {
+                type: 'string',
+                description: 'The name of the skill to invoke (e.g., "deploy", "review", "test")',
+            },
+            arguments: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Optional arguments to pass to the skill. These replace $ARGUMENTS and $1, $2, etc. in the skill content.',
+            },
+        },
+        required: ['skill_name'],
+    }, async (input, context) => {
+        const skillName = input.skill_name;
+        const args = input.arguments || [];
+        try {
+            // Look up the skill
+            const skill = await getSkill(skillName);
+            if (!skill) {
+                // List available skills in error message
+                const availableSkills = await getSkillsForModelInvocation();
+                const skillNames = availableSkills.map((s) => s.name).join(', ');
+                return {
+                    success: false,
+                    error: `Skill not found: "${skillName}". Available skills: ${skillNames || 'none'}`,
+                };
+            }
+            // Check if model invocation is disabled
+            if (skill.frontmatter['disable-model-invocation']) {
+                return {
+                    success: false,
+                    error: `Skill "${skillName}" has disabled model invocation. It can only be invoked via slash command (/${skillName}).`,
+                };
+            }
+            logger.info(`Invoking skill: ${skillName}`, {
+                args,
+                source: skill.source,
+                context: skill.frontmatter.context || 'inline',
+            });
+            // Process the skill content
+            const processed = await processSkill(skill, args);
+            // Handle fork context - execute in subagent
+            if (processed.context === 'fork') {
+                return await executeSkillInFork(skill, processed, context.projectRoot);
+            }
+            // Inline context - return processed content for the model to act on
+            return {
+                success: true,
+                skill: skillName,
+                mode: 'inline',
+                content: processed.processedContent,
+                toolRestrictions: processed.allowedTools,
+                modelOverride: processed.modelOverride,
+                message: `Skill "${skillName}" content is ready. Follow the instructions in the content field.`,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            logger.error(`Failed to invoke skill: ${skillName}`, error);
+            return {
+                success: false,
+                skill: skillName,
+                error: errorMessage,
+            };
+        }
+    }, {
+        actionType: ActionType.COMMAND_EXEC,
+        requiresApproval: false,
+        category: 'workflow',
+        tags: ['skill', 'invoke', 'automation'],
+        displayName: 'Invoke Skill',
+    });
+    // ============================================================
+    // LIST_SKILLS - List available skills
+    // ============================================================
+    registry.registerTool('list_skills', `Lists all available skills that can be invoked.
+
+Returns information about each skill including:
+- Name: The skill identifier (use with invoke_skill)
+- Description: What the skill does
+- Source: Where the skill is defined (project or personal)
+- Context: How the skill executes (inline or fork)
+
+Skills marked with disable-model-invocation are excluded from this list
+as they can only be invoked via slash command.`, {
+        type: 'object',
+        properties: {},
+    }, async () => {
+        try {
+            const skills = await getSkillsForModelInvocation();
+            if (skills.length === 0) {
+                return {
+                    success: true,
+                    count: 0,
+                    skills: [],
+                    message: 'No skills available. Skills can be created in .compass/skills/<name>/SKILL.md',
+                };
+            }
+            const skillList = skills.map((skill) => ({
+                name: skill.name,
+                description: skill.description,
+                source: skill.source,
+                context: skill.frontmatter.context || 'inline',
+                argumentHint: skill.frontmatter['argument-hint'],
+                agent: skill.frontmatter.agent,
+            }));
+            return {
+                success: true,
+                count: skills.length,
+                skills: skillList,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            logger.error('Failed to list skills', error);
+            return {
+                success: false,
+                error: errorMessage,
+            };
+        }
+    }, {
+        actionType: ActionType.FILE_READ, // Read-only operation
+        requiresApproval: false,
+        category: 'workflow',
+        tags: ['skill', 'list', 'discovery'],
+        displayName: 'List Skills',
+    });
+}
+/**
+ * Executes a skill in a forked subagent.
+ *
+ * @param skill - The skill definition
+ * @param processed - The processed skill result
+ * @param projectRoot - Current project root
+ * @returns Execution result from the forked agent
+ */
+async function executeSkillInFork(skill, processed, projectRoot) {
+    try {
+        logger.info(`Forking skill ${skill.name} to subagent`, {
+            agent: processed.agent || 'default',
+        });
+        // Build agent config if agent name specified
+        let agentConfig = undefined;
+        if (processed.agent) {
+            const { getAgentByName } = await import('../services/agent-manager.js');
+            agentConfig = await getAgentByName(processed.agent);
+            if (!agentConfig) {
+                logger.warn(`Agent not found for skill fork: ${processed.agent}`);
+            }
+        }
+        // If model override specified but no agent, create minimal agent config for model
+        if (processed.modelOverride && !agentConfig) {
+            const { createDefaultAgentDefinition } = await import('../types/agent.js');
+            agentConfig = createDefaultAgentDefinition('skill-runner', `Skill execution: ${skill.name}`, '', // No system prompt override
+            'builtin');
+            agentConfig.model = processed.modelOverride;
+        }
+        else if (processed.modelOverride && agentConfig) {
+            // Override agent model with skill's model
+            agentConfig = { ...agentConfig, model: processed.modelOverride };
+        }
+        const result = await runSDKQuery({
+            query: processed.processedContent,
+            projectRoot,
+            continueSession: false,
+            autoApprove: true,
+            agentConfig,
+        });
+        if (result.success) {
+            return {
+                success: true,
+                skill: skill.name,
+                mode: 'fork',
+                response: result.content,
+                message: `Skill "${skill.name}" executed successfully in forked context.`,
+            };
+        }
+        else {
+            return {
+                success: false,
+                skill: skill.name,
+                mode: 'fork',
+                error: result.error || 'Subagent execution failed',
+            };
+        }
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        logger.error(`Skill fork execution failed: ${skill.name}`, error);
+        return {
+            success: false,
+            skill: skill.name,
+            mode: 'fork',
+            error: errorMessage,
+        };
+    }
+}
+//# sourceMappingURL=skill-tools.js.map

package/dist/tools/skill-tools.js.map

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

package/dist/tools/swarm-tools.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Swarm/Agent Teams tools
+ *
+ * Tools for spawning coordinated agent teams, reading team messages,
+ * managing shared state, and monitoring team progress.
+ */
+import type { ToolRegistry } from '../services/tool-registry.js';
+export declare function registerSwarmTools(registry: ToolRegistry): Promise<void>;
+//# sourceMappingURL=swarm-tools.d.ts.map

package/dist/tools/swarm-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarm-tools.d.ts","sourceRoot":"","sources":["../../src/tools/swarm-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAKjE,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA4d9E"}