opencode-akane 0.1.3 → 0.1.4

package/README.md

@@ -73,6 +73,22 @@ For package-based installation, publish this repository to npm and add it to the
 Akane still reads its runtime config from `~/.config/opencode/akane.json`.
 If that file does not exist yet, the plugin now bootstraps it automatically on first load with the default config.
 You only need to edit it when you want to override the default role or artifact settings.
+When `oh-my-opencode` is installed, Akane now prefers OMO agents such as `prometheus`, `atlas`, `momus`, `oracle`, and `sisyphus`, then falls back to direct model routing when those agents are unavailable.
+
+`akane.json` supports both model routing and agent routing:
+
+```json
+{
+  "roleAgents": {
+    "planner": "prometheus",
+    "plan_reviewer": "hephaestus",
+    "implementer": "atlas",
+    "reviewer_codex": "momus",
+    "reviewer_claude": "oracle",
+    "synthesizer": "sisyphus"
+  }
+}
+```
 
 ## Publish flow
 

package/dist/artifacts.js

@@ -56,6 +56,7 @@ export function createInitialState(input) {
         activeStage: null,
         stageOrder: [...input.config.workflow.stageOrder],
         stages,
+        roleAgents: { ...input.config.roleAgents },
         roles: { ...input.config.roles },
     };
 }
@@ -109,6 +110,21 @@ export async function ensureArtifactLayout(input) {
         await writeStateFile(statePath, state);
         createdFiles.push(statePath);
     }
+    else {
+        let updated = false;
+        if (!state.roleAgents) {
+            state.roleAgents = { ...input.config.roleAgents };
+            updated = true;
+        }
+        if (!state.roles) {
+            state.roles = { ...input.config.roles };
+            updated = true;
+        }
+        if (updated) {
+            state.updatedAt = nowIso();
+            await writeStateFile(statePath, state);
+        }
+    }
     return { artifactDir, statePath, state, createdFiles };
 }
 export async function writeStageArtifact(input) {

package/dist/config.js

@@ -1,7 +1,7 @@
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
-import { AKANE_SERVICE_NAME, AKANE_STAGE_IDS, DEFAULT_ARTIFACT_DIR, DEFAULT_GLOBAL_CONFIG_PATH, DEFAULT_PLUGIN_OUTPUT_PATH, DEFAULT_ROLE_MODELS, DEFAULT_STAGE_FILES, DEFAULT_STAGE_ORDER, DEFAULT_STATE_FILE, } from "./constants.js";
+import { AKANE_SERVICE_NAME, AKANE_ROLE_IDS, AKANE_STAGE_IDS, DEFAULT_ARTIFACT_DIR, DEFAULT_GLOBAL_CONFIG_PATH, DEFAULT_PLUGIN_OUTPUT_PATH, DEFAULT_ROLE_AGENTS, DEFAULT_ROLE_MODELS, DEFAULT_STAGE_FILES, DEFAULT_STAGE_ORDER, DEFAULT_STATE_FILE, } from "./constants.js";
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -51,6 +51,7 @@ export function defaultAkaneConfig(configPath = DEFAULT_GLOBAL_CONFIG_PATH) {
         workflow: {
             stageOrder: [...DEFAULT_STAGE_ORDER],
         },
+        roleAgents: { ...DEFAULT_ROLE_AGENTS },
         roles: { ...DEFAULT_ROLE_MODELS },
     };
 }
@@ -76,6 +77,19 @@ function normalizeRoles(input, fallback) {
     }
     return next;
 }
