oh-my-opencode 4.16.1 → 4.16.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (151) hide show
  1. package/.agents/skills/pre-publish-review/SKILL.md +3 -0
  2. package/README.md +2 -2
  3. package/dist/agents/hephaestus/agent.d.ts +1 -1
  4. package/dist/agents/hephaestus/gpt-5-6.d.ts +2 -0
  5. package/dist/agents/momus-gpt-5-6.d.ts +1 -0
  6. package/dist/agents/types.d.ts +2 -0
  7. package/dist/cli/index.js +800 -536
  8. package/dist/cli-node/index.js +800 -536
  9. package/dist/features/background-agent/error-classifier.d.ts +5 -0
  10. package/dist/features/background-agent/parent-wake-dedupe.d.ts +1 -0
  11. package/dist/features/background-agent/parent-wake-flush-runner.d.ts +2 -0
  12. package/dist/features/background-agent/parent-wake-prompt-dispatch.d.ts +1 -0
  13. package/dist/features/builtin-commands/templates/refactor-sections/intro-and-analysis.d.ts +1 -1
  14. package/dist/features/builtin-commands/templates/remove-ai-slops.d.ts +1 -1
  15. package/dist/index.js +464 -54
  16. package/dist/shared/live-server-route.d.ts +1 -1
  17. package/dist/skills/review-work/SKILL.md +4 -2
  18. package/dist/skills/start-work/SKILL.md +2 -0
  19. package/dist/skills/ulw-plan/references/full-workflow.md +1 -1
  20. package/dist/skills/ulw-research/SKILL.md +5 -3
  21. package/dist/skills/visual-qa/SKILL.md +1 -1
  22. package/dist/tui.js +125 -13
  23. package/package.json +13 -13
  24. package/packages/omo-codex/plugin/.codex-plugin/plugin.json +1 -1
  25. package/packages/omo-codex/plugin/components/bootstrap/dist/cli.js +398 -246
  26. package/packages/omo-codex/plugin/components/bootstrap/hooks/hooks.json +1 -1
  27. package/packages/omo-codex/plugin/components/bootstrap/package.json +1 -1
  28. package/packages/omo-codex/plugin/components/codegraph/package.json +1 -1
  29. package/packages/omo-codex/plugin/components/comment-checker/hooks/hooks.json +1 -1
  30. package/packages/omo-codex/plugin/components/comment-checker/package.json +1 -1
  31. package/packages/omo-codex/plugin/components/git-bash/hooks/hooks.json +2 -2
  32. package/packages/omo-codex/plugin/components/git-bash/package.json +1 -1
  33. package/packages/omo-codex/plugin/components/lazycodex-executor-verify/hooks/hooks.json +1 -1
  34. package/packages/omo-codex/plugin/components/lazycodex-executor-verify/package.json +1 -1
  35. package/packages/omo-codex/plugin/components/lsp/hooks/hooks.json +2 -2
  36. package/packages/omo-codex/plugin/components/lsp/package.json +1 -1
  37. package/packages/omo-codex/plugin/components/rules/bundled-rules/{hephaestus.md → hephaestus/gpt-5.5.md} +1 -1
  38. package/packages/omo-codex/plugin/components/rules/bundled-rules/hephaestus/gpt-5.6.md +93 -0
  39. package/packages/omo-codex/plugin/components/rules/dist/cli.js +43 -24
  40. package/packages/omo-codex/plugin/components/rules/hooks/hooks.json +4 -4
  41. package/packages/omo-codex/plugin/components/rules/package.json +1 -1
  42. package/packages/omo-codex/plugin/components/rules/src/codex-hook.ts +2 -1
  43. package/packages/omo-codex/plugin/components/rules/src/dynamic-target-fingerprints.ts +15 -6
  44. package/packages/omo-codex/plugin/components/rules/src/rules-engine-factory.ts +7 -2
  45. package/packages/omo-codex/plugin/components/rules/src/static-injection.ts +2 -2
  46. package/packages/omo-codex/plugin/components/rules/test/codex-hook.test.ts +32 -0
  47. package/packages/omo-codex/plugin/components/rules/test/hephaestus-model-variant.test.ts +106 -0
  48. package/packages/omo-codex/plugin/components/start-work-continuation/directive.md +1 -1
  49. package/packages/omo-codex/plugin/components/start-work-continuation/hooks/hooks.json +2 -2
  50. package/packages/omo-codex/plugin/components/start-work-continuation/package.json +1 -1
  51. package/packages/omo-codex/plugin/components/start-work-continuation/test/codex-hook.test.ts +1 -1
  52. package/packages/omo-codex/plugin/components/teammode/AGENTS.md +12 -9
  53. package/packages/omo-codex/plugin/components/teammode/hooks/hooks.json +1 -1
  54. package/packages/omo-codex/plugin/components/teammode/package.json +1 -1
  55. package/packages/omo-codex/plugin/components/teammode/skills/teammode/SKILL.md +136 -76
  56. package/packages/omo-codex/plugin/components/teammode/skills/teammode/scripts/team-guide.mjs +94 -23
  57. package/packages/omo-codex/plugin/components/teammode/skills/teammode/scripts/team-state.mjs +94 -14
  58. package/packages/omo-codex/plugin/components/teammode/skills/teammode/scripts/team-transport.mjs +55 -0
  59. package/packages/omo-codex/plugin/components/teammode/skills/teammode/scripts/team.mjs +72 -18
  60. package/packages/omo-codex/plugin/components/teammode/test/thread-title-hook.test.ts +23 -0
  61. package/packages/omo-codex/plugin/components/telemetry/hooks/hooks.json +1 -1
  62. package/packages/omo-codex/plugin/components/telemetry/package.json +1 -1
  63. package/packages/omo-codex/plugin/components/ultrawork/agents/explorer.toml +24 -41
  64. package/packages/omo-codex/plugin/components/ultrawork/agents/lazycodex-clone-fidelity-reviewer.toml +1 -1
  65. package/packages/omo-codex/plugin/components/ultrawork/agents/lazycodex-code-reviewer.toml +1 -1
  66. package/packages/omo-codex/plugin/components/ultrawork/agents/lazycodex-executor.toml +2 -2
  67. package/packages/omo-codex/plugin/components/ultrawork/agents/lazycodex-gate-reviewer.toml +1 -1
  68. package/packages/omo-codex/plugin/components/ultrawork/agents/lazycodex-qa-executor.toml +1 -1
  69. package/packages/omo-codex/plugin/components/ultrawork/agents/librarian.toml +21 -49
  70. package/packages/omo-codex/plugin/components/ultrawork/agents/metis.toml +17 -29
  71. package/packages/omo-codex/plugin/components/ultrawork/agents/momus.toml +20 -50
  72. package/packages/omo-codex/plugin/components/ultrawork/agents/plan.toml +18 -39
  73. package/packages/omo-codex/plugin/components/ultrawork/directive.md +1 -0
  74. package/packages/omo-codex/plugin/components/ultrawork/hooks/hooks.json +1 -1
  75. package/packages/omo-codex/plugin/components/ultrawork/package.json +1 -1
  76. package/packages/omo-codex/plugin/components/ultrawork/skills/ultrawork/SKILL.md +1 -0
  77. package/packages/omo-codex/plugin/components/ultrawork/skills/ulw-plan/SKILL.md +2 -0
  78. package/packages/omo-codex/plugin/components/ultrawork/skills/ulw-plan/references/full-workflow.md +3 -1
  79. package/packages/omo-codex/plugin/components/ulw-loop/directive.md +1 -0
  80. package/packages/omo-codex/plugin/components/ulw-loop/hooks/hooks.json +2 -2
  81. package/packages/omo-codex/plugin/components/ulw-loop/package.json +1 -1
  82. package/packages/omo-codex/plugin/components/ulw-loop/skills/ulw-loop/SKILL.md +2 -0
  83. package/packages/omo-codex/plugin/components/ulw-loop/skills/ulw-loop/references/full-workflow.md +1 -1
  84. package/packages/omo-codex/plugin/components/ulw-loop/test/skill-contract.test.ts +1 -1
  85. package/packages/omo-codex/plugin/hooks/post-compact-resetting-git-bash-mcp-reminder.json +1 -1
  86. package/packages/omo-codex/plugin/hooks/post-compact-resetting-lsp-diagnostics-cache.json +1 -1
  87. package/packages/omo-codex/plugin/hooks/post-compact-resetting-project-rule-cache.json +1 -1
  88. package/packages/omo-codex/plugin/hooks/post-tool-use-checking-codegraph-init-guidance.json +1 -1
  89. package/packages/omo-codex/plugin/hooks/post-tool-use-checking-comments.json +1 -1
  90. package/packages/omo-codex/plugin/hooks/post-tool-use-checking-lsp-diagnostics.json +1 -1
  91. package/packages/omo-codex/plugin/hooks/post-tool-use-checking-thread-title-hygiene.json +1 -1
  92. package/packages/omo-codex/plugin/hooks/post-tool-use-matching-project-rules.json +1 -1
  93. package/packages/omo-codex/plugin/hooks/pre-tool-use-enforcing-unlimited-goal-budget.json +1 -1
  94. package/packages/omo-codex/plugin/hooks/pre-tool-use-recommending-git-bash-mcp.json +1 -1
  95. package/packages/omo-codex/plugin/hooks/session-start-checking-auto-update.json +1 -1
  96. package/packages/omo-codex/plugin/hooks/session-start-checking-bootstrap-provisioning.json +1 -1
  97. package/packages/omo-codex/plugin/hooks/session-start-checking-codegraph-bootstrap.json +1 -1
  98. package/packages/omo-codex/plugin/hooks/session-start-loading-project-rules.json +1 -1
  99. package/packages/omo-codex/plugin/hooks/session-start-recording-session-telemetry.json +1 -1
  100. package/packages/omo-codex/plugin/hooks/stop-checking-start-work-continuation.json +1 -1
  101. package/packages/omo-codex/plugin/hooks/subagent-stop-checking-start-work-continuation.json +1 -1
  102. package/packages/omo-codex/plugin/hooks/subagent-stop-verifying-lazycodex-executor-evidence.json +1 -1
  103. package/packages/omo-codex/plugin/hooks/user-prompt-submit-checking-ultrawork-trigger.json +1 -1
  104. package/packages/omo-codex/plugin/hooks/user-prompt-submit-checking-ulw-loop-steering.json +1 -1
  105. package/packages/omo-codex/plugin/hooks/user-prompt-submit-loading-project-rules.json +1 -1
  106. package/packages/omo-codex/plugin/package-lock.json +13 -13
  107. package/packages/omo-codex/plugin/package.json +1 -1
  108. package/packages/omo-codex/plugin/scripts/auto-update.mjs +73 -19
  109. package/packages/omo-codex/plugin/scripts/entry-guard.mjs +26 -0
  110. package/packages/omo-codex/plugin/scripts/materialize-shared-upstreams.mjs +3 -1
  111. package/packages/omo-codex/plugin/scripts/migrate-codex-config/multi-agent-v2-guard.mjs +221 -20
  112. package/packages/omo-codex/plugin/scripts/migrate-codex-config/subagent-limit-guard.mjs +71 -3
  113. package/packages/omo-codex/plugin/scripts/migrate-codex-config.mjs +35 -7
  114. package/packages/omo-codex/plugin/scripts/migrate-omo-sot.mjs +2 -2
  115. package/packages/omo-codex/plugin/scripts/sync-hook-status-messages.mjs +2 -2
  116. package/packages/omo-codex/plugin/scripts/sync-skills.mjs +7 -5
  117. package/packages/omo-codex/plugin/scripts/sync-version.mjs +4 -2
  118. package/packages/omo-codex/plugin/skills/init-deep/SKILL.md +2 -2
  119. package/packages/omo-codex/plugin/skills/refactor/SKILL.md +2 -2
  120. package/packages/omo-codex/plugin/skills/remove-ai-slops/SKILL.md +2 -2
  121. package/packages/omo-codex/plugin/skills/review-work/SKILL.md +2 -2
  122. package/packages/omo-codex/plugin/skills/start-work/SKILL.md +2 -2
  123. package/packages/omo-codex/plugin/skills/teammode/SKILL.md +136 -76
  124. package/packages/omo-codex/plugin/skills/teammode/scripts/team-guide.mjs +94 -23
  125. package/packages/omo-codex/plugin/skills/teammode/scripts/team-state.mjs +94 -14
  126. package/packages/omo-codex/plugin/skills/teammode/scripts/team-transport.mjs +55 -0
  127. package/packages/omo-codex/plugin/skills/teammode/scripts/team.mjs +72 -18
  128. package/packages/omo-codex/plugin/skills/ultrawork/SKILL.md +1 -0
  129. package/packages/omo-codex/plugin/skills/ulw-loop/SKILL.md +2 -0
  130. package/packages/omo-codex/plugin/skills/ulw-loop/references/full-workflow.md +1 -1
  131. package/packages/omo-codex/plugin/skills/ulw-plan/SKILL.md +2 -0
  132. package/packages/omo-codex/plugin/skills/ulw-plan/references/full-workflow.md +3 -1
  133. package/packages/omo-codex/plugin/skills/ulw-research/SKILL.md +3 -3
  134. package/packages/omo-codex/plugin/skills/visual-qa/SKILL.md +3 -3
  135. package/packages/omo-codex/plugin/test/aggregate-agents.test.mjs +47 -1
  136. package/packages/omo-codex/plugin/test/aggregate-plugin-fixture.mjs +1 -1
  137. package/packages/omo-codex/plugin/test/aggregate-skills.test.mjs +4 -2
  138. package/packages/omo-codex/plugin/test/auto-update-restart-notice.test.mjs +33 -0
  139. package/packages/omo-codex/plugin/test/auto-update.test.mjs +35 -1
  140. package/packages/omo-codex/plugin/test/migrate-codex-config.test.mjs +412 -19
  141. package/packages/omo-codex/plugin/test/multi-agent-v2-regression.test.mjs +71 -0
  142. package/packages/omo-codex/plugin/test/subagent-limit-migration.test.mjs +65 -0
  143. package/packages/omo-codex/plugin/test/sync-skills-orchestration.test.mjs +13 -4
  144. package/packages/omo-codex/plugin/test/teammode-transport.test.mjs +345 -0
  145. package/packages/omo-codex/scripts/install-dist/install-local.mjs +436 -284
  146. package/packages/omo-codex/scripts/install-generated-bundle.test.mjs +111 -1
  147. package/packages/shared-skills/skills/review-work/SKILL.md +4 -2
  148. package/packages/shared-skills/skills/start-work/SKILL.md +2 -0
  149. package/packages/shared-skills/skills/ulw-plan/references/full-workflow.md +1 -1
  150. package/packages/shared-skills/skills/ulw-research/SKILL.md +5 -3
  151. package/packages/shared-skills/skills/visual-qa/SKILL.md +1 -1
