@compass-ai/nova 1.0.74 → 1.0.76

package/dist/tools/user-tools.js

@@ -1,232 +0,0 @@
-/**
- * User interaction tools
- *
- * Tools for interacting with the user during task execution,
- * including asking questions, gathering preferences, and
- * clarifying requirements mid-execution.
- */
-import { ActionType } from '../services/action-logger.js';
-import { getApprovalManager } from '../services/approval-manager.js';
-import { logger } from '../utils/logger.js';
-import { v4 as uuidv4 } from 'uuid';
-/**
- * Transforms LLM input questions to ClarificationQuestion format
- */
-function transformQuestions(questions) {
-    return questions.map((q, index) => {
-        // Determine answer type based on options
-        let answerType = q.answerType || 'single_choice';
-        if (!q.answerType) {
-            if (!q.options || q.options.length === 0) {
-                answerType = 'free_text';
-            }
-            else if (q.options.length === 2 &&
-                q.options.some(o => o.label.toLowerCase() === 'yes') &&
-                q.options.some(o => o.label.toLowerCase() === 'no')) {
-                answerType = 'yes_no';
-            }
-        }
-        // Transform options if provided
-        const options = q.options?.map((opt, optIndex) => ({
-            id: opt.id || `option_${optIndex + 1}`,
-            label: opt.label,
-            description: opt.description || '',
-            recommended: opt.recommended,
-        }));
-        return {
-            id: q.id || `q_${index + 1}_${uuidv4().slice(0, 8)}`,
-            question: q.question,
-            context: q.context || '',
-            answerType,
-            options,
-            category: q.category || 'general',
-        };
-    });
-}
-/**
- * Formats answers for LLM consumption
- */
-function formatAnswersForLLM(questions, answers) {
-    const formatted = questions.map((q, index) => {
-        const answer = answers[index];
-        if (!answer) {
-            return `Q: "${q.question}" → Unanswered`;
-        }
-        let answerText;
-        if (Array.isArray(answer.answer)) {
-            answerText = answer.answer.join(', ');
-        }
-        else {
-            answerText = answer.answer;
-        }
-        // If it's a choice question, try to show the label instead of ID
-        if (q.options && !Array.isArray(answer.answer)) {
-            const selectedOption = q.options.find(o => o.id === answer.answer);
-            if (selectedOption) {
-                answerText = selectedOption.label;
-            }
-        }
-        else if (q.options && Array.isArray(answer.answer)) {
-            answerText = answer.answer
-                .map(a => q.options?.find(o => o.id === a)?.label || a)
-                .join(', ');
-        }
-        return `Q: "${q.question}" → "${answerText}"`;
-    });
-    return formatted.join('\n');
-}
-/**
- * Registers user interaction tools with the tool registry
- */
-export function registerUserTools(registry) {
-    registry.registerTool('ask_user', `Ask the user questions when you need clarification or input during task execution.
-
-Use this tool when you:
-- Need to choose between multiple valid implementation approaches
-- Want to confirm assumptions before proceeding with significant changes
-- Are unsure about edge cases
-
-Guidelines:
-- Keep questions concise and actionable
-- Provide clear options when possible (users can always add custom input)
-- Mark recommended options by setting recommended: true on the first/best option
-- Limit to 1-5 focused questions per call
-- Group related questions together
-- Don't ask questions you could answer by reading the codebase
-
-Answer types:
-- single_choice: User picks one option (default when options provided)
-- multiple_choice: User can select multiple options
-- free_text: Open-ended text input (default when no options)
-- yes_no: Simple yes/no question`, {
-        type: 'object',
-        properties: {
-            questions: {
-                type: 'array',
-                minItems: 1,
-                maxItems: 5,
-                items: {
-                    type: 'object',
-                    properties: {
-                        id: {
-                            type: 'string',
-                            description: 'Unique identifier for the question (auto-generated if not provided)',
-                        },
-                        question: {
-                            type: 'string',
-                            description: 'The question to ask the user. Be clear and specific.',
-                        },
-                        context: {
-                            type: 'string',
-                            description: 'Additional context explaining why you need this information',
-                        },
-                        answerType: {
-                            type: 'string',
-                            enum: ['single_choice', 'multiple_choice', 'free_text', 'yes_no'],
-                            description: 'Type of answer expected. Defaults to single_choice if options provided, free_text otherwise.',
-                        },
-                        options: {
-                            type: 'array',
-                            items: {
-                                type: 'object',
-                                properties: {
-                                    id: {
-                                        type: 'string',
-                                        description: 'Unique identifier for the option',
-                                    },
-                                    label: {
-                                        type: 'string',
-                                        description: 'Display text for the option',
-                                    },
-                                    description: {
-                                        type: 'string',
-                                        description: 'Explanation of what this option means',
-                                    },
-                                    recommended: {
-                                        type: 'boolean',
-                                        description: 'Mark as true for the recommended option',
-                                    },
-                                },
-                                required: ['label'],
-                            },
-                            description: 'Available choices for the user. If not provided, free text input is used.',
-                        },
-                        category: {
-                            type: 'string',
-                            description: 'Category for grouping (e.g., "architecture", "styling", "behavior")',
-                            default: 'general',
-                        },
-                    },
-                    required: ['question'],
-                },
-                description: 'Array of questions to ask the user (1-5 questions). Must provide at least 1 and at most 5 questions.',
-            },
-        },
-        required: ['questions'],
-    }, async (input) => {
-        const questionsInput = input.questions;
-        if (!questionsInput || questionsInput.length === 0) {
-            return {
-                success: false,
-                error: 'No questions provided',
-            };
-        }
-        if (questionsInput.length > 5) {
-            return {
-                success: false,
-                error: 'Maximum 5 questions allowed per call. Split into multiple calls if needed.',
-            };
-        }
-        // Transform input questions to ClarificationQuestion format
-        const questions = transformQuestions(questionsInput);
-        logger.info(`ask_user tool invoked with ${questions.length} question(s)`);
-        try {
-            const approvalManager = getApprovalManager();
-            // Request clarification through the approval manager
-            // This emits 'clarification-required' event which triggers the ClarificationWizard UI
-            const response = await approvalManager.requestClarification('Question from Assistant', // taskSummary
-            questions, 'The assistant needs your input to proceed with the task.' // reasoning
-            );
-            if (!response.completed) {
-                logger.info('User cancelled the question dialog');
-                return {
-                    success: false,
-                    cancelled: true,
-                    message: 'User cancelled the question dialog. Consider proceeding with a reasonable default or asking a different question.',
-                };
-            }
-            // Format answers for LLM consumption
-            const formattedAnswers = formatAnswersForLLM(questions, response.answers || []);
-            logger.info(`User answered ${response.answers?.length || 0} question(s)`);
-            return {
-                success: true,
-                questionCount: questions.length,
-                answerCount: response.answers?.length || 0,
-                answers: response.answers?.map((a, i) => ({
-                    questionId: a.questionId,
-                    question: questions[i]?.question,
-                    answer: a.answer,
-                    answeredAt: a.answeredAt,
-                })),
-                formatted: formattedAnswers,
-                summary: response.result?.decisionSummary || formattedAnswers,
-                message: `User has answered your questions. Here are their responses:\n\n${formattedAnswers}\n\nProceed with the task using these answers.`,
-            };
-        }
-        catch (err) {
-            const errorMessage = err instanceof Error ? err.message : 'Unknown error';
-            logger.error('ask_user tool failed', err);
-            return {
-                success: false,
-                error: errorMessage,
-            };
-        }
-    }, {
-        actionType: ActionType.CUSTOM,
-        requiresApproval: false, // The wizard interaction IS the user approval
-        category: 'interaction',
-        tags: ['user', 'question', 'clarification', 'input', 'preference'],
-        displayName: 'Ask User',
-    });
-}
-//# sourceMappingURL=user-tools.js.map

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

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

