@ashx-j/lunr 0.1.0

package/dist/builtin-extensions/pi-subagents/src/shared/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../src/builtin-extensions/pi-subagents/src/shared/utils.ts"],"names":[],"mappings":"AACA;;GAEG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,KAAK,EAAiB,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAoB,YAAY,EAAmB,KAAK,EAAE,MAAM,YAAY,CAAC;AAUtJ,eAAO,MAAM,gCAAgC,8CAA8C,CAAC;AAE5F,wBAAgB,gBAAgB,CAC/B,SAAS,EAAE,MAAM,EACjB,cAAc,GAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAA+B,GACnE,MAAM,CAOR;AAqCD,wBAAgB,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAOnH;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAgB,WAAW,IAAI,MAAM,CAKpC;AAQD,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAGrF;AASD;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CA2C/D;AAiDD;;GAEG;AACF,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAYvE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAavE;AAgBD;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CA2B1D;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,aAAa,GAAG,UAAU,CAAC,GAAG,MAAM,CAEpG;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,SAAS,GAAG,WAAW,EAAE,CAY9E;AAwCD,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,KAAK,CAW9D;AAeD,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CASzF;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAS1E;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAQlE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,SAAS,CAsElE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAqD5E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAyB/D;AAMD,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC","sourcesContent":["// @ts-nocheck\n/**\n * General utility functions for the subagent extension\n */\n\nimport * as fs from \"node:fs\";\nimport * as os from \"node:os\";\nimport * as path from \"node:path\";\nimport type { Message } from \"@earendil-works/pi-ai\";\nimport { formatToolCall } from \"./formatters.ts\";\nimport type { AgentProgress, AsyncStatus, Details, DisplayItem, ErrorInfo, NestedRunSummary, SingleResult, ToolCallSummary, Usage } from \"./types.ts\";\n\n// ============================================================================\n// File System Utilities\n// ============================================================================\n\n// lunr: last-resort default was \".pi\" — lunr's config dir is .lunr. (The package.json\n// probe above normally resolves piConfig.configDir; this only fires when it fails.)\nconst DEFAULT_CONFIG_DIR_NAME = \".lunr\";\nconst PI_CODING_AGENT_PACKAGE_NAME = \"@earendil-works/pi-coding-agent\";\nexport const PI_CODING_AGENT_PACKAGE_ROOT_ENV = \"PI_SUBAGENTS_PI_CODING_AGENT_PACKAGE_ROOT\";\n\nexport function resolveWatchPath(\n\twatchPath: string,\n\tnativeRealpath: (filePath: string) => string = fs.realpathSync.native,\n): string {\n\t// libuv's Windows watcher cannot mix 8.3 registration paths with long event paths.\n\ttry {\n\t\treturn nativeRealpath(watchPath);\n\t} catch {\n\t\treturn watchPath;\n\t}\n}\n\nfunction validConfigDirName(value: unknown): string | undefined {\n\treturn typeof value === \"string\" && value.trim() ? value : undefined;\n}\n\nfunction readConfigDirNameFromPackageRoot(packageRoot: string | undefined): string | undefined {\n\tif (!packageRoot) return undefined;\n\ttry {\n\t\tconst pkg = JSON.parse(fs.readFileSync(path.join(packageRoot, \"package.json\"), \"utf-8\")) as {\n\t\t\tname?: unknown;\n\t\t\tpiConfig?: { configDir?: unknown };\n\t\t};\n\t\tif (pkg.name !== PI_CODING_AGENT_PACKAGE_NAME) return undefined;\n\t\treturn validConfigDirName(pkg.piConfig?.configDir);\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\nfunction resolveConfigDirNameFromPackageJson(entryPoint = process.argv[1], packageRoot = process.env[PI_CODING_AGENT_PACKAGE_ROOT_ENV]): string | undefined {\n\tconst packageRootValue = readConfigDirNameFromPackageRoot(packageRoot);\n\tif (packageRootValue) return packageRootValue;\n\tif (!entryPoint) return undefined;\n\ttry {\n\t\tlet dir = path.dirname(fs.realpathSync(entryPoint));\n\t\twhile (dir !== path.dirname(dir)) {\n\t\t\tconst value = readConfigDirNameFromPackageRoot(dir);\n\t\t\tif (value) return value;\n\t\t\tdir = path.dirname(dir);\n\t\t}\n\t} catch {\n\t\t// Package metadata lookup is best-effort; detached runners must not fail here.\n\t}\n\treturn undefined;\n}\n\nexport function resolveConfigDirName(codingAgentModule?: unknown, entryPoint?: string, packageRoot?: string): string {\n\tconst moduleValue = codingAgentModule && typeof codingAgentModule === \"object\"\n\t\t? validConfigDirName((codingAgentModule as { CONFIG_DIR_NAME?: unknown }).CONFIG_DIR_NAME)\n\t\t: undefined;\n\treturn moduleValue\n\t\t?? resolveConfigDirNameFromPackageJson(entryPoint, packageRoot)\n\t\t?? DEFAULT_CONFIG_DIR_NAME;\n}\n\nexport function getConfigDirName(): string {\n\treturn resolveConfigDirName();\n}\n\nexport function getProjectConfigDir(projectRoot: string): string {\n\treturn path.join(projectRoot, getConfigDirName());\n}\n\nexport function getAgentDir(): string {\n\tconst configured = process.env.PI_CODING_AGENT_DIR;\n\tif (configured === \"~\") return os.homedir();\n\tif (configured?.startsWith(\"~/\")) return path.join(os.homedir(), configured.slice(2));\n\treturn configured || path.join(os.homedir(), getConfigDirName(), \"agent\");\n}\n\nconst statusCache = new Map<string, { mtime: number; status: AsyncStatus }>();\n\nfunction getErrorMessage(error: unknown): string {\n\treturn error instanceof Error ? error.message : String(error);\n}\n\nexport function resolveChildCwd(baseCwd: string, childCwd: string | undefined): string {\n\tif (!childCwd) return baseCwd;\n\treturn path.isAbsolute(childCwd) ? childCwd : path.resolve(baseCwd, childCwd);\n}\n\nfunction isNotFoundError(error: unknown): boolean {\n\treturn typeof error === \"object\"\n\t\t&& error !== null\n\t\t&& \"code\" in error\n\t\t&& (error as NodeJS.ErrnoException).code === \"ENOENT\";\n}\n\n/**\n * Read async job status from disk (with mtime-based caching)\n */\nexport function readStatus(asyncDir: string): AsyncStatus | null {\n\tconst statusPath = path.join(asyncDir, \"status.json\");\n\n\tlet stat: fs.Stats;\n\ttry {\n\t\tstat = fs.statSync(statusPath);\n\t} catch (error) {\n\t\tif (isNotFoundError(error)) return null;\n\t\tthrow new Error(`Failed to inspect async status file '${statusPath}': ${getErrorMessage(error)}`, {\n\t\t\tcause: error instanceof Error ? error : undefined,\n\t\t});\n\t}\n\n\tconst cached = statusCache.get(statusPath);\n\tif (cached && cached.mtime === stat.mtimeMs) {\n\t\treturn cached.status;\n\t}\n\n\tlet content: string;\n\ttry {\n\t\tcontent = fs.readFileSync(statusPath, \"utf-8\");\n\t} catch (error) {\n\t\tif (isNotFoundError(error)) return null;\n\t\tthrow new Error(`Failed to read async status file '${statusPath}': ${getErrorMessage(error)}`, {\n\t\t\tcause: error instanceof Error ? error : undefined,\n\t\t});\n\t}\n\n\tlet status: AsyncStatus;\n\ttry {\n\t\tstatus = JSON.parse(content) as AsyncStatus;\n\t} catch (error) {\n\t\tthrow new Error(`Failed to parse async status file '${statusPath}': ${getErrorMessage(error)}`, {\n\t\t\tcause: error instanceof Error ? error : undefined,\n\t\t});\n\t}\n\n\tstatusCache.set(statusPath, { mtime: stat.mtimeMs, status });\n\tif (statusCache.size > 50) {\n\t\tconst firstKey = statusCache.keys().next().value;\n\t\tif (firstKey) statusCache.delete(firstKey);\n\t}\n\treturn status;\n}\n\nconst outputTailCache = new Map<string, { mtime: number; size: number; lines: string[] }>();\n\n/**\n * Get the last N lines from an output file (with mtime/size-based caching)\n */\nfunction getOutputTail(outputFile: string | undefined, maxLines: number = 3): string[] {\n\tif (!outputFile) return [];\n\tlet fd: number | null = null;\n\ttry {\n\t\tconst stat = fs.statSync(outputFile);\n\t\tif (stat.size === 0) return [];\n\n\t\tconst cached = outputTailCache.get(outputFile);\n\t\tif (cached && cached.mtime === stat.mtimeMs && cached.size === stat.size) {\n\t\t\treturn cached.lines;\n\t\t}\n\n\t\tconst tailBytes = 4096;\n\t\tconst start = Math.max(0, stat.size - tailBytes);\n\t\tfd = fs.openSync(outputFile, \"r\");\n\t\tconst buffer = Buffer.alloc(Math.min(tailBytes, stat.size));\n\t\tfs.readSync(fd, buffer, 0, buffer.length, start);\n\t\tconst content = buffer.toString(\"utf-8\");\n\t\tconst allLines = content.split(\"\\n\").filter((l) => l.trim());\n\t\tconst lines = allLines.slice(-maxLines).map((l) => l.slice(0, 120) + (l.length > 120 ? \"...\" : \"\"));\n\n\t\toutputTailCache.set(outputFile, { mtime: stat.mtimeMs, size: stat.size, lines });\n\t\tif (outputTailCache.size > 20) {\n\t\t\tconst firstKey = outputTailCache.keys().next().value;\n\t\t\tif (firstKey) outputTailCache.delete(firstKey);\n\t\t}\n\n\t\treturn lines;\n\t} catch {\n\t\t// Output tails are UI-only hints; unreadable or missing files should render as no tail.\n\t\treturn [];\n\t} finally {\n\t\tif (fd !== null) {\n\t\t\ttry {\n\t\t\t\tfs.closeSync(fd);\n\t\t\t} catch {\n\t\t\t\t// Closing the best-effort tail file handle should not surface over the main status view.\n\t\t\t}\n\t\t}\n\t}\n}\n\n/**\n * Get human-readable last activity time for a file\n */\n\texport function getLastActivity(outputFile: string | undefined): string {\n\tif (!outputFile) return \"\";\n\ttry {\n\t\tconst stat = fs.statSync(outputFile);\n\t\tconst ago = Date.now() - stat.mtimeMs;\n\t\tif (ago < 1000) return \"active now\";\n\t\tif (ago < 60000) return `active ${Math.floor(ago / 1000)}s ago`;\n\t\treturn `active ${Math.floor(ago / 60000)}m ago`;\n\t} catch {\n\t\t// Last-activity text is best effort; missing files should simply omit the hint.\n\t\treturn \"\";\n\t}\n}\n\n/**\n * Find the latest session file in a directory\n */\nexport function findLatestSessionFile(sessionDir: string): string | null {\n\tif (!fs.existsSync(sessionDir)) return null;\n\tconst files = fs.readdirSync(sessionDir)\n\t\t.filter((f) => f.endsWith(\".jsonl\"))\n\t\t.map((f) => {\n\t\t\tconst filePath = path.join(sessionDir, f);\n\t\t\treturn {\n\t\t\t\tpath: filePath,\n\t\t\t\tmtime: fs.statSync(filePath).mtimeMs,\n\t\t\t};\n\t\t})\n\t\t.sort((a, b) => b.mtime - a.mtime);\n\treturn files.length > 0 ? files[0].path : null;\n}\n\n/**\n * Write a prompt to a temporary file\n */\nfunction writePrompt(agent: string, prompt: string): { dir: string; path: string } {\n\tconst dir = fs.mkdtempSync(path.join(os.tmpdir(), \"pi-subagent-\"));\n\tconst p = path.join(dir, `${agent.replace(/[^\\w.-]/g, \"_\")}.md`);\n\tfs.writeFileSync(p, prompt, { mode: 0o600 });\n\treturn { dir, path: p };\n}\n\n// ============================================================================\n// Message Parsing Utilities\n// ============================================================================\n\n/**\n * Get the final text output from a list of messages\n */\nexport function getFinalOutput(messages: Message[]): string {\n\tconst validTextParts: string[] = [];\n\tfor (let i = messages.length - 1; i >= 0; i--) {\n\t\tconst msg = messages[i];\n\t\tif (msg.role !== \"assistant\") continue;\n\t\tconst hasAssistantError = (\"errorMessage\" in msg && typeof msg.errorMessage === \"string\" && msg.errorMessage.length > 0)\n\t\t\t|| (\"stopReason\" in msg && msg.stopReason === \"error\");\n\t\tif (hasAssistantError) continue;\n\t\tconst messageText = msg.content\n\t\t\t.filter((part) => part.type === \"text\" && part.text.trim().length > 0)\n\t\t\t.map((part) => part.type === \"text\" ? part.text : \"\")\n\t\t\t.join(\"\\n\");\n\t\tfor (let j = msg.content.length - 1; j >= 0; j--) {\n\t\t\tconst part = msg.content[j];\n\t\t\tif (part.type !== \"text\" || part.text.trim().length === 0) continue;\n\t\t\tvalidTextParts.push(part.text);\n\t\t\tif (/```acceptance[-_]report\\s*\\n[\\s\\S]*?```/i.test(part.text)) return messageText;\n\t\t\tfor (const match of part.text.matchAll(/```(?:json|jsonc|json5)\\s*\\n([\\s\\S]*?)```/gi)) {\n\t\t\t\tconst body = match[1] ?? \"\";\n\t\t\t\tif (/\"(?:criteriaSatisfied|criteria_satisfied)\"/.test(body) && /\"(?:changedFiles|changed_files|testsAddedOrUpdated|tests_added_or_updated|commandsRun|commands_run|validationOutput|validation_output|residualRisks|residual_risks|noStagedFiles|no_staged_files|diffSummary|diff_summary|reviewFindings|review_findings|manualNotes|manual_notes)\"/.test(body)) {\n\t\t\t\t\treturn messageText;\n\t\t\t\t}\n\t\t\t}\n\t\t\tif (/ACCEPTANCE_REPORT\\s*:/i.test(part.text)) return messageText;\n\t\t}\n\t}\n\treturn validTextParts[0] ?? \"\";\n}\n\nexport function getSingleResultOutput(result: Pick<SingleResult, \"finalOutput\" | \"messages\">): string {\n\treturn result.finalOutput ?? getFinalOutput(result.messages ?? []);\n}\n\n/**\n * Extract display items (text and tool calls) from messages\n */\nexport function getDisplayItems(messages: Message[] | undefined): DisplayItem[] {\n\tif (!messages || messages.length === 0) return [];\n\tconst items: DisplayItem[] = [];\n\tfor (const msg of messages) {\n\t\tif (msg.role === \"assistant\") {\n\t\t\tfor (const part of msg.content) {\n\t\t\t\tif (part.type === \"text\") items.push({ type: \"text\", text: part.text });\n\t\t\t\telse if (part.type === \"toolCall\") items.push({ type: \"tool\", name: part.name, args: part.arguments });\n\t\t\t}\n\t\t}\n\t}\n\treturn items;\n}\n\nfunction compactCompletedProgress(progress: AgentProgress): AgentProgress {\n\tif (progress.status === \"running\") return progress;\n\treturn {\n\t\tindex: progress.index,\n\t\tagent: progress.agent,\n\t\tstatus: progress.status,\n\t\tactivityState: progress.activityState,\n\t\ttask: progress.task,\n\t\tskills: progress.skills,\n\t\ttoolCount: progress.toolCount,\n\t\ttokens: progress.tokens,\n\t\tdurationMs: progress.durationMs,\n\t\terror: progress.error,\n\t\tfailedTool: progress.failedTool,\n\t\trecentTools: [],\n\t\trecentOutput: [],\n\t};\n}\n\nfunction extractToolCallSummaries(messages: Message[] | undefined): ToolCallSummary[] {\n\tif (!messages?.length) return [];\n\tconst summaries: ToolCallSummary[] = [];\n\tfor (const msg of messages) {\n\t\tif (msg.role !== \"assistant\") continue;\n\t\tfor (const part of msg.content) {\n\t\t\tif (part.type !== \"toolCall\") continue;\n\t\t\tconst args = typeof part.arguments === \"object\" && part.arguments !== null && !Array.isArray(part.arguments)\n\t\t\t\t? part.arguments\n\t\t\t\t: {};\n\t\t\tsummaries.push({\n\t\t\t\ttext: formatToolCall(part.name, args),\n\t\t\t\texpandedText: formatToolCall(part.name, args, true),\n\t\t\t});\n\t\t}\n\t}\n\treturn summaries;\n}\n\nexport function sumResultsUsage(results: SingleResult[]): Usage {\n\tconst usage: Usage = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, cost: 0, turns: 0 };\n\tfor (const result of results) {\n\t\tusage.input += result.usage.input;\n\t\tusage.output += result.usage.output;\n\t\tusage.cacheRead += result.usage.cacheRead;\n\t\tusage.cacheWrite += result.usage.cacheWrite;\n\t\tusage.cost += result.usage.cost;\n\t\tusage.turns += result.usage.turns;\n\t}\n\treturn usage;\n}\n\nfunction addNestedCost(total: NonNullable<Details[\"totalCost\"]>, children: NestedRunSummary[] | undefined): void {\n\tfor (const child of children ?? []) {\n\t\tif (child.totalCost) {\n\t\t\ttotal.inputTokens += child.totalCost.inputTokens;\n\t\t\ttotal.outputTokens += child.totalCost.outputTokens;\n\t\t\ttotal.costUsd += child.totalCost.costUsd;\n\t\t\tcontinue;\n\t\t}\n\t\taddNestedCost(total, child.children);\n\t\tfor (const step of child.steps ?? []) addNestedCost(total, step.children);\n\t}\n}\n\n/** Sum input tokens, output tokens, and cost across a set of SingleResults. */\nexport function sumResultsCost(results: SingleResult[]): NonNullable<Details[\"totalCost\"]> {\n\tconst total = { inputTokens: 0, outputTokens: 0, costUsd: 0 };\n\tfor (const result of results) {\n\t\ttotal.inputTokens += result.usage.input;\n\t\ttotal.outputTokens += result.usage.output;\n\t\ttotal.costUsd += result.usage.cost;\n\t\taddNestedCost(total, result.children);\n\t}\n\treturn total;\n}\n\nexport function compactForegroundResult(result: SingleResult): SingleResult {\n\tif (result.progress?.status === \"running\") return result;\n\tconst toolCalls = result.toolCalls?.length ? result.toolCalls : extractToolCallSummaries(result.messages);\n\treturn {\n\t\t...result,\n\t\tmessages: undefined,\n\t\tprogress: undefined,\n\t\ttoolCalls: toolCalls.length ? toolCalls : undefined,\n\t};\n}\n\nexport function compactForegroundDetails(details: Details): Details {\n\treturn {\n\t\t...details,\n\t\tresults: details.results.map(compactForegroundResult),\n\t\tprogress: details.progress\n\t\t\t? details.progress.map(compactCompletedProgress)\n\t\t\t: undefined,\n\t};\n}\n\n/**\n * Detect errors in subagent execution from messages (only errors with no subsequent success)\n */\nexport function detectSubagentError(messages: Message[]): ErrorInfo {\n\tlet lastAssistantTextIndex = -1;\n\tfor (let i = messages.length - 1; i >= 0; i--) {\n\t\tconst msg = messages[i];\n\t\tif (msg.role === \"assistant\") {\n\t\t\tconst hasText = Array.isArray(msg.content) && msg.content.some(\n\t\t\t\t(c) => c.type === \"text\" && \"text\" in c && typeof c.text === \"string\" && c.text.trim().length > 0,\n\t\t\t);\n\t\t\tif (hasText) {\n\t\t\t\tlastAssistantTextIndex = i;\n\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\t}\n\n\tconst scanStart = lastAssistantTextIndex >= 0 ? lastAssistantTextIndex + 1 : 0;\n\n\tfor (let i = messages.length - 1; i >= scanStart; i--) {\n\t\tconst msg = messages[i];\n\t\tif (msg.role !== \"toolResult\") continue;\n\t\tconst toolName = \"toolName\" in msg && typeof msg.toolName === \"string\" ? msg.toolName : undefined;\n\t\tconst isError = \"isError\" in msg && msg.isError === true;\n\n\t\tif (isError) {\n\t\t\tconst text = msg.content.find((c) => c.type === \"text\");\n\t\t\tconst details = text && \"text\" in text ? text.text : undefined;\n\t\t\tconst exitMatch = details?.match(/exit(?:ed)?\\s*(?:with\\s*)?(?:code|status)?\\s*[:\\s]?\\s*(\\d+)/i);\n\t\t\treturn {\n\t\t\t\thasError: true,\n\t\t\t\texitCode: exitMatch ? parseInt(exitMatch[1], 10) : 1,\n\t\t\t\terrorType: toolName || \"tool\",\n\t\t\t\tdetails: details?.slice(0, 200),\n\t\t\t};\n\t\t}\n\n\t\tif (toolName !== \"bash\") continue;\n\n\t\tconst text = msg.content.find((c) => c.type === \"text\");\n\t\tif (!text || !(\"text\" in text)) continue;\n\t\tconst output = text.text;\n\n\t\tconst exitMatch = output.match(/exit(?:ed)?\\s*(?:with\\s*)?(?:code|status)?\\s*[:\\s]?\\s*(\\d+)/i);\n\t\tif (exitMatch) {\n\t\t\tconst code = parseInt(exitMatch[1], 10);\n\t\t\tif (code !== 0) {\n\t\t\t\treturn { hasError: true, exitCode: code, errorType: \"bash\", details: output.slice(0, 200) };\n\t\t\t}\n\t\t}\n\n\t\t// NOTE: These patterns can match legitimate output (grep results, logs,\n\t\t// testing). With the assistant-message check above, most false positives\n\t\t// are mitigated since the agent will have responded after routine errors.\n\t\tconst fatalPatterns = [\n\t\t\t/command not found/i,\n\t\t\t/permission denied/i,\n\t\t\t/no such file or directory/i,\n\t\t\t/segmentation fault/i,\n\t\t\t/killed|terminated/i,\n\t\t\t/out of memory/i,\n\t\t\t/connection refused/i,\n\t\t\t/timeout/i,\n\t\t];\n\t\tfor (const pattern of fatalPatterns) {\n\t\t\tif (pattern.test(output)) {\n\t\t\t\treturn { hasError: true, exitCode: 1, errorType: \"bash\", details: output.slice(0, 200) };\n\t\t\t}\n\t\t}\n\t}\n\n\treturn { hasError: false };\n}\n\n/**\n * Extract a preview of tool arguments for display\n */\nexport function extractToolArgsPreview(args: Record<string, unknown>): string {\n\tconst truncatePreview = (value: string, maxLength: number): string =>\n\t\tvalue.length > maxLength ? `${value.slice(0, maxLength - 3)}...` : value;\n\n\tconst stringifyPreviewValue = (value: unknown): string | undefined => {\n\t\tif (typeof value === \"string\" && value.trim().length > 0) return value;\n\t\tif (typeof value === \"number\" || typeof value === \"boolean\") return String(value);\n\t\treturn undefined;\n\t};\n\n\tconst previewArray = (value: unknown): string | undefined => {\n\t\tif (!Array.isArray(value) || value.length === 0) return undefined;\n\t\tconst first = stringifyPreviewValue(value[0]);\n\t\tif (!first) return undefined;\n\t\tconst suffix = value.length > 1 ? ` (+${value.length - 1} more)` : \"\";\n\t\treturn `${first}${suffix}`;\n\t};\n\n\t// Handle MCP tool calls - show server/tool info\n\tif (args.tool && typeof args.tool === \"string\") {\n\t\tconst server = args.server && typeof args.server === \"string\" ? `${args.server}/` : \"\";\n\t\tconst toolArgs = args.args && typeof args.args === \"string\" ? ` ${args.args.slice(0, 40)}` : \"\";\n\t\treturn `${server}${args.tool}${toolArgs}`;\n\t}\n\n\tconst queriesPreview = previewArray(args.queries);\n\tif (queriesPreview) return truncatePreview(queriesPreview, 60);\n\tif (typeof args.query === \"string\" && args.query.trim().length > 0) return truncatePreview(args.query, 60);\n\tif (typeof args.workflow === \"string\" && args.workflow.trim().length > 0) return `workflow=${truncatePreview(args.workflow, 48)}`;\n\n\tif (typeof args.url === \"string\" && args.url.trim().length > 0) return truncatePreview(args.url, 60);\n\tconst urlsPreview = previewArray(args.urls);\n\tif (urlsPreview) return truncatePreview(urlsPreview, 60);\n\tif (typeof args.prompt === \"string\" && args.prompt.trim().length > 0) return truncatePreview(args.prompt, 60);\n\t\n\tconst previewKeys = [\"command\", \"path\", \"file_path\", \"pattern\", \"query\", \"url\", \"task\", \"describe\", \"search\"];\n\tfor (const key of previewKeys) {\n\t\tif (args[key] && typeof args[key] === \"string\") {\n\t\t\tconst value = args[key] as string;\n\t\t\treturn truncatePreview(value, 60);\n\t\t}\n\t}\n\t\n\t// Fallback: show first string value found\n\tfor (const [key, value] of Object.entries(args)) {\n\t\tconst arrayPreview = previewArray(value);\n\t\tif (arrayPreview) return `${key}=${truncatePreview(arrayPreview, 50)}`;\n\t\tif (typeof value === \"string\" && value.length > 0) {\n\t\t\tconst preview = truncatePreview(value, 50);\n\t\t\treturn `${key}=${preview}`;\n\t\t}\n\t}\n\treturn \"\";\n}\n\n/**\n * Extract text content from various message content formats\n */\nexport function extractTextFromContent(content: unknown): string {\n\tif (!content) return \"\";\n\t// Handle string content directly\n\tif (typeof content === \"string\") return content;\n\t// Handle array content\n\tif (!Array.isArray(content)) return \"\";\n\tconst texts: string[] = [];\n\tfor (const part of content) {\n\t\tif (part && typeof part === \"object\") {\n\t\t\t// Handle { type: \"text\", text: \"...\" }\n\t\t\tif (\"type\" in part && part.type === \"text\" && \"text\" in part) {\n\t\t\t\ttexts.push(String(part.text));\n\t\t\t}\n\t\t\t// Handle { type: \"tool_result\", content: \"...\" }\n\t\t\telse if (\"type\" in part && part.type === \"tool_result\" && \"content\" in part) {\n\t\t\t\tconst inner = extractTextFromContent(part.content);\n\t\t\t\tif (inner) texts.push(inner);\n\t\t\t}\n\t\t\t// Handle { text: \"...\" } without type\n\t\t\telse if (\"text\" in part) {\n\t\t\t\ttexts.push(String(part.text));\n\t\t\t}\n\t\t}\n\t}\n\treturn texts.join(\"\\n\");\n}\n\n// ============================================================================\n// Concurrency Utilities\n// ============================================================================\n\nexport { mapConcurrent } from \"../runs/shared/parallel-utils.ts\";\n"]}