@@ -3,7 +3,7 @@ export declare const LIVE_ROUTE_UNAVAILABLE_LOG = "[live-server-route] route una
3
3
  type RouteResult = {
4
4
  client: unknown;
5
5
  route: "live" | "in-process";
6
- reason: "identity" | "flag" | "child" | "unavailable" | "live";
6
+ reason: "identity" | "flag" | "child" | "unavailable" | "live" | "affinity";
7
7
  };
8
8
  type FetchImpl = typeof fetch;
9
9
  export declare function _setFetchImplementationForTesting(impl: FetchImpl | undefined): void;
@@ -14,9 +14,11 @@ This skill may include examples copied from the OpenCode harness. In Codex, do n
14
14
  | `task(subagent_type="oracle", ...)` for final verification | `multi_agent_v1.spawn_agent({"message":"TASK: act as a rigorous reviewer. ...","agent_type":"lazycodex-gate-reviewer","fork_context":false})` |
15
15
  | `task(category="...", ...)` for implementation or QA | `multi_agent_v1.spawn_agent({"message":"TASK: act as an implementation or QA worker. ...","fork_context":false})` |
16
16
  | `background_output(task_id="...")` | `multi_agent_v1.wait_agent(...)` for mailbox signals |
17
- | `team_*(...)` | Use Codex native subagents via `multi_agent_v1.spawn_agent`, `multi_agent_v1.send_input`, `multi_agent_v1.wait_agent`, and `multi_agent_v1.close_agent` |
17
+ | `team_*(...)` | Use Codex native subagents via `multi_agent_v1.spawn_agent` and `multi_agent_v1.wait_agent`; use `multi_agent_v1.send_input` and `multi_agent_v1.close_agent` only when exposed in the active tools list |
18
18
 
