@hansjm10/volt-coding-agent 0.0.0-bootstrap.0 → 0.1.0

package/dist/core/rpc/transcript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.d.ts","sourceRoot":"","sources":["../../../src/core/rpc/transcript.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAClF,OAAO,KAAK,EACX,eAAe,EAEf,qBAAqB,EAGrB,MAAM,YAAY,CAAC;AA0BpB,MAAM,WAAW,+BAA+B;IAC/C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,wBAAwB,CACvC,cAAc,EAAE,sBAAsB,EACtC,OAAO,GAAE,+BAAoC,GAC3C,qBAAqB,CAiBvB;AAED;;;;;GAKG;AACH,eAAO,MAAM,oCAAoC,QAAkB,CAAC;AACpE,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAEhD,MAAM,MAAM,0BAA0B,GACnC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,eAAe,EAAE,CAAC;IAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC5G;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,eAAe,GAAG,iBAAiB,CAAA;CAAE,CAAC;AAM7D;;;;;GAKG;AACH,wBAAgB,oBAAoB,CACnC,OAAO,EAAE,YAAY,EAAE,EACvB,OAAO,EAAE,MAAM,EACf,eAAe,SAAI,EACnB,WAAW,SAAuC,GAChD,0BAA0B,CAwB5B;AAED,kEAAkE;AAClE,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,EAAE,CAYrE;AA+SD,wBAAgB,sBAAsB,CACrC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC1C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAiDrC","sourcesContent":["import { Buffer } from \"node:buffer\";\nimport type { AgentMessage } from \"@hansjm10/volt-agent-core\";\nimport type { ImageContent } from \"@hansjm10/volt-ai\";\nimport { type BashExecutionMessage, extractVisibleTextContent } from \"../messages.ts\";\nimport type { ReadonlySessionManager, SessionEntry } from \"../session-manager.ts\";\nimport type {\n\tRpcMessageImage,\n\tRpcTranscriptItem,\n\tRpcTranscriptResponse,\n\tRpcTranscriptToolItem,\n\tRpcTranscriptToolStatus,\n} from \"./types.ts\";\n\nconst DEFAULT_TRANSCRIPT_LIMIT = 100;\nconst MAX_TRANSCRIPT_LIMIT = 200;\nconst MESSAGE_TEXT_LIMIT = 16_000;\nconst SUMMARY_TEXT_LIMIT = 1_000;\nconst TOOL_SUMMARY_LIMIT = 1_000;\nconst TOOL_COMMAND_LIMIT = 500;\nconst TOOL_ARGUMENT_STRING_LIMIT = 500;\nconst TOOL_ARGUMENT_KEYS_LIMIT = 12;\nconst MUTATION_PREVIEW_LIMIT = 4_000;\nconst SUBAGENT_AGENT_LIMIT = 200;\nconst SUBAGENT_ID_LIMIT = 200;\nconst SUBAGENT_TASK_LIMIT = 1_000;\nconst SUBAGENT_ERROR_LIMIT = 1_000;\nconst SUBAGENT_OUTPUT_LIMIT = 1_000;\nconst SUBAGENT_ACTIVITY_LIMIT = 300;\nconst SUBAGENT_TREE_DEPTH_LIMIT = 5;\nconst SUBAGENT_NUMERIC_DETAIL_KEYS = [\"startedAt\", \"durationMs\", \"toolCalls\", \"tokens\"] as const;\n\ninterface StoredToolCall {\n\tid: string;\n\tname: string;\n\targuments: Record<string, unknown>;\n}\n\nexport interface ProjectSessionTranscriptOptions {\n\tbeforeEntryId?: string;\n\tlimit?: number;\n}\n\nexport function projectSessionTranscript(\n\tsessionManager: ReadonlySessionManager,\n\toptions: ProjectSessionTranscriptOptions = {},\n): RpcTranscriptResponse {\n\tconst allItems = projectTranscriptItems(sessionManager.getBranch());\n\tconst beforeIndex = options.beforeEntryId\n\t\t? allItems.findIndex((item) => item.id === options.beforeEntryId)\n\t\t: allItems.length;\n\tconst eligibleItems = beforeIndex === -1 ? [] : allItems.slice(0, beforeIndex);\n\tconst limit = normalizeLimit(options.limit);\n\tconst pageStart = Math.max(0, eligibleItems.length - limit);\n\tconst items = eligibleItems.slice(pageStart);\n\tconst hasMore = pageStart > 0;\n\n\treturn {\n\t\tsessionId: sessionManager.getSessionId(),\n\t\titems,\n\t\thasMore,\n\t\tnextBeforeEntryId: hasMore ? (items[0]?.id ?? null) : null,\n\t};\n}\n\n/**\n * Serialized-size budget for one get_message_images response. Keeps the frame\n * under the daemon control protocol's 8 MB line cap (the tightest transport on\n * any relay path) with headroom for JSON envelope overhead. The first image of\n * a page is always included so pagination cannot stall on a single large image.\n */\nexport const MESSAGE_IMAGES_RESPONSE_BUDGET_BYTES = 6 * 1024 * 1024;\nexport const MESSAGE_IMAGES_PAGE_MAX_ITEMS = 32;\n\nexport type ProjectMessageImagesResult =\n\t| { ok: true; entryId: string; totalImages: number; images: RpcMessageImage[]; nextImageIndex: number | null }\n\t| { ok: false; error: \"unknown_entry\" | \"image_too_large\" };\n\nfunction getSerializedMessageImageBytes(image: ImageContent, index: number): number {\n\treturn Buffer.byteLength(JSON.stringify({ ...image, index }), \"utf8\");\n}\n\n/**\n * Recovers the inline image blocks persisted on a session entry, paged from\n * `startImageIndex` under `budgetBytes`. Text-only transcript projections\n * advertise `imageCount`; reconnecting clients call this per entry to restore\n * user-message images after a cold restart.\n */\nexport function projectMessageImages(\n\tentries: SessionEntry[],\n\tentryId: string,\n\tstartImageIndex = 0,\n\tbudgetBytes = MESSAGE_IMAGES_RESPONSE_BUDGET_BYTES,\n): ProjectMessageImagesResult {\n\tconst entry = entries.find((candidate) => candidate.id === entryId);\n\tif (!entry || entry.type !== \"message\") {\n\t\treturn { ok: false, error: \"unknown_entry\" };\n\t}\n\tconst allImages = extractMessageImages((entry.message as { content?: unknown }).content);\n\tconst start = Math.max(0, Math.floor(startImageIndex));\n\tconst images: RpcMessageImage[] = [];\n\tlet usedBytes = 0;\n\tlet nextImageIndex: number | null = null;\n\tfor (let index = start; index < allImages.length; index++) {\n\t\tconst image = allImages[index];\n\t\tconst serializedBytes = getSerializedMessageImageBytes(image, index);\n\t\tif (serializedBytes > budgetBytes && images.length === 0) {\n\t\t\treturn { ok: false, error: \"image_too_large\" };\n\t\t}\n\t\tif (images.length >= MESSAGE_IMAGES_PAGE_MAX_ITEMS || usedBytes + serializedBytes > budgetBytes) {\n\t\t\tnextImageIndex = index;\n\t\t\tbreak;\n\t\t}\n\t\timages.push({ ...image, index });\n\t\tusedBytes += serializedBytes;\n\t}\n\treturn { ok: true, entryId, totalImages: allImages.length, images, nextImageIndex };\n}\n\n/** Inline image blocks on a persisted message's content array. */\nexport function extractMessageImages(content: unknown): ImageContent[] {\n\tif (!Array.isArray(content)) {\n\t\treturn [];\n\t}\n\treturn content.filter(\n\t\t(block): block is ImageContent =>\n\t\t\tisRecord(block) &&\n\t\t\tblock.type === \"image\" &&\n\t\t\ttypeof block.data === \"string\" &&\n\t\t\tblock.data.length > 0 &&\n\t\t\ttypeof block.mimeType === \"string\",\n\t);\n}\n\nfunction normalizeLimit(limit: number | undefined): number {\n\tif (limit === undefined || !Number.isFinite(limit) || limit <= 0) {\n\t\treturn DEFAULT_TRANSCRIPT_LIMIT;\n\t}\n\treturn Math.min(MAX_TRANSCRIPT_LIMIT, Math.floor(limit));\n}\n\nfunction projectTranscriptItems(entries: SessionEntry[]): RpcTranscriptItem[] {\n\tconst toolCallsById = collectToolCalls(entries);\n\tconst items: RpcTranscriptItem[] = [];\n\n\tfor (const entry of entries) {\n\t\tif (entry.type === \"compaction\") {\n\t\t\titems.push({\n\t\t\t\tid: entry.id,\n\t\t\t\trole: \"summary\",\n\t\t\t\ttimestamp: normalizeTimestamp(entry.timestamp),\n\t\t\t\ttitle: \"Conversation compacted\",\n\t\t\t\ttext: boundText(entry.summary, SUMMARY_TEXT_LIMIT),\n\t\t\t});\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (entry.type === \"custom_message\") {\n\t\t\tconst customItem = projectCustomMessage(entry);\n\t\t\tif (customItem) {\n\t\t\t\titems.push(customItem);\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (entry.type !== \"message\") {\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst message = entry.message;\n\t\tif (message.role === \"user\") {\n\t\t\tconst text = boundText(extractVisibleTextContent(message.content), MESSAGE_TEXT_LIMIT);\n\t\t\tconst imageCount = extractMessageImages(message.content).length;\n\t\t\tif (text || imageCount > 0) {\n\t\t\t\titems.push({\n\t\t\t\t\tid: entry.id,\n\t\t\t\t\trole: \"user\",\n\t\t\t\t\ttext,\n\t\t\t\t\ttimestamp: normalizeTimestamp(entry.timestamp),\n\t\t\t\t\t...(imageCount > 0 ? { imageCount } : {}),\n\t\t\t\t});\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (message.role === \"assistant\") {\n\t\t\tconst text = boundText(extractVisibleTextContent(message.content), MESSAGE_TEXT_LIMIT);\n\t\t\tif (text) {\n\t\t\t\titems.push({ id: entry.id, role: \"assistant\", text, timestamp: normalizeTimestamp(entry.timestamp) });\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (message.role === \"toolResult\") {\n\t\t\titems.push(projectToolResult(entry.id, entry.timestamp, message, toolCallsById.get(message.toolCallId)));\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (message.role === \"bashExecution\") {\n\t\t\titems.push(projectBashExecution(entry.id, entry.timestamp, message));\n\t\t}\n\t}\n\n\treturn items;\n}\n\nfunction projectCustomMessage(entry: Extract<SessionEntry, { type: \"custom_message\" }>): RpcTranscriptItem | undefined {\n\tif (!entry.display || entry.customType !== \"review\") {\n\t\treturn undefined;\n\t}\n\tconst text = boundText(extractVisibleTextContent(entry.content), MESSAGE_TEXT_LIMIT);\n\tif (!text) {\n\t\treturn undefined;\n\t}\n\treturn { id: entry.id, role: \"assistant\", text, timestamp: normalizeTimestamp(entry.timestamp) };\n}\n\nfunction collectToolCalls(entries: SessionEntry[]): Map<string, StoredToolCall> {\n\tconst toolCalls = new Map<string, StoredToolCall>();\n\tfor (const entry of entries) {\n\t\tif (entry.type !== \"message\" || entry.message.role !== \"assistant\") {\n\t\t\tcontinue;\n\t\t}\n\t\tfor (const block of entry.message.content) {\n\t\t\tif (isStoredToolCall(block)) {\n\t\t\t\ttoolCalls.set(block.id, block);\n\t\t\t}\n\t\t}\n\t}\n\treturn toolCalls;\n}\n\nfunction projectToolResult(\n\tentryId: string,\n\ttimestamp: string,\n\tmessage: Extract<AgentMessage, { role: \"toolResult\" }>,\n\ttoolCall: StoredToolCall | undefined,\n): RpcTranscriptToolItem {\n\tconst args = toolCall?.arguments;\n\tconst status: RpcTranscriptToolStatus = message.isError ? \"failed\" : \"completed\";\n\tconst path = getToolPath(message.toolName, args);\n\tconst details = isRecord(message.details) ? message.details : undefined;\n\tconst item: RpcTranscriptToolItem = {\n\t\tid: entryId,\n\t\trole: \"tool\",\n\t\ttoolName: message.toolName,\n\t\tstatus,\n\t\tsummary: summarizeToolResult(message.toolName, status, args, path),\n\t\ttimestamp: normalizeTimestamp(timestamp),\n\t};\n\tif (path) {\n\t\titem.path = path;\n\t}\n\tconst imageCount = extractMessageImages(message.content).length;\n\tif (imageCount > 0) {\n\t\titem.imageCount = imageCount;\n\t}\n\tconst diffPreview = getBoundedString(details, \"diff\", MUTATION_PREVIEW_LIMIT);\n\tif (diffPreview) {\n\t\titem.diffPreview = diffPreview;\n\t}\n\tconst patchPreview = getBoundedString(details, \"patch\", MUTATION_PREVIEW_LIMIT);\n\tif (patchPreview) {\n\t\titem.patchPreview = patchPreview;\n\t}\n\tconst projectedArgs = projectToolArgs(message.toolName, args);\n\tif (projectedArgs) {\n\t\titem.args = projectedArgs;\n\t}\n\tif (message.toolName === \"subagent\") {\n\t\tconst subagentDetails = projectSubagentDetails(details);\n\t\tif (subagentDetails) {\n\t\t\titem.details = subagentDetails;\n\t\t}\n\t}\n\treturn item;\n}\n\nfunction projectToolArgs(\n\ttoolName: string,\n\targs: Record<string, unknown> | undefined,\n): Record<string, unknown> | undefined {\n\tif (toolName === \"subagent\") {\n\t\treturn projectSubagentArgs(args);\n\t}\n\tif (!args) {\n\t\treturn undefined;\n\t}\n\n\tconst projected: Record<string, unknown> = {};\n\tswitch (toolName) {\n\t\tcase \"bash\":\n\t\t\tcopyStringArg(args, projected, \"command\", TOOL_COMMAND_LIMIT);\n\t\t\tcopyNumberArg(args, projected, \"timeout\");\n\t\t\tbreak;\n\t\tcase \"read\":\n\t\t\tcopyStringArg(args, projected, \"path\");\n\t\t\tcopyStringArg(args, projected, \"file_path\");\n\t\t\tcopyNumberArg(args, projected, \"offset\");\n\t\t\tcopyNumberArg(args, projected, \"limit\");\n\t\t\tbreak;\n\t\tcase \"edit\":\n\t\tcase \"write\":\n\t\t\tcopyStringArg(args, projected, \"path\");\n\t\t\tcopyStringArg(args, projected, \"file_path\");\n\t\t\tbreak;\n\t\tcase \"grep\":\n\t\t\tcopyStringArg(args, projected, \"pattern\");\n\t\t\tcopyStringArg(args, projected, \"path\");\n\t\t\tcopyStringArg(args, projected, \"glob\");\n\t\t\tcopyStringArg(args, projected, \"include\");\n\t\t\tcopyStringArg(args, projected, \"exclude\");\n\t\t\tcopyBooleanArg(args, projected, \"ignoreCase\");\n\t\t\tcopyBooleanArg(args, projected, \"literal\");\n\t\t\tcopyNumberArg(args, projected, \"context\");\n\t\t\tbreak;\n\t\tcase \"find\":\n\t\t\tcopyStringArg(args, projected, \"query\");\n\t\t\tcopyStringArg(args, projected, \"pattern\");\n\t\t\tcopyStringArg(args, projected, \"path\");\n\t\t\tcopyStringArg(args, projected, \"glob\");\n\t\t\tcopyStringArg(args, projected, \"name\");\n\t\t\tcopyNumberArg(args, projected, \"limit\");\n\t\t\tbreak;\n\t\tcase \"ls\":\n\t\t\tcopyStringArg(args, projected, \"path\");\n\t\t\tcopyNumberArg(args, projected, \"limit\");\n\t\t\tbreak;\n\t\tcase \"lsp\":\n\t\t\tcopyStringArg(args, projected, \"action\");\n\t\t\tcopyStringArg(args, projected, \"symbol\");\n\t\t\tcopyStringArg(args, projected, \"path\");\n\t\t\tcopyStringArg(args, projected, \"file_path\");\n\t\t\tcopyNumberArg(args, projected, \"line\");\n\t\t\tbreak;\n\t\tcase \"web_search\":\n\t\t\tcopyStringArg(args, projected, \"query\");\n\t\t\tcopyStringArrayArg(args, projected, \"domains\");\n\t\t\tcopyNumberArg(args, projected, \"limit\");\n\t\t\tcopyNumberArg(args, projected, \"recencyDays\");\n\t\t\tbreak;\n\t\tdefault:\n\t\t\tbreak;\n\t}\n\n\treturn Object.keys(projected).length > 0 ? projected : undefined;\n}\n\nfunction copyStringArg(\n\tfrom: Record<string, unknown>,\n\tto: Record<string, unknown>,\n\tkey: string,\n\tlimit = TOOL_ARGUMENT_STRING_LIMIT,\n): void {\n\tconst value = getStringArg(from, key);\n\tif (value) {\n\t\tto[key] = boundText(value, limit);\n\t}\n}\n\nfunction copyNumberArg(from: Record<string, unknown>, to: Record<string, unknown>, key: string): void {\n\tconst value = getFiniteNumber(from, key);\n\tif (value !== undefined) {\n\t\tto[key] = value;\n\t}\n}\n\nfunction copyBooleanArg(from: Record<string, unknown>, to: Record<string, unknown>, key: string): void {\n\tconst value = from[key];\n\tif (typeof value === \"boolean\") {\n\t\tto[key] = value;\n\t}\n}\n\nfunction copyStringArrayArg(from: Record<string, unknown>, to: Record<string, unknown>, key: string): void {\n\tconst value = from[key];\n\tif (!Array.isArray(value)) {\n\t\treturn;\n\t}\n\tconst strings = value\n\t\t.map((item) => (typeof item === \"string\" ? boundText(item, TOOL_ARGUMENT_STRING_LIMIT) : undefined))\n\t\t.filter((item): item is string => item !== undefined && item.trim().length > 0)\n\t\t.slice(0, TOOL_ARGUMENT_KEYS_LIMIT);\n\tif (strings.length > 0) {\n\t\tto[key] = strings;\n\t}\n}\n\nfunction projectSubagentArgs(args: Record<string, unknown> | undefined): Record<string, unknown> | undefined {\n\tif (!args) {\n\t\treturn undefined;\n\t}\n\tconst projected: Record<string, unknown> = {};\n\tconst agent = getStringArg(args, \"agent\");\n\tif (agent) {\n\t\tprojected.agent = boundSummary(agent, SUBAGENT_AGENT_LIMIT);\n\t}\n\tconst task = getStringArg(args, \"task\");\n\tif (task) {\n\t\tprojected.task = boundText(task, SUBAGENT_TASK_LIMIT);\n\t}\n\tconst tasks = projectSubagentInputArray(args.tasks);\n\tif (tasks) {\n\t\tprojected.tasks = tasks;\n\t}\n\tconst chain = projectSubagentInputArray(args.chain);\n\tif (chain) {\n\t\tprojected.chain = chain;\n\t}\n\treturn Object.keys(projected).length > 0 ? projected : undefined;\n}\n\nfunction projectSubagentInputArray(value: unknown): Record<string, string>[] | undefined {\n\tif (!Array.isArray(value)) {\n\t\treturn undefined;\n\t}\n\tconst projected = value\n\t\t.map((item) => {\n\t\t\tif (!isRecord(item)) {\n\t\t\t\treturn undefined;\n\t\t\t}\n\t\t\tconst agent = getStringArg(item, \"agent\");\n\t\t\tconst task = getStringArg(item, \"task\");\n\t\t\tif (!agent || !task) {\n\t\t\t\treturn undefined;\n\t\t\t}\n\t\t\treturn {\n\t\t\t\tagent: boundSummary(agent, SUBAGENT_AGENT_LIMIT),\n\t\t\t\ttask: boundText(task, SUBAGENT_TASK_LIMIT),\n\t\t\t};\n\t\t})\n\t\t.filter((item): item is { agent: string; task: string } => item !== undefined);\n\treturn projected.length > 0 ? projected : undefined;\n}\n\nexport function projectSubagentDetails(\n\tdetails: Record<string, unknown> | undefined,\n): Record<string, unknown> | undefined {\n\tif (!details) {\n\t\treturn undefined;\n\t}\n\tconst projected: Record<string, unknown> = {};\n\tcopyBoundedString(details, projected, \"mode\", SUBAGENT_AGENT_LIMIT);\n\tcopyBoundedString(details, projected, \"status\", SUBAGENT_AGENT_LIMIT);\n\tcopyBoundedString(details, projected, \"subagentId\", SUBAGENT_ID_LIMIT);\n\tcopyBoundedString(details, projected, \"sessionId\", SUBAGENT_ID_LIMIT);\n\tfor (const key of SUBAGENT_NUMERIC_DETAIL_KEYS) {\n\t\tconst numberValue = getFiniteNumber(details, key);\n\t\tif (numberValue !== undefined) {\n\t\t\tprojected[key] = numberValue;\n\t\t}\n\t}\n\tcopyBoundedString(details, projected, \"currentActivity\", SUBAGENT_ACTIVITY_LIMIT);\n\tconst summary = projectSubagentSummary(details.summary);\n\tif (summary) {\n\t\tprojected.summary = summary;\n\t}\n\tconst childSessions = projectSubagentDetailArray(details.childSessions);\n\tif (childSessions) {\n\t\tprojected.childSessions = childSessions;\n\t}\n\tconst agent = projectSubagentAgent(details.agent);\n\tif (agent) {\n\t\tprojected.agent = agent;\n\t}\n\tconst output = projectSubagentOutput(details.output);\n\tif (output) {\n\t\tprojected.output = output;\n\t}\n\tconst error = projectSubagentError(details.error);\n\tif (error) {\n\t\tprojected.error = error;\n\t}\n\tconst children = projectSubagentDetailArray(details.children);\n\tif (children) {\n\t\tprojected.children = children;\n\t}\n\tconst tasks = projectSubagentDetailArray(details.tasks);\n\tif (tasks) {\n\t\tprojected.tasks = tasks;\n\t}\n\tconst steps = projectSubagentDetailArray(details.steps);\n\tif (steps) {\n\t\tprojected.steps = steps;\n\t}\n\treturn Object.keys(projected).length > 0 ? projected : undefined;\n}\n\nfunction projectSubagentSummary(value: unknown): Record<string, number> | undefined {\n\tif (!isRecord(value)) {\n\t\treturn undefined;\n\t}\n\tconst projected: Record<string, number> = {};\n\tfor (const key of [\n\t\t\"total\",\n\t\t\"completed\",\n\t\t\"failed\",\n\t\t\"aborted\",\n\t\t\"running\",\n\t\t\"maxTasks\",\n\t\t\"maxConcurrency\",\n\t\t\"stoppedAt\",\n\t]) {\n\t\tconst numberValue = getFiniteNumber(value, key);\n\t\tif (numberValue !== undefined) {\n\t\t\tprojected[key] = numberValue;\n\t\t}\n\t}\n\treturn Object.keys(projected).length > 0 ? projected : undefined;\n}\n\nfunction projectSubagentDetailArray(value: unknown, depth = 0): Record<string, unknown>[] | undefined {\n\tif (!Array.isArray(value) || depth >= SUBAGENT_TREE_DEPTH_LIMIT) {\n\t\treturn undefined;\n\t}\n\tconst projected = value\n\t\t.map((item) => (isRecord(item) ? projectSubagentTaskDetails(item, depth) : undefined))\n\t\t.filter((item): item is Record<string, unknown> => item !== undefined);\n\treturn projected.length > 0 ? projected : undefined;\n}\n\nfunction projectSubagentTaskDetails(item: Record<string, unknown>, depth = 0): Record<string, unknown> | undefined {\n\tconst projected: Record<string, unknown> = {};\n\tconst index = getFiniteNumber(item, \"index\");\n\tif (index !== undefined) {\n\t\tprojected.index = index;\n\t}\n\tcopyBoundedString(item, projected, \"subagentId\", SUBAGENT_ID_LIMIT);\n\tcopyBoundedString(item, projected, \"sessionId\", SUBAGENT_ID_LIMIT);\n\tconst agent = projectSubagentAgent(item.agent);\n\tif (agent) {\n\t\tprojected.agent = agent;\n\t}\n\tcopyBoundedString(item, projected, \"status\", SUBAGENT_AGENT_LIMIT);\n\tcopyBoundedString(item, projected, \"task\", SUBAGENT_TASK_LIMIT);\n\tfor (const key of SUBAGENT_NUMERIC_DETAIL_KEYS) {\n\t\tconst numberValue = getFiniteNumber(item, key);\n\t\tif (numberValue !== undefined) {\n\t\t\tprojected[key] = numberValue;\n\t\t}\n\t}\n\tcopyBoundedString(item, projected, \"currentActivity\", SUBAGENT_ACTIVITY_LIMIT);\n\tconst error = projectSubagentError(item.error);\n\tif (error) {\n\t\tprojected.error = error;\n\t}\n\tconst children = projectSubagentDetailArray(item.children, depth + 1);\n\tif (children) {\n\t\tprojected.children = children;\n\t}\n\treturn Object.keys(projected).length > 0 ? projected : undefined;\n}\n\nfunction projectSubagentAgent(value: unknown): Record<string, string> | undefined {\n\tif (!isRecord(value)) {\n\t\treturn undefined;\n\t}\n\tconst projected: Record<string, string> = {};\n\tconst name = getStringArg(value, \"name\");\n\tif (name) {\n\t\tprojected.name = boundSummary(name, SUBAGENT_AGENT_LIMIT);\n\t}\n\tconst source = getStringArg(value, \"source\");\n\tif (source) {\n\t\tprojected.source = boundSummary(source, SUBAGENT_AGENT_LIMIT);\n\t}\n\treturn Object.keys(projected).length > 0 ? projected : undefined;\n}\n\nfunction projectSubagentOutput(value: unknown): Record<string, unknown> | undefined {\n\tif (!isRecord(value)) {\n\t\treturn undefined;\n\t}\n\tconst projected: Record<string, unknown> = {};\n\tconst text = getStringArg(value, \"text\");\n\tif (text) {\n\t\tprojected.text = boundText(text, SUBAGENT_OUTPUT_LIMIT);\n\t}\n\tfor (const key of [\"bytes\", \"omittedBytes\", \"maxBytes\"]) {\n\t\tconst numberValue = getFiniteNumber(value, key);\n\t\tif (numberValue !== undefined) {\n\t\t\tprojected[key] = numberValue;\n\t\t}\n\t}\n\tconst truncated = value.truncated;\n\tif (typeof truncated === \"boolean\") {\n\t\tprojected.truncated = truncated;\n\t}\n\treturn Object.keys(projected).length > 0 ? projected : undefined;\n}\n\nfunction projectSubagentError(value: unknown): Record<string, string> | undefined {\n\tif (!isRecord(value)) {\n\t\treturn undefined;\n\t}\n\tconst message = getStringArg(value, \"message\");\n\treturn message ? { message: boundText(message, SUBAGENT_ERROR_LIMIT) } : undefined;\n}\n\nfunction copyBoundedString(\n\tfrom: Record<string, unknown>,\n\tto: Record<string, unknown>,\n\tkey: string,\n\tlimit: number,\n): void {\n\tconst value = getStringArg(from, key);\n\tif (value) {\n\t\tto[key] = boundText(value, limit);\n\t}\n}\n\nfunction getFiniteNumber(record: Record<string, unknown>, key: string): number | undefined {\n\tconst value = record[key];\n\treturn typeof value === \"number\" && Number.isFinite(value) ? value : undefined;\n}\n\nfunction projectBashExecution(\n\tentryId: string,\n\ttimestamp: string,\n\tmessage: BashExecutionMessage,\n): RpcTranscriptToolItem {\n\tconst failed = message.cancelled || (message.exitCode !== undefined && message.exitCode !== 0);\n\tconst status: RpcTranscriptToolStatus = failed ? \"failed\" : \"completed\";\n\tconst summaryParts = [`Ran command: ${boundSummary(message.command, TOOL_COMMAND_LIMIT)}`];\n\tif (message.truncated) {\n\t\tsummaryParts.push(\"output truncated\");\n\t}\n\tif (message.cancelled) {\n\t\tsummaryParts.push(\"cancelled\");\n\t} else if (message.exitCode !== undefined) {\n\t\tsummaryParts.push(`exit ${message.exitCode}`);\n\t}\n\tconst item: RpcTranscriptToolItem = {\n\t\tid: entryId,\n\t\trole: \"tool\",\n\t\ttoolName: \"bash\",\n\t\tstatus,\n\t\tsummary: boundSummary(summaryParts.join(\"; \"), TOOL_SUMMARY_LIMIT),\n\t\ttimestamp: normalizeTimestamp(timestamp),\n\t};\n\tif (message.command.trim().length > 0) {\n\t\titem.args = { command: boundText(message.command, TOOL_COMMAND_LIMIT) };\n\t}\n\treturn item;\n}\n\nfunction summarizeToolResult(\n\ttoolName: string,\n\tstatus: RpcTranscriptToolStatus,\n\targs: Record<string, unknown> | undefined,\n\tpath: string | undefined,\n): string {\n\tconst statusText = status === \"failed\" ? \"failed\" : \"completed\";\n\tconst target = path ? ` ${path}` : \"\";\n\tif (toolName === \"read\") {\n\t\treturn boundSummary(`Read${target || \" file\"} (${statusText})`, TOOL_SUMMARY_LIMIT);\n\t}\n\tif (toolName === \"edit\") {\n\t\treturn boundSummary(`Edited${target || \" file\"} (${statusText})`, TOOL_SUMMARY_LIMIT);\n\t}\n\tif (toolName === \"write\") {\n\t\treturn boundSummary(`Wrote${target || \" file\"} (${statusText})`, TOOL_SUMMARY_LIMIT);\n\t}\n\tif (toolName === \"bash\") {\n\t\tconst command = getStringArg(args, \"command\");\n\t\treturn boundSummary(\n\t\t\tcommand\n\t\t\t\t? `Ran command: ${boundSummary(command, TOOL_COMMAND_LIMIT)} (${statusText})`\n\t\t\t\t: `Ran command (${statusText})`,\n\t\t\tTOOL_SUMMARY_LIMIT,\n\t\t);\n\t}\n\tif (toolName === \"web_search\") {\n\t\tconst query = getStringArg(args, \"query\");\n\t\treturn boundSummary(\n\t\t\tquery\n\t\t\t\t? `Searched web for ${boundSummary(query, TOOL_COMMAND_LIMIT)} (${statusText})`\n\t\t\t\t: `Searched web (${statusText})`,\n\t\t\tTOOL_SUMMARY_LIMIT,\n\t\t);\n\t}\n\tif (toolName === \"grep\") {\n\t\tconst pattern = getStringArg(args, \"pattern\");\n\t\tconst patternText = pattern ? ` for ${pattern}` : \"\";\n\t\treturn boundSummary(`Searched${target || \" workspace\"}${patternText} (${statusText})`, TOOL_SUMMARY_LIMIT);\n\t}\n\tif (toolName === \"find\") {\n\t\tconst query = getStringArg(args, \"query\") ?? getStringArg(args, \"pattern\");\n\t\tconst queryText = query ? ` for ${query}` : \"\";\n\t\treturn boundSummary(`Found files${target}${queryText} (${statusText})`, TOOL_SUMMARY_LIMIT);\n\t}\n\tif (toolName === \"ls\") {\n\t\treturn boundSummary(`Listed${target || \" directory\"} (${statusText})`, TOOL_SUMMARY_LIMIT);\n\t}\n\tif (toolName === \"lsp\") {\n\t\tconst action = getStringArg(args, \"action\");\n\t\treturn boundSummary(\n\t\t\taction ? `Ran lsp ${action}${target} (${statusText})` : `Ran lsp${target} (${statusText})`,\n\t\t\tTOOL_SUMMARY_LIMIT,\n\t\t);\n\t}\n\treturn boundSummary(`${toolName} ${statusText}`, TOOL_SUMMARY_LIMIT);\n}\n\nfunction getToolPath(toolName: string, args: Record<string, unknown> | undefined): string | undefined {\n\treturn getStringArg(args, \"path\") ?? getStringArg(args, \"file_path\") ?? getStringArg(args, `${toolName}Path`);\n}\n\nfunction getStringArg(args: Record<string, unknown> | undefined, key: string): string | undefined {\n\tconst value = args?.[key];\n\treturn typeof value === \"string\" && value.trim().length > 0 ? value : undefined;\n}\n\nfunction getBoundedString(record: Record<string, unknown> | undefined, key: string, limit: number): string | undefined {\n\tconst value = record?.[key];\n\treturn typeof value === \"string\" && value.length > 0 ? boundText(value, limit) : undefined;\n}\n\nfunction boundSummary(text: string, limit: number): string {\n\treturn boundText(text.replace(/\\s+/g, \" \").trim(), limit);\n}\n\nfunction boundText(text: string, limit: number): string {\n\tif (text.length <= limit) {\n\t\treturn text;\n\t}\n\treturn `${text.slice(0, Math.max(0, limit - 16)).trimEnd()}\\n[truncated]`;\n}\n\nfunction normalizeTimestamp(timestamp: string): string {\n\tconst date = new Date(timestamp);\n\treturn Number.isNaN(date.getTime()) ? timestamp : date.toISOString();\n}\n\nfunction isStoredToolCall(value: unknown): value is StoredToolCall {\n\treturn (\n\t\tisRecord(value) &&\n\t\tvalue.type === \"toolCall\" &&\n\t\ttypeof value.id === \"string\" &&\n\t\ttypeof value.name === \"string\" &&\n\t\tisRecord(value.arguments)\n\t);\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n"]}

