import { aiVaultAgentLabel } from '../shared/ai-vault/contracts/ai-vault-types' import type { AiVaultSearchHit, AiVaultSearchResponse, AiVaultSearchStatus } from '../shared/ai-vault/search/ai-vault-search-types' import { terminalSafeLine } from '../shared/terminal/output/terminal-safe-text' type SessionSearchResults = Extract /** Malformed cursors are a caller mistake and leave through the CLI error channel. */ export type PrintableSessionSearchResponse = Exclude< AiVaultSearchResponse, { kind: 'malformed-cursor' } > function oneLine(value: string): string { return terminalSafeLine(value).trim() } function formatHit(hit: AiVaultSearchHit): string { const host = oneLine(hit.executionHostId ?? '') const header = [ aiVaultAgentLabel(hit.agent), oneLine(hit.updatedAt ?? '') || 'unknown time', oneLine(hit.title) || '(untitled)', ...(host ? [`host=${host}`] : []) ].join(' ') const evidence = hit.evidence ? ` ${hit.evidence.role}: ${oneLine(hit.evidence.snippet)}` : ' no text evidence for this match' // Withheld for paired callers by the contract, so its absence is not a failure. const resume = hit.resumeCommand ? [` resume: ${oneLine(hit.resumeCommand)}`] : [] return [header, evidence, ...resume].join('\n') } function formatTruncation(truncated: SessionSearchResults['truncated']): string[] { return [ ...(truncated.candidates ? ['ranking saw only the first batch of candidate sessions, so a better match may be missing'] : []), ...(truncated.query ? ['query was cut'] : []), ...(truncated.freshness ? ['freshness wait timed out; these results come from the index as it stood'] : []), ...(truncated.snippets > 0 ? [`${truncated.snippets} snippets were shortened`] : []) ] } function formatDebug(debug: SessionSearchResults['debug']): string[] { if (!debug) { return [] } return [ '', 'debug:', ` route: ${debug.route}`, ...(debug.repairedTerms ? [` repairedTerms: ${debug.repairedTerms.map((term) => oneLine(term)).join(' ')}`] : []), ` plannerScope: ${debug.plannerReport.scope}` ] } function formatUnavailable( reason: 'disabled' | 'not-ready' | 'no-service' | 'scope-unknown' | 'unsupported-agent' ): string { if (reason === 'disabled') { return 'Session search is off on this host.' } if (reason === 'unsupported-agent') { return 'This host does not support history search for the selected agent. Update Orca on that host or select another agent.' } // Only hand-built requests can select an unknown identity; the CLI scopes by path. if (reason === 'scope-unknown') { return 'This host does not know the workspace or project that search was scoped to.' } if (reason === 'not-ready') { return 'Session search is not ready on this host yet. Try again once its index has started.' } return [ 'This host runs no session search service.', 'An Orca host older than session search answers the same way; update it and try again.' ].join('\n') } function formatResults(response: SessionSearchResults): string { const body = response.hits.length === 0 ? ['No sessions match this query.'] : response.hits.map(formatHit) const cursor = oneLine(response.page.cursor ?? '') const footer = [ `${response.hits.length} ${response.hits.length === 1 ? 'result' : 'results'} on this page, ${Math.round(response.durationMs)} ms.`, ...(response.page.hasMore && cursor ? [`more pages: re-run with --cursor ${cursor}`] : response.page.hasMore ? ['more pages exist, but this host issued no cursor for them'] : []), ...formatTruncation(response.truncated) ] return [...body, '', ...footer, ...formatDebug(response.debug)].join('\n') } export function formatSessionSearchResponse(response: PrintableSessionSearchResponse): string { if (response.kind === 'unavailable') { return formatUnavailable(response.reason) } if (response.kind === 'stale-cursor') { return [ 'The index moved on since that page, so the cursor no longer names a place in it.', 'Re-run the same search without --cursor to start again from page 1.' ].join('\n') } return formatResults(response) } function formatEpochMs(value: number | null): string { return value === null ? 'never' : new Date(value).toISOString() } export function formatSessionSearchStatus(status: AiVaultSearchStatus): string { return [ `enabled: ${status.enabled}`, `phase: ${status.phase}`, `filesIndexed: ${status.filesIndexed}`, `filesDue: ${status.filesDue}`, `filesFailed: ${status.filesFailed}`, `lastReconcileAt: ${formatEpochMs(status.lastReconcileAt)}`, `lastSweepCompletedAt: ${formatEpochMs(status.lastSweepCompletedAt)}`, `generation: ${status.generation}`, `degradedRoots: ${status.degradedRoots.length}`, // A paired host withholds the root itself and sends the count with a fixed reason. ...status.degradedRoots.map( (root) => ` ${root.root ? oneLine(root.root) : '(withheld)'}: ${oneLine(root.reason)}` ) ].join('\n') }