package/dist/types/agent-process.d.ts

@@ -1,244 +0,0 @@
-/**
- * Types for the Agent Process system - enables isolated agent execution
- * with per-agent token budgets, turn limits, and background execution.
- *
- * This module defines the interfaces needed for Claude Code Task tool-style
- * sub-agent execution with proper context isolation.
- */
-import type { Message } from './anthropic.js';
-/**
- * Budget allocation strategy for agent execution.
- */
-export type BudgetStrategy = 'fixed' | 'percentage' | 'adaptive';
-/**
- * Token and turn budget for an agent execution.
- * Enforces limits to prevent context bloat.
- */
-export interface AgentBudget {
-    /** Maximum context tokens this agent can consume */
-    maxTokens: number;
-    /** Maximum iterations/turns before forced termination */
-    maxTurns: number;
-    /** Running total of tokens consumed (input + output) */
-    tokensUsed: number;
-    /** Current turn/iteration count */
-    turnsUsed: number;
-}
-/**
- * Options for allocating a budget to a new agent.
- */
-export interface BudgetAllocationOptions {
-    /** Strategy for determining budget limits */
-    strategy: BudgetStrategy;
-    /** Fixed max tokens (used when strategy is 'fixed') */
-    maxTokens?: number;
-    /** Fixed max turns (used when strategy is 'fixed') */
-    maxTurns?: number;
-    /** Percentage of parent budget to allocate (0-100, used when strategy is 'percentage') */
-    percentageOfParent?: number;
-    /** Parent's remaining budget (required for 'percentage' strategy) */
-    parentBudget?: AgentBudget;
-}
-/**
- * Status of an agent process execution.
- */
-export type AgentProcessStatus = 'pending' | 'running' | 'paused' | 'completed' | 'failed' | 'cancelled' | 'budget_exceeded';
-/**
- * Reason for process termination (when not successful completion).
- */
-export type TerminationReason = 'token_budget_exceeded' | 'turn_budget_exceeded' | 'user_cancelled' | 'error' | 'parent_cancelled' | 'timeout';
-/**
- * Result envelope from agent execution with full attribution metadata.
- * Enables tracking which agent produced what results.
- */
-export interface AgentProcessResult {
-    /** Whether the task completed successfully */
-    success: boolean;
-    /** The agent's response/output */
-    content: string;
-    /** Error message if failed */
-    error?: string;
-    /** Name of the agent that produced this result */
-    agentName: string;
-    /** Model used by this agent (e.g., 'sonnet', 'haiku') */
-    agentModel: string;
-    /** Process ID for tracking */
-    processId: string;
-    /** Total tokens consumed (input + output) */
-    tokensUsed: number;
-    /** Number of turns/iterations executed */
-    turnsUsed: number;
-    /** Execution duration in milliseconds */
-    durationMs: number;
-    /** List of unique tools used during execution */
-    toolsUsed: string[];
-    /** Total number of tool calls made */
-    toolCallCount: number;
-    /** Whether execution was terminated due to budget limits */
-    budgetExceeded: boolean;
-    /** Which budget limit was hit, if any */
-    budgetExceededReason?: 'tokens' | 'turns';
-}
-/**
- * Full agent process state - tracks execution from spawn to completion.
- * Supports resumption and background execution.
- */
-export interface AgentProcess {
-    /** Unique identifier for this process instance (UUID) */
-    processId: string;
-    /** Reference to the AgentDefinition ID */
-    agentId: string;
-    /** Human-readable agent name */
-    agentName: string;
-    /** Current execution status */
-    status: AgentProcessStatus;
-    /** Budget allocation for this process */
-    budget: AgentBudget;
-    /** Original task description given to the agent */
-    task: string;
-    /** Additional context provided at spawn time */
-    context?: string;
-    /** Result of execution (populated when completed/failed) */
-    result?: AgentProcessResult;
-    /** Error details if status is 'failed' */
-    error?: string;
-    /** Reason for termination if not successful completion */
-    terminationReason?: TerminationReason;
-    /** ISO-8601 timestamp when process was created */
-    createdAt: string;
-    /** ISO-8601 timestamp when execution started */
-    startedAt?: string;
-    /** ISO-8601 timestamp when execution completed */
-    completedAt?: string;
-    /** Conversation messages for resumption */
-    messages: Message[];
-    /** Current turn number (for resumption tracking) */
-    turnNumber: number;
-    /** System prompt being used */
-    systemPrompt?: string;
-    /** Parent process ID if this is a nested agent */
-    parentProcessId?: string;
-    /** Chain of parent process IDs (for cycle detection) */
-    parentChain: string[];
-    /** Nesting depth (0 = top-level) */
-    depth: number;
-    /** Whether this process is running in background */
-    isBackground: boolean;
-    /** File path where background output is written */
-    outputFile?: string;
-    /** Project root directory for this execution */
-    projectRoot: string;
-    /** Parent tool call ID for UI status updates (ephemeral, not persisted) */
-    parentToolCallId?: string;
-    /** Team ID this process belongs to (if part of a swarm) */
-    teamId?: string;
-    /** Role within the team */
-    teamRole?: string;
-}
-/**
- * Options for spawning a new agent process.
- */
-export interface SpawnOptions {
-    /** Task description for the agent */
-    task: string;
-    /** Agent name/type to use (uses default if not specified) */
-    agentName?: string;
-    /** Additional context to inject into the agent's prompt */
-    context?: string;
-    /** Budget allocation options */
-    budget?: BudgetAllocationOptions;
-    /** Run in background (non-blocking) */
-    runInBackground?: boolean;
-    /** Parent process ID for nesting tracking */
-    parentProcessId?: string;
-    /** Project root directory */
-    projectRoot?: string;
-    /** Model override (sonnet, haiku, opus) */
-    model?: string;
-    /** Allowed tools (restricts available tools) */
-    allowedTools?: string[];
-    /** Parent tool call ID for UI status updates (pipes subagent activity to parent tool block) */
-    parentToolCallId?: string;
-    /** Team ID this agent belongs to (links to TeamContextStore) */
-    teamId?: string;
-    /** Role within the team (lead, worker, reviewer) */
-    teamRole?: string;
-    /** Process IDs this agent depends on (must complete before this agent starts) */
-    dependencies?: string[];
-}
-/**
- * Event types emitted during agent process lifecycle.
- */
-export type AgentProcessEventType = 'process_created' | 'process_started' | 'process_paused' | 'process_resumed' | 'process_completed' | 'process_failed' | 'process_cancelled' | 'budget_warning' | 'budget_exceeded' | 'turn_completed';
-/**
- * Event emitted during agent process execution.
- */
-export interface AgentProcessEvent {
-    /** Type of event */
-    type: AgentProcessEventType;
-    /** Process ID this event relates to */
-    processId: string;
-    /** Agent name */
-    agentName: string;
-    /** ISO-8601 timestamp */
-    timestamp: string;
-    /** Additional event data */
-    data?: {
-        /** Current budget status */
-        budget?: AgentBudget;
-        /** Turn number (for turn_completed) */
-        turnNumber?: number;
-        /** Result (for process_completed) */
-        result?: AgentProcessResult;
-        /** Error message (for process_failed) */
-        error?: string;
-        /** Warning percentage (for budget_warning) */
-        warningPercent?: number;
-    };
-}
-/**
- * Type guard for AgentProcessStatus.
- */
-export declare function isAgentProcessStatus(value: unknown): value is AgentProcessStatus;
-/**
- * Type guard for BudgetStrategy.
- */
-export declare function isBudgetStrategy(value: unknown): value is BudgetStrategy;
-/**
- * Checks if a process is in a terminal state (cannot be resumed).
- */
-export declare function isTerminalStatus(status: AgentProcessStatus): boolean;
-/**
- * Checks if a process can be resumed.
- */
-export declare function isResumable(process: AgentProcess): boolean;
-/**
- * Creates a default budget with standard limits.
- */
-export declare function createDefaultBudget(): AgentBudget;
-/**
- * Calculates remaining budget.
- */
-export declare function getRemainingBudget(budget: AgentBudget): {
-    tokens: number;
-    turns: number;
-};
-/**
- * Calculates budget usage percentage.
- */
-export declare function getBudgetUsagePercent(budget: AgentBudget): {
-    tokens: number;
-    turns: number;
-};
-/**
- * Checks if budget is exceeded.
- */
-export declare function isBudgetExceeded(budget: AgentBudget): {
-    exceeded: boolean;
-    reason?: 'tokens' | 'turns';
-};
-/**
- * Formats duration in human-readable format.
- */
-export declare function formatDuration(ms: number): string;
-//# sourceMappingURL=agent-process.d.ts.map

