@oeronteros-1/opencode-orchestra 0.5.0

package/dist/telemetry/ledger.js

@@ -0,0 +1,179 @@
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { normalizeCandidate } from "../routing/model-resolver.js";
+function emptySession() {
+    return {
+        agents: {},
+        premiumEscalations: 0,
+        estimatedPaidUsage: 0,
+        freeWorkerCalls: 0,
+        messages: {},
+    };
+}
+export function emptyLedgerState() {
+    return { version: 2, updatedAt: new Date(0).toISOString(), sessions: {} };
+}
+function normalizeTokens(tokens) {
+    return {
+        input: Math.max(0, tokens?.input ?? 0),
+        output: Math.max(0, tokens?.output ?? 0),
+        reasoning: Math.max(0, tokens?.reasoning ?? 0),
+        cache: {
+            read: Math.max(0, tokens?.cache?.read ?? 0),
+            write: Math.max(0, tokens?.cache?.write ?? 0),
+        },
+    };
+}
+function upgradeState(input) {
+    if (typeof input !== "object" || input === null)
+        return emptyLedgerState();
+    const candidate = input;
+    if (candidate.version !== 1 && candidate.version !== 2)
+        return emptyLedgerState();
+    const sessions = candidate.sessions ?? {};
+    for (const session of Object.values(sessions)) {
+        session.messages ??= {};
+        for (const [id, message] of Object.entries(session.messages)) {
+            session.messages[id] = {
+                ...message,
+                cost: Math.max(0, message.cost ?? 0),
+                tokens: normalizeTokens(message.tokens),
+            };
+        }
+    }
+    return {
+        version: 2,
+        updatedAt: candidate.updatedAt ?? new Date(0).toISOString(),
+        sessions,
+    };
+}
+export async function readLedgerState(file) {
+    try {
+        return upgradeState(JSON.parse(await readFile(file, "utf8")));
+    }
+    catch {
+        return emptyLedgerState();
+    }
+}
+export class Ledger {
+    enabled;
+    stateFile;
+    modelCosts;
+    state;
+    queue = Promise.resolve();
+    constructor(directory, telemetryDirectory, enabled, pools) {
+        this.enabled = enabled;
+        this.stateFile = path.resolve(directory, telemetryDirectory, "state.json");
+        this.modelCosts = new Map(pools.flat().map((candidate) => {
+            const normalized = normalizeCandidate(candidate);
+            return [normalized.id, normalized.cost];
+        }));
+    }
+    async load() {
+        if (this.state)
+            return this.state;
+        try {
+            this.state = upgradeState(JSON.parse(await readFile(this.stateFile, "utf8")));
+        }
+        catch {
+            this.state = emptyLedgerState();
+        }
+        return this.state;
+    }
+    async save(state) {
+        if (!this.enabled)
+            return;
+        const directory = path.dirname(this.stateFile);
+        await mkdir(directory, { recursive: true });
+        const ignoreFile = path.join(directory, ".gitignore");
+        try {
+            await writeFile(ignoreFile, "*\n!.gitignore\n", { flag: "wx" });
+        }
+        catch {
+            // The sentinel already exists or the directory is intentionally read-only.
+        }
+        state.updatedAt = new Date().toISOString();
+        const temporary = `${this.stateFile}.tmp`;
+        await writeFile(temporary, `${JSON.stringify(state, null, 2)}\n`, "utf8");
+        await rename(temporary, this.stateFile);
+    }
+    mutate(operation) {
+        if (!this.enabled)
+            return Promise.resolve();
+        this.queue = this.queue.then(async () => {
+            const state = await this.load();
+            operation(state);
+            await this.save(state);
+        });
+        return this.queue;
+    }
+    async setProfile(sessionID, profile) {
+        await this.mutate((state) => {
+            const session = (state.sessions[sessionID] ??= emptySession());
+            session.profile = profile;
+        });
+    }
+    async setConsensus(sessionID, consensus) {
+        await this.mutate((state) => {
+            const session = (state.sessions[sessionID] ??= emptySession());
+            session.consensus = consensus;
+        });
+    }
+    async recordAssistant(info) {
+        const mode = info.mode;
+        if (!mode?.startsWith("orch-"))
+            return;
+        await this.mutate((state) => {
+            const session = (state.sessions[info.sessionID] ??= emptySession());
+            const previous = session.messages[info.id];
+            const currentCost = Math.max(0, info.cost ?? 0);
+            const delta = Math.max(0, currentCost - (previous?.cost ?? 0));
+            session.estimatedPaidUsage += delta;
+            if (!previous) {
+                session.agents[mode] = (session.agents[mode] ?? 0) + 1;
+                if (mode === "orch-judge")
+                    session.premiumEscalations += 1;
+                const model = info.providerID && info.modelID ? `${info.providerID}/${info.modelID}` : undefined;
+                if (mode !== "orch-lead" && mode !== "orch-judge" && model && this.modelCosts.get(model) === "free") {
+                    session.freeWorkerCalls += 1;
+                }
+            }
+            session.messages[info.id] = {
+                cost: currentCost,
+                ...(mode ? { agent: mode } : {}),
+                ...(info.modelID ? { model: info.modelID } : {}),
+                ...(info.providerID ? { provider: info.providerID } : {}),
+                ...(info.time?.created ? { createdAt: info.time.created } : {}),
+                ...(info.time?.completed ? { completedAt: info.time.completed } : {}),
+                ...(info.finish ? { finish: info.finish } : {}),
+                tokens: normalizeTokens(info.tokens),
+            };
+        });
+    }
+    async getSession(sessionID) {
+        await this.queue;
+        const state = await this.load();
+        return state.sessions[sessionID] ?? emptySession();
+    }
+    async formatStatus(sessionID) {
+        const session = await this.getSession(sessionID);
+        const agents = Object.entries(session.agents)
+            .sort(([a], [b]) => a.localeCompare(b))
+            .map(([name, calls]) => `  ${name.padEnd(24)} ${calls}`)
+            .join("\n");
+        return [
+            "OpenCode Orchestra status",
+            "",
+            `profile: ${session.profile?.toUpperCase() ?? "not classified"}`,
+            "",
+            "agents:",
+            agents || "  no recorded calls",
+            "",
+            `premium escalations: ${session.premiumEscalations}`,
+            `estimated paid usage: $${session.estimatedPaidUsage.toFixed(4)}`,
+            `free worker calls: ${session.freeWorkerCalls}`,
+            `consensus: ${session.consensus === undefined ? "not recorded" : `${Math.round(session.consensus * 100)}%`}`,
+        ].join("\n");
+    }
+}
+//# sourceMappingURL=ledger.js.map

