jiva-core 0.2.2 → 0.2.3

package/dist/utils/orchestration-logger.js

@@ -0,0 +1,224 @@
+/**
+ * Orchestration Logger - Tracks Manager/Worker coordination
+ *
+ * Writes detailed logs to understand how tasks flow through the dual-agent system.
+ * Logs are written to: ~/.jiva/logs/orchestration-{timestamp}.log
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+class OrchestrationLogger {
+    static instance;
+    logFilePath = null;
+    logStream = null;
+    sessionStart;
+    constructor() {
+        this.sessionStart = new Date();
+        this.initializeLogFile();
+    }
+    static getInstance() {
+        if (!OrchestrationLogger.instance) {
+            OrchestrationLogger.instance = new OrchestrationLogger();
+        }
+        return OrchestrationLogger.instance;
+    }
+    initializeLogFile() {
+        try {
+            // Create logs directory in ~/.jiva/logs/
+            const jivaDir = path.join(os.homedir(), '.jiva', 'logs');
+            fs.mkdirSync(jivaDir, { recursive: true });
+            // Create timestamped log file
+            const timestamp = this.sessionStart.toISOString().replace(/[:.]/g, '-');
+            this.logFilePath = path.join(jivaDir, `orchestration-${timestamp}.log`);
+            // Create write stream
+            this.logStream = fs.createWriteStream(this.logFilePath, { flags: 'a' });
+            // Write header
+            this.writeHeader();
+        }
+        catch (error) {
+            console.error('Failed to initialize orchestration log file:', error);
+            this.logFilePath = null;
+            this.logStream = null;
+        }
+    }
+    writeHeader() {
+        if (!this.logStream)
+            return;
+        const header = [
+            '='.repeat(80),
+            'JIVA ORCHESTRATION LOG',
+            `Session started: ${this.sessionStart.toISOString()}`,
+            '='.repeat(80),
+            '',
+        ].join('\n');
+        this.logStream.write(header);
+    }
+    writeEvent(event) {
+        if (!this.logStream)
+            return;
+        const line = [
+            `[${event.timestamp}]`,
+            `[${event.phase}]`,
+            event.event,
+            Object.keys(event.details).length > 0 ? JSON.stringify(event.details, null, 2) : '',
+        ].filter(Boolean).join(' ');
+        this.logStream.write(line + '\n');
+    }
+    // DualAgent events
+    logUserMessage(message) {
+        this.writeEvent({
+            timestamp: new Date().toISOString(),
+            phase: 'DUAL_AGENT',
+            event: 'USER_MESSAGE',
+            details: { message },
+        });
+    }
+    logPhaseStart(phase) {
+        this.writeEvent({
+            timestamp: new Date().toISOString(),
+            phase: 'DUAL_AGENT',
+            event: `PHASE_START_${phase}`,
+            details: {},
+        });
+    }
+    logPhaseEnd(phase, durationMs) {
+        this.writeEvent({
+            timestamp: new Date().toISOString(),
+            phase: 'DUAL_AGENT',
+            event: `PHASE_END_${phase}`,
+            details: { durationMs },
+        });
+    }
+    logFinalResponse(response, totalIterations, toolsUsed) {
+        this.writeEvent({
+            timestamp: new Date().toISOString(),
+            phase: 'DUAL_AGENT',
+            event: 'FINAL_RESPONSE',
+            details: {
+                responseLength: response.length,
+                totalIterations,
+                toolsUsed,
+                uniqueTools: [...new Set(toolsUsed)],
+            },
+        });
+    }
+    // Manager events
+    logManagerCreatePlan(task, context) {
+        this.writeEvent({
+            timestamp: new Date().toISOString(),
+            phase: 'MANAGER',
+            event: 'CREATE_PLAN',
+            details: { task, context },
+        });
+    }
+    logManagerPlanCreated(subtasks, reasoning) {
+        this.writeEvent({
+            timestamp: new Date().toISOString(),
+            phase: 'MANAGER',
+            event: 'PLAN_CREATED',
+            details: {
+                subtaskCount: subtasks.length,
+                subtasks,
+                reasoning,
+            },
+        });
+    }
+    logManagerReview(subtask, workerResult) {
+        this.writeEvent({
+            timestamp: new Date().toISOString(),
+            phase: 'MANAGER',
+            event: 'REVIEW_SUBTASK',
+            details: {
+                subtask,
+                workerResultLength: workerResult.length,
+                workerResultPreview: workerResult.substring(0, 200),
+            },
+        });
+    }
+    logManagerDecision(isComplete, reasoning, nextAction) {
+        this.writeEvent({
+            timestamp: new Date().toISOString(),
+            phase: 'MANAGER',
+            event: 'DECISION',
+            details: {
+                isComplete,
+                reasoning,
+                nextAction,
+            },
+        });
+    }
+    logManagerSynthesize(resultsCount) {
+        this.writeEvent({
+            timestamp: new Date().toISOString(),
+            phase: 'MANAGER',
+            event: 'SYNTHESIZE',
+            details: { resultsCount },
+        });
+    }
+    // Worker events
+    logWorkerStart(subtask, context) {
+        this.writeEvent({
+            timestamp: new Date().toISOString(),
+            phase: 'WORKER',
+            event: 'START_SUBTASK',
+            details: { subtask, context },
+        });
+    }
+    logWorkerIteration(iteration, maxIterations) {
+        this.writeEvent({
+            timestamp: new Date().toISOString(),
+            phase: 'WORKER',
+            event: 'ITERATION',
+            details: { iteration, maxIterations },
+        });
+    }
+    logWorkerToolCall(toolName, args) {
+        this.writeEvent({
+            timestamp: new Date().toISOString(),
+            phase: 'WORKER',
+            event: 'TOOL_CALL',
+            details: { toolName, args },
+        });
+    }
+    logWorkerToolResult(toolName, success, hasImages) {
+        this.writeEvent({
+            timestamp: new Date().toISOString(),
+            phase: 'WORKER',
+            event: 'TOOL_RESULT',
+            details: { toolName, success, hasImages },
+        });
+    }
+    logWorkerComplete(success, toolsUsed, iterations) {
+        this.writeEvent({
+            timestamp: new Date().toISOString(),
+            phase: 'WORKER',
+            event: 'COMPLETE',
+            details: {
+                success,
+                toolsUsed,
+                iterations,
+                uniqueTools: [...new Set(toolsUsed)],
+            },
+        });
+    }
+    // Utility
+    getLogFilePath() {
+        return this.logFilePath;
+    }
+    close() {
+        if (this.logStream) {
+            const footer = [
+                '',
+                '='.repeat(80),
+                `Session ended: ${new Date().toISOString()}`,
+                `Duration: ${Date.now() - this.sessionStart.getTime()}ms`,
+                '='.repeat(80),
+            ].join('\n');
+            this.logStream.write(footer);
+            this.logStream.end();
+            this.logStream = null;
+        }
+    }
+}
+export const orchestrationLogger = OrchestrationLogger.getInstance();
+//# sourceMappingURL=orchestration-logger.js.map

package/dist/utils/orchestration-logger.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jiva-core",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Versatile autonomous AI agent powered by gpt-oss-120b with full MCP support. Mission-driven execution, smart conversations, and extensible tooling.",
   "main": "dist/index.js",
   "bin": {