@viberlabs/orchestrator 2.1.0

package/dist/orchestrator/src/orca/index.d.ts

@@ -0,0 +1,137 @@
+/**
+ * DOCUMENT: ORCA STATE MACHINE
+ * PROJECT: VIBER Universal v2
+ * PURPOSE: XState v5 state machine for task orchestration
+ * UPDATE PATTERN: Update when orchestration states change
+ * LOCATION: packages/orchestrator/src/orca/index.ts
+ * RELATED: pool, workflow, FLL validation
+ * LAST UPDATED: 2026-03-06
+ */
+import type { FllValidationResult } from "@viberlabs/viber-core/engine";
+import type { Task, Agent } from "@viberlabs/viber-core/db";
+export interface OrcaContext {
+    task: Task | null;
+    validation: FllValidationResult | null;
+    agents: Agent[];
+    error: string | null;
+    retries: number;
+    sessionId: string | null;
+}
+export type OrcaEvent = {
+    type: "VALIDATE";
+    task: Task;
+} | {
+    type: "EXECUTE";
+    agents: Agent[];
+} | {
+    type: "REVIEW";
+    results: any;
+} | {
+    type: "COMPLETE";
+    summary: string;
+} | {
+    type: "FAIL";
+    error: string;
+} | {
+    type: "RETRY";
+} | {
+    type: "RESET";
+};
+export type OrcaState = "idle" | "validating" | "planning" | "orchestrating" | "executing" | "reviewing" | "completed" | "failed";
+export declare const orcaMachine: import("xstate").StateMachine<OrcaContext, OrcaEvent, {
+    [x: string]: import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<{
+        valid: boolean;
+        probability: number;
+        position: "peak";
+        premises: any[];
+        contradictions: any[];
+        warnings: any[];
+    }, {
+        task: Task;
+    }, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<{
+        success: boolean;
+        results: {
+            agentId: string;
+            output: string;
+            artifacts: any[];
+        }[];
+    }, {
+        agents: Agent[];
+    }, import("xstate").EventObject>>;
+}, {
+    src: "validateTask";
+    logic: import("xstate").PromiseActorLogic<{
+        valid: boolean;
+        probability: number;
+        position: "peak";
+        premises: any[];
+        contradictions: any[];
+        warnings: any[];
+    }, {
+        task: Task;
+    }, import("xstate").EventObject>;
+    id: string;
+} | {
+    src: "executeAgents";
+    logic: import("xstate").PromiseActorLogic<{
+        success: boolean;
+        results: {
+            agentId: string;
+            output: string;
+            artifacts: any[];
+        }[];
+    }, {
+        agents: Agent[];
+    }, import("xstate").EventObject>;
+    id: string;
+}, {
+    type: "setTask";
+    params: {};
+} | {
+    type: "setValidation";
+    params: {};
+} | {
+    type: "setAgents";
+    params: {};
+} | {
+    type: "setError";
+    params: {};
+} | {
+    type: "incrementRetry";
+    params: {};
+} | {
+    type: "reset";
+    params: {};
+}, {
+    type: "isValidTask";
+    params: unknown;
+} | {
+    type: "canRetry";
+    params: unknown;
+} | {
+    type: "isPeak";
+    params: unknown;
+} | {
+    type: "isSlope";
+    params: unknown;
+} | {
+    type: "isValley";
+    params: unknown;
+}, never, "validating" | "executing" | "completed" | "failed" | "idle" | "planning" | "orchestrating" | "reviewing", string, {}, {}, import("xstate").EventObject, import("xstate").MetaObject, {
+    id: "orca";
+    states: {
+        readonly idle: {};
+        readonly validating: {};
+        readonly planning: {};
+        readonly orchestrating: {};
+        readonly executing: {};
+        readonly reviewing: {};
+        readonly completed: {};
+        readonly failed: {};
+    };
+}>;
+export declare class Orca {
+    constructor();
+    orchestrate(_task: Task, _agents: Agent[]): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/orchestrator/src/orca/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/orca/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAM5D,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACvC,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAMD,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,KAAK,EAAE,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,GAAG,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAMtB,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,YAAY,GACZ,UAAU,GACV,eAAe,GACf,WAAW,GACX,WAAW,GACX,WAAW,GACX,QAAQ,CAAC;AA0Cb,eAAO,MAAM,WAAW;;;;;;;;;cApCyC,IAAI;;;;;;;;;gBAkB9B,KAAK,EAAE;;;;;;;;;;;;cAlBmB,IAAI;;;;;;;;;;;;;gBAkB9B,KAAK,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6K5C,CAAC;AAMH,qBAAa,IAAI;;IAKT,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAGhE"}

package/dist/orchestrator/src/orca/index.js

@@ -0,0 +1,215 @@
+"use strict";
+/**
+ * DOCUMENT: ORCA STATE MACHINE
+ * PROJECT: VIBER Universal v2
+ * PURPOSE: XState v5 state machine for task orchestration
+ * UPDATE PATTERN: Update when orchestration states change
+ * LOCATION: packages/orchestrator/src/orca/index.ts
+ * RELATED: pool, workflow, FLL validation
+ * LAST UPDATED: 2026-03-06
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Orca = exports.orcaMachine = void 0;
+const xstate_1 = require("xstate");
+// ============================================================================
+// Validation Actor (would call FLL validation)
+// ============================================================================
+const validateTask = (0, xstate_1.fromPromise)(async (_input) => {
+    // This would call FLL validation
+    // For now, return a mock result
+    return {
+        valid: true,
+        probability: 0.85,
+        position: "peak",
+        premises: [],
+        contradictions: [],
+        warnings: [],
+    };
+});
+// ============================================================================
+// Execution Actor (would spawn and manage agents)
+// ============================================================================
+const executeAgents = (0, xstate_1.fromPromise)(async ({ input }) => {
+    // This would spawn agents via OpenCode
+    // For now, return mock results
+    return {
+        success: true,
+        results: input.agents.map((a) => ({
+            agentId: a.id,
+            output: "Task completed",
+            artifacts: [],
+        })),
+    };
+});
+// ============================================================================
+// Orca State Machine
+// ============================================================================
+exports.orcaMachine = (0, xstate_1.setup)({
+    types: {
+        context: {},
+        events: {},
+    },
+    actors: {
+        validateTask,
+        executeAgents,
+    },
+    guards: {
+        isValidTask: ({ context }) => context.validation?.valid ?? false,
+        canRetry: ({ context }) => context.retries < 3,
+        isPeak: ({ context }) => context.validation?.position === "peak",
+        isSlope: ({ context }) => context.validation?.position === "slope",
+        isValley: ({ context }) => context.validation?.position === "valley",
+    },
+    actions: {
+        setTask: (0, xstate_1.assign)({
+            task: ({ event }) => ("task" in event ? event.task : null),
+        }),
+        setValidation: (0, xstate_1.assign)({
+            validation: ({ event }) => ("validation" in event ? event.validation : null),
+        }),
+        setAgents: (0, xstate_1.assign)({
+            agents: ({ event }) => ("agents" in event ? event.agents : []),
+        }),
+        setError: (0, xstate_1.assign)({
+            error: ({ event }) => ("error" in event ? event.error : null),
+        }),
+        incrementRetry: (0, xstate_1.assign)({
+            retries: ({ context }) => context.retries + 1,
+        }),
+        reset: (0, xstate_1.assign)({
+            task: null,
+            validation: null,
+            agents: [],
+            error: null,
+            retries: 0,
+            sessionId: null,
+        }),
+    },
+}).createMachine({
+    id: "orca",
+    initial: "idle",
+    context: {
+        task: null,
+        validation: null,
+        agents: [],
+        error: null,
+        retries: 0,
+        sessionId: null,
+    },
+    states: {
+        idle: {
+            on: {
+                VALIDATE: {
+                    target: "validating",
+                    actions: ["setTask"],
+                },
+            },
+        },
+        validating: {
+            invoke: {
+                src: "validateTask",
+                input: ({ context }) => ({ task: context.task }),
+                onDone: {
+                    target: "planning",
+                    actions: ["setValidation"],
+                },
+                onError: {
+                    target: "failed",
+                    actions: ["setError"],
+                },
+            },
+        },
+        planning: {
+            always: [
+                {
+                    guard: "isValley",
+                    target: "failed",
+                    actions: [
+                        (0, xstate_1.assign)({
+                            error: () => "Task probability too low. Ask for clarification.",
+                        }),
+                    ],
+                },
+                {
+                    guard: "isValidTask",
+                    target: "orchestrating",
+                },
+                {
+                    target: "failed",
+                    actions: [(0, xstate_1.assign)({ error: () => "Task validation failed" })],
+                },
+            ],
+        },
+        orchestrating: {
+            on: {
+                EXECUTE: {
+                    target: "executing",
+                    actions: ["setAgents"],
+                },
+            },
+        },
+        executing: {
+            invoke: {
+                src: "executeAgents",
+                input: ({ context }) => ({ agents: context.agents }),
+                onDone: {
+                    target: "reviewing",
+                },
+                onError: {
+                    target: "failed",
+                    actions: ["setError"],
+                },
+            },
+        },
+        reviewing: {
+            on: {
+                COMPLETE: {
+                    target: "completed",
+                },
+                FAIL: {
+                    target: "failed",
+                    actions: ["setError"],
+                },
+            },
+        },
+        completed: {
+            type: "final",
+        },
+        failed: {
+            on: {
+                RETRY: [
+                    {
+                        guard: "canRetry",
+                        target: "validating",
+                        actions: ["incrementRetry"],
+                    },
+                    {
+                        target: "failed",
+                        actions: [
+                            (0, xstate_1.assign)({
+                                error: () => "Maximum retries exceeded",
+                            }),
+                        ],
+                    },
+                ],
+                RESET: {
+                    target: "idle",
+                    actions: ["reset"],
+                },
+            },
+        },
+    },
+});
+// ============================================================================
+// Orca Orchestrator Class
+// ============================================================================
+class Orca {
+    constructor() {
+        // State machine ready
+    }
+    async orchestrate(_task, _agents) {
+        // This would create actor from state machine and execute
+    }
+}
+exports.Orca = Orca;
+//# sourceMappingURL=index.js.map

package/dist/orchestrator/src/orca/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/orca/index.ts"],"names":[],"mappings":"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"}

package/dist/orchestrator/src/pool/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * DOCUMENT: AGENT POOL
+ * PROJECT: VIBER Universal v2
+ * PURPOSE: Agent lifecycle management with concurrency limits
+ * UPDATE PATTERN: Update when agent management changes
+ * LOCATION: packages/orchestrator/src/pool/index.ts
+ * RELATED: orca, opencode integration
+ * LAST UPDATED: 2026-03-06
+ */
+import type { OpenCodeClient } from "@viberlabs/opencode";
+import type { Agent, Task } from "@viberlabs/viber-core/db";
+export interface PoolConfig {
+    maxConcurrent: number;
+    client: OpenCodeClient;
+}
+export declare class AgentPool {
+    private maxConcurrent;
+    private client;
+    private active;
+    private queue;
+    private completed;
+    constructor(config: PoolConfig);
+    /**
+     * Spawn an agent to work on a task
+     */
+    spawn(task: Task, role: Agent["role"], dependsOn?: string[], model?: string): Promise<string>;
+    /**
+     * Get status of all agents
+     */
+    getStatus(): {
+        active: number;
+        queued: number;
+        completed: number;
+        maxConcurrent: number;
+    };
+    /**
+     * Complete an agent
+     */
+    complete(agentId: string, result: unknown): Promise<void>;
+    /**
+     * Mark an agent as failed
+     */
+    fail(agentId: string, _error: string): Promise<void>;
+    /**
+     * Wait for all active agents to complete
+     */
+    drain(): Promise<Agent[]>;
+    private spawnAgent;
+    private processQueue;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/orchestrator/src/pool/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/pool/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAM5D,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,cAAc,CAAC;CACxB;AAyBD,qBAAa,SAAS;IACpB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,MAAM,CAAwC;IACtD,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,SAAS,CAAe;gBAEpB,MAAM,EAAE,UAAU;IAK9B;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,SAAS,GAAE,MAAM,EAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA6BvG;;OAEG;IACH,SAAS,IAAI;QACX,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;KACvB;IASD;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB/D;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAe1D;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAejB,UAAU;IA+BxB,OAAO,CAAC,YAAY;CAYrB"}

package/dist/orchestrator/src/pool/index.js

@@ -0,0 +1,152 @@
+"use strict";
+/**
+ * DOCUMENT: AGENT POOL
+ * PROJECT: VIBER Universal v2
+ * PURPOSE: Agent lifecycle management with concurrency limits
+ * UPDATE PATTERN: Update when agent management changes
+ * LOCATION: packages/orchestrator/src/pool/index.ts
+ * RELATED: orca, opencode integration
+ * LAST UPDATED: 2026-03-06
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentPool = void 0;
+// ============================================================================
+// Agent Pool
+// ============================================================================
+class AgentPool {
+    maxConcurrent;
+    client;
+    active = new Map();
+    queue = [];
+    completed = [];
+    constructor(config) {
+        this.maxConcurrent = config.maxConcurrent;
+        this.client = config.client;
+    }
+    /**
+     * Spawn an agent to work on a task
+     */
+    async spawn(task, role, dependsOn = [], model) {
+        return new Promise((resolve, reject) => {
+            const agent = {
+                id: `agent-${task.id}-${Date.now()}`,
+                taskId: task.id,
+                role,
+                status: "spawned",
+                startedAt: new Date().toISOString(),
+                inputTokens: 0,
+                outputTokens: 0,
+                costUsd: 0,
+                durationMs: null,
+                result: null,
+                opencodeSessionId: null,
+                model: model || null,
+                completedAt: null,
+                dependsOn: dependsOn.length > 0 ? dependsOn.join(",") : null,
+            };
+            // Check if we can spawn immediately
+            if (this.active.size < this.maxConcurrent) {
+                void this.spawnAgent(agent).then(resolve).catch(reject);
+            }
+            else {
+                // Queue for later
+                this.queue.push({ agent, resolve, reject });
+            }
+        });
+    }
+    /**
+     * Get status of all agents
+     */
+    getStatus() {
+        return {
+            active: this.active.size,
+            queued: this.queue.length,
+            completed: this.completed.length,
+            maxConcurrent: this.maxConcurrent,
+        };
+    }
+    /**
+     * Complete an agent
+     */
+    async complete(agentId, result) {
+        const wrapper = this.active.get(agentId);
+        if (!wrapper) {
+            throw new Error(`Agent ${agentId} not found in active pool`);
+        }
+        wrapper.status = "completed";
+        wrapper.endTime = Date.now();
+        wrapper.result = result;
+        this.completed.push(wrapper.agent);
+        this.active.delete(agentId);
+        // Process queue
+        this.processQueue();
+    }
+    /**
+     * Mark an agent as failed
+     */
+    async fail(agentId, _error) {
+        const wrapper = this.active.get(agentId);
+        if (!wrapper) {
+            throw new Error(`Agent ${agentId} not found in active pool`);
+        }
+        wrapper.status = "failed";
+        wrapper.endTime = Date.now();
+        this.active.delete(agentId);
+        // Process queue
+        this.processQueue();
+    }
+    /**
+     * Wait for all active agents to complete
+     */
+    async drain() {
+        return new Promise((resolve) => {
+            const checkInterval = setInterval(() => {
+                if (this.active.size === 0 && this.queue.length === 0) {
+                    clearInterval(checkInterval);
+                    resolve([...this.completed]);
+                }
+            }, 100);
+        });
+    }
+    // ============================================================================
+    // Private Methods
+    // ============================================================================
+    async spawnAgent(agent) {
+        const wrapper = {
+            agent,
+            sessionId: null,
+            status: "spawning",
+            startTime: Date.now(),
+            endTime: null,
+        };
+        this.active.set(agent.id, wrapper);
+        try {
+            // Create OpenCode session
+            const sessionId = await this.client.createSession(`VIBER: ${agent.role} - ${agent.taskId}`);
+            wrapper.sessionId = sessionId;
+            wrapper.status = "working";
+            // Mark agent as working
+            // This would update database via ViberDatabase
+            return agent.id;
+        }
+        catch (err) {
+            wrapper.status = "failed";
+            this.active.delete(agent.id);
+            throw err;
+        }
+    }
+    processQueue() {
+        while (this.queue.length > 0 && this.active.size < this.maxConcurrent) {
+            const item = this.queue.shift();
+            void this.spawnAgent(item.agent)
+                .then((id) => {
+                item.resolve(id);
+            })
+                .catch((err) => {
+                item.reject(err);
+            });
+        }
+    }
+}
+exports.AgentPool = AgentPool;
+//# sourceMappingURL=index.js.map

package/dist/orchestrator/src/pool/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/pool/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAiCH,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E,MAAa,SAAS;IACZ,aAAa,CAAS;IACtB,MAAM,CAAiB;IACvB,MAAM,GAA8B,IAAI,GAAG,EAAE,CAAC;IAC9C,KAAK,GAAkB,EAAE,CAAC;IAC1B,SAAS,GAAY,EAAE,CAAC;IAEhC,YAAY,MAAkB;QAC5B,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;QAC1C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,IAAU,EAAE,IAAmB,EAAE,YAAsB,EAAE,EAAE,KAAc;QACnF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,KAAK,GAAU;gBACnB,EAAE,EAAE,SAAS,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE;gBACpC,MAAM,EAAE,IAAI,CAAC,EAAE;gBACf,IAAI;gBACJ,MAAM,EAAE,SAAS;gBACjB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,WAAW,EAAE,CAAC;gBACd,YAAY,EAAE,CAAC;gBACf,OAAO,EAAE,CAAC;gBACV,UAAU,EAAE,IAAI;gBAChB,MAAM,EAAE,IAAI;gBACZ,iBAAiB,EAAE,IAAI;gBACvB,KAAK,EAAE,KAAK,IAAI,IAAI;gBACpB,WAAW,EAAE,IAAI;gBACjB,SAAS,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI;aAC7D,CAAC;YAEF,oCAAoC;YACpC,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;gBAC1C,KAAK,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC1D,CAAC;iBAAM,CAAC;gBACN,kBAAkB;gBAClB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,SAAS;QAMP,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;YACxB,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM;YAChC,aAAa,EAAE,IAAI,CAAC,aAAa;SAClC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,OAAe,EAAE,MAAe;QAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,SAAS,OAAO,2BAA2B,CAAC,CAAC;QAC/D,CAAC;QAED,OAAO,CAAC,MAAM,GAAG,WAAW,CAAC;QAC7B,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;QAExB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAE5B,gBAAgB;QAChB,IAAI,CAAC,YAAY,EAAE,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,OAAe,EAAE,MAAc;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,SAAS,OAAO,2BAA2B,CAAC,CAAC;QAC/D,CAAC;QAED,OAAO,CAAC,MAAM,GAAG,QAAQ,CAAC;QAC1B,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAE5B,gBAAgB;QAChB,IAAI,CAAC,YAAY,EAAE,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,MAAM,aAAa,GAAG,WAAW,CAAC,GAAG,EAAE;gBACrC,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACtD,aAAa,CAAC,aAAa,CAAC,CAAC;oBAC7B,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC,EAAE,GAAG,CAAC,CAAC;QACV,CAAC,CAAC,CAAC;IACL,CAAC;IAED,+EAA+E;IAC/E,kBAAkB;IAClB,+EAA+E;IAEvE,KAAK,CAAC,UAAU,CAAC,KAAY;QACnC,MAAM,OAAO,GAAiB;YAC5B,KAAK;YACL,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,UAAU;YAClB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,OAAO,EAAE,IAAI;SACd,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAEnC,IAAI,CAAC;YACH,0BAA0B;YAC1B,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,CAC/C,UAAU,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,MAAM,EAAE,CACzC,CAAC;YAEF,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;YAC9B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;YAE3B,wBAAwB;YACxB,+CAA+C;YAE/C,OAAO,KAAK,CAAC,EAAE,CAAC;QAClB,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,OAAO,CAAC,MAAM,GAAG,QAAQ,CAAC;YAC1B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC7B,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAEO,YAAY;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;YACtE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAG,CAAC;YACjC,KAAK,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC;iBAC7B,IAAI,CAAC,CAAC,EAAU,EAAE,EAAE;gBACnB,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACnB,CAAC,CAAC;iBACD,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;gBACtB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACnB,CAAC,CAAC,CAAC;QACP,CAAC;IACH,CAAC;CACF;AAhKD,8BAgKC"}

package/dist/orchestrator/src/workflow/index.d.ts

@@ -0,0 +1,65 @@
+/**
+ * DOCUMENT: WORKFLOW PATTERNS
+ * PROJECT: VIBER Universal v2
+ * PURPOSE: Multi-agent workflow orchestration
+ * UPDATE PATTERN: Update when workflow patterns change
+ * LOCATION: packages/orchestrator/src/workflow/index.ts
+ * RELATED: orca, pool
+ * LAST UPDATED: 2026-03-06
+ */
+import type { Task, Agent } from "@viberlabs/viber-core/db";
+import type { AgentPool } from "../pool";
+export interface WorkflowStep {
+    agent: Agent;
+    dependsOn: string[];
+}
+export interface WorkflowResult {
+    workflowId: string;
+    success: boolean;
+    steps: WorkflowStepResult[];
+    totalDuration: number;
+    totalCost: number;
+}
+export interface WorkflowStepResult {
+    agentId: string;
+    success: boolean;
+    duration: number;
+    cost: number;
+    artifacts: string[];
+    summary: string;
+}
+export declare class WorkflowExecutor {
+    private pool;
+    constructor(pool: AgentPool);
+    /**
+     * Execute sequential workflow:
+     * Agent A → Agent B → Agent C
+     */
+    sequential(task: Task, roles: Agent["role"][]): Promise<WorkflowResult>;
+    /**
+     * Execute parallel workflow:
+     * Agents A, B, C all run simultaneously
+     */
+    parallel(task: Task, roles: Agent["role"][]): Promise<WorkflowResult>;
+    /**
+     * Execute pipeline workflow:
+     * Output of A feeds input of B
+     */
+    pipeline(task: Task, roles: Agent["role"][]): Promise<WorkflowResult>;
+    /**
+     * Execute implement-review workflow:
+     * Coder implements → Reviewer reviews
+     */
+    implementReview(task: Task, _model?: string): Promise<WorkflowResult>;
+    /**
+     * Execute plan-implement-test workflow:
+     * Planner plans → Coder implements → Tester tests
+     */
+    planImplementTest(task: Task, _model?: string): Promise<WorkflowResult>;
+    /**
+     * Execute dual-review workflow:
+     * Coder implements → Two reviewers review in parallel
+     */
+    dualReview(task: Task, _model?: string): Promise<WorkflowResult>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/orchestrator/src/workflow/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/workflow/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAMzC,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,KAAK,CAAC;IACb,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,IAAI,CAAY;gBAEZ,IAAI,EAAE,SAAS;IAI3B;;;OAGG;IACG,UAAU,CACd,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,GACrB,OAAO,CAAC,cAAc,CAAC;IAmC1B;;;OAGG;IACG,QAAQ,CACZ,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,GACrB,OAAO,CAAC,cAAc,CAAC;IA2B1B;;;OAGG;IACG,QAAQ,CACZ,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,GACrB,OAAO,CAAC,cAAc,CAAC;IA4C1B;;;OAGG;IACG,eAAe,CACnB,IAAI,EAAE,IAAI,EACV,MAAM,GAAE,MAAgC,GACvC,OAAO,CAAC,cAAc,CAAC;IAI1B;;;OAGG;IACG,iBAAiB,CACrB,IAAI,EAAE,IAAI,EACV,MAAM,GAAE,MAAgC,GACvC,OAAO,CAAC,cAAc,CAAC;IAI1B;;;OAGG;IACG,UAAU,CACd,IAAI,EAAE,IAAI,EACV,MAAM,GAAE,MAAgC,GACvC,OAAO,CAAC,cAAc,CAAC;CA2B3B"}