package/dist/telemetry/ledger.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,4 @@
+import { type ToolDefinition } from "@opencode-ai/plugin";
+import type { OrchestraConfig } from "./config/schema.js";
+import type { Ledger } from "./telemetry/ledger.js";
+export declare function createOrchestraTools(config: OrchestraConfig, ledger: Ledger): Record<string, ToolDefinition>;

package/dist/tools.js

@@ -0,0 +1,57 @@
+import { tool } from "@opencode-ai/plugin";
+import { profileNameSchema } from "./config/schema.js";
+import { PROFILE_CATALOG } from "./profiles/catalog.js";
+import { classifyTask } from "./routing/classifier.js";
+import { decideEscalation } from "./routing/escalation.js";
+export function createOrchestraTools(config, ledger) {
+    return {
+        orchestra_route: tool({
+            description: "Classify a complex task and return the recommended OpenCode Orchestra worker team for the active budget mode. This does not execute the team.",
+            args: {
+                task: tool.schema.string().min(1),
+                profile: tool.schema.string().optional(),
+            },
+            async execute(args, context) {
+                const requested = args.profile ? profileNameSchema.safeParse(args.profile) : undefined;
+                const automatic = classifyTask(args.task, config.orchestration.profiles);
+                const profile = requested?.success ? requested.data : automatic.profile;
+                const classification = requested?.success
+                    ? { ...automatic, profile, confidence: 1, matchedSignals: ["explicit profile"] }
+                    : automatic;
+                const definition = PROFILE_CATALOG[profile];
+                const enabledWorkers = Object.values(PROFILE_CATALOG)
+                    .filter((candidate) => config.orchestration.profiles[candidate.name] !== false)
+                    .flatMap((candidate) => candidate.workers);
+                const workerPool = config.budget === "ebobo"
+                    ? Array.from(new Set(enabledWorkers))
+                    : definition.workers;
+                const workers = workerPool.slice(0, config.orchestration.maxWorkers);
+                const escalation = decideEscalation(config, { classification });
+                const sessionID = context.sessionID;
+                if (sessionID)
+                    await ledger.setProfile(sessionID, profile);
+                return JSON.stringify({
+                    profile,
+                    secondaryProfiles: classification.secondaryProfiles,
+                    confidence: classification.confidence,
+                    critical: classification.critical,
+                    workers,
+                    parallelWorkers: Math.min(config.orchestration.parallelWorkers, workers.length),
+                    escalation,
+                    next: `Delegate the full task once to orch-lead with profile=${profile}. Let orch-lead dispatch workers.`,
+                }, null, 2);
+            },
+        }),
+        orchestra_status: tool({
+            description: "Show model, worker, escalation, cost, and consensus statistics for the current Orchestra session.",
+            args: {},
+            async execute(_args, context) {
+                const sessionID = context.sessionID;
+                if (!sessionID)
+                    return "Orchestra status is unavailable because the current session ID was not provided.";
+                return ledger.formatStatus(sessionID);
+            },
+        }),
+    };
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@oeronteros-1/opencode-orchestra",
+  "version": "0.5.0",
+  "description": "Additive model and subagent orchestration for OpenCode",
+  "type": "module",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "opencode",
+    "plugin",
+    "agents",
+    "orchestration"
+  ],
+  "files": [
+    "dist",
+    "dashboard-dist",
+    "prompts",
+    "schema",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": "./dist/index.js",
+    "./schema": "./schema/opencode-orchestra.schema.json"
+  },
+  "bin": {
+    "opencode-orchestra": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "npm run build:dashboard && npm run build:plugin",
+    "build:dashboard": "vite build --config dashboard/vite.config.ts",
+    "build:plugin": "tsc -p tsconfig.build.json",
+    "dev:dashboard": "vite --config dashboard/vite.config.ts",
+    "prepack": "npm run build",
+    "typecheck": "tsc --noEmit && tsc -p dashboard/tsconfig.json",
+    "test": "tsc -p tsconfig.test.json && node --test dist-test/test/classifier.test.js dist-test/test/model-resolver.test.js dist-test/test/model-discovery.test.js dist-test/test/budget.test.js dist-test/test/agents.test.js dist-test/test/plugin.test.js dist-test/test/cli.test.js dist-test/test/dashboard.test.js",
+    "check": "npm run typecheck && npm test"
+  },
+  "dependencies": {
+    "@opencode-ai/plugin": "^1.18.18",
+    "jsonc-parser": "^3.3.1",
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "@base-ui/react": "^1.7.0",
+    "@hookform/resolvers": "^5.9.0",
+    "@hugeicons/core-free-icons": "^4.2.3",
+    "@hugeicons/react": "^1.1.9",
+    "@tailwindcss/vite": "^4.3.3",
+    "@tanstack/react-query": "^5.101.4",
+    "@tanstack/react-router": "^1.170.29",
+    "@tanstack/react-table": "^9.1.2",
+    "@tanstack/react-virtual": "^3.14.9",
+    "@types/node": "^22.0.0",
+    "@types/react": "^19.2.18",
+    "@types/react-dom": "^19.2.4",
+    "@vitejs/plugin-react": "^6.0.5",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "i18next": "^26.3.6",
+    "motion": "^13.1.0",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
+    "react-hook-form": "^7.85.0",
+    "react-i18next": "^17.0.11",
+    "recharts": "^3.10.1",
+    "tailwind-merge": "^3.6.0",
+    "tailwindcss": "^4.3.3",
+    "typescript": "^5.9.0",
+    "vite": "^8.2.1",
+    "zustand": "^5.0.15"
+  },
+  "engines": {
+    "bun": ">=1.2",
+    "node": ">=22"
+  }
+}

