oxe-cc 0.9.3 → 1.2.1

package/lib/runtime/reducers/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./run-state-reducer"), exports);
+__exportStar(require("./debug-reducer"), exports);

package/lib/runtime/reducers/run-state-reducer.d.ts

@@ -0,0 +1,46 @@
+import type { OxeEvent } from '../events/envelope';
+import type { Run } from '../models/run';
+import type { WorkItem } from '../models/work-item';
+import type { Attempt } from '../models/attempt';
+import type { Workspace } from '../models/workspace';
+export interface PolicyDecisionRecord {
+    allowed: boolean;
+    gate_required: boolean;
+    reason: string;
+    rule_id: string | null;
+}
+export interface ToolFailureRecord {
+    tool: string;
+    error: string;
+    timestamp: string;
+}
+export interface RunState {
+    run: Run | null;
+    workItems: Map<string, WorkItem>;
+    attempts: Map<string, Attempt[]>;
+    workspaces: Map<string, Workspace>;
+    completedWorkItems: Set<string>;
+    failedWorkItems: Set<string>;
+    blockedWorkItems: Set<string>;
+    retryCounts: Map<string, number>;
+    policyDecisions: Map<string, PolicyDecisionRecord>;
+    pendingGates: Set<string>;
+    resolvedGates: Map<string, {
+        decision: string;
+        actor?: string;
+    }>;
+    verificationStatus: Map<string, 'started' | 'completed' | 'failed'>;
+    evidenceRefs: Map<string, string[]>;
+    toolFailures: Map<string, ToolFailureRecord[]>;
+}
+export declare function createEmptyRunState(): RunState;
+export declare function reduce(events: OxeEvent[]): RunState;
+export { applyEvent as applyEventExported };
+declare function applyEvent(state: RunState, event: OxeEvent): RunState;
+export declare function getWorkItemStatus(state: RunState, workItemId: string): WorkItem['status'] | null;
+export declare function getAttemptCount(state: RunState, workItemId: string): number;
+export declare function getRetryCount(state: RunState, workItemId: string): number;
+export declare function getPolicyDecision(state: RunState, workItemId: string): PolicyDecisionRecord | null;
+export declare function getVerificationStatus(state: RunState, workItemId: string): 'started' | 'completed' | 'failed' | null;
+export declare function getEvidenceRefs(state: RunState, workItemId: string): string[];
+export declare function getToolFailures(state: RunState, workItemId: string): ToolFailureRecord[];

package/lib/runtime/reducers/run-state-reducer.js

