@wolfx/oh-my-openagent 3.17.15 → 4.0.0

package/dist/shared/tmux/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./types";
 export * from "./constants";
+export * from "./runner";
 export * from "./tmux-utils";

package/dist/shared/tmux/runner.d.ts

@@ -0,0 +1,13 @@
+type RunTmuxOptions = {
+    retry?: number;
+    timeoutMs?: number;
+};
+export type TmuxCommandResult = {
+    success: boolean;
+    output: string;
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+};
+export declare function runTmuxCommand(tmuxPath: string, args: string[], options?: RunTmuxOptions): Promise<TmuxCommandResult>;
+export {};

package/dist/shared/tmux/tmux-utils/pane-replace.d.ts

@@ -1,3 +1,3 @@
 import type { TmuxConfig } from "../../../config/schema";
 import type { SpawnPaneResult } from "../types";
-export declare function replaceTmuxPane(paneId: string, sessionId: string, description: string, config: TmuxConfig, serverUrl: string): Promise<SpawnPaneResult>;
+export declare function replaceTmuxPane(paneId: string, sessionId: string, description: string, config: TmuxConfig, serverUrl: string, directory: string): Promise<SpawnPaneResult>;

package/dist/shared/tmux/tmux-utils/pane-spawn.d.ts

@@ -1,4 +1,16 @@
 import type { TmuxConfig } from "../../../config/schema";
+import { getTmuxPath } from "../../../tools/interactive-bash/tmux-path-resolver";
 import type { SpawnPaneResult } from "../types";
+import type { runTmuxCommand as RunTmuxCommand } from "../runner";
 import type { SplitDirection } from "./environment";
-export declare function spawnTmuxPane(sessionId: string, description: string, config: TmuxConfig, serverUrl: string, targetPaneId?: string, splitDirection?: SplitDirection): Promise<SpawnPaneResult>;
+import { isInsideTmux } from "./environment";
+import { isServerRunning } from "./server-health";
+type SpawnTmuxPaneDeps = {
+    log: (message: string, data?: unknown) => void;
+    runTmuxCommand: typeof RunTmuxCommand;
+    isInsideTmux: typeof isInsideTmux;
+    isServerRunning: typeof isServerRunning;
+    getTmuxPath: typeof getTmuxPath;
+};
+export declare function spawnTmuxPane(sessionId: string, description: string, config: TmuxConfig, serverUrl: string, directory: string, targetPaneId?: string, splitDirection?: SplitDirection, depsInput?: Partial<SpawnTmuxPaneDeps>): Promise<SpawnPaneResult>;
+export {};

package/dist/shared/tmux/tmux-utils/session-spawn.d.ts

@@ -1,4 +1,16 @@
 import type { TmuxConfig } from "../../../config/schema";
+import { getTmuxPath } from "../../../tools/interactive-bash/tmux-path-resolver";
 import type { SpawnPaneResult } from "../types";
+import type { runTmuxCommand as RunTmuxCommand } from "../runner";
+import { isInsideTmux } from "./environment";
+import { isServerRunning } from "./server-health";
+type SpawnTmuxSessionDeps = {
+    log: (message: string, data?: unknown) => void;
+    runTmuxCommand: typeof RunTmuxCommand;
+    isInsideTmux: typeof isInsideTmux;
+    isServerRunning: typeof isServerRunning;
+    getTmuxPath: typeof getTmuxPath;
+};
 export declare function getIsolatedSessionName(pid?: number): string;
-export declare function spawnTmuxSession(sessionId: string, description: string, config: TmuxConfig, serverUrl: string, sourcePaneId?: string): Promise<SpawnPaneResult>;
+export declare function spawnTmuxSession(sessionId: string, description: string, config: TmuxConfig, serverUrl: string, directory: string, sourcePaneId?: string, depsInput?: Partial<SpawnTmuxSessionDeps>): Promise<SpawnPaneResult>;
+export {};

package/dist/shared/tmux/tmux-utils/stale-session-sweep.d.ts

