@cuongtran001/kanna 1.3.0 → 1.3.1

package/src/shared/tool-call-types.ts

@@ -0,0 +1,314 @@
+/**
+ * Tool call shapes (raw + hydrated) — extracted from shared/types.ts.
+ * Completely self-contained: no imports from types.ts.
+ * Imported via the re-export barrel in types.ts; all external consumers
+ * continue to import from "../shared/types" unchanged.
+ */
+
+// ---------------------------------------------------------------------------
+// AskUserQuestion / TodoWrite payload primitives
+// ---------------------------------------------------------------------------
+
+export interface AskUserQuestionOption {
+  label: string
+  description?: string
+}
+
+export interface AskUserQuestionItem {
+  id?: string
+  question: string
+  header?: string
+  options?: AskUserQuestionOption[]
+  multiSelect?: boolean
+}
+
+export type AskUserQuestionAnswerMap = Record<string, string[]>
+
+export interface TodoItem {
+  content: string
+  status: "pending" | "in_progress" | "completed"
+  activeForm: string
+}
+
+// ---------------------------------------------------------------------------
+// Raw tool call shapes
+// ---------------------------------------------------------------------------
+
+interface ToolCallBase<TKind extends string, TInput> {
+  kind: "tool"
+  toolKind: TKind
+  toolName: string
+  toolId: string
+  input: TInput
+  rawInput?: Record<string, unknown>
+}
+
+export interface AskUserQuestionToolCall
+  extends ToolCallBase<"ask_user_question", { questions: AskUserQuestionItem[] }> { }
+
+export interface ExitPlanModeToolCall
+  extends ToolCallBase<"exit_plan_mode", { plan?: string; summary?: string }> { }
+
+export interface TodoWriteToolCall
+  extends ToolCallBase<"todo_write", { todos: TodoItem[] }> { }
+
+export interface SkillToolCall
+  extends ToolCallBase<"skill", { skill: string }> { }
+
+export interface GlobToolCall
+  extends ToolCallBase<"glob", { pattern: string }> { }
+
+export interface GrepToolCall
+  extends ToolCallBase<"grep", { pattern: string; outputMode?: string }> { }
+
+export interface BashToolCall
+  extends ToolCallBase<"bash", { command: string; description?: string; timeoutMs?: number; runInBackground?: boolean }> { }
+
+export interface WebSearchToolCall
+  extends ToolCallBase<"web_search", { query: string }> { }
+
+export interface ReadFileToolCall
+  extends ToolCallBase<"read_file", { filePath: string }> { }
+
+export interface WriteFileToolCall
+  extends ToolCallBase<"write_file", { filePath: string; content: string }> { }
+
+export interface EditFileToolCall
+  extends ToolCallBase<"edit_file", { filePath: string; oldString: string; newString: string }> { }
+
+export interface DeleteFileToolCall
+  extends ToolCallBase<"delete_file", { filePath: string; content: string }> { }
+
+export interface SubagentTaskToolCall
+  extends ToolCallBase<"subagent_task", { subagentType?: string }> { }
+
+export interface McpGenericToolCall
+  extends ToolCallBase<"mcp_generic", { server: string; tool: string; payload: Record<string, unknown> }> { }
+
+export interface OfferDownloadToolCall
+  extends ToolCallBase<"offer_download", { path: string; label?: string }> { }
+
+export interface OfferDownloadToolResult {
+  contentUrl: string
+  relativePath: string
+  fileName: string
+  displayName: string
+  size: number
+  mimeType?: string
+}
+
+export interface PreviewFileToolCall
+  extends ToolCallBase<"preview_file", { path: string; label?: string }> { }
+
+export interface PreviewFileToolResult {
+  contentUrl: string
+  relativePath: string
+  fileName: string
+  displayName: string
+  size: number
+  mimeType: string
+}
+
+export type ImageGenerationStatus = "in_progress" | "completed" | "failed"
+
+export interface ImageGenerationToolCall
+  extends ToolCallBase<"image_generation", { revisedPrompt: string | null; status: ImageGenerationStatus }> { }
+
+export interface ImageGenerationToolResult {
+  contentUrl: string
+  relativePath: string
+  fileName: string
+}
+
+export interface UnknownToolCall
+  extends ToolCallBase<"unknown_tool", { payload: Record<string, unknown> }> { }
+
+export interface WorkflowToolCall
+  extends ToolCallBase<"workflow", { name?: string; description?: string; scriptPath?: string }> { }
+
+export type NormalizedToolCall =
+  | AskUserQuestionToolCall
+  | ExitPlanModeToolCall
+  | TodoWriteToolCall
+  | SkillToolCall
+  | GlobToolCall
+  | GrepToolCall
+  | BashToolCall
+  | WebSearchToolCall
+  | ReadFileToolCall
+  | WriteFileToolCall
+  | EditFileToolCall
+  | DeleteFileToolCall
+  | SubagentTaskToolCall
+  | McpGenericToolCall
+  | OfferDownloadToolCall
+  | PreviewFileToolCall
+  | ImageGenerationToolCall
+  | WorkflowToolCall
+  | UnknownToolCall
+
+// ---------------------------------------------------------------------------
+// Hydrated tool call shapes
+// ---------------------------------------------------------------------------
+
+export interface HydratedToolCallBase<TKind extends string, TInput, TResult> {
+  id: string
+  messageId?: string
+  hidden?: boolean
+  kind: "tool"
+  toolKind: TKind
+  toolName: string
+  toolId: string
+  input: TInput
+  result?: TResult
+  rawResult?: string | Record<string, unknown> | readonly unknown[] | null
+  isError?: boolean
+  /**
+   * Set when the underlying tool_result entry was persisted to disk
+   * via the subagent payload cap. Mirrored from
+   * ToolResultEntry.persisted during hydration.
+   */
+  persisted?: {
+    filePath: string
+    originalSize: number
+    isJson: boolean
+    truncated: true
+  }
+  timestamp: string
+}
+
+export interface AskUserQuestionToolResult {
+  answers: AskUserQuestionAnswerMap
+  discarded?: boolean
+}
+
+export interface ExitPlanModeToolResult {
+  confirmed?: boolean
+  clearContext?: boolean
+  message?: string
+  discarded?: boolean
+}
+
+export type HydratedAskUserQuestionToolCall =
+  HydratedToolCallBase<"ask_user_question", AskUserQuestionToolCall["input"], AskUserQuestionToolResult>
+
+export type HydratedExitPlanModeToolCall =
+  HydratedToolCallBase<"exit_plan_mode", ExitPlanModeToolCall["input"], ExitPlanModeToolResult>
+
+export type HydratedTodoWriteToolCall =
+  HydratedToolCallBase<"todo_write", TodoWriteToolCall["input"], unknown>
+
+export type HydratedSkillToolCall =
+  HydratedToolCallBase<"skill", SkillToolCall["input"], unknown>
+
+export type HydratedGlobToolCall =
+  HydratedToolCallBase<"glob", GlobToolCall["input"], unknown>
+
+export type HydratedGrepToolCall =
+  HydratedToolCallBase<"grep", GrepToolCall["input"], unknown>
+
+export type HydratedBashToolCall =
+  HydratedToolCallBase<"bash", BashToolCall["input"], unknown>
+
+export type HydratedWebSearchToolCall =
+  HydratedToolCallBase<"web_search", WebSearchToolCall["input"], unknown>
+
+export interface ReadFileTextBlock {
+  type: "text"
+  text: string
+}
+
+export interface ReadFileImageBlock {
+  type: "image"
+  data: string
+  mimeType?: string
+}
+
+export interface ReadFileToolResult {
+  content: string
+  blocks?: Array<ReadFileTextBlock | ReadFileImageBlock>
+}
+
+export type HydratedReadFileToolCall =
+  HydratedToolCallBase<"read_file", ReadFileToolCall["input"], ReadFileToolResult | string>
+
+export type HydratedWriteFileToolCall =
+  HydratedToolCallBase<"write_file", WriteFileToolCall["input"], unknown>
+
+export type HydratedEditFileToolCall =
+  HydratedToolCallBase<"edit_file", EditFileToolCall["input"], unknown>
+
+export type HydratedDeleteFileToolCall =
+  HydratedToolCallBase<"delete_file", DeleteFileToolCall["input"], unknown>
+
+export interface SubagentToolStats {
+  readCount?: number
+  searchCount?: number
+  bashCount?: number
+  editFileCount?: number
+  linesAdded?: number
+  linesRemoved?: number
+  otherToolCount?: number
+}
+
+// Parsed from the `Agent`/`Task` tool_result's top-level `toolUseResult`
+// sidecar (camelCase, written by claude-code into the transcript JSONL and
+// preserved on the tool_result entry's debugRaw). All fields optional — the
+// SDK driver / older transcripts / in-flight calls may omit it entirely.
+export interface SubagentTaskResult {
+  agentId?: string
+  agentType?: string
+  status?: string
+  totalTokens?: number
+  totalDurationMs?: number
+  totalToolUseCount?: number
+  toolStats?: SubagentToolStats
+  content?: string
+}
+
+export type HydratedSubagentTaskToolCall =
+  HydratedToolCallBase<"subagent_task", SubagentTaskToolCall["input"], SubagentTaskResult>
+
+export type HydratedMcpGenericToolCall =
+  HydratedToolCallBase<"mcp_generic", McpGenericToolCall["input"], unknown>
+
+export type HydratedOfferDownloadToolCall =
+  HydratedToolCallBase<"offer_download", OfferDownloadToolCall["input"], OfferDownloadToolResult>
+
+export type HydratedPreviewFileToolCall =
+  HydratedToolCallBase<"preview_file", PreviewFileToolCall["input"], PreviewFileToolResult>
+
+export type HydratedImageGenerationToolCall =
+  HydratedToolCallBase<"image_generation", ImageGenerationToolCall["input"], ImageGenerationToolResult>
+
+export interface WorkflowToolResult {
+  taskId?: string
+  text: string
+}
+
+export type HydratedWorkflowToolCall =
+  HydratedToolCallBase<"workflow", WorkflowToolCall["input"], WorkflowToolResult>
+
+export type HydratedUnknownToolCall =
+  HydratedToolCallBase<"unknown_tool", UnknownToolCall["input"], unknown>
+
+export type HydratedToolCall =
+  | HydratedAskUserQuestionToolCall
+  | HydratedExitPlanModeToolCall
+  | HydratedTodoWriteToolCall
+  | HydratedSkillToolCall
+  | HydratedGlobToolCall
+  | HydratedGrepToolCall
+  | HydratedBashToolCall
+  | HydratedWebSearchToolCall
+  | HydratedReadFileToolCall
+  | HydratedWriteFileToolCall
+  | HydratedEditFileToolCall
+  | HydratedDeleteFileToolCall
+  | HydratedSubagentTaskToolCall
+  | HydratedMcpGenericToolCall
+  | HydratedOfferDownloadToolCall
+  | HydratedPreviewFileToolCall
+  | HydratedImageGenerationToolCall
+  | HydratedWorkflowToolCall
+  | HydratedUnknownToolCall