@@ -0,0 +1,226 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEmptyRunState = createEmptyRunState;
+exports.reduce = reduce;
+exports.applyEventExported = applyEvent;
+exports.getWorkItemStatus = getWorkItemStatus;
+exports.getAttemptCount = getAttemptCount;
+exports.getRetryCount = getRetryCount;
+exports.getPolicyDecision = getPolicyDecision;
+exports.getVerificationStatus = getVerificationStatus;
+exports.getEvidenceRefs = getEvidenceRefs;
+exports.getToolFailures = getToolFailures;
+function createEmptyRunState() {
+    return {
+        run: null,
+        workItems: new Map(),
+        attempts: new Map(),
+        workspaces: new Map(),
+        completedWorkItems: new Set(),
+        failedWorkItems: new Set(),
+        blockedWorkItems: new Set(),
+        retryCounts: new Map(),
+        policyDecisions: new Map(),
+        pendingGates: new Set(),
+        resolvedGates: new Map(),
+        verificationStatus: new Map(),
+        evidenceRefs: new Map(),
+        toolFailures: new Map(),
+    };
+}
+function reduce(events) {
+    return events.reduce(applyEvent, createEmptyRunState());
+}
+function applyEvent(state, event) {
+    switch (event.type) {
+        case 'RunStarted': {
+            const run = event.payload;
+            return { ...state, run };
+        }
+        case 'RunCompleted': {
+            if (!state.run)
+                return state;
+            const status = event.payload.status ?? 'completed';
+            return {
+                ...state,
+                run: { ...state.run, status, ended_at: event.timestamp },
+            };
+        }
+        case 'WorkItemReady': {
+            if (!event.work_item_id)
+                return state;
+            const workItems = new Map(state.workItems);
+            const existing = workItems.get(event.work_item_id);
+            if (existing) {
+                workItems.set(event.work_item_id, { ...existing, status: 'ready' });
+            }
+            else {
+                const item = event.payload;
+                workItems.set(event.work_item_id, { ...item, work_item_id: event.work_item_id, status: 'ready' });
+            }
+            return { ...state, workItems };
+        }
+        case 'AttemptStarted': {
+            if (!event.work_item_id || !event.attempt_id)
+                return state;
+            const attempts = new Map(state.attempts);
+            const attempt = {
+                attempt_id: event.attempt_id,
+                work_item_id: event.work_item_id,
+                attempt_number: event.payload.attempt_number ?? 1,
+                workspace_id: null,
+                agent_profile: null,
+                model: null,
+                started_at: event.timestamp,
+                ended_at: null,
+                outcome: null,
+            };
+            const existing = attempts.get(event.work_item_id) ?? [];
+            attempts.set(event.work_item_id, [...existing, attempt]);
+            return { ...state, attempts };
+        }
+        case 'WorkspaceAllocated': {
+            const ws = event.payload;
+            if (!ws.workspace_id)
+                return state;
+            const workspaces = new Map(state.workspaces);
+            workspaces.set(ws.workspace_id, { ...ws, status: 'ready' });
+            return { ...state, workspaces };
+        }
+        case 'WorkItemCompleted': {
+            if (!event.work_item_id)
+                return state;
+            const workItems = new Map(state.workItems);
+            const item = workItems.get(event.work_item_id);
+            if (item)
+                workItems.set(event.work_item_id, { ...item, status: 'completed' });
+            const completedWorkItems = new Set(state.completedWorkItems);
+            completedWorkItems.add(event.work_item_id);
+            // Collect evidence refs from payload
+            const evidence = event.payload.evidence ?? [];
+            if (evidence.length > 0) {
+                const evidenceRefs = new Map(state.evidenceRefs);
+                const existing = evidenceRefs.get(event.work_item_id) ?? [];
+                evidenceRefs.set(event.work_item_id, [...existing, ...evidence]);
+                return { ...state, workItems, completedWorkItems, evidenceRefs };
+            }
+            return { ...state, workItems, completedWorkItems };
+        }
+        case 'WorkItemBlocked': {
+            if (!event.work_item_id)
+                return state;
+            const workItems = new Map(state.workItems);
+            const item = workItems.get(event.work_item_id);
+            if (item)
+                workItems.set(event.work_item_id, { ...item, status: 'blocked' });
+            const blockedWorkItems = new Set(state.blockedWorkItems);
+            blockedWorkItems.add(event.work_item_id);
+            return { ...state, workItems, blockedWorkItems };
+        }
+        case 'RetryScheduled': {
+            if (!event.work_item_id)
+                return state;
+            const retryCounts = new Map(state.retryCounts);
+            const current = retryCounts.get(event.work_item_id) ?? 0;
+            retryCounts.set(event.work_item_id, current + 1);
+            return { ...state, retryCounts };
+        }
+        case 'PolicyEvaluated': {
+            const p = event.payload;
+            const key = p.work_item_id ?? event.work_item_id;
+            if (!key)
+                return state;
+            const policyDecisions = new Map(state.policyDecisions);
+            policyDecisions.set(key, {
+                allowed: p.allowed ?? true,
+                gate_required: p.gate_required ?? false,
+                reason: p.reason ?? '',
+                rule_id: p.rule_id ?? null,
+            });
+            return { ...state, policyDecisions };
+        }
+        case 'GateRequested': {
+            const gateId = event.payload.gate_id;
+            if (!gateId)
+                return state;
+            const pendingGates = new Set(state.pendingGates);
+            pendingGates.add(gateId);
+            return { ...state, pendingGates };
+        }
+        case 'GateResolved': {
+            const p = event.payload;
+            if (!p.gate_id)
+                return state;
+            const pendingGates = new Set(state.pendingGates);
+            pendingGates.delete(p.gate_id);
+            const resolvedGates = new Map(state.resolvedGates);
+            resolvedGates.set(p.gate_id, { decision: p.decision ?? 'approved', actor: p.actor });
+            return { ...state, pendingGates, resolvedGates };
+        }
+        case 'VerificationStarted': {
+            const key = event.work_item_id ?? event.payload.work_item_id;
+            if (!key)
+                return state;
+            const verificationStatus = new Map(state.verificationStatus);
+            verificationStatus.set(key, 'started');
+            return { ...state, verificationStatus };
+        }
+        case 'VerificationCompleted': {
+            const p = event.payload;
+            const key = event.work_item_id ?? p.work_item_id;
+            if (!key)
+                return state;
+            const verificationStatus = new Map(state.verificationStatus);
+            verificationStatus.set(key, p.status ?? 'completed');
+            return { ...state, verificationStatus };
+        }
+        case 'ToolFailed': {
+            if (!event.work_item_id)
+                return state;
+            const p = event.payload;
+            const toolFailures = new Map(state.toolFailures);
+            const existing = toolFailures.get(event.work_item_id) ?? [];
+            toolFailures.set(event.work_item_id, [
+                ...existing,
+                { tool: p.tool ?? 'unknown', error: p.error ?? '', timestamp: event.timestamp },
+            ]);
+            return { ...state, toolFailures };
+        }
+        case 'EvidenceCollected': {
+            const p = event.payload;
+            const key = event.work_item_id ?? p.work_item_id;
+            if (!key)
+                return state;
+            const refs = p.refs ?? (p.ref ? [p.ref] : []);
+            if (refs.length === 0)
+                return state;
+            const evidenceRefs = new Map(state.evidenceRefs);
+            const existing = evidenceRefs.get(key) ?? [];
+            evidenceRefs.set(key, [...existing, ...refs]);
+            return { ...state, evidenceRefs };
+        }
+        default:
+            return state;
+    }
+}
+function getWorkItemStatus(state, workItemId) {
+    return state.workItems.get(workItemId)?.status ?? null;
+}
+function getAttemptCount(state, workItemId) {
+    return state.attempts.get(workItemId)?.length ?? 0;
+}
+function getRetryCount(state, workItemId) {
+    return state.retryCounts.get(workItemId) ?? 0;
+}
+function getPolicyDecision(state, workItemId) {
+    return state.policyDecisions.get(workItemId) ?? null;
+}
+function getVerificationStatus(state, workItemId) {
+    return state.verificationStatus.get(workItemId) ?? null;
+}
+function getEvidenceRefs(state, workItemId) {
+    return state.evidenceRefs.get(workItemId) ?? [];
+}
+function getToolFailures(state, workItemId) {
+    return state.toolFailures.get(workItemId) ?? [];
+}