19
- Role-specific behavior must be described in a self-contained `message`. Use `fork_context: false` to start the child with only the initial prompt (no parent history); use `fork_context: true` only when full parent history is truly required. Include any required conversation context, files, diffs, constraints, and requested skill names directly in the spawned agent's `message`. OMO installs these selectable agent roles into `~/.codex/agents/`: `explorer`, `librarian`, `plan`, `momus`, `metis`, `lazycodex-code-reviewer`, `lazycodex-qa-executor`, and `lazycodex-gate-reviewer` — pass the matching name as `agent_type` so the child gets that role's model and instructions. On `multi_agent_v2` sessions the same `agent_type` applies (the OMO installer exposes it) with `fork_turns` instead of `fork_context`. If the spawn tool exposes no `agent_type` parameter, omit it and describe the role inside `message`. If a code block below conflicts with this section, this section wins.
19
+ Role-specific behavior must be described in a self-contained `message`. Use `fork_context: false` to start the child with only the initial prompt (no parent history); use `fork_context: true` only when full parent history is truly required. Include any required conversation context, files, diffs, constraints, and requested skill names directly in the spawned agent's `message`. OMO installs these selectable agent roles into `~/.codex/agents/`: `explorer`, `librarian`, `plan`, `momus`, `metis`, `lazycodex-code-reviewer`, `lazycodex-qa-executor`, and `lazycodex-gate-reviewer` — pass the matching name as `agent_type` so the child gets that role's model and instructions. If the spawn tool exposes no `agent_type` parameter, omit it and describe the role inside `message`. If a code block below conflicts with this section, this section wins.
20
+
21
+ Codex exposes ONE of two subagent tool surfaces per session; check your own tool list and route accordingly. If `multi_agent_v1.*` tools exist, use the table above as written. If instead a flat `spawn_agent` with a required `task_name` exists (`multi_agent_v2`), rewrite every `multi_agent_v1.*` example: `multi_agent_v1.spawn_agent({...,"fork_context":false})` becomes `spawn_agent({"task_name":"<lowercase_digits_underscores>","message":...,"agent_type":...,"fork_turns":"none"})` (`"all"` only when full parent history is truly required); `send_input` becomes `send_message`; do not call `close_agent`/`resume_agent` (finished agents end on their own; `followup_task` re-tasks one, `interrupt_agent` stops one); `wait_agent` takes only `timeout_ms` and returns on any child mailbox activity. `agent_type` works the same on both surfaces. If a code block below conflicts with this section, this section wins.
20
22
 
