@termfleet/core 0.1.0

package/dist/agent-session.d.ts

@@ -0,0 +1,380 @@
+export type ClaudeSessionMessage = {
+    blocks: ClaudeMessageBlock[];
+    role: "assistant" | "user";
+    text: string;
+    stopReason?: string;
+    timestamp?: string;
+};
+export type AgentSessionMessageSummary = {
+    role: "assistant" | "developer" | "user";
+    text: string;
+    timestamp?: string;
+};
+export type ClaudeMessageBlock = {
+    kind: "text";
+    text: string;
+} | {
+    kind: "thinking";
+    text: string;
+} | {
+    input: string;
+    kind: "tool_use";
+    name: string;
+    toolUseId?: string;
+} | {
+    isError: boolean;
+    kind: "tool_result";
+    text: string;
+    toolUseId?: string;
+} | {
+    blockType: string;
+    kind: "unknown";
+    text: string;
+};
+export type ClaudeTimelineItem = {
+    kind: "claude_user_message";
+    text: string;
+    timestamp?: string;
+} | {
+    blocks: ClaudeMessageBlock[];
+    kind: "claude_assistant_message";
+    text: string;
+    timestamp?: string;
+} | {
+    kind: "claude_thinking";
+    text: string;
+    timestamp?: string;
+} | {
+    input: string;
+    kind: "claude_tool_use";
+    name: string;
+    toolCategory: AgentToolCategory;
+    toolUseId?: string;
+    timestamp?: string;
+} | {
+    isError: boolean;
+    kind: "claude_tool_result";
+    name?: string;
+    output: string;
+    toolCategory: AgentToolCategory;
+    toolUseId?: string;
+    timestamp?: string;
+} | {
+    kind: "claude_tool_exchange";
+    result: {
+        isError: boolean;
+        output: string;
+        timestamp?: string;
+    };
+    toolUse: {
+        input: string;
+        name: string;
+        toolCategory: AgentToolCategory;
+        timestamp?: string;
+    };
+    toolUseId?: string;
+    timestamp?: string;
+} | {
+    items: ClaudeTodoItem[];
+    kind: "claude_todo";
+    title: string;
+    timestamp?: string;
+} | {
+    kind: "claude_queued_message";
+    operation: string;
+    text: string;
+    timestamp?: string;
+} | {
+    kind: "claude_system_event";
+    label: string;
+    text: string;
+    tone?: "default" | "success" | "warning";
+    timestamp?: string;
+} | {
+    kind: "claude_attachment";
+    label: string;
+    text: string;
+    timestamp?: string;
+} | {
+    kind: "claude_file_snapshot";
+    label: string;
+    text: string;
+    timestamp?: string;
+} | {
+    kind: "claude_pr_link";
+    repository?: string;
+    title: string;
+    url: string;
+    timestamp?: string;
+};
+export type ClaudeTodoItem = {
+    status?: string;
+    text: string;
+};
+export type AgentToolCategory = "browser" | "discovery" | "file_edit" | "file_read" | "generic" | "human" | "mcp" | "monitor" | "planning" | "search" | "scheduler" | "shell" | "structured" | "subagent" | "task" | "workflow" | "web";
+export type ClaudeToolCategory = AgentToolCategory;
+export type AgentSubagentRef = {
+    agentId: string;
+    updatedAt: string;
+};
+export type ClaudeAgentSessionDetails = {
+    agentSessionId: string;
+    endOfTurn: boolean;
+    firstAssistantMessage?: AgentSessionMessageSummary;
+    firstMessage?: AgentSessionMessageSummary;
+    lastAssistantMessage?: AgentSessionMessageSummary;
+    lastAssistantText: string;
+    lastMessage?: AgentSessionMessageSummary;
+    messages: ClaudeSessionMessage[];
+    provider: "claude";
+    sessionId: string;
+    subagents?: AgentSubagentRef[];
+    timeline: ClaudeTimelineItem[];
+    transcriptPath?: string;
+};
+export type CodexTimelineItem = {
+    kind: "codex_user_message";
+    text: string;
+    timestamp?: string;
+} | {
+    kind: "codex_assistant_message";
+    phase?: string;
+    text: string;
+    timestamp?: string;
+} | {
+    kind: "codex_commentary";
+    phase?: string;
+    text: string;
+    timestamp?: string;
+} | {
+    kind: "codex_reasoning";
+    summary?: string;
+    text: string;
+    timestamp?: string;
+} | {
+    arguments: string;
+    callId?: string;
+    kind: "codex_tool_call";
+    name: string;
+    toolCategory: AgentToolCategory;
+    timestamp?: string;
+} | {
+    callId?: string;
+    kind: "codex_tool_result";
+    name?: string;
+    output: string;
+    status?: string;
+    toolCategory: AgentToolCategory;
+    timestamp?: string;
+} | {
+    callId?: string;
+    kind: "codex_tool_exchange";
+    result: {
+        output: string;
+        status?: string;
+        timestamp?: string;
+    };
+    toolUse: {
+        arguments: string;
+        name: string;
+        toolCategory: AgentToolCategory;
+        timestamp?: string;
+    };
+    timestamp?: string;
+} | {
+    kind: "codex_patch";
+    callId?: string;
+    changes: CodexPatchChange[];
+    output: string;
+    status?: string;
+    success: boolean;
+    timestamp?: string;
+} | {
+    kind: "codex_task_event";
+    label: string;
+    text: string;
+    tone?: "default" | "success" | "warning";
+    timestamp?: string;
+} | {
+    kind: "codex_context";
+    cwd?: string;
+    label: string;
+    model?: string;
+    text: string;
+    timestamp?: string;
+} | {
+    kind: "codex_compaction";
+    text: string;
+    timestamp?: string;
+} | {
+    kind: "codex_goal";
+    status?: string;
+    text: string;
+    timestamp?: string;
+} | {
+    kind: "codex_review";
+    text: string;
+    timestamp?: string;
+} | {
+    kind: "codex_error";
+    text: string;
+    timestamp?: string;
+} | {
+    kind: "codex_web_search";
+    callId?: string;
+    query: string;
+    timestamp?: string;
+};
+export type CodexPatchChange = {
+    path: string;
+    text?: string;
+    type: string;
+};
+export type CodexAgentSessionDetails = {
+    agentSessionId: string;
+    endOfTurn: boolean;
+    firstAssistantMessage?: AgentSessionMessageSummary;
+    firstMessage?: AgentSessionMessageSummary;
+    lastAssistantMessage?: AgentSessionMessageSummary;
+    lastAssistantText: string;
+    lastMessage?: AgentSessionMessageSummary;
+    messages: Array<{
+        role: "assistant" | "developer" | "user";
+        text: string;
+        timestamp?: string;
+    }>;
+    provider: "codex";
+    sessionId: string;
+    timeline: CodexTimelineItem[];
+    transcriptPath?: string;
+};
+export type GeminiTimelineItem = {
+    kind: "gemini_user_message";
+    text: string;
+    timestamp?: string;
+} | {
+    kind: "gemini_assistant_message";
+    text: string;
+    timestamp?: string;
+} | {
+    kind: "gemini_thinking";
+    text: string;
+    timestamp?: string;
+};
+export type GeminiAgentSessionDetails = {
+    agentSessionId: string;
+    endOfTurn: boolean;
+    firstAssistantMessage?: AgentSessionMessageSummary;
+    firstMessage?: AgentSessionMessageSummary;
+    lastAssistantMessage?: AgentSessionMessageSummary;
+    lastAssistantText: string;
+    lastMessage?: AgentSessionMessageSummary;
+    messages: AgentSessionMessageSummary[];
+    provider: "gemini";
+    sessionId: string;
+    timeline: GeminiTimelineItem[];
+    transcriptPath?: string;
+};
+export type AgentSessionDetails = ClaudeAgentSessionDetails | CodexAgentSessionDetails | GeminiAgentSessionDetails;
+export declare function agentHome(): string;
+export declare function assertSafeAgentSessionId(bareId: string): string;
+export declare function normalizeClaudeSessionId(sessionId: string): string;
+export declare function encodeClaudeCwd(cwd: string): string;
+export declare function claudeTranscriptPath(options: {
+    cwd: string;
+    home?: string;
+    sessionId: string;
+}): string;
+export declare function normalizeCodexSessionId(sessionId: string): string;
+export declare function isCodexInjectedContext(raw: string): boolean;
+export declare function codexTranscriptPath(options: {
+    cwd: string;
+    home?: string;
+    sessionId: string;
+}): string | undefined;
+export declare function readLocalClaudeSession(options: {
+    cwd: string;
+    home?: string;
+    sessionId: string;
+}): ClaudeAgentSessionDetails;
+export declare function resolveClaudeTranscriptPath(options: {
+    cwd: string;
+    home?: string;
+    sessionId: string;
+}): string | undefined;
+export declare function emptyClaudeSession(options: {
+    cwd: string;
+    home?: string;
+    sessionId: string;
+}): ClaudeAgentSessionDetails;
+export declare function readLocalAgentSession(options: {
+    cwd: string;
+    home?: string;
+    sessionId: string;
+}): AgentSessionDetails;
+export declare function normalizeGeminiSessionId(sessionId: string): string;
+export declare function resolveGeminiTranscriptPath(options: {
+    cwd?: string;
+    home?: string;
+    sessionId: string;
+}): string | undefined;
+export declare function readLocalGeminiSession(options: {
+    cwd?: string;
+    home?: string;
+    sessionId: string;
+}): GeminiAgentSessionDetails;
+export declare function geminiContentText(content: unknown): string;
+export declare function parseGeminiSessionJsonl(options: {
+    jsonl: string;
+    sessionId: string;
+    transcriptPath?: string;
+}): GeminiAgentSessionDetails;
+export declare function readLocalAgentSessionAsync(options: {
+    cwd: string;
+    home?: string;
+    sessionId: string;
+}): Promise<AgentSessionDetails>;
+export declare function makeSubagentSessionId(parentSessionId: string, agentId: string): string;
+export declare function parseSubagentSessionId(sessionId: string): {
+    agentId: string;
+    parentSessionId: string;
+} | undefined;
+export declare function resolveClaudeSubagentTranscriptPath(options: {
+    agentId: string;
+    home?: string;
+    parentSessionId?: string;
+    sessionId?: string;
+}): string;
+export declare function listLocalAgentSubagents(options: {
+    home?: string;
+    sessionId: string;
+    transcriptPath?: string;
+}): AgentSubagentRef[];
+export declare function readLocalAgentSubagentSessionAsync(options: {
+    agentId: string;
+    home?: string;
+    sessionId: string;
+}): Promise<ClaudeAgentSessionDetails>;
+export declare function readLocalCodexSession(options: {
+    cwd: string;
+    home?: string;
+    sessionId: string;
+}): CodexAgentSessionDetails;
+export type ClaudeSessionParser = {
+    feedLine(line: string): void;
+    finalize(): ClaudeAgentSessionDetails;
+};
+export declare function createClaudeSessionParser(options: {
+    sessionId: string;
+    transcriptPath?: string;
+}): ClaudeSessionParser;
+export declare function parseClaudeSessionJsonl(options: {
+    jsonl: string;
+    sessionId: string;
+    transcriptPath?: string;
+}): ClaudeAgentSessionDetails;
+export declare function parseCodexSessionJsonl(options: {
+    jsonl: string;
+    sessionId: string;
+    transcriptPath?: string;
+}): CodexAgentSessionDetails;