package/lib/runtime/scheduler/agent-registry.d.ts

@@ -0,0 +1,44 @@
+import type { TaskExecutor } from './scheduler';
+import type { WorkspaceManager } from '../workspace/workspace-manager';
+import type { AgentRole, AgentActionLog } from './agent-roles';
+export type AgentStatus = 'idle' | 'running' | 'paused' | 'failed' | 'timeout';
+export interface AgentHeartbeat {
+    agent_id: string;
+    last_seen: string;
+    current_task: string | null;
+    status: AgentStatus;
+}
+export interface RegisteredAgent {
+    id: string;
+    executor: TaskExecutor;
+    workspaceManager: WorkspaceManager;
+    assignedTaskIds: string[];
+    heartbeat: AgentHeartbeat;
+    role?: AgentRole;
+    actionLog: AgentActionLog[];
+}
+export declare class AgentRegistry {
+    private agents;
+    private readonly heartbeatTimeoutMs;
+    constructor(heartbeatTimeoutMs?: number);
+    register(id: string, executor: TaskExecutor, workspaceManager: WorkspaceManager, assignedTaskIds?: string[], role?: AgentRole): RegisteredAgent;
+    unregister(id: string): void;
+    beat(id: string, currentTask?: string | null): void;
+    setStatus(id: string, status: AgentStatus): void;
+    isAlive(id: string): boolean;
+    /** Returns agents that haven't sent a heartbeat within the timeout window */
+    timedOut(): RegisteredAgent[];
+    liveAgents(): RegisteredAgent[];
+    get(id: string): RegisteredAgent | null;
+    list(): RegisteredAgent[];
+    /**
+     * Reassign orphaned tasks from timed-out agents to a fallback agent.
+     * Returns the list of task IDs that were reassigned.
+     */
+    failover(fallbackAgentId: string): string[];
+    /** Return all agents assigned to a given role */
+    getByRole(role: AgentRole): RegisteredAgent[];
+    /** Append an action log entry for a registered agent (no-op if unknown) */
+    logAction(agentId: string, log: AgentActionLog): void;
+    clear(): void;
+}

