@namzu/cli 26.3.0 → 27.0.0

package/dist/integrations/sessions/conversation-search.d.ts

@@ -1,26 +1,27 @@
 import { type EvidenceRecordKind, type SessionId, type ToolContext, type ToolDefinition } from '@namzu/sdk';
-import type { ConversationContext } from './store.js';
+import { type ConversationContext } from './store.js';
 /** Successful archive retrievals quote earlier records; they are not new observations. */
 export declare const CONVERSATION_RETRIEVAL_TOOLS: readonly ["read_conversation", "search_conversation"];
 /** Stable capability guidance; include only when this host mounts both tools. */
-export declare const CONVERSATION_EVIDENCE_GUIDANCE = "## Conversation evidence\nWhen a question asks about an earlier observation, use the evidence already in context. If the detail is missing or clipped, use search_conversation to locate the original recorded output, then read_conversation for exact text beyond an excerpt. Pass a supplied recall continuation's cursor to search_conversation to continue from the scan's existing position. This works before compaction as well as after compaction or restart, within this conversation only. New searches omit successful search_conversation/read_conversation outputs, which repeat earlier records. To inspect those outputs themselves, start a new search with includeRetrievalResults=true. excerptComplete=true means the entire full-retained text part is already shown: reading the same unchanged part adds no text or independent evidence. False or absent means partial or unknown. This does not establish the truth of a prior claim or exhaust the conversation.\nA path following \"The full output was written to:\" identifies an internal backing file, not a workspace file. Recover its contents through search_conversation and read_conversation, which verify ownership and retained-byte integrity. Do not use bash, read or grep to bypass a workspace-path refusal when recovering archived output.\nrecordedAt is the event recorder\u2019s wall-clock time in Unix milliseconds, not the time its text became true. For compaction_shed it dates the copy, not the original observation. compaction_shed:summary identifies derived summary text, not an independent observation. Missing stamps stay unknown; clocks can move backwards or differ. Event seq orders one run only; UUIDs, file order and mtime do not establish cross-run chronology.\nFor what a file contained earlier, recover its earlier observation; reading or searching the current file cannot establish its past contents. For what is true now, inspect the current source when freshness matters. Do not substitute one time for the other. Report unavailable historical evidence honestly and never repeat a state-changing action to recover its output.";
+export declare const CONVERSATION_EVIDENCE_GUIDANCE = "## Conversation evidence\nWhen a question asks about an earlier observation, use the evidence already in context. If the detail is missing or clipped, use search_conversation to locate the original recorded output, then read_conversation for exact text beyond an excerpt. Pass a supplied recall continuation's cursor to search_conversation to continue from the scan's existing position. This works before compaction as well as after compaction or restart, within this conversation only. New searches omit successful search_conversation/read_conversation outputs, which repeat earlier records. To inspect those outputs themselves, start a new search with includeRetrievalResults=true. excerptComplete=true means the entire full-retained text part is already shown: reading the same unchanged part adds no text or independent evidence. False or absent means partial or unknown. This does not establish the truth of a prior claim or exhaust the conversation.\nA path following \"The full output was written to:\" identifies an internal backing file, not a workspace file. Recover its contents through search_conversation and read_conversation, which verify ownership and retained-byte integrity. Do not use bash, read or grep to bypass a workspace-path refusal when recovering archived output.\nrecordedAt is the event recorder\u2019s wall-clock time in Unix milliseconds, not the time its text became true. For compaction_shed it dates the copy, not the original observation. compaction_shed:summary identifies derived summary text, not an independent observation. Missing stamps stay unknown; clocks can move backwards or differ. seq orders the records of this conversation's log; it is not a clock.\nFor what a file contained earlier, recover its earlier observation; reading or searching the current file cannot establish its past contents. For what is true now, inspect the current source when freshness matters. Do not substitute one time for the other. Report unavailable historical evidence honestly and never repeat a state-changing action to recover its output.";
+/** The part of a tool call's context that can hand over the live turn's evidence. */
+export type ActiveEvidence = Pick<ToolContext, 'sessionId' | 'turnId' | 'captureSessionEvidence'>;
 interface EvidenceMatch {
     /** Stored event wall-clock Unix milliseconds; not original fact time. */
     recordedAt?: number;
-    runId: string;
     seq: number;
     source: string;
     /** Producer classification only, not a truth or successful-action verdict. */
     recordKind: EvidenceRecordKind;
     text: string;
-    /** Zero-based textual part within this event (not a character offset). */
+    /** Zero-based textual part within this record (not a character offset). */
     part: number;
-    /** Optional UTF-8 position to begin reading near this indexed match. */
+    /** Optional UTF-8 position to begin reading near this match. */
     byteOffset?: number;
     retained?: 'full' | 'preview';
     /** True only when this excerpt covers the entire full-retained text part. */
     excerptComplete?: boolean;
-    /** Originating tool, when the authenticated event provides it. */
+    /** Originating tool, when the authenticated record provides it. */
     toolName?: string;
     isError?: boolean;
 }