package/dist/core/rpc/transcript.js

@@ -0,0 +1,624 @@
+import { Buffer } from "node:buffer";
+import { extractVisibleTextContent } from "../messages.js";
+const DEFAULT_TRANSCRIPT_LIMIT = 100;
+const MAX_TRANSCRIPT_LIMIT = 200;
+const MESSAGE_TEXT_LIMIT = 16_000;
+const SUMMARY_TEXT_LIMIT = 1_000;
+const TOOL_SUMMARY_LIMIT = 1_000;
+const TOOL_COMMAND_LIMIT = 500;
+const TOOL_ARGUMENT_STRING_LIMIT = 500;
+const TOOL_ARGUMENT_KEYS_LIMIT = 12;
+const MUTATION_PREVIEW_LIMIT = 4_000;
+const SUBAGENT_AGENT_LIMIT = 200;
+const SUBAGENT_ID_LIMIT = 200;
+const SUBAGENT_TASK_LIMIT = 1_000;
+const SUBAGENT_ERROR_LIMIT = 1_000;
+const SUBAGENT_OUTPUT_LIMIT = 1_000;
+const SUBAGENT_ACTIVITY_LIMIT = 300;
+const SUBAGENT_TREE_DEPTH_LIMIT = 5;
+const SUBAGENT_NUMERIC_DETAIL_KEYS = ["startedAt", "durationMs", "toolCalls", "tokens"];
+export function projectSessionTranscript(sessionManager, options = {}) {
+    const allItems = projectTranscriptItems(sessionManager.getBranch());
+    const beforeIndex = options.beforeEntryId
+        ? allItems.findIndex((item) => item.id === options.beforeEntryId)
+        : allItems.length;
+    const eligibleItems = beforeIndex === -1 ? [] : allItems.slice(0, beforeIndex);
+    const limit = normalizeLimit(options.limit);
+    const pageStart = Math.max(0, eligibleItems.length - limit);
+    const items = eligibleItems.slice(pageStart);
+    const hasMore = pageStart > 0;
+    return {
+        sessionId: sessionManager.getSessionId(),
+        items,
+        hasMore,
+        nextBeforeEntryId: hasMore ? (items[0]?.id ?? null) : null,
+    };
+}
+/**
+ * Serialized-size budget for one get_message_images response. Keeps the frame
+ * under the daemon control protocol's 8 MB line cap (the tightest transport on
+ * any relay path) with headroom for JSON envelope overhead. The first image of
+ * a page is always included so pagination cannot stall on a single large image.
+ */
+export const MESSAGE_IMAGES_RESPONSE_BUDGET_BYTES = 6 * 1024 * 1024;
+export const MESSAGE_IMAGES_PAGE_MAX_ITEMS = 32;
+function getSerializedMessageImageBytes(image, index) {
+    return Buffer.byteLength(JSON.stringify({ ...image, index }), "utf8");
+}
+/**
+ * Recovers the inline image blocks persisted on a session entry, paged from
+ * `startImageIndex` under `budgetBytes`. Text-only transcript projections
+ * advertise `imageCount`; reconnecting clients call this per entry to restore
+ * user-message images after a cold restart.
+ */
+export function projectMessageImages(entries, entryId, startImageIndex = 0, budgetBytes = MESSAGE_IMAGES_RESPONSE_BUDGET_BYTES) {
+    const entry = entries.find((candidate) => candidate.id === entryId);
+    if (!entry || entry.type !== "message") {
+        return { ok: false, error: "unknown_entry" };
+    }
+    const allImages = extractMessageImages(entry.message.content);
+    const start = Math.max(0, Math.floor(startImageIndex));
+    const images = [];
+    let usedBytes = 0;
+    let nextImageIndex = null;
+    for (let index = start; index < allImages.length; index++) {
+        const image = allImages[index];
+        const serializedBytes = getSerializedMessageImageBytes(image, index);
+        if (serializedBytes > budgetBytes && images.length === 0) {
+            return { ok: false, error: "image_too_large" };
+        }
+        if (images.length >= MESSAGE_IMAGES_PAGE_MAX_ITEMS || usedBytes + serializedBytes > budgetBytes) {
+            nextImageIndex = index;
+            break;
+        }
+        images.push({ ...image, index });
+        usedBytes += serializedBytes;
+    }
+    return { ok: true, entryId, totalImages: allImages.length, images, nextImageIndex };
+}
+/** Inline image blocks on a persisted message's content array. */
+export function extractMessageImages(content) {
+    if (!Array.isArray(content)) {
+        return [];
+    }
+    return content.filter((block) => isRecord(block) &&
+        block.type === "image" &&
+        typeof block.data === "string" &&
+        block.data.length > 0 &&
+        typeof block.mimeType === "string");
+}
+function normalizeLimit(limit) {
+    if (limit === undefined || !Number.isFinite(limit) || limit <= 0) {
+        return DEFAULT_TRANSCRIPT_LIMIT;
+    }
+    return Math.min(MAX_TRANSCRIPT_LIMIT, Math.floor(limit));
+}
+function projectTranscriptItems(entries) {
+    const toolCallsById = collectToolCalls(entries);
+    const items = [];
+    for (const entry of entries) {
+        if (entry.type === "compaction") {
+            items.push({
+                id: entry.id,
+                role: "summary",
+                timestamp: normalizeTimestamp(entry.timestamp),
+                title: "Conversation compacted",
+                text: boundText(entry.summary, SUMMARY_TEXT_LIMIT),
+            });
+            continue;
+        }
+        if (entry.type === "custom_message") {
+            const customItem = projectCustomMessage(entry);
+            if (customItem) {
+                items.push(customItem);
+            }
+            continue;
+        }
+        if (entry.type !== "message") {
+            continue;
+        }
+        const message = entry.message;
+        if (message.role === "user") {
+            const text = boundText(extractVisibleTextContent(message.content), MESSAGE_TEXT_LIMIT);
+            const imageCount = extractMessageImages(message.content).length;
+            if (text || imageCount > 0) {
+                items.push({
+                    id: entry.id,
+                    role: "user",
+                    text,
+                    timestamp: normalizeTimestamp(entry.timestamp),
+                    ...(imageCount > 0 ? { imageCount } : {}),
+                });
+            }
+            continue;
+        }
+        if (message.role === "assistant") {
+            const text = boundText(extractVisibleTextContent(message.content), MESSAGE_TEXT_LIMIT);
+            if (text) {
+                items.push({ id: entry.id, role: "assistant", text, timestamp: normalizeTimestamp(entry.timestamp) });
+            }
+            continue;
+        }
+        if (message.role === "toolResult") {
+            items.push(projectToolResult(entry.id, entry.timestamp, message, toolCallsById.get(message.toolCallId)));
+            continue;
+        }
+        if (message.role === "bashExecution") {
+            items.push(projectBashExecution(entry.id, entry.timestamp, message));
+        }
+    }
+    return items;
+}
+function projectCustomMessage(entry) {
+    if (!entry.display || entry.customType !== "review") {
+        return undefined;
+    }
+    const text = boundText(extractVisibleTextContent(entry.content), MESSAGE_TEXT_LIMIT);
+    if (!text) {
+        return undefined;
+    }
+    return { id: entry.id, role: "assistant", text, timestamp: normalizeTimestamp(entry.timestamp) };
+}
+function collectToolCalls(entries) {
+    const toolCalls = new Map();
+    for (const entry of entries) {
+        if (entry.type !== "message" || entry.message.role !== "assistant") {
+            continue;
+        }
+        for (const block of entry.message.content) {
+            if (isStoredToolCall(block)) {
+                toolCalls.set(block.id, block);
+            }
+        }
+    }
+    return toolCalls;
+}
+function projectToolResult(entryId, timestamp, message, toolCall) {
+    const args = toolCall?.arguments;
+    const status = message.isError ? "failed" : "completed";
+    const path = getToolPath(message.toolName, args);
+    const details = isRecord(message.details) ? message.details : undefined;
+    const item = {
+        id: entryId,
+        role: "tool",
+        toolName: message.toolName,
+        status,
+        summary: summarizeToolResult(message.toolName, status, args, path),
+        timestamp: normalizeTimestamp(timestamp),
+    };
+    if (path) {
+        item.path = path;
+    }
+    const imageCount = extractMessageImages(message.content).length;
+    if (imageCount > 0) {
+        item.imageCount = imageCount;
+    }
+    const diffPreview = getBoundedString(details, "diff", MUTATION_PREVIEW_LIMIT);
+    if (diffPreview) {
+        item.diffPreview = diffPreview;
+    }
+    const patchPreview = getBoundedString(details, "patch", MUTATION_PREVIEW_LIMIT);
+    if (patchPreview) {
+        item.patchPreview = patchPreview;
+    }
+    const projectedArgs = projectToolArgs(message.toolName, args);
+    if (projectedArgs) {
+        item.args = projectedArgs;
+    }
+    if (message.toolName === "subagent") {
+        const subagentDetails = projectSubagentDetails(details);
+        if (subagentDetails) {
+            item.details = subagentDetails;
+        }
+    }
+    return item;
+}
+function projectToolArgs(toolName, args) {
+    if (toolName === "subagent") {
+        return projectSubagentArgs(args);
+    }
+    if (!args) {
+        return undefined;
+    }
+    const projected = {};
+    switch (toolName) {
+        case "bash":
+            copyStringArg(args, projected, "command", TOOL_COMMAND_LIMIT);
+            copyNumberArg(args, projected, "timeout");
+            break;
+        case "read":
+            copyStringArg(args, projected, "path");
+            copyStringArg(args, projected, "file_path");
+            copyNumberArg(args, projected, "offset");
+            copyNumberArg(args, projected, "limit");
+            break;
+        case "edit":
+        case "write":
+            copyStringArg(args, projected, "path");
+            copyStringArg(args, projected, "file_path");
+            break;
+        case "grep":
+            copyStringArg(args, projected, "pattern");
+            copyStringArg(args, projected, "path");
+            copyStringArg(args, projected, "glob");
+            copyStringArg(args, projected, "include");
+            copyStringArg(args, projected, "exclude");
+            copyBooleanArg(args, projected, "ignoreCase");
+            copyBooleanArg(args, projected, "literal");
+            copyNumberArg(args, projected, "context");
+            break;
+        case "find":
+            copyStringArg(args, projected, "query");
+            copyStringArg(args, projected, "pattern");
+            copyStringArg(args, projected, "path");
+            copyStringArg(args, projected, "glob");
+            copyStringArg(args, projected, "name");
+            copyNumberArg(args, projected, "limit");
+            break;
+        case "ls":
+            copyStringArg(args, projected, "path");
+            copyNumberArg(args, projected, "limit");
+            break;
+        case "lsp":
+            copyStringArg(args, projected, "action");
+            copyStringArg(args, projected, "symbol");
+            copyStringArg(args, projected, "path");
+            copyStringArg(args, projected, "file_path");
+            copyNumberArg(args, projected, "line");
+            break;
+        case "web_search":
+            copyStringArg(args, projected, "query");
+            copyStringArrayArg(args, projected, "domains");
+            copyNumberArg(args, projected, "limit");
+            copyNumberArg(args, projected, "recencyDays");
+            break;
+        default:
+            break;
+    }
+    return Object.keys(projected).length > 0 ? projected : undefined;
+}
+function copyStringArg(from, to, key, limit = TOOL_ARGUMENT_STRING_LIMIT) {
+    const value = getStringArg(from, key);
+    if (value) {
+        to[key] = boundText(value, limit);
+    }
+}
+function copyNumberArg(from, to, key) {
+    const value = getFiniteNumber(from, key);
+    if (value !== undefined) {
+        to[key] = value;
+    }
+}
+function copyBooleanArg(from, to, key) {
+    const value = from[key];
+    if (typeof value === "boolean") {
+        to[key] = value;
+    }
+}
+function copyStringArrayArg(from, to, key) {
+    const value = from[key];
+    if (!Array.isArray(value)) {
+        return;
+    }
+    const strings = value
+        .map((item) => (typeof item === "string" ? boundText(item, TOOL_ARGUMENT_STRING_LIMIT) : undefined))
+        .filter((item) => item !== undefined && item.trim().length > 0)
+        .slice(0, TOOL_ARGUMENT_KEYS_LIMIT);
+    if (strings.length > 0) {
+        to[key] = strings;
+    }
+}
+function projectSubagentArgs(args) {
+    if (!args) {
+        return undefined;
+    }
+    const projected = {};
+    const agent = getStringArg(args, "agent");
+    if (agent) {
+        projected.agent = boundSummary(agent, SUBAGENT_AGENT_LIMIT);
+    }
+    const task = getStringArg(args, "task");
+    if (task) {
+        projected.task = boundText(task, SUBAGENT_TASK_LIMIT);
+    }
+    const tasks = projectSubagentInputArray(args.tasks);
+    if (tasks) {
+        projected.tasks = tasks;
+    }
+    const chain = projectSubagentInputArray(args.chain);
+    if (chain) {
+        projected.chain = chain;
+    }
+    return Object.keys(projected).length > 0 ? projected : undefined;
+}
+function projectSubagentInputArray(value) {
+    if (!Array.isArray(value)) {
+        return undefined;
+    }
+    const projected = value
+        .map((item) => {
+        if (!isRecord(item)) {
+            return undefined;
+        }
+        const agent = getStringArg(item, "agent");
+        const task = getStringArg(item, "task");
+        if (!agent || !task) {
+            return undefined;
+        }
+        return {
+            agent: boundSummary(agent, SUBAGENT_AGENT_LIMIT),
+            task: boundText(task, SUBAGENT_TASK_LIMIT),
+        };
+    })
+        .filter((item) => item !== undefined);
+    return projected.length > 0 ? projected : undefined;
+}
+export function projectSubagentDetails(details) {
+    if (!details) {
+        return undefined;
+    }
+    const projected = {};
+    copyBoundedString(details, projected, "mode", SUBAGENT_AGENT_LIMIT);
+    copyBoundedString(details, projected, "status", SUBAGENT_AGENT_LIMIT);
+    copyBoundedString(details, projected, "subagentId", SUBAGENT_ID_LIMIT);
+    copyBoundedString(details, projected, "sessionId", SUBAGENT_ID_LIMIT);
+    for (const key of SUBAGENT_NUMERIC_DETAIL_KEYS) {
+        const numberValue = getFiniteNumber(details, key);
+        if (numberValue !== undefined) {
+            projected[key] = numberValue;
+        }
+    }
+    copyBoundedString(details, projected, "currentActivity", SUBAGENT_ACTIVITY_LIMIT);
+    const summary = projectSubagentSummary(details.summary);
+    if (summary) {
+        projected.summary = summary;
+    }
+    const childSessions = projectSubagentDetailArray(details.childSessions);
+    if (childSessions) {
+        projected.childSessions = childSessions;
+    }
+    const agent = projectSubagentAgent(details.agent);
+    if (agent) {
+        projected.agent = agent;
+    }
+    const output = projectSubagentOutput(details.output);
+    if (output) {
+        projected.output = output;
+    }
+    const error = projectSubagentError(details.error);
+    if (error) {
+        projected.error = error;
+    }
+    const children = projectSubagentDetailArray(details.children);
+    if (children) {
+        projected.children = children;
+    }
+    const tasks = projectSubagentDetailArray(details.tasks);
+    if (tasks) {
+        projected.tasks = tasks;
+    }
+    const steps = projectSubagentDetailArray(details.steps);
+    if (steps) {
+        projected.steps = steps;
+    }
+    return Object.keys(projected).length > 0 ? projected : undefined;
+}
+function projectSubagentSummary(value) {
+    if (!isRecord(value)) {
+        return undefined;
+    }
+    const projected = {};
+    for (const key of [
+        "total",
+        "completed",
+        "failed",
+        "aborted",
+        "running",
+        "maxTasks",
+        "maxConcurrency",
+        "stoppedAt",
+    ]) {
+        const numberValue = getFiniteNumber(value, key);
+        if (numberValue !== undefined) {
+            projected[key] = numberValue;
+        }
+    }
+    return Object.keys(projected).length > 0 ? projected : undefined;
+}
+function projectSubagentDetailArray(value, depth = 0) {
+    if (!Array.isArray(value) || depth >= SUBAGENT_TREE_DEPTH_LIMIT) {
+        return undefined;
+    }
+    const projected = value
+        .map((item) => (isRecord(item) ? projectSubagentTaskDetails(item, depth) : undefined))
+        .filter((item) => item !== undefined);
+    return projected.length > 0 ? projected : undefined;
+}
+function projectSubagentTaskDetails(item, depth = 0) {
+    const projected = {};
+    const index = getFiniteNumber(item, "index");
+    if (index !== undefined) {
+        projected.index = index;
+    }
+    copyBoundedString(item, projected, "subagentId", SUBAGENT_ID_LIMIT);
+    copyBoundedString(item, projected, "sessionId", SUBAGENT_ID_LIMIT);
+    const agent = projectSubagentAgent(item.agent);
+    if (agent) {
+        projected.agent = agent;
+    }
+    copyBoundedString(item, projected, "status", SUBAGENT_AGENT_LIMIT);
+    copyBoundedString(item, projected, "task", SUBAGENT_TASK_LIMIT);
+    for (const key of SUBAGENT_NUMERIC_DETAIL_KEYS) {
+        const numberValue = getFiniteNumber(item, key);
+        if (numberValue !== undefined) {
+            projected[key] = numberValue;
+        }
+    }
+    copyBoundedString(item, projected, "currentActivity", SUBAGENT_ACTIVITY_LIMIT);
+    const error = projectSubagentError(item.error);
+    if (error) {
+        projected.error = error;
+    }
+    const children = projectSubagentDetailArray(item.children, depth + 1);
+    if (children) {
+        projected.children = children;
+    }
+    return Object.keys(projected).length > 0 ? projected : undefined;
+}
+function projectSubagentAgent(value) {
+    if (!isRecord(value)) {
+        return undefined;
+    }
+    const projected = {};
+    const name = getStringArg(value, "name");
+    if (name) {
+        projected.name = boundSummary(name, SUBAGENT_AGENT_LIMIT);
+    }
+    const source = getStringArg(value, "source");
+    if (source) {
+        projected.source = boundSummary(source, SUBAGENT_AGENT_LIMIT);
+    }
+    return Object.keys(projected).length > 0 ? projected : undefined;
+}
+function projectSubagentOutput(value) {
+    if (!isRecord(value)) {
+        return undefined;
+    }
+    const projected = {};
+    const text = getStringArg(value, "text");
+    if (text) {
+        projected.text = boundText(text, SUBAGENT_OUTPUT_LIMIT);
+    }
+    for (const key of ["bytes", "omittedBytes", "maxBytes"]) {
+        const numberValue = getFiniteNumber(value, key);
+        if (numberValue !== undefined) {
+            projected[key] = numberValue;
+        }
+    }
+    const truncated = value.truncated;
+    if (typeof truncated === "boolean") {
+        projected.truncated = truncated;
+    }
+    return Object.keys(projected).length > 0 ? projected : undefined;
+}
+function projectSubagentError(value) {
+    if (!isRecord(value)) {
+        return undefined;
+    }
+    const message = getStringArg(value, "message");
+    return message ? { message: boundText(message, SUBAGENT_ERROR_LIMIT) } : undefined;
+}
+function copyBoundedString(from, to, key, limit) {
+    const value = getStringArg(from, key);
+    if (value) {
+        to[key] = boundText(value, limit);
+    }
+}
+function getFiniteNumber(record, key) {
+    const value = record[key];
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+function projectBashExecution(entryId, timestamp, message) {
+    const failed = message.cancelled || (message.exitCode !== undefined && message.exitCode !== 0);
+    const status = failed ? "failed" : "completed";
+    const summaryParts = [`Ran command: ${boundSummary(message.command, TOOL_COMMAND_LIMIT)}`];
+    if (message.truncated) {
+        summaryParts.push("output truncated");
+    }
+    if (message.cancelled) {
+        summaryParts.push("cancelled");
+    }
+    else if (message.exitCode !== undefined) {
+        summaryParts.push(`exit ${message.exitCode}`);
+    }
+    const item = {
+        id: entryId,
+        role: "tool",
+        toolName: "bash",
+        status,
+        summary: boundSummary(summaryParts.join("; "), TOOL_SUMMARY_LIMIT),
+        timestamp: normalizeTimestamp(timestamp),
+    };
+    if (message.command.trim().length > 0) {
+        item.args = { command: boundText(message.command, TOOL_COMMAND_LIMIT) };
+    }
+    return item;
+}
+function summarizeToolResult(toolName, status, args, path) {
+    const statusText = status === "failed" ? "failed" : "completed";
+    const target = path ? ` ${path}` : "";
+    if (toolName === "read") {
+        return boundSummary(`Read${target || " file"} (${statusText})`, TOOL_SUMMARY_LIMIT);
+    }
+    if (toolName === "edit") {
+        return boundSummary(`Edited${target || " file"} (${statusText})`, TOOL_SUMMARY_LIMIT);
+    }
+    if (toolName === "write") {
+        return boundSummary(`Wrote${target || " file"} (${statusText})`, TOOL_SUMMARY_LIMIT);
+    }
+    if (toolName === "bash") {
+        const command = getStringArg(args, "command");
+        return boundSummary(command
+            ? `Ran command: ${boundSummary(command, TOOL_COMMAND_LIMIT)} (${statusText})`
+            : `Ran command (${statusText})`, TOOL_SUMMARY_LIMIT);
+    }
+    if (toolName === "web_search") {
+        const query = getStringArg(args, "query");
+        return boundSummary(query
+            ? `Searched web for ${boundSummary(query, TOOL_COMMAND_LIMIT)} (${statusText})`
+            : `Searched web (${statusText})`, TOOL_SUMMARY_LIMIT);
+    }
+    if (toolName === "grep") {
+        const pattern = getStringArg(args, "pattern");
+        const patternText = pattern ? ` for ${pattern}` : "";
+        return boundSummary(`Searched${target || " workspace"}${patternText} (${statusText})`, TOOL_SUMMARY_LIMIT);
+    }
+    if (toolName === "find") {
+        const query = getStringArg(args, "query") ?? getStringArg(args, "pattern");
+        const queryText = query ? ` for ${query}` : "";
+        return boundSummary(`Found files${target}${queryText} (${statusText})`, TOOL_SUMMARY_LIMIT);
+    }
+    if (toolName === "ls") {
+        return boundSummary(`Listed${target || " directory"} (${statusText})`, TOOL_SUMMARY_LIMIT);
+    }
+    if (toolName === "lsp") {
+        const action = getStringArg(args, "action");
+        return boundSummary(action ? `Ran lsp ${action}${target} (${statusText})` : `Ran lsp${target} (${statusText})`, TOOL_SUMMARY_LIMIT);
+    }
+    return boundSummary(`${toolName} ${statusText}`, TOOL_SUMMARY_LIMIT);
+}
+function getToolPath(toolName, args) {
+    return getStringArg(args, "path") ?? getStringArg(args, "file_path") ?? getStringArg(args, `${toolName}Path`);
+}
+function getStringArg(args, key) {
+    const value = args?.[key];
+    return typeof value === "string" && value.trim().length > 0 ? value : undefined;
+}
+function getBoundedString(record, key, limit) {
+    const value = record?.[key];
+    return typeof value === "string" && value.length > 0 ? boundText(value, limit) : undefined;
+}
+function boundSummary(text, limit) {
+    return boundText(text.replace(/\s+/g, " ").trim(), limit);
+}
+function boundText(text, limit) {
+    if (text.length <= limit) {
+        return text;
+    }
+    return `${text.slice(0, Math.max(0, limit - 16)).trimEnd()}\n[truncated]`;
+}
+function normalizeTimestamp(timestamp) {
+    const date = new Date(timestamp);
+    return Number.isNaN(date.getTime()) ? timestamp : date.toISOString();
+}
+function isStoredToolCall(value) {
+    return (isRecord(value) &&
+        value.type === "toolCall" &&
+        typeof value.id === "string" &&
+        typeof value.name === "string" &&
+        isRecord(value.arguments));
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=transcript.js.map