@ashx-j/lunr 0.1.0

package/dist/builtin-extensions/pi-subagents/src/runs/background/fleet-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-view.d.ts","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/background/fleet-view.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAGrE,OAAO,EAKN,KAAK,WAAW,EAChB,KAAK,OAAO,EACZ,KAAK,gBAAgB,EAErB,KAAK,aAAa,EAClB,MAAM,uBAAuB,CAAC;AAY/B,UAAU,eAAe;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,UAAU,aAAa;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,OAAO,GAAG,CAAC,KAAK,OAAO,CAAC;IAC7D,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,UAAU,iBAAiB;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAyQD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,GAAE,aAAkB,GAAG,eAAe,CAAC,OAAO,CAAC,CAiDjH;AA4DD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,MAAM,CAmDvH;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,gBAAgB,EAAE,OAAO,GAAE,iBAAsB,GAAG,MAAM,CAwBxG;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IACjD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;CAC1J,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,MAAM,CA2B9D","sourcesContent":["// @ts-nocheck\nimport * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport type { AgentToolResult } from \"@earendil-works/pi-agent-core\";\nimport { formatDuration, formatModelThinking, formatTokens, shortenPath } from \"../../shared/formatters.ts\";\nimport { formatActivityLabel } from \"../../shared/status-format.ts\";\nimport {\n\tASYNC_DIR,\n\tRESULTS_DIR,\n\ttype ActivityState,\n\ttype AsyncJobStep,\n\ttype AsyncStatus,\n\ttype Details,\n\ttype NestedRunSummary,\n\ttype SubagentRunMode,\n\ttype SubagentState,\n} from \"../../shared/types.ts\";\nimport { readStatus } from \"../../shared/utils.ts\";\nimport { formatNestedRunStatusLines } from \"../shared/nested-render.ts\";\nimport { formatAsyncRunOutputPath, formatAsyncRunProgressLabel, listAsyncRuns, type AsyncRunSummary } from \"./async-status.ts\";\n\nconst DEFAULT_TRANSCRIPT_LINES = 80;\nconst MAX_TRANSCRIPT_LINES = 500;\nconst TRANSCRIPT_TAIL_BYTES = 256 * 1024;\n\ntype ForegroundControl = SubagentState[\"foregroundControls\"] extends Map<string, infer T> ? T : never;\ntype ForegroundRun = NonNullable<SubagentState[\"foregroundRuns\"]> extends Map<string, infer T> ? T : never;\n\ninterface FleetViewParams {\n\tlines?: number;\n}\n\ninterface FleetViewDeps {\n\tasyncDirRoot?: string;\n\tresultsDir?: string;\n\tkill?: (pid: number, signal?: NodeJS.Signals | 0) => boolean;\n\tnow?: () => number;\n\tstate?: SubagentState;\n\tchildSafe?: boolean;\n}\n\ninterface TranscriptOptions {\n\tindex?: number;\n\tlines?: number;\n\tsessionRoots?: string[];\n}\n\ninterface TextTailResult {\n\tpath: string;\n\tlines: string[];\n\ttruncated: boolean;\n\terror?: string;\n}\n\nfunction transcriptLineLimit(value: number | undefined): number {\n\tif (value === undefined) return DEFAULT_TRANSCRIPT_LINES;\n\tif (!Number.isFinite(value)) return DEFAULT_TRANSCRIPT_LINES;\n\treturn Math.max(1, Math.min(MAX_TRANSCRIPT_LINES, Math.trunc(value)));\n}\n\nfunction uniqueStrings(values: Array<string | undefined>): string[] {\n\tconst seen = new Set<string>();\n\tconst result: string[] = [];\n\tfor (const value of values) {\n\t\tif (!value || seen.has(value)) continue;\n\t\tseen.add(value);\n\t\tresult.push(value);\n\t}\n\treturn result;\n}\n\nfunction resolveMaybeRelative(asyncDir: string, filePath: string | undefined): string | undefined {\n\tif (!filePath) return undefined;\n\treturn path.resolve(asyncDir, filePath);\n}\n\nfunction pathWithin(base: string, candidate: string): boolean {\n\tconst resolvedBase = path.resolve(base);\n\tconst resolvedCandidate = path.resolve(candidate);\n\treturn resolvedCandidate === resolvedBase || resolvedCandidate.startsWith(`${resolvedBase}${path.sep}`);\n}\n\nfunction getErrorMessage(error: unknown): string {\n\treturn error instanceof Error ? error.message : String(error);\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\nfunction readTextTail(filePath: string, maxLines: number): TextTailResult {\n\tlet stat: fs.Stats;\n\ttry {\n\t\tstat = fs.statSync(filePath);\n\t} catch (error) {\n\t\tif (isNotFoundError(error)) return { path: filePath, lines: [], truncated: false };\n\t\treturn { path: filePath, lines: [], truncated: false, error: getErrorMessage(error) };\n\t}\n\tif (stat.size === 0) return { path: filePath, lines: [], truncated: false };\n\n\tlet fd: number | undefined;\n\ttry {\n\t\tconst bytesToRead = Math.min(stat.size, TRANSCRIPT_TAIL_BYTES);\n\t\tconst start = stat.size - bytesToRead;\n\t\tconst buffer = Buffer.alloc(bytesToRead);\n\t\tfd = fs.openSync(filePath, \"r\");\n\t\tconst bytesRead = fs.readSync(fd, buffer, 0, bytesToRead, start);\n\t\tconst content = buffer.subarray(0, bytesRead).toString(\"utf-8\");\n\t\tlet lines = content.split(/\\r?\\n/);\n\t\tif (start > 0 && lines.length > 0) lines = lines.slice(1);\n\t\tif (lines.at(-1) === \"\") lines = lines.slice(0, -1);\n\t\treturn { path: filePath, lines: lines.slice(-maxLines), truncated: start > 0 || lines.length > maxLines };\n\t} catch (error) {\n\t\treturn { path: filePath, lines: [], truncated: false, error: getErrorMessage(error) };\n\t} finally {\n\t\tif (fd !== undefined) fs.closeSync(fd);\n\t}\n}\n\nfunction readContainedTextTail(filePath: string, maxLines: number, trustedRoots: string[], label: string): TextTailResult {\n\tif (trustedRoots.length === 0) return { path: filePath, lines: [], truncated: false, error: `Refusing to read ${label} transcript path without a trusted root: ${filePath}` };\n\tconst resolvedPath = path.resolve(filePath);\n\tif (!trustedRoots.some((root) => pathWithin(root, resolvedPath))) {\n\t\treturn { path: filePath, lines: [], truncated: false, error: `Refusing to read ${label} transcript path outside trusted roots: ${filePath}` };\n\t}\n\tlet lstat: fs.Stats;\n\ttry {\n\t\tlstat = fs.lstatSync(resolvedPath);\n\t} catch (error) {\n\t\tif (isNotFoundError(error)) return { path: filePath, lines: [], truncated: false };\n\t\treturn { path: filePath, lines: [], truncated: false, error: getErrorMessage(error) };\n\t}\n\tif (lstat.isSymbolicLink()) return { path: filePath, lines: [], truncated: false, error: `Refusing to read symlink ${label} transcript path: ${filePath}` };\n\tif (!lstat.isFile()) return { path: filePath, lines: [], truncated: false, error: `Refusing to read non-file ${label} transcript path: ${filePath}` };\n\tlet realPath: string;\n\tlet realRoots: string[];\n\ttry {\n\t\trealPath = fs.realpathSync(resolvedPath);\n\t\trealRoots = trustedRoots.filter((root) => fs.existsSync(root)).map((root) => fs.realpathSync(root));\n\t} catch (error) {\n\t\treturn { path: filePath, lines: [], truncated: false, error: getErrorMessage(error) };\n\t}\n\tif (!realRoots.some((root) => pathWithin(root, realPath))) {\n\t\treturn { path: filePath, lines: [], truncated: false, error: `Refusing to read ${label} transcript path outside trusted roots: ${filePath}` };\n\t}\n\treturn readTextTail(resolvedPath, maxLines);\n}\n\nfunction stringifyJsonPreview(value: unknown, maxLength = 240): string {\n\tlet raw: string;\n\tif (typeof value === \"string\") raw = value;\n\telse raw = JSON.stringify(value);\n\treturn raw.length > maxLength ? `${raw.slice(0, maxLength)}…` : raw;\n}\n\nfunction contentText(content: unknown): string {\n\tif (typeof content === \"string\") return content;\n\tif (!Array.isArray(content)) return \"\";\n\treturn content.map((part) => {\n\t\tif (!part || typeof part !== \"object\") return \"\";\n\t\tconst entry = part as { type?: unknown; text?: unknown; name?: unknown; toolName?: unknown; args?: unknown; result?: unknown; content?: unknown };\n\t\tif (typeof entry.text === \"string\") return entry.text;\n\t\tif (entry.type === \"toolCall\" || entry.type === \"tool_call\") {\n\t\t\tconst name = typeof entry.name === \"string\" ? entry.name : typeof entry.toolName === \"string\" ? entry.toolName : \"tool\";\n\t\t\treturn `[tool: ${name}${entry.args === undefined ? \"\" : ` ${stringifyJsonPreview(entry.args)}`}]`;\n\t\t}\n\t\tif (entry.type === \"toolResult\" || entry.type === \"tool_result\") {\n\t\t\treturn `[tool result${entry.result === undefined ? \"\" : `: ${stringifyJsonPreview(entry.result)}`}]`;\n\t\t}\n\t\tif (entry.content !== undefined) return stringifyJsonPreview(entry.content);\n\t\treturn \"\";\n\t}).filter(Boolean).join(\"\\n\");\n}\n\nfunction sessionMessageLine(record: unknown): string | undefined {\n\tif (!record || typeof record !== \"object\") return undefined;\n\tconst outer = record as { message?: unknown; role?: unknown; content?: unknown; type?: unknown };\n\tconst message = outer.message && typeof outer.message === \"object\" ? outer.message as { role?: unknown; content?: unknown } : outer;\n\tconst role = typeof message.role === \"string\" ? message.role : undefined;\n\tif (!role) return undefined;\n\tconst text = contentText(message.content).trim();\n\tif (!text) return undefined;\n\treturn `${role}: ${text}`;\n}\n\nfunction readSessionTranscriptTail(sessionFile: string, maxLines: number, trustedRoots: string[]): { lines: string[]; warnings: string[] } {\n\tconst tail = readContainedTextTail(sessionFile, Math.max(maxLines * 4, maxLines), trustedRoots, \"session\");\n\tconst warnings: string[] = [];\n\tif (tail.error) warnings.push(`Session read failed for ${sessionFile}: ${tail.error}`);\n\tconst lines: string[] = [];\n\tlet malformed = 0;\n\tfor (const line of tail.lines) {\n\t\tif (!line.trim()) continue;\n\t\ttry {\n\t\t\tconst parsed = JSON.parse(line) as unknown;\n\t\t\tconst messageLine = sessionMessageLine(parsed);\n\t\t\tif (messageLine) lines.push(messageLine);\n\t\t} catch {\n\t\t\tmalformed++;\n\t\t}\n\t}\n\tif (malformed > 0) warnings.push(`Skipped ${malformed} malformed session tail line${malformed === 1 ? \"\" : \"s\"}.`);\n\treturn { lines: lines.slice(-maxLines), warnings };\n}\n\nfunction formatActivityFacts(input: {\n\tactivityState?: ActivityState;\n\tlastActivityAt?: number;\n\tcurrentTool?: string;\n\tcurrentToolStartedAt?: number;\n\tcurrentPath?: string;\n\tturnCount?: number;\n\ttoolCount?: number;\n\ttokens?: { total: number };\n}): string | undefined {\n\tconst facts: string[] = [];\n\tif (input.currentTool && input.currentToolStartedAt !== undefined) facts.push(`tool ${input.currentTool} ${formatDuration(Math.max(0, Date.now() - input.currentToolStartedAt))}`);\n\telse if (input.currentTool) facts.push(`tool ${input.currentTool}`);\n\tif (input.currentPath) facts.push(shortenPath(input.currentPath));\n\tif (input.turnCount !== undefined) facts.push(`${input.turnCount} turns`);\n\tif (input.toolCount !== undefined) facts.push(`${input.toolCount} tools`);\n\tif (input.tokens?.total) facts.push(`${formatTokens(input.tokens.total)} tok`);\n\tconst activity = formatActivityLabel(input.lastActivityAt, input.activityState);\n\treturn activity || facts.length ? [activity, ...facts].filter(Boolean).join(\" | \") : undefined;\n}\n\nfunction foregroundModeName(control: ForegroundControl): string {\n\tif (control.mode === \"single\" && control.currentAgent) return control.currentAgent;\n\treturn control.mode;\n}\n\nfunction formatForegroundFleetLines(controls: ForegroundControl[]): string[] {\n\tif (controls.length === 0) return [];\n\tconst lines = [\"Foreground runs:\"];\n\tconst ordered = [...controls].sort((left, right) => right.updatedAt - left.updatedAt);\n\tfor (const control of ordered) {\n\t\tconst activity = formatActivityFacts({\n\t\t\tactivityState: control.currentActivityState,\n\t\t\tlastActivityAt: control.lastActivityAt,\n\t\t\tcurrentTool: control.currentTool,\n\t\t\tcurrentToolStartedAt: control.currentToolStartedAt,\n\t\t\tcurrentPath: control.currentPath,\n\t\t\tturnCount: control.turnCount,\n\t\t\ttoolCount: control.toolCount,\n\t\t\t...(control.tokens !== undefined ? { tokens: { total: control.tokens } } : {}),\n\t\t});\n\t\tconst current = control.currentAgent ? ` | ${control.currentAgent}${control.currentIndex !== undefined ? ` #${control.currentIndex}` : \"\"}` : \"\";\n\t\tlines.push(`- ${control.runId} | running | ${foregroundModeName(control)}${current}${activity ? ` | ${activity}` : \"\"}`);\n\t\tlines.push(`  status: subagent({ action: \"status\", id: \"${control.runId}\" })`);\n\t\tlines.push(\"  transcript: live in the expanded foreground result; persisted session transcript appears after completion when sessions are enabled.\");\n\t\tlines.push(...formatNestedRunStatusLines(control.nestedChildren, { indent: \"  \", commandHints: true, maxLines: 12 }));\n\t}\n\treturn lines;\n}\n\nfunction formatDetachedForegroundFleetLines(runs: ForegroundRun[]): string[] {\n\tif (runs.length === 0) return [];\n\tconst lines = [\"Detached foreground runs:\"];\n\tconst ordered = [...runs].sort((left, right) => right.updatedAt - left.updatedAt);\n\tfor (const run of ordered) {\n\t\tconst detachedChildren = run.children.filter((child) => child.status === \"detached\");\n\t\tconst childSummary = detachedChildren.map((child) => `${child.agent} #${child.index}`).join(\", \");\n\t\tlines.push(`- ${run.runId} | detached | ${run.mode}${childSummary ? ` | ${childSummary}` : \"\"}`);\n\t\tlines.push(`  status: subagent({ action: \"status\", id: \"${run.runId}\" })`);\n\t\tlines.push(`  recovery: reply to the supervisor request first, then wait with subagent_wait({ id: \"${run.runId}\" }); do not resume or launch a replacement while any child remains detached.`);\n\t}\n\treturn lines;\n}\n\nfunction formatAsyncFleetLines(runs: AsyncRunSummary[]): string[] {\n\tif (runs.length === 0) return [];\n\tconst lines = [\"Async runs:\"];\n\tfor (const run of runs) {\n\t\tconst progress = formatAsyncRunProgressLabel(run);\n\t\tconst activity = formatActivityFacts(run);\n\t\tconst cwd = run.cwd ? shortenPath(run.cwd) : shortenPath(run.asyncDir);\n\t\tconst pending = run.pendingAppends ? ` | ${run.pendingAppends} pending append${run.pendingAppends === 1 ? \"\" : \"s\"}` : \"\";\n\t\tlines.push(`- ${run.id} | ${run.state}${activity ? ` | ${activity}` : \"\"} | ${run.mode} | ${progress}${pending} | ${cwd}`);\n\t\tlines.push(`  status: subagent({ action: \"status\", id: \"${run.id}\" })`);\n\t\tlines.push(`  transcript: subagent({ action: \"status\", id: \"${run.id}\", view: \"transcript\" })`);\n\t\tfor (const step of run.steps) {\n\t\t\tconst display = step.label ? `${step.label} (${step.agent})` : step.agent;\n\t\t\tconst phase = step.phase ? `[${step.phase}] ` : \"\";\n\t\t\tconst stepActivity = formatActivityFacts(step);\n\t\t\tconst modelThinking = formatModelThinking(step.model, step.thinking);\n\t\t\tconst parts = [`${step.index}. ${phase}${display}`, step.status, stepActivity, modelThinking].filter(Boolean);\n\t\t\tlines.push(`  ${parts.join(\" | \")}`);\n\t\t\tconst output = path.join(run.asyncDir, `output-${step.index}.log`);\n\t\t\tif (fs.existsSync(output)) lines.push(`    output: ${shortenPath(output)}`);\n\t\t\tif (step.sessionFile) lines.push(`    session: ${shortenPath(step.sessionFile)}`);\n\t\t\tif (step.status === \"running\" || step.recentOutput?.length || fs.existsSync(output)) {\n\t\t\t\tlines.push(`    transcript: subagent({ action: \"status\", id: \"${run.id}\", index: ${step.index}, view: \"transcript\" })`);\n\t\t\t}\n\t\t\tlines.push(...formatNestedRunStatusLines(step.children, { indent: \"    \", commandHints: true, maxLines: 12 }));\n\t\t}\n\t\tconst attached = new Set(run.steps.flatMap((step) => step.children?.map((child) => child.id) ?? []));\n\t\tconst unattached = run.nestedChildren?.filter((child) => !attached.has(child.id)) ?? [];\n\t\tlines.push(...formatNestedRunStatusLines(unattached, { indent: \"  \", commandHints: true, maxLines: 12 }));\n\t\tif (run.error) lines.push(`  error: ${run.error}`);\n\t\tfor (const warning of run.nestedWarnings ?? []) lines.push(`  warning: ${warning}`);\n\t\tconst outputPath = formatAsyncRunOutputPath(run);\n\t\tif (outputPath) lines.push(`  output: ${shortenPath(outputPath)}`);\n\t\tif (run.sessionFile) lines.push(`  session: ${shortenPath(run.sessionFile)}`);\n\t}\n\treturn lines;\n}\n\nexport function inspectSubagentFleet(_params: FleetViewParams, deps: FleetViewDeps = {}): AgentToolResult<Details> {\n\tif (deps.childSafe) {\n\t\treturn {\n\t\t\tcontent: [{ type: \"text\", text: \"Child-safe subagent fleet view is unavailable without an explicit run id. Use subagent({ action: \\\"status\\\", id: \\\"...\\\" }) for the delegated run you can see.\" }],\n\t\t\tisError: true,\n\t\t\tdetails: { mode: \"management\", results: [] },\n\t\t};\n\t}\n\n\tlet asyncRuns: AsyncRunSummary[];\n\ttry {\n\t\tasyncRuns = listAsyncRuns(deps.asyncDirRoot ?? ASYNC_DIR, {\n\t\t\tstates: [\"queued\", \"running\"],\n\t\t\tsessionId: deps.state?.currentSessionId ?? undefined,\n\t\t\tresultsDir: deps.resultsDir ?? RESULTS_DIR,\n\t\t\tkill: deps.kill,\n\t\t\tnow: deps.now,\n\t\t});\n\t} catch (error) {\n\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\treturn { content: [{ type: \"text\", text: message }], isError: true, details: { mode: \"management\", results: [] } };\n\t}\n\n\tconst foregroundControls = deps.state ? [...deps.state.foregroundControls.values()] : [];\n\tconst activeForegroundIds = new Set(foregroundControls.map((control) => control.runId));\n\tconst detachedForegroundRuns = deps.state?.foregroundRuns\n\t\t? [...deps.state.foregroundRuns.values()].filter((run) => run.sessionId === deps.state?.currentSessionId && !activeForegroundIds.has(run.runId) && run.children.some((child) => child.status === \"detached\"))\n\t\t: [];\n\tconst total = foregroundControls.length + detachedForegroundRuns.length + asyncRuns.length;\n\tif (total === 0) {\n\t\treturn {\n\t\t\tcontent: [{ type: \"text\", text: \"No active subagent fleet. Background runs that already finished are available through completion notifications or subagent({ action: \\\"status\\\", id: \\\"...\\\" }).\" }],\n\t\t\tdetails: { mode: \"management\", results: [] },\n\t\t};\n\t}\n\n\tconst lines = [`Subagent fleet: ${total} tracked`, \"\"];\n\tconst foregroundLines = formatForegroundFleetLines(foregroundControls);\n\tif (foregroundLines.length) lines.push(...foregroundLines, \"\");\n\tconst detachedForegroundLines = formatDetachedForegroundFleetLines(detachedForegroundRuns);\n\tif (detachedForegroundLines.length) lines.push(...detachedForegroundLines, \"\");\n\tconst asyncLines = formatAsyncFleetLines(asyncRuns);\n\tif (asyncLines.length) lines.push(...asyncLines, \"\");\n\tlines.push(\"Commands:\");\n\tlines.push(\"  Refresh fleet: subagent({ action: \\\"status\\\", view: \\\"fleet\\\" })\");\n\tlines.push(\"  Tail run transcript: subagent({ action: \\\"status\\\", id: \\\"<run-id>\\\", view: \\\"transcript\\\" })\");\n\tlines.push(\"  Tail child transcript: subagent({ action: \\\"status\\\", id: \\\"<run-id>\\\", index: 0, view: \\\"transcript\\\" })\");\n\n\treturn { content: [{ type: \"text\", text: lines.join(\"\\n\").trimEnd() }], details: { mode: \"management\", results: [] } };\n}\n\nfunction validateTranscriptIndex(index: number | undefined, steps: AsyncJobStep[]): number | undefined {\n\tif (index === undefined) return undefined;\n\tif (!Number.isInteger(index)) throw new Error(\"Transcript index must be an integer.\");\n\tif (index < 0 || index >= steps.length) throw new Error(`Transcript index ${index} is out of range for ${steps.length} child step${steps.length === 1 ? \"\" : \"s\"}.`);\n\treturn index;\n}\n\nfunction selectTranscriptStep(status: AsyncStatus, options: TranscriptOptions): { index?: number; step?: AsyncJobStep; hint?: string } {\n\tconst steps = status.steps ?? [];\n\tlet selectedIndex = validateTranscriptIndex(options.index, steps);\n\tif (selectedIndex === undefined) {\n\t\tif (status.state === \"running\" && typeof status.currentStep === \"number\" && status.currentStep >= 0 && status.currentStep < steps.length) {\n\t\t\tselectedIndex = status.currentStep;\n\t\t} else if (steps.length === 1) {\n\t\t\tselectedIndex = 0;\n\t\t}\n\t}\n\tconst step = selectedIndex !== undefined ? steps[selectedIndex] : undefined;\n\tconst hint = options.index === undefined && steps.length > 1\n\t\t? `Tip: pass index to inspect a specific child transcript (${steps.map((candidate, index) => `${index}=${candidate.agent}`).join(\", \")}).`\n\t\t: undefined;\n\treturn { index: selectedIndex, step, hint };\n}\n\nfunction stepStateLine(mode: SubagentRunMode, index: number | undefined, step: AsyncJobStep | undefined): string | undefined {\n\tif (index === undefined || !step) return undefined;\n\tconst modelThinking = formatModelThinking(step.model, step.thinking);\n\tconst parts = [\n\t\t`${mode === \"parallel\" ? \"Agent\" : \"Step\"}: ${index} (${step.agent})`,\n\t\tstep.status,\n\t\tformatActivityFacts(step),\n\t\tmodelThinking,\n\t\tstep.error ? `error: ${step.error}` : undefined,\n\t].filter(Boolean);\n\treturn parts.join(\" | \");\n}\n\nfunction appendKnownArtifacts(lines: string[], input: { outputPaths: string[]; sessionFile?: string; eventsPath?: string; logPath?: string; resultPath?: string }): void {\n\tconst artifacts: string[] = [];\n\tfor (const outputPath of input.outputPaths) artifacts.push(`Output: ${outputPath}`);\n\tif (input.sessionFile) artifacts.push(`Session: ${input.sessionFile}`);\n\tif (input.eventsPath) artifacts.push(`Events: ${input.eventsPath}`);\n\tif (input.logPath) artifacts.push(`Log: ${input.logPath}`);\n\tif (input.resultPath) artifacts.push(`Result: ${input.resultPath}`);\n\tif (!artifacts.length) return;\n\tlines.push(\"Artifacts:\");\n\tfor (const artifact of artifacts) lines.push(`  ${artifact}`);\n}\n\nfunction appendTranscriptBody(lines: string[], sourceLabel: string, sourceLines: string[], truncated: boolean): void {\n\tlines.push(`${sourceLabel}${truncated ? \" (tail truncated)\" : \"\"}:`);\n\tif (sourceLines.length === 0) {\n\t\tlines.push(\"  (no transcript lines available yet)\");\n\t\treturn;\n\t}\n\tfor (const line of sourceLines) lines.push(`  ${line}`);\n}\n\nexport function formatAsyncRunTranscript(status: AsyncStatus, asyncDir: string, options: TranscriptOptions = {}): string {\n\tconst lineLimit = transcriptLineLimit(options.lines);\n\tconst selected = selectTranscriptStep(status, options);\n\tconst stepOutputPath = selected.index !== undefined ? path.join(asyncDir, `output-${selected.index}.log`) : undefined;\n\tconst runOutputPath = resolveMaybeRelative(asyncDir, status.outputFile);\n\tconst logPath = path.join(asyncDir, `subagent-log-${status.runId}.md`);\n\tconst outputPaths = selected.index !== undefined\n\t\t? uniqueStrings([stepOutputPath, runOutputPath && stepOutputPath && path.resolve(runOutputPath) === path.resolve(stepOutputPath) ? runOutputPath : undefined])\n\t\t: uniqueStrings([runOutputPath]);\n\tconst sessionFile = selected.index !== undefined ? selected.step?.sessionFile : status.sessionFile;\n\tconst eventsPath = path.join(asyncDir, \"events.jsonl\");\n\n\tconst lines = [\n\t\t`Run: ${status.runId}`,\n\t\t`State: ${status.state}`,\n\t\t`Mode: ${status.mode}`,\n\t\tstepStateLine(status.mode, selected.index, selected.step),\n\t\tselected.hint,\n\t].filter((line): line is string => Boolean(line));\n\tappendKnownArtifacts(lines, { outputPaths, sessionFile, eventsPath: fs.existsSync(eventsPath) ? eventsPath : undefined, logPath: fs.existsSync(logPath) ? logPath : undefined });\n\n\tconst warnings: string[] = [];\n\tlet transcriptLines: string[] = [];\n\tlet transcriptSource = \"Transcript tail\";\n\tlet truncated = false;\n\tfor (const outputPath of outputPaths) {\n\t\tconst tail = readContainedTextTail(outputPath, lineLimit, [asyncDir], \"output\");\n\t\tif (tail.error) warnings.push(`Output read failed for ${tail.path}: ${tail.error}`);\n\t\tif (tail.lines.length === 0) continue;\n\t\ttranscriptLines = tail.lines;\n\t\ttranscriptSource = \"Transcript tail\";\n\t\ttruncated = tail.truncated;\n\t\tbreak;\n\t}\n\tif (transcriptLines.length === 0 && selected.step?.recentOutput?.length) {\n\t\ttranscriptLines = selected.step.recentOutput.slice(-lineLimit);\n\t\ttranscriptSource = \"Recent output\";\n\t}\n\tif (transcriptLines.length === 0 && sessionFile) {\n\t\tconst sessionTail = readSessionTranscriptTail(sessionFile, lineLimit, options.sessionRoots ?? []);\n\t\ttranscriptLines = sessionTail.lines;\n\t\twarnings.push(...sessionTail.warnings);\n\t\tif (transcriptLines.length > 0) transcriptSource = \"Session transcript tail\";\n\t}\n\n\tif (warnings.length) {\n\t\tlines.push(\"Warnings:\");\n\t\tfor (const warning of warnings) lines.push(`  ${warning}`);\n\t}\n\tappendTranscriptBody(lines, transcriptSource, transcriptLines, truncated);\n\treturn lines.join(\"\\n\");\n}\n\nexport function formatNestedRunTranscript(run: NestedRunSummary, options: TranscriptOptions = {}): string {\n\tif (run.asyncDir) {\n\t\tconst status = readStatus(run.asyncDir);\n\t\tif (status) return formatAsyncRunTranscript(status, run.asyncDir, options);\n\t}\n\tconst lineLimit = transcriptLineLimit(options.lines);\n\tconst lines = [\n\t\t`Nested run: ${run.id}`,\n\t\t`State: ${run.state}`,\n\t\trun.mode ? `Mode: ${run.mode}` : undefined,\n\t\trun.agent ? `Agent: ${run.agent}` : run.agents?.length ? `Agents: ${run.agents.join(\", \")}` : undefined,\n\t].filter((line): line is string => Boolean(line));\n\tappendKnownArtifacts(lines, { outputPaths: [], sessionFile: run.sessionFile });\n\tif (!run.sessionFile) {\n\t\tappendTranscriptBody(lines, \"Transcript tail\", [], false);\n\t\treturn lines.join(\"\\n\");\n\t}\n\tconst sessionTail = readSessionTranscriptTail(run.sessionFile, lineLimit, options.sessionRoots ?? []);\n\tif (sessionTail.warnings.length) {\n\t\tlines.push(\"Warnings:\");\n\t\tfor (const warning of sessionTail.warnings) lines.push(`  ${warning}`);\n\t}\n\tappendTranscriptBody(lines, `Session transcript tail from ${run.sessionFile}`, sessionTail.lines, false);\n\treturn lines.join(\"\\n\");\n}\n\nexport function formatAsyncResultTranscript(data: {\n\tid?: string;\n\trunId?: string;\n\tstate?: string;\n\tsuccess?: boolean;\n\tsummary?: string;\n\toutput?: string;\n\tsessionFile?: string;\n\tagent?: string;\n\texitCode?: number | null;\n\tresults?: Array<{ agent?: string; output?: string; summary?: string; sessionFile?: string; state?: string; success?: boolean; exitCode?: number | null }>;\n}, resultPath: string, options: TranscriptOptions = {}): string {\n\tconst lineLimit = transcriptLineLimit(options.lines);\n\tconst runId = data.runId ?? data.id ?? path.basename(resultPath, \".json\");\n\tconst children = Array.isArray(data.results)\n\t\t? data.results\n\t\t: data.agent\n\t\t\t? [{ agent: data.agent, output: data.output, summary: data.summary, sessionFile: data.sessionFile, state: data.state, success: data.success, exitCode: data.exitCode }]\n\t\t\t: [];\n\tlet index = options.index;\n\tif (index !== undefined && !Number.isInteger(index)) throw new Error(\"Transcript index must be an integer.\");\n\tif (index === undefined && children.length === 1) index = 0;\n\tif (index !== undefined && (index < 0 || index >= children.length)) throw new Error(`Transcript index ${index} is out of range for ${children.length} result child${children.length === 1 ? \"\" : \"ren\"}.`);\n\tconst child = index !== undefined ? children[index] : undefined;\n\tconst output = index !== undefined\n\t\t? child?.output ?? child?.summary ?? (children.length === 1 ? data.output ?? data.summary : undefined) ?? \"\"\n\t\t: data.output ?? data.summary ?? \"\";\n\tconst transcriptLines = output.split(/\\r?\\n/).slice(-lineLimit);\n\tconst sessionFile = child?.sessionFile ?? data.sessionFile;\n\tconst lines = [\n\t\t`Run: ${runId}`,\n\t\t`State: ${data.state ?? (data.success ? \"complete\" : \"failed\")}`,\n\t\tindex !== undefined && child ? `Child: ${index} (${child.agent ?? \"subagent\"})` : undefined,\n\t\tindex === undefined && children.length > 1 ? `Tip: pass index to inspect a specific child transcript (${children.map((candidate, childIndex) => `${childIndex}=${candidate.agent ?? \"subagent\"}`).join(\", \")}).` : undefined,\n\t].filter((line): line is string => Boolean(line));\n\tappendKnownArtifacts(lines, { outputPaths: [], sessionFile, resultPath });\n\tappendTranscriptBody(lines, \"Result transcript tail\", transcriptLines.filter((line) => line.trim()), output.split(/\\r?\\n/).length > lineLimit);\n\treturn lines.join(\"\\n\");\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/runs/background/fleet-view.js

