{isWebClient ? translate( 'sessionHistory.settings.webUnsupported', - 'Manage indexing in the Orca desktop app on the computer that owns the transcripts. These controls are unavailable from a paired client.' + 'Turn on session search from the Orca desktop app on that computer.' ) : translate( 'sessionHistory.settings.computersConsent', - 'Each computer keeps a local index of its own transcripts, including conversation text and tool output as written. Content is not redacted. Turning a computer off stops indexing and keeps its index.' + 'Each computer keeps a searchable copy of its own agent conversations and tool output. Nothing leaves that computer.' )}
{translate( - 'sessionHistory.settings.sshNote', - 'SSH hosts appear here once indexing is available on SSH.' + 'sessionHistory.settings.panelHint', + 'Search from the Agent Session History panel in the sidebar.' )}
@@ -262,10 +259,7 @@ export function SessionHistorySettingsPane({ } function saveErrorMessage(): string { - return translate( - 'sessionHistory.settings.saveError', - 'Could not save session search settings. Try again.' - ) + return translate('sessionHistory.settings.saveError', 'Could not save. Try again.') } /** Shared by the Advanced row and its confirm dialog so both promise the same thing. */ @@ -273,10 +267,10 @@ function deleteDescription(enabled: boolean): string { return enabled ? translate( 'sessionHistory.settings.deleteEnabled', - 'Turn off search on this computer and remove its index. Original transcripts are not touched. Switch search back on to rebuild.' + 'Turns off search and removes the searchable copy from this computer. Your agent sessions are not affected.' ) : translate( 'sessionHistory.settings.deleteDisabled', - 'Remove the search index from this computer. Original transcripts are not touched. Search stays off.' + 'Removes the searchable copy from this computer. Your agent sessions are not affected.' ) } diff --git a/src/renderer/src/components/settings/session-history-status-copy.ts b/src/renderer/src/components/settings/session-history-status-copy.ts index 45de302ee62..8dd340745d3 100644 --- a/src/renderer/src/components/settings/session-history-status-copy.ts +++ b/src/renderer/src/components/settings/session-history-status-copy.ts @@ -21,15 +21,19 @@ export function sessionSearchPollIntervalMs(status: AiVaultSearchStatus | null): function sweepMessage(status: AiVaultSearchStatus): string { if (status.lastSweepCompletedAt === null) { // No completed sweep yet, so the denominator is still growing and a percentage would mislead. - return translate('sessionHistory.status.firstScan', 'Indexing… {{indexed}} files so far', { - indexed: status.filesIndexed - }) + return translate( + 'sessionHistory.status.firstScan', + 'Preparing search · {{indexed}} sessions so far', + { + indexed: status.filesIndexed + } + ) } const total = status.filesIndexed + status.filesDue + status.filesFailed const percent = total > 0 ? Math.floor((status.filesIndexed / total) * 100) : 0 return translate( 'sessionHistory.status.progress', - 'Indexing · {{percent}}% · {{indexed}} of {{total}} files', + 'Preparing search · {{percent}}% · {{indexed}} of {{total}} sessions', { percent, indexed: status.filesIndexed, total } ) } @@ -39,18 +43,18 @@ export function sessionSearchStatusMessage(status: AiVaultSearchStatus): string if (!status.enabled || status.phase === 'idle' || status.phase === 'closed') { return translate( 'sessionHistory.status.unavailable', - 'Index is not ready or the search service is unavailable.' + 'Search is not available on this computer right now.' ) } if (isSweepingSessionSearch(status)) { return sweepMessage(status) } - return translate('sessionHistory.status.upToDate', 'Up to date · {{indexed}} files indexed', { + return translate('sessionHistory.status.upToDate', 'Ready · {{indexed}} sessions searchable', { indexed: status.filesIndexed }) } -/** Lines shown under the status sentence while a host is actually indexing. */ +/** Lines shown under the status sentence when something needs the user's attention. */ export function sessionSearchStatusDetails(status: AiVaultSearchStatus | null): string[] { if (!status?.enabled) { return [] @@ -60,22 +64,14 @@ export function sessionSearchStatusDetails(status: AiVaultSearchStatus | null): lines.push( translate( 'sessionHistory.status.unreadable', - '{{failed}} files could not be read and will be retried.', + '{{failed}} sessions could not be read and will be retried.', { failed: status.filesFailed } ) ) } - if (isSweepingSessionSearch(status)) { - lines.push( - translate( - 'sessionHistory.status.stopHint', - 'Turn off search to stop. Progress is kept and resumes when you turn it back on.' - ) - ) - } if (status.degradedRoots.length > 0) { lines.push( - translate('sessionHistory.status.roots', 'Unverified source roots: {{roots}}', { + translate('sessionHistory.status.roots', '{{roots}} session folders could not be checked.', { roots: status.degradedRoots.length }) ) @@ -84,15 +80,15 @@ export function sessionSearchStatusDetails(status: AiVaultSearchStatus | null): } export function sessionSearchCheckingMessage(): string { - return translate('sessionHistory.status.checking', 'Checking index…') + return translate('sessionHistory.status.checking', 'Checking…') } export function sessionSearchOffMessage(): string { - return translate('sessionHistory.status.off', 'Search is off. Any existing index copy is kept.') + return translate('sessionHistory.status.off', 'Off') } export function sessionSearchReadErrorMessage(): string { - return translate('sessionHistory.status.error', 'Could not read index status. Retrying…') + return translate('sessionHistory.status.error', 'Could not check status. Retrying…') } // IPC wraps a rejection's message, so the host-too-old marker arrives inside a longer string. diff --git a/src/renderer/src/components/settings/settings-setup-workflow-section-renderers.tsx b/src/renderer/src/components/settings/settings-setup-workflow-section-renderers.tsx index 861df90842d..884534ae0bb 100644 --- a/src/renderer/src/components/settings/settings-setup-workflow-section-renderers.tsx +++ b/src/renderer/src/components/settings/settings-setup-workflow-section-renderers.tsx @@ -188,7 +188,7 @@ export function renderSessionHistorySettingsSection( title={translate('sessionHistory.settings.title', 'Agent Session History')} description={translate( 'sessionHistory.settings.description', - 'Each computer keeps its own index of the transcripts it owns. Turn on indexing here for this computer and for any paired Orca server.' + 'Search everything your agents have said and done, on this computer and on any paired Orca server.' )} searchEntries={navigation.getSectionSearchEntries('session-history')} > diff --git a/src/renderer/src/components/settings/use-session-search-status.test.tsx b/src/renderer/src/components/settings/use-session-search-status.test.tsx index b1d5558cc99..3b1558e7cc2 100644 --- a/src/renderer/src/components/settings/use-session-search-status.test.tsx +++ b/src/renderer/src/components/settings/use-session-search-status.test.tsx @@ -61,12 +61,12 @@ it('keeps polling a settled index so counts stay live between sweeps', async () const view = poll() await act(async () => {}) expect(mocks.status).toHaveBeenCalledWith('local') - expect(message(view.result.current.status)).toBe('Up to date · 12 files indexed') + expect(message(view.result.current.status)).toBe('Ready · 12 sessions searchable') mocks.status.mockResolvedValue({ ...current, filesIndexed: 30 }) await act(async () => { await vi.advanceTimersByTimeAsync(10_000) }) - expect(message(view.result.current.status)).toBe('Up to date · 30 files indexed') + expect(message(view.result.current.status)).toBe('Ready · 30 sessions searchable') }) it('reports a first scan by count and later sweeps by percentage', async () => { @@ -79,10 +79,8 @@ it('reports a first scan by count and later sweeps by percentage', async () => { }) const view = poll() await act(async () => {}) - expect(message(view.result.current.status)).toBe('Indexing… 4 files so far') - expect(sessionSearchStatusDetails(view.result.current.status)).toContain( - 'Turn off search to stop. Progress is kept and resumes when you turn it back on.' - ) + expect(message(view.result.current.status)).toBe('Preparing search · 4 sessions so far') + expect(sessionSearchStatusDetails(view.result.current.status)).toEqual([]) mocks.status.mockResolvedValue({ ...current, phase: 'indexing', @@ -94,7 +92,7 @@ it('reports a first scan by count and later sweeps by percentage', async () => { await act(async () => { await vi.advanceTimersByTimeAsync(2_000) }) - expect(message(view.result.current.status)).toBe('Indexing · 40% · 4 of 10 files') + expect(message(view.result.current.status)).toBe('Preparing search · 40% · 4 of 10 sessions') }) it('polls a sweep faster than a settled index', async () => { @@ -119,11 +117,10 @@ it('names unreadable files while degraded and still reports progress', async () }) const view = poll() await act(async () => {}) - expect(message(view.result.current.status)).toBe('Indexing · 80% · 8 of 10 files') + expect(message(view.result.current.status)).toBe('Preparing search · 80% · 8 of 10 sessions') expect(sessionSearchStatusDetails(view.result.current.status)).toEqual([ - '1 files could not be read and will be retried.', - 'Turn off search to stop. Progress is kept and resumes when you turn it back on.', - 'Unverified source roots: 1' + '1 sessions could not be read and will be retried.', + '1 session folders could not be checked.' ]) }) @@ -137,9 +134,9 @@ it('calls a drained degraded index up to date', async () => { }) const view = poll() await act(async () => {}) - expect(message(view.result.current.status)).toBe('Up to date · 9 files indexed') + expect(message(view.result.current.status)).toBe('Ready · 9 sessions searchable') expect(sessionSearchStatusDetails(view.result.current.status)).toEqual([ - '2 files could not be read and will be retried.' + '2 sessions could not be read and will be retried.' ]) }) @@ -148,7 +145,7 @@ it('does not describe an absent service as an empty current index', async () => const view = poll() await act(async () => {}) expect(message(view.result.current.status)).toBe( - 'Index is not ready or the search service is unavailable.' + 'Search is not available on this computer right now.' ) }) diff --git a/src/renderer/src/hooks/settings-navigation-workflow-sections.ts b/src/renderer/src/hooks/settings-navigation-workflow-sections.ts index 5e4414a2434..73c4210b32b 100644 --- a/src/renderer/src/hooks/settings-navigation-workflow-sections.ts +++ b/src/renderer/src/hooks/settings-navigation-workflow-sections.ts @@ -74,15 +74,15 @@ export function buildWorkflowSettingsSections( title: translate('sessionHistory.settings.title', 'Agent Session History'), description: translate( 'sessionHistory.settings.description', - 'Each computer keeps its own index of the transcripts it owns. Turn on indexing here for this computer and for any paired Orca server.' + 'Search everything your agents have said and done, on this computer and on any paired Orca server.' ), icon: History, searchEntries: [ { - title: translate('sessionHistory.settings.indexComputers', 'Index agent sessions'), + title: translate('sessionHistory.settings.indexComputers', 'Search agent sessions'), description: translate( 'sessionHistory.settings.searchDescription', - 'Transcript indexing on this computer and paired servers, index status and delete index.' + 'Turn on session search for this computer and paired servers, or clear search data.' ) } ], diff --git a/src/renderer/src/i18n/locales/en.json b/src/renderer/src/i18n/locales/en.json index c0a3c69b79a..25ad0067e1e 100644 --- a/src/renderer/src/i18n/locales/en.json +++ b/src/renderer/src/i18n/locales/en.json @@ -17942,47 +17942,46 @@ }, "sessionHistory": { "status": { - "checking": "Checking index…", - "off": "Search is off. Any existing index copy is kept.", - "error": "Could not read index status. Retrying…", - "unavailable": "Index is not ready or the search service is unavailable.", - "firstScan": "Indexing… {{indexed}} files so far", - "progress": "Indexing · {{percent}}% · {{indexed}} of {{total}} files", - "upToDate": "Up to date · {{indexed}} files indexed", - "unreadable": "{{failed}} files could not be read and will be retried.", - "stopHint": "Turn off search to stop. Progress is kept and resumes when you turn it back on.", - "roots": "Unverified source roots: {{roots}}" + "checking": "Checking…", + "off": "Off", + "error": "Could not check status. Retrying…", + "unavailable": "Search is not available on this computer right now.", + "firstScan": "Preparing search · {{indexed}} sessions so far", + "progress": "Preparing search · {{percent}}% · {{indexed}} of {{total}} sessions", + "upToDate": "Ready · {{indexed}} sessions searchable", + "unreadable": "{{failed}} sessions could not be read and will be retried.", + "roots": "{{roots}} session folders could not be checked." }, "settings": { - "saveError": "Could not save session search settings. Try again.", - "enableTitle": "Start indexing agent sessions?", - "enableConsent": "Orca will build a local search index on this computer. It copies conversation text and tool output from agent transcripts as written; content is not redacted. Indexing starts now, runs in the background, and the first scan can take several minutes. You can turn it off at any time; progress is kept.", - "enableConfirm": "Start indexing", + "saveError": "Could not save. Try again.", + "enableTitle": "Turn on session search?", + "enableConsent": "Orca will make your past agent conversations and tool output on this computer searchable from Agent Session History. It stays on this computer. The first pass runs in the background and can take a few minutes.", + "enableConfirm": "Turn on", "advanced": "Advanced", - "deleteIndexCopy": "Delete index copy", - "deleteTitle": "Delete this computer’s search index?", - "deleteEnabled": "Turn off search on this computer and remove its index. Original transcripts are not touched. Switch search back on to rebuild.", - "deleteDisabled": "Remove the search index from this computer. Original transcripts are not touched. Search stays off.", - "delete": "Delete index", - "cleared": "Search index cleared. Original transcripts were kept.", - "clearError": "Could not clear the index. Try again.", - "webUnsupported": "Manage indexing in the Orca desktop app on the computer that owns the transcripts. These controls are unavailable from a paired client.", + "deleteIndexCopy": "Clear search data", + "deleteTitle": "Clear search data on this computer?", + "deleteEnabled": "Turns off search and removes the searchable copy from this computer. Your agent sessions are not affected.", + "deleteDisabled": "Removes the searchable copy from this computer. Your agent sessions are not affected.", + "delete": "Clear", + "cleared": "Search data cleared.", + "clearError": "Could not clear search data. Try again.", + "webUnsupported": "Turn on session search from the Orca desktop app on that computer.", "title": "Agent Session History", - "description": "Each computer keeps its own index of the transcripts it owns. Turn on indexing here for this computer and for any paired Orca server.", - "searchDescription": "Transcript indexing on this computer and paired servers, index status and delete index.", - "indexComputers": "Index agent sessions", - "computersConsent": "Each computer keeps a local index of its own transcripts, including conversation text and tool output as written. Content is not redacted. Turning a computer off stops indexing and keeps its index.", - "sshNote": "SSH hosts appear here once indexing is available on SSH.", + "description": "Search everything your agents have said and done, on this computer and on any paired Orca server.", + "searchDescription": "Turn on session search for this computer and paired servers, or clear search data.", + "indexComputers": "Search agent sessions", + "computersConsent": "Each computer keeps a searchable copy of its own agent conversations and tool output. Nothing leaves that computer.", "serverVersion": "Orca v{{version}}", - "rowSwitchLabel": "Index sessions on {{host}}", - "serverOffline": "Offline · index kept as it was", - "serverTooOld": "Update this server to enable session search.", + "rowSwitchLabel": "Search sessions on {{host}}", + "serverOffline": "Offline", + "serverTooOld": "Needs a newer version of Orca.", "updateServer": "Update server", "serverOff": "Off", - "serverEnableTitle": "Start indexing agent sessions on {{host}}?", - "serverEnableConsent": "Orca will build a search index on {{host}}. This client only receives search results. It copies conversation text and tool output from agent transcripts as written; content is not redacted. Indexing starts now, runs in the background, and the first scan can take several minutes. You can turn it off at any time; progress is kept.", + "serverEnableTitle": "Turn on session search on {{host}}?", + "serverEnableConsent": "Orca will make the agent conversations and tool output on {{host}} searchable from Agent Session History. The searchable copy stays on {{host}}; results are sent to this computer when you search. The first pass runs in the background and can take a few minutes.", "serverToggleError": "Could not change session search on {{host}}. Try again.", - "clearedAndTurnedOff": "Search is off and the index was deleted. Original transcripts were kept." + "clearedAndTurnedOff": "Search turned off and search data cleared.", + "panelHint": "Search from the Agent Session History panel in the sidebar." } }, "aiVault": {