titan-agent 5.4.2 → 5.5.6

package/dist/agent/checkpoint.js

@@ -13,7 +13,7 @@ function sessionDir(sessionId) {
 function roundFile(sessionId, round) {
   return join(sessionDir(sessionId), `round-${String(round).padStart(3, "0")}.json`);
 }
-function ensureDir(sessionId) {
+function mkdirIfNotExists(sessionId) {
   const dir = sessionDir(sessionId);
   if (!existsSync(dir)) {
     mkdirSync(dir, { recursive: true });
@@ -21,7 +21,7 @@ function ensureDir(sessionId) {
 }
 function saveCheckpoint(state) {
   try {
-    ensureDir(state.sessionId);
+    mkdirIfNotExists(state.sessionId);
     const path = roundFile(state.sessionId, state.round);
     const trimmedMessages = trimMessages(state.messages);
     const data = {

package/dist/agent/checkpoint.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/agent/checkpoint.ts"],"sourcesContent":["/**\n * TITAN — Execution Checkpointing\n *\n * Persists agent loop state after each round so tasks can be resumed\n * after crashes, restarts, or budget exhaustion. Closes the #1 gap\n * vs LangGraph's durable execution.\n *\n * Storage: ~/.titan/checkpoints/{sessionId}/round-{N}.json\n * Each checkpoint contains: messages, toolsUsed, round, model, phase.\n *\n * Usage:\n *   saveCheckpoint(sessionId, round, state);   // After each round\n *   const cp = loadCheckpoint(sessionId);       // Latest checkpoint\n *   const cp = loadCheckpoint(sessionId, 3);    // Specific round\n *   clearCheckpoints(sessionId);                 // After completion\n */\n\nimport { existsSync, mkdirSync, writeFileSync, readFileSync, readdirSync, rmSync } from 'fs';\nimport { atomicWriteJsonFile } from '../utils/helpers.js';\nimport { join } from 'path';\nimport { TITAN_HOME } from '../utils/constants.js';\nimport logger from '../utils/logger.js';\nimport type { ChatMessage } from '../providers/base.js';\n\nconst COMPONENT = 'Checkpoint';\nconst CHECKPOINTS_DIR = join(TITAN_HOME, 'checkpoints');\n\n// ── Types ───────────────────────────────────────────────────────\n\nexport interface CheckpointState {\n    sessionId: string;\n    round: number;\n    phase: string;\n    model: string;\n    messages: ChatMessage[];\n    toolsUsed: string[];\n    orderedToolSequence: string[];\n    timestamp: string;\n    message: string;             // Original user message (first 500 chars)\n    channel: string;\n    totalPromptTokens: number;\n    totalCompletionTokens: number;\n}\n\nexport interface CheckpointMeta {\n    sessionId: string;\n    rounds: number;\n    latestRound: number;\n    model: string;\n    message: string;\n    channel: string;\n    createdAt: string;\n    updatedAt: string;\n}\n\n// ── Storage ─────────────────────────────────────────────────────\n\nfunction sessionDir(sessionId: string): string {\n    // Sanitize sessionId for filesystem safety\n    const safe = sessionId.replace(/[^a-zA-Z0-9_:-]/g, '_');\n    return join(CHECKPOINTS_DIR, safe);\n}\n\nfunction roundFile(sessionId: string, round: number): string {\n    return join(sessionDir(sessionId), `round-${String(round).padStart(3, '0')}.json`);\n}\n\nfunction ensureDir(sessionId: string): void {\n    const dir = sessionDir(sessionId);\n    if (!existsSync(dir)) {\n        mkdirSync(dir, { recursive: true });\n    }\n}\n\n// ── Save ────────────────────────────────────────────────────────\n\nexport function saveCheckpoint(state: CheckpointState): void {\n    try {\n        ensureDir(state.sessionId);\n        const path = roundFile(state.sessionId, state.round);\n\n        // Trim messages to avoid huge checkpoints — keep system + last 20 messages\n        const trimmedMessages = trimMessages(state.messages);\n\n        const data: CheckpointState = {\n            ...state,\n            messages: trimmedMessages,\n            timestamp: new Date().toISOString(),\n        };\n\n        atomicWriteJsonFile(path, data);\n        logger.debug(COMPONENT, `Saved checkpoint: session=${state.sessionId} round=${state.round} messages=${trimmedMessages.length}`);\n    } catch (e) {\n        logger.warn(COMPONENT, `Failed to save checkpoint: ${(e as Error).message}`);\n    }\n}\n\nfunction trimMessages(messages: ChatMessage[]): ChatMessage[] {\n    if (messages.length <= 22) return messages;\n\n    // Keep system message + first user message + last 20 messages\n    const system = messages.find(m => m.role === 'system');\n    const firstUser = messages.find(m => m.role === 'user');\n    const recent = messages.slice(-20);\n\n    const result: ChatMessage[] = [];\n    if (system && !recent.includes(system)) result.push(system);\n    if (firstUser && !recent.includes(firstUser) && firstUser !== system) result.push(firstUser);\n    result.push(...recent);\n\n    return result;\n}\n\n// ── Load ────────────────────────────────────────────────────────\n\n/** Load the latest checkpoint for a session, or a specific round */\nexport function loadCheckpoint(sessionId: string, round?: number): CheckpointState | null {\n    try {\n        const dir = sessionDir(sessionId);\n        if (!existsSync(dir)) return null;\n\n        if (round !== undefined) {\n            const path = roundFile(sessionId, round);\n            if (!existsSync(path)) return null;\n            return JSON.parse(readFileSync(path, 'utf-8')) as CheckpointState;\n        }\n\n        // Find latest round\n        const files = readdirSync(dir)\n            .filter(f => f.startsWith('round-') && f.endsWith('.json'))\n            .sort()\n            .reverse();\n\n        if (files.length === 0) return null;\n        return JSON.parse(readFileSync(join(dir, files[0]), 'utf-8')) as CheckpointState;\n    } catch (e) {\n        logger.warn(COMPONENT, `Failed to load checkpoint: ${(e as Error).message}`);\n        return null;\n    }\n}\n\n// ── List ────────────────────────────────────────────────────────\n\n/** List all sessions with checkpoints */\nexport function listCheckpoints(): CheckpointMeta[] {\n    try {\n        if (!existsSync(CHECKPOINTS_DIR)) return [];\n\n        const sessions = readdirSync(CHECKPOINTS_DIR).filter(d => {\n            const full = join(CHECKPOINTS_DIR, d);\n            try { return existsSync(full) && readdirSync(full).some(f => f.endsWith('.json')); }\n            catch { return false; }\n        });\n\n        return sessions.map(sessionId => {\n            const dir = join(CHECKPOINTS_DIR, sessionId);\n            const files = readdirSync(dir).filter(f => f.startsWith('round-') && f.endsWith('.json')).sort();\n\n            if (files.length === 0) return null;\n\n            const latest = JSON.parse(readFileSync(join(dir, files[files.length - 1]), 'utf-8')) as CheckpointState;\n            const first = JSON.parse(readFileSync(join(dir, files[0]), 'utf-8')) as CheckpointState;\n\n            return {\n                sessionId: latest.sessionId,\n                rounds: files.length,\n                latestRound: latest.round,\n                model: latest.model,\n                message: latest.message,\n                channel: latest.channel,\n                createdAt: first.timestamp,\n                updatedAt: latest.timestamp,\n            } as CheckpointMeta;\n        }).filter((m): m is CheckpointMeta => m !== null);\n    } catch {\n        return [];\n    }\n}\n\n// ── Clear ───────────────────────────────────────────────────────\n\n/** Clear all checkpoints for a session (call after successful completion) */\nexport function clearCheckpoints(sessionId: string): void {\n    try {\n        const dir = sessionDir(sessionId);\n        if (existsSync(dir)) {\n            rmSync(dir, { recursive: true, force: true });\n            logger.debug(COMPONENT, `Cleared checkpoints for session ${sessionId}`);\n        }\n    } catch (e) {\n        logger.warn(COMPONENT, `Failed to clear checkpoints: ${(e as Error).message}`);\n    }\n}\n\n/** Clear all expired checkpoints (older than maxAge ms, default 24h) */\nexport function clearExpiredCheckpoints(maxAgeMs: number = 24 * 60 * 60 * 1000): number {\n    let cleared = 0;\n    try {\n        if (!existsSync(CHECKPOINTS_DIR)) return 0;\n\n        const now = Date.now();\n        for (const sessionId of readdirSync(CHECKPOINTS_DIR)) {\n            const dir = join(CHECKPOINTS_DIR, sessionId);\n            const files = readdirSync(dir).filter(f => f.endsWith('.json')).sort().reverse();\n            if (files.length === 0) continue;\n\n            try {\n                const latest = JSON.parse(readFileSync(join(dir, files[0]), 'utf-8')) as CheckpointState;\n                const age = now - new Date(latest.timestamp).getTime();\n                if (age > maxAgeMs) {\n                    rmSync(dir, { recursive: true, force: true });\n                    cleared++;\n                }\n            } catch { /* skip corrupted */ }\n        }\n\n        if (cleared > 0) {\n            logger.info(COMPONENT, `Cleared ${cleared} expired checkpoint sessions`);\n        }\n    } catch { /* non-critical */ }\n    return cleared;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/agent/checkpoint.ts"],"sourcesContent":["/**\n * TITAN — Execution Checkpointing\n *\n * Persists agent loop state after each round so tasks can be resumed\n * after crashes, restarts, or budget exhaustion. Closes the #1 gap\n * vs LangGraph's durable execution.\n *\n * Storage: ~/.titan/checkpoints/{sessionId}/round-{N}.json\n * Each checkpoint contains: messages, toolsUsed, round, model, phase.\n *\n * Usage:\n *   saveCheckpoint(sessionId, round, state);   // After each round\n *   const cp = loadCheckpoint(sessionId);       // Latest checkpoint\n *   const cp = loadCheckpoint(sessionId, 3);    // Specific round\n *   clearCheckpoints(sessionId);                 // After completion\n */\n\nimport { existsSync, mkdirSync, writeFileSync, readFileSync, readdirSync, rmSync } from 'fs';\nimport { atomicWriteJsonFile } from '../utils/helpers.js';\nimport { join } from 'path';\nimport { TITAN_HOME } from '../utils/constants.js';\nimport logger from '../utils/logger.js';\nimport type { ChatMessage } from '../providers/base.js';\n\nconst COMPONENT = 'Checkpoint';\nconst CHECKPOINTS_DIR = join(TITAN_HOME, 'checkpoints');\n\n// ── Types ───────────────────────────────────────────────────────\n\nexport interface CheckpointState {\n    sessionId: string;\n    round: number;\n    phase: string;\n    model: string;\n    messages: ChatMessage[];\n    toolsUsed: string[];\n    orderedToolSequence: string[];\n    timestamp: string;\n    message: string;             // Original user message (first 500 chars)\n    channel: string;\n    totalPromptTokens: number;\n    totalCompletionTokens: number;\n}\n\nexport interface CheckpointMeta {\n    sessionId: string;\n    rounds: number;\n    latestRound: number;\n    model: string;\n    message: string;\n    channel: string;\n    createdAt: string;\n    updatedAt: string;\n}\n\n// ── Storage ─────────────────────────────────────────────────────\n\nfunction sessionDir(sessionId: string): string {\n    // Sanitize sessionId for filesystem safety\n    const safe = sessionId.replace(/[^a-zA-Z0-9_:-]/g, '_');\n    return join(CHECKPOINTS_DIR, safe);\n}\n\nfunction roundFile(sessionId: string, round: number): string {\n    return join(sessionDir(sessionId), `round-${String(round).padStart(3, '0')}.json`);\n}\n\nfunction mkdirIfNotExists(sessionId: string): void {\n    const dir = sessionDir(sessionId);\n    if (!existsSync(dir)) {\n        mkdirSync(dir, { recursive: true });\n    }\n}\n\n// ── Save ────────────────────────────────────────────────────────\n\nexport function saveCheckpoint(state: CheckpointState): void {\n    try {\n        mkdirIfNotExists(state.sessionId);\n        const path = roundFile(state.sessionId, state.round);\n\n        // Trim messages to avoid huge checkpoints — keep system + last 20 messages\n        const trimmedMessages = trimMessages(state.messages);\n\n        const data: CheckpointState = {\n            ...state,\n            messages: trimmedMessages,\n            timestamp: new Date().toISOString(),\n        };\n\n        atomicWriteJsonFile(path, data);\n        logger.debug(COMPONENT, `Saved checkpoint: session=${state.sessionId} round=${state.round} messages=${trimmedMessages.length}`);\n    } catch (e) {\n        logger.warn(COMPONENT, `Failed to save checkpoint: ${(e as Error).message}`);\n    }\n}\n\nfunction trimMessages(messages: ChatMessage[]): ChatMessage[] {\n    if (messages.length <= 22) return messages;\n\n    // Keep system message + first user message + last 20 messages\n    const system = messages.find(m => m.role === 'system');\n    const firstUser = messages.find(m => m.role === 'user');\n    const recent = messages.slice(-20);\n\n    const result: ChatMessage[] = [];\n    if (system && !recent.includes(system)) result.push(system);\n    if (firstUser && !recent.includes(firstUser) && firstUser !== system) result.push(firstUser);\n    result.push(...recent);\n\n    return result;\n}\n\n// ── Load ────────────────────────────────────────────────────────\n\n/** Load the latest checkpoint for a session, or a specific round */\nexport function loadCheckpoint(sessionId: string, round?: number): CheckpointState | null {\n    try {\n        const dir = sessionDir(sessionId);\n        if (!existsSync(dir)) return null;\n\n        if (round !== undefined) {\n            const path = roundFile(sessionId, round);\n            if (!existsSync(path)) return null;\n            return JSON.parse(readFileSync(path, 'utf-8')) as CheckpointState;\n        }\n\n        // Find latest round\n        const files = readdirSync(dir)\n            .filter(f => f.startsWith('round-') && f.endsWith('.json'))\n            .sort()\n            .reverse();\n\n        if (files.length === 0) return null;\n        return JSON.parse(readFileSync(join(dir, files[0]), 'utf-8')) as CheckpointState;\n    } catch (e) {\n        logger.warn(COMPONENT, `Failed to load checkpoint: ${(e as Error).message}`);\n        return null;\n    }\n}\n\n// ── List ────────────────────────────────────────────────────────\n\n/** List all sessions with checkpoints */\nexport function listCheckpoints(): CheckpointMeta[] {\n    try {\n        if (!existsSync(CHECKPOINTS_DIR)) return [];\n\n        const sessions = readdirSync(CHECKPOINTS_DIR).filter(d => {\n            const full = join(CHECKPOINTS_DIR, d);\n            try { return existsSync(full) && readdirSync(full).some(f => f.endsWith('.json')); }\n            catch { return false; }\n        });\n\n        return sessions.map(sessionId => {\n            const dir = join(CHECKPOINTS_DIR, sessionId);\n            const files = readdirSync(dir).filter(f => f.startsWith('round-') && f.endsWith('.json')).sort();\n\n            if (files.length === 0) return null;\n\n            const latest = JSON.parse(readFileSync(join(dir, files[files.length - 1]), 'utf-8')) as CheckpointState;\n            const first = JSON.parse(readFileSync(join(dir, files[0]), 'utf-8')) as CheckpointState;\n\n            return {\n                sessionId: latest.sessionId,\n                rounds: files.length,\n                latestRound: latest.round,\n                model: latest.model,\n                message: latest.message,\n                channel: latest.channel,\n                createdAt: first.timestamp,\n                updatedAt: latest.timestamp,\n            } as CheckpointMeta;\n        }).filter((m): m is CheckpointMeta => m !== null);\n    } catch {\n        return [];\n    }\n}\n\n// ── Clear ───────────────────────────────────────────────────────\n\n/** Clear all checkpoints for a session (call after successful completion) */\nexport function clearCheckpoints(sessionId: string): void {\n    try {\n        const dir = sessionDir(sessionId);\n        if (existsSync(dir)) {\n            rmSync(dir, { recursive: true, force: true });\n            logger.debug(COMPONENT, `Cleared checkpoints for session ${sessionId}`);\n        }\n    } catch (e) {\n        logger.warn(COMPONENT, `Failed to clear checkpoints: ${(e as Error).message}`);\n    }\n}\n\n/** Clear all expired checkpoints (older than maxAge ms, default 24h) */\nexport function clearExpiredCheckpoints(maxAgeMs: number = 24 * 60 * 60 * 1000): number {\n    let cleared = 0;\n    try {\n        if (!existsSync(CHECKPOINTS_DIR)) return 0;\n\n        const now = Date.now();\n        for (const sessionId of readdirSync(CHECKPOINTS_DIR)) {\n            const dir = join(CHECKPOINTS_DIR, sessionId);\n            const files = readdirSync(dir).filter(f => f.endsWith('.json')).sort().reverse();\n            if (files.length === 0) continue;\n\n            try {\n                const latest = JSON.parse(readFileSync(join(dir, files[0]), 'utf-8')) as CheckpointState;\n                const age = now - new Date(latest.timestamp).getTime();\n                if (age > maxAgeMs) {\n                    rmSync(dir, { recursive: true, force: true });\n                    cleared++;\n                }\n            } catch { /* skip corrupted */ }\n        }\n\n        if (cleared > 0) {\n            logger.info(COMPONENT, `Cleared ${cleared} expired checkpoint sessions`);\n        }\n    } catch { /* non-critical */ }\n    return cleared;\n}\n"],"mappings":"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","names":[]}

package/dist/agent/commandPost.js

@@ -4,7 +4,7 @@ import { existsSync, readFileSync, writeFileSync, appendFileSync } from "fs";
 import { spawn } from "child_process";
 import { join } from "path";
 import { TITAN_HOME } from "../utils/constants.js";
-import { ensureDir } from "../utils/helpers.js";
+import { mkdirIfNotExists } from "../utils/helpers.js";
 import { titanEvents } from "./daemon.js";
 import { spawnAgent, stopAgent, listAgents } from "./multiAgent.js";
 import { listGoals } from "./goals.js";
@@ -53,7 +53,7 @@ function loadState() {
 }
 function saveState() {
   try {
-    ensureDir(TITAN_HOME);
+    mkdirIfNotExists(TITAN_HOME);
     const state = {
       checkouts: Array.from(checkouts.values()),
       budgetPolicies,
@@ -534,7 +534,7 @@ function getDashboard() {
 function initCommandPost(cfg) {
   if (initialized) return;
   config = cfg;
-  ensureDir(TITAN_HOME);
+  mkdirIfNotExists(TITAN_HOME);
   loadState();
   syncAgentRegistry();
   sweepInterval = setInterval(sweepExpiredCheckouts, 6e4);