@corbat-tech/coco 2.38.0 → 2.39.0

package/dist/adapters/index.d.ts

@@ -1,4 +1,4 @@
-import { W as RuntimeTurnStreamEvent, t as AgentRuntime } from '../agent-runtime-DeLcB0Ie.js';
+import { ac as RuntimeTurnStreamEvent, I as AgentRuntime } from '../agent-runtime-DJY9FzL_.js';
 import '../registry-CEpl9Jq0.js';
 import 'zod';
 

package/dist/{agent-runtime-DeLcB0Ie.d.ts → agent-runtime-DJY9FzL_.d.ts}

@@ -370,7 +370,7 @@ interface AgentRuntimeSnapshot {
     };
     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" | "agent.started" | "agent.tool.called" | "agent.artifact.created" | "agent.completed" | "agent.failed" | "guardrail.input" | "guardrail.output" | "guardrail.tool" | "workflow.planned" | "workflow.started" | "workflow.completed" | "workflow.failed" | "workflow.gate.failed" | "session.created" | "session.updated" | "checkpoint.created" | "error";
+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" | "agent.started" | "agent.graph.started" | "agent.graph.completed" | "agent.graph.failed" | "agent.tool.called" | "agent.handoff.created" | "agent.artifact.created" | "agent.completed" | "agent.failed" | "guardrail.input" | "guardrail.output" | "guardrail.tool" | "workflow.planned" | "workflow.started" | "workflow.completed" | "workflow.failed" | "workflow.gate.passed" | "workflow.gate.failed" | "shared_state.updated" | "session.created" | "session.updated" | "checkpoint.created" | "error";
 interface RuntimeEvent {
     id: string;
     type: RuntimeEventType;
@@ -485,6 +485,55 @@ interface RuntimeToolExecutionResult {
     decision: PermissionDecision;
 }
 
+type WorkflowRisk = "read-only" | "write" | "network" | "destructive" | "secrets-sensitive";
+interface WorkflowStepDefinition {
+    id: string;
+    description: string;
+    requiredTools: string[];
+    risk: WorkflowRisk;
+}
+interface WorkflowRetryPolicy {
+    maxAttempts: number;
+    backoffMs?: number;
+}
+interface WorkflowDefinition {
+    id: string;
+    name: string;
+    description: string;
+    inputSchema: string;
+    /** Legacy linear workflow steps. Prefer nodes for new multi-agent workflows. */
+    steps: WorkflowStepDefinition[];
+    nodes?: AgentGraphNode[];
+    edges?: AgentGraphDefinition["edges"];
+    gates?: AgentGateDefinition[];
+    retryPolicy?: WorkflowRetryPolicy;
+    parallelism?: number;
+    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;
+}
+declare function workflowToAgentGraph(workflow: WorkflowDefinition): AgentGraphDefinition;
+/** 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 AgentRole = "researcher" | "planner" | "architect" | "editor" | "coder" | "tester" | "reviewer" | "optimizer" | "security" | "qa" | "integrator" | "pm" | "docs" | "database";
 interface AgentBudget {
     maxTurns?: number;
@@ -492,6 +541,7 @@ interface AgentBudget {
     maxInputTokens?: number;
     maxOutputTokens?: number;
     maxEstimatedCostUsd?: number;
+    maxConcurrentRuns?: number;
 }
 interface AgentCapability {
     role: AgentRole;
@@ -500,7 +550,31 @@ interface AgentCapability {
     model?: string;
     temperature?: number;
     budget?: AgentBudget;
+    guardrails?: AgentGuardrailPolicy;
+}
+interface AgentGuardrailPolicy {
+    input?: boolean;
+    output?: boolean;
+    toolUse?: boolean;
+    redactSecrets?: boolean;
+    blockPromptInjection?: boolean;
 }
+interface AgentDefinition {
+    id: string;
+    role: AgentRole;
+    name: string;
+    instructions: string;
+    capability: AgentCapability;
+    outputSchema?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}
+interface LegacyAgentRoleMapping {
+    legacy: string;
+    role: AgentRole;
+    reason: string;
+}
+declare function mapLegacyAgentRole(legacyRole: string, fallback?: AgentRole): AgentRole;
+declare function listLegacyAgentRoleMappings(): LegacyAgentRoleMapping[];
 interface AgentTask {
     id: string;
     role: AgentRole;
@@ -543,6 +617,35 @@ interface AgentRunResult {
     completedAt: string;
     metadata?: Record<string, unknown>;
 }
+type AgentMessageRole = "user" | "agent" | "system" | "tool";
+interface AgentMessage {
+    id: string;
+    role: AgentMessageRole;
+    content: string;
+    taskId?: string;
+    agentRunId?: string;
+    createdAt: string;
+    metadata?: Record<string, unknown>;
+}
+interface AgentHandoff {
+    id: string;
+    fromAgentRunId: string;
+    toRole: AgentRole;
+    task: AgentTask;
+    artifacts: AgentArtifact[];
+    createdAt: string;
+    metadata?: Record<string, unknown>;
+}
+interface AgentCard {
+    id: string;
+    role: AgentRole;
+    name: string;
+    description: string;
+    skills: string[];
+    inputSchema?: Record<string, unknown>;
+    outputSchema?: Record<string, unknown>;
+    capability: AgentCapability;
+}
 type AgentGateKind = "tests" | "coverage" | "review" | "security" | "quality-score" | "human-approval";
 interface AgentGateDefinition {
     id: string;
@@ -595,7 +698,61 @@ interface SharedWorkspaceStateSnapshot {
     testResults: Record<string, unknown>;
     artifacts: AgentArtifact[];
 }
+type SharedWorkspaceRecordKind = "fact" | "decision" | "risk" | "file" | "testResult" | "artifact";
+interface SharedWorkspaceProvenance {
+    workflowRunId: string;
+    agentRunId?: string;
+    nodeId?: string;
+    taskId?: string;
+    eventId?: string;
+    confidence?: number;
+    risk?: WorkflowRisk;
+}
+interface SharedWorkspaceRecord {
+    id: string;
+    kind: SharedWorkspaceRecordKind;
+    key: string;
+    value: unknown;
+    provenance: SharedWorkspaceProvenance;
+    createdAt: string;
+}
+interface SharedWorkspaceWriteInput {
+    kind: SharedWorkspaceRecordKind;
+    key: string;
+    value: unknown;
+    provenance: SharedWorkspaceProvenance;
+    createdAt?: string;
+}
+interface SharedWorkspaceStore {
+    write(input: SharedWorkspaceWriteInput): SharedWorkspaceRecord;
+    list(): SharedWorkspaceRecord[];
+    snapshot(): SharedWorkspaceStateSnapshot;
+    readForRole(role: AgentRole): SharedWorkspaceStateSnapshot;
+    clear(): void;
+}
+declare class InMemorySharedWorkspaceStore implements SharedWorkspaceStore {
+    private records;
+    write(input: SharedWorkspaceWriteInput): SharedWorkspaceRecord;
+    list(): SharedWorkspaceRecord[];
+    snapshot(): SharedWorkspaceStateSnapshot;
+    readForRole(role: AgentRole): SharedWorkspaceStateSnapshot;
+    clear(): void;
+}
+declare class FileSharedWorkspaceStore implements SharedWorkspaceStore {
+    private readonly filePath;
+    private readonly memory;
+    private writable;
+    constructor(filePath: string);
+    write(input: SharedWorkspaceWriteInput): SharedWorkspaceRecord;
+    list(): SharedWorkspaceRecord[];
+    snapshot(): SharedWorkspaceStateSnapshot;
+    readForRole(role: AgentRole): SharedWorkspaceStateSnapshot;
+    clear(): void;
+    private readRecordsFromDisk;
+}
 declare class SharedWorkspaceState {
+    private readonly workflowRunId;
+    private readonly store;
     private facts;
     private decisions;
     private risks;
@@ -610,7 +767,101 @@ declare class SharedWorkspaceState {
     addArtifact(artifact: AgentArtifact): void;
     readForRole(role: AgentRole): SharedWorkspaceStateSnapshot;
     snapshot(): SharedWorkspaceStateSnapshot;
+    records(): SharedWorkspaceRecord[];
+}
+type ToolRiskLevel = "low" | "medium" | "high" | "critical";
+interface ToolRiskManifestEntry {
+    toolName: string;
+    risk: WorkflowRisk;
+    level: ToolRiskLevel;
+    requiredCapability?: AgentRole | AgentRole[];
+    requiresConsent?: boolean;
+    destructive?: boolean;
+    secretsSensitive?: boolean;
+    network?: boolean;
+    filesystem?: boolean;
+}
+type ToolRiskManifest = Record<string, ToolRiskManifestEntry>;
+interface AgentToolPolicyDecision {
+    allowed: boolean;
+    risk: WorkflowRisk;
+    reason?: string;
+    requiresConsent?: boolean;
+}
+declare function evaluateAgentToolPolicy(input: {
+    capability: AgentCapability;
+    toolName: string;
+    manifest?: ToolRiskManifest;
+}): AgentToolPolicyDecision;
+interface AgentTraceContext {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    workflowRunId?: string;
+    agentRunId?: string;
+    taskId?: string;
+    toolCallId?: string;
+}
+declare function createAgentTraceContext(input?: Partial<AgentTraceContext>): AgentTraceContext;
+interface AgentGraphNodeExecution {
+    node: AgentGraphNode;
+    task: AgentTask;
+    attempt: number;
+    workflowRunId: string;
+    trace: AgentTraceContext;
+    dependencyResults: Map<string, AgentRunResult>;
+    sharedState: SharedWorkspaceStore;
+    eventLog: EventLog;
+}
+type AgentGraphNodeExecutor = (execution: AgentGraphNodeExecution) => Promise<AgentRunResult>;
+type AgentGateEvaluator = (input: {
+    gate: AgentGateDefinition;
+    node: AgentGraphNode;
+    result: AgentRunResult;
+    workflowRunId: string;
+    trace: AgentTraceContext;
+    sharedState: SharedWorkspaceStore;
+    eventLog: EventLog;
+}) => Promise<{
+    passed: boolean;
+    reason?: string;
+}>;
+interface AgentGraphEngineOptions {
+    eventLog?: EventLog;
+    sharedState?: SharedWorkspaceStore;
+    nodeExecutor?: AgentGraphNodeExecutor;
+    gateEvaluator?: AgentGateEvaluator;
+    trace?: AgentTraceContext;
+}
+interface AgentGraphRunInput {
+    workflowRunId: string;
+    graph: AgentGraphDefinition;
+    input: Record<string, unknown>;
 }
+type AgentGraphRunStatus = "completed" | "failed";
+interface AgentGraphRunResult {
+    id: string;
+    status: AgentGraphRunStatus;
+    nodeResults: Record<string, AgentRunResult>;
+    artifacts: AgentArtifact[];
+    stateSnapshot: SharedWorkspaceStateSnapshot;
+    trace: AgentTraceContext;
+    startedAt: string;
+    completedAt: string;
+    error?: string;
+}
+declare class AgentGraphEngine {
+    private readonly eventLog?;
+    private readonly sharedState;
+    private readonly nodeExecutor;
+    private readonly gateEvaluator;
+    private readonly trace;
+    constructor(options?: AgentGraphEngineOptions);
+    run(input: AgentGraphRunInput): Promise<AgentGraphRunResult>;
+    private executeNode;
+    private evaluateNodeGates;
+}
+declare function createAgentGraphEngine(options?: AgentGraphEngineOptions): AgentGraphEngine;
 declare function createAgentArtifact<T>(input: Omit<AgentArtifact<T>, "id" | "createdAt"> & {
     id?: string;
     createdAt?: string;
@@ -638,55 +889,6 @@ declare function normalizeAgentRunResult(input: {
 declare function validateAgentCapabilities(capability: AgentCapability, requiredTools?: string[]): AgentGraphValidationIssue[];
 declare function validateAgentGraph(graph: AgentGraphDefinition): AgentGraphValidationResult;
 
-type WorkflowRisk = "read-only" | "write" | "network" | "destructive" | "secrets-sensitive";
-interface WorkflowStepDefinition {
-    id: string;
-    description: string;
-    requiredTools: string[];
-    risk: WorkflowRisk;
-}
-interface WorkflowRetryPolicy {
-    maxAttempts: number;
-    backoffMs?: number;
-}
-interface WorkflowDefinition {
-    id: string;
-    name: string;
-    description: string;
-    inputSchema: string;
-    /** Legacy linear workflow steps. Prefer nodes for new multi-agent workflows. */
-    steps: WorkflowStepDefinition[];
-    nodes?: AgentGraphNode[];
-    edges?: AgentGraphDefinition["edges"];
-    gates?: AgentGateDefinition[];
-    retryPolicy?: WorkflowRetryPolicy;
-    parallelism?: number;
-    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;
-}
-declare function workflowToAgentGraph(workflow: WorkflowDefinition): AgentGraphDefinition;
-/** 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;
@@ -701,6 +903,8 @@ interface WorkflowRunResult {
     startedAt: string;
     completedAt: string;
     error?: string;
+    graphResult?: AgentGraphRunResult;
+    trace?: AgentTraceContext;
 }
 interface WorkflowRunContext {
     workflow: WorkflowDefinition;
@@ -708,16 +912,25 @@ interface WorkflowRunContext {
     eventLog: EventLog;
 }
 type WorkflowHandler = (input: Record<string, unknown>, context: WorkflowRunContext) => Promise<unknown>;
+interface WorkflowEngineOptions {
+    catalog?: WorkflowCatalog;
+    eventLog?: EventLog;
+    sharedState?: SharedWorkspaceStore;
+    nodeExecutor?: AgentGraphNodeExecutor;
+}
 declare class WorkflowEngine {
     private readonly catalog;
     private readonly eventLog;
     private handlers;
-    constructor(catalog?: WorkflowCatalog, eventLog?: EventLog);
+    private readonly sharedState;
+    private nodeExecutor?;
+    constructor(catalog?: WorkflowCatalog, eventLog?: EventLog, options?: Omit<WorkflowEngineOptions, "catalog" | "eventLog">);
     registerHandler(workflowId: string, handler: WorkflowHandler): void;
+    registerNodeExecutor(executor: AgentGraphNodeExecutor): void;
     createPlan(workflowId: string, input: Record<string, unknown>): WorkflowPlan;
     run(request: WorkflowRunInput): Promise<WorkflowRunResult>;
 }
-declare function createWorkflowEngine(catalog?: WorkflowCatalog, eventLog?: EventLog): WorkflowEngine;
+declare function createWorkflowEngine(catalog?: WorkflowCatalog, eventLog?: EventLog, options?: Omit<WorkflowEngineOptions, "catalog" | "eventLog">): WorkflowEngine;
 
 /**
  * Reusable runtime facade for wiring providers, tools, permissions, sessions,
@@ -753,4 +966,4 @@ declare class AgentRuntime {
 }
 declare function createAgentRuntime(options: AgentRuntimeOptions): Promise<AgentRuntime>;
 
-export { WorkflowEngine as $, AGENT_MODES as A, type AgentTask as B, type ChatOptions as C, DEFAULT_WORKFLOWS as D, type EventLog as E, type RuntimeEvent as F, type RuntimeEventType as G, type RuntimeMode as H, type RuntimeSession as I, type RuntimeSessionCreateOptions as J, type RuntimeSessionStore as K, type LLMProvider as L, type Message as M, type RuntimeToolExecutionInput as N, type RuntimeToolExecutionResult as O, type ProviderConfig as P, type RuntimeTurnContext as Q, type ReasoningEffort as R, type StreamChunk as S, type RuntimeTurnInput as T, type RuntimeTurnResult as U, type RuntimeTurnRunner as V, type RuntimeTurnStreamEvent as W, SharedWorkspaceState as X, type SharedWorkspaceStateSnapshot as Y, WorkflowCatalog as Z, type WorkflowDefinition as _, type ChatResponse as a, type WorkflowHandler as a0, type WorkflowPlan as a1, WorkflowRegistry as a2, type WorkflowRetryPolicy as a3, type WorkflowRisk as a4, type WorkflowRunContext as a5, type WorkflowRunInput as a6, type WorkflowRunResult as a7, type WorkflowRunStatus as a8, type WorkflowStepDefinition as a9, createAgentArtifact as aa, createAgentRuntime as ab, createProvider as ac, createProviderRegistry as ad, createSummaryArtifact as ae, createWorkflowCatalog as af, createWorkflowEngine as ag, createWorkflowRegistry as ah, getAgentMode as ai, isAgentMode as aj, listAgentModes as ak, normalizeAgentRunResult as al, validateAgentCapabilities as am, validateAgentGraph as an, workflowToAgentGraph as ao, type ProviderType as ap, type ChatWithToolsOptions as b, type ChatWithToolsResponse as c, type AgentArtifact as d, type AgentArtifactKind as e, type AgentBudget as f, type AgentCapability as g, type AgentGateDefinition as h, type AgentGateKind as i, type AgentGraphDefinition as j, type AgentGraphEdge as k, type AgentGraphNode as l, type AgentGraphValidationIssue as m, type AgentGraphValidationResult as n, type AgentModeDefinition as o, type AgentModeId as p, type AgentRole as q, type AgentRunResult as r, type AgentRunStatus as s, AgentRuntime as t, type AgentRuntimeOptions as u, type AgentRuntimeSnapshot as v, type PermissionDecision as w, type PermissionPolicy as x, ProviderRegistry as y, type ProviderRuntimeSelection as z };
+export { type AgentTask as $, AGENT_MODES as A, type AgentMessageRole as B, type ChatOptions as C, type AgentModeDefinition as D, type AgentModeId as E, type AgentRole as F, type AgentRunResult as G, type AgentRunStatus as H, AgentRuntime as I, type AgentRuntimeOptions as J, type AgentRuntimeSnapshot as K, type LLMProvider as L, type Message as M, type AgentToolPolicyDecision as N, type AgentTraceContext as O, type ProviderConfig as P, DEFAULT_WORKFLOWS as Q, type EventLog as R, type StreamChunk as S, FileSharedWorkspaceStore as T, InMemorySharedWorkspaceStore as U, type LegacyAgentRoleMapping as V, type PermissionDecision as W, type PermissionPolicy as X, ProviderRegistry as Y, type ProviderRuntimeSelection as Z, type ReasoningEffort as _, type ChatResponse as a, type RuntimeEvent as a0, type RuntimeEventType as a1, type RuntimeMode as a2, type RuntimeSession as a3, type RuntimeSessionCreateOptions as a4, type RuntimeSessionStore as a5, type RuntimeToolExecutionInput as a6, type RuntimeToolExecutionResult as a7, type RuntimeTurnContext as a8, type RuntimeTurnInput as a9, createAgentArtifact as aA, createAgentGraphEngine as aB, createAgentRuntime as aC, createAgentTraceContext as aD, createProvider as aE, createProviderRegistry as aF, createSummaryArtifact as aG, createWorkflowCatalog as aH, createWorkflowEngine as aI, createWorkflowRegistry as aJ, evaluateAgentToolPolicy as aK, getAgentMode as aL, isAgentMode as aM, listAgentModes as aN, listLegacyAgentRoleMappings as aO, mapLegacyAgentRole as aP, normalizeAgentRunResult as aQ, validateAgentCapabilities as aR, validateAgentGraph as aS, workflowToAgentGraph as aT, type ProviderType as aU, type RuntimeTurnResult as aa, type RuntimeTurnRunner as ab, type RuntimeTurnStreamEvent as ac, type SharedWorkspaceProvenance as ad, type SharedWorkspaceRecord as ae, type SharedWorkspaceRecordKind as af, SharedWorkspaceState as ag, type SharedWorkspaceStateSnapshot as ah, type SharedWorkspaceStore as ai, type SharedWorkspaceWriteInput as aj, type ToolRiskLevel as ak, type ToolRiskManifest as al, type ToolRiskManifestEntry as am, WorkflowCatalog as an, type WorkflowDefinition as ao, WorkflowEngine as ap, type WorkflowHandler as aq, type WorkflowPlan as ar, WorkflowRegistry as as, type WorkflowRetryPolicy as at, type WorkflowRisk as au, type WorkflowRunContext as av, type WorkflowRunInput as aw, type WorkflowRunResult as ax, type WorkflowRunStatus as ay, type WorkflowStepDefinition as az, type ChatWithToolsOptions as b, type ChatWithToolsResponse as c, type AgentArtifact as d, type AgentArtifactKind as e, type AgentBudget as f, type AgentCapability as g, type AgentCard as h, type AgentDefinition as i, type AgentGateDefinition as j, type AgentGateKind as k, type AgentGraphDefinition as l, type AgentGraphEdge as m, AgentGraphEngine as n, type AgentGraphEngineOptions as o, type AgentGraphNode as p, type AgentGraphNodeExecution as q, type AgentGraphNodeExecutor as r, type AgentGraphRunInput as s, type AgentGraphRunResult as t, type AgentGraphRunStatus as u, type AgentGraphValidationIssue as v, type AgentGraphValidationResult as w, type AgentGuardrailPolicy as x, type AgentHandoff as y, type AgentMessage as z };

package/dist/{blueprints-BWcCJfnN.d.ts → blueprints-DYgm3K65.d.ts}

@@ -1,4 +1,4 @@
-import { ap as ProviderType, P as ProviderConfig, L as LLMProvider, E as EventLog, V as RuntimeTurnRunner, t as AgentRuntime, I as RuntimeSession, T as RuntimeTurnInput, U as RuntimeTurnResult } from './agent-runtime-DeLcB0Ie.js';
+import { aU as ProviderType, P as ProviderConfig, L as LLMProvider, R as EventLog, ab as RuntimeTurnRunner, I as AgentRuntime, a3 as RuntimeSession, a9 as RuntimeTurnInput, aa as RuntimeTurnResult } from './agent-runtime-DJY9FzL_.js';
 import { T as ToolRegistry } from './registry-CEpl9Jq0.js';
 import { z } from 'zod';