21
23
  For work likely to exceed one wait cycle, require the child to send `WORKING: <task> - <current phase>` before long passes and `BLOCKED: <reason>` only when progress stops. A `multi_agent_v1.wait_agent` timeout only means no new mailbox update arrived. Treat a running child as alive. Fallback only when the child is completed without the deliverable, ack-only after followup, explicitly `BLOCKED:`, or no longer running.
22
24
 
@@ -20,6 +20,8 @@ Translate any OpenCode-only tool name in an inherited example to its Codex equiv
20
20
 
21
21
  When translating `load_skills=[...]`, name the skills inside the spawned agent's `message`. If a code block below conflicts with this section, this section wins.
22
22
 
23
+ Codex exposes ONE of two subagent tool surfaces per session; check your own tool list and route accordingly. If `multi_agent_v1.*` tools exist, use the table above as written. If instead a flat `spawn_agent` with a required `task_name` exists (`multi_agent_v2`), rewrite every `multi_agent_v1.*` example: `multi_agent_v1.spawn_agent({...,"fork_context":false})` becomes `spawn_agent({"task_name":"<lowercase_digits_underscores>","message":...,"agent_type":...,"fork_turns":"none"})` (`"all"` only when full parent history is truly required); `send_input` becomes `send_message`; do not call `close_agent`/`resume_agent` (finished agents end on their own; `followup_task` re-tasks one, `interrupt_agent` stops one); `wait_agent` takes only `timeout_ms` and returns on any child mailbox activity. `agent_type` works the same on both surfaces. If a code block below conflicts with this section, this section wins.
24
+
23
25
  ## Codex Subagent Reliability
24
26
 
25
27
  Every `multi_agent_v1.spawn_agent` message is a self-contained executable assignment: `TASK: <imperative assignment>`, then `DELIVERABLE`, `SCOPE`, and `VERIFY`, with role instructions inside `message`. Use `fork_context: false` unless full history is truly required; paste only the context the child needs.
@@ -85,7 +85,7 @@ Runs in parallel; ALL must APPROVE; surface results and wait for the user's expl
85
85
  - UNCLEAR: run the high-accuracy review AUTOMATICALLY before presenting (unless Classify=Trivial), then present a brief that LEADS with the derived approach and the adopted defaults; still wait for the user's explicit okay.
86
86
 
87
87
  ### High-accuracy review (dual review)
88
- The high-accuracy review is DUAL and both passes must return OKAY before handoff: (1) the native `momus` reviewer subagent, and (2) an independent Oracle review via `task(subagent_type="oracle", ...)` on the strongest available reasoning model, in a fully isolated sub-session with normal approval and sandbox policy. Do not add flags that disable approvals or sandboxing. One round = exactly ONE `momus` + ONE independent review, dispatched together against the COMPLETE plan file (todos + TL;DR filled) - never a second `momus` while a round is in flight. After both verdicts return, fix every cited issue and resubmit both fresh until each approves. CLEAR: runs when the user opts in or `review_required: true`. UNCLEAR: runs automatically unless Classify=Trivial.
88
+ The high-accuracy review is DUAL and both passes must return OKAY before handoff: (1) the native `momus` reviewer subagent, and (2) an independent Oracle review via `task(subagent_type="oracle", ...)` on the strongest available reasoning model, in a fully isolated sub-session with normal approval and sandbox policy. Do not add flags that disable approvals or sandboxing. Momus runs at Ultra and may take substantially longer than other agents. One round = exactly ONE `momus` + ONE independent review, dispatched together against the COMPLETE plan file (todos + TL;DR filled). Keep Momus in flight and wait for its terminal result: elapsed time alone never justifies cancelling, duplicating, replacing, or treating it as failed. After both verdicts return, fix every cited issue and resubmit both fresh until each approves. CLEAR: runs when the user opts in or `review_required: true`. UNCLEAR: runs automatically unless Classify=Trivial.
89
89
 
90
90
  The draft must record the native Momus session/result, the independent review session/result, and the fix/retry summary. Do not say "high-accuracy review completed" unless both receipts exist and both final verdicts are unconditional approval.
91
91
 
@@ -15,9 +15,11 @@ This skill may include examples copied from the OpenCode harness. In Codex, do n
15
15
  | `task(subagent_type="oracle", ...)` for final verification | `multi_agent_v1.spawn_agent({"message":"TASK: act as a rigorous reviewer. ...","agent_type":"lazycodex-gate-reviewer","fork_context":false})` |
16
16
  | `task(category="...", ...)` for implementation or QA | `multi_agent_v1.spawn_agent({"message":"TASK: act as an implementation or QA worker. ...","fork_context":false})` |
17
17
  | `background_output(task_id="...")` | `multi_agent_v1.wait_agent(...)` for mailbox signals |