package/src/shared/transcript-types.ts

@@ -0,0 +1,270 @@
+/**
+ * Transcript entry shapes and the TranscriptEntry union — extracted from shared/types.ts.
+ * Imported via the re-export barrel in types.ts; all external consumers
+ * continue to import from "../shared/types" unchanged.
+ *
+ * import type = erased at compile time → no circular runtime dependency.
+ */
+
+import type { AgentProvider, ChatAttachment, ProviderUsage } from "./types"
+import type { ToolRequestStatus, ToolRequestDecision } from "./permission-policy"
+import type { NormalizedToolCall, HydratedToolCall } from "./tool-call-types"
+
+// ---------------------------------------------------------------------------
+// Shared info shapes (only referenced by transcript entries)
+// ---------------------------------------------------------------------------
+
+export interface McpServerInfo {
+  name: string
+  status: string
+  error?: string
+}
+
+export interface AccountInfo {
+  email?: string
+  organization?: string
+  subscriptionType?: string
+  tokenSource?: string
+  apiKeySource?: string
+  oauthKeyMasked?: string
+}
+
+// ---------------------------------------------------------------------------
+// Context window usage — only used by transcript entries
+// ---------------------------------------------------------------------------
+
+export interface ContextWindowUsageSnapshot {
+  usedTokens: number
+  totalProcessedTokens?: number
+  maxTokens?: number
+  inputTokens?: number
+  cachedInputTokens?: number
+  outputTokens?: number
+  reasoningOutputTokens?: number
+  lastUsedTokens?: number
+  lastInputTokens?: number
+  lastCachedInputTokens?: number
+  lastOutputTokens?: number
+  lastReasoningOutputTokens?: number
+  toolUses?: number
+  durationMs?: number
+  /** USD cost for this turn. Provider-reported (Claude) or computed (others). */
+  costUsd?: number
+  compactsAutomatically: boolean
+}
+
+// ---------------------------------------------------------------------------
+// Transcript entry base (private to this module)
+// ---------------------------------------------------------------------------
+
+interface TranscriptEntryBase {
+  _id: string
+  messageId?: string
+  createdAt: number
+  hidden?: boolean
+  debugRaw?: string
+}
+
+// ---------------------------------------------------------------------------
+// Transcript entry types
+// ---------------------------------------------------------------------------
+
+export interface ToolResultEntry extends TranscriptEntryBase {
+  kind: "tool_result"
+  toolId: string
+  content: string | Record<string, unknown> | readonly unknown[] | null
+  isError?: boolean
+  /**
+   * Set when the original content exceeded the subagent payload cap
+   * (50 KB) and the full content was written to disk. `content` then
+   * carries only a 2 KB preview wrapped in <persisted-output> tags.
+   */
+  persisted?: {
+    filePath: string
+    originalSize: number
+    isJson: boolean
+    truncated: true
+  }
+}
+
+export interface UserPromptEntry extends TranscriptEntryBase {
+  kind: "user_prompt"
+  content: string
+  attachments?: ChatAttachment[]
+  steered?: boolean
+  autoContinue?: { scheduleId: string }
+  subagentMentions?: Array<{ subagentId: string; raw: string }>
+  unknownSubagentMentions?: Array<{ name: string; raw: string }>
+}
+
+export interface SystemInitEntry extends TranscriptEntryBase {
+  kind: "system_init"
+  provider: AgentProvider
+  model: string
+  tools: string[]
+  agents: string[]
+  slashCommands: string[]
+  mcpServers: McpServerInfo[]
+}
+
+export interface AccountInfoEntry extends TranscriptEntryBase {
+  kind: "account_info"
+  accountInfo: AccountInfo
+}
+
+export interface AssistantTextEntry extends TranscriptEntryBase {
+  kind: "assistant_text"
+  text: string
+}
+
+export interface AssistantThinkingEntry extends TranscriptEntryBase {
+  kind: "assistant_thinking"
+  text: string
+  signature?: string
+}
+
+export interface ApiErrorEntry extends TranscriptEntryBase {
+  kind: "api_error"
+  status: number
+  text: string
+  requestId?: string
+}
+
+// A deliberate model refusal (Claude CLI returns stop_reason "refusal" /
+// Usage-Policy block text) — distinct from a transport/overload api_error.
+// Surfaced as its own kind so the UI can label it "Blocked — Usage Policy"
+// instead of a generic red API-error card.
+// See adr-20260607-surface-policy-refusal-entry.
+export interface PolicyRefusalEntry extends TranscriptEntryBase {
+  kind: "policy_refusal"
+  text: string
+  requestId?: string
+}
+
+export interface ToolCallEntry extends TranscriptEntryBase {
+  kind: "tool_call"
+  tool: NormalizedToolCall
+}
+
+export interface ResultEntry extends TranscriptEntryBase {
+  kind: "result"
+  subtype: "success" | "error" | "cancelled"
+  isError: boolean
+  durationMs: number
+  result: string
+  costUsd?: number
+  usage?: ProviderUsage
+  /**
+   * Number of background Workflow tasks still running when this turn ended
+   * (from claude-code's `turn_duration` frame). When > 0 the coordinator arms
+   * a pending-workflow wake so the agent re-enters to harvest results instead
+   * of going idle. Absent/0 on normal turns.
+   * See adr-20260603-agent-self-scheduled-wake.
+   */
+  pendingWorkflowCount?: number
+}
+
+export interface StatusEntry extends TranscriptEntryBase {
+  kind: "status"
+  status: string
+  backgroundTaskId?: string
+}
+
+export interface ContextWindowUpdatedEntry extends TranscriptEntryBase {
+  kind: "context_window_updated"
+  usage: ContextWindowUsageSnapshot
+}
+
+export interface CompactBoundaryEntry extends TranscriptEntryBase {
+  kind: "compact_boundary"
+}
+
+export interface CompactSummaryEntry extends TranscriptEntryBase {
+  kind: "compact_summary"
+  summary: string
+}
+
+export interface ContextClearedEntry extends TranscriptEntryBase {
+  kind: "context_cleared"
+}
+
+export interface InterruptedEntry extends TranscriptEntryBase {
+  kind: "interrupted"
+}
+
+/**
+ * A Claude Code memory/rule file auto-loaded into context (CLAUDE.md, nested
+ * CLAUDE.md, `.claude/rules/*.md`). PTY mode surfaces these from the
+ * transcript's `type:"nested_memory"` lines. Path only — file content is
+ * intentionally not carried (keeps the persisted/replayed event log light).
+ */
+export interface MemoryLoadedEntry extends TranscriptEntryBase {
+  kind: "memory_loaded"
+  path: string
+}
+
+export interface AutoContinuePromptEntry extends TranscriptEntryBase {
+  kind: "auto_continue_prompt"
+  scheduleId: string
+}
+
+export interface PendingToolRequestEntry extends TranscriptEntryBase {
+  kind: "pending_tool_request"
+  toolRequestId: string
+  toolName: string
+  arguments: Record<string, unknown>
+}
+
+export interface ToolRequestResolvedEntry extends TranscriptEntryBase {
+  kind: "tool_request_resolved"
+  toolRequestId: string
+  status: ToolRequestStatus
+  decision?: ToolRequestDecision
+}
+
+export type TranscriptEntry =
+  | UserPromptEntry
+  | SystemInitEntry
+  | AccountInfoEntry
+  | AssistantTextEntry
+  | AssistantThinkingEntry
+  | ApiErrorEntry
+  | PolicyRefusalEntry
+  | ToolCallEntry
+  | ToolResultEntry
+  | ResultEntry
+  | StatusEntry
+  | ContextWindowUpdatedEntry
+  | CompactBoundaryEntry
+  | CompactSummaryEntry
+  | ContextClearedEntry
+  | InterruptedEntry
+  | MemoryLoadedEntry
+  | AutoContinuePromptEntry
+  | PendingToolRequestEntry
+  | ToolRequestResolvedEntry
+
+// ---------------------------------------------------------------------------
+// Hydrated transcript message (rich UI representation)
+// ---------------------------------------------------------------------------
+
+export type HydratedTranscriptMessage =
+  | ({ kind: "user_prompt"; content: string; attachments?: ChatAttachment[]; steered?: boolean; autoContinue?: { scheduleId: string }; id: string; messageId?: string; timestamp: string; hidden?: boolean })
+  | ({ kind: "system_init"; model: string; tools: string[]; agents: string[]; slashCommands: string[]; mcpServers: McpServerInfo[]; provider: AgentProvider; id: string; messageId?: string; timestamp: string; hidden?: boolean; debugRaw?: string })
+  | ({ kind: "account_info"; accountInfo: AccountInfo; id: string; messageId?: string; timestamp: string; hidden?: boolean })
+  | ({ kind: "assistant_text"; text: string; id: string; messageId?: string; timestamp: string; hidden?: boolean })
+  | ({ kind: "assistant_thinking"; text: string; signature?: string; id: string; messageId?: string; timestamp: string; hidden?: boolean })
+  | ({ kind: "api_error"; status: number; text: string; requestId?: string; id: string; messageId?: string; timestamp: string; hidden?: boolean })
+  | ({ kind: "policy_refusal"; text: string; requestId?: string; id: string; messageId?: string; timestamp: string; hidden?: boolean })
+  | ({ kind: "result"; success: boolean; cancelled?: boolean; result: string; durationMs: number; costUsd?: number; id: string; messageId?: string; timestamp: string; hidden?: boolean })
+  | ({ kind: "status"; status: string; id: string; messageId?: string; timestamp: string; hidden?: boolean })
+  | ({ kind: "context_window_updated"; usage: ContextWindowUsageSnapshot; id: string; messageId?: string; timestamp: string; hidden?: boolean })
+  | ({ kind: "compact_boundary"; id: string; messageId?: string; timestamp: string; hidden?: boolean })
+  | ({ kind: "compact_summary"; summary: string; id: string; messageId?: string; timestamp: string; hidden?: boolean })
+  | ({ kind: "context_cleared"; id: string; messageId?: string; timestamp: string; hidden?: boolean })
+  | ({ kind: "interrupted"; id: string; messageId?: string; timestamp: string; hidden?: boolean })
+  | ({ kind: "memory_loaded"; path: string; id: string; messageId?: string; timestamp: string; hidden?: boolean })
+  | ({ kind: "unknown"; json: string; id: string; messageId?: string; timestamp: string; hidden?: boolean })
+  | ({ kind: "auto_continue_prompt"; scheduleId: string; id: string; messageId?: string; timestamp: string; hidden?: boolean })
+  | ({ kind: "pending_tool_request"; toolRequestId: string; toolName: string; arguments: Record<string, unknown>; id: string; messageId?: string; timestamp: string; hidden?: boolean })
+  | ({ id: string; messageId?: string; hidden?: boolean } & HydratedToolCall)