package/dist/builtin-extensions/pi-subagents/src/shared/utils.js

@@ -0,0 +1,562 @@
+// @ts-nocheck
+/**
+ * General utility functions for the subagent extension
+ */
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { formatToolCall } from "./formatters.js";
+// ============================================================================
+// File System Utilities
+// ============================================================================
+// lunr: last-resort default was ".pi" — lunr's config dir is .lunr. (The package.json
+// probe above normally resolves piConfig.configDir; this only fires when it fails.)
+const DEFAULT_CONFIG_DIR_NAME = ".lunr";
+const PI_CODING_AGENT_PACKAGE_NAME = "@earendil-works/pi-coding-agent";
+export const PI_CODING_AGENT_PACKAGE_ROOT_ENV = "PI_SUBAGENTS_PI_CODING_AGENT_PACKAGE_ROOT";
+export function resolveWatchPath(watchPath, nativeRealpath = fs.realpathSync.native) {
+    // libuv's Windows watcher cannot mix 8.3 registration paths with long event paths.
+    try {
+        return nativeRealpath(watchPath);
+    }
+    catch {
+        return watchPath;
+    }
+}
+function validConfigDirName(value) {
+    return typeof value === "string" && value.trim() ? value : undefined;
+}
+function readConfigDirNameFromPackageRoot(packageRoot) {
+    if (!packageRoot)
+        return undefined;
+    try {
+        const pkg = JSON.parse(fs.readFileSync(path.join(packageRoot, "package.json"), "utf-8"));
+        if (pkg.name !== PI_CODING_AGENT_PACKAGE_NAME)
+            return undefined;
+        return validConfigDirName(pkg.piConfig?.configDir);
+    }
+    catch {
+        return undefined;
+    }
+}
+function resolveConfigDirNameFromPackageJson(entryPoint = process.argv[1], packageRoot = process.env[PI_CODING_AGENT_PACKAGE_ROOT_ENV]) {
+    const packageRootValue = readConfigDirNameFromPackageRoot(packageRoot);
+    if (packageRootValue)
+        return packageRootValue;
+    if (!entryPoint)
+        return undefined;
+    try {
+        let dir = path.dirname(fs.realpathSync(entryPoint));
+        while (dir !== path.dirname(dir)) {
+            const value = readConfigDirNameFromPackageRoot(dir);
+            if (value)
+                return value;
+            dir = path.dirname(dir);
+        }
+    }
+    catch {
+        // Package metadata lookup is best-effort; detached runners must not fail here.
+    }
+    return undefined;
+}
+export function resolveConfigDirName(codingAgentModule, entryPoint, packageRoot) {
+    const moduleValue = codingAgentModule && typeof codingAgentModule === "object"
+        ? validConfigDirName(codingAgentModule.CONFIG_DIR_NAME)
+        : undefined;
+    return moduleValue
+        ?? resolveConfigDirNameFromPackageJson(entryPoint, packageRoot)
+        ?? DEFAULT_CONFIG_DIR_NAME;
+}
+export function getConfigDirName() {
+    return resolveConfigDirName();
+}
+export function getProjectConfigDir(projectRoot) {
+    return path.join(projectRoot, getConfigDirName());
+}
+export function getAgentDir() {
+    const configured = process.env.PI_CODING_AGENT_DIR;
+    if (configured === "~")
+        return os.homedir();
+    if (configured?.startsWith("~/"))
+        return path.join(os.homedir(), configured.slice(2));
+    return configured || path.join(os.homedir(), getConfigDirName(), "agent");
+}
+const statusCache = new Map();
+function getErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+export function resolveChildCwd(baseCwd, childCwd) {
+    if (!childCwd)
+        return baseCwd;
+    return path.isAbsolute(childCwd) ? childCwd : path.resolve(baseCwd, childCwd);
+}
+function isNotFoundError(error) {
+    return typeof error === "object"
+        && error !== null
+        && "code" in error
+        && error.code === "ENOENT";
+}
+/**
+ * Read async job status from disk (with mtime-based caching)
+ */
+export function readStatus(asyncDir) {
+    const statusPath = path.join(asyncDir, "status.json");
+    let stat;
+    try {
+        stat = fs.statSync(statusPath);
+    }
+    catch (error) {
+        if (isNotFoundError(error))
+            return null;
+        throw new Error(`Failed to inspect async status file '${statusPath}': ${getErrorMessage(error)}`, {
+            cause: error instanceof Error ? error : undefined,
+        });
+    }
+    const cached = statusCache.get(statusPath);
+    if (cached && cached.mtime === stat.mtimeMs) {
+        return cached.status;
+    }
+    let content;
+    try {
+        content = fs.readFileSync(statusPath, "utf-8");
+    }
+    catch (error) {
+        if (isNotFoundError(error))
+            return null;
+        throw new Error(`Failed to read async status file '${statusPath}': ${getErrorMessage(error)}`, {
+            cause: error instanceof Error ? error : undefined,
+        });
+    }
+    let status;
+    try {
+        status = JSON.parse(content);
+    }
+    catch (error) {
+        throw new Error(`Failed to parse async status file '${statusPath}': ${getErrorMessage(error)}`, {
+            cause: error instanceof Error ? error : undefined,
+        });
+    }
+    statusCache.set(statusPath, { mtime: stat.mtimeMs, status });
+    if (statusCache.size > 50) {
+        const firstKey = statusCache.keys().next().value;
+        if (firstKey)
+            statusCache.delete(firstKey);
+    }
+    return status;
+}
+const outputTailCache = new Map();
+/**
+ * Get the last N lines from an output file (with mtime/size-based caching)
+ */
+function getOutputTail(outputFile, maxLines = 3) {
+    if (!outputFile)
+        return [];
+    let fd = null;
+    try {
+        const stat = fs.statSync(outputFile);
+        if (stat.size === 0)
+            return [];
+        const cached = outputTailCache.get(outputFile);
+        if (cached && cached.mtime === stat.mtimeMs && cached.size === stat.size) {
+            return cached.lines;
+        }
+        const tailBytes = 4096;
+        const start = Math.max(0, stat.size - tailBytes);
+        fd = fs.openSync(outputFile, "r");
+        const buffer = Buffer.alloc(Math.min(tailBytes, stat.size));
+        fs.readSync(fd, buffer, 0, buffer.length, start);
+        const content = buffer.toString("utf-8");
+        const allLines = content.split("\n").filter((l) => l.trim());
+        const lines = allLines.slice(-maxLines).map((l) => l.slice(0, 120) + (l.length > 120 ? "..." : ""));
+        outputTailCache.set(outputFile, { mtime: stat.mtimeMs, size: stat.size, lines });
+        if (outputTailCache.size > 20) {
+            const firstKey = outputTailCache.keys().next().value;
+            if (firstKey)
+                outputTailCache.delete(firstKey);
+        }
+        return lines;
+    }
+    catch {
+        // Output tails are UI-only hints; unreadable or missing files should render as no tail.
+        return [];
+    }
+    finally {
+        if (fd !== null) {
+            try {
+                fs.closeSync(fd);
+            }
+            catch {
+                // Closing the best-effort tail file handle should not surface over the main status view.
+            }
+        }
+    }
+}
+/**
+ * Get human-readable last activity time for a file
+ */
+export function getLastActivity(outputFile) {
+    if (!outputFile)
+        return "";
+    try {
+        const stat = fs.statSync(outputFile);
+        const ago = Date.now() - stat.mtimeMs;
+        if (ago < 1000)
+            return "active now";
+        if (ago < 60000)
+            return `active ${Math.floor(ago / 1000)}s ago`;
+        return `active ${Math.floor(ago / 60000)}m ago`;
+    }
+    catch {
+        // Last-activity text is best effort; missing files should simply omit the hint.
+        return "";
+    }
+}
+/**
+ * Find the latest session file in a directory
+ */
+export function findLatestSessionFile(sessionDir) {
+    if (!fs.existsSync(sessionDir))
+        return null;
+    const files = fs.readdirSync(sessionDir)
+        .filter((f) => f.endsWith(".jsonl"))
+        .map((f) => {
+        const filePath = path.join(sessionDir, f);
+        return {
+            path: filePath,
+            mtime: fs.statSync(filePath).mtimeMs,
+        };
+    })
+        .sort((a, b) => b.mtime - a.mtime);
+    return files.length > 0 ? files[0].path : null;
+}
+/**
+ * Write a prompt to a temporary file
+ */
+function writePrompt(agent, prompt) {
+    const dir = fs.mkdtempSync(path.join(os.tmpdir(), "pi-subagent-"));
+    const p = path.join(dir, `${agent.replace(/[^\w.-]/g, "_")}.md`);
+    fs.writeFileSync(p, prompt, { mode: 0o600 });
+    return { dir, path: p };
+}
+// ============================================================================
+// Message Parsing Utilities
+// ============================================================================
+/**
+ * Get the final text output from a list of messages
+ */
+export function getFinalOutput(messages) {
+    const validTextParts = [];
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const msg = messages[i];
+        if (msg.role !== "assistant")
+            continue;
+        const hasAssistantError = ("errorMessage" in msg && typeof msg.errorMessage === "string" && msg.errorMessage.length > 0)
+            || ("stopReason" in msg && msg.stopReason === "error");
+        if (hasAssistantError)
+            continue;
+        const messageText = msg.content
+            .filter((part) => part.type === "text" && part.text.trim().length > 0)
+            .map((part) => part.type === "text" ? part.text : "")
+            .join("\n");
+        for (let j = msg.content.length - 1; j >= 0; j--) {
+            const part = msg.content[j];
+            if (part.type !== "text" || part.text.trim().length === 0)
+                continue;
+            validTextParts.push(part.text);
+            if (/```acceptance[-_]report\s*\n[\s\S]*?```/i.test(part.text))
+                return messageText;
+            for (const match of part.text.matchAll(/```(?:json|jsonc|json5)\s*\n([\s\S]*?)```/gi)) {
+                const body = match[1] ?? "";
+                if (/"(?:criteriaSatisfied|criteria_satisfied)"/.test(body) && /"(?:changedFiles|changed_files|testsAddedOrUpdated|tests_added_or_updated|commandsRun|commands_run|validationOutput|validation_output|residualRisks|residual_risks|noStagedFiles|no_staged_files|diffSummary|diff_summary|reviewFindings|review_findings|manualNotes|manual_notes)"/.test(body)) {
+                    return messageText;
+                }
+            }
+            if (/ACCEPTANCE_REPORT\s*:/i.test(part.text))
+                return messageText;
+        }
+    }
+    return validTextParts[0] ?? "";
+}
+export function getSingleResultOutput(result) {
+    return result.finalOutput ?? getFinalOutput(result.messages ?? []);
+}
+/**
+ * Extract display items (text and tool calls) from messages
+ */
+export function getDisplayItems(messages) {
+    if (!messages || messages.length === 0)
+        return [];
+    const items = [];
+    for (const msg of messages) {
+        if (msg.role === "assistant") {
+            for (const part of msg.content) {
+                if (part.type === "text")
+                    items.push({ type: "text", text: part.text });
+                else if (part.type === "toolCall")
+                    items.push({ type: "tool", name: part.name, args: part.arguments });
+            }
+        }
+    }
+    return items;
+}
+function compactCompletedProgress(progress) {
+    if (progress.status === "running")
+        return progress;
+    return {
+        index: progress.index,
+        agent: progress.agent,
+        status: progress.status,
+        activityState: progress.activityState,
+        task: progress.task,
+        skills: progress.skills,
+        toolCount: progress.toolCount,
+        tokens: progress.tokens,
+        durationMs: progress.durationMs,
+        error: progress.error,
+        failedTool: progress.failedTool,
+        recentTools: [],
+        recentOutput: [],
+    };
+}
+function extractToolCallSummaries(messages) {
+    if (!messages?.length)
+        return [];
+    const summaries = [];
+    for (const msg of messages) {
+        if (msg.role !== "assistant")
+            continue;
+        for (const part of msg.content) {
+            if (part.type !== "toolCall")
+                continue;
+            const args = typeof part.arguments === "object" && part.arguments !== null && !Array.isArray(part.arguments)
+                ? part.arguments
+                : {};
+            summaries.push({
+                text: formatToolCall(part.name, args),
+                expandedText: formatToolCall(part.name, args, true),
+            });
+        }
+    }
+    return summaries;
+}
+export function sumResultsUsage(results) {
+    const usage = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, cost: 0, turns: 0 };
+    for (const result of results) {
+        usage.input += result.usage.input;
+        usage.output += result.usage.output;
+        usage.cacheRead += result.usage.cacheRead;
+        usage.cacheWrite += result.usage.cacheWrite;
+        usage.cost += result.usage.cost;
+        usage.turns += result.usage.turns;
+    }
+    return usage;
+}
+function addNestedCost(total, children) {
+    for (const child of children ?? []) {
+        if (child.totalCost) {
+            total.inputTokens += child.totalCost.inputTokens;
+            total.outputTokens += child.totalCost.outputTokens;
+            total.costUsd += child.totalCost.costUsd;
+            continue;
+        }
+        addNestedCost(total, child.children);
+        for (const step of child.steps ?? [])
+            addNestedCost(total, step.children);
+    }
+}
+/** Sum input tokens, output tokens, and cost across a set of SingleResults. */
+export function sumResultsCost(results) {
+    const total = { inputTokens: 0, outputTokens: 0, costUsd: 0 };
+    for (const result of results) {
+        total.inputTokens += result.usage.input;
+        total.outputTokens += result.usage.output;
+        total.costUsd += result.usage.cost;
+        addNestedCost(total, result.children);
+    }
+    return total;
+}
+export function compactForegroundResult(result) {
+    if (result.progress?.status === "running")
+        return result;
+    const toolCalls = result.toolCalls?.length ? result.toolCalls : extractToolCallSummaries(result.messages);
+    return {
+        ...result,
+        messages: undefined,
+        progress: undefined,
+        toolCalls: toolCalls.length ? toolCalls : undefined,
+    };
+}
+export function compactForegroundDetails(details) {
+    return {
+        ...details,
+        results: details.results.map(compactForegroundResult),
+        progress: details.progress
+            ? details.progress.map(compactCompletedProgress)
+            : undefined,
+    };
+}
+/**
+ * Detect errors in subagent execution from messages (only errors with no subsequent success)
+ */
+export function detectSubagentError(messages) {
+    let lastAssistantTextIndex = -1;
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const msg = messages[i];
+        if (msg.role === "assistant") {
+            const hasText = Array.isArray(msg.content) && msg.content.some((c) => c.type === "text" && "text" in c && typeof c.text === "string" && c.text.trim().length > 0);
+            if (hasText) {
+                lastAssistantTextIndex = i;
+                break;
+            }
+        }
+    }
+    const scanStart = lastAssistantTextIndex >= 0 ? lastAssistantTextIndex + 1 : 0;
+    for (let i = messages.length - 1; i >= scanStart; i--) {
+        const msg = messages[i];
+        if (msg.role !== "toolResult")
+            continue;
+        const toolName = "toolName" in msg && typeof msg.toolName === "string" ? msg.toolName : undefined;
+        const isError = "isError" in msg && msg.isError === true;
+        if (isError) {
+            const text = msg.content.find((c) => c.type === "text");
+            const details = text && "text" in text ? text.text : undefined;
+            const exitMatch = details?.match(/exit(?:ed)?\s*(?:with\s*)?(?:code|status)?\s*[:\s]?\s*(\d+)/i);
+            return {
+                hasError: true,
+                exitCode: exitMatch ? parseInt(exitMatch[1], 10) : 1,
+                errorType: toolName || "tool",
+                details: details?.slice(0, 200),
+            };
+        }
+        if (toolName !== "bash")
+            continue;
+        const text = msg.content.find((c) => c.type === "text");
+        if (!text || !("text" in text))
+            continue;
+        const output = text.text;
+        const exitMatch = output.match(/exit(?:ed)?\s*(?:with\s*)?(?:code|status)?\s*[:\s]?\s*(\d+)/i);
+        if (exitMatch) {
+            const code = parseInt(exitMatch[1], 10);
+            if (code !== 0) {
+                return { hasError: true, exitCode: code, errorType: "bash", details: output.slice(0, 200) };
+            }
+        }
+        // NOTE: These patterns can match legitimate output (grep results, logs,
+        // testing). With the assistant-message check above, most false positives
+        // are mitigated since the agent will have responded after routine errors.
+        const fatalPatterns = [
+            /command not found/i,
+            /permission denied/i,
+            /no such file or directory/i,
+            /segmentation fault/i,
+            /killed|terminated/i,
+            /out of memory/i,
+            /connection refused/i,
+            /timeout/i,
+        ];
+        for (const pattern of fatalPatterns) {
+            if (pattern.test(output)) {
+                return { hasError: true, exitCode: 1, errorType: "bash", details: output.slice(0, 200) };
+            }
+        }
+    }
+    return { hasError: false };
+}
+/**
+ * Extract a preview of tool arguments for display
+ */
+export function extractToolArgsPreview(args) {
+    const truncatePreview = (value, maxLength) => value.length > maxLength ? `${value.slice(0, maxLength - 3)}...` : value;
+    const stringifyPreviewValue = (value) => {
+        if (typeof value === "string" && value.trim().length > 0)
+            return value;
+        if (typeof value === "number" || typeof value === "boolean")
+            return String(value);
+        return undefined;
+    };
+    const previewArray = (value) => {
+        if (!Array.isArray(value) || value.length === 0)
+            return undefined;
+        const first = stringifyPreviewValue(value[0]);
+        if (!first)
+            return undefined;
+        const suffix = value.length > 1 ? ` (+${value.length - 1} more)` : "";
+        return `${first}${suffix}`;
+    };
+    // Handle MCP tool calls - show server/tool info
+    if (args.tool && typeof args.tool === "string") {
+        const server = args.server && typeof args.server === "string" ? `${args.server}/` : "";
+        const toolArgs = args.args && typeof args.args === "string" ? ` ${args.args.slice(0, 40)}` : "";
+        return `${server}${args.tool}${toolArgs}`;
+    }
+    const queriesPreview = previewArray(args.queries);
+    if (queriesPreview)
+        return truncatePreview(queriesPreview, 60);
+    if (typeof args.query === "string" && args.query.trim().length > 0)
+        return truncatePreview(args.query, 60);
+    if (typeof args.workflow === "string" && args.workflow.trim().length > 0)
+        return `workflow=${truncatePreview(args.workflow, 48)}`;
+    if (typeof args.url === "string" && args.url.trim().length > 0)
+        return truncatePreview(args.url, 60);
+    const urlsPreview = previewArray(args.urls);
+    if (urlsPreview)
+        return truncatePreview(urlsPreview, 60);
+    if (typeof args.prompt === "string" && args.prompt.trim().length > 0)
+        return truncatePreview(args.prompt, 60);
+    const previewKeys = ["command", "path", "file_path", "pattern", "query", "url", "task", "describe", "search"];
+    for (const key of previewKeys) {
+        if (args[key] && typeof args[key] === "string") {
+            const value = args[key];
+            return truncatePreview(value, 60);
+        }
+    }
+    // Fallback: show first string value found
+    for (const [key, value] of Object.entries(args)) {
+        const arrayPreview = previewArray(value);
+        if (arrayPreview)
+            return `${key}=${truncatePreview(arrayPreview, 50)}`;
+        if (typeof value === "string" && value.length > 0) {
+            const preview = truncatePreview(value, 50);
+            return `${key}=${preview}`;
+        }
+    }
+    return "";
+}
+/**
+ * Extract text content from various message content formats
+ */
+export function extractTextFromContent(content) {
+    if (!content)
+        return "";
+    // Handle string content directly
+    if (typeof content === "string")
+        return content;
+    // Handle array content
+    if (!Array.isArray(content))
+        return "";
+    const texts = [];
+    for (const part of content) {
+        if (part && typeof part === "object") {
+            // Handle { type: "text", text: "..." }
+            if ("type" in part && part.type === "text" && "text" in part) {
+                texts.push(String(part.text));
+            }
+            // Handle { type: "tool_result", content: "..." }
+            else if ("type" in part && part.type === "tool_result" && "content" in part) {
+                const inner = extractTextFromContent(part.content);
+                if (inner)
+                    texts.push(inner);
+            }
+            // Handle { text: "..." } without type
+            else if ("text" in part) {
+                texts.push(String(part.text));
+            }
+        }
+    }
+    return texts.join("\n");
+}
+// ============================================================================
+// Concurrency Utilities
+// ============================================================================
+export { mapConcurrent } from "../runs/shared/parallel-utils.js";
+//# sourceMappingURL=utils.js.map