@@ -1,11 +1,18 @@
-export type SweepDeps = {
+export type SweepTmuxSessionsDeps = {
     isInsideTmux: () => boolean;
     getTmuxPath: () => Promise<string | null | undefined>;
     listCandidateSessions: (tmux: string) => Promise<string[]>;
     killSession: (sessionName: string) => Promise<boolean>;
+    log: (message: string, payload?: unknown) => void;
+};
+export type SweepDeps = SweepTmuxSessionsDeps & {
     processAlive: (pid: number) => boolean;
     currentPid: number;
-    log: (message: string, payload?: unknown) => void;
 };
+export type SweepTmuxSessionsOptions = {
+    prefix?: string;
+    predicate?: (sessionName: string) => boolean;
+};
+export declare function sweepTmuxSessionsWith(deps: SweepTmuxSessionsDeps, options: SweepTmuxSessionsOptions): Promise<string[]>;
 export declare function sweepStaleOmoAgentSessionsWith(deps: SweepDeps): Promise<number>;
 export declare function sweepStaleOmoAgentSessions(): Promise<number>;

package/dist/shared/tmux/tmux-utils/window-spawn.d.ts

@@ -1,3 +1,15 @@
 import type { TmuxConfig } from "../../../config/schema";
+import { getTmuxPath } from "../../../tools/interactive-bash/tmux-path-resolver";
 import type { SpawnPaneResult } from "../types";
-export declare function spawnTmuxWindow(sessionId: string, description: string, config: TmuxConfig, serverUrl: string): Promise<SpawnPaneResult>;
+import { isInsideTmux } from "./environment";
+import { isServerRunning } from "./server-health";
+import type { runTmuxCommand as RunTmuxCommand } from "../runner";
+type SpawnTmuxWindowDeps = {
+    log: (message: string, data?: unknown) => void;
+    runTmuxCommand: typeof RunTmuxCommand;
+    isInsideTmux: typeof isInsideTmux;
+    isServerRunning: typeof isServerRunning;
+    getTmuxPath: typeof getTmuxPath;
+};
+export declare function spawnTmuxWindow(sessionId: string, description: string, config: TmuxConfig, serverUrl: string, directory: string, depsInput?: Partial<SpawnTmuxWindowDeps>): Promise<SpawnPaneResult>;
+export {};

package/dist/shared/tmux/tmux-utils.d.ts

@@ -9,5 +9,5 @@ export { replaceTmuxPane } from "./tmux-utils/pane-replace";
 export { spawnTmuxWindow } from "./tmux-utils/window-spawn";
 export { spawnTmuxSession, getIsolatedSessionName } from "./tmux-utils/session-spawn";
 export { killTmuxSessionIfExists } from "./tmux-utils/session-kill";
-export { sweepStaleOmoAgentSessions } from "./tmux-utils/stale-session-sweep";
+export { sweepStaleOmoAgentSessions, sweepTmuxSessionsWith } from "./tmux-utils/stale-session-sweep";
 export { applyLayout, enforceMainPaneWidth } from "./tmux-utils/layout";

package/dist/tools/delegate-task/openai-categories.d.ts

@@ -1,5 +1,6 @@
 import type { BuiltinCategoryDefinition } from "./builtin-category-definition";
 export declare const DEEP_CATEGORY_PROMPT_APPEND = "<Category_Context>\nYou are working on GOAL-ORIENTED AUTONOMOUS tasks.\n\nYou are NOT an interactive assistant. You are an autonomous problem-solver.\n\nBEFORE making ANY changes:\n1. Silently explore the codebase extensively (5-15 minutes of reading is normal)\n2. Read related files, trace dependencies, understand the full context\n3. Build a complete mental model of the problem space\n4. Do not ask clarifying questions - the goal is already defined\n\nYou receive a GOAL. When the goal includes numbered steps or phases, treat them as one atomic task broken into sub-steps, not as separate independent tasks. Figure out HOW to achieve it yourself. Thorough research before any action.\n\nSub-steps of ONE goal = execute all steps as phases of one atomic task.\nGenuinely independent tasks = flag and refuse, require separate delegations.\n\nApproach: explore extensively, understand deeply, then act decisively. Prefer comprehensive solutions over quick patches. If the goal is unclear, make reasonable assumptions and proceed.\n\nMinimal status updates. Focus on results, not play-by-play. Report completion with summary of changes.\n</Category_Context>";
+export declare const DEEP_CATEGORY_PROMPT_APPEND_GPT_5_3_CODEX = "<Category_Context name=\"deep\">\nYou are operating in DEEP mode on GPT-5.3-Codex. This category is reserved for goal-oriented autonomous coding work on hairy problems that reward depth over speed and a complete solution over a quick patch.\n\nThe orchestrator routed you here for autonomous execution. Do not stop to ask the orchestrator for permission, do not produce an upfront plan and wait for approval, do not stop at a proof of concept.\n\n# Autonomy and persistence\n\n- Once the goal is given, gather context, implement, verify, and explain outcomes within this turn whenever feasible.\n- Persist end-to-end: do not stop at analysis or partial fixes; carry changes through implementation, verification, and a clear explanation unless you hit a genuine blocker (missing secret, design decision only the user can make, three materially different attempts all failed).\n- Bias to action: default to implementing with reasonable assumptions. Do not end your turn with clarifying questions unless truly blocked. Document assumptions in the final message instead.\n- Avoid excessive looping. If you find yourself re-reading or re-editing the same files without clear progress, stop and end the turn with a concise summary and any clarifying questions needed.\n\n# Goal, not plan\n\nYou receive a GOAL describing the desired outcome. You figure out HOW. The orchestrator deliberately did not hand you a step-by-step plan; producing one and pausing for approval is not what was asked.\n\nWhen the goal contains numbered steps or phases, treat them as sub-steps of ONE atomic task and execute them all in this turn. Splitting them across turns is wrong unless they reveal an architectural blocker that requires the user's input. If the steps turn out to be genuinely independent tasks that should have been separate delegations, flag that in your final message and refuse the ones beyond scope.\n\n# Exploration\n\n- Think first. Before any tool call, decide ALL files and resources you will need.\n- Batch everything. If you need multiple files (even from different places), read them together using parallel tool calls.\n- Always maximize parallelism: never read files one-by-one unless logically unavoidable. For broader questions fire 2-5 explore/librarian sub-agents in parallel.\n- Workflow: (a) plan all needed reads, (b) issue one parallel batch, (c) analyze results, (d) repeat if new unpredictable reads arise. Sequential reads only when you truly cannot know the next file without seeing a prior result first.\n\nBuild a complete mental model before the first edit. Exploration is an investment, not overhead - the orchestrator routed depth tasks here specifically because rushing to implementation is the failure mode.\n\n# Code implementation\n\n- Discerning engineer mindset: optimize for correctness, clarity, and reliability over speed. Cover the root cause, not just a symptom or a narrow slice. Trace at least two levels up before settling - a null check around `foo()` is a symptom; fixing what causes `foo()` to return unexpected values is the root.\n- Conform to codebase conventions: follow existing patterns, helpers, naming, formatting, localization. If you must diverge, state why.\n- Behavior-safe defaults: preserve intended behavior and UX; gate or flag intentional changes; add tests when behavior shifts.\n- Tight error handling: no broad try/catch blocks, no success-shaped fallbacks; propagate or surface errors explicitly. No silent failures - do not early-return on invalid input without logging consistent with repo patterns.\n- Efficient, coherent edits: read enough context before changing a file; batch logical edits together rather than thrashing with many tiny patches.\n- Type safety: changes must pass build and type-check; avoid `as any` or `as unknown as ...`; prefer proper types and guards; reuse existing helpers.\n- Reuse / DRY: search for prior art before adding helpers; reuse or extract a shared helper instead of duplicating.\n- Ambition scaled to context: greenfield = strong defaults, avoid AI-slop, produce work you would hand to another senior engineer. Existing codebase = surgical, respect existing patterns. Depth does not mean invasiveness.\n\n# Completion bar\n\n\"Simplified version\", \"proof of concept\", and \"you can extend this later\" are not acceptable for a deep task. The orchestrator routed here specifically for a complete solution. If you hit a genuine blocker, document it and return; otherwise, finish the task.\n\n# Worktree safety\n\n- NEVER revert existing changes you did not make unless explicitly requested - those changes were made by the user.\n- If asked to commit and there are unrelated changes in those files, do not revert them.\n- If you notice unexpected changes you did not make in unrelated files, ignore them.\n- If you notice unexpected mid-rollout changes you did not make and are not sure how to proceed, stop and ask.\n- NEVER use destructive commands like `git reset --hard` or `git checkout --` unless explicitly requested.\n\n# Status cadence\n\nThe user is not on the other side of this conversation; the orchestrator is, and they will synthesize your progress. Send commentary only at meaningful phase transitions (starting exploration, starting implementation, starting verification, hitting a genuine blocker). Do not narrate every tool call; silence during focused work is expected.\n\nIf you used a planning tool, mark every previously stated intention as Done, Blocked (one-sentence reason + targeted question), or Cancelled (with reason) before finishing. Do not end with in_progress or pending items.\n\n# Final message\n\n- Be concise; pragmatic, not chatty. Higher actionable information per token; fewer social flourishes.\n- Lead with a quick explanation of the change, then context covering where and why. Do not start with \"Summary\"; jump in.\n- Reference paths only - do not dump file contents. Do not say \"save/copy this file\" - the user is on the same machine.\n- For substantial work, summarize clearly with high-level headings.\n- File references: inline code with standalone path. Examples: `src/app.ts`, `src/app.ts:42`. Do not use `file://`, `vscode://`, or `https://` URIs. Do not provide line ranges.\n- Suggest natural next steps (tests, commits, build) only if there are real ones; otherwise omit.\n</Category_Context>";
 export declare const DEEP_CATEGORY_PROMPT_APPEND_GPT_5_5 = "<Category_Context name=\"deep\">\nYou are operating in DEEP mode. This is the category reserved for goal-oriented autonomous work on hairy problems that reward thorough exploration and comprehensive solutions.\n\nThe orchestrator chose this category because the task benefits from depth over speed. You should feel empowered to spend the time needed: five to fifteen minutes of silent exploration before the first edit is normal and correct. Rushing to implementation on a deep task is a failure mode, not a feature.\n\n# How deep mode adjusts the base behavior\n\n**Exploration budget: generous.** Read the files you need, trace dependencies both directions, fire 2-5 explore/librarian sub-agents in parallel for broader questions. Build a complete mental model before the first `apply_patch`. Exploration here is an investment, not overhead.\n\n**Goal, not plan.** You receive a GOAL describing the desired outcome. You figure out HOW to achieve it. The orchestrator deliberately did not hand you a step-by-step plan; producing one and asking for approval is not what was asked. Execute.\n\n**Atomic task treatment.** When the goal contains numbered steps or phases, treat them as sub-steps of ONE task and execute them all in this turn. Splitting them across turns is wrong unless they reveal an architectural blocker that requires the user's input. If the \"steps\" turn out to be genuinely independent tasks that should have been separate delegations, flag that in your final message and refuse the ones beyond scope.\n\n**Root cause bias.** Prefer root-cause fixes over symptom fixes. A null check around `foo()` is a symptom fix; fixing whatever causes `foo()` to return unexpected values is the root fix. Trace at least two levels up before settling on an answer. In deep mode, you have permission (and the expectation) to do the deeper fix.\n\n**Ambition scaled to context.** For brand-new greenfield work, be ambitious. Choose strong defaults, avoid AI-slop aesthetics, produce something you would be proud to hand to another senior engineer. For changes in an existing codebase, be surgical and respect the existing patterns; depth does not mean invasiveness.\n\n**Completion bar: full delivery.** \"Simplified version\", \"proof of concept\", and \"you can extend this later\" are not acceptable deliveries for a deep task. The orchestrator routed here specifically for a complete solution. If you hit a genuine blocker (missing secret, design decision only the user can make, three materially different attempts all failed), document it and return; otherwise, finish the task.\n\n**Status cadence: sparse.** The user is not on the other side of this conversation; the orchestrator is, and they will synthesize your progress. Send commentary only at meaningful phase transitions (starting exploration, starting implementation, starting verification, hitting a genuine blocker). Do not narrate every tool call; silence during focused work is expected.\n</Category_Context>";
 export declare function resolveDeepCategoryPromptAppend(model: string | undefined): string;
 export declare const OPENAI_CATEGORIES: BuiltinCategoryDefinition[];

package/dist/tools/delegate-task/skill-resolver.d.ts

@@ -3,6 +3,7 @@ export declare function resolveSkillContent(skills: string[], options: {
     gitMasterConfig?: GitMasterConfig;
     browserProvider?: BrowserAutomationProvider;
     disabledSkills?: Set<string>;
+    teamModeEnabled?: boolean;
     directory?: string;
 }): Promise<{
     content: string | undefined;

package/dist/tools/delegate-task/subagent-resolver.d.ts

@@ -2,7 +2,11 @@ import type { DelegateTaskArgs } from "./types";
 import type { ExecutorContext } from "./executor-types";
 import type { DelegatedModelConfig } from "./types";
 import type { FallbackEntry } from "../../shared/model-requirements";
-export declare function resolveSubagentExecution(args: DelegateTaskArgs, executorCtx: ExecutorContext, parentAgent: string | undefined, categoryExamples: string): Promise<{
+export interface ResolveSubagentExecutionOptions {
+    allowSisyphusJuniorDirect?: boolean;
+    allowPrimaryAgentDelegation?: boolean;
+}
+export declare function resolveSubagentExecution(args: DelegateTaskArgs, executorCtx: ExecutorContext, parentAgent: string | undefined, categoryExamples: string, options?: ResolveSubagentExecutionOptions): Promise<{
     agentToUse: string;
     categoryModel: DelegatedModelConfig | undefined;
     fallbackChain?: FallbackEntry[];

package/dist/tools/delegate-task/types.d.ts

@@ -57,6 +57,7 @@ export interface DelegateTaskToolOptions {
     sisyphusJuniorModel?: string;
     browserProvider?: BrowserAutomationProvider;
     disabledSkills?: Set<string>;
+    teamModeEnabled?: boolean;
     availableCategories?: AvailableCategory[];
     availableSkills?: AvailableSkill[];
     agentOverrides?: AgentOverrides;

package/dist/tools/index.d.ts

@@ -17,5 +17,6 @@ export { createLookAt } from "./look-at";
 export { createDelegateTask } from "./delegate-task";
 export { createTaskCreateTool, createTaskGetTool, createTaskList, createTaskUpdateTool, } from "./task";
 export { createHashlineEditTool } from "./hashline-edit";
+export { createTeamSendMessageTool } from "../features/team-mode/tools/messaging";
 export declare function createBackgroundTools(manager: BackgroundManager, client: OpencodeClient): Record<string, ToolDefinition>;
 export declare const builtinTools: Record<string, ToolDefinition>;

package/dist/tools/look-at/missing-file-error.d.ts

@@ -0,0 +1,2 @@
+import type { LookAtArgs } from "./types";
+export declare function getMissingLookAtFilePath(error: unknown, args: LookAtArgs): string | null;

package/dist/tools/skill/types.d.ts

@@ -32,6 +32,8 @@ export interface SkillLoadOptions {
     disabledSkills?: Set<string>;
     /** Browser automation provider for provider-gated skill filtering */
     browserProvider?: BrowserAutomationProvider;
+    /** Whether team mode built-in docs should be exposed */
+    teamModeEnabled?: boolean;
     /** Include Claude marketplace plugin commands in discovery (default: true) */
     pluginsEnabled?: boolean;
     /** Override plugin enablement from Claude settings by plugin key */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wolfx/oh-my-openagent",
-  "version": "3.17.15",
+  "version": "4.0.0",
   "description": "A fork of oh-my-openagent",
   "main": "./dist/index.js",
   "types": "dist/index.d.ts",
@@ -71,6 +71,7 @@
     "zod": "^4.3.0"
   },
 
+
   "overrides": {},
   "trustedDependencies": [
     "@ast-grep/cli",