package/lib/runtime/scheduler/agent-registry.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentRegistry = void 0;
+class AgentRegistry {
+    constructor(heartbeatTimeoutMs = 30000) {
+        this.agents = new Map();
+        this.heartbeatTimeoutMs = heartbeatTimeoutMs;
+    }
+    register(id, executor, workspaceManager, assignedTaskIds = [], role) {
+        if (this.agents.has(id))
+            throw new Error(`Agent "${id}" is already registered`);
+        const agent = {
+            id,
+            executor,
+            workspaceManager,
+            assignedTaskIds,
+            heartbeat: {
+                agent_id: id,
+                last_seen: new Date().toISOString(),
+                current_task: null,
+                status: 'idle',
+            },
+            role,
+            actionLog: [],
+        };
+        this.agents.set(id, agent);
+        return agent;
+    }
+    unregister(id) {
+        this.agents.delete(id);
+    }
+    beat(id, currentTask = null) {
+        const agent = this.agents.get(id);
+        if (!agent)
+            return;
+        agent.heartbeat.last_seen = new Date().toISOString();
+        agent.heartbeat.current_task = currentTask;
+        agent.heartbeat.status = currentTask ? 'running' : 'idle';
+    }
+    setStatus(id, status) {
+        const agent = this.agents.get(id);
+        if (agent)
+            agent.heartbeat.status = status;
+    }
+    isAlive(id) {
+        const agent = this.agents.get(id);
+        if (!agent)
+            return false;
+        const elapsed = Date.now() - new Date(agent.heartbeat.last_seen).getTime();
+        return elapsed < this.heartbeatTimeoutMs;
+    }
+    /** Returns agents that haven't sent a heartbeat within the timeout window */
+    timedOut() {
+        return [...this.agents.values()].filter((a) => !this.isAlive(a.id));
+    }
+    liveAgents() {
+        return [...this.agents.values()].filter((a) => this.isAlive(a.id));
+    }
+    get(id) {
+        return this.agents.get(id) ?? null;
+    }
+    list() {
+        return [...this.agents.values()];
+    }
+    /**
+     * Reassign orphaned tasks from timed-out agents to a fallback agent.
+     * Returns the list of task IDs that were reassigned.
+     */
+    failover(fallbackAgentId) {
+        const fallback = this.agents.get(fallbackAgentId);
+        if (!fallback)
+            throw new Error(`Fallback agent "${fallbackAgentId}" not found`);
+        const orphaned = [];
+        for (const agent of this.timedOut()) {
+            orphaned.push(...agent.assignedTaskIds);
+            agent.assignedTaskIds = [];
+            agent.heartbeat.status = 'failed';
+        }
+        fallback.assignedTaskIds = [...fallback.assignedTaskIds, ...orphaned];
+        return orphaned;
+    }
+    /** Return all agents assigned to a given role */
+    getByRole(role) {
+        return [...this.agents.values()].filter((a) => a.role === role);
+    }
+    /** Append an action log entry for a registered agent (no-op if unknown) */
+    logAction(agentId, log) {
+        const agent = this.agents.get(agentId);
+        if (agent)
+            agent.actionLog.push(log);
+    }
+    clear() {
+        this.agents.clear();
+    }
+}
+exports.AgentRegistry = AgentRegistry;

package/lib/runtime/scheduler/agent-roles.d.ts

@@ -0,0 +1,54 @@
+import type { TaskResult } from './scheduler';
+export type AgentRole = 'planner' | 'executor' | 'reviewer' | 'verifier';
+export interface AgentBudget {
+    max_tokens: number;
+    max_time_ms: number;
+    max_retries: number;
+    consumed_tokens: number;
+    consumed_time_ms: number;
+    consumed_retries: number;
+}
+export interface CooperativeHandoff {
+    handoff_id: string;
+    from_agent_id: string;
+    to_agent_id: string;
+    from_role: AgentRole;
+    to_role: AgentRole;
+    work_item_id: string;
+    context_pack_ref: string | null;
+    transferred_at: string;
+}
+export interface AgentActionLog {
+    agent_id: string;
+    role: AgentRole;
+    work_item_id: string;
+    action: 'execute' | 'verify' | 'review' | 'plan';
+    result: 'success' | 'failure';
+    duration_ms: number;
+    timestamp: string;
+}
+export declare function createBudget(opts?: Partial<Omit<AgentBudget, 'consumed_tokens' | 'consumed_time_ms' | 'consumed_retries'>>): AgentBudget;
+export declare function consumeBudget(budget: AgentBudget, delta: {
+    tokens?: number;
+    time_ms?: number;
+    retries?: number;
+}): AgentBudget;
+export declare function isBudgetExhausted(budget: AgentBudget): boolean;
+export declare function buildHandoff(opts: {
+    from_agent_id: string;
+    to_agent_id: string;
+    from_role: AgentRole;
+    to_role: AgentRole;
+    work_item_id: string;
+    context_pack_ref?: string | null;
+}): CooperativeHandoff;
+export declare class ArbitrationEngine {
+    /**
+     * Choose the best result from multiple competing agents.
+     * Prefers success; among successes prefers more evidence; falls back to first.
+     */
+    arbitrate(results: Array<{
+        agent_id: string;
+        result: TaskResult;
+    }>): TaskResult;
+}