18
- | `team_*(...)` | Use Codex native subagents via `multi_agent_v1.spawn_agent`, `multi_agent_v1.send_input`, `multi_agent_v1.wait_agent`, and `multi_agent_v1.close_agent` |
18
+ | `team_*(...)` | Use Codex native subagents via `multi_agent_v1.spawn_agent` and `multi_agent_v1.wait_agent`; use `multi_agent_v1.send_input` and `multi_agent_v1.close_agent` only when exposed in the active tools list |
19
19
 
20
- Role-specific behavior must be described in a self-contained `message`. Use `fork_context: false` to start the child with only the initial prompt (no parent history); use `fork_context: true` only when full parent history is truly required. Include any required conversation context, files, diffs, constraints, and requested skill names directly in the spawned agent's `message`. OMO installs these selectable agent roles into `~/.codex/agents/`: `explorer`, `librarian`, `plan`, `momus`, `metis`, `lazycodex-code-reviewer`, `lazycodex-qa-executor`, and `lazycodex-gate-reviewer` — pass the matching name as `agent_type` so the child gets that role's model and instructions. On `multi_agent_v2` sessions the same `agent_type` applies (the OMO installer exposes it) with `fork_turns` instead of `fork_context`. If the spawn tool exposes no `agent_type` parameter, omit it and describe the role inside `message`. If a code block below conflicts with this section, this section wins.
20
+ Role-specific behavior must be described in a self-contained `message`. Use `fork_context: false` to start the child with only the initial prompt (no parent history); use `fork_context: true` only when full parent history is truly required. Include any required conversation context, files, diffs, constraints, and requested skill names directly in the spawned agent's `message`. OMO installs these selectable agent roles into `~/.codex/agents/`: `explorer`, `librarian`, `plan`, `momus`, `metis`, `lazycodex-code-reviewer`, `lazycodex-qa-executor`, and `lazycodex-gate-reviewer` — pass the matching name as `agent_type` so the child gets that role's model and instructions. If the spawn tool exposes no `agent_type` parameter, omit it and describe the role inside `message`. If a code block below conflicts with this section, this section wins.
21
+
22
+ Codex exposes ONE of two subagent tool surfaces per session; check your own tool list and route accordingly. If `multi_agent_v1.*` tools exist, use the table above as written. If instead a flat `spawn_agent` with a required `task_name` exists (`multi_agent_v2`), rewrite every `multi_agent_v1.*` example: `multi_agent_v1.spawn_agent({...,"fork_context":false})` becomes `spawn_agent({"task_name":"<lowercase_digits_underscores>","message":...,"agent_type":...,"fork_turns":"none"})` (`"all"` only when full parent history is truly required); `send_input` becomes `send_message`; do not call `close_agent`/`resume_agent` (finished agents end on their own; `followup_task` re-tasks one, `interrupt_agent` stops one); `wait_agent` takes only `timeout_ms` and returns on any child mailbox activity. `agent_type` works the same on both surfaces. If a code block below conflicts with this section, this section wins.
21
23
 
22
24
  For work likely to exceed one wait cycle, require the child to send `WORKING: <task> - <current phase>` before long passes and `BLOCKED: <reason>` only when progress stops. A `multi_agent_v1.wait_agent` timeout only means no new mailbox update arrived. Treat a running child as alive. Fallback only when the child is completed without the deliverable, ack-only after followup, explicitly `BLOCKED:`, or no longer running.
23
25
 
@@ -67,7 +69,7 @@ Observation candidates and claim candidates travel back from workers as message
67
69
 
68
70
  ## Run the swarm as a cooperating team
69
71
 
70
- Saturation research defaults to teammode, not isolated fire-and-forget workers: a lead one worker surfaces almost always reshapes what another should search next. When your harness gives you real cooperating members — Codex: the `teammode` skill (`codex_app` threads); OpenCode: `team_mode` — run this swarm as a team. Fall back to the background-worker swarm below only when team mode is unavailable, or the axes are genuinely independent with no cross-pollination expected.
72
+ Saturation research defaults to teammode, not isolated fire-and-forget workers: a lead one worker surfaces almost always reshapes what another should search next. When your harness gives you real cooperating members — Codex: the `teammode` skill (MultiAgentV2 agents, or `codex_app` threads as its fallback); OpenCode: `team_mode` — run this swarm as a team. Fall back to the background-worker swarm below only when team mode is unavailable, or the axes are genuinely independent with no cross-pollination expected.
71
73
 
72
74
  - **One member per axis — by part, ownership, or perspective, never a job title.** Each Phase 0 axis is one member owning one concrete slice: a codebase part, a source territory, or a question lens. No two members share an angle. "Backend researcher" or "the web person" gives no real boundary and invites overlap — name what the member owns.
73
75
  - **Many teammates by default.** Prefer a larger roster, usually 5-8 teammates, whenever the axes can be made distinct. Add at least one skeptic or red-team perspective for hyperdebate/ultradebate: cross-critique claims, evidence quality, synthesis structure, and visual-report choices before they reach the final deliverable.
@@ -249,7 +249,7 @@ If any page fails, you are not done: fix it, re-capture the full set, re-dispatc
249
249
 
250
250
  Run this step IN ADDITION to Steps 1-4 when the original user task has a concrete visual target: "clone this site", "move this Figma design to code", "rebuild this screen", "make it look exactly like X", or "build this Imagen/Stitch/generated mockup and overview". For these tasks the normal dual-oracle is necessary but NOT sufficient. After it returns, run the following TWO additional MANDATORY verifications and LOOP until BOTH pass.
251
251
 
252
- 1. Pixel-perfect design-compare subagent (visual oracle). Dispatch a focused, read-only design-compare reviewer (recommend `gpt-5.5` with medium reasoning). It must crop/zoom BOTH the reference (target / Figma export / source-site screenshot / generated page snapshot) and the ACTUAL screenshot into matching regions and read them **pixel-by-pixel** - header, nav, each card, spacing, type ramp, color tokens - not at a glance. It must also compare the overview text or annotations against the rendered content and DOM text. Anchor every claim with the bundled tool:
252
+ 1. Pixel-perfect design-compare subagent (visual oracle). Dispatch a focused, read-only design-compare reviewer (recommend `gpt-5.6-sol` with xhigh reasoning). It must crop/zoom BOTH the reference (target / Figma export / source-site screenshot / generated page snapshot) and the ACTUAL screenshot into matching regions and read them **pixel-by-pixel** - header, nav, each card, spacing, type ramp, color tokens - not at a glance. It must also compare the overview text or annotations against the rendered content and DOM text. Anchor every claim with the bundled tool:
253
253
 
