sessionlog 0.0.1

package/dist/agent/agents/opencode.js

@@ -0,0 +1,423 @@
+/**
+ * OpenCode Agent
+ *
+ * Implementation of the Entire agent interface for OpenCode.
+ * Handles JSON export format with messages array, OpenCode-specific
+ * plugin-based hook installation, and session lifecycle management.
+ *
+ * OpenCode uses `opencode export` CLI command for transcript access.
+ * Sessions are stored in JSON format: { info: {...}, messages: [...] }
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import { AGENT_NAMES, AGENT_TYPES, EventType, emptyTokenUsage, } from '../../types.js';
+import { registerAgent } from '../registry.js';
+// ============================================================================
+// Constants
+// ============================================================================
+const OPENCODE_DIR = '.opencode';
+const HOOK_NAMES = [
+    'session-start',
+    'session-end',
+    'turn-start',
+    'turn-end',
+    'compaction',
+];
+/** Tools that modify files in OpenCode */
+const FILE_MODIFICATION_TOOLS = new Set(['edit', 'write', 'patch']);
+const ENTIRE_PLUGIN_MARKER = 'Auto-generated by `entire enable --agent opencode`';
+// ============================================================================
+// OpenCode Agent Implementation
+// ============================================================================
+class OpenCodeAgent {
+    name = AGENT_NAMES.OPENCODE;
+    type = AGENT_TYPES.OPENCODE;
+    description = 'OpenCode - AI-powered terminal coding agent';
+    isPreview = true;
+    protectedDirs = [OPENCODE_DIR];
+    async detectPresence(cwd) {
+        const repoRoot = cwd ?? process.cwd();
+        try {
+            await fs.promises.stat(path.join(repoRoot, OPENCODE_DIR));
+            return true;
+        }
+        catch {
+            try {
+                await fs.promises.stat(path.join(repoRoot, 'opencode.json'));
+                return true;
+            }
+            catch {
+                return false;
+            }
+        }
+    }
+    async getSessionDir(repoPath) {
+        if (process.env.ENTIRE_TEST_OPENCODE_PROJECT_DIR) {
+            return process.env.ENTIRE_TEST_OPENCODE_PROJECT_DIR;
+        }
+        const projectDir = sanitizePathForOpenCode(repoPath);
+        return path.join(os.tmpdir(), 'entire-opencode', projectDir);
+    }
+    getSessionID(input) {
+        return input.sessionID;
+    }
+    resolveSessionFile(sessionDir, agentSessionID) {
+        return path.join(sessionDir, `${agentSessionID}.json`);
+    }
+    async readTranscript(sessionRef) {
+        return fs.promises.readFile(sessionRef);
+    }
+    formatResumeCommand(sessionID) {
+        if (!sessionID.trim())
+            return 'opencode';
+        return `opencode -s ${sessionID}`;
+    }
+    // ===========================================================================
+    // HookSupport
+    // ===========================================================================
+    hookNames() {
+        return [...HOOK_NAMES];
+    }
+    parseHookEvent(hookName, stdin) {
+        try {
+            const data = JSON.parse(stdin);
+            const sessionID = String(data.session_id ?? data.sessionID ?? '');
+            switch (hookName) {
+                case 'session-start':
+                    return {
+                        type: EventType.SessionStart,
+                        sessionID,
+                        sessionRef: '',
+                        timestamp: new Date(),
+                    };
+                case 'turn-start':
+                    return {
+                        type: EventType.TurnStart,
+                        sessionID,
+                        sessionRef: '',
+                        prompt: String(data.prompt ?? ''),
+                        timestamp: new Date(),
+                    };
+                case 'turn-end':
+                    return {
+                        type: EventType.TurnEnd,
+                        sessionID,
+                        sessionRef: '',
+                        timestamp: new Date(),
+                    };
+                case 'compaction':
+                    return {
+                        type: EventType.Compaction,
+                        sessionID,
+                        sessionRef: '',
+                        timestamp: new Date(),
+                    };
+                case 'session-end':
+                    return {
+                        type: EventType.SessionEnd,
+                        sessionID,
+                        sessionRef: '',
+                        timestamp: new Date(),
+                    };
+                default:
+                    return null;
+            }
+        }
+        catch {
+            return null;
+        }
+    }
+    async installHooks(repoPath, force = false) {
+        const pluginPath = path.join(repoPath, OPENCODE_DIR, 'plugins', 'entire.ts');
+        // Check if already installed
+        if (!force) {
+            try {
+                const content = await fs.promises.readFile(pluginPath, 'utf-8');
+                if (content.includes(ENTIRE_PLUGIN_MARKER))
+                    return 0;
+            }
+            catch {
+                // File doesn't exist, proceed with install
+            }
+        }
+        // Create plugin directory
+        await fs.promises.mkdir(path.dirname(pluginPath), { recursive: true });
+        // Write the plugin file
+        const pluginContent = generateOpenCodePlugin();
+        await fs.promises.writeFile(pluginPath, pluginContent, 'utf-8');
+        return 5; // 5 lifecycle hooks
+    }
+    async uninstallHooks(repoPath) {
+        const pluginPath = path.join(repoPath, OPENCODE_DIR, 'plugins', 'entire.ts');
+        try {
+            const content = await fs.promises.readFile(pluginPath, 'utf-8');
+            if (content.includes(ENTIRE_PLUGIN_MARKER)) {
+                await fs.promises.unlink(pluginPath);
+            }
+        }
+        catch {
+            // File doesn't exist
+        }
+    }
+    async areHooksInstalled(repoPath) {
+        const pluginPath = path.join(repoPath, OPENCODE_DIR, 'plugins', 'entire.ts');
+        try {
+            const content = await fs.promises.readFile(pluginPath, 'utf-8');
+            return content.includes(ENTIRE_PLUGIN_MARKER);
+        }
+        catch {
+            return false;
+        }
+    }
+    // ===========================================================================
+    // TranscriptAnalyzer
+    // ===========================================================================
+    async getTranscriptPosition(transcriptPath) {
+        try {
+            const data = await fs.promises.readFile(transcriptPath, 'utf-8');
+            const session = JSON.parse(data);
+            return session.messages?.length ?? 0;
+        }
+        catch {
+            return 0;
+        }
+    }
+    async extractModifiedFilesFromOffset(transcriptPath, startOffset) {
+        const data = await fs.promises.readFile(transcriptPath, 'utf-8');
+        const session = JSON.parse(data);
+        const files = new Set();
+        for (let i = startOffset; i < session.messages.length; i++) {
+            const msg = session.messages[i];
+            if (msg.info.role !== 'assistant')
+                continue;
+            for (const part of msg.parts) {
+                if (part.type !== 'tool' || !part.state)
+                    continue;
+                if (!FILE_MODIFICATION_TOOLS.has(part.tool ?? ''))
+                    continue;
+                const filePath = extractOpenCodeFilePath(part.state.input ?? {});
+                if (filePath)
+                    files.add(filePath);
+            }
+        }
+        return { files: Array.from(files), currentPosition: session.messages.length };
+    }
+    async extractPrompts(sessionRef, fromOffset) {
+        const data = await fs.promises.readFile(sessionRef, 'utf-8');
+        const session = JSON.parse(data);
+        const prompts = [];
+        for (let i = fromOffset; i < session.messages.length; i++) {
+            const msg = session.messages[i];
+            if (msg.info.role !== 'user')
+                continue;
+            const content = extractTextFromParts(msg.parts);
+            if (content)
+                prompts.push(content);
+        }
+        return prompts;
+    }
+    async extractSummary(sessionRef) {
+        const data = await fs.promises.readFile(sessionRef, 'utf-8');
+        const session = JSON.parse(data);
+        for (let i = session.messages.length - 1; i >= 0; i--) {
+            const msg = session.messages[i];
+            if (msg.info.role === 'assistant') {
+                const content = extractTextFromParts(msg.parts);
+                if (content)
+                    return content;
+            }
+        }
+        return '';
+    }
+    // ===========================================================================
+    // TokenCalculator
+    // ===========================================================================
+    async calculateTokenUsage(transcriptData, fromOffset) {
+        const usage = emptyTokenUsage();
+        try {
+            const session = JSON.parse(transcriptData.toString('utf-8'));
+            for (let i = fromOffset; i < session.messages.length; i++) {
+                const msg = session.messages[i];
+                if (msg.info.role !== 'assistant' || !msg.info.tokens)
+                    continue;
+                usage.inputTokens += msg.info.tokens.input ?? 0;
+                usage.outputTokens += msg.info.tokens.output ?? 0;
+                usage.cacheReadTokens += msg.info.tokens.cache?.read ?? 0;
+                usage.cacheCreationTokens += msg.info.tokens.cache?.write ?? 0;
+                usage.apiCallCount++;
+            }
+        }
+        catch {
+            // Invalid transcript data
+        }
+        return usage;
+    }
+    // ===========================================================================
+    // TranscriptChunker
+    // ===========================================================================
+    async chunkTranscript(content, maxSize) {
+        try {
+            const session = JSON.parse(content.toString('utf-8'));
+            if (!session.messages?.length)
+                return [content];
+            const infoStr = JSON.stringify(session.info);
+            const baseSize = Buffer.byteLength(`{"info":${infoStr},"messages":[]}`);
+            const chunks = [];
+            let currentMessages = [];
+            let currentSize = baseSize;
+            for (const msg of session.messages) {
+                const msgStr = JSON.stringify(msg);
+                const msgSize = Buffer.byteLength(msgStr) + 1; // +1 for comma
+                if (currentSize + msgSize > maxSize && currentMessages.length > 0) {
+                    chunks.push(Buffer.from(JSON.stringify({ info: session.info, messages: currentMessages })));
+                    currentMessages = [];
+                    currentSize = baseSize;
+                }
+                currentMessages.push(msg);
+                currentSize += msgSize;
+            }
+            if (currentMessages.length > 0) {
+                chunks.push(Buffer.from(JSON.stringify({ info: session.info, messages: currentMessages })));
+            }
+            return chunks.length > 0 ? chunks : [content];
+        }
+        catch {
+            return [content];
+        }
+    }
+    async reassembleTranscript(chunks) {
+        const allMessages = [];
+        let sessionInfo;
+        for (const chunk of chunks) {
+            const session = JSON.parse(chunk.toString('utf-8'));
+            if (!sessionInfo)
+                sessionInfo = session.info;
+            allMessages.push(...(session.messages ?? []));
+        }
+        return Buffer.from(JSON.stringify({ info: sessionInfo ?? { id: '' }, messages: allMessages }));
+    }
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+const nonAlphanumericRegex = /[^a-zA-Z0-9]/g;
+function sanitizePathForOpenCode(repoPath) {
+    return repoPath.replace(nonAlphanumericRegex, '-');
+}
+function extractOpenCodeFilePath(input) {
+    for (const key of ['filePath', 'path']) {
+        if (typeof input[key] === 'string' && input[key])
+            return input[key];
+    }
+    return '';
+}
+/**
+ * Extract text content from OpenCode message parts.
+ */
+export function extractTextFromParts(parts) {
+    const texts = [];
+    for (const part of parts) {
+        if (part.type === 'text' && part.text) {
+            texts.push(part.text);
+        }
+    }
+    return texts.join('\n');
+}
+/**
+ * Parse an OpenCode export session from raw bytes.
+ */
+export function parseExportSession(data) {
+    const str = typeof data === 'string' ? data : data.toString('utf-8');
+    if (!str.trim())
+        return null;
+    return JSON.parse(str);
+}
+/**
+ * Extract all user prompts from raw export JSON.
+ */
+export function extractAllUserPrompts(data) {
+    const session = parseExportSession(data);
+    if (!session)
+        return [];
+    const prompts = [];
+    for (const msg of session.messages) {
+        if (msg.info.role !== 'user')
+            continue;
+        const content = extractTextFromParts(msg.parts);
+        if (content)
+            prompts.push(content);
+    }
+    return prompts;
+}
+/**
+ * Generate the OpenCode plugin TypeScript source.
+ */
+function generateOpenCodePlugin() {
+    return `// ${ENTIRE_PLUGIN_MARKER}
+// This plugin integrates OpenCode with Entire for session tracking.
+// Do not edit manually.
+
+import type { Plugin } from "opencode";
+
+const plugin: Plugin = {
+  name: "entire",
+  hooks: {
+    "session.start": async ({ session }) => {
+      const payload = JSON.stringify({ session_id: session.id });
+      const proc = Bun.spawn(["entire", "hooks", "opencode", "session-start"], {
+        stdin: new Blob([payload]),
+        stdout: "ignore",
+        stderr: "ignore",
+      });
+      await proc.exited;
+    },
+    "session.end": async ({ session }) => {
+      const payload = JSON.stringify({ session_id: session.id });
+      const proc = Bun.spawn(["entire", "hooks", "opencode", "session-end"], {
+        stdin: new Blob([payload]),
+        stdout: "ignore",
+        stderr: "ignore",
+      });
+      await proc.exited;
+    },
+    "message.create": async ({ message, session }) => {
+      if (message.role === "user") {
+        const text = message.parts
+          .filter((p: { type: string }) => p.type === "text")
+          .map((p: { text: string }) => p.text)
+          .join("\\n");
+        const payload = JSON.stringify({ session_id: session.id, prompt: text });
+        const proc = Bun.spawn(["entire", "hooks", "opencode", "turn-start"], {
+          stdin: new Blob([payload]),
+          stdout: "ignore",
+          stderr: "ignore",
+        });
+        await proc.exited;
+      }
+    },
+    "message.complete": async ({ message, session }) => {
+      if (message.role === "assistant") {
+        const payload = JSON.stringify({ session_id: session.id });
+        const proc = Bun.spawn(["entire", "hooks", "opencode", "turn-end"], {
+          stdin: new Blob([payload]),
+          stdout: "ignore",
+          stderr: "ignore",
+        });
+        await proc.exited;
+      }
+    },
+  },
+};
+
+export default plugin;
+`;
+}
+// ============================================================================
+// Registration
+// ============================================================================
+export function createOpenCodeAgent() {
+    return new OpenCodeAgent();
+}
+registerAgent(AGENT_NAMES.OPENCODE, () => new OpenCodeAgent());
+//# sourceMappingURL=opencode.js.map

package/dist/agent/agents/opencode.js.map

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

package/dist/agent/registry.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Agent Registry
+ *
+ * Central registry for AI agent implementations. Agents register
+ * themselves via factory functions and are discovered at runtime.
+ */
+import type { AgentName, AgentType } from '../types.js';
+import type { Agent } from './types.js';
+export type AgentFactory = () => Agent;
+/**
+ * Register an agent factory
+ */
+export declare function registerAgent(name: AgentName, factory: AgentFactory): void;
+/**
+ * Get an agent by name
+ */
+export declare function getAgent(name: AgentName): Agent | null;
+/**
+ * List all registered agent names (sorted)
+ */
+export declare function listAgentNames(): AgentName[];
+/**
+ * Get all registered agents
+ */
+export declare function listAgents(): Agent[];
+/**
+ * Detect which agents are present in the current environment
+ */
+export declare function detectAgents(cwd?: string): Promise<Agent[]>;
+/**
+ * Auto-detect the first present agent
+ */
+export declare function detectAgent(cwd?: string): Promise<Agent | null>;
+/**
+ * Get an agent by its human-readable type
+ */
+export declare function getAgentByType(agentType: AgentType): Agent | null;
+/**
+ * Get the default agent
+ */
+export declare function getDefaultAgent(): Agent | null;
+/**
+ * Get the union of all protected directories across all agents
+ */
+export declare function allProtectedDirs(): string[];
+/**
+ * Resolve an agent name, trying exact match then type match
+ */
+export declare function resolveAgent(nameOrType: string): Agent | null;
+/**
+ * Reset the registry (for testing)
+ */
+export declare function resetRegistry(): void;
+//# sourceMappingURL=registry.d.ts.map

package/dist/agent/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/agent/registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAMxC,MAAM,MAAM,YAAY,GAAG,MAAM,KAAK,CAAC;AASvC;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAG1E;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,KAAK,GAAG,IAAI,CAUtD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,SAAS,EAAE,CAE5C;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,KAAK,EAAE,CAEpC;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAgBjE;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAGrE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,KAAK,GAAG,IAAI,CAMjE;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,KAAK,GAAG,IAAI,CAE9C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAW3C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAO7D;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAGpC"}

package/dist/agent/registry.js

@@ -0,0 +1,123 @@
+/**
+ * Agent Registry
+ *
+ * Central registry for AI agent implementations. Agents register
+ * themselves via factory functions and are discovered at runtime.
+ */
+import { DEFAULT_AGENT_NAME } from '../types.js';
+// ============================================================================
+// Registry
+// ============================================================================
+const agents = new Map();
+let cachedInstances = new Map();
+/**
+ * Register an agent factory
+ */
+export function registerAgent(name, factory) {
+    agents.set(name, factory);
+    cachedInstances.delete(name);
+}
+/**
+ * Get an agent by name
+ */
+export function getAgent(name) {
+    const cached = cachedInstances.get(name);
+    if (cached)
+        return cached;
+    const factory = agents.get(name);
+    if (!factory)
+        return null;
+    const instance = factory();
+    cachedInstances.set(name, instance);
+    return instance;
+}
+/**
+ * List all registered agent names (sorted)
+ */
+export function listAgentNames() {
+    return Array.from(agents.keys()).sort();
+}
+/**
+ * Get all registered agents
+ */
+export function listAgents() {
+    return listAgentNames().map((name) => getAgent(name));
+}
+/**
+ * Detect which agents are present in the current environment
+ */
+export async function detectAgents(cwd) {
+    const detected = [];
+    for (const name of listAgentNames()) {
+        const agent = getAgent(name);
+        if (!agent)
+            continue;
+        try {
+            const present = await agent.detectPresence(cwd);
+            if (present)
+                detected.push(agent);
+        }
+        catch {
+            // Skip agents that fail detection
+        }
+    }
+    return detected;
+}
+/**
+ * Auto-detect the first present agent
+ */
+export async function detectAgent(cwd) {
+    const agents = await detectAgents(cwd);
+    return agents[0] ?? null;
+}
+/**
+ * Get an agent by its human-readable type
+ */
+export function getAgentByType(agentType) {
+    for (const name of listAgentNames()) {
+        const agent = getAgent(name);
+        if (agent && agent.type === agentType)
+            return agent;
+    }
+    return null;
+}
+/**
+ * Get the default agent
+ */
+export function getDefaultAgent() {
+    return getAgent(DEFAULT_AGENT_NAME);
+}
+/**
+ * Get the union of all protected directories across all agents
+ */
+export function allProtectedDirs() {
+    const dirs = new Set();
+    for (const name of listAgentNames()) {
+        const agent = getAgent(name);
+        if (agent) {
+            for (const dir of agent.protectedDirs) {
+                dirs.add(dir);
+            }
+        }
+    }
+    return Array.from(dirs);
+}
+/**
+ * Resolve an agent name, trying exact match then type match
+ */
+export function resolveAgent(nameOrType) {
+    // Try exact name match
+    const byName = getAgent(nameOrType);
+    if (byName)
+        return byName;
+    // Try type match
+    return getAgentByType(nameOrType);
+}
+/**
+ * Reset the registry (for testing)
+ */
+export function resetRegistry() {
+    agents.clear();
+    cachedInstances = new Map();
+}
+//# sourceMappingURL=registry.js.map

package/dist/agent/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/agent/registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AASjD,+EAA+E;AAC/E,WAAW;AACX,+EAA+E;AAE/E,MAAM,MAAM,GAAG,IAAI,GAAG,EAA2B,CAAC;AAClD,IAAI,eAAe,GAAG,IAAI,GAAG,EAAoB,CAAC;AAElD;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAe,EAAE,OAAqB;IAClE,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1B,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAe;IACtC,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,MAAM,QAAQ,GAAG,OAAO,EAAE,CAAC;IAC3B,eAAe,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACpC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,cAAc,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAE,CAAC,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAY;IAC7C,MAAM,QAAQ,GAAY,EAAE,CAAC;IAE7B,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK;YAAE,SAAS;QAErB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;YAChD,IAAI,OAAO;gBAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,kCAAkC;QACpC,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAY;IAC5C,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC;IACvC,OAAO,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,SAAoB;IACjD,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;IACtD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,QAAQ,CAAC,kBAAkB,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;gBACtC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAChB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,UAAkB;IAC7C,uBAAuB;IACvB,MAAM,MAAM,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;IACpC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,iBAAiB;IACjB,OAAO,cAAc,CAAC,UAAU,CAAC,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,CAAC,KAAK,EAAE,CAAC;IACf,eAAe,GAAG,IAAI,GAAG,EAAE,CAAC;AAC9B,CAAC"}

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

@@ -0,0 +1,45 @@
+/**
+ * Normalized Agent Session Type
+ *
+ * A shared, agent-agnostic representation of a coding session with typed
+ * entries. This provides a uniform interface for cross-agent operations.
+ *
+ * Ported from Go: agent/session.go
+ */
+import type { AgentType } from '../types.js';
+export declare const enum EntryType {
+    User = "user",
+    Assistant = "assistant",
+    Tool = "tool",
+    System = "system"
+}
+export interface SessionEntry {
+    type: EntryType;
+    uuid?: string;
+    timestamp?: string;
+    text?: string;
+    toolName?: string;
+    toolInput?: unknown;
+    toolResult?: unknown;
+}
+export interface AgentSession {
+    readonly agentType: AgentType;
+    readonly sessionID: string;
+    readonly entries: SessionEntry[];
+    /** Get the last user prompt text */
+    getLastUserPrompt(): string;
+    /** Get all user prompts */
+    getUserPrompts(): string[];
+    /** Get the total number of entries */
+    length(): number;
+    /** Truncate the session at a specific UUID (for partial replay) */
+    truncateAtUUID(uuid: string): AgentSession;
+    /** Find the tool result entry for a given tool use UUID */
+    findToolResultByUUID(uuid: string): SessionEntry | undefined;
+    /** Get all entries of a specific type */
+    getEntriesByType(type: EntryType): SessionEntry[];
+    /** Get entries from a specific offset */
+    slice(fromOffset: number): SessionEntry[];
+}
+export declare function createAgentSession(agentType: AgentType, sessionID: string, entries: SessionEntry[]): AgentSession;
+//# sourceMappingURL=session-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-types.d.ts","sourceRoot":"","sources":["../../src/agent/session-types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAM7C,0BAAkB,SAAS;IACzB,IAAI,SAAS;IACb,SAAS,cAAc;IACvB,IAAI,SAAS;IACb,MAAM,WAAW;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAMD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE,CAAC;IAEjC,oCAAoC;IACpC,iBAAiB,IAAI,MAAM,CAAC;IAE5B,2BAA2B;IAC3B,cAAc,IAAI,MAAM,EAAE,CAAC;IAE3B,sCAAsC;IACtC,MAAM,IAAI,MAAM,CAAC;IAEjB,mEAAmE;IACnE,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAAC;IAE3C,2DAA2D;IAC3D,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;IAE7D,yCAAyC;IACzC,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,YAAY,EAAE,CAAC;IAElD,yCAAyC;IACzC,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,EAAE,CAAC;CAC3C;AAMD,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,YAAY,EAAE,GACtB,YAAY,CAyCd"}