@corbat-tech/coco 2.37.0 → 2.39.0

package/dist/index.d.ts

@@ -1,6 +1,17 @@
+import { Q as QualityScores, a as QualityDimensions } from './index-Dp1o8c9g.js';
+export { b as QualityThresholds, c as createFullToolRegistry, r as registerAllTools } from './index-Dp1o8c9g.js';
 import { z } from 'zod';
-import { Server } from 'node:http';
+import { L as LLMProvider, P as ProviderConfig, M as Message$1, C as ChatOptions, a as ChatResponse$1, b as ChatWithToolsOptions, c as ChatWithToolsResponse$1, S as StreamChunk } from './agent-runtime-DJY9FzL_.js';
+export { A as AGENT_MODES, d as AgentArtifact, e as AgentArtifactKind, f as AgentBudget, g as AgentCapability, h as AgentCard, i as AgentDefinition, j as AgentGateDefinition, k as AgentGateKind, l as AgentGraphDefinition, m as AgentGraphEdge, n as AgentGraphEngine, o as AgentGraphEngineOptions, p as AgentGraphNode, q as AgentGraphNodeExecution, r as AgentGraphNodeExecutor, s as AgentGraphRunInput, t as AgentGraphRunResult, u as AgentGraphRunStatus, v as AgentGraphValidationIssue, w as AgentGraphValidationResult, x as AgentGuardrailPolicy, y as AgentHandoff, z as AgentMessage, B as AgentMessageRole, D as AgentModeDefinition, E as AgentModeId, F as AgentRole, G as AgentRunResult, H as AgentRunStatus, I as AgentRuntime, J as AgentRuntimeOptions, K as AgentRuntimeSnapshot, N as AgentToolPolicyDecision, O as AgentTraceContext, Q as DEFAULT_WORKFLOWS, R as EventLog, T as FileSharedWorkspaceStore, U as InMemorySharedWorkspaceStore, V as LegacyAgentRoleMapping, W as PermissionDecision, X as PermissionPolicy, Y as ProviderRegistry, Z as ProviderRuntimeSelection, _ as ReasoningEffort, $ as RuntimeAgentTask, a0 as RuntimeEvent, a1 as RuntimeEventType, a2 as RuntimeMode, a3 as RuntimeSession, a4 as RuntimeSessionCreateOptions, a5 as RuntimeSessionStore, a6 as RuntimeToolExecutionInput, a7 as RuntimeToolExecutionResult, a8 as RuntimeTurnContext, a9 as RuntimeTurnInput, aa as RuntimeTurnResult, ab as RuntimeTurnRunner, ac as RuntimeTurnStreamEvent, ad as SharedWorkspaceProvenance, ae as SharedWorkspaceRecord, af as SharedWorkspaceRecordKind, ag as SharedWorkspaceState, ah as SharedWorkspaceStateSnapshot, ai as SharedWorkspaceStore, aj as SharedWorkspaceWriteInput, ak as ToolRiskLevel, al as ToolRiskManifest, am as ToolRiskManifestEntry, an as WorkflowCatalog, ao as WorkflowDefinition, ap as WorkflowEngine, aq as WorkflowHandler, ar as WorkflowPlan, as as WorkflowRegistry, at as WorkflowRetryPolicy, au as WorkflowRisk, av as WorkflowRunContext, aw as WorkflowRunInput, ax as WorkflowRunResult, ay as WorkflowRunStatus, az as WorkflowStepDefinition, aA as createAgentArtifact, aB as createAgentGraphEngine, aC as createAgentRuntime, aD as createAgentTraceContext, aE as createProvider, aF as createProviderRegistry, aG as createSummaryArtifact, aH as createWorkflowCatalog, aI as createWorkflowEngine, aJ as createWorkflowRegistry, aK as evaluateAgentToolPolicy, aL as getAgentMode, aM as isAgentMode, aN as listAgentModes, aO as listLegacyAgentRoleMappings, aP as mapLegacyAgentRole, aQ as normalizeAgentRunResult, aR as validateAgentCapabilities, aS as validateAgentGraph, aT as workflowToAgentGraph } from './agent-runtime-DJY9FzL_.js';
+export { A as AgentRunner, a as AgentRunnerExecutionContext, b as AgentRunnerExecutionInput, c as AgentRunnerExecutor, d as AgentRunnerOptions, e as AgentRunnerRawResult, f as AgentSurface, D as DefaultPermissionPolicy, g as DefaultRuntimeTurnRunner, E as ExtensionRisk, F as FileEventLog, h as FileRuntimeSessionStore, I as InMemoryEventLog, i as InMemoryRuntimeSessionStore, M as McpToolPolicy, R as RecipeManifest, j as RecipeStep, k as RuntimeHttpServerOptions, S as SkillManifest, T as ToolCallingRuntimeTurnRunner, l as ToolCallingRuntimeTurnRunnerOptions, m as createAgentRunner, n as createDefaultRuntimeTurnRunner, o as createEventLog, p as createFileEventLog, q as createFileRuntimeSessionStore, r as createMcpToolPolicy, s as createPermissionPolicy, t as createRuntimeHttpServer, u as createRuntimeSessionStore, v as createToolCallingRuntimeTurnRunner } from './extension-manifests-CAQQILhE.js';
+export { A as AgentActionMode, a as AgentBlueprint, b as AgentDeploymentSurface, c as AgentMaturity, d as AgentPreset, e as AgentRuntimeFactoryOptions, f as ApprovalPolicy, B as BlueprintAgent, G as GuardrailConfig, g as GuardrailFinding, h as GuardrailResult, i as GuardrailSeverity, j as GuardrailStage, M as MemoryConfig, O as ObservabilityConfig, S as SecretRedactionConfig, T as TopicBoundaryConfig, k as createAgentFromBlueprint, l as createBaseBlueprint, m as createSafeToolRegistry, n as defaultPublicGuardrails, o as mapActionModeToRuntimeMode, r as redactSecrets, p as runGuardrails, v as validateStructuredOutput } from './blueprints-DYgm3K65.js';
+export { I as InMemoryKnowledgeDocument, a as InMemoryKnowledgeRetriever, K as KnowledgeRetriever, R as RetrievalOptions, b as RetrievedSource, c as createInMemoryKnowledgeRetriever, f as formatRetrievedSourcesForPrompt } from './rag-BakFRE-u.js';
+export { H as HumanEscalationHandler, a as HumanEscalationInput, b as HumanEscalationOutput, S as SupportDraftHandler, c as SupportDraftInput, d as SupportDraftOutput, e as SupportRagToolRegistryOptions, f as createCodingToolRegistry, g as createCustomerSupportToolRegistry, h as createNoToolRegistry, i as createPublicWebToolRegistry, j as createRagToolRegistry, k as createSupportRagToolRegistry } from './profiles-BcyL-gQ9.js';
+export { AGENT_PRESETS, AppointmentPresetConfig, BrandPresetConfig, RagPresetConfig, SupportRagPresetConfig, appointmentBookingAssistantPreset, codingAgentPreset, customerSupportAssistantPreset, internalOpsAssistantPreset, publicWebsiteAssistantPreset, ragKnowledgeAssistantPreset, salesIntakeAssistantPreset, supportRagAssistantPreset } from './presets/index.js';
+export { ChannelAdapter, ChannelInput, ChannelOutput, HttpAssistantAdapter, StreamingHttpAssistantAdapter, createHttpAssistantAdapter, createStreamingHttpAssistantAdapter, createWebhookAssistantAdapter } from './adapters/index.js';
 import { Logger, ILogObj } from 'tslog';
