@compass-ai/nova 1.0.72 → 1.0.74

package/dist/services/tools-logger.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Tools logging service for tracking tool schemas and usage patterns
+ *
+ * This module provides comprehensive logging of all tools sent to the LLM API,
+ * including their schemas, sizes, and contextual metadata. This helps identify
+ * tool proliferation, schema bloat, and patterns that might affect performance.
+ *
+ * Logs are stored in JSONL format in .compass/.logs/tools-[DATE].jsonl
+ */
+import type { Tool } from '../types/anthropic.js';
+import type { AgentBudget } from '../types/agent-process.js';
+/**
+ * Schema information for a tool parameter
+ */
+export interface ParameterSchema {
+    type: string;
+    description?: string;
+    properties?: Record<string, unknown>;
+    required?: string[];
+    [key: string]: unknown;
+}
+/**
+ * Single tool entry in the log
+ */
+export interface ToolEntry {
+    name: string;
+    description: string;
+    inputSchema: ParameterSchema;
+    schemaSize: number;
+}
+/**
+ * Complete tools log entry
+ */
+export interface ToolsLogEntry {
+    /** ISO-8601 timestamp */
+    ts: string;
+    /** Session ID for correlation */
+    session_id?: string;
+    /** Trace ID for request/response correlation */
+    trace_id?: string;
+    /** Model being used */
+    model: string;
+    /** Number of tools sent */
+    toolCount: number;
+    /** Total size of all tool schemas in bytes */
+    totalSchemaSize: number;
+    /** Individual tool entries */
+    tools: ToolEntry[];
+    /** Context metadata */
+    context: {
+        /** Which agent is making this call */
+        agentType?: string;
+        /** Name of the agent */
+        agentName?: string;
+        /** Which turn/iteration this is */
+        turnNumber?: number;
+        /** Size of messages sent in bytes */
+        messagesSize?: number;
+        /** System prompt size in bytes */
+        systemPromptSize?: number;
+    };
+    /** Budget state at time of call */
+    budget?: {
+        maxTurns: number;
+        turnsUsed: number;
+        maxTokens: number;
+        tokensUsed: number;
+        turnsRemaining: number;
+        tokensRemaining: number;
+        turnPercentage: number;
+        tokenPercentage: number;
+    };
+}
+/**
+ * ToolsLogger class for tracking tool usage
+ */
+declare class ToolsLogger {
+    private projectRoot;
+    private currentLogFile;
+    private logFileInitialized;
+    private enabled;
+    private sessionId;
+    private currentTraceId;
+    constructor(projectRoot?: string);
+    /**
+     * Sets the current session ID for correlation
+     */
+    setSessionId(sessionId: string | undefined): void;
+    /**
+     * Gets the current session ID
+     */
+    getSessionId(): string | null;
+    /**
+     * Sets the current trace ID
+     */
+    setCurrentTraceId(traceId: string | undefined): void;
+    /**
+     * Gets the current trace ID
+     */
+    getCurrentTraceId(): string | null;
+    /**
+     * Sets the project root directory for logging
+     */
+    setProjectRoot(projectRoot: string): void;
+    /**
+     * Gets the project root directory
+     */
+    getProjectRoot(): string;
+    /**
+     * Enables or disables tools logging
+     */
+    setEnabled(enabled: boolean): void;
+    /**
+     * Formats a date to dd-mm-yy format for log file names
+     */
+    private formatDateForFilename;
+    /**
+     * Ensures the log file exists and returns its path
+     */
+    private ensureLogFile;
+    /**
+     * Writes a tools log entry in JSONL format
+     */
+    private writeEntry;
+    /**
+     * Calculates the size of a JSON object in bytes
+     */
+    private calculateSize;
+    /**
+     * Extracts tool entry information from Tool type
+     */
+    private extractToolEntry;
+    /**
+     * Logs tools sent to the API
+     */
+    logTools(options: {
+        model: string;
+        tools?: Tool[];
+        systemPrompt?: string;
+        messages?: unknown;
+        agentType?: string;
+        agentName?: string;
+        turnNumber?: number;
+        budget?: AgentBudget;
+    }): Promise<void>;
+}
+/**
+ * Gets or creates the tools logger singleton
+ */
+export declare function getToolsLogger(projectRoot?: string): ToolsLogger;
+export {};
+//# sourceMappingURL=tools-logger.d.ts.map

package/dist/services/tools-logger.d.ts.map

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

package/dist/services/tools-logger.js