+function normalizeRoleAgents(input, fallback) {
+    if (!isRecord(input)) {
+        return { ...fallback };
+    }
+    const next = { ...fallback };
+    for (const role of AKANE_ROLE_IDS) {
+        const candidate = input[role];
+        if (typeof candidate === "string" && candidate.trim()) {
+            next[role] = candidate.trim();
+        }
+    }
+    return next;
+}
 function normalizeFiles(input, fallback) {
     if (!isRecord(input)) {
         return { ...fallback };
@@ -127,6 +141,7 @@ export function mergeAkaneConfig(base, overrides) {
         workflow: {
             stageOrder: normalizeStageOrder(isRecord(overrides.workflow) ? overrides.workflow.stageOrder : undefined, base.workflow.stageOrder),
         },
+        roleAgents: normalizeRoleAgents(overrides.roleAgents, base.roleAgents),
         roles: normalizeRoles(overrides.roles, base.roles),
     };
 }

package/dist/constants.d.ts

@@ -16,6 +16,16 @@ export declare const DEFAULT_ROLE_MODELS: {
     readonly reviewer_claude: "anthropic/claude-opus-4-6";
     readonly synthesizer: "openai/gpt-5.4";
 };
+export declare const DEFAULT_ROLE_AGENTS: {
+    readonly planner: "prometheus";
+    readonly plan_reviewer: "metis";
+    readonly implementer: "atlas";
+    readonly consultant_primary: "oracle";
+    readonly consultant_secondary: "librarian";
+    readonly reviewer_codex: "momus";
+    readonly reviewer_claude: "oracle";
+    readonly synthesizer: "sisyphus";
+};
 export declare const DEFAULT_STAGE_FILES: {
     readonly plan: "plan.md";
     readonly "plan-review": "plan-review.md";

package/dist/constants.js

@@ -41,6 +41,16 @@ export const DEFAULT_ROLE_MODELS = {
     reviewer_claude: "anthropic/claude-opus-4-6",
     synthesizer: "openai/gpt-5.4",
 };
+export const DEFAULT_ROLE_AGENTS = {
+    planner: "prometheus",
+    plan_reviewer: "metis",
+    implementer: "atlas",
+    consultant_primary: "oracle",
+    consultant_secondary: "librarian",
+    reviewer_codex: "momus",
+    reviewer_claude: "oracle",
+    synthesizer: "sisyphus",
+};
 export const DEFAULT_STAGE_FILES = {
     plan: "plan.md",
     "plan-review": "plan-review.md",

package/dist/types.d.ts

@@ -2,6 +2,7 @@ import type { AKANE_ROLE_IDS, AKANE_STAGE_IDS, DEFAULT_ROLE_MODELS, DEFAULT_STAG
 export type AkaneStageId = (typeof AKANE_STAGE_IDS)[number];
 export type AkaneRoleId = (typeof AKANE_ROLE_IDS)[number];
 export type AkaneRoles = Record<AkaneRoleId, string>;
+export type AkaneRoleAgents = Record<AkaneRoleId, string>;
 export type AkaneStageFiles = Record<AkaneStageId, string>;
 export interface AkaneConfig {
     version: number;
@@ -16,6 +17,7 @@ export interface AkaneConfig {
     workflow: {
         stageOrder: AkaneStageId[];
     };
+    roleAgents: AkaneRoleAgents;
     roles: AkaneRoles;
 }
 export interface LoadedAkaneConfig {
@@ -28,6 +30,7 @@ export interface AkaneStageState {
     status: "pending" | "initialized" | "completed";
     updatedAt: string | null;
     role?: AkaneRoleId;
+    agent?: string;
     model?: string;
     sessionID?: string;
     messageID?: string;
@@ -44,6 +47,7 @@ export interface AkaneState {
     activeStage: AkaneStageId | null;
     stageOrder: AkaneStageId[];
     stages: Record<AkaneStageId, AkaneStageState>;
+    roleAgents: AkaneRoleAgents;
     roles: AkaneRoles;
 }
 export type ArtifactWriteMode = "append" | "replace";

package/dist/workflow.js

@@ -1,7 +1,7 @@
 import { readFile } from "node:fs/promises";
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
-import { AKANE_SERVICE_NAME, AKANE_TOOL_IDS, } from "./constants.js";
+import { AKANE_SERVICE_NAME, AKANE_TOOL_IDS, DEFAULT_ROLE_AGENTS, } from "./constants.js";
 import { ensureArtifactLayout, resolveProjectRoot, resolveStageArtifactPath, writeStageArtifact, } from "./artifacts.js";
 const execFileAsync = promisify(execFile);
 const STAGE_ROLE_MAP = {
@@ -12,13 +12,27 @@ const STAGE_ROLE_MAP = {
     "review-claude": "reviewer_claude",
     "final-synthesis": "synthesizer",
 };
-const DEFAULT_ROLE_AGENTS = {
-    planner: "plan",
-    plan_reviewer: "general",
-    implementer: "build",
-    reviewer_codex: "general",
-    reviewer_claude: "general",
-    synthesizer: "general",
+const DEFAULT_ROLE_AGENT_CANDIDATES = {
+    planner: ["prometheus", "Prometheus (Plan Builder)", "plan"],
+    plan_reviewer: [
+        "metis",
+        "Metis (Plan Consultant)",
+        "hephaestus",
+        "Hephaestus (Deep Agent)",
+        "general",
+    ],
+    implementer: ["atlas", "Atlas (Plan Executor)", "build"],
+    consultant_primary: ["oracle", "general"],
+    consultant_secondary: ["librarian", "explore", "general"],
+    reviewer_codex: [
+        "momus",
+        "Momus (Plan Critic)",
+        "hephaestus",
+        "Hephaestus (Deep Agent)",
+        "general",
+    ],
+    reviewer_claude: ["oracle", "general"],
+    synthesizer: ["sisyphus", "Sisyphus (Ultraworker)", "general"],
 };
 const IMPLEMENT_TIMEOUT_MS = 15 * 60 * 1000;
 const DEFAULT_TIMEOUT_MS = 5 * 60 * 1000;
@@ -39,6 +53,14 @@ function stageTitle(stage) {
         .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
         .join(" ");
 }
+function normalizeAgentName(input) {
+    return input.trim().toLowerCase();
+}
+function agentNameAliases(input) {
+    const normalized = normalizeAgentName(input);
+    const base = normalized.replace(/\s*\([^)]*\)\s*$/, "").trim();
+    return Array.from(new Set([normalized, base].filter(Boolean)));
+}
 function parseModelRef(modelRef) {
     const [providerID, ...rest] = modelRef.split("/");
     const modelID = rest.join("/").trim();
@@ -86,23 +108,33 @@ function findLatestAssistantMessage(messages) {
 function makeToolRestrictions(allowWorkspaceMutation) {
     const restrictions = Object.fromEntries(AKANE_TOOL_IDS.map((toolID) => [toolID, false]));
     if (!allowWorkspaceMutation) {
-        for (const toolID of ["bash", "edit", "patch", "write", "task", "question"]) {
+        for (const toolID of ["bash", "edit", "patch", "write"]) {
             restrictions[toolID] = false;
         }
     }
     return restrictions;
 }
-async function resolveAgentName(client, directory, role) {
-    const preferred = DEFAULT_ROLE_AGENTS[role];
-    if (!preferred) {
-        return undefined;
-    }
+async function resolveAgentName(client, directory, role, config) {
+    const candidates = [
+        config.roleAgents[role],
+        ...DEFAULT_ROLE_AGENT_CANDIDATES[role],
+        DEFAULT_ROLE_AGENTS[role],
+    ]
+        .filter((candidate) => typeof candidate === "string" && candidate.trim().length > 0)
+        .filter((candidate, index, all) => all.findIndex((value) => normalizeAgentName(value) === normalizeAgentName(candidate)) === index);
     try {
         const result = await client.app.agents({
             query: { directory },
         });
         const agents = requireResultData(result, "agent list");
-        return agents.some((agent) => agent.name === preferred) ? preferred : undefined;
+        for (const candidate of candidates) {
+            const candidateAliases = agentNameAliases(candidate);
+            const matched = agents.find((agent) => agentNameAliases(agent.name).some((alias) => candidateAliases.includes(alias)));
+            if (matched) {
+                return matched.name;
+            }
+        }
+        return undefined;
     }
     catch {
         return undefined;
@@ -199,6 +231,7 @@ function renderStageDocument(input) {
         "",
         `- Service: ${AKANE_SERVICE_NAME}`,
         `- Role: ${input.role}`,
+        ...(input.agent ? [`- Agent: ${input.agent}`] : []),
         `- Model: ${input.model}`,
         `- Session ID: ${input.sessionID}`,
         `- Message ID: ${input.messageID}`,
@@ -246,9 +279,9 @@ function buildArtifactBlock(title, content) {
 }
 async function runStageSession(input) {
     const role = STAGE_ROLE_MAP[input.stage];
-    const model = input.configInfo.config.roles[role];
-    const modelRef = parseModelRef(model);
-    const agent = await resolveAgentName(input.pluginInput.client, input.projectRoot, role);
+    const configuredModel = input.configInfo.config.roles[role];
+    const modelRef = parseModelRef(configuredModel);
+    const agent = await resolveAgentName(input.pluginInput.client, input.projectRoot, role, input.configInfo.config);
     const session = await createStageSession({
         client: input.pluginInput.client,
         parentSessionID: input.toolContext.sessionID,
@@ -261,7 +294,7 @@ async function runStageSession(input) {
         signal: input.toolContext.abort,
         body: {
             ...(agent ? { agent } : {}),
-            model: modelRef,
+            ...(agent ? {} : { model: modelRef }),
             system: input.system,
             tools: makeToolRestrictions(input.allowWorkspaceMutation),
             parts: [
@@ -293,7 +326,9 @@ async function runStageSession(input) {
     return {
         stage: input.stage,
         role,
-        model,
+        model: latestAssistant.info.providerID && latestAssistant.info.modelID
+            ? `${latestAssistant.info.providerID}/${latestAssistant.info.modelID}`
+            : configuredModel,
         agent,
         sessionID: session.id,
         messageID: latestAssistant.info.id,
@@ -381,6 +416,7 @@ export async function executePlanStage(input) {
     const content = renderStageDocument({
         stage: result.stage,
         role: result.role,
+        agent: result.agent,
         model: result.model,
         sessionID: result.sessionID,
         messageID: result.messageID,
@@ -396,6 +432,7 @@ export async function executePlanStage(input) {
         mode: "replace",
         details: {
             role: result.role,
+            agent: result.agent,
             model: result.model,
             sessionID: result.sessionID,
             messageID: result.messageID,
@@ -429,6 +466,7 @@ export async function executePlanReviewStage(input) {
     const content = renderStageDocument({
         stage: result.stage,
         role: result.role,
+        agent: result.agent,
         model: result.model,
         sessionID: result.sessionID,
         messageID: result.messageID,
@@ -444,6 +482,7 @@ export async function executePlanReviewStage(input) {
         mode: "replace",
         details: {
             role: result.role,
+            agent: result.agent,
             model: result.model,
             sessionID: result.sessionID,
             messageID: result.messageID,
@@ -500,6 +539,7 @@ export async function executeImplementStage(input) {
     const content = renderStageDocument({
         stage: result.stage,
         role: result.role,
+        agent: result.agent,
         model: result.model,
         sessionID: result.sessionID,
         messageID: result.messageID,
@@ -530,6 +570,7 @@ export async function executeImplementStage(input) {
         mode: "replace",
         details: {
             role: result.role,
+            agent: result.agent,
             model: result.model,
             sessionID: result.sessionID,
             messageID: result.messageID,
@@ -577,6 +618,7 @@ async function executeReviewerStage(input) {
     const content = renderStageDocument({
         stage: result.stage,
         role: result.role,
+        agent: result.agent,
         model: result.model,
         sessionID: result.sessionID,
         messageID: result.messageID,
@@ -592,6 +634,7 @@ async function executeReviewerStage(input) {
         mode: "replace",
         details: {
             role: result.role,
+            agent: result.agent,
             model: result.model,
             sessionID: result.sessionID,
             messageID: result.messageID,
@@ -655,6 +698,7 @@ export async function executeSynthesizeStage(input) {
     const content = renderStageDocument({
         stage: result.stage,
         role: result.role,
+        agent: result.agent,
         model: result.model,
         sessionID: result.sessionID,
         messageID: result.messageID,
@@ -670,6 +714,7 @@ export async function executeSynthesizeStage(input) {
         mode: "replace",
         details: {
             role: result.role,
+            agent: result.agent,
             model: result.model,
             sessionID: result.sessionID,
             messageID: result.messageID,

package/examples/akane.example.json

@@ -25,6 +25,16 @@
       "final-synthesis"
     ]
   },
+  "roleAgents": {
+    "planner": "prometheus",
+    "plan_reviewer": "metis",
+    "implementer": "atlas",
+    "consultant_primary": "oracle",
+    "consultant_secondary": "librarian",
+    "reviewer_codex": "momus",
+    "reviewer_claude": "oracle",
+    "synthesizer": "sisyphus"
+  },
   "roles": {
     "planner": "anthropic/claude-opus-4-6",
     "plan_reviewer": "openai/gpt-5.4",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-akane",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Akane orchestration plugin for OpenCode",
   "license": "MIT",
   "type": "module",