@viberlabs/orchestrator 2.1.0

package/dist/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/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/daemon.d.ts

@@ -0,0 +1,66 @@
+/**
+ * DOCUMENT: ORCA Daemon (MVP)
+ * PROJECT: VIBER Universal v2
+ * PURPOSE: Always-on daemon that processes pending agents from SQLite and spawns OpenCode sessions.
+ * UPDATE PATTERN: Update when queue contract or OpenCode endpoints change.
+ * LOCATION: packages/orchestrator/src/daemon.ts
+ * RELATED: packages/core/src/db/index.ts, packages/opencode-plugin/src/index.ts
+ * LAST UPDATED: 2026-03-11
+ */
+import { ViberDatabase } from "@viberlabs/viber-core/db";
+export type OrcaDaemonConfig = {
+    rootDir: string;
+    intervalMs: number;
+    opencode: {
+        baseUrl: string;
+        username: string;
+        password: string;
+    };
+};
+export type OpenCodeSessionCreateResponse = {
+    id: string;
+};
+export declare class OpenCodeHttpError extends Error {
+    readonly status: number;
+    readonly url: string;
+    constructor(args: {
+        message: string;
+        status: number;
+        url: string;
+    });
+}
+export interface OpenCodeClient {
+    createSession(args: {
+        title: string;
+        parentID?: string;
+    }): Promise<OpenCodeSessionCreateResponse>;
+    promptAsync(args: {
+        sessionId: string;
+        agent: string;
+        parts: Array<{
+            type: "text";
+            text: string;
+        }>;
+    }): Promise<void>;
+}
+export type OrcaLogger = (line: string) => void;
+export declare function createDeterministicOpenCodeClient(config: {
+    baseUrl: string;
+    username: string;
+    password: string;
+}): OpenCodeClient;
+export declare function processPendingAgentsOnce(args: {
+    db: ViberDatabase;
+    client: OpenCodeClient;
+    rootDir: string;
+    logger?: OrcaLogger;
+}): Promise<{
+    processed: number;
+    skipped: number;
+}>;
+export declare function loadOrcaDaemonConfigFromDiskAndEnv(args: {
+    rootDir: string;
+    intervalMs?: number;
+}): OrcaDaemonConfig;
+export declare function runOrcaDaemon(config: OrcaDaemonConfig): Promise<void>;
+//# sourceMappingURL=daemon.d.ts.map

package/dist/orchestrator/src/daemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../../../src/daemon.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,EACL,aAAa,EAOd,MAAM,0BAA0B,CAAC;AAElC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,GAAG,EAAE,MAAM,CAAC;gBAEhB,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;CAMnE;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,6BAA6B,CAAC,CAAC;IAClG,WAAW,CAAC,IAAI,EAAE;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC9C,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnB;AAED,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;AAiJhD,wBAAgB,iCAAiC,CAAC,MAAM,EAAE;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,cAAc,CAsEjB;AAED,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,EAAE,EAAE,aAAa,CAAC;IAClB,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB,GAAG,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAuHlD;AAED,wBAAgB,kCAAkC,CAAC,IAAI,EAAE;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,gBAAgB,CAkEnB;AAwCD,wBAAsB,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2F3E"}