@@ -0,0 +1,222 @@
+/**
+ * Tools logging service for tracking tool schemas and usage patterns
+ *
+ * This module provides comprehensive logging of all tools sent to the LLM API,
+ * including their schemas, sizes, and contextual metadata. This helps identify
+ * tool proliferation, schema bloat, and patterns that might affect performance.
+ *
+ * Logs are stored in JSONL format in .compass/.logs/tools-[DATE].jsonl
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { formatTimestamp } from '../utils/format.js';
+import { logger } from '../utils/logger.js';
+import { cleanupOldLogs } from '../utils/log-cleanup.js';
+/**
+ * ToolsLogger class for tracking tool usage
+ */
+class ToolsLogger {
+    projectRoot;
+    currentLogFile = null;
+    logFileInitialized = false;
+    enabled = true;
+    sessionId = null;
+    currentTraceId = null;
+    constructor(projectRoot) {
+        this.projectRoot = projectRoot || process.cwd();
+    }
+    /**
+     * Sets the current session ID for correlation
+     */
+    setSessionId(sessionId) {
+        this.sessionId = sessionId || null;
+    }
+    /**
+     * Gets the current session ID
+     */
+    getSessionId() {
+        return this.sessionId;
+    }
+    /**
+     * Sets the current trace ID
+     */
+    setCurrentTraceId(traceId) {
+        this.currentTraceId = traceId || null;
+    }
+    /**
+     * Gets the current trace ID
+     */
+    getCurrentTraceId() {
+        return this.currentTraceId;
+    }
+    /**
+     * Sets the project root directory for logging
+     */
+    setProjectRoot(projectRoot) {
+        this.projectRoot = projectRoot;
+        this.currentLogFile = null;
+        this.logFileInitialized = false;
+    }
+    /**
+     * Gets the project root directory
+     */
+    getProjectRoot() {
+        return this.projectRoot;
+    }
+    /**
+     * Enables or disables tools logging
+     */
+    setEnabled(enabled) {
+        this.enabled = enabled;
+    }
+    /**
+     * Formats a date to dd-mm-yy format for log file names
+     */
+    formatDateForFilename(date) {
+        const day = String(date.getDate()).padStart(2, '0');
+        const month = String(date.getMonth() + 1).padStart(2, '0');
+        const year = String(date.getFullYear()).slice(-2);
+        return `${day}-${month}-${year}`;
+    }
+    /**
+     * Ensures the log file exists and returns its path
+     */
+    async ensureLogFile() {
+        if (this.currentLogFile && this.logFileInitialized) {
+            return this.currentLogFile;
+        }
+        const logsDir = path.join(this.projectRoot, '.compass', '.logs');
+        try {
+            await fs.ensureDir(logsDir);
+        }
+        catch (error) {
+            logger.debug('Failed to create .logs directory', error);
+            this.enabled = false;
+            return '';
+        }
+        // Clean up old log files (runs once per directory per session)
+        await cleanupOldLogs(logsDir);
+        const dateStr = this.formatDateForFilename(new Date());
+        this.currentLogFile = path.join(logsDir, `tools-${dateStr}.jsonl`);
+        this.logFileInitialized = true;
+        return this.currentLogFile;
+    }
+    /**
+     * Writes a tools log entry in JSONL format
+     */
+    async writeEntry(entry) {
+        if (!this.enabled) {
+            return;
+        }
+        try {
+            const logFile = await this.ensureLogFile();
+            if (!logFile) {
+                return;
+            }
+            // JSONL format: one JSON object per line
+            const jsonLine = JSON.stringify(entry) + '\n';
+            await fs.appendFile(logFile, jsonLine);
+        }
+        catch (error) {
+            logger.debug('Failed to write tools log entry', error);
+        }
+    }
+    /**
+     * Calculates the size of a JSON object in bytes
+     */
+    calculateSize(obj) {
+        try {
+            return JSON.stringify(obj).length;
+        }
+        catch {
+            return 0;
+        }
+    }
+    /**
+     * Extracts tool entry information from Tool type
+     */
+    extractToolEntry(tool) {
+        const toolName = typeof tool === 'string' ? tool : 'name' in tool ? tool.name : 'unknown';
+        const toolDescription = typeof tool === 'object' && 'description' in tool ? tool.description : '';
+        const inputSchema = typeof tool === 'object' && 'input_schema' in tool
+            ? tool.input_schema
+            : { type: 'object' };
+        const schemaSize = this.calculateSize(inputSchema);
+        return {
+            name: toolName,
+            description: toolDescription,
+            inputSchema,
+            schemaSize,
+        };
+    }
+    /**
+     * Logs tools sent to the API
+     */
+    async logTools(options) {
+        if (!this.enabled || !options.tools || options.tools.length === 0) {
+            return;
+        }
+        try {
+            const toolEntries = options.tools.map((tool) => this.extractToolEntry(tool));
+            const totalSchemaSize = toolEntries.reduce((sum, tool) => sum + tool.schemaSize, 0);
+            const messagesSize = this.calculateSize(options.messages);
+            const systemPromptSize = this.calculateSize(options.systemPrompt);
+            // Calculate budget percentages if budget is provided
+            let budgetData = undefined;
+            if (options.budget) {
+                const turnsRemaining = Math.max(0, options.budget.maxTurns - options.budget.turnsUsed);
+                const tokensRemaining = Math.max(0, options.budget.maxTokens - options.budget.tokensUsed);
+                budgetData = {
+                    maxTurns: options.budget.maxTurns,
+                    turnsUsed: options.budget.turnsUsed,
+                    maxTokens: options.budget.maxTokens,
+                    tokensUsed: options.budget.tokensUsed,
+                    turnsRemaining,
+                    tokensRemaining,
+                    turnPercentage: options.budget.maxTurns > 0
+                        ? parseFloat(((options.budget.turnsUsed / options.budget.maxTurns) * 100).toFixed(1))
+                        : 0,
+                    tokenPercentage: options.budget.maxTokens > 0
+                        ? parseFloat(((options.budget.tokensUsed / options.budget.maxTokens) * 100).toFixed(1))
+                        : 0,
+                };
+            }
+            const entry = {
+                ts: formatTimestamp(),
+                session_id: this.sessionId || undefined,
+                trace_id: this.currentTraceId || undefined,
+                model: options.model,
+                toolCount: options.tools.length,
+                totalSchemaSize,
+                tools: toolEntries,
+                context: {
+                    agentType: options.agentType,
+                    agentName: options.agentName,
+                    turnNumber: options.turnNumber,
+                    messagesSize,
+                    systemPromptSize,
+                },
+                budget: budgetData,
+            };
+            await this.writeEntry(entry);
+        }
+        catch (error) {
+            logger.debug('Failed to log tools', error);
+        }
+    }
+}
+// Singleton instance
+let toolsLoggerInstance = null;
+/**
+ * Gets or creates the tools logger singleton
+ */
+export function getToolsLogger(projectRoot) {
+    if (!toolsLoggerInstance) {
+        toolsLoggerInstance = new ToolsLogger(projectRoot);
+    }
+    else if (projectRoot) {
+        toolsLoggerInstance.setProjectRoot(projectRoot);
+    }
+    return toolsLoggerInstance;
+}
+//# sourceMappingURL=tools-logger.js.map