@@ -29,11 +30,11 @@ export interface ConversationSearchResult {
     guidance: string;
     recordKindGuidance: string;
     matches: EvidenceMatch[];
-    scannedRuns: number;
     scannedBytes: number;
     /** True means the search cannot establish that absent evidence does not exist. */
     incomplete: boolean;
-    unavailableRuns: number;
+    /** Records the reader could not verify or read back in this page. */
+    unavailable: number;
     /** Successful tool outputs omitted by the host's source filter in this page. */
     excludedToolResults?: number;
     /** Known derived-summary visits omitted by a focused scan. */
@@ -43,27 +44,24 @@ export interface ConversationSearchResult {
 }
 /** Release process-local search resources after the host has settled this conversation's work. */
 export declare function releaseConversationEvidence(sessions: ConversationContext, sessionId: SessionId): Promise<void>;
-/** Bridge an already validated writer search to the ordinary scoped search tool. */
-export declare function retainLiveConversationSearch(sessions: ConversationContext, sessionId: SessionId, runId: string, terms: readonly string[], indexCursor: string, omitted?: boolean, matchMode?: 'literal' | 'token', excludeSuccessfulTools?: readonly string[], excludeDerivedSummaries?: boolean): string;
-/** Searches only local runs of the host-selected conversation, never arbitrary paths. */
+/** Searches only the host-selected conversation's log, never arbitrary paths. */
 export declare function searchConversation(sessions: ConversationContext, sessionId: SessionId, input: {
     query?: string;
     caseSensitive?: boolean;
-    runId?: string;
+    turnId?: string;
     limit?: number;
     cursor?: string;
     includeRetrievalResults?: boolean;
-}, signal?: AbortSignal, active?: Pick<ToolContext, 'runId' | 'captureRunEvidence'>): Promise<ConversationSearchResult>;
+}, signal?: AbortSignal, active?: ActiveEvidence): Promise<ConversationSearchResult>;
 /** Host-only bounded candidate discovery; does not change the model tool schema. */
 export declare function searchConversationTerms(sessions: ConversationContext, sessionId: SessionId, input: {
     terms: readonly string[];
-    excludeRunId: string;
     maxReadBytes: number;
     cursor?: string;
     matchMode?: 'literal' | 'token';
     excludeSuccessfulTools?: readonly string[];
     excludeDerivedSummaries?: boolean;
-}, signal?: AbortSignal): Promise<ConversationSearchResult>;
+}, signal?: AbortSignal, active?: ActiveEvidence): Promise<ConversationSearchResult>;
 export declare function buildConversationSearchTool(resolveScope: (context: ToolContext) => {
     sessions: ConversationContext;
     sessionId: SessionId;
@@ -71,10 +69,9 @@ export declare function buildConversationSearchTool(resolveScope: (context: Tool
 export interface ConversationEvidencePage {
     /** Stored event wall-clock Unix milliseconds; unknown when absent. */
     recordedAt?: number;
-    runId: string;
     seq: number;
     part: number;
-    /** Exact retained text, paged without summarization. Empty while scanning. */
+    /** Exact retained text, paged without summarization. Empty while locating. */
     text: string;
     offset: number;
     totalChars?: number;
@@ -92,14 +89,13 @@ export interface ConversationEvidencePage {
     retainedPreview: boolean;
     nextCursor?: string;
 }
-/** Read a recorded text by durable run/event/part identity, within the current conversation. */
+/** Read a recorded text by durable seq/part identity, within the current conversation. */
 export declare function readConversationEvidence(sessions: ConversationContext, sessionId: SessionId, input: {
-    runId: string;
     seq: number;
     part?: number;
     cursor?: string;
     byteOffset?: number;
-}, signal?: AbortSignal, active?: Pick<ToolContext, 'runId' | 'captureRunEvidence'>): Promise<ConversationEvidencePage>;
+}, signal?: AbortSignal, active?: ActiveEvidence): Promise<ConversationEvidencePage>;
 export declare function buildConversationReadTool(resolveScope: (context: ToolContext) => {
     sessions: ConversationContext;
     sessionId: SessionId;

package/dist/integrations/sessions/conversation-search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-search.d.ts","sourceRoot":"","sources":["../../../src/integrations/sessions/conversation-search.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"conversation-search.d.ts","sourceRoot":"","sources":["../../../src/integrations/sessions/conversation-search.ts"],"names":[],"mappings":"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"}