@@ -0,0 +1,518 @@
+// @ts-nocheck
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { formatDuration, formatModelThinking, formatTokens, shortenPath } from "../../shared/formatters.js";
+import { formatActivityLabel } from "../../shared/status-format.js";
+import { ASYNC_DIR, RESULTS_DIR, } from "../../shared/types.js";
+import { readStatus } from "../../shared/utils.js";
+import { formatNestedRunStatusLines } from "../shared/nested-render.js";
+import { formatAsyncRunOutputPath, formatAsyncRunProgressLabel, listAsyncRuns } from "./async-status.js";
+const DEFAULT_TRANSCRIPT_LINES = 80;
+const MAX_TRANSCRIPT_LINES = 500;
+const TRANSCRIPT_TAIL_BYTES = 256 * 1024;
+function transcriptLineLimit(value) {
+    if (value === undefined)
+        return DEFAULT_TRANSCRIPT_LINES;
+    if (!Number.isFinite(value))
+        return DEFAULT_TRANSCRIPT_LINES;
+    return Math.max(1, Math.min(MAX_TRANSCRIPT_LINES, Math.trunc(value)));
+}
+function uniqueStrings(values) {
+    const seen = new Set();
+    const result = [];
+    for (const value of values) {
+        if (!value || seen.has(value))
+            continue;
+        seen.add(value);
+        result.push(value);
+    }
+    return result;
+}
+function resolveMaybeRelative(asyncDir, filePath) {
+    if (!filePath)
+        return undefined;
+    return path.resolve(asyncDir, filePath);
+}
+function pathWithin(base, candidate) {
+    const resolvedBase = path.resolve(base);
+    const resolvedCandidate = path.resolve(candidate);
+    return resolvedCandidate === resolvedBase || resolvedCandidate.startsWith(`${resolvedBase}${path.sep}`);
+}
+function getErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function isNotFoundError(error) {
+    return typeof error === "object"
+        && error !== null
+        && "code" in error
+        && error.code === "ENOENT";
+}
+function readTextTail(filePath, maxLines) {
+    let stat;
+    try {
+        stat = fs.statSync(filePath);
+    }
+    catch (error) {
+        if (isNotFoundError(error))
+            return { path: filePath, lines: [], truncated: false };
+        return { path: filePath, lines: [], truncated: false, error: getErrorMessage(error) };
+    }
+    if (stat.size === 0)
+        return { path: filePath, lines: [], truncated: false };
+    let fd;
+    try {
+        const bytesToRead = Math.min(stat.size, TRANSCRIPT_TAIL_BYTES);
+        const start = stat.size - bytesToRead;
+        const buffer = Buffer.alloc(bytesToRead);
+        fd = fs.openSync(filePath, "r");
+        const bytesRead = fs.readSync(fd, buffer, 0, bytesToRead, start);
+        const content = buffer.subarray(0, bytesRead).toString("utf-8");
+        let lines = content.split(/\r?\n/);
+        if (start > 0 && lines.length > 0)
+            lines = lines.slice(1);
+        if (lines.at(-1) === "")
+            lines = lines.slice(0, -1);
+        return { path: filePath, lines: lines.slice(-maxLines), truncated: start > 0 || lines.length > maxLines };
+    }
+    catch (error) {
+        return { path: filePath, lines: [], truncated: false, error: getErrorMessage(error) };
+    }
+    finally {
+        if (fd !== undefined)
+            fs.closeSync(fd);
+    }
+}
+function readContainedTextTail(filePath, maxLines, trustedRoots, label) {
+    if (trustedRoots.length === 0)
+        return { path: filePath, lines: [], truncated: false, error: `Refusing to read ${label} transcript path without a trusted root: ${filePath}` };
+    const resolvedPath = path.resolve(filePath);
+    if (!trustedRoots.some((root) => pathWithin(root, resolvedPath))) {
+        return { path: filePath, lines: [], truncated: false, error: `Refusing to read ${label} transcript path outside trusted roots: ${filePath}` };
+    }
+    let lstat;
+    try {
+        lstat = fs.lstatSync(resolvedPath);
+    }
+    catch (error) {
+        if (isNotFoundError(error))
+            return { path: filePath, lines: [], truncated: false };
+        return { path: filePath, lines: [], truncated: false, error: getErrorMessage(error) };
+    }
+    if (lstat.isSymbolicLink())
+        return { path: filePath, lines: [], truncated: false, error: `Refusing to read symlink ${label} transcript path: ${filePath}` };
+    if (!lstat.isFile())
+        return { path: filePath, lines: [], truncated: false, error: `Refusing to read non-file ${label} transcript path: ${filePath}` };
+    let realPath;
+    let realRoots;
+    try {
+        realPath = fs.realpathSync(resolvedPath);
+        realRoots = trustedRoots.filter((root) => fs.existsSync(root)).map((root) => fs.realpathSync(root));
+    }
+    catch (error) {
+        return { path: filePath, lines: [], truncated: false, error: getErrorMessage(error) };
+    }
+    if (!realRoots.some((root) => pathWithin(root, realPath))) {
+        return { path: filePath, lines: [], truncated: false, error: `Refusing to read ${label} transcript path outside trusted roots: ${filePath}` };
+    }
+    return readTextTail(resolvedPath, maxLines);
+}
+function stringifyJsonPreview(value, maxLength = 240) {
+    let raw;
+    if (typeof value === "string")
+        raw = value;
+    else
+        raw = JSON.stringify(value);
+    return raw.length > maxLength ? `${raw.slice(0, maxLength)}…` : raw;
+}
+function contentText(content) {
+    if (typeof content === "string")
+        return content;
+    if (!Array.isArray(content))
+        return "";
+    return content.map((part) => {
+        if (!part || typeof part !== "object")
+            return "";
+        const entry = part;
+        if (typeof entry.text === "string")
+            return entry.text;
+        if (entry.type === "toolCall" || entry.type === "tool_call") {
+            const name = typeof entry.name === "string" ? entry.name : typeof entry.toolName === "string" ? entry.toolName : "tool";
+            return `[tool: ${name}${entry.args === undefined ? "" : ` ${stringifyJsonPreview(entry.args)}`}]`;
+        }
+        if (entry.type === "toolResult" || entry.type === "tool_result") {
+            return `[tool result${entry.result === undefined ? "" : `: ${stringifyJsonPreview(entry.result)}`}]`;
+        }
+        if (entry.content !== undefined)
+            return stringifyJsonPreview(entry.content);
+        return "";
+    }).filter(Boolean).join("\n");
+}
+function sessionMessageLine(record) {
+    if (!record || typeof record !== "object")
+        return undefined;
+    const outer = record;
+    const message = outer.message && typeof outer.message === "object" ? outer.message : outer;
+    const role = typeof message.role === "string" ? message.role : undefined;
+    if (!role)
+        return undefined;
+    const text = contentText(message.content).trim();
+    if (!text)
+        return undefined;
+    return `${role}: ${text}`;
+}
+function readSessionTranscriptTail(sessionFile, maxLines, trustedRoots) {
+    const tail = readContainedTextTail(sessionFile, Math.max(maxLines * 4, maxLines), trustedRoots, "session");
+    const warnings = [];
+    if (tail.error)
+        warnings.push(`Session read failed for ${sessionFile}: ${tail.error}`);
+    const lines = [];
+    let malformed = 0;
+    for (const line of tail.lines) {
+        if (!line.trim())
+            continue;
+        try {
+            const parsed = JSON.parse(line);
+            const messageLine = sessionMessageLine(parsed);
+            if (messageLine)
+                lines.push(messageLine);
+        }
+        catch {
+            malformed++;
+        }
+    }
+    if (malformed > 0)
+        warnings.push(`Skipped ${malformed} malformed session tail line${malformed === 1 ? "" : "s"}.`);
+    return { lines: lines.slice(-maxLines), warnings };
+}
+function formatActivityFacts(input) {
+    const facts = [];
+    if (input.currentTool && input.currentToolStartedAt !== undefined)
+        facts.push(`tool ${input.currentTool} ${formatDuration(Math.max(0, Date.now() - input.currentToolStartedAt))}`);
+    else if (input.currentTool)
+        facts.push(`tool ${input.currentTool}`);
+    if (input.currentPath)
+        facts.push(shortenPath(input.currentPath));
+    if (input.turnCount !== undefined)
+        facts.push(`${input.turnCount} turns`);
+    if (input.toolCount !== undefined)
+        facts.push(`${input.toolCount} tools`);
+    if (input.tokens?.total)
+        facts.push(`${formatTokens(input.tokens.total)} tok`);
+    const activity = formatActivityLabel(input.lastActivityAt, input.activityState);
+    return activity || facts.length ? [activity, ...facts].filter(Boolean).join(" | ") : undefined;
+}
+function foregroundModeName(control) {
+    if (control.mode === "single" && control.currentAgent)
+        return control.currentAgent;
+    return control.mode;
+}
+function formatForegroundFleetLines(controls) {
+    if (controls.length === 0)
+        return [];
+    const lines = ["Foreground runs:"];
+    const ordered = [...controls].sort((left, right) => right.updatedAt - left.updatedAt);
+    for (const control of ordered) {
+        const activity = formatActivityFacts({
+            activityState: control.currentActivityState,
+            lastActivityAt: control.lastActivityAt,
+            currentTool: control.currentTool,
+            currentToolStartedAt: control.currentToolStartedAt,
+            currentPath: control.currentPath,
+            turnCount: control.turnCount,
+            toolCount: control.toolCount,
+            ...(control.tokens !== undefined ? { tokens: { total: control.tokens } } : {}),
+        });
+        const current = control.currentAgent ? ` | ${control.currentAgent}${control.currentIndex !== undefined ? ` #${control.currentIndex}` : ""}` : "";
+        lines.push(`- ${control.runId} | running | ${foregroundModeName(control)}${current}${activity ? ` | ${activity}` : ""}`);
+        lines.push(`  status: subagent({ action: "status", id: "${control.runId}" })`);
+        lines.push("  transcript: live in the expanded foreground result; persisted session transcript appears after completion when sessions are enabled.");
+        lines.push(...formatNestedRunStatusLines(control.nestedChildren, { indent: "  ", commandHints: true, maxLines: 12 }));
+    }
+    return lines;
+}
+function formatDetachedForegroundFleetLines(runs) {
+    if (runs.length === 0)
+        return [];
+    const lines = ["Detached foreground runs:"];
+    const ordered = [...runs].sort((left, right) => right.updatedAt - left.updatedAt);
+    for (const run of ordered) {
+        const detachedChildren = run.children.filter((child) => child.status === "detached");
+        const childSummary = detachedChildren.map((child) => `${child.agent} #${child.index}`).join(", ");
+        lines.push(`- ${run.runId} | detached | ${run.mode}${childSummary ? ` | ${childSummary}` : ""}`);
+        lines.push(`  status: subagent({ action: "status", id: "${run.runId}" })`);
+        lines.push(`  recovery: reply to the supervisor request first, then wait with subagent_wait({ id: "${run.runId}" }); do not resume or launch a replacement while any child remains detached.`);
+    }
+    return lines;
+}
+function formatAsyncFleetLines(runs) {
+    if (runs.length === 0)
+        return [];
+    const lines = ["Async runs:"];
+    for (const run of runs) {
+        const progress = formatAsyncRunProgressLabel(run);
+        const activity = formatActivityFacts(run);
+        const cwd = run.cwd ? shortenPath(run.cwd) : shortenPath(run.asyncDir);
+        const pending = run.pendingAppends ? ` | ${run.pendingAppends} pending append${run.pendingAppends === 1 ? "" : "s"}` : "";
+        lines.push(`- ${run.id} | ${run.state}${activity ? ` | ${activity}` : ""} | ${run.mode} | ${progress}${pending} | ${cwd}`);
+        lines.push(`  status: subagent({ action: "status", id: "${run.id}" })`);
+        lines.push(`  transcript: subagent({ action: "status", id: "${run.id}", view: "transcript" })`);
+        for (const step of run.steps) {
+            const display = step.label ? `${step.label} (${step.agent})` : step.agent;
+            const phase = step.phase ? `[${step.phase}] ` : "";
+            const stepActivity = formatActivityFacts(step);
+            const modelThinking = formatModelThinking(step.model, step.thinking);
+            const parts = [`${step.index}. ${phase}${display}`, step.status, stepActivity, modelThinking].filter(Boolean);
+            lines.push(`  ${parts.join(" | ")}`);
+            const output = path.join(run.asyncDir, `output-${step.index}.log`);
+            if (fs.existsSync(output))
+                lines.push(`    output: ${shortenPath(output)}`);
+            if (step.sessionFile)
+                lines.push(`    session: ${shortenPath(step.sessionFile)}`);
+            if (step.status === "running" || step.recentOutput?.length || fs.existsSync(output)) {
+                lines.push(`    transcript: subagent({ action: "status", id: "${run.id}", index: ${step.index}, view: "transcript" })`);
+            }
+            lines.push(...formatNestedRunStatusLines(step.children, { indent: "    ", commandHints: true, maxLines: 12 }));
+        }
+        const attached = new Set(run.steps.flatMap((step) => step.children?.map((child) => child.id) ?? []));
+        const unattached = run.nestedChildren?.filter((child) => !attached.has(child.id)) ?? [];
+        lines.push(...formatNestedRunStatusLines(unattached, { indent: "  ", commandHints: true, maxLines: 12 }));
+        if (run.error)
+            lines.push(`  error: ${run.error}`);
+        for (const warning of run.nestedWarnings ?? [])
+            lines.push(`  warning: ${warning}`);
+        const outputPath = formatAsyncRunOutputPath(run);
+        if (outputPath)
+            lines.push(`  output: ${shortenPath(outputPath)}`);
+        if (run.sessionFile)
+            lines.push(`  session: ${shortenPath(run.sessionFile)}`);
+    }
+    return lines;
+}
+export function inspectSubagentFleet(_params, deps = {}) {
+    if (deps.childSafe) {
+        return {
+            content: [{ type: "text", text: "Child-safe subagent fleet view is unavailable without an explicit run id. Use subagent({ action: \"status\", id: \"...\" }) for the delegated run you can see." }],
+            isError: true,
+            details: { mode: "management", results: [] },
+        };
+    }
+    let asyncRuns;
+    try {
+        asyncRuns = listAsyncRuns(deps.asyncDirRoot ?? ASYNC_DIR, {
+            states: ["queued", "running"],
+            sessionId: deps.state?.currentSessionId ?? undefined,
+            resultsDir: deps.resultsDir ?? RESULTS_DIR,
+            kill: deps.kill,
+            now: deps.now,
+        });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return { content: [{ type: "text", text: message }], isError: true, details: { mode: "management", results: [] } };
+    }
+    const foregroundControls = deps.state ? [...deps.state.foregroundControls.values()] : [];
+    const activeForegroundIds = new Set(foregroundControls.map((control) => control.runId));
+    const detachedForegroundRuns = deps.state?.foregroundRuns
+        ? [...deps.state.foregroundRuns.values()].filter((run) => run.sessionId === deps.state?.currentSessionId && !activeForegroundIds.has(run.runId) && run.children.some((child) => child.status === "detached"))
+        : [];
+    const total = foregroundControls.length + detachedForegroundRuns.length + asyncRuns.length;
+    if (total === 0) {
+        return {
+            content: [{ type: "text", text: "No active subagent fleet. Background runs that already finished are available through completion notifications or subagent({ action: \"status\", id: \"...\" })." }],
+            details: { mode: "management", results: [] },
+        };
+    }
+    const lines = [`Subagent fleet: ${total} tracked`, ""];
+    const foregroundLines = formatForegroundFleetLines(foregroundControls);
+    if (foregroundLines.length)
+        lines.push(...foregroundLines, "");
+    const detachedForegroundLines = formatDetachedForegroundFleetLines(detachedForegroundRuns);
+    if (detachedForegroundLines.length)
+        lines.push(...detachedForegroundLines, "");
+    const asyncLines = formatAsyncFleetLines(asyncRuns);
+    if (asyncLines.length)
+        lines.push(...asyncLines, "");
+    lines.push("Commands:");
+    lines.push("  Refresh fleet: subagent({ action: \"status\", view: \"fleet\" })");
+    lines.push("  Tail run transcript: subagent({ action: \"status\", id: \"<run-id>\", view: \"transcript\" })");
+    lines.push("  Tail child transcript: subagent({ action: \"status\", id: \"<run-id>\", index: 0, view: \"transcript\" })");
+    return { content: [{ type: "text", text: lines.join("\n").trimEnd() }], details: { mode: "management", results: [] } };
+}
+function validateTranscriptIndex(index, steps) {
+    if (index === undefined)
+        return undefined;
+    if (!Number.isInteger(index))
+        throw new Error("Transcript index must be an integer.");
+    if (index < 0 || index >= steps.length)
+        throw new Error(`Transcript index ${index} is out of range for ${steps.length} child step${steps.length === 1 ? "" : "s"}.`);
+    return index;
+}
+function selectTranscriptStep(status, options) {
+    const steps = status.steps ?? [];
+    let selectedIndex = validateTranscriptIndex(options.index, steps);
+    if (selectedIndex === undefined) {
+        if (status.state === "running" && typeof status.currentStep === "number" && status.currentStep >= 0 && status.currentStep < steps.length) {
+            selectedIndex = status.currentStep;
+        }
+        else if (steps.length === 1) {
+            selectedIndex = 0;
+        }
+    }
+    const step = selectedIndex !== undefined ? steps[selectedIndex] : undefined;
+    const hint = options.index === undefined && steps.length > 1
+        ? `Tip: pass index to inspect a specific child transcript (${steps.map((candidate, index) => `${index}=${candidate.agent}`).join(", ")}).`
+        : undefined;
+    return { index: selectedIndex, step, hint };
+}
+function stepStateLine(mode, index, step) {
+    if (index === undefined || !step)
+        return undefined;
+    const modelThinking = formatModelThinking(step.model, step.thinking);
+    const parts = [
+        `${mode === "parallel" ? "Agent" : "Step"}: ${index} (${step.agent})`,
+        step.status,
+        formatActivityFacts(step),
+        modelThinking,
+        step.error ? `error: ${step.error}` : undefined,
+    ].filter(Boolean);
+    return parts.join(" | ");
+}
+function appendKnownArtifacts(lines, input) {
+    const artifacts = [];
+    for (const outputPath of input.outputPaths)
+        artifacts.push(`Output: ${outputPath}`);
+    if (input.sessionFile)
+        artifacts.push(`Session: ${input.sessionFile}`);
+    if (input.eventsPath)
+        artifacts.push(`Events: ${input.eventsPath}`);
+    if (input.logPath)
+        artifacts.push(`Log: ${input.logPath}`);
+    if (input.resultPath)
+        artifacts.push(`Result: ${input.resultPath}`);
+    if (!artifacts.length)
+        return;
+    lines.push("Artifacts:");
+    for (const artifact of artifacts)
+        lines.push(`  ${artifact}`);
+}
+function appendTranscriptBody(lines, sourceLabel, sourceLines, truncated) {
+    lines.push(`${sourceLabel}${truncated ? " (tail truncated)" : ""}:`);
+    if (sourceLines.length === 0) {
+        lines.push("  (no transcript lines available yet)");
+        return;
+    }
+    for (const line of sourceLines)
+        lines.push(`  ${line}`);
+}
+export function formatAsyncRunTranscript(status, asyncDir, options = {}) {
+    const lineLimit = transcriptLineLimit(options.lines);
+    const selected = selectTranscriptStep(status, options);
+    const stepOutputPath = selected.index !== undefined ? path.join(asyncDir, `output-${selected.index}.log`) : undefined;
+    const runOutputPath = resolveMaybeRelative(asyncDir, status.outputFile);
+    const logPath = path.join(asyncDir, `subagent-log-${status.runId}.md`);
+    const outputPaths = selected.index !== undefined
+        ? uniqueStrings([stepOutputPath, runOutputPath && stepOutputPath && path.resolve(runOutputPath) === path.resolve(stepOutputPath) ? runOutputPath : undefined])
+        : uniqueStrings([runOutputPath]);
+    const sessionFile = selected.index !== undefined ? selected.step?.sessionFile : status.sessionFile;
+    const eventsPath = path.join(asyncDir, "events.jsonl");
+    const lines = [
+        `Run: ${status.runId}`,
+        `State: ${status.state}`,
+        `Mode: ${status.mode}`,
+        stepStateLine(status.mode, selected.index, selected.step),
+        selected.hint,
+    ].filter((line) => Boolean(line));
+    appendKnownArtifacts(lines, { outputPaths, sessionFile, eventsPath: fs.existsSync(eventsPath) ? eventsPath : undefined, logPath: fs.existsSync(logPath) ? logPath : undefined });
+    const warnings = [];
+    let transcriptLines = [];
+    let transcriptSource = "Transcript tail";
+    let truncated = false;
+    for (const outputPath of outputPaths) {
+        const tail = readContainedTextTail(outputPath, lineLimit, [asyncDir], "output");
+        if (tail.error)
+            warnings.push(`Output read failed for ${tail.path}: ${tail.error}`);
+        if (tail.lines.length === 0)
+            continue;
+        transcriptLines = tail.lines;
+        transcriptSource = "Transcript tail";
+        truncated = tail.truncated;
+        break;
+    }
+    if (transcriptLines.length === 0 && selected.step?.recentOutput?.length) {
+        transcriptLines = selected.step.recentOutput.slice(-lineLimit);
+        transcriptSource = "Recent output";
+    }
+    if (transcriptLines.length === 0 && sessionFile) {
+        const sessionTail = readSessionTranscriptTail(sessionFile, lineLimit, options.sessionRoots ?? []);
+        transcriptLines = sessionTail.lines;
+        warnings.push(...sessionTail.warnings);
+        if (transcriptLines.length > 0)
+            transcriptSource = "Session transcript tail";
+    }
+    if (warnings.length) {
+        lines.push("Warnings:");
+        for (const warning of warnings)
+            lines.push(`  ${warning}`);
+    }
+    appendTranscriptBody(lines, transcriptSource, transcriptLines, truncated);
+    return lines.join("\n");
+}
+export function formatNestedRunTranscript(run, options = {}) {
+    if (run.asyncDir) {
+        const status = readStatus(run.asyncDir);
+        if (status)
+            return formatAsyncRunTranscript(status, run.asyncDir, options);
+    }
+    const lineLimit = transcriptLineLimit(options.lines);
+    const lines = [
+        `Nested run: ${run.id}`,
+        `State: ${run.state}`,
+        run.mode ? `Mode: ${run.mode}` : undefined,
+        run.agent ? `Agent: ${run.agent}` : run.agents?.length ? `Agents: ${run.agents.join(", ")}` : undefined,
+    ].filter((line) => Boolean(line));
+    appendKnownArtifacts(lines, { outputPaths: [], sessionFile: run.sessionFile });
+    if (!run.sessionFile) {
+        appendTranscriptBody(lines, "Transcript tail", [], false);
+        return lines.join("\n");
+    }
+    const sessionTail = readSessionTranscriptTail(run.sessionFile, lineLimit, options.sessionRoots ?? []);
+    if (sessionTail.warnings.length) {
+        lines.push("Warnings:");
+        for (const warning of sessionTail.warnings)
+            lines.push(`  ${warning}`);
+    }
+    appendTranscriptBody(lines, `Session transcript tail from ${run.sessionFile}`, sessionTail.lines, false);
+    return lines.join("\n");
+}
+export function formatAsyncResultTranscript(data, resultPath, options = {}) {
+    const lineLimit = transcriptLineLimit(options.lines);
+    const runId = data.runId ?? data.id ?? path.basename(resultPath, ".json");
+    const children = Array.isArray(data.results)
+        ? data.results
+        : data.agent
+            ? [{ agent: data.agent, output: data.output, summary: data.summary, sessionFile: data.sessionFile, state: data.state, success: data.success, exitCode: data.exitCode }]
+            : [];
+    let index = options.index;
+    if (index !== undefined && !Number.isInteger(index))
+        throw new Error("Transcript index must be an integer.");
+    if (index === undefined && children.length === 1)
+        index = 0;
+    if (index !== undefined && (index < 0 || index >= children.length))
+        throw new Error(`Transcript index ${index} is out of range for ${children.length} result child${children.length === 1 ? "" : "ren"}.`);
+    const child = index !== undefined ? children[index] : undefined;
+    const output = index !== undefined
+        ? child?.output ?? child?.summary ?? (children.length === 1 ? data.output ?? data.summary : undefined) ?? ""
+        : data.output ?? data.summary ?? "";
+    const transcriptLines = output.split(/\r?\n/).slice(-lineLimit);
+    const sessionFile = child?.sessionFile ?? data.sessionFile;
+    const lines = [
+        `Run: ${runId}`,
+        `State: ${data.state ?? (data.success ? "complete" : "failed")}`,
+        index !== undefined && child ? `Child: ${index} (${child.agent ?? "subagent"})` : undefined,
+        index === undefined && children.length > 1 ? `Tip: pass index to inspect a specific child transcript (${children.map((candidate, childIndex) => `${childIndex}=${candidate.agent ?? "subagent"}`).join(", ")}).` : undefined,
+    ].filter((line) => Boolean(line));
+    appendKnownArtifacts(lines, { outputPaths: [], sessionFile, resultPath });
+    appendTranscriptBody(lines, "Result transcript tail", transcriptLines.filter((line) => line.trim()), output.split(/\r?\n/).length > lineLimit);
+    return lines.join("\n");
+}
+//# sourceMappingURL=fleet-view.js.map