254
254
  ```
255
255
  node "$SKILL_DIR/scripts/visual-qa.mjs" image-diff <reference.png> <actual.png>
package/dist/tui.js CHANGED
@@ -20694,6 +20694,11 @@ var init_agent_model_requirements = __esm(() => {
20694
20694
  },
20695
20695
  hephaestus: {
20696
20696
  fallbackChain: [
20697
+ {
20698
+ providers: ["openai", "vercel"],
20699
+ model: "gpt-5.6-sol",
20700
+ variant: "medium"
20701
+ },
20697
20702
  {
20698
20703
  providers: ["openai", "github-copilot", "opencode", "vercel"],
20699
20704
  model: "gpt-5.5",
@@ -20720,7 +20725,7 @@ var init_agent_model_requirements = __esm(() => {
20720
20725
  model: "claude-opus-4-7",
20721
20726
  variant: "max"
20722
20727
  },
20723
- { providers: ["opencode-go", "vercel"], model: "glm-5.1" }
20728
+ { providers: ["opencode-go", "vercel"], model: "glm-5.2" }
20724
20729
  ]
20725
20730
  },
20726
20731
  librarian: {
@@ -20767,7 +20772,7 @@ var init_agent_model_requirements = __esm(() => {
20767
20772
  model: "gpt-5.5",
20768
20773
  variant: "high"
20769
20774
  },
20770
- { providers: ["opencode-go", "vercel"], model: "glm-5.1" },
20775
+ { providers: ["opencode-go", "vercel"], model: "glm-5.2" },
20771
20776
  {
20772
20777
  providers: ["google", "github-copilot", "opencode", "vercel"],
20773
20778
  model: "gemini-3.1-pro"
@@ -20790,12 +20795,17 @@ var init_agent_model_requirements = __esm(() => {
20790
20795
  model: "gpt-5.5",
20791
20796
  variant: "high"
20792
20797
  },
20793
- { providers: ["opencode-go", "vercel"], model: "glm-5.1" },
20798
+ { providers: ["opencode-go", "vercel"], model: "glm-5.2" },
20794
20799
  { providers: ["kimi-for-coding"], model: "k2p5" }
20795
20800
  ]
20796
20801
  },
20797
20802
  momus: {
20798
20803
  fallbackChain: [
20804
+ {
20805
+ providers: ["openai", "vercel"],
20806
+ model: "gpt-5.6-sol",
20807
+ variant: "xhigh"
20808
+ },
20799
20809
  {
20800
20810
  providers: ["openai", "github-copilot", "opencode", "vercel"],
20801
20811
  model: "gpt-5.5",
@@ -20811,7 +20821,7 @@ var init_agent_model_requirements = __esm(() => {
20811
20821
  model: "gemini-3.1-pro",
20812
20822
  variant: "high"
20813
20823
  },
20814
- { providers: ["opencode-go", "vercel"], model: "glm-5.1" }
20824
+ { providers: ["opencode-go", "vercel"], model: "glm-5.2" }
20815
20825
  ]
20816
20826
  },
20817
20827
  atlas: {
@@ -20863,12 +20873,17 @@ var init_category_model_requirements = __esm(() => {
20863
20873
  model: "claude-opus-4-7",
20864
20874
  variant: "max"
20865
20875
  },
20866
- { providers: ["opencode-go", "vercel"], model: "glm-5.1" },
20876
+ { providers: ["opencode-go", "vercel"], model: "glm-5.2" },
20867
20877
  { providers: ["kimi-for-coding"], model: "k2p5" }
20868
20878
  ]
20869
20879
  },
20870
20880
  ultrabrain: {
20871
20881
  fallbackChain: [
20882
+ {
20883
+ providers: ["openai", "vercel"],
20884
+ model: "gpt-5.6-sol",
20885
+ variant: "xhigh"
20886
+ },
20872
20887
  {
20873
20888
  providers: ["openai", "opencode", "vercel"],
20874
20889
  model: "gpt-5.5",
@@ -20884,11 +20899,16 @@ var init_category_model_requirements = __esm(() => {
20884
20899
  model: "claude-opus-4-7",
20885
20900
  variant: "max"
20886
20901
  },
20887
- { providers: ["opencode-go", "vercel"], model: "glm-5.1" }
20902
+ { providers: ["opencode-go", "vercel"], model: "glm-5.2" }
20888
20903
  ]
20889
20904
  },
20890
20905
  deep: {
20891
20906
  fallbackChain: [
20907
+ {
20908
+ providers: ["openai", "vercel"],
20909
+ model: "gpt-5.6-sol",
20910
+ variant: "high"
20911
+ },
20892
20912
  {
20893
20913
  providers: ["openai", "github-copilot", "opencode", "vercel"],
20894
20914
  model: "gpt-5.5",
@@ -20905,7 +20925,7 @@ var init_category_model_requirements = __esm(() => {
20905
20925
  variant: "high"
20906
20926
  },
20907
20927
  { providers: ["opencode-go", "vercel"], model: "kimi-k2.6" },
20908
- { providers: ["opencode-go", "vercel"], model: "glm-5.1" }
20928
+ { providers: ["opencode-go", "vercel"], model: "glm-5.2" }
20909
20929
  ]
20910
20930
  },
20911
20931
  artistry: {
@@ -20922,7 +20942,7 @@ var init_category_model_requirements = __esm(() => {
20922
20942
  },
20923
20943
  { providers: ["openai", "github-copilot", "opencode", "vercel"], model: "gpt-5.5" },
20924
20944
  { providers: ["opencode-go", "vercel"], model: "kimi-k2.6" },
20925
- { providers: ["opencode-go", "vercel"], model: "glm-5.1" }
20945
+ { providers: ["opencode-go", "vercel"], model: "glm-5.2" }
20926
20946
  ]
20927
20947
  },
20928
20948
  quick: {
@@ -20980,7 +21000,7 @@ var init_category_model_requirements = __esm(() => {
20980
21000
  },
20981
21001
  { providers: ["zai-coding-plan", "opencode", "bailian-coding-plan", "vercel"], model: "glm-5" },
20982
21002
  { providers: ["kimi-for-coding"], model: "k2p5" },
20983
- { providers: ["opencode-go", "vercel"], model: "glm-5.1" },
21003
+ { providers: ["opencode-go", "vercel"], model: "glm-5.2" },
20984
21004
  { providers: ["opencode", "bailian-coding-plan", "vercel"], model: "kimi-k2.5" },
20985
21005
  {
20986
21006
  providers: [
@@ -21328,6 +21348,22 @@ var init_supplemental_entries = __esm(() => {
21328
21348
  output: 262144
21329
21349
  }
21330
21350
  },
21351
+ "gpt-5.6-sol": {
21352
+ id: "gpt-5.6-sol",
21353
+ family: "gpt",
21354
+ reasoning: true,
21355
+ temperature: false,
21356
+ toolCall: true,
21357
+ modalities: {
21358
+ input: ["text", "image", "pdf"],
21359
+ output: ["text"]
21360
+ },
21361
+ limit: {
21362
+ context: 1050000,
21363
+ input: 922000,
21364
+ output: 128000
21365
+ }
21366
+ },
21331
21367
  "gpt-5.5": {
21332
21368
  id: "gpt-5.5",
21333
21369
  family: "gpt",
@@ -22064,11 +22100,15 @@ function isGpt5_5Model(model) {
22064
22100
  const modelName = extractModelName(model).toLowerCase();
22065
22101
  return modelName.includes("gpt-5.5") || modelName.includes("gpt-5-5");
22066
22102
  }
22103
+ function isGpt5_6Model(model) {
22104
+ const modelName = extractModelName(model).toLowerCase();
22105
+ return modelName.includes("gpt-5.6") || modelName.includes("gpt-5-6");
22106
+ }
22067
22107
  var init_types3 = () => {};
22068
22108
 
22069
22109
  // packages/omo-opencode/src/tools/delegate-task/openai-categories.ts
22070
22110
  function resolveDeepCategoryPromptAppend(model) {
22071
- if (model && isGpt5_5Model(model)) {
22111
+ if (model && (isGpt5_5Model(model) || isGpt5_6Model(model))) {
22072
22112
  return DEEP_CATEGORY_PROMPT_APPEND_GPT_5_5;
22073
22113
  }
22074
22114
  return DEEP_CATEGORY_PROMPT_APPEND;
@@ -22187,13 +22227,13 @@ var init_openai_categories = __esm(() => {
22187
22227
  OPENAI_CATEGORIES = [
22188
22228
  {
22189
22229
  name: "ultrabrain",
22190
- config: { model: "openai/gpt-5.5", variant: "xhigh" },
22230
+ config: { model: "openai/gpt-5.6-sol", variant: "xhigh" },
22191
22231
  description: "Use ONLY for genuinely hard, logic-heavy tasks. Give clear goals only, not step-by-step instructions.",
22192
22232
  promptAppend: ULTRABRAIN_CATEGORY_PROMPT_APPEND
22193
22233
  },
22194
22234
  {
22195
22235
  name: "deep",
22196
- config: { model: "openai/gpt-5.5", variant: "medium" },
22236
+ config: { model: "openai/gpt-5.6-sol", variant: "high" },
22197
22237
  description: "Goal-oriented autonomous problem-solving on hairy problems requiring deep research. ONE goal + ONE deliverable per call \u2014 multiple goals must fan out as parallel `deep` calls, never bundled into one.",
22198
22238
  promptAppend: DEEP_CATEGORY_PROMPT_APPEND,
22199
22239
  resolvePromptAppend: resolveDeepCategoryPromptAppend
@@ -75205,6 +75245,66 @@ async function probe(registration) {
75205
75245
  return false;
75206
75246
  }
75207
75247
  }
75248
+ async function probeSessionAffinity(registration, sessionID) {
75249
+ if (!registration.serverUrl) {
75250
+ return;
75251
+ }
75252
+ const probeUrl = new URL(`/session/${sessionID}`, registration.serverUrl);
75253
+ const authHeader = getServerBasicAuthHeader();
75254
+ const headers = authHeader ? { Authorization: authHeader } : {};
75255
+ try {
75256
+ const controller = new AbortController;
75257
+ const timeoutId = setTimeout(() => controller.abort(), PROBE_ABORT_MS);
75258
+ let response;
75259
+ try {
75260
+ response = await getFetch()(probeUrl, { headers, signal: controller.signal });
75261
+ } finally {
75262
+ clearTimeout(timeoutId);
75263
+ }
75264
+ if (response.ok) {
75265
+ setSessionAffinity(registration, sessionID, true);
75266
+ return true;
75267
+ }
75268
+ if (response.status === 404) {
75269
+ setSessionAffinity(registration, sessionID, false);
75270
+ log2("[live-server-route] live listener does not own session; falling back to in-process client", { sessionID });
75271
+ return false;
75272
+ }
75273
+ return;
75274
+ } catch {
75275
+ return;
75276
+ }
75277
+ }
75278
+ function setSessionAffinity(registration, sessionID, owned) {
75279
+ const now = Date.now();
75280
+ for (const [key, entry] of registration.sessionAffinity) {
75281
+ if (now - entry.timestamp >= AFFINITY_TTL_MS) {
75282
+ registration.sessionAffinity.delete(key);
75283
+ }
75284
+ }
75285
+ registration.sessionAffinity.set(sessionID, { owned, timestamp: now });
75286
+ }
75287
+ function getFreshSessionAffinity(registration, sessionID) {
75288
+ const entry = registration.sessionAffinity.get(sessionID);
75289
+ if (!entry || Date.now() - entry.timestamp >= AFFINITY_TTL_MS) {
75290
+ return;
75291
+ }
75292
+ return entry.owned;
75293
+ }
75294
+ async function resolveSessionAffinity(registration, sessionID) {
75295
+ const cached2 = getFreshSessionAffinity(registration, sessionID);
75296
+ if (cached2 !== undefined) {
75297
+ return cached2;
75298
+ }
75299
+ let inFlight = registration.inFlightAffinity.get(sessionID);
75300
+ if (!inFlight) {
75301
+ inFlight = probeSessionAffinity(registration, sessionID).finally(() => {
75302
+ registration.inFlightAffinity.delete(sessionID);
75303
+ });
75304
+ registration.inFlightAffinity.set(sessionID, inFlight);
75305
+ }
75306
+ return inFlight;
75307
+ }
75208
75308
  function getFreshProbeAvailability(registration) {
75209
75309
  const available = registration.available;
75210
75310
  if (available === undefined || Date.now() - registration.probeTimestamp >= PROBE_TTL_MS) {
@@ -75257,6 +75357,13 @@ function tryResolveDispatchClientSync(client3, sessionID) {
75257
75357
  if (!freshAvailability) {
75258
75358
  return { client: client3, route: "in-process", reason: "unavailable" };
75259
75359
  }
75360
+ const cachedAffinity = getFreshSessionAffinity(registration, sessionID);
75361
+ if (cachedAffinity === undefined) {
75362
+ return;
75363
+ }
75364
+ if (!cachedAffinity) {
75365
+ return { client: client3, route: "in-process", reason: "affinity" };
75366
+ }
75260
75367
  const resolvedLiveClient = getOrBuildLiveClient(registration);
75261
75368
  if (!resolvedLiveClient) {
75262
75369
  return { client: client3, route: "in-process", reason: "unavailable" };
@@ -75276,6 +75383,10 @@ async function resolveDispatchClient(client3, sessionID) {
75276
75383
  if (!isAvailable) {
75277
75384
  return { client: client3, route: "in-process", reason: "unavailable" };
75278
75385
  }
75386
+ const affinity = await resolveSessionAffinity(registration, sessionID);
75387
+ if (affinity === false) {
75388
+ return { client: client3, route: "in-process", reason: "affinity" };
75389
+ }
75279
75390
  const resolvedLiveClient = getOrBuildLiveClient(registration);
75280
75391
  if (!resolvedLiveClient) {
75281
75392
  return { client: client3, route: "in-process", reason: "unavailable" };
@@ -75313,10 +75424,11 @@ function markLiveRouteUnavailable(reason) {
75313
75424
  for (const registration of registrations.values()) {
75314
75425
  registration.available = false;
75315
75426
  registration.probeTimestamp = Date.now();
75427
+ registration.sessionAffinity.clear();
75316
75428
  }
75317
75429
  log2(`[live-server-route] marked unavailable: ${reason}`);
75318
75430
  }
75319
- var PROBE_TTL_MS = 60000, PROBE_ABORT_MS = 1500, registrations, liveParentWakeRoutingDisabled = false, fetchImplementationForTesting;
75431
+ var PROBE_TTL_MS = 60000, PROBE_ABORT_MS = 1500, AFFINITY_TTL_MS = 60000, registrations, liveParentWakeRoutingDisabled = false, fetchImplementationForTesting;
75320
75432
  var init_live_server_route = __esm(() => {
75321
75433
  init_dist();
75322
75434
  init_state();
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "oh-my-opencode",
3
- "version": "4.16.1",
3
+ "version": "4.16.3",
4
4
  "description": "The Best AI Agent Harness - Batteries-Included OpenCode Plugin with Multi-Model Orchestration, Parallel Background Agents, and Crafted LSP/AST Tools",
5
5
  "main": "./dist/index.js",
6
6
  "types": "dist/index.d.ts",
@@ -210,18 +210,18 @@
210
210
  "typescript": "^6.0.3"
211
211
  },
212
212
  "optionalDependencies": {
213
- "oh-my-opencode-darwin-arm64": "4.16.1",
214
- "oh-my-opencode-darwin-x64": "4.16.1",
215
- "oh-my-opencode-darwin-x64-baseline": "4.16.1",
216
- "oh-my-opencode-linux-arm64": "4.16.1",
217
- "oh-my-opencode-linux-arm64-musl": "4.16.1",
218
- "oh-my-opencode-linux-x64": "4.16.1",
219
- "oh-my-opencode-linux-x64-baseline": "4.16.1",
220
- "oh-my-opencode-linux-x64-musl": "4.16.1",
221
- "oh-my-opencode-linux-x64-musl-baseline": "4.16.1",
222
- "oh-my-opencode-windows-arm64": "4.16.1",
223
- "oh-my-opencode-windows-x64": "4.16.1",
224
- "oh-my-opencode-windows-x64-baseline": "4.16.1"
213
+ "oh-my-opencode-darwin-arm64": "4.16.3",
214
+ "oh-my-opencode-darwin-x64": "4.16.3",
215
+ "oh-my-opencode-darwin-x64-baseline": "4.16.3",
216
+ "oh-my-opencode-linux-arm64": "4.16.3",
217
+ "oh-my-opencode-linux-arm64-musl": "4.16.3",
218
+ "oh-my-opencode-linux-x64": "4.16.3",
219
+ "oh-my-opencode-linux-x64-baseline": "4.16.3",
220
+ "oh-my-opencode-linux-x64-musl": "4.16.3",
221
+ "oh-my-opencode-linux-x64-musl-baseline": "4.16.3",
222
+ "oh-my-opencode-windows-arm64": "4.16.3",
223
+ "oh-my-opencode-windows-x64": "4.16.3",
224
+ "oh-my-opencode-windows-x64-baseline": "4.16.3"
225
225
  },
226
226
  "overrides": {
227
227
  "@earendil-works/pi-agent-core": "0.80.3",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "omo",
3
- "version": "4.16.1",
3
+ "version": "4.16.3",
4
4
  "description": "One Codex plugin namespace for Yeongyu's local Codex components.",
5
5
  "author": {
6
6
  "name": "Yeongyu Kim",