package/lib/runtime/scheduler/agent-roles.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArbitrationEngine = void 0;
+exports.createBudget = createBudget;
+exports.consumeBudget = consumeBudget;
+exports.isBudgetExhausted = isBudgetExhausted;
+exports.buildHandoff = buildHandoff;
+function createBudget(opts = {}) {
+    return {
+        max_tokens: opts.max_tokens ?? Infinity,
+        max_time_ms: opts.max_time_ms ?? Infinity,
+        max_retries: opts.max_retries ?? Infinity,
+        consumed_tokens: 0,
+        consumed_time_ms: 0,
+        consumed_retries: 0,
+    };
+}
+function consumeBudget(budget, delta) {
+    return {
+        ...budget,
+        consumed_tokens: budget.consumed_tokens + (delta.tokens ?? 0),
+        consumed_time_ms: budget.consumed_time_ms + (delta.time_ms ?? 0),
+        consumed_retries: budget.consumed_retries + (delta.retries ?? 0),
+    };
+}
+function isBudgetExhausted(budget) {
+    return (budget.consumed_tokens >= budget.max_tokens ||
+        budget.consumed_time_ms >= budget.max_time_ms ||
+        budget.consumed_retries >= budget.max_retries);
+}
+function buildHandoff(opts) {
+    return {
+        handoff_id: `hoff-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 6)}`,
+        from_agent_id: opts.from_agent_id,
+        to_agent_id: opts.to_agent_id,
+        from_role: opts.from_role,
+        to_role: opts.to_role,
+        work_item_id: opts.work_item_id,
+        context_pack_ref: opts.context_pack_ref ?? null,
+        transferred_at: new Date().toISOString(),
+    };
+}
+// ─── ArbitrationEngine ────────────────────────────────────────────────────────
+class ArbitrationEngine {
+    /**
+     * Choose the best result from multiple competing agents.
+     * Prefers success; among successes prefers more evidence; falls back to first.
+     */
+    arbitrate(results) {
+        if (results.length === 0) {
+            return { success: false, failure_class: null, evidence: [], output: 'no results to arbitrate' };
+        }
+        const successes = results.filter((r) => r.result.success);
+        if (successes.length === 0) {
+            return results[0].result;
+        }
+        // Among successes, prefer the one with most evidence
+        successes.sort((a, b) => b.result.evidence.length - a.result.evidence.length);
+        return successes[0].result;
+    }
+}
+exports.ArbitrationEngine = ArbitrationEngine;

package/lib/runtime/scheduler/index.d.ts

@@ -0,0 +1,4 @@
+export * from './scheduler';
+export * from './run-journal';
+export * from './agent-registry';
+export * from './agent-roles';

package/lib/runtime/scheduler/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./scheduler"), exports);
+__exportStar(require("./run-journal"), exports);
+__exportStar(require("./agent-registry"), exports);
+__exportStar(require("./agent-roles"), exports);

package/lib/runtime/scheduler/multi-agent-coordinator.d.ts

@@ -0,0 +1,36 @@
+import type { ExecutionGraph } from '../compiler/graph-compiler';
+import type { WorkspaceManager } from '../workspace/workspace-manager';
+import type { TaskExecutor, SchedulerContext } from './scheduler';
+import type { CooperativeHandoff } from './agent-roles';
+export type CoordinationMode = 'parallel' | 'competitive' | 'cooperative';
+export interface AgentSpec {
+    id: string;
+    executor: TaskExecutor;
+    workspaceManager: WorkspaceManager;
+    /** Task IDs this agent is responsible for (used in parallel mode) */
+    assignedTaskIds?: string[];
+}
+export interface CoordinationOptions {
+    mode: CoordinationMode;
+    agents: AgentSpec[];
+    projectRoot: string;
+    sessionId: string | null;
+    runId: string;
+    onEvent?: SchedulerContext['onEvent'];
+}
+export interface CoordinationResult {
+    mode: CoordinationMode;
+    run_id: string;
+    completed: string[];
+    failed: string[];
+    blocked: string[];
+    agent_results: Array<{
+        agent_id: string;
+        completed: string[];
+        failed: string[];
+    }>;
+    handoffs?: CooperativeHandoff[];
+}
+export declare class MultiAgentCoordinator {
+    run(graph: ExecutionGraph, opts: CoordinationOptions): Promise<CoordinationResult>;
+}