package/dist/services/tools-logger.js.map

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

package/dist/services/update-plan-handler.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Handler for the update_plan tool.
+ *
+ * This module provides the handler function that executes when the LLM
+ * calls the update_plan tool to modify an existing implementation plan.
+ * It reuses stored context and only regenerates the plan portion.
+ */
+import type { UpdatePlanInput, UpdatePlanResult, ImplementationPlan } from '../types/workflow.js';
+import type { ToolExecutionContext } from './tool-registry.js';
+/**
+ * Input for a new task to be appended programmatically.
+ */
+export interface NewTaskInput {
+    description: string;
+    targetFiles?: string[];
+    targetElements?: string[];
+    changes?: string;
+    dependencies?: string[];
+    verificationCriteria?: string[];
+    complexity?: number;
+    requirementRefs?: string[];
+}
+/**
+ * Appends new tasks to an existing plan without calling the LLM.
+ * Generates proper task IDs, assigns correct ordering, increments the plan version,
+ * and preserves all existing tasks unchanged.
+ *
+ * @param plan - The existing implementation plan
+ * @param newTasks - Array of new task descriptions to append
+ * @returns A new plan object with the tasks appended
+ * @throws If plan is null/undefined
+ */
+export declare function appendTasksToPlan(plan: ImplementationPlan, newTasks: NewTaskInput[]): ImplementationPlan;
+/**
+ * Handler for the update_plan tool.
+ *
+ * Flow:
+ * 1. Load existing plan record from persistence
+ * 2. Get completed task IDs to preserve
+ * 3. Archive current version (optional)
+ * 4. Generate updated plan with LLM
+ * 5. Compute task diff
+ * 6. Request approval for updated plan
+ * 7. Update the plan record if approved
+ *
+ * @param input - Tool input parameters
+ * @param context - Tool execution context
+ * @returns Structured result containing the updated plan and diff
+ */
+export declare function updatePlanHandler(input: UpdatePlanInput, context: ToolExecutionContext): Promise<UpdatePlanResult>;
+/**
+ * Formats the update plan result for LLM consumption.
+ * Provides a clear summary of what changed and next steps.
+ */
+export declare function formatUpdatePlanResult(result: UpdatePlanResult): string;
+//# sourceMappingURL=update-plan-handler.d.ts.map

package/dist/services/update-plan-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-plan-handler.d.ts","sourceRoot":"","sources":["../../src/services/update-plan-handler.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAEnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAiB/D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,kBAAkB,EACxB,QAAQ,EAAE,YAAY,EAAE,GACvB,kBAAkB,CAyDpB;AA2DD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,gBAAgB,CAAC,CA6N3B;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAqCvE"}