@peakflo/agent-harness 0.0.0-stage → 0.2.1-rc.3

package/dist/adapters/claude-code-adapter.d.ts

@@ -0,0 +1,171 @@
+/**
+ * Claude Code Adapter
+ *
+ * Implements CodingAgentAdapter for Claude Code using @anthropic-ai/claude-agent-sdk.
+ *
+ * Key differences from OpenCode:
+ * - Uses AsyncGenerator streaming API instead of HTTP client
+ * - File-based session persistence (~/.claude/sessions/)
+ * - Different message format (SDKMessage vs OpenCode messages)
+ */
+/**
+ * Extracted verbatim from 20x `src/main/adapters/claude-code-adapter.ts`.
+ * CHANGED: nothing. The only import it has is `./coding-agent-adapter`, which
+ * sits in the same directory here too. `@anthropic-ai/claude-agent-sdk` is an
+ * optional dependency (dynamically imported) and is declared ambiently in
+ * `./optional-agent-sdks.d.ts` so `tsc` succeeds when it is not installed.
+ * Source formatting (no semicolons) preserved.
+ */
+import type { CodingAgentAdapter, SessionConfig, SessionStatus, SessionMessage, MessagePart } from './coding-agent-adapter';
+export declare enum ClaudeSystemSubtype {
+    INIT = "init",
+    TASK_STARTED = "task_started",
+    TASK_PROGRESS = "task_progress",
+    TASK_NOTIFICATION = "task_notification",
+    TASK_UPDATED = "task_updated",
+    /** Authoritative in-flight background-task list. Emitted by the CLI but NOT
+     *  surfaced by SDK >= 0.3.x (absent from the SDKMessage union) — older bundled
+     *  SDKs (e.g. 0.2.x) do pass it through, so it is handled defensively both as a
+     *  status source and as a transcript-suppression case. */
+    BACKGROUND_TASKS_CHANGED = "background_tasks_changed",
+    STATUS = "status",
+    THINKING_TOKENS = "thinking_tokens"
+}
+export declare class ClaudeCodeAdapter implements CodingAgentAdapter {
+    private sessions;
+    private sdkLoading;
+    private claudeExecutablePath;
+    /**
+     * Callback set by agent-manager to trigger an immediate poll cycle
+     * when new stream data is buffered.  Eliminates the up-to-2-second
+     * latency of the fixed-interval polling heartbeat.
+     */
+    onDataAvailable?: (sessionId: string) => void;
+    constructor();
+    /**
+     * Find the Claude CLI executable path
+     */
+    private findClaudeExecutable;
+    /**
+     * On Windows, .cmd wrapper files can't be spawned directly by the SDK
+     * (no shell: true). Resolve claude.cmd → the underlying cli.js path.
+     */
+    private resolveWindowsCmdToJs;
+    /**
+     * Build environment variables for Claude process
+     * Removes CLAUDECODE to prevent nested session errors.
+     * When secrets are configured, sets SHELL to the secret-shell.sh wrapper
+     * so every bash command fetches secrets from the broker transparently.
+     */
+    private buildClaudeEnvironment;
+    /**
+     * Build PreToolUse hooks for secret injection.
+     * Registers a hook that prepends `export KEY='value'` lines to each Bash command.
+     * The LLM never sees the modified command — only the original tool call and
+     * the output appear in conversation context.
+     */
+    private buildSecretHooks;
+    private loadSDK;
+    private ensureSDKLoaded;
+    initialize(): Promise<void>;
+    createSession(config: SessionConfig): Promise<string>;
+    /**
+     * Check if a session ID is valid for Claude Code (UUID format)
+     */
+    private isValidClaudeSessionId;
+    /**
+     * Load conversation history from Claude session file
+     */
+    /**
+     * Cleans the session file by removing messages with empty text blocks
+     * This prevents API errors when resuming sessions
+     */
+    private cleanSessionFile;
+    /**
+     * Public, side-effect-free read of the persisted session history from the
+     * on-disk JSONL — no CLI/SDK spawn, no live session required. Used to backfill
+     * the durable transcript projection once. Returns [] if the file is missing.
+     */
+    getPersistedMessages(sessionId: string, config: SessionConfig): Promise<SessionMessage[]>;
+    private loadSessionHistory;
+    resumeSession(sessionId: string, config: SessionConfig): Promise<SessionMessage[]>;
+    sendPrompt(sessionId: string, parts: MessagePart[], config: SessionConfig): Promise<void>;
+    getStatus(sessionId: string, _config: SessionConfig): Promise<SessionStatus>;
+    /**
+     * Exposes in-flight background subagents as "running tools" so agent-manager's
+     * delegation-aware watchdogs (which look for tool names like `task`/`agent`)
+     * stand down instead of aborting a coordinator that is waiting on children.
+     */
+    getRunningTools(sessionId: string, _config: SessionConfig): Promise<Array<{
+        partId: string;
+        toolName: string;
+        startTime?: number;
+        input?: Record<string, unknown>;
+    }>>;
+    pollMessages(sessionId: string, _seenMessageIds: Set<string>, seenPartIds: Set<string>, partContentLengths: Map<string, string>, _config: SessionConfig): Promise<MessagePart[]>;
+    abortPrompt(sessionId: string, _config: SessionConfig): Promise<void>;
+    destroySession(sessionId: string, _config: SessionConfig): Promise<void>;
+    getAllMessages(sessionId: string, _config: SessionConfig): Promise<SessionMessage[]>;
+    respondToQuestion(sessionId: string, answers: Record<string, 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;
+    }>;
+    /**
+     * Safely logs a message by truncating large base64 content
+     */
+    /**
+     * Lightweight message logger — only logs type/subtype to avoid blocking
+     * the event loop with expensive JSON serialization on every streaming chunk.
+     */
+    private safeLogMessage;
+    /**
+     * Consumes the query stream in the background and buffers messages
+     */
+    private consumeStream;
+    /**
+     * Maintains `session.backgroundTasks` from the SDK's task lifecycle messages.
+     *
+     * Note: the raw CLI also emits `background_tasks_changed` (which carries the
+     * authoritative in-flight list), but the SDK filters it out — it is not part of
+     * the `SDKMessage` union — so the set has to be rebuilt from task_started plus
+     * task_updated / task_notification.
+     */
+    private trackBackgroundTask;
+    /**
+     * Drops background tasks that have outlived MAX_BACKGROUND_TASK_AGE_MS so a
+     * lost terminal notification can't keep the session BUSY (and un-reapable)
+     * indefinitely.
+     */
+    private pruneStaleBackgroundTasks;
+    /**
+     * Marks the current turn idle once it has produced a `result` AND no
+     * background task is still running. The streaming-input prompt remains open
+     * for the full session lifetime. Until background work is complete,
+     * the session stays BUSY so agent-manager keeps polling instead of calling
+     * transitionToIdle (which flips the task to ready_for_review and eventually
+     * lets the inactivity reaper destroy the session out from under the subagents).
+     */
+    private settleTurnIfComplete;
+    /**
+     * Extracts a unique message ID from SDKMessage
+     */
+    private getMessageId;
+    /**
+     * Converts SDKMessage to MessagePart[] format
+     */
+    private convertSDKMessageToParts;
+    /**
+     * Builds a human-readable title for a tool call from its input.
+     * Mirrors the titles that OpenCode/buildPartPayload produces.
+     */
+    private buildToolTitle;
+}