+export { T as ToolRegistry, c as createToolRegistry } from './registry-CEpl9Jq0.js';
+import 'node:http';
 
 declare const VERSION: string;
 
@@ -118,8 +129,8 @@ interface PhaseTools {
  * LLM interface for phases
  */
 interface LLMInterface {
-    chat(messages: Message$1[]): Promise<ChatResponse$1>;
-    chatWithTools(messages: Message$1[], tools: ToolDefinition$2[]): Promise<ChatWithToolsResponse$1>;
+    chat(messages: Message[]): Promise<ChatResponse>;
+    chatWithTools(messages: Message[], tools: ToolDefinition[]): Promise<ChatWithToolsResponse>;
 }
 /**
  * Phase checkpoint for recovery
@@ -153,26 +164,26 @@ interface QualityTools {
     complexity(files: string[]): Promise<ComplexityResult>;
     security(files: string[]): Promise<SecurityResult>;
 }
-interface Message$1 {
+interface Message {
     role: "system" | "user" | "assistant";
     content: string;
 }
-interface ChatResponse$1 {
+interface ChatResponse {
     content: string;
     usage: {
         inputTokens: number;
         outputTokens: number;
     };
 }
-interface ToolDefinition$2 {
+interface ToolDefinition {
     name: string;
     description: string;
     parameters: Record<string, unknown>;
 }
-interface ChatWithToolsResponse$1 extends ChatResponse$1 {
-    toolCalls?: ToolCall$1[];
+interface ChatWithToolsResponse extends ChatResponse {
+    toolCalls?: ToolCall[];
 }
-interface ToolCall$1 {
+interface ToolCall {
     name: string;
     arguments: Record<string, unknown>;
 }
@@ -251,113 +262,6 @@ interface SecurityIssue {
     line?: number;
 }
 
-/**
- * Quality system types for Corbat-Coco
- */
-/**
- * Multi-dimensional quality scores
- */
-interface QualityScores {
-    /**
-     * Overall weighted score (0-100)
-     */
-    overall: number;
-    /**
-     * Individual dimension scores
-     */
-    dimensions: QualityDimensions;
-    /**
-     * Metadata
-     */
-    evaluatedAt: Date;
-    evaluationDurationMs: number;
-}
-/**
- * Quality dimensions
- */
-interface QualityDimensions {
-    /**
-     * Does the code work correctly? (tests pass, logic correct)
-     */
-    correctness: number;
-    /**
-     * Are all requirements met?
-     */
-    completeness: number;
-    /**
-     * Are edge cases handled?
-     */
-    robustness: number;
-    /**
-     * Is the code clear and understandable?
-     */
-    readability: number;
-    /**
-     * Is the code easy to modify?
-     */
-    maintainability: number;
-    /**
-     * Cyclomatic complexity score (inverted - higher is better)
-     */
-    complexity: number;
-    /**
-     * DRY score - code duplication (inverted - higher is better)
-     */
-    duplication: number;
-    /**
-     * Line and branch coverage
-     */
-    testCoverage: number;
-    /**
-     * Test meaningfulness and quality
-     */
-    testQuality: number;
-    /**
-     * Security vulnerability score (100 = no vulnerabilities)
-     */
-    security: number;
-    /**
-     * Documentation coverage
-     */
-    documentation: number;
-    /**
-     * Linting and style compliance
-     */
-    style: number;
-}
-/**
- * Quality thresholds
- */
-interface QualityThresholds {
-    /**
-     * Minimum acceptable scores (must achieve to pass)
-     */
-    minimum: {
-        overall: number;
-        testCoverage: number;
-        security: number;
-    };
-    /**
-     * Target scores (excellent quality)
-     */
-    target: {
-        overall: number;
-        testCoverage: number;
-    };
-    /**
-     * Convergence threshold (max score delta to consider converged)
-     */
-    convergenceThreshold: number;
-    /**
-     * Maximum iterations before forced completion
-     */
-    maxIterations: number;
-    /**
-     * Minimum iterations before checking convergence
-     */
-    minIterations: number;
-}
-
 /**
  * Main orchestrator interface
  */
@@ -936,226 +840,6 @@ interface InputAnalysis {
  */
 type ProjectType = "cli" | "api" | "web_app" | "library" | "service" | "full_stack" | "automation" | "unknown";
 
-/**
- * Unified thinking/reasoning mode support for all LLM providers.
- *
- * Normalizes three distinct API surfaces:
- *   - Anthropic: thinking.budget_tokens
- *   - OpenAI Chat Completions: reasoning_effort
- *   - OpenAI Responses API: reasoning.effort
- *   - Gemini: thinkingConfig.thinkingBudget
- *   - Kimi: thinking.type enabled/disabled
- */
-/**
- * Provider-agnostic thinking mode.
- * "off"    — disable thinking entirely (or keep disabled for models like Kimi)
- * "auto"   — provider default / dynamic budget
- * "low"    — minimal reasoning
- * "medium" — balanced reasoning
- * "high"   — maximum reasoning
- * { budget: N } — explicit token budget (Anthropic / Gemini only; rejected for effort-only providers)
- */
-type ThinkingMode = "off" | "auto" | "low" | "medium" | "high" | {
-    budget: number;
-};
-/**
- * Whether this provider/model uses effort buckets (OpenAI) or token budgets (Anthropic, Gemini).
- */
-type ThinkingKind = "effort" | "budget";
-
-/**
- * LLM Provider types for Corbat-Coco
- */
-
-/**
- * Message role
- */
-type MessageRole = "system" | "user" | "assistant";
-/**
- * Message content types
- */
-type MessageContent = string | Array<TextContent | ImageContent | ToolUseContent | ToolResultContent>;
-/**
- * Text content block
- */
-interface TextContent {
-    type: "text";
-    text: string;
-}
-/**
- * Image content block
- */
-interface ImageContent {
-    type: "image";
-    source: {
-        type: "base64";
-        media_type: string;
-        data: string;
-    };
-}
-/**
- * Tool use content block
- */
-interface ToolUseContent {
-    type: "tool_use";
-    id: string;
-    name: string;
-    input: Record<string, unknown>;
-    /** Gemini-specific: preserve function-call thought signature across tool turns */
-    geminiThoughtSignature?: string;
-}
-/**
- * Tool result content block
- */
-interface ToolResultContent {
-    type: "tool_result";
-    tool_use_id: string;
-    content: string;
-    is_error?: boolean;
-}
-/**
- * Chat message
- */
-interface Message {
-    role: MessageRole;
-    content: MessageContent;
-}
-/**
- * Tool definition for LLM
- */
-interface ToolDefinition$1 {
-    name: string;
-    description: string;
-    input_schema: {
-        type: "object";
-        properties: Record<string, unknown>;
-        required?: string[];
-    };
-}
-/**
- * Tool call from LLM
- */
-interface ToolCall {
-    id: string;
-    name: string;
-    input: Record<string, unknown>;
-    /** Gemini-specific: preserve function-call thought signature across tool turns */
-    geminiThoughtSignature?: string;
-}
-/**
- * Chat options
- */
-interface ChatOptions {
-    model?: string;
-    maxTokens?: number;
-    temperature?: number;
-    stopSequences?: string[];
-    system?: string;
-    timeout?: number;
-    /** Abort signal to cancel in-flight requests */
-    signal?: AbortSignal;
-    /** Thinking/reasoning mode to pass to the model (if supported) */
-    thinking?: ThinkingMode;
-}
-/**
- * Chat response
- */
-interface ChatResponse {
-    id: string;
-    content: string;
-    stopReason: "end_turn" | "max_tokens" | "stop_sequence" | "tool_use";
-    usage: {
-        inputTokens: number;
-        outputTokens: number;
-    };
-    model: string;
-}
-/**
- * Chat with tools options
- */
-interface ChatWithToolsOptions extends ChatOptions {
-    tools: ToolDefinition$1[];
-    toolChoice?: "auto" | "any" | {
-        type: "tool";
-        name: string;
-    };
-}
-/**
- * Chat with tools response
- */
-interface ChatWithToolsResponse extends ChatResponse {
-    toolCalls: ToolCall[];
-}
-/**
- * Stream chunk
- */
-interface StreamChunk {
-    type: "text" | "tool_use_start" | "tool_use_delta" | "tool_use_end" | "done";
-    text?: string;
-    toolCall?: Partial<ToolCall>;
-    stopReason?: "end_turn" | "max_tokens" | "stop_sequence" | "tool_use";
-}
-/**
- * LLM Provider interface
- */
-interface LLMProvider {
-    /**
-     * Provider identifier
-     */
-    id: string;
-    /**
-     * Provider display name
-     */
-    name: string;
-    /**
-     * Initialize the provider
-     */
-    initialize(config: ProviderConfig): Promise<void>;
-    /**
-     * Send a chat message
-     */
-    chat(messages: Message[], options?: ChatOptions): Promise<ChatResponse>;
-    /**
-     * Send a chat message with tool use
-     */
-    chatWithTools(messages: Message[], options: ChatWithToolsOptions): Promise<ChatWithToolsResponse>;
-    /**
-     * Stream a chat response
-     */
-    stream(messages: Message[], options?: ChatOptions): AsyncIterable<StreamChunk>;
-    /**
-     * Stream a chat response with tool use
-     */
-    streamWithTools(messages: Message[], options: ChatWithToolsOptions): AsyncIterable<StreamChunk>;
-    /**
-     * Count tokens in text
-     */
-    countTokens(text: string): number;
-    /**
-     * Get context window size
-     */
-    getContextWindow(): number;
-    /**
-     * Check if provider is available
-     */
-    isAvailable(): Promise<boolean>;
-}
-/**
- * Provider configuration
- */
-interface ProviderConfig {
-    apiKey?: string;
-    baseUrl?: string;
-    model?: string;
-    maxTokens?: number;
-    temperature?: number;
-    timeout?: number;
-    project?: string;
-    location?: string;
-    /** Internal: flag to indicate using Google Cloud ADC */
-    useADC?: boolean;
-}
-
 /**
  * Discovery Engine for the CONVERGE phase
  *
@@ -2990,19 +2674,19 @@ declare class AnthropicProvider implements LLMProvider {
     /**
      * Send a chat message
      */
-    chat(messages: Message[], options?: ChatOptions): Promise<ChatResponse>;
+    chat(messages: Message$1[], options?: ChatOptions): Promise<ChatResponse$1>;
     /**
      * Send a chat message with tool use
      */
-    chatWithTools(messages: Message[], options: ChatWithToolsOptions): Promise<ChatWithToolsResponse>;
+    chatWithTools(messages: Message$1[], options: ChatWithToolsOptions): Promise<ChatWithToolsResponse$1>;
     /**
      * Stream a chat response
      */
-    stream(messages: Message[], options?: ChatOptions): AsyncIterable<StreamChunk>;
+    stream(messages: Message$1[], options?: ChatOptions): AsyncIterable<StreamChunk>;
     /**
      * Stream a chat response with tool use
      */
-    streamWithTools(messages: Message[], options: ChatWithToolsOptions): AsyncIterable<StreamChunk>;
+    streamWithTools(messages: Message$1[], options: ChatWithToolsOptions): AsyncIterable<StreamChunk>;
     /**
      * Count tokens (improved heuristic for Claude models)
      *
@@ -3141,578 +2825,6 @@ declare class TaskError extends CocoError {
     });
 }
 
-/**
- * Provider and model catalog.
- *
- * This is the source of truth for model IDs, defaults, context windows,
- * pricing metadata, and provider capabilities. Endpoint adapters still own
- * request/response conversion, but they should read model metadata from here.
- */
-
-type ModelStatus = "current" | "legacy" | "deprecated" | "experimental";
-type ModelCapability = "streaming" | "tool-use" | "vision" | "reasoning-effort" | "adaptive-thinking" | "thinking-budget" | "openai-responses" | "openai-chat" | "anthropic-messages" | "gemini-generate-content";
-interface ProviderSource {
-    name: string;
-    url: string;
-    verifiedAt: string;
-}
-interface ModelPricing {
-    inputPerMillion: number;
-    outputPerMillion: number;
-}
-interface ModelCatalogEntry {
-    id: string;
-    name: string;
-    description?: string;
-    contextWindow: number;
-    maxOutputTokens?: number;
-    recommended?: boolean;
-    status: ModelStatus;
-    capabilities: ModelCapability[];
-    pricing?: ModelPricing;
-    source: ProviderSource;
-}
-interface ProviderCatalogEntry {
-    id: ProviderType;
-    defaultModel: string;
-    models: ModelCatalogEntry[];
-}
-
-/**
- * Runtime compatibility view derived from the static provider catalog.
- *
- * The catalog records what a model is; this module records how Coco should use it
- * safely at runtime, including endpoint selection and reasoning/tooling limits.
- */
-
-type ProviderEndpointStrategy = "anthropic-messages" | "openai-responses" | "openai-chat" | "gemini-generate-content";
-type ModelCompatibilityStatus = ModelStatus | "unverified";
-interface ProviderRuntimeCapability {
-    provider: ProviderType;
-    model: string;
-    catalogModel?: ModelCatalogEntry;
-    status: ModelCompatibilityStatus;
-    endpoint: ProviderEndpointStrategy;
-    supportsStreaming: boolean;
-    supportsToolUse: boolean;
-    supportsVision: boolean;
-    supportsReasoning: boolean;
-    reasoningKinds: ThinkingKind[];
-    defaultReasoning: ThinkingMode;
-    contextWindow: number;
-    maxOutputTokens?: number;
-    sourceUrl?: string;
-    restrictions: string[];
-}
-interface ProviderProbeResult extends ProviderRuntimeCapability {
-    available: boolean | "not-checked";
-    checkedAt: string;
-    error?: string;
-}
-
-/**
- * Provider exports for Corbat-Coco
- */
-
-/**
- * Supported provider types
- */
-type ProviderType = "anthropic" | "openai" | "codex" | "copilot" | "gemini" | "vertex" | "kimi" | "kimi-code" | "lmstudio" | "ollama" | "groq" | "openrouter" | "mistral" | "deepseek" | "together" | "huggingface" | "qwen";
-/**
- * Create a provider by type
- */
-declare function createProvider(type: ProviderType, config?: ProviderConfig): Promise<LLMProvider>;
-
-/**
- * Tool Registry for Corbat-Coco
- * Central management of all available tools
- */
-
-/**
- * Tool definition
- */
-interface ToolDefinition<TInput = unknown, TOutput = unknown> {
-    name: string;
-    description: string;
-    category: ToolCategory;
-    parameters: z.ZodType<TInput, any, any>;
-    execute: (params: TInput) => Promise<TOutput>;
-}
-/**
- * Tool categories
- */
-type ToolCategory = "file" | "bash" | "git" | "test" | "quality" | "build" | "deploy" | "config" | "web" | "search" | "memory" | "document";
-/**
- * Tool execution result
- */
-interface ToolResult<T = unknown> {
-    success: boolean;
-    data?: T;
-    error?: string;
-    duration: number;
-}
-/**
- * Progress callback for long-running operations
- */
-type ProgressCallback = (progress: ProgressInfo) => void;
-/**
- * Progress information
- */
-interface ProgressInfo {
-    /** Current step or phase name */
-    phase: string;
-    /** Progress percentage (0-100), null if indeterminate */
-    percent: number | null;
-    /** Human-readable message */
-    message?: string;
-    /** Estimated time remaining in ms, null if unknown */
-    estimatedTimeRemaining?: number | null;
-    /** Additional metadata */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Options for tool execution
- */
-interface ExecuteOptions {
-    /** Progress callback for long operations */
-    onProgress?: ProgressCallback;
-    /** Abort signal for cancellation */
-    signal?: AbortSignal;
-}
-/**
- * Tool registry
- */
-declare class ToolRegistry {
-    private tools;
-    private logger;
-    /**
-     * Register a tool
-     */
-    register<TInput, TOutput>(tool: ToolDefinition<TInput, TOutput>): void;
-    /**
-     * Unregister a tool
-     */
-    unregister(name: string): boolean;
-    /**
-     * Get a tool by name
-     */
-    get<TInput = unknown, TOutput = unknown>(name: string): ToolDefinition<TInput, TOutput> | undefined;
-    /**
-     * Check if a tool exists
-     */
-    has(name: string): boolean;
-    /**
-     * Get all tools
-     */
-    getAll(): ToolDefinition[];
-    /**
-     * Get tools by category
-     */
-    getByCategory(category: ToolCategory): ToolDefinition[];
-    /**
-     * Execute a tool
-     */
-    execute<TInput, TOutput>(name: string, params: TInput, options?: ExecuteOptions): Promise<ToolResult<TOutput>>;
-    /**
-     * Get tool definitions for LLM (simplified format)
-     */
-    getToolDefinitionsForLLM(): Array<{
-        name: string;
-        description: string;
-        input_schema: Record<string, unknown>;
-    }>;
-}
-/**
- * Create a new tool registry
- */
-declare function createToolRegistry(): ToolRegistry;
-
-/** Catalog-backed provider/model registry used by runtime consumers. */
-declare class ProviderRegistry {
-    listProviders(): ProviderCatalogEntry[];
-    getProvider(provider: ProviderType): ProviderCatalogEntry;
-    listModels(provider: ProviderType): ModelCatalogEntry[];
-    getModel(provider: ProviderType, model: string): ModelCatalogEntry | undefined;
-    getDefaultModel(provider: ProviderType): string;
-    getRecommendedModel(provider: ProviderType): ModelCatalogEntry;
-    getCapability(provider: ProviderType, model?: string): ProviderRuntimeCapability;
-    createProvider(provider: ProviderType, config?: ProviderConfig): Promise<LLMProvider>;
-    probe(provider: ProviderType, model: string | undefined, checkAvailability?: () => Promise<boolean>): Promise<ProviderProbeResult>;
-}
-declare function createProviderRegistry(): ProviderRegistry;
-
-/**
- * Agent mode registry.
- *
- * Modes describe the intended control flow for a runtime turn without changing
- * the provider interface. CLI, headless, and embedders share this registry.
- */
-type AgentModeId = "ask" | "plan" | "build" | "debug" | "review" | "architect";
-interface AgentModeDefinition {
-    id: AgentModeId;
-    label: string;
-    description: string;
-    readOnly: boolean;
-    preferredTools: string[];
-    requiresVerification: boolean;
-}
-declare const AGENT_MODES: Record<AgentModeId, AgentModeDefinition>;
-declare function getAgentMode(mode: AgentModeId): AgentModeDefinition;
-declare function listAgentModes(): AgentModeDefinition[];
-declare function isAgentMode(value: string): value is AgentModeId;
-
-type ReasoningEffort = "auto" | "low" | "medium" | "high" | "max";
-type RuntimeMode = AgentModeId;
-interface AgentRuntimeOptions {
-    providerType: ProviderType;
-    model?: string;
-    providerConfig?: ProviderConfig;
-    provider?: LLMProvider;
-    toolRegistry?: ToolRegistry;
-    /** Legacy CLI session store passthrough. Runtime APIs use runtimeSessionStore. */
-    sessionStore?: unknown;
-    runtimeSessionStore?: RuntimeSessionStore;
-    workflowEngine?: WorkflowEngine;
-    permissionPolicy?: PermissionPolicy;
-    eventLog?: EventLog;
-    eventLogPath?: string;
-    turnRunner?: RuntimeTurnRunner;
-    /**
-     * Publish provider/tools into Coco's legacy process-global subagent bridge.
-     * CLI/headless use this for compatibility; embedders should leave it false.
-     */
-    publishToGlobalBridge?: boolean;
-}
-interface AgentRuntimeSnapshot {
-    provider: {
-        type: ProviderType;
-        model: string;
-        capability: ProviderRuntimeCapability;
-    };
-    tools: {
-        count: number;
-        names: string[];
-    };
-    modes: AgentModeDefinition[];
-}
-type RuntimeEventType = "runtime.initialized" | "provider.attached" | "provider.created" | "provider.updated" | "turn.started" | "turn.completed" | "turn.cancelled" | "turn.failed" | "tool.started" | "tool.completed" | "tool.allowed" | "tool.blocked" | "tool.skipped" | "workflow.planned" | "workflow.started" | "workflow.completed" | "workflow.failed" | "session.created" | "session.updated" | "checkpoint.created" | "error";
-interface RuntimeEvent {
-    id: string;
-    type: RuntimeEventType;
-    timestamp: string;
-    data: Record<string, unknown>;
-}
-interface EventLog {
-    record(type: RuntimeEventType, data?: Record<string, unknown>): RuntimeEvent;
-    list(): RuntimeEvent[];
-    count(): number;
-    clear(): void;
-}
-interface PermissionDecision {
-    allowed: boolean;
-    reason?: string;
-    requiresConfirmation?: boolean;
-    risk: "read-only" | "write" | "network" | "destructive" | "secrets-sensitive";
-}
-interface PermissionPolicy {
-    canExecuteTool(mode: RuntimeMode, tool: ToolDefinition): PermissionDecision;
-    canExecuteToolInput?(mode: RuntimeMode, tool: ToolDefinition, input: Record<string, unknown>): PermissionDecision;
-}
-interface ProviderRuntimeSelection {
-    provider: ProviderType;
-    model: string;
-    thinking?: ThinkingMode;
-}
-interface RuntimeSession {
-    id: string;
-    createdAt: string;
-    updatedAt: string;
-    mode: RuntimeMode;
-    messages: Message[];
-    instructions?: string;
-    metadata: Record<string, unknown>;
-}
-interface RuntimeSessionCreateOptions {
-    id?: string;
-    mode?: RuntimeMode;
-    instructions?: string;
-    metadata?: Record<string, unknown>;
-    messages?: Message[];
-}
-interface RuntimeSessionStore {
-    create(options?: RuntimeSessionCreateOptions): RuntimeSession;
-    get(id: string): RuntimeSession | undefined;
-    update(session: RuntimeSession): RuntimeSession;
-    list(): RuntimeSession[];
-    delete(id: string): boolean;
-}
-interface RuntimeTurnInput {
-    content: string;
-    sessionId?: string;
-    mode?: RuntimeMode;
-    options?: ChatOptions;
-    metadata?: Record<string, unknown>;
-}
-interface RuntimeTurnResult {
-    sessionId: string;
-    content: string;
-    usage: {
-        inputTokens: number;
-        outputTokens: number;
-        estimated?: boolean;
-    };
-    model: string;
-    mode: RuntimeMode;
-}
-type RuntimeTurnStreamEvent = {
-    type: "text";
-    sessionId: string;
-    text: string;
-} | {
-    type: "done";
-    sessionId: string;
-    result: RuntimeTurnResult;
-} | {
-    type: "error";
-    sessionId: string;
-    error: string;
-};
-interface RuntimeTurnContext {
-    runtime: unknown;
-    session: RuntimeSession;
-    provider: LLMProvider;
-    toolRegistry: ToolRegistry;
-    permissionPolicy: PermissionPolicy;
-    eventLog: EventLog;
-}
-interface RuntimeTurnRunner {
-    run(input: RuntimeTurnInput, context: RuntimeTurnContext): Promise<RuntimeTurnResult>;
-}
-interface RuntimeToolExecutionInput {
-    sessionId?: string;
-    mode?: RuntimeMode;
-    toolName: string;
-    input: Record<string, unknown>;
-    confirmed?: boolean;
-    metadata?: Record<string, unknown>;
-}
-interface RuntimeToolExecutionResult {
-    toolName: string;
-    success: boolean;
-    output?: unknown;
-    error?: string;
-    duration: number;
-    decision: PermissionDecision;
-}
-
-type WorkflowRisk = "read-only" | "write" | "network" | "destructive" | "secrets-sensitive";
-interface WorkflowStepDefinition {
-    id: string;
-    description: string;
-    requiredTools: string[];
-    risk: WorkflowRisk;
-}
-interface WorkflowDefinition {
-    id: string;
-    name: string;
-    description: string;
-    inputSchema: string;
-    steps: WorkflowStepDefinition[];
-    checks: string[];
-    outputKind: "markdown" | "json" | "patch" | "pull-request" | "release";
-    replayable: boolean;
-}
-interface WorkflowPlan {
-    id: string;
-    workflowId: string;
-    input: Record<string, unknown>;
-    status: "planned";
-    createdAt: string;
-}
-/** Descriptive catalog of reusable workflow definitions; it does not execute workflows. */
-declare class WorkflowCatalog {
-    private workflows;
-    constructor(workflows?: WorkflowDefinition[]);
-    register(workflow: WorkflowDefinition): void;
-    get(id: string): WorkflowDefinition | undefined;
-    list(): WorkflowDefinition[];
-    createPlan(workflowId: string, input: Record<string, unknown>, eventLog?: EventLog): WorkflowPlan;
-}
-declare const DEFAULT_WORKFLOWS: WorkflowDefinition[];
-declare const WorkflowRegistry: typeof WorkflowCatalog;
-declare function createWorkflowCatalog(workflows?: WorkflowDefinition[]): WorkflowCatalog;
-declare function createWorkflowRegistry(workflows?: WorkflowDefinition[]): WorkflowCatalog;
-
-type WorkflowRunStatus = "completed" | "failed";
-interface WorkflowRunInput {
-    workflowId: string;
-    input: Record<string, unknown>;
-    plan?: WorkflowPlan;
-}
-interface WorkflowRunResult {
-    id: string;
-    workflowId: string;
-    status: WorkflowRunStatus;
-    output: unknown;
-    startedAt: string;
-    completedAt: string;
-    error?: string;
-}
-interface WorkflowRunContext {
-    workflow: WorkflowDefinition;
-    plan: WorkflowPlan;
-    eventLog: EventLog;
-}
-type WorkflowHandler = (input: Record<string, unknown>, context: WorkflowRunContext) => Promise<unknown>;
-declare class WorkflowEngine {
-    private readonly catalog;
-    private readonly eventLog;
-    private handlers;
-    constructor(catalog?: WorkflowCatalog, eventLog?: EventLog);
-    registerHandler(workflowId: string, handler: WorkflowHandler): void;
-    createPlan(workflowId: string, input: Record<string, unknown>): WorkflowPlan;
-    run(request: WorkflowRunInput): Promise<WorkflowRunResult>;
-}
-declare function createWorkflowEngine(catalog?: WorkflowCatalog, eventLog?: EventLog): WorkflowEngine;
-
-/**
- * Reusable runtime facade for wiring providers, tools, permissions, sessions,
- * and observability. It does not own the CLI loop; CLI/headless are adapters on
- * top of this boundary.
- */
-declare class AgentRuntime {
-    private readonly options;
-    readonly providerRegistry: ProviderRegistry;
-    readonly toolRegistry: ToolRegistry;
-    readonly sessionStore: unknown;
-    readonly runtimeSessionStore: RuntimeSessionStore;
-    readonly workflowEngine: WorkflowEngine;
-    readonly permissionPolicy: PermissionPolicy;
-    readonly eventLog: EventLog;
-    readonly turnRunner: RuntimeTurnRunner;
-    private providerType;
-    private model;
-    private provider?;
-    constructor(options: AgentRuntimeOptions);
-    initialize(): Promise<void>;
-    getModel(): string;
-    updateProvider(providerType: ProviderType, model: string | undefined, provider: LLMProvider): void;
-    private publishToGlobalBridge;
-    snapshot(): AgentRuntimeSnapshot;
-    createSession(options?: RuntimeSessionCreateOptions): RuntimeSession;
-    getSession(sessionId: string): RuntimeSession | undefined;
-    listSessions(): RuntimeSession[];
-    runTurn(input: RuntimeTurnInput): Promise<RuntimeTurnResult>;
-    streamTurn(input: RuntimeTurnInput): AsyncIterable<RuntimeTurnStreamEvent>;
-    executeTool(input: RuntimeToolExecutionInput): Promise<RuntimeToolExecutionResult>;
-    assertToolAllowed(mode: RuntimeMode, toolName: string, input?: Record<string, unknown>): boolean;
-}
-declare function createAgentRuntime(options: AgentRuntimeOptions): Promise<AgentRuntime>;
-
-declare class DefaultRuntimeTurnRunner implements RuntimeTurnRunner {
-    run(input: RuntimeTurnInput, context: RuntimeTurnContext): Promise<RuntimeTurnResult>;
-}
-declare function createDefaultRuntimeTurnRunner(): RuntimeTurnRunner;
-
-declare class InMemoryEventLog implements EventLog {
-    private events;
-    record(type: RuntimeEventType, data?: Record<string, unknown>): RuntimeEvent;
-    list(): RuntimeEvent[];
-    count(): number;
-    clear(): void;
-}
-declare class FileEventLog implements EventLog {
-    private readonly filePath;
-    private memory;
-    private writable;
-    constructor(filePath: string);
-    record(type: RuntimeEventType, data?: Record<string, unknown>): RuntimeEvent;
-    list(): RuntimeEvent[];
-    count(): number;
-    clear(): void;
-}
-declare function createEventLog(): EventLog;
-declare function createFileEventLog(filePath: string): EventLog;
-
-interface RuntimeHttpServerOptions {
-    maxBodyBytes?: number;
-}
-declare function createRuntimeHttpServer(runtime: AgentRuntime, options?: RuntimeHttpServerOptions): Server;
-
-declare class DefaultPermissionPolicy implements PermissionPolicy {
-    canExecuteTool(mode: RuntimeMode, tool: ToolDefinition): PermissionDecision;
-    canExecuteToolInput(mode: RuntimeMode, tool: ToolDefinition, input: Record<string, unknown>): PermissionDecision;
-}
-declare function createPermissionPolicy(): PermissionPolicy;
-
-declare class InMemoryRuntimeSessionStore implements RuntimeSessionStore {
-    private sessions;
-    create(options?: RuntimeSessionCreateOptions): RuntimeSession;
-    get(id: string): RuntimeSession | undefined;
-    update(session: RuntimeSession): RuntimeSession;
-    list(): RuntimeSession[];
-    delete(id: string): boolean;
-}
-declare class FileRuntimeSessionStore implements RuntimeSessionStore {
-    private readonly filePath;
-    private sessions;
-    constructor(filePath: string);
-    create(options?: RuntimeSessionCreateOptions): RuntimeSession;
-    get(id: string): RuntimeSession | undefined;
-    update(session: RuntimeSession): RuntimeSession;
-    list(): RuntimeSession[];
-    delete(id: string): boolean;
-    private readSessionsFromDisk;
-    private persist;
-}
-declare function createRuntimeSessionStore(): RuntimeSessionStore;
-declare function createFileRuntimeSessionStore(filePath: string): RuntimeSessionStore;
-
-type ExtensionRisk = "read-only" | "write" | "network" | "destructive" | "secrets-sensitive";
-type AgentSurface = "coco" | "claude" | "codex" | "gemini" | "opencode";
-interface SkillManifest {
-    name: string;
-    description: string;
-    triggers: string[];
-    requiredTools: string[];
-    risk: ExtensionRisk;
-    compatibleAgents: AgentSurface[];
-    sourcePath?: string;
-}
-interface RecipeStep {
-    id: string;
-    description: string;
-    requiredTools?: string[];
-    check?: string;
-}
-interface RecipeManifest {
-    name: string;
-    description: string;
-    inputs: string[];
-    suggestedModels?: string[];
-    steps: RecipeStep[];
-    checks: string[];
-    risk: ExtensionRisk;
-}
-interface McpToolPolicy {
-    server: string;
-    tool: string;
-    risk: ExtensionRisk;
-    requiresConfirmation: boolean;
-    allowedModes: string[];
-}
-declare function createMcpToolPolicy(server: string, tool: string, risk: ExtensionRisk, allowedModes?: string[]): McpToolPolicy;
-
-/**
- * Tool exports for Corbat-Coco
- */
-
-declare function registerAllTools(registry: ToolRegistry): void;
-/**
- * Create a registry with all tools registered
- */
-declare function createFullToolRegistry(): ToolRegistry;
-
 /**
  * Logging system for Corbat-Coco
  * Based on tslog with structured output
@@ -3750,4 +2862,4 @@ interface SystemProxyConfig {
  */
 declare function installProxyDispatcher(resolveSystem?: () => SystemProxyConfig | null): string | null;
 
-export { ADRGenerator, AGENT_MODES, type AgentModeDefinition, type AgentModeId, AgentRuntime, type AgentRuntimeOptions, type AgentRuntimeSnapshot, type AgentSurface, AnthropicProvider, ArchitectureGenerator, type Backlog, BacklogGenerator, CICDGenerator, type ChatOptions, type ChatResponse, type CocoConfig, CocoError, CodeGenerator, CodeReviewer, CompleteExecutor, ConfigError, ConvergeExecutor, DEFAULT_WORKFLOWS, DefaultPermissionPolicy, DefaultRuntimeTurnRunner, DiscoveryEngine, DockerGenerator, DocsGenerator, type Epic, type EventLog, type ExtensionRisk, FileEventLog, FileRuntimeSessionStore, InMemoryEventLog, InMemoryRuntimeSessionStore, type LLMProvider, type McpToolPolicy, type Message, OrchestrateExecutor, type Orchestrator, type OrchestratorConfig, OutputExecutor, type PermissionDecision, type PermissionPolicy, type Phase, type PhaseContext, PhaseError, type PhaseExecutor, type PhaseResult, type Progress, type ProjectState, ProviderRegistry, type ProviderRuntimeSelection, type QualityDimensions, type QualityScores, type QualityThresholds, type ReasoningEffort, type RecipeManifest, type RecipeStep, type RuntimeEvent, type RuntimeEventType, type RuntimeHttpServerOptions, type RuntimeMode, type RuntimeSession, type RuntimeSessionCreateOptions, type RuntimeSessionStore, type RuntimeToolExecutionInput, type RuntimeToolExecutionResult, type RuntimeTurnContext, type RuntimeTurnInput, type RuntimeTurnResult, type RuntimeTurnRunner, type RuntimeTurnStreamEvent, SessionManager, type SkillManifest, SpecificationGenerator, type Sprint, type Story, type Task, TaskError, type TaskHistory, TaskIterator, type TaskVersion, ToolRegistry, VERSION, WorkflowCatalog, type WorkflowDefinition, WorkflowEngine, type WorkflowHandler, type WorkflowPlan, WorkflowRegistry, type WorkflowRisk, type WorkflowRunContext, type WorkflowRunInput, type WorkflowRunResult, type WorkflowRunStatus, type WorkflowStepDefinition, configExists, createADRGenerator, createAgentRuntime, createAnthropicProvider, createArchitectureGenerator, createBacklogGenerator, createCICDGenerator, createCodeGenerator, createCodeReviewer, createCompleteExecutor, createConvergeExecutor, createDefaultConfig, createDefaultRuntimeTurnRunner, createDiscoveryEngine, createDockerGenerator, createDocsGenerator, createEventLog, createFileEventLog, createFileRuntimeSessionStore, createFullToolRegistry, createLogger, createMcpToolPolicy, createOrchestrateExecutor, createOrchestrator, createOutputExecutor, createPermissionPolicy, createProvider, createProviderRegistry, createRuntimeHttpServer, createRuntimeSessionStore, createSessionManager, createSpecificationGenerator, createTaskIterator, createToolRegistry, createWorkflowCatalog, createWorkflowEngine, createWorkflowRegistry, getAgentMode, installProxyDispatcher, isAgentMode, listAgentModes, loadConfig, registerAllTools, saveConfig };
+export { ADRGenerator, AnthropicProvider, ArchitectureGenerator, type Backlog, BacklogGenerator, CICDGenerator, ChatOptions, ChatResponse$1 as ChatResponse, type CocoConfig, CocoError, CodeGenerator, CodeReviewer, CompleteExecutor, ConfigError, ConvergeExecutor, DiscoveryEngine, DockerGenerator, DocsGenerator, type Epic, LLMProvider, Message$1 as Message, OrchestrateExecutor, type Orchestrator, type OrchestratorConfig, OutputExecutor, type Phase, type PhaseContext, PhaseError, type PhaseExecutor, type PhaseResult, type Progress, type ProjectState, QualityDimensions, QualityScores, SessionManager, SpecificationGenerator, type Sprint, type Story, type Task, TaskError, type TaskHistory, TaskIterator, type TaskVersion, VERSION, configExists, createADRGenerator, createAnthropicProvider, createArchitectureGenerator, createBacklogGenerator, createCICDGenerator, createCodeGenerator, createCodeReviewer, createCompleteExecutor, createConvergeExecutor, createDefaultConfig, createDiscoveryEngine, createDockerGenerator, createDocsGenerator, createLogger, createOrchestrateExecutor, createOrchestrator, createOutputExecutor, createSessionManager, createSpecificationGenerator, createTaskIterator, installProxyDispatcher, loadConfig, saveConfig };