package/prompts/judge.md

@@ -0,0 +1,13 @@
+You are `orch-judge`, a costly independent arbiter.
+
+You are called only when specialist findings conflict, uncertainty remains above the configured threshold, or the task is critical. Inspect only the evidence needed to resolve the disagreement.
+
+Do not delegate. Do not edit files. Do not replace the primary agent's decision-making.
+
+Return:
+
+- claims accepted and the evidence supporting them;
+- claims rejected and why;
+- remaining uncertainty;
+- safest recommended decision;
+- the cheapest decisive verification if uncertainty remains.

package/prompts/lead.md

@@ -0,0 +1,24 @@
+You are `orch-lead`, an evidence-driven orchestration subagent.
+
+For structural repository questions, query Codebase Memory before broad grep or file reading, then verify decisive claims against exact source. Use MemoryGraph `recall_memories` at most once near the start when prior decisions or learned patterns can materially change the answer. Store only verified fixes, architecture decisions, and reusable patterns; never store secrets, raw transcripts, or transient task state. Add relationships when they clarify why a memory matters. Use Context7 only for current library/API facts that repository evidence cannot settle.
+
+Your job is to decide what kind of intellectual work the task requires, dispatch the smallest useful specialist team, and synthesize their evidence for the primary agent.
+
+Operating rules:
+
+1. Classify the task as architecture, debug, UI, research, review, security, performance, migration, or ops. Use at most two secondary profiles.
+2. Dispatch workers only when their evidence can change the answer. Avoid ceremonial parallelism.
+3. Give each worker a narrow question, relevant context, explicit deliverable, and a prohibition on editing or further delegation.
+4. Run independent questions in parallel, but stay within the runtime worker limits.
+5. Compare claims, evidence, and uncertainty. Do not treat repeated unsupported opinions as consensus.
+6. Invoke `orch-judge` only for critical risk or genuinely unresolved disagreement. Never use it merely to polish prose.
+7. Do not edit files. Do not invoke yourself. Do not take over the primary agent's implementation, plan, TDD, review, or active skill workflow.
+
+Return a compact handoff with:
+
+- selected profile and why;
+- workers used and their questions;
+- evidence-backed findings;
+- consensus and unresolved disagreement;
+- recommendation and risks;
+- verification or next implementation step for the primary agent.

