@peakflo/agent-harness 0.0.0-stage → 0.2.2-rc.1

package/dist/adapters/codex-app-server-adapter.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Codex App Server adapter.
+ *
+ * Experimental replacement path for Codex ACP. This talks to `codex app-server`
+ * over JSON-RPC stdio and maps the app-server thread/turn/item protocol onto
+ * 20x's CodingAgentAdapter contract.
+ */
+import type { CodingAgentAdapter, SessionConfig, SessionStatus, SessionMessage, MessagePart } from './coding-agent-adapter';
+interface PendingApproval {
+    requestId: string | number;
+    toolCallId: string;
+    question: string;
+    options: Array<{
+        optionId: string;
+        name: string;
+        kind: string;
+    }>;
+    responseKind: 'execCommand' | 'commandExecution' | 'fileChange' | 'permissions' | 'elicitation' | 'userInput' | 'generic';
+}
+export declare class CodexAppServerAdapter implements CodingAgentAdapter {
+    private sessions;
+    private codexExecutablePath;
+    onDataAvailable?: (sessionId: string) => void;
+    initialize(): Promise<void>;
+    createSession(config: SessionConfig): Promise<string>;
+    resumeSession(sessionId: string, config: SessionConfig): Promise<SessionMessage[]>;
+    sendPrompt(sessionId: string, parts: MessagePart[], config: SessionConfig): Promise<void>;
+    getStatus(sessionId: string, _config: SessionConfig): Promise<SessionStatus>;
+    pollMessages(sessionId: string, seenMessageIds: Set<string>, seenPartIds: Set<string>, partContentLengths: Map<string, string>, _config: SessionConfig): Promise<MessagePart[]>;
+    getAllMessages(sessionId: string, _config: SessionConfig): Promise<SessionMessage[]>;
+    abortPrompt(sessionId: string, _config: SessionConfig): Promise<void>;
+    destroySession(sessionId: string, _config: SessionConfig): Promise<void>;
+    registerMcpServer(_serverName: string, _mcpConfig: {
+        type: 'local' | 'remote';
+        command?: string[];
+        args?: string[];
+        url?: string;
+        headers?: Record<string, string>;
+        environment?: Record<string, string>;
+    }, _workspaceDir?: string): Promise<void>;
+    checkHealth(): Promise<{
+        available: boolean;
+        reason?: string;
+    }>;
+    getPendingApproval(sessionId: string): PendingApproval | null;
+    respondToApproval(sessionId: string, approved: boolean, optionId?: string): Promise<void>;
+    getRunningTools(sessionId: string, _config: SessionConfig): Promise<Array<{
+        partId: string;
+        toolName: string;
+        startTime?: number;
+        input?: Record<string, unknown>;
+    }>>;
+    private startAppServerProcess;
+    private initializeAppServer;
+    private findCodexExecutable;
+    private execFileAsync;
+    private buildEnvironment;
+    private buildConfigOverrides;
+    private buildRuntimeWorkspaceRoots;
+    private resolveExternalGitRoots;
+    private convertMcpServers;
+    private logMcpServerInventory;
+    private setupStdoutParser;
+    private handleRpcMessage;
+    private handleServerRequest;
+    private handleNotification;
+    private handleApprovalRequest;
+    private buildApprovalResponse;
+    private getApprovalResponseKind;
+    private resolveSandboxMode;
+    private buildSandboxPolicy;
+    private addEvent;
+    private bufferThreadItems;
+    /**
+     * Buffers a single thread item from a reconcile pass, skipping it if it has
+     * already been buffered. reconcileCompletedTurn() re-lists the entire thread on
+     * every turn/completed, so this MUST be idempotent for every item — including
+     * the many Codex item types that carry no top-level `id` (function_call_output,
+     * custom_tool_call_output, tool_search_output, user/developer messages). We key
+     * off a stable identity (id/itemId/call_id) or, failing that, a deterministic
+     * content hash, and forward that key as `itemId` so the derived part id stays
+     * stable across passes. Without this, id-less items were re-emitted with a fresh
+     * id on every idle and the transcript repeated older messages.
+     */
+    private bufferReconciledThreadItem;
+    private computeThreadItemKey;
+    private bufferAllThreadItems;
+    private bufferAllThreadTurns;
+    private reconcileCompletedTurn;
+    private markIdleIfSettled;
+    private convertEventToMessageParts;
+    private convertOutputDeltaEvent;
+    private convertThreadItem;
+    private hasSeenAssistantTextForTurn;
+    private markAssistantTextForTurn;
+    private extractTurnKey;
+    private extractAssistantTextScopeKeys;
+    private buildAssistantTextKey;
+    private sendRpcRequest;
+    private sendRpcResponse;
+    private sendRpcNotification;
+    private writeJson;
+    private requireSession;
+}
+export {};