@codex-native/sdk 0.0.23 → 0.0.25

package/dist/index.d.mts

@@ -284,6 +284,79 @@ type TurnOptions = {
     modelProvider?: string;
 };
 
+type NativeUserInputItem = {
+    type: "text";
+    text: string;
+} | {
+    type: "local_image";
+    path: string;
+} | {
+    type: "skill_inline";
+    name: string;
+    contents: string;
+};
+type NativeRunRequest = {
+    prompt: string;
+    threadId?: string;
+    inputItems?: NativeUserInputItem[];
+    images?: string[];
+    model?: string;
+    modelProvider?: string;
+    oss?: boolean;
+    sandboxMode?: SandboxMode;
+    approvalMode?: ApprovalMode;
+    workspaceWriteOptions?: WorkspaceWriteOptions;
+    workingDirectory?: string;
+    skipGitRepoCheck?: boolean;
+    outputSchema?: unknown;
+    baseUrl?: string;
+    apiKey?: string;
+    linuxSandboxPath?: string;
+    reasoningEffort?: ReasoningEffort;
+    reasoningSummary?: ReasoningSummary;
+    /** @deprecated Use sandboxMode and approvalMode instead */
+    fullAuto?: boolean;
+    reviewMode?: boolean;
+    reviewHint?: string;
+};
+type NativeForkRequest = {
+    threadId: string;
+    nthUserMessage: number;
+    model?: string;
+    modelProvider?: string;
+    oss?: boolean;
+    sandboxMode?: SandboxMode;
+    approvalMode?: ApprovalMode;
+    workspaceWriteOptions?: WorkspaceWriteOptions;
+    workingDirectory?: string;
+    skipGitRepoCheck?: boolean;
+    baseUrl?: string;
+    apiKey?: string;
+    linuxSandboxPath?: string;
+    fullAuto?: boolean;
+};
+type NativeConversationConfig = {
+    model?: string;
+    modelProvider?: string;
+    oss?: boolean;
+    sandboxMode?: SandboxMode;
+    approvalMode?: ApprovalMode;
+    workspaceWriteOptions?: WorkspaceWriteOptions;
+    workingDirectory?: string;
+    skipGitRepoCheck?: boolean;
+    baseUrl?: string;
+    apiKey?: string;
+    linuxSandboxPath?: string;
+    reasoningEffort?: ReasoningEffort;
+    reasoningSummary?: ReasoningSummary;
+    fullAuto?: boolean;
+};
+type NativeConversationListRequest = {
+    config?: NativeConversationConfig;
+    pageSize?: number;
+    cursor?: string;
+    modelProviders?: string[];
+};
 type NativeConversationSummary = {
     id: string;
     path: string;
@@ -296,6 +369,17 @@ type NativeConversationListPage = {
     numScannedFiles: number;
     reachedScanCap: boolean;
 };
+type NativeDeleteConversationRequest = {
+    id: string;
+    config?: NativeConversationConfig;
+};
+type NativeDeleteConversationResult = {
+    deleted: boolean;
+};
+type NativeResumeFromRolloutRequest = {
+    rolloutPath: string;
+    config?: NativeConversationConfig;
+};
 type NativeTuiRequest = {
     prompt?: string;
     images?: string[];
@@ -320,6 +404,47 @@ type NativeTuiRequest = {
     reasoningEffort?: ReasoningEffort;
     reasoningSummary?: ReasoningSummary;
 };
+type PlanStatus = "pending" | "in_progress" | "completed";
+type NativeEmitBackgroundEventRequest = {
+    threadId: string;
+    message: string;
+};
+type NativeEmitPlanUpdateRequest = {
+    threadId: string;
+    explanation?: string;
+    plan: Array<{
+        step: string;
+        status: PlanStatus;
+    }>;
+};
+type NativeModifyPlanRequest = {
+    threadId: string;
+    operations: PlanOperation[];
+};
+type PlanOperation = {
+    type: "add";
+    item: {
+        step: string;
+        status?: PlanStatus;
+    };
+} | {
+    type: "update";
+    index: number;
+    updates: {
+        step?: string;
+        status?: PlanStatus;
+    };
+} | {
+    type: "remove";
+    index: number;
+} | {
+    type: "reorder";
+    newOrder: number[];
+};
+type NativeToolInterceptorNativeContext = {
+    invocation: NativeToolInvocation;
+    token: string;
+};
 type NativeTokenUsage = {
     inputTokens: number;
     cachedInputTokens: number;
@@ -337,6 +462,11 @@ type NativeTuiExitInfo = {
     conversationId?: string;
     updateAction?: NativeUpdateActionInfo;
 };
+type NativeTuiSession = {
+    wait(): Promise<NativeTuiExitInfo>;
+    shutdown(): void;
+    readonly closed: boolean;
+};
 type RepoDiffFileChange = {
     path: string;
     status: string;
@@ -420,6 +550,62 @@ type TokenizerOptions = {
 type TokenizerEncodeOptions = TokenizerOptions & {
     withSpecialTokens?: boolean;
 };
+type NativeBinding = {
+    runThread(request: NativeRunRequest): Promise<string[]>;
+    runThreadStream(request: NativeRunRequest, onEvent: (err: unknown, eventJson?: string) => void): Promise<void>;
+    compactThread(request: NativeRunRequest): Promise<string[]>;
+    forkThread(request: NativeForkRequest): Promise<NativeForkResult>;
+    listConversations(request: NativeConversationListRequest): Promise<NativeConversationListPage>;
+    deleteConversation(request: NativeDeleteConversationRequest): Promise<NativeDeleteConversationResult>;
+    resumeConversationFromRollout(request: NativeResumeFromRolloutRequest): Promise<NativeForkResult>;
+    runTui(request: NativeTuiRequest): Promise<NativeTuiExitInfo>;
+    tuiTestRun?(request: {
+        width: number;
+        height: number;
+        viewport: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        };
+        lines: string[];
+    }): Promise<string[]>;
+    callToolBuiltin(token: string, invocation?: NativeToolInvocation): Promise<NativeToolResult>;
+    callRegisteredToolForTest?(toolName: string, invocation: NativeToolInvocation): Promise<NativeToolResult>;
+    clearRegisteredTools(): void;
+    registerTool(info: NativeToolInfo, handler: (call: NativeToolInvocation) => Promise<NativeToolResult> | NativeToolResult): void;
+    registerToolInterceptor(toolName: string, handler: (context: NativeToolInterceptorNativeContext) => Promise<NativeToolResult> | NativeToolResult): void;
+    listRegisteredTools(): NativeToolInfo[];
+    registerApprovalCallback?(handler: (request: ApprovalRequest) => boolean | Promise<boolean>): void;
+    emitBackgroundEvent(request: NativeEmitBackgroundEventRequest): Promise<void>;
+    emitPlanUpdate(request: NativeEmitPlanUpdateRequest): Promise<void>;
+    modifyPlan(request: NativeModifyPlanRequest): Promise<void>;
+    startTui?(request: NativeTuiRequest): NativeTuiSession;
+    ev_completed(id: string): string;
+    ev_response_created(id: string): string;
+    ev_assistant_message(id: string, text: string): string;
+    ev_function_call(callId: string, name: string, args: string): string;
+    sse(events: string[]): string;
+    ensureTokioRuntime?: () => void;
+    isTokioRuntimeAvailable?: () => boolean;
+    cloudTasksList?(env?: string, baseUrl?: string, apiKey?: string): Promise<string>;
+    cloudTasksGetDiff?(taskId: string, baseUrl?: string, apiKey?: string): Promise<string>;
+    cloudTasksApplyPreflight?(taskId: string, diffOverride?: string, baseUrl?: string, apiKey?: string): Promise<string>;
+    cloudTasksApply?(taskId: string, diffOverride?: string, baseUrl?: string, apiKey?: string): Promise<string>;
+    cloudTasksCreate?(envId: string, prompt: string, gitRef?: string, qaMode?: boolean, bestOfN?: number, baseUrl?: string, apiKey?: string): Promise<string>;
+    reverieListConversations(codexHomePath: string, limit?: number, offset?: number): Promise<ReverieConversation[]>;
+    reverieSearchConversations(codexHomePath: string, query: string, limit?: number): Promise<ReverieSearchResult[]>;
+    reverieSearchSemantic?(codexHomePath: string, context: string, options?: ReverieSemanticSearchOptions): Promise<ReverieSearchResult[]>;
+    reverieIndexSemantic?(codexHomePath: string, options?: ReverieSemanticSearchOptions): Promise<ReverieSemanticIndexStats>;
+    reverieGetConversationInsights(conversationPath: string, query?: string): Promise<string[]>;
+    toonEncode(value: unknown): string;
+    fastEmbedInit?(options: FastEmbedInitOptions): Promise<void>;
+    fastEmbedEmbed?(request: FastEmbedEmbedRequest): Promise<number[][]>;
+    tokenizerCount(text: string, options?: TokenizerOptions): number;
+    tokenizerEncode(text: string, options?: TokenizerEncodeOptions): number[];
+    tokenizerDecode(tokens: number[], options?: TokenizerOptions): string;
+    collectRepoDiffSummary?(cwd: string, baseBranchOverride?: string, options?: NativeRepoDiffOptions): Promise<RepoDiffSummary>;
+};
 type NativeToolInfo = {
     name: string;
     description?: string;
@@ -447,6 +633,12 @@ type ApprovalRequest = {
     details?: unknown;
     context?: string;
 };
+type NativeRepoDiffOptions = {
+    maxFiles?: number;
+    diffContextLines?: number;
+    diffCharLimit?: number;
+};
+declare function getNativeBinding(): NativeBinding | null;
 declare function reverieListConversations(codexHomePath: string, limit?: number, offset?: number): Promise<ReverieConversation[]>;
 declare function reverieSearchConversations(codexHomePath: string, query: string, limit?: number): Promise<ReverieSearchResult[]>;
 declare function reverieSearchSemantic(codexHomePath: string, context: string, options?: ReverieSemanticSearchOptions): Promise<ReverieSearchResult[]>;
@@ -998,7 +1190,7 @@ type ToolExecutorResult = string | NativeToolResult | {
     output?: string;
     error?: string;
     success?: boolean;
-} | void;
+} | Record<string, unknown> | unknown[] | number | boolean | null | void;
 type ToolExecutor = (context: ToolExecutionContext) => Promise<ToolExecutorResult> | ToolExecutorResult;
 declare function registerCodexToolExecutor(name: string, executor: ToolExecutor): void;
 declare function getCodexToolExecutor(name: string): ToolExecutor | undefined;
@@ -2306,4 +2498,4 @@ declare function evAssistantMessage(id: string, text: string): string;
 declare function evFunctionCall(callId: string, name: string, args: string): string;
 declare function sse(events: string[]): string;
 
-export { type AgentMessageItem, type AgentRunner, type ApprovalMode, type ApprovalRequest, type BranchLevelContext, type BranchReview, type CloudApplyOutcome, type CloudApplyStatus, type DiffSummary as CloudDiffSummary, type CloudTaskStatus, type CloudTaskSummary, CloudTasks, type CloudTasksOptions, Codex, type CodexOptions, CodexProvider, type CodexProviderOptions, type CodexToolOptions, type CommandExecutionItem, type CommandExecutionStatus, type CommitReview, type ConversationListOptions, type ConversationListPage, type ConversationSummary, type CurrentChangesReview, type CustomReview, DEFAULT_RERANKER_BATCH_SIZE, DEFAULT_RERANKER_TOP_K, DEFAULT_REVERIE_LIMIT, DEFAULT_REVERIE_MAX_CANDIDATES, DEFAULT_SERVERS, type DelegationResult, type DiagnosticSeverity, type ErrorItem, type FastEmbedEmbedRequest, type FastEmbedInitOptions, type FastEmbedRerankerModelCode, type FileChangeItem, type FileDiagnostics, type FileLevelContext, type FileUpdateChange, type ForkOptions, type FormatStreamOptions, type FormattedStream, type GradingOptions, type Input, type ItemCompletedEvent, type ItemStartedEvent, type ItemUpdatedEvent, type LogEntry, LogLevel, type LogOutput, type LogScope, Logger, type LoggerConfig, type LspDiagnosticSeverity, LspDiagnosticsBridge, LspManager, type LspManagerOptions, type LspServerConfig, type McpToolCallItem, type McpToolCallStatus, type NativeForkResult, type NativeTokenUsage, type NativeToolDefinition, type NativeToolInterceptorContext, type NativeToolInvocation, type NativeToolResult, type NativeTuiExitInfo, type NativeTuiRequest, type NativeUpdateActionInfo, type NativeUpdateActionKind, type NormalizedDiagnostic, OpenCodeAgent, type OpenCodeAgentOptions, type PatchApplyStatus, type PatchChangeKind, type PermissionDecision, type PermissionRequest, type ProjectLevelContext, type QualityFilterStats, REVERIE_CANDIDATE_MULTIPLIER, REVERIE_EMBED_MODEL, REVERIE_LLM_GRADE_THRESHOLD, REVERIE_RERANKER_MODEL, type ReasoningItem, type RepoDiffFileChange, type RepoDiffSummary, type RepoDiffSummaryOptions, type ReverieContext, type ReverieEpisodeSummary, type ReverieFilterStats, type ReverieInsight$1 as ReverieInsight, type ReveriePipelineOptions, type ReveriePipelineResult, type ReverieResult, type ReverieSearchLevel, type ReverieSearchOptions, type ReverieSemanticIndexStats, type ReverieSemanticSearchOptions, type ReviewInvocationOptions, type ReviewTarget, type RunResult, type RunStreamedResult, type RunTuiOptions, type SandboxMode, ScopedLogger, type SkillDefinition, type SkillMentionTrigger, Thread, type ThreadError, type ThreadErrorEvent, type ThreadEvent, type ThreadItem, type ThreadLoggingSink, type ThreadOptions, type ThreadStartedEvent, type TodoItem, type TodoListItem, type TokenizerEncodeOptions, type TokenizerOptions, type ToolCallEvent, type ToolExecutionContext, type ToolExecutor, type ToolExecutorResult, type TuiSession, type TurnCompletedEvent, type TurnFailedEvent, type TurnOptions, type TurnStartedEvent, type Usage, type UserInput, type WebSearchItem, type WorkspaceLocator, applyFileReveriePipeline, applyQualityPipeline, applyReveriePipeline, attachLspDiagnostics, buildBranchContext, buildFileContext, buildProjectContext, clearCodexToolExecutors, codexTool, collectRepoDiffSummary, contextToQuery, createThreadLogger, deduplicateReverieInsights, encodeToToon, evAssistantMessage, evCompleted, evFunctionCall, evResponseCreated, extractKeySymbols, fastEmbedEmbed, fastEmbedInit, filterBySeverity, findServerForFile, formatDiagnosticsForBackgroundEvent, formatDiagnosticsForTool, formatDiagnosticsWithSummary, formatFileList, formatStream, getCodexToolExecutor, gradeReverieRelevance, gradeReveriesInParallel, isValidReverieExcerpt, logApprovedReveries, logLLMGrading, logLevelResults, logMultiLevelSearch, logMultiLevelSummary, logReverieFiltering, logReverieHintQuality, logReverieInsights, logReverieSearch, logger, registerCodexToolExecutor, resolveWorkspaceRoot, reverieGetConversationInsights, reverieIndexSemantic, reverieListConversations, reverieSearchConversations, reverieSearchSemantic, runThreadTurnWithLogs, runTui, searchBranchLevel, searchFileLevel, searchMultiLevel, searchProjectLevel, searchReveries, sse, startTui, summarizeDiagnostics, tokenizerCount, tokenizerDecode, tokenizerEncode, truncate as truncateText };
+export { type AgentMessageItem, type AgentRunner, type ApprovalMode, type ApprovalRequest, type BranchLevelContext, type BranchReview, type CloudApplyOutcome, type CloudApplyStatus, type DiffSummary as CloudDiffSummary, type CloudTaskStatus, type CloudTaskSummary, CloudTasks, type CloudTasksOptions, Codex, type CodexOptions, CodexProvider, type CodexProviderOptions, type CodexToolOptions, type CommandExecutionItem, type CommandExecutionStatus, type CommitReview, type ConversationListOptions, type ConversationListPage, type ConversationSummary, type CurrentChangesReview, type CustomReview, DEFAULT_RERANKER_BATCH_SIZE, DEFAULT_RERANKER_TOP_K, DEFAULT_REVERIE_LIMIT, DEFAULT_REVERIE_MAX_CANDIDATES, DEFAULT_SERVERS, type DelegationResult, type DiagnosticSeverity, type ErrorItem, type FastEmbedEmbedRequest, type FastEmbedInitOptions, type FastEmbedRerankerModelCode, type FileChangeItem, type FileDiagnostics, type FileLevelContext, type FileUpdateChange, type ForkOptions, type FormatStreamOptions, type FormattedStream, type GradingOptions, type Input, type ItemCompletedEvent, type ItemStartedEvent, type ItemUpdatedEvent, type LogEntry, LogLevel, type LogOutput, type LogScope, Logger, type LoggerConfig, type LspDiagnosticSeverity, LspDiagnosticsBridge, LspManager, type LspManagerOptions, type LspServerConfig, type McpToolCallItem, type McpToolCallStatus, type NativeForkResult, type NativeTokenUsage, type NativeToolDefinition, type NativeToolInterceptorContext, type NativeToolInvocation, type NativeToolResult, type NativeTuiExitInfo, type NativeTuiRequest, type NativeUpdateActionInfo, type NativeUpdateActionKind, type NormalizedDiagnostic, OpenCodeAgent, type OpenCodeAgentOptions, type PatchApplyStatus, type PatchChangeKind, type PermissionDecision, type PermissionRequest, type ProjectLevelContext, type QualityFilterStats, REVERIE_CANDIDATE_MULTIPLIER, REVERIE_EMBED_MODEL, REVERIE_LLM_GRADE_THRESHOLD, REVERIE_RERANKER_MODEL, type ReasoningItem, type RepoDiffFileChange, type RepoDiffSummary, type RepoDiffSummaryOptions, type ReverieContext, type ReverieEpisodeSummary, type ReverieFilterStats, type ReverieInsight$1 as ReverieInsight, type ReveriePipelineOptions, type ReveriePipelineResult, type ReverieResult, type ReverieSearchLevel, type ReverieSearchOptions, type ReverieSemanticIndexStats, type ReverieSemanticSearchOptions, type ReviewInvocationOptions, type ReviewTarget, type RunResult, type RunStreamedResult, type RunTuiOptions, type SandboxMode, ScopedLogger, type SkillDefinition, type SkillMentionTrigger, Thread, type ThreadError, type ThreadErrorEvent, type ThreadEvent, type ThreadItem, type ThreadLoggingSink, type ThreadOptions, type ThreadStartedEvent, type TodoItem, type TodoListItem, type TokenizerEncodeOptions, type TokenizerOptions, type ToolCallEvent, type ToolExecutionContext, type ToolExecutor, type ToolExecutorResult, type TuiSession, type TurnCompletedEvent, type TurnFailedEvent, type TurnOptions, type TurnStartedEvent, type Usage, type UserInput, type WebSearchItem, type WorkspaceLocator, applyFileReveriePipeline, applyQualityPipeline, applyReveriePipeline, attachLspDiagnostics, buildBranchContext, buildFileContext, buildProjectContext, clearCodexToolExecutors, codexTool, collectRepoDiffSummary, contextToQuery, createThreadLogger, deduplicateReverieInsights, encodeToToon, evAssistantMessage, evCompleted, evFunctionCall, evResponseCreated, extractKeySymbols, fastEmbedEmbed, fastEmbedInit, filterBySeverity, findServerForFile, formatDiagnosticsForBackgroundEvent, formatDiagnosticsForTool, formatDiagnosticsWithSummary, formatFileList, formatStream, getCodexToolExecutor, getNativeBinding, gradeReverieRelevance, gradeReveriesInParallel, isValidReverieExcerpt, logApprovedReveries, logLLMGrading, logLevelResults, logMultiLevelSearch, logMultiLevelSummary, logReverieFiltering, logReverieHintQuality, logReverieInsights, logReverieSearch, logger, registerCodexToolExecutor, resolveWorkspaceRoot, reverieGetConversationInsights, reverieIndexSemantic, reverieListConversations, reverieSearchConversations, reverieSearchSemantic, runThreadTurnWithLogs, runTui, searchBranchLevel, searchFileLevel, searchMultiLevel, searchProjectLevel, searchReveries, sse, startTui, summarizeDiagnostics, tokenizerCount, tokenizerDecode, tokenizerEncode, truncate as truncateText };

package/dist/index.d.ts

@@ -284,6 +284,79 @@ type TurnOptions = {
     modelProvider?: string;
 };
 
+type NativeUserInputItem = {
+    type: "text";
+    text: string;
+} | {
+    type: "local_image";
+    path: string;
+} | {
+    type: "skill_inline";
+    name: string;
+    contents: string;
+};
+type NativeRunRequest = {
+    prompt: string;
+    threadId?: string;
+    inputItems?: NativeUserInputItem[];
+    images?: string[];
+    model?: string;
+    modelProvider?: string;
+    oss?: boolean;
+    sandboxMode?: SandboxMode;
+    approvalMode?: ApprovalMode;
+    workspaceWriteOptions?: WorkspaceWriteOptions;
+    workingDirectory?: string;
+    skipGitRepoCheck?: boolean;
+    outputSchema?: unknown;
+    baseUrl?: string;
+    apiKey?: string;
+    linuxSandboxPath?: string;
+    reasoningEffort?: ReasoningEffort;
+    reasoningSummary?: ReasoningSummary;
+    /** @deprecated Use sandboxMode and approvalMode instead */
+    fullAuto?: boolean;
+    reviewMode?: boolean;
+    reviewHint?: string;
+};
+type NativeForkRequest = {
+    threadId: string;
+    nthUserMessage: number;
+    model?: string;
+    modelProvider?: string;
+    oss?: boolean;
+    sandboxMode?: SandboxMode;
+    approvalMode?: ApprovalMode;
+    workspaceWriteOptions?: WorkspaceWriteOptions;
+    workingDirectory?: string;
+    skipGitRepoCheck?: boolean;
+    baseUrl?: string;
+    apiKey?: string;
+    linuxSandboxPath?: string;
+    fullAuto?: boolean;
+};
+type NativeConversationConfig = {
+    model?: string;
+    modelProvider?: string;
+    oss?: boolean;
+    sandboxMode?: SandboxMode;
+    approvalMode?: ApprovalMode;
+    workspaceWriteOptions?: WorkspaceWriteOptions;
+    workingDirectory?: string;
+    skipGitRepoCheck?: boolean;
+    baseUrl?: string;
+    apiKey?: string;
+    linuxSandboxPath?: string;
+    reasoningEffort?: ReasoningEffort;
+    reasoningSummary?: ReasoningSummary;
+    fullAuto?: boolean;
+};
+type NativeConversationListRequest = {
+    config?: NativeConversationConfig;
+    pageSize?: number;
+    cursor?: string;
+    modelProviders?: string[];
+};
 type NativeConversationSummary = {
     id: string;
     path: string;
@@ -296,6 +369,17 @@ type NativeConversationListPage = {
     numScannedFiles: number;
     reachedScanCap: boolean;
 };
+type NativeDeleteConversationRequest = {
+    id: string;
+    config?: NativeConversationConfig;
+};
+type NativeDeleteConversationResult = {
+    deleted: boolean;
+};
+type NativeResumeFromRolloutRequest = {
+    rolloutPath: string;
+    config?: NativeConversationConfig;
+};
 type NativeTuiRequest = {
     prompt?: string;
     images?: string[];
@@ -320,6 +404,47 @@ type NativeTuiRequest = {
     reasoningEffort?: ReasoningEffort;
     reasoningSummary?: ReasoningSummary;
 };
+type PlanStatus = "pending" | "in_progress" | "completed";
+type NativeEmitBackgroundEventRequest = {
+    threadId: string;
+    message: string;
+};
+type NativeEmitPlanUpdateRequest = {
+    threadId: string;
+    explanation?: string;
+    plan: Array<{
+        step: string;
+        status: PlanStatus;
+    }>;
+};
+type NativeModifyPlanRequest = {
+    threadId: string;
+    operations: PlanOperation[];
+};
+type PlanOperation = {
+    type: "add";
+    item: {
+        step: string;
+        status?: PlanStatus;
+    };
+} | {
+    type: "update";
+    index: number;
+    updates: {
+        step?: string;
+        status?: PlanStatus;
+    };
+} | {
+    type: "remove";
+    index: number;
+} | {
+    type: "reorder";
+    newOrder: number[];
+};
+type NativeToolInterceptorNativeContext = {
+    invocation: NativeToolInvocation;
+    token: string;
+};
 type NativeTokenUsage = {
     inputTokens: number;
     cachedInputTokens: number;
@@ -337,6 +462,11 @@ type NativeTuiExitInfo = {
     conversationId?: string;
     updateAction?: NativeUpdateActionInfo;
 };
+type NativeTuiSession = {
+    wait(): Promise<NativeTuiExitInfo>;
+    shutdown(): void;
+    readonly closed: boolean;
+};
 type RepoDiffFileChange = {
     path: string;
     status: string;
@@ -420,6 +550,62 @@ type TokenizerOptions = {
 type TokenizerEncodeOptions = TokenizerOptions & {
     withSpecialTokens?: boolean;
 };
+type NativeBinding = {
+    runThread(request: NativeRunRequest): Promise<string[]>;
+    runThreadStream(request: NativeRunRequest, onEvent: (err: unknown, eventJson?: string) => void): Promise<void>;
+    compactThread(request: NativeRunRequest): Promise<string[]>;
+    forkThread(request: NativeForkRequest): Promise<NativeForkResult>;
+    listConversations(request: NativeConversationListRequest): Promise<NativeConversationListPage>;
+    deleteConversation(request: NativeDeleteConversationRequest): Promise<NativeDeleteConversationResult>;
+    resumeConversationFromRollout(request: NativeResumeFromRolloutRequest): Promise<NativeForkResult>;
+    runTui(request: NativeTuiRequest): Promise<NativeTuiExitInfo>;
+    tuiTestRun?(request: {
+        width: number;
+        height: number;
+        viewport: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        };
+        lines: string[];
+    }): Promise<string[]>;
+    callToolBuiltin(token: string, invocation?: NativeToolInvocation): Promise<NativeToolResult>;
+    callRegisteredToolForTest?(toolName: string, invocation: NativeToolInvocation): Promise<NativeToolResult>;
+    clearRegisteredTools(): void;
+    registerTool(info: NativeToolInfo, handler: (call: NativeToolInvocation) => Promise<NativeToolResult> | NativeToolResult): void;
+    registerToolInterceptor(toolName: string, handler: (context: NativeToolInterceptorNativeContext) => Promise<NativeToolResult> | NativeToolResult): void;
+    listRegisteredTools(): NativeToolInfo[];
+    registerApprovalCallback?(handler: (request: ApprovalRequest) => boolean | Promise<boolean>): void;
+    emitBackgroundEvent(request: NativeEmitBackgroundEventRequest): Promise<void>;
+    emitPlanUpdate(request: NativeEmitPlanUpdateRequest): Promise<void>;
+    modifyPlan(request: NativeModifyPlanRequest): Promise<void>;
+    startTui?(request: NativeTuiRequest): NativeTuiSession;
+    ev_completed(id: string): string;
+    ev_response_created(id: string): string;
+    ev_assistant_message(id: string, text: string): string;
+    ev_function_call(callId: string, name: string, args: string): string;
+    sse(events: string[]): string;
+    ensureTokioRuntime?: () => void;
+    isTokioRuntimeAvailable?: () => boolean;
+    cloudTasksList?(env?: string, baseUrl?: string, apiKey?: string): Promise<string>;
+    cloudTasksGetDiff?(taskId: string, baseUrl?: string, apiKey?: string): Promise<string>;
+    cloudTasksApplyPreflight?(taskId: string, diffOverride?: string, baseUrl?: string, apiKey?: string): Promise<string>;
+    cloudTasksApply?(taskId: string, diffOverride?: string, baseUrl?: string, apiKey?: string): Promise<string>;
+    cloudTasksCreate?(envId: string, prompt: string, gitRef?: string, qaMode?: boolean, bestOfN?: number, baseUrl?: string, apiKey?: string): Promise<string>;
+    reverieListConversations(codexHomePath: string, limit?: number, offset?: number): Promise<ReverieConversation[]>;
+    reverieSearchConversations(codexHomePath: string, query: string, limit?: number): Promise<ReverieSearchResult[]>;
+    reverieSearchSemantic?(codexHomePath: string, context: string, options?: ReverieSemanticSearchOptions): Promise<ReverieSearchResult[]>;
+    reverieIndexSemantic?(codexHomePath: string, options?: ReverieSemanticSearchOptions): Promise<ReverieSemanticIndexStats>;
+    reverieGetConversationInsights(conversationPath: string, query?: string): Promise<string[]>;
+    toonEncode(value: unknown): string;
+    fastEmbedInit?(options: FastEmbedInitOptions): Promise<void>;
+    fastEmbedEmbed?(request: FastEmbedEmbedRequest): Promise<number[][]>;
+    tokenizerCount(text: string, options?: TokenizerOptions): number;
+    tokenizerEncode(text: string, options?: TokenizerEncodeOptions): number[];
+    tokenizerDecode(tokens: number[], options?: TokenizerOptions): string;
+    collectRepoDiffSummary?(cwd: string, baseBranchOverride?: string, options?: NativeRepoDiffOptions): Promise<RepoDiffSummary>;
+};
 type NativeToolInfo = {
     name: string;
     description?: string;
@@ -447,6 +633,12 @@ type ApprovalRequest = {
     details?: unknown;
     context?: string;
 };
+type NativeRepoDiffOptions = {
+    maxFiles?: number;
+    diffContextLines?: number;
+    diffCharLimit?: number;
+};
+declare function getNativeBinding(): NativeBinding | null;
 declare function reverieListConversations(codexHomePath: string, limit?: number, offset?: number): Promise<ReverieConversation[]>;
 declare function reverieSearchConversations(codexHomePath: string, query: string, limit?: number): Promise<ReverieSearchResult[]>;
 declare function reverieSearchSemantic(codexHomePath: string, context: string, options?: ReverieSemanticSearchOptions): Promise<ReverieSearchResult[]>;
@@ -998,7 +1190,7 @@ type ToolExecutorResult = string | NativeToolResult | {
     output?: string;
     error?: string;
     success?: boolean;
-} | void;
+} | Record<string, unknown> | unknown[] | number | boolean | null | void;
 type ToolExecutor = (context: ToolExecutionContext) => Promise<ToolExecutorResult> | ToolExecutorResult;
 declare function registerCodexToolExecutor(name: string, executor: ToolExecutor): void;
 declare function getCodexToolExecutor(name: string): ToolExecutor | undefined;
@@ -2306,4 +2498,4 @@ declare function evAssistantMessage(id: string, text: string): string;
 declare function evFunctionCall(callId: string, name: string, args: string): string;
 declare function sse(events: string[]): string;
 
-export { type AgentMessageItem, type AgentRunner, type ApprovalMode, type ApprovalRequest, type BranchLevelContext, type BranchReview, type CloudApplyOutcome, type CloudApplyStatus, type DiffSummary as CloudDiffSummary, type CloudTaskStatus, type CloudTaskSummary, CloudTasks, type CloudTasksOptions, Codex, type CodexOptions, CodexProvider, type CodexProviderOptions, type CodexToolOptions, type CommandExecutionItem, type CommandExecutionStatus, type CommitReview, type ConversationListOptions, type ConversationListPage, type ConversationSummary, type CurrentChangesReview, type CustomReview, DEFAULT_RERANKER_BATCH_SIZE, DEFAULT_RERANKER_TOP_K, DEFAULT_REVERIE_LIMIT, DEFAULT_REVERIE_MAX_CANDIDATES, DEFAULT_SERVERS, type DelegationResult, type DiagnosticSeverity, type ErrorItem, type FastEmbedEmbedRequest, type FastEmbedInitOptions, type FastEmbedRerankerModelCode, type FileChangeItem, type FileDiagnostics, type FileLevelContext, type FileUpdateChange, type ForkOptions, type FormatStreamOptions, type FormattedStream, type GradingOptions, type Input, type ItemCompletedEvent, type ItemStartedEvent, type ItemUpdatedEvent, type LogEntry, LogLevel, type LogOutput, type LogScope, Logger, type LoggerConfig, type LspDiagnosticSeverity, LspDiagnosticsBridge, LspManager, type LspManagerOptions, type LspServerConfig, type McpToolCallItem, type McpToolCallStatus, type NativeForkResult, type NativeTokenUsage, type NativeToolDefinition, type NativeToolInterceptorContext, type NativeToolInvocation, type NativeToolResult, type NativeTuiExitInfo, type NativeTuiRequest, type NativeUpdateActionInfo, type NativeUpdateActionKind, type NormalizedDiagnostic, OpenCodeAgent, type OpenCodeAgentOptions, type PatchApplyStatus, type PatchChangeKind, type PermissionDecision, type PermissionRequest, type ProjectLevelContext, type QualityFilterStats, REVERIE_CANDIDATE_MULTIPLIER, REVERIE_EMBED_MODEL, REVERIE_LLM_GRADE_THRESHOLD, REVERIE_RERANKER_MODEL, type ReasoningItem, type RepoDiffFileChange, type RepoDiffSummary, type RepoDiffSummaryOptions, type ReverieContext, type ReverieEpisodeSummary, type ReverieFilterStats, type ReverieInsight$1 as ReverieInsight, type ReveriePipelineOptions, type ReveriePipelineResult, type ReverieResult, type ReverieSearchLevel, type ReverieSearchOptions, type ReverieSemanticIndexStats, type ReverieSemanticSearchOptions, type ReviewInvocationOptions, type ReviewTarget, type RunResult, type RunStreamedResult, type RunTuiOptions, type SandboxMode, ScopedLogger, type SkillDefinition, type SkillMentionTrigger, Thread, type ThreadError, type ThreadErrorEvent, type ThreadEvent, type ThreadItem, type ThreadLoggingSink, type ThreadOptions, type ThreadStartedEvent, type TodoItem, type TodoListItem, type TokenizerEncodeOptions, type TokenizerOptions, type ToolCallEvent, type ToolExecutionContext, type ToolExecutor, type ToolExecutorResult, type TuiSession, type TurnCompletedEvent, type TurnFailedEvent, type TurnOptions, type TurnStartedEvent, type Usage, type UserInput, type WebSearchItem, type WorkspaceLocator, applyFileReveriePipeline, applyQualityPipeline, applyReveriePipeline, attachLspDiagnostics, buildBranchContext, buildFileContext, buildProjectContext, clearCodexToolExecutors, codexTool, collectRepoDiffSummary, contextToQuery, createThreadLogger, deduplicateReverieInsights, encodeToToon, evAssistantMessage, evCompleted, evFunctionCall, evResponseCreated, extractKeySymbols, fastEmbedEmbed, fastEmbedInit, filterBySeverity, findServerForFile, formatDiagnosticsForBackgroundEvent, formatDiagnosticsForTool, formatDiagnosticsWithSummary, formatFileList, formatStream, getCodexToolExecutor, gradeReverieRelevance, gradeReveriesInParallel, isValidReverieExcerpt, logApprovedReveries, logLLMGrading, logLevelResults, logMultiLevelSearch, logMultiLevelSummary, logReverieFiltering, logReverieHintQuality, logReverieInsights, logReverieSearch, logger, registerCodexToolExecutor, resolveWorkspaceRoot, reverieGetConversationInsights, reverieIndexSemantic, reverieListConversations, reverieSearchConversations, reverieSearchSemantic, runThreadTurnWithLogs, runTui, searchBranchLevel, searchFileLevel, searchMultiLevel, searchProjectLevel, searchReveries, sse, startTui, summarizeDiagnostics, tokenizerCount, tokenizerDecode, tokenizerEncode, truncate as truncateText };
+export { type AgentMessageItem, type AgentRunner, type ApprovalMode, type ApprovalRequest, type BranchLevelContext, type BranchReview, type CloudApplyOutcome, type CloudApplyStatus, type DiffSummary as CloudDiffSummary, type CloudTaskStatus, type CloudTaskSummary, CloudTasks, type CloudTasksOptions, Codex, type CodexOptions, CodexProvider, type CodexProviderOptions, type CodexToolOptions, type CommandExecutionItem, type CommandExecutionStatus, type CommitReview, type ConversationListOptions, type ConversationListPage, type ConversationSummary, type CurrentChangesReview, type CustomReview, DEFAULT_RERANKER_BATCH_SIZE, DEFAULT_RERANKER_TOP_K, DEFAULT_REVERIE_LIMIT, DEFAULT_REVERIE_MAX_CANDIDATES, DEFAULT_SERVERS, type DelegationResult, type DiagnosticSeverity, type ErrorItem, type FastEmbedEmbedRequest, type FastEmbedInitOptions, type FastEmbedRerankerModelCode, type FileChangeItem, type FileDiagnostics, type FileLevelContext, type FileUpdateChange, type ForkOptions, type FormatStreamOptions, type FormattedStream, type GradingOptions, type Input, type ItemCompletedEvent, type ItemStartedEvent, type ItemUpdatedEvent, type LogEntry, LogLevel, type LogOutput, type LogScope, Logger, type LoggerConfig, type LspDiagnosticSeverity, LspDiagnosticsBridge, LspManager, type LspManagerOptions, type LspServerConfig, type McpToolCallItem, type McpToolCallStatus, type NativeForkResult, type NativeTokenUsage, type NativeToolDefinition, type NativeToolInterceptorContext, type NativeToolInvocation, type NativeToolResult, type NativeTuiExitInfo, type NativeTuiRequest, type NativeUpdateActionInfo, type NativeUpdateActionKind, type NormalizedDiagnostic, OpenCodeAgent, type OpenCodeAgentOptions, type PatchApplyStatus, type PatchChangeKind, type PermissionDecision, type PermissionRequest, type ProjectLevelContext, type QualityFilterStats, REVERIE_CANDIDATE_MULTIPLIER, REVERIE_EMBED_MODEL, REVERIE_LLM_GRADE_THRESHOLD, REVERIE_RERANKER_MODEL, type ReasoningItem, type RepoDiffFileChange, type RepoDiffSummary, type RepoDiffSummaryOptions, type ReverieContext, type ReverieEpisodeSummary, type ReverieFilterStats, type ReverieInsight$1 as ReverieInsight, type ReveriePipelineOptions, type ReveriePipelineResult, type ReverieResult, type ReverieSearchLevel, type ReverieSearchOptions, type ReverieSemanticIndexStats, type ReverieSemanticSearchOptions, type ReviewInvocationOptions, type ReviewTarget, type RunResult, type RunStreamedResult, type RunTuiOptions, type SandboxMode, ScopedLogger, type SkillDefinition, type SkillMentionTrigger, Thread, type ThreadError, type ThreadErrorEvent, type ThreadEvent, type ThreadItem, type ThreadLoggingSink, type ThreadOptions, type ThreadStartedEvent, type TodoItem, type TodoListItem, type TokenizerEncodeOptions, type TokenizerOptions, type ToolCallEvent, type ToolExecutionContext, type ToolExecutor, type ToolExecutorResult, type TuiSession, type TurnCompletedEvent, type TurnFailedEvent, type TurnOptions, type TurnStartedEvent, type Usage, type UserInput, type WebSearchItem, type WorkspaceLocator, applyFileReveriePipeline, applyQualityPipeline, applyReveriePipeline, attachLspDiagnostics, buildBranchContext, buildFileContext, buildProjectContext, clearCodexToolExecutors, codexTool, collectRepoDiffSummary, contextToQuery, createThreadLogger, deduplicateReverieInsights, encodeToToon, evAssistantMessage, evCompleted, evFunctionCall, evResponseCreated, extractKeySymbols, fastEmbedEmbed, fastEmbedInit, filterBySeverity, findServerForFile, formatDiagnosticsForBackgroundEvent, formatDiagnosticsForTool, formatDiagnosticsWithSummary, formatFileList, formatStream, getCodexToolExecutor, getNativeBinding, gradeReverieRelevance, gradeReveriesInParallel, isValidReverieExcerpt, logApprovedReveries, logLLMGrading, logLevelResults, logMultiLevelSearch, logMultiLevelSummary, logReverieFiltering, logReverieHintQuality, logReverieInsights, logReverieSearch, logger, registerCodexToolExecutor, resolveWorkspaceRoot, reverieGetConversationInsights, reverieIndexSemantic, reverieListConversations, reverieSearchConversations, reverieSearchSemantic, runThreadTurnWithLogs, runTui, searchBranchLevel, searchFileLevel, searchMultiLevel, searchProjectLevel, searchReveries, sse, startTui, summarizeDiagnostics, tokenizerCount, tokenizerDecode, tokenizerEncode, truncate as truncateText };

package/dist/index.mjs

@@ -27,7 +27,7 @@ import {
   tokenizerCount,
   tokenizerDecode,
   tokenizerEncode
-} from "./chunk-LFJNLOFF.mjs";
+} from "./chunk-ZAYUMM55.mjs";
 
 // src/agents/toolRegistry.ts
 var executors = /* @__PURE__ */ new Map();
@@ -264,10 +264,21 @@ var CodexModel = class {
         };
         this.codex.registerTool(nativeToolDef);
         this.registeredTools.add(tool2.name);
-        console.log(`Registered tool with Codex: ${tool2.name}`);
+        const DEBUG = process.env.DEBUG === "1" || process.env.DEBUG === "true";
+        if (DEBUG) {
+          try {
+            process.stderr.write(`[codex-native] Registered tool with Codex: ${tool2.name}
+`);
+          } catch {
+          }
+        }
       } catch (error) {
         const errorMessage = `Failed to register tool ${tool2.name}: ${error instanceof Error ? error.message : String(error)}`;
-        console.error(errorMessage);
+        try {
+          process.stderr.write(`[codex-native] ${errorMessage}
+`);
+        } catch {
+        }
       }
     }
   }
@@ -292,11 +303,21 @@ var CodexModel = class {
    * but the framework integration is not yet complete.
    */
   async executeToolViaFramework(invocation) {
-    console.log("[DEBUG executeToolViaFramework] invocation:", JSON.stringify(invocation, null, 2));
-    console.log("[DEBUG executeToolViaFramework] invocation type:", typeof invocation);
-    console.log("[DEBUG executeToolViaFramework] invocation keys:", invocation ? Object.keys(invocation) : "null/undefined");
+    const DEBUG = process.env.DEBUG === "1" || process.env.DEBUG === "true";
+    if (DEBUG) {
+      try {
+        process.stderr.write(
+          `[codex-native] executeToolViaFramework invocation: ${JSON.stringify(invocation)}
+`
+        );
+      } catch {
+      }
+    }
     if (!invocation) {
-      console.warn("Codex requested a tool execution without invocation data.");
+      try {
+        process.stderr.write("[codex-native] Codex requested a tool execution without invocation data.\n");
+      } catch {
+      }
       return {
         output: JSON.stringify({
           message: "Tool invocation payload missing",
@@ -306,13 +327,23 @@ var CodexModel = class {
         error: "Missing tool invocation data from Codex"
       };
     }
-    console.log(
-      `Tool execution requested by Codex: ${invocation.toolName} (callId: ${invocation.callId})`
-    );
+    if (DEBUG) {
+      try {
+        process.stderr.write(
+          `[codex-native] Tool execution requested: ${invocation.toolName} (callId: ${invocation.callId})
+`
+        );
+      } catch {
+      }
+    }
     const executor = this.toolExecutors.get(invocation.toolName) ?? getCodexToolExecutor(invocation.toolName);
     if (!executor) {
       const message = `No Codex executor registered for tool '${invocation.toolName}'. Use codexTool() or provide a codexExecute handler.`;
-      console.warn(message);
+      try {
+        process.stderr.write(`[codex-native] ${message}
+`);
+      } catch {
+      }
       return {
         success: false,
         error: message,
@@ -357,7 +388,15 @@ var CodexModel = class {
     if (typeof result === "string") {
       return { success: true, output: result };
     }
-    if (typeof result === "object" && ("output" in result || "error" in result || "success" in result)) {
+    const isNativeToolResultLike = (value) => {
+      if (!value || typeof value !== "object") return false;
+      if (!("output" in value) && !("error" in value) && !("success" in value)) return false;
+      if ("success" in value && value.success != null && typeof value.success !== "boolean") return false;
+      if ("output" in value && value.output != null && typeof value.output !== "string") return false;
+      if ("error" in value && value.error != null && typeof value.error !== "string") return false;
+      return true;
+    };
+    if (isNativeToolResultLike(result)) {
       return {
         success: result.success ?? !result.error,
         output: result.output,
@@ -2663,6 +2702,7 @@ export {
   formatFileList,
   formatStream,
   getCodexToolExecutor,
+  getNativeBinding,
   gradeReverieRelevance,
   gradeReveriesInParallel,
   isValidReverieExcerpt,