package/schema/opencode-orchestra.schema.json

@@ -0,0 +1,112 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://unpkg.com/@oeronteros-1/opencode-orchestra@latest/schema/opencode-orchestra.schema.json",
+  "title": "OpenCode Orchestra configuration",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "$schema": { "type": "string" },
+    "budget": { "enum": ["eco", "balanced", "quality", "ebobo"], "default": "balanced" },
+    "models": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "strategy": { "enum": ["auto", "manual"], "default": "auto" },
+        "agents": {
+          "type": "object",
+          "default": {},
+          "additionalProperties": { "type": "string", "pattern": "^[^/]+/.+$" }
+        },
+        "lead": { "$ref": "#/$defs/modelPool" },
+        "worker": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "code": { "$ref": "#/$defs/modelPool" },
+            "reasoning": { "$ref": "#/$defs/modelPool" },
+            "research": { "$ref": "#/$defs/modelPool" },
+            "vision": { "$ref": "#/$defs/modelPool" },
+            "image": { "$ref": "#/$defs/modelPool" }
+          }
+        },
+        "judge": { "$ref": "#/$defs/modelPool" }
+      }
+    },
+    "orchestration": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "parallelWorkers": { "type": "integer", "minimum": 1, "maximum": 8, "default": 3 },
+        "maxWorkers": { "type": "integer", "minimum": 1, "maximum": 12, "default": 5 },
+        "premiumEscalation": { "type": "boolean", "default": true },
+        "maxPremiumCallsPerTask": { "type": "integer", "minimum": 0, "maximum": 5, "default": 1 },
+        "confidenceThreshold": { "type": "number", "minimum": 0, "maximum": 1, "default": 0.72 },
+        "exposeWorkers": { "type": "boolean", "default": false },
+        "profiles": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "architecture": { "type": "boolean" },
+            "debug": { "type": "boolean" },
+            "ui": { "type": "boolean" },
+            "research": { "type": "boolean" },
+            "review": { "type": "boolean" },
+            "security": { "type": "boolean" },
+            "performance": { "type": "boolean" },
+            "migration": { "type": "boolean" },
+            "ops": { "type": "boolean" }
+          }
+        }
+      }
+    },
+    "superpowers": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "compatibility": { "type": "boolean", "default": true },
+        "injectPrimaryHint": { "type": "boolean", "default": false }
+      }
+    },
+    "telemetry": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": { "type": "boolean", "default": true },
+        "directory": { "type": "string", "minLength": 1, "default": ".orchestra" }
+      }
+    }
+  },
+  "$defs": {
+    "modelPool": {
+      "type": "array",
+      "items": {
+        "oneOf": [
+          { "type": "string", "pattern": "^[^/]+/.+$" },
+          { "$ref": "#/$defs/model" }
+        ]
+      }
+    },
+    "model": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id"],
+      "properties": {
+        "id": { "type": "string", "pattern": "^[^/]+/.+$" },
+        "cost": { "enum": ["free", "subscription", "paid"], "default": "free" },
+        "tier": { "enum": ["worker", "lead", "frontier"], "default": "worker" },
+        "priority": { "type": "number", "minimum": 0, "maximum": 100, "default": 50 },
+        "capabilities": {
+          "type": "array",
+          "items": {
+            "enum": ["code", "reasoning", "research", "vision", "image", "review", "security", "performance", "large-context"]
+          }
+        },
+        "scores": {
+          "type": "object",
+          "additionalProperties": { "type": "number", "minimum": 0, "maximum": 10 }
+        },
+        "context": { "enum": ["small", "medium", "large", "xlarge"] }
+      }
+    }
+  }
+}