package/dist/types/agent-process.d.ts.map

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

package/dist/types/agent-process.js

@@ -1,93 +0,0 @@
-/**
- * Types for the Agent Process system - enables isolated agent execution
- * with per-agent token budgets, turn limits, and background execution.
- *
- * This module defines the interfaces needed for Claude Code Task tool-style
- * sub-agent execution with proper context isolation.
- */
-// =============================================================================
-// Type Guards
-// =============================================================================
-/**
- * Type guard for AgentProcessStatus.
- */
-export function isAgentProcessStatus(value) {
-    return (typeof value === 'string' &&
-        ['pending', 'running', 'paused', 'completed', 'failed', 'cancelled', 'budget_exceeded'].includes(value));
-}
-/**
- * Type guard for BudgetStrategy.
- */
-export function isBudgetStrategy(value) {
-    return (typeof value === 'string' &&
-        ['fixed', 'percentage', 'adaptive'].includes(value));
-}
-/**
- * Checks if a process is in a terminal state (cannot be resumed).
- */
-export function isTerminalStatus(status) {
-    return ['completed', 'failed', 'cancelled', 'budget_exceeded'].includes(status);
-}
-/**
- * Checks if a process can be resumed.
- */
-export function isResumable(process) {
-    return process.status === 'paused' && process.messages.length > 0;
-}
-// =============================================================================
-// Utility Functions
-// =============================================================================
-/**
- * Creates a default budget with standard limits.
- */
-export function createDefaultBudget() {
-    return {
-        maxTokens: 80000,
-        maxTurns: 20,
-        tokensUsed: 0,
-        turnsUsed: 0,
-    };
-}
-/**
- * Calculates remaining budget.
- */
-export function getRemainingBudget(budget) {
-    return {
-        tokens: Math.max(0, budget.maxTokens - budget.tokensUsed),
-        turns: Math.max(0, budget.maxTurns - budget.turnsUsed),
-    };
-}
-/**
- * Calculates budget usage percentage.
- */
-export function getBudgetUsagePercent(budget) {
-    return {
-        tokens: budget.maxTokens > 0 ? (budget.tokensUsed / budget.maxTokens) * 100 : 0,
-        turns: budget.maxTurns > 0 ? (budget.turnsUsed / budget.maxTurns) * 100 : 0,
-    };
-}
-/**
- * Checks if budget is exceeded.
- */
-export function isBudgetExceeded(budget) {
-    if (budget.tokensUsed >= budget.maxTokens) {
-        return { exceeded: true, reason: 'tokens' };
-    }
-    if (budget.turnsUsed >= budget.maxTurns) {
-        return { exceeded: true, reason: 'turns' };
-    }
-    return { exceeded: false };
-}
-/**
- * Formats duration in human-readable format.
- */
-export function formatDuration(ms) {
-    if (ms < 1000)
-        return `${ms}ms`;
-    if (ms < 60000)
-        return `${(ms / 1000).toFixed(1)}s`;
-    const minutes = Math.floor(ms / 60000);
-    const seconds = Math.round((ms % 60000) / 1000);
-    return `${minutes}m ${seconds}s`;
-}
-//# sourceMappingURL=agent-process.js.map

package/dist/types/agent-process.js.map

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