@greppleai/grip 0.0.0-stage → 0.0.1

package/dist/core/tools/session-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-history.d.ts","sourceRoot":"","sources":["../../../src/core/tools/session-history.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAE5D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AA+B7D,QAAA,MAAM,mBAAmB;;;;;;;;EAoCvB,CAAC;AAEH,QAAA,MAAM,qBAAqB;;EAKzB,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,gBAAgB,GAAG,mBAAmB,CAAC;AAC5E,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACxE,MAAM,MAAM,wBAAwB,GAAG,MAAM,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAC5E,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE9D,MAAM,WAAW,kBAAkB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,wBAAwB;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,0BAA0B;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;CACzB;AAqkBD,wBAAgB,iCAAiC,CAChD,OAAO,EAAE,eAAe,GACtB,cAAc,CAAC,OAAO,mBAAmB,EAAE,wBAAwB,CAAC,CA8DtE;AAED,wBAAgB,mCAAmC,CAClD,OAAO,EAAE,eAAe,GACtB,cAAc,CAAC,OAAO,qBAAqB,EAAE,0BAA0B,CAAC,CAkC1E;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,eAAe,GAAG,SAAS,CAAC,OAAO,mBAAmB,CAAC,CAEvG;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,eAAe,GAAG,SAAS,CAAC,OAAO,qBAAqB,CAAC,CAE3G","sourcesContent":["import { Worker } from \"node:worker_threads\";\nimport type { AgentTool } from \"@greppleai/grip-agent-core\";\nimport { StringEnum } from \"@greppleai/grip-ai\";\nimport type { Static } from \"typebox\";\nimport { Type } from \"typebox\";\nimport type { ToolDefinition } from \"../extensions/types.ts\";\nimport { STRUCTURED_RESPONSE_INTERNAL_CUSTOM_TYPE } from \"../messages.ts\";\nimport { getLatestCompactionEntry, projectSessionContextEntries } from \"../session/context.ts\";\nimport type { ReadonlySession } from \"../session/session.ts\";\nimport type { SessionEntry } from \"../session/types.ts\";\nimport { abortIf } from \"./runtime.ts\";\nimport { wrapToolDefinition } from \"./tool-definition-wrapper.ts\";\nimport { DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, truncateHead, truncateLine } from \"./truncate.ts\";\n\nconst DEFAULT_SEARCH_RESULTS = 20;\nconst MAX_SEARCH_RESULTS = 50;\nconst MAX_CONTEXT_LINES = 5;\nconst MAX_PATTERN_LENGTH = 1000;\nconst MAX_DISPLAY_LINE_LENGTH = 500;\nconst MAX_SEARCH_LINE_LENGTH = 10_000;\nconst MAX_SEARCH_BYTES = 5 * 1024 * 1024;\nconst MAX_SEARCH_LINES = 100_000;\nconst MAX_ENTRY_SERIALIZATION_BYTES = 5 * 1024 * 1024;\nconst REGEX_TIMEOUT_MS = 1000;\n\nconst REGEX_WORKER_SOURCE = `\nconst { parentPort, workerData } = require(\"node:worker_threads\");\ntry {\n  const expression = new RegExp(workerData.pattern, workerData.ignoreCase ? \"iu\" : \"u\");\n  const indexes = [];\n  for (let index = 0; index < workerData.lines.length; index++) {\n    if (expression.test(workerData.lines[index])) indexes.push(index);\n  }\n  parentPort.postMessage({ indexes });\n} catch (error) {\n  parentPort.postMessage({ error: error instanceof Error ? error.message : String(error) });\n}\n`;\n\nconst sessionSearchSchema = Type.Object({\n\tpattern: Type.String({\n\t\tdescription:\n\t\t\t\"JavaScript regular expression to search for, without / delimiters; use fixedStrings for literal matching\",\n\t\tmaxLength: MAX_PATTERN_LENGTH,\n\t}),\n\tignoreCase: Type.Optional(Type.Boolean({ description: \"Perform case-insensitive matching, like grep -i\" })),\n\tfixedStrings: Type.Optional(\n\t\tType.Boolean({ description: \"Treat pattern as a literal string instead of a regular expression, like grep -F\" }),\n\t),\n\tbeforeContext: Type.Optional(\n\t\tType.Integer({\n\t\t\tdescription: `Context lines before each match (default 0, max ${MAX_CONTEXT_LINES}), like grep -B`,\n\t\t\tminimum: 0,\n\t\t\tmaximum: MAX_CONTEXT_LINES,\n\t\t}),\n\t),\n\tafterContext: Type.Optional(\n\t\tType.Integer({\n\t\t\tdescription: `Context lines after each match (default 0, max ${MAX_CONTEXT_LINES}), like grep -A`,\n\t\t\tminimum: 0,\n\t\t\tmaximum: MAX_CONTEXT_LINES,\n\t\t}),\n\t),\n\tmaxResults: Type.Optional(\n\t\tType.Integer({\n\t\t\tdescription: `Maximum matching lines to return (default ${DEFAULT_SEARCH_RESULTS}, max ${MAX_SEARCH_RESULTS})`,\n\t\t\tminimum: 1,\n\t\t\tmaximum: MAX_SEARCH_RESULTS,\n\t\t}),\n\t),\n\tscope: Type.Optional(\n\t\tStringEnum([\"context\", \"branch\", \"all\"] as const, {\n\t\t\tdescription: \"Search entries in the current model context (default), current branch ancestry, or every branch\",\n\t\t}),\n\t),\n});\n\nconst sessionEntryGetSchema = Type.Object({\n\tentryId: Type.String({\n\t\tdescription: \"Exact session entry ID returned by session_search or another session API\",\n\t\tminLength: 1,\n\t}),\n});\n\nexport type SessionHistoryToolName = \"session_search\" | \"session_entry_get\";\nexport type SessionSearchToolInput = Static<typeof sessionSearchSchema>;\nexport type SessionEntryGetToolInput = Static<typeof sessionEntryGetSchema>;\nexport type SessionSearchScope = \"context\" | \"branch\" | \"all\";\n\nexport interface SessionSearchMatch {\n\tentryId: string;\n\tentryType: string;\n\trole?: string;\n\ttimestamp: string;\n\tlineNumber: number;\n\tline: string;\n}\n\nexport interface SessionSearchToolDetails {\n\tpattern: string;\n\tignoreCase: boolean;\n\tfixedStrings: boolean;\n\tscope: SessionSearchScope;\n\tmatchCount: number;\n\treturnedMatchCount: number;\n\tmatches: SessionSearchMatch[];\n\tscannedEntries: number;\n\tscannedLines: number;\n\tscannedBytes: number;\n\tscanTruncated: boolean;\n\toutputTruncated: boolean;\n}\n\nexport interface SessionEntryGetToolDetails {\n\tentryId: string;\n\tentryType: string;\n\tonCurrentBranch: boolean;\n\toutputTruncated: boolean;\n}\n\ninterface SearchDocument {\n\tentry: SessionEntry;\n\trole?: string;\n\tlines: string[];\n\tbytes: number;\n\ttruncated: boolean;\n\tlimitReached: boolean;\n}\n\ninterface SearchLine {\n\tdocument: SearchDocument;\n\tlineIndex: number;\n}\n\ninterface SearchCorpus {\n\tlines: SearchLine[];\n\tscannedEntries: number;\n\tscannedBytes: number;\n\ttruncated: boolean;\n}\n\ninterface SessionSearchContextLine {\n\tlineNumber: number;\n\tline: string;\n}\n\ninterface CollectedMatch extends SessionSearchMatch {\n\tcontextBefore: SessionSearchContextLine[];\n\tcontextAfter: SessionSearchContextLine[];\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction sanitizeImageData(value: unknown): unknown {\n\tif (Array.isArray(value)) return value.map((child) => sanitizeImageData(child));\n\tif (!isRecord(value)) return value;\n\tconst result: Record<string, unknown> = {};\n\tconst imageDataLength = value.type === \"image\" && typeof value.data === \"string\" ? value.data.length : undefined;\n\tfor (const key in value) {\n\t\tif (!Object.hasOwn(value, key)) continue;\n\t\tconst child = value[key];\n\t\tresult[key] =\n\t\t\timageDataLength !== undefined && key === \"data\"\n\t\t\t\t? `[base64 image data omitted: ${imageDataLength} chars]`\n\t\t\t\t: sanitizeImageData(child);\n\t}\n\treturn result;\n}\n\nfunction estimateSerializedArrayBytes(values: unknown[], limit: number, seen: Set<object>): number {\n\tlet total = 2;\n\tfor (const value of values) {\n\t\ttotal += estimateSerializedBytes(value, limit - total, seen) + 1;\n\t\tif (total > limit) return total;\n\t}\n\treturn total;\n}\n\nfunction estimateSerializedRecordBytes(value: Record<string, unknown>, limit: number, seen: Set<object>): number {\n\tlet total = 2;\n\tfor (const key in value) {\n\t\tif (!Object.hasOwn(value, key)) continue;\n\t\ttotal += Buffer.byteLength(key, \"utf8\") * 6 + estimateSerializedBytes(value[key], limit - total, seen) + 4;\n\t\tif (total > limit) return total;\n\t}\n\treturn total;\n}\n\nfunction estimateSerializedBytes(value: unknown, limit: number, seen = new Set<object>()): number {\n\tif (typeof value === \"string\") return Buffer.byteLength(value, \"utf8\") * 6 + 2;\n\tif (typeof value !== \"object\" || value === null) return Buffer.byteLength(String(value), \"utf8\");\n\tif (seen.has(value)) return 0;\n\tseen.add(value);\n\tif (Array.isArray(value)) return estimateSerializedArrayBytes(value, limit, seen);\n\tif (isRecord(value)) return estimateSerializedRecordBytes(value, limit, seen);\n\treturn 2;\n}\n\ninterface BoundedLineCollector {\n\tlines: string[];\n\tbytes: number;\n\tencounteredLines: number;\n\ttruncated: boolean;\n\tlimitReached: boolean;\n\tappendLine(line: string): boolean;\n\tomitOversizedLine(): boolean;\n\tappendText(text: string): boolean;\n}\ninterface SearchLineTextSegment {\n\tkind: \"line\";\n\tline: string;\n\tnextStart: number;\n}\n\ninterface OversizedSearchTextSegment {\n\tkind: \"oversized\";\n\tcomplete: boolean;\n}\n\ntype SearchTextSegment = SearchLineTextSegment | OversizedSearchTextSegment;\n\nfunction readSearchTextSegment(text: string, start: number): SearchTextSegment {\n\tconst windowEnd = Math.min(text.length, start + MAX_SEARCH_LINE_LENGTH + 1);\n\tconst window = text.slice(start, windowEnd);\n\tconst lineFeed = window.indexOf(\"\\n\");\n\tconst carriageReturn = window.indexOf(\"\\r\");\n\tlet separatorIndex = lineFeed;\n\tif (separatorIndex < 0 || (carriageReturn >= 0 && carriageReturn < separatorIndex)) {\n\t\tseparatorIndex = carriageReturn;\n\t}\n\tif (separatorIndex < 0) {\n\t\tif (window.length > MAX_SEARCH_LINE_LENGTH) {\n\t\t\treturn { kind: \"oversized\", complete: windowEnd === text.length };\n\t\t}\n\t\treturn { kind: \"line\", line: window, nextStart: text.length };\n\t}\n\n\tconst separatorPosition = start + separatorIndex;\n\tconst separatorLength = text[separatorPosition] === \"\\r\" && text[separatorPosition + 1] === \"\\n\" ? 2 : 1;\n\treturn {\n\t\tkind: \"line\",\n\t\tline: window.slice(0, separatorIndex),\n\t\tnextStart: separatorPosition + separatorLength,\n\t};\n}\nfunction appendOversizedSearchTextSegment(\n\tcollector: BoundedLineCollector,\n\tsegment: OversizedSearchTextSegment,\n): boolean {\n\tif (!collector.omitOversizedLine()) return false;\n\tif (!segment.complete) collector.limitReached = true;\n\treturn segment.complete;\n}\n\nfunction createBoundedLineCollector(maxLines: number, maxBytes: number): BoundedLineCollector {\n\tconst collector: BoundedLineCollector = {\n\t\tlines: [],\n\t\tbytes: 0,\n\t\tencounteredLines: 0,\n\t\ttruncated: false,\n\t\tlimitReached: false,\n\t\tappendLine(line) {\n\t\t\tif (line.length > MAX_SEARCH_LINE_LENGTH) return collector.omitOversizedLine();\n\t\t\tconst lineBytes = Buffer.byteLength(line, \"utf8\") + 1;\n\t\t\tif (collector.encounteredLines >= maxLines || collector.bytes + lineBytes > maxBytes) {\n\t\t\t\tcollector.truncated = true;\n\t\t\t\tcollector.limitReached = true;\n\t\t\t\treturn false;\n\t\t\t}\n\t\t\tcollector.lines.push(line);\n\t\t\tcollector.bytes += lineBytes;\n\t\t\tcollector.encounteredLines++;\n\t\t\treturn true;\n\t\t},\n\t\tomitOversizedLine() {\n\t\t\tconst budgetBytes = MAX_SEARCH_LINE_LENGTH * 4 + 1;\n\t\t\tif (collector.encounteredLines >= maxLines || collector.bytes + budgetBytes > maxBytes) {\n\t\t\t\tcollector.truncated = true;\n\t\t\t\tcollector.limitReached = true;\n\t\t\t\treturn false;\n\t\t\t}\n\t\t\tcollector.bytes += budgetBytes;\n\t\t\tcollector.encounteredLines++;\n\t\t\tcollector.truncated = true;\n\t\t\treturn true;\n\t\t},\n\t\tappendText(text) {\n\t\t\tif (text.length === 0) return collector.appendLine(\"\");\n\t\t\tlet start = 0;\n\t\t\twhile (start < text.length) {\n\t\t\t\tconst segment = readSearchTextSegment(text, start);\n\t\t\t\tif (segment.kind === \"oversized\") return appendOversizedSearchTextSegment(collector, segment);\n\t\t\t\tif (!collector.appendLine(segment.line)) return false;\n\t\t\t\tstart = segment.nextStart;\n\t\t\t}\n\t\t\treturn true;\n\t\t},\n\t};\n\treturn collector;\n}\n\nfunction appendSearchArrayValues(collector: BoundedLineCollector, values: unknown[], seen: Set<object>): boolean {\n\tfor (let index = 0; index < values.length; index++) {\n\t\tif (!appendSearchValue(collector, values[index], seen, `[${index}]`)) return false;\n\t}\n\treturn true;\n}\n\nfunction appendSearchRecordValue(\n\tcollector: BoundedLineCollector,\n\tvalue: Record<string, unknown>,\n\tseen: Set<object>,\n): boolean {\n\tif (value.type === \"image\" && typeof value.data === \"string\") {\n\t\treturn collector.appendLine(\n\t\t\t`[image ${typeof value.mimeType === \"string\" ? value.mimeType : \"unknown\"} data omitted: ${value.data.length} chars]`,\n\t\t);\n\t}\n\tfor (const key in value) {\n\t\tif (!Object.hasOwn(value, key)) continue;\n\t\tif (!appendSearchValue(collector, value[key], seen, key)) return false;\n\t}\n\treturn true;\n}\n\nfunction appendSearchValue(\n\tcollector: BoundedLineCollector,\n\tvalue: unknown,\n\tseen = new Set<object>(),\n\tlabel?: string,\n): boolean {\n\tif (label !== undefined && !collector.appendLine(`${label}:`)) return false;\n\tif (typeof value === \"string\") return collector.appendText(value);\n\tif (typeof value !== \"object\" || value === null) return collector.appendLine(String(value));\n\tif (seen.has(value)) return collector.appendLine(\"[circular value omitted]\");\n\tseen.add(value);\n\tif (Array.isArray(value)) return appendSearchArrayValues(collector, value, seen);\n\tif (!isRecord(value)) return collector.appendLine(String(value));\n\treturn appendSearchRecordValue(collector, value, seen);\n}\n\nfunction appendSearchContentBlock(collector: BoundedLineCollector, block: Record<string, unknown>): void {\n\tswitch (block.type) {\n\t\tcase \"text\":\n\t\t\tif (typeof block.text === \"string\") collector.appendText(block.text);\n\t\t\tbreak;\n\t\tcase \"thinking\":\n\t\t\tif (typeof block.thinking !== \"string\") break;\n\t\t\tcollector.appendLine(\"thinking:\");\n\t\t\tcollector.appendText(block.thinking);\n\t\t\tbreak;\n\t\tcase \"toolCall\":\n\t\t\tcollector.appendLine(`tool_call: ${typeof block.name === \"string\" ? block.name : \"unknown\"}`);\n\t\t\tif (block.arguments !== undefined) appendSearchValue(collector, block.arguments);\n\t\t\tbreak;\n\t\tcase \"image\":\n\t\t\tcollector.appendLine(`[image ${typeof block.mimeType === \"string\" ? block.mimeType : \"unknown\"} omitted]`);\n\t\t\tbreak;\n\t}\n}\n\nfunction appendContentLines(collector: BoundedLineCollector, content: unknown): void {\n\tif (typeof content === \"string\") {\n\t\tcollector.appendText(content);\n\t\treturn;\n\t}\n\tif (!Array.isArray(content)) return;\n\tfor (const block of content) {\n\t\tif (collector.limitReached) break;\n\t\tif (isRecord(block)) appendSearchContentBlock(collector, block);\n\t}\n}\n\nfunction finishSearchDocument(entry: SessionEntry, collector: BoundedLineCollector, role?: string): SearchDocument {\n\treturn {\n\t\tentry,\n\t\trole,\n\t\tlines: collector.lines,\n\t\tbytes: collector.bytes,\n\t\ttruncated: collector.truncated,\n\t\tlimitReached: collector.limitReached,\n\t};\n}\n\nfunction createMessageSearchDocument(entry: SessionEntry, collector: BoundedLineCollector): SearchDocument | undefined {\n\tif (entry.type !== \"message\") return undefined;\n\tconst message = entry.message;\n\tconst role = message.role;\n\tif (role === \"bashExecution\" && message.excludeFromContext) return undefined;\n\tif (role === \"custom\" && message.customType === STRUCTURED_RESPONSE_INTERNAL_CUSTOM_TYPE) return undefined;\n\tcollector.appendLine(`role: ${role}`);\n\tswitch (role) {\n\t\tcase \"user\":\n\t\tcase \"assistant\":\n\t\t\tappendContentLines(collector, message.content);\n\t\t\tbreak;\n\t\tcase \"toolResult\":\n\t\t\tcollector.appendLine(`tool_name: ${message.toolName}`);\n\t\t\tappendContentLines(collector, message.content);\n\t\t\tbreak;\n\t\tcase \"custom\":\n\t\t\tcollector.appendLine(`custom_type: ${message.customType}`);\n\t\t\tappendContentLines(collector, message.content);\n\t\t\tbreak;\n\t\tcase \"bashExecution\":\n\t\t\tcollector.appendLine(\"command:\");\n\t\t\tcollector.appendText(message.command);\n\t\t\tcollector.appendLine(\"output:\");\n\t\t\tcollector.appendText(message.output);\n\t\t\tbreak;\n\t\tcase \"branchSummary\":\n\t\tcase \"compactionSummary\":\n\t\t\tcollector.appendText(message.summary);\n\t\t\tbreak;\n\t}\n\treturn finishSearchDocument(entry, collector, role);\n}\n\nfunction createMetadataSearchDocument(\n\tentry: SessionEntry,\n\tcollector: BoundedLineCollector,\n): SearchDocument | undefined {\n\tif (entry.type === \"message\") return undefined;\n\tswitch (entry.type) {\n\t\tcase \"compaction\":\n\t\t\tcollector.appendLine(\"compaction summary:\");\n\t\t\tcollector.appendText(entry.summary);\n\t\t\treturn finishSearchDocument(entry, collector);\n\t\tcase \"branch_summary\":\n\t\t\tcollector.appendLine(\"branch summary:\");\n\t\t\tcollector.appendText(entry.summary);\n\t\t\treturn finishSearchDocument(entry, collector);\n\t\tcase \"custom_message\":\n\t\t\tif (entry.customType === STRUCTURED_RESPONSE_INTERNAL_CUSTOM_TYPE) return undefined;\n\t\t\tcollector.appendLine(`custom_type: ${entry.customType}`);\n\t\t\tappendContentLines(collector, entry.content);\n\t\t\treturn finishSearchDocument(entry, collector, \"custom\");\n\t\tcase \"thinking_level_change\":\n\t\t\tcollector.appendLine(`thinking_level: ${entry.thinkingLevel}`);\n\t\t\treturn finishSearchDocument(entry, collector);\n\t\tcase \"model_change\":\n\t\t\tcollector.appendLine(`model: ${entry.provider}/${entry.modelId}`);\n\t\t\treturn finishSearchDocument(entry, collector);\n\t\tcase \"label\":\n\t\t\tcollector.appendLine(`label target: ${entry.targetId}`);\n\t\t\tcollector.appendLine(`label: ${entry.label ?? \"(cleared)\"}`);\n\t\t\treturn finishSearchDocument(entry, collector);\n\t\tcase \"session_info\":\n\t\t\tcollector.appendLine(`session_name: ${entry.name ?? \"\"}`);\n\t\t\treturn finishSearchDocument(entry, collector);\n\t\tcase \"custom\":\n\t\t\treturn undefined;\n\t}\n}\n\nfunction createSearchDocument(entry: SessionEntry, maxLines: number, maxBytes: number): SearchDocument | undefined {\n\tconst collector = createBoundedLineCollector(maxLines, maxBytes);\n\treturn entry.type === \"message\"\n\t\t? createMessageSearchDocument(entry, collector)\n\t\t: createMetadataSearchDocument(entry, collector);\n}\n\nfunction containsToolCall(entry: SessionEntry, toolCallId: string): boolean {\n\treturn (\n\t\tentry.type === \"message\" &&\n\t\tentry.message.role === \"assistant\" &&\n\t\tentry.message.content.some((block) => block.type === \"toolCall\" && block.id === toolCallId)\n\t);\n}\n\nfunction buildSearchCorpus(entries: SessionEntry[], toolCallId: string, signal?: AbortSignal): SearchCorpus {\n\tconst searchLines: SearchLine[] = [];\n\tlet scannedEntries = 0;\n\tlet scannedBytes = 0;\n\tlet truncated = false;\n\tfor (const entry of entries) {\n\t\tabortIf(signal);\n\t\tif (containsToolCall(entry, toolCallId)) continue;\n\t\tconst document = createSearchDocument(\n\t\t\tentry,\n\t\t\tMAX_SEARCH_LINES - searchLines.length,\n\t\t\tMAX_SEARCH_BYTES - scannedBytes,\n\t\t);\n\t\tif (!document) continue;\n\t\tfor (let lineIndex = 0; lineIndex < document.lines.length; lineIndex++) {\n\t\t\tsearchLines.push({ document, lineIndex });\n\t\t}\n\t\tif (document.lines.length > 0) scannedEntries++;\n\t\tscannedBytes += document.bytes;\n\t\ttruncated ||= document.truncated;\n\t\tif (document.limitReached) break;\n\t}\n\treturn { lines: searchLines, scannedEntries, scannedBytes, truncated };\n}\n\nfunction validateRegex(pattern: string, ignoreCase: boolean): void {\n\ttry {\n\t\tnew RegExp(pattern, ignoreCase ? \"iu\" : \"u\");\n\t} catch (error) {\n\t\tthrow new Error(\n\t\t\t`Invalid session_search regular expression: ${error instanceof Error ? error.message : String(error)}`,\n\t\t);\n\t}\n}\n\nfunction findFixedStringMatchIndexes(lines: string[], pattern: string, ignoreCase: boolean): number[] {\n\tconst expected = ignoreCase ? pattern.toLowerCase() : pattern;\n\tconst indexes: number[] = [];\n\tfor (let index = 0; index < lines.length; index++) {\n\t\tif ((ignoreCase ? lines[index].toLowerCase() : lines[index]).includes(expected)) indexes.push(index);\n\t}\n\treturn indexes;\n}\n\nfunction findRegexMatchIndexes(\n\tlines: string[],\n\tpattern: string,\n\tignoreCase: boolean,\n\tsignal?: AbortSignal,\n): Promise<number[]> {\n\tvalidateRegex(pattern, ignoreCase);\n\tabortIf(signal);\n\treturn new Promise((resolve, reject) => {\n\t\tconst worker = new Worker(REGEX_WORKER_SOURCE, {\n\t\t\teval: true,\n\t\t\tworkerData: { lines, pattern, ignoreCase },\n\t\t});\n\t\tlet settled = false;\n\t\tconst cleanup = () => {\n\t\t\tclearTimeout(timeout);\n\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\n\t\t\tvoid worker.terminate();\n\t\t};\n\t\tconst succeed = (indexes: number[]) => {\n\t\t\tif (settled) return;\n\t\t\tsettled = true;\n\t\t\tcleanup();\n\t\t\tresolve(indexes);\n\t\t};\n\t\tconst fail = (error: Error) => {\n\t\t\tif (settled) return;\n\t\t\tsettled = true;\n\t\t\tcleanup();\n\t\t\treject(error);\n\t\t};\n\t\tconst onAbort = () => fail(new Error(\"Operation aborted\"));\n\t\tconst timeout = setTimeout(\n\t\t\t() => fail(new Error(`session_search regular expression exceeded the ${REGEX_TIMEOUT_MS}ms safety limit`)),\n\t\t\tREGEX_TIMEOUT_MS,\n\t\t);\n\t\ttimeout.unref?.();\n\t\tsignal?.addEventListener(\"abort\", onAbort, { once: true });\n\t\tworker.once(\"message\", (message: unknown) => {\n\t\t\tif (!isRecord(message)) {\n\t\t\t\tfail(new Error(\"session_search regex worker returned an invalid response\"));\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (typeof message.error === \"string\") {\n\t\t\t\tfail(new Error(`Invalid session_search regular expression: ${message.error}`));\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (!Array.isArray(message.indexes) || !message.indexes.every((index) => Number.isSafeInteger(index))) {\n\t\t\t\tfail(new Error(\"session_search regex worker returned invalid match indexes\"));\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tsucceed(message.indexes as number[]);\n\t\t});\n\t\tworker.once(\"error\", fail);\n\t\tworker.once(\"exit\", (code) => {\n\t\t\tif (!settled) fail(new Error(`session_search regex worker exited before returning matches (code ${code})`));\n\t\t});\n\t});\n}\n\nfunction collectMatches(\n\tcorpus: SearchCorpus,\n\tindexes: number[],\n\tbeforeContext: number,\n\tafterContext: number,\n): CollectedMatch[] {\n\treturn indexes.map((index) => {\n\t\tconst searchLine = corpus.lines[index];\n\t\tconst { document, lineIndex } = searchLine;\n\t\tconst entry = document.entry;\n\t\treturn {\n\t\t\tentryId: entry.id,\n\t\t\tentryType: entry.type,\n\t\t\trole: document.role,\n\t\t\ttimestamp: entry.timestamp,\n\t\t\tlineNumber: lineIndex + 1,\n\t\t\tline: document.lines[lineIndex],\n\t\t\tcontextBefore: document.lines\n\t\t\t\t.slice(Math.max(0, lineIndex - beforeContext), lineIndex)\n\t\t\t\t.map((line, contextIndex) => ({\n\t\t\t\t\tlineNumber: Math.max(0, lineIndex - beforeContext) + contextIndex + 1,\n\t\t\t\t\tline,\n\t\t\t\t})),\n\t\t\tcontextAfter: document.lines\n\t\t\t\t.slice(lineIndex + 1, lineIndex + 1 + afterContext)\n\t\t\t\t.map((line, contextIndex) => ({ lineNumber: lineIndex + contextIndex + 2, line })),\n\t\t};\n\t});\n}\n\nfunction entryHeader(match: CollectedMatch): string {\n\tconst role = match.role ? ` role=${match.role}` : \"\";\n\treturn `entry ${match.entryId} type=${match.entryType}${role} timestamp=${match.timestamp}`;\n}\n\nfunction displayLine(line: string): string {\n\treturn truncateLine(line, MAX_DISPLAY_LINE_LENGTH).text;\n}\n\nfunction formatMatches(\n\tmatches: CollectedMatch[],\n\ttotalMatches: number,\n\tmaxResults: number,\n\tscanTruncated: boolean,\n): string {\n\tconst blocks = matches.map((match) => {\n\t\tconst lines = [entryHeader(match)];\n\t\tfor (const context of match.contextBefore) lines.push(`  ${context.lineNumber}-${displayLine(context.line)}`);\n\t\tlines.push(`> ${match.lineNumber}:${displayLine(match.line)}`);\n\t\tfor (const context of match.contextAfter) lines.push(`  ${context.lineNumber}-${displayLine(context.line)}`);\n\t\treturn lines.join(\"\\n\");\n\t});\n\tif (blocks.length === 0) blocks.push(\"No matching session entries found.\");\n\tif (totalMatches > maxResults) {\n\t\tblocks.push(\n\t\t\t`[Showing ${matches.length} of ${totalMatches} matching lines. Refine the pattern or raise maxResults.]`,\n\t\t);\n\t}\n\tif (scanTruncated) {\n\t\tblocks.push(\n\t\t\t`[Session search input was bounded at ${MAX_SEARCH_LINES} lines, ${MAX_SEARCH_BYTES} bytes, and ${MAX_SEARCH_LINE_LENGTH} characters per line. Results may be incomplete.]`,\n\t\t);\n\t}\n\treturn blocks.join(\"\\n\\n\");\n}\n\ninterface TruncatedSessionToolOutput {\n\ttext: string;\n\ttruncated: boolean;\n}\n\nfunction truncateToolOutput(output: string): TruncatedSessionToolOutput {\n\tconst initial = truncateHead(output, { maxBytes: DEFAULT_MAX_BYTES, maxLines: DEFAULT_MAX_LINES });\n\tif (!initial.truncated) return { text: output, truncated: false };\n\tconst notice = \"\\n\\n[Session tool output truncated. Refine the request.]\";\n\tconst reserved = truncateHead(output, {\n\t\tmaxBytes: DEFAULT_MAX_BYTES - Buffer.byteLength(notice, \"utf8\"),\n\t\tmaxLines: DEFAULT_MAX_LINES - 2,\n\t});\n\treturn { text: `${reserved.content}${notice}`, truncated: true };\n}\n\nfunction projectEntryForModel(entry: SessionEntry): unknown | undefined {\n\tif (entry.type === \"custom\") return undefined;\n\tif (entry.type === \"custom_message\") {\n\t\tif (entry.customType === STRUCTURED_RESPONSE_INTERNAL_CUSTOM_TYPE) return undefined;\n\t\tconst { details: _details, ...visible } = entry;\n\t\treturn visible;\n\t}\n\tif (entry.type === \"compaction\" || entry.type === \"branch_summary\") {\n\t\tconst { details: _details, ...visible } = entry;\n\t\treturn visible;\n\t}\n\tif (entry.type !== \"message\") return entry;\n\tconst message = entry.message;\n\tif (message.role === \"bashExecution\") {\n\t\tif (message.excludeFromContext) return undefined;\n\t\tconst { fullOutputPath: _fullOutputPath, ...visibleMessage } = message;\n\t\treturn { ...entry, message: visibleMessage };\n\t}\n\tif (message.role === \"toolResult\") {\n\t\tconst { details: _details, ...visibleMessage } = message;\n\t\treturn { ...entry, message: visibleMessage };\n\t}\n\tif (message.role === \"custom\") {\n\t\tif (message.customType === STRUCTURED_RESPONSE_INTERNAL_CUSTOM_TYPE) return undefined;\n\t\tconst { details: _details, ...visibleMessage } = message;\n\t\treturn { ...entry, message: visibleMessage };\n\t}\n\treturn entry;\n}\n\nfunction getContextSearchEntries(path: SessionEntry[]): SessionEntry[] {\n\tconst compaction = getLatestCompactionEntry(path);\n\treturn projectSessionContextEntries(path).filter(\n\t\t(entry) =>\n\t\t\tentry.type === \"message\" ||\n\t\t\tentry.type === \"custom_message\" ||\n\t\t\tentry.type === \"branch_summary\" ||\n\t\t\t(entry.type === \"compaction\" && entry.id === compaction?.id && entry.summary.length > 0),\n\t);\n}\n\nexport function createSessionSearchToolDefinition(\n\tsession: ReadonlySession,\n): ToolDefinition<typeof sessionSearchSchema, SessionSearchToolDetails> {\n\treturn {\n\t\tname: \"session_search\",\n\t\tlabel: \"session_search\",\n\t\tdescription:\n\t\t\t\"Search finalized entries in the active session using a JavaScript regular expression by default, with grep-like case, fixed-string, context, result-limit, and scope options. Searches entries in the current model context by default; use scope: branch for older current-branch history or scope: all for archived branches. Hidden extension state and context-excluded bash output are not searched. Input and output are bounded.\",\n\t\tpromptSnippet: \"Search finalized entries in the active session history with a regular expression\",\n\t\tpromptGuidelines: [\n\t\t\t\"Default searches cover current model context. Use scope: branch or scope: all to recover history omitted by compaction; use session_entry_get with a returned entry ID when the exact model-visible entry is needed.\",\n\t\t],\n\t\tparameters: sessionSearchSchema,\n\t\texecutionMode: \"sequential\",\n\t\tasync execute(\n\t\t\ttoolCallId,\n\t\t\t{\n\t\t\t\tpattern,\n\t\t\t\tignoreCase = false,\n\t\t\t\tfixedStrings = false,\n\t\t\t\tbeforeContext = 0,\n\t\t\t\tafterContext = 0,\n\t\t\t\tmaxResults = DEFAULT_SEARCH_RESULTS,\n\t\t\t\tscope = \"context\",\n\t\t\t}: SessionSearchToolInput,\n\t\t\tsignal,\n\t\t) {\n\t\t\tabortIf(signal);\n\t\t\tconst entries =\n\t\t\t\tscope === \"all\"\n\t\t\t\t\t? session.getEntries()\n\t\t\t\t\t: scope === \"branch\"\n\t\t\t\t\t\t? session.getBranch()\n\t\t\t\t\t\t: getContextSearchEntries(session.getBranch());\n\t\t\tconst corpus = buildSearchCorpus(entries, toolCallId, signal);\n\t\t\tconst lines = corpus.lines.map(({ document, lineIndex }) => document.lines[lineIndex]);\n\t\t\tconst matchIndexes = fixedStrings\n\t\t\t\t? findFixedStringMatchIndexes(lines, pattern, ignoreCase)\n\t\t\t\t: await findRegexMatchIndexes(lines, pattern, ignoreCase, signal);\n\t\t\tabortIf(signal);\n\t\t\tconst matches = collectMatches(corpus, matchIndexes.slice(0, maxResults), beforeContext, afterContext);\n\t\t\tconst output = truncateToolOutput(formatMatches(matches, matchIndexes.length, maxResults, corpus.truncated));\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: \"text\", text: output.text }],\n\t\t\t\tdetails: {\n\t\t\t\t\tpattern,\n\t\t\t\t\tignoreCase,\n\t\t\t\t\tfixedStrings,\n\t\t\t\t\tscope,\n\t\t\t\t\tmatchCount: matchIndexes.length,\n\t\t\t\t\treturnedMatchCount: matches.length,\n\t\t\t\t\tmatches: matches.map(({ contextBefore: _before, contextAfter: _after, ...match }) => ({\n\t\t\t\t\t\t...match,\n\t\t\t\t\t\tline: displayLine(match.line),\n\t\t\t\t\t})),\n\t\t\t\t\tscannedEntries: corpus.scannedEntries,\n\t\t\t\t\tscannedLines: corpus.lines.length,\n\t\t\t\t\tscannedBytes: corpus.scannedBytes,\n\t\t\t\t\tscanTruncated: corpus.truncated,\n\t\t\t\t\toutputTruncated: output.truncated,\n\t\t\t\t},\n\t\t\t};\n\t\t},\n\t};\n}\n\nexport function createSessionEntryGetToolDefinition(\n\tsession: ReadonlySession,\n): ToolDefinition<typeof sessionEntryGetSchema, SessionEntryGetToolDetails> {\n\treturn {\n\t\tname: \"session_entry_get\",\n\t\tlabel: \"session_entry_get\",\n\t\tdescription:\n\t\t\t\"Fetch one exact model-visible entry by ID from the active session, including entries outside the current branch. Extension-private metadata, hidden custom entries, context-excluded bash output, and base64 image payloads are not exposed. Returns the complete JSON projection unless safety or tool-output limits require truncation.\",\n\t\tpromptSnippet: \"Fetch an exact model-visible entry by ID from the active session\",\n\t\tparameters: sessionEntryGetSchema,\n\t\texecutionMode: \"sequential\",\n\t\tasync execute(_toolCallId, { entryId }: SessionEntryGetToolInput, signal) {\n\t\t\tabortIf(signal);\n\t\t\tconst entry = session.getEntry(entryId);\n\t\t\tif (!entry) throw new Error(`Session entry not found: ${entryId}`);\n\t\t\tconst visibleEntry = projectEntryForModel(entry);\n\t\t\tif (!visibleEntry) throw new Error(`Session entry is private or context-excluded: ${entryId}`);\n\t\t\tconst sanitizedEntry = sanitizeImageData(visibleEntry);\n\t\t\tif (estimateSerializedBytes(sanitizedEntry, MAX_ENTRY_SERIALIZATION_BYTES) > MAX_ENTRY_SERIALIZATION_BYTES) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`Session entry exceeds the ${MAX_ENTRY_SERIALIZATION_BYTES}-byte serialization safety limit: ${entryId}`,\n\t\t\t\t);\n\t\t\t}\n\t\t\tconst onCurrentBranch = session.getBranch().some((candidate) => candidate.id === entryId);\n\t\t\tconst output = truncateToolOutput(`Session entry ${entryId}:\\n${JSON.stringify(sanitizedEntry)}`);\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: \"text\", text: output.text }],\n\t\t\t\tdetails: {\n\t\t\t\t\tentryId,\n\t\t\t\t\tentryType: entry.type,\n\t\t\t\t\tonCurrentBranch,\n\t\t\t\t\toutputTruncated: output.truncated,\n\t\t\t\t},\n\t\t\t};\n\t\t},\n\t};\n}\n\nexport function createSessionSearchTool(session: ReadonlySession): AgentTool<typeof sessionSearchSchema> {\n\treturn wrapToolDefinition(createSessionSearchToolDefinition(session));\n}\n\nexport function createSessionEntryGetTool(session: ReadonlySession): AgentTool<typeof sessionEntryGetSchema> {\n\treturn wrapToolDefinition(createSessionEntryGetToolDefinition(session));\n}\n"]}