dual-brain 0.2.30 → 0.3.1

package/dist/src/dispatch.d.ts

@@ -0,0 +1,154 @@
+#!/usr/bin/env node
+interface RuntimeInfo {
+    claudeAvailable: boolean;
+    codexAvailable: boolean;
+    runtime: 'claude-code' | 'codex-cli' | 'none';
+}
+interface TokenUsageInfo {
+    inputTokens: number;
+    outputTokens: number;
+}
+interface RetryBudgetState {
+    perTaskRetries: Record<string, number>;
+    recentDispatches: number;
+    windowMs: number;
+    maxPerTask: number;
+    maxPerWindow: number;
+}
+interface WorktreeCheck {
+    safe: boolean;
+    conflicts?: string[];
+}
+interface PreflightResult {
+    ready: boolean;
+    provider: string;
+    error?: string;
+    suggestion?: string;
+}
+interface NativeDispatchDescriptor {
+    type: 'native-agent';
+    description: string;
+    model: 'haiku' | 'sonnet' | 'opus';
+    prompt: string;
+    isolation: string | undefined;
+    maxTurns: number;
+    disallowedTools: string[];
+    background: boolean;
+}
+interface NormalizedResult {
+    status: 'success' | 'failure' | 'partial';
+    provider: string;
+    model: string;
+    tier: string;
+    filesChanged: string[];
+    filesFound: string[];
+    testsRun: number;
+    edgeCases: string[];
+    tokensUsed: {
+        input: number;
+        output: number;
+    };
+    errors: string[];
+    rawOutput: string;
+}
+interface DispatchInput {
+    prompt?: string;
+    decision?: Record<string, unknown>;
+    files?: string[];
+    cwd?: string;
+    dryRun?: boolean;
+    verbose?: boolean;
+    situationBrief?: string;
+    useWorktree?: boolean;
+    maxTurns?: number;
+    modelSuggestion?: {
+        model: string;
+        reason: string;
+    };
+    profile?: Record<string, unknown>;
+    _retryAttempt?: number;
+    _skipPreDispatchThink?: boolean;
+    _skipRelatedContext?: boolean;
+}
+interface DispatchResult {
+    status: string;
+    provider: string;
+    model: string;
+    specialist?: string;
+    command: string[] | null;
+    nativeDispatch?: NativeDispatchDescriptor;
+    exitCode: number | null;
+    summary: string | null;
+    durationMs: number;
+    usage: TokenUsageInfo | null;
+    worktreeUsed?: boolean;
+    autoReview?: {
+        triggered: boolean;
+        provider?: string;
+        status?: string;
+        reason?: string;
+    };
+    authVerified?: boolean;
+    error: string | null;
+    suggestion?: string;
+    type?: string;
+}
+interface DualBrainResult {
+    tier: string;
+    claude: DispatchResult;
+    openai: DispatchResult;
+    consensus: 'both-passed' | 'both-failed' | 'split';
+}
+/**
+ * Read agents/specialists/_base.md and agents/specialists/{specialist}.md,
+ * concatenate them (base first, specialist second). Falls back gracefully:
+ * - If base is missing, only specialist content is returned.
+ * - If specialist file is missing, only base content is returned.
+ * - If both are missing, returns an empty string.
+ */
+declare function loadSpecialistPrompt(specialist: string): string;
+/**
+ * Detect whether we are running inside Claude Code (as a subagent or tool call).
+ * Checks the CLAUDE_CODE env var or the presence of .claude/settings.json in the project root.
+ */
+declare function isInsideClaude(): boolean;
+/**
+ * Build a structured native Agent tool call descriptor instead of a shell command.
+ * The caller (CLI or plugin) is responsible for invoking the Agent tool with this object.
+ */
+declare function buildNativeDispatch(decision: Record<string, unknown>, prompt: string, options?: {
+    worktree?: boolean;
+    maxTurns?: number;
+}): NativeDispatchDescriptor;
+/**
+ * Normalize a raw result from either a native Agent call or subprocess stdout
+ * into a common result shape.
+ */
+declare function normalizeResult(rawResult: unknown, dispatchType: 'native-agent' | 'subprocess'): NormalizedResult;
+declare function detectRuntime(): Promise<RuntimeInfo>;
+/**
+ * Validate a routing decision against CLI availability and valid model lists.
+ * Returns either a (possibly corrected) decision object, or an error sentinel
+ * `{ _error: string }` when no CLI is available at all.
+ */
+declare function validateDispatch(decision: Record<string, unknown>, rt: RuntimeInfo): Record<string, unknown> & {
+    _error?: string;
+};
+/**
+ * Check whether dirty worktree files overlap with the agent's ownership globs.
+ */
+declare function checkWorktreeClean(owns: string[], cwd?: string): Promise<WorktreeCheck>;
+/**
+ * Return current retry budget state for status display.
+ */
+declare function getRetryBudget(): RetryBudgetState;
+/**
+ * Verify a provider CLI is present and (optionally) responds to --version.
+ * Uses `which` for the fast path and a 3s-capped --version call to confirm.
+ */
+declare function preflightAuth(provider: string, _cwd?: string): Promise<PreflightResult>;
+declare function buildCommand(decision: Record<string, unknown>, prompt: string, files?: string[], _cwd?: string): string[];
+declare function compressResult(rawOutput?: string, maxLength?: number): string;
+declare function dispatch(input?: DispatchInput): Promise<DispatchResult>;
+declare function dispatchDualBrain(input?: DispatchInput): Promise<DualBrainResult>;
+export { dispatch, buildCommand, detectRuntime, compressResult, dispatchDualBrain, validateDispatch, checkWorktreeClean, getRetryBudget, isInsideClaude, buildNativeDispatch, normalizeResult, loadSpecialistPrompt, preflightAuth };