oh-my-opencode 3.0.1 → 3.1.1

package/dist/features/background-agent/manager.d.ts

@@ -1,6 +1,6 @@
 import type { PluginInput } from "@opencode-ai/plugin";
 import type { BackgroundTask, LaunchInput, ResumeInput } from "./types";
-import type { BackgroundTaskConfig } from "../../config/schema";
+import type { BackgroundTaskConfig, TmuxConfig } from "../../config/schema";
 interface EventProperties {
     sessionID?: string;
     info?: {
@@ -12,6 +12,12 @@ interface Event {
     type: string;
     properties?: EventProperties;
 }
+export interface SubagentSessionCreatedEvent {
+    sessionID: string;
+    parentID: string;
+    title: string;
+}
+export type OnSubagentSessionCreated = (event: SubagentSessionCreatedEvent) => Promise<void>;
 export declare class BackgroundManager {
     private static cleanupManagers;
     private static cleanupRegistered;
@@ -25,9 +31,14 @@ export declare class BackgroundManager {
     private concurrencyManager;
     private shutdownTriggered;
     private config?;
+    private tmuxEnabled;
+    private onSubagentSessionCreated?;
     private queuesByKey;
     private processingKeys;
-    constructor(ctx: PluginInput, config?: BackgroundTaskConfig);
+    constructor(ctx: PluginInput, config?: BackgroundTaskConfig, options?: {
+        tmuxConfig?: TmuxConfig;
+        onSubagentSessionCreated?: OnSubagentSessionCreated;
+    });
     launch(input: LaunchInput): Promise<BackgroundTask>;
     private processKey;
     private startTask;

package/dist/features/builtin-commands/templates/start-work.d.ts

@@ -1 +1 @@
-export declare const START_WORK_TEMPLATE = "You are starting a Sisyphus work session.\n\n## WHAT TO DO\n\n1. **Find available plans**: Search for Prometheus-generated plan files at `.sisyphus/plans/`\n\n2. **Check for active boulder state**: Read `.sisyphus/boulder.json` if it exists\n\n3. **Decision logic**:\n   - If `.sisyphus/boulder.json` exists AND plan is NOT complete (has unchecked boxes):\n     - **APPEND** current session to session_ids\n     - Continue work on existing plan\n   - If no active plan OR plan is complete:\n     - List available plan files\n     - If ONE plan: auto-select it\n     - If MULTIPLE plans: show list with timestamps, ask user to select\n\n4. **Create/Update boulder.json**:\n   ```json\n   {\n     \"active_plan\": \"/absolute/path/to/plan.md\",\n     \"started_at\": \"ISO_TIMESTAMP\",\n     \"session_ids\": [\"session_id_1\", \"session_id_2\"],\n     \"plan_name\": \"plan-name\"\n   }\n   ```\n\n5. **Read the plan file** and start executing tasks according to Orchestrator Sisyphus workflow\n\n## OUTPUT FORMAT\n\nWhen listing plans for selection:\n```\nAvailable Work Plans\n\nCurrent Time: {ISO timestamp}\nSession ID: {current session id}\n\n1. [plan-name-1.md] - Modified: {date} - Progress: 3/10 tasks\n2. [plan-name-2.md] - Modified: {date} - Progress: 0/5 tasks\n\nWhich plan would you like to work on? (Enter number or plan name)\n```\n\nWhen resuming existing work:\n```\nResuming Work Session\n\nActive Plan: {plan-name}\nProgress: {completed}/{total} tasks\nSessions: {count} (appending current session)\n\nReading plan and continuing from last incomplete task...\n```\n\nWhen auto-selecting single plan:\n```\nStarting Work Session\n\nPlan: {plan-name}\nSession ID: {session_id}\nStarted: {timestamp}\n\nReading plan and beginning execution...\n```\n\n## CRITICAL\n\n- The session_id is injected by the hook - use it directly\n- Always update boulder.json BEFORE starting work\n- Read the FULL plan file before delegating any tasks\n- Follow Orchestrator Sisyphus delegation protocols (7-section format)";
+export declare const START_WORK_TEMPLATE = "You are starting a Sisyphus work session.\n\n## WHAT TO DO\n\n1. **Find available plans**: Search for Prometheus-generated plan files at `.sisyphus/plans/`\n\n2. **Check for active boulder state**: Read `.sisyphus/boulder.json` if it exists\n\n3. **Decision logic**:\n   - If `.sisyphus/boulder.json` exists AND plan is NOT complete (has unchecked boxes):\n     - **APPEND** current session to session_ids\n     - Continue work on existing plan\n   - If no active plan OR plan is complete:\n     - List available plan files\n     - If ONE plan: auto-select it\n     - If MULTIPLE plans: show list with timestamps, ask user to select\n\n4. **Create/Update boulder.json**:\n   ```json\n   {\n     \"active_plan\": \"/absolute/path/to/plan.md\",\n     \"started_at\": \"ISO_TIMESTAMP\",\n     \"session_ids\": [\"session_id_1\", \"session_id_2\"],\n     \"plan_name\": \"plan-name\"\n   }\n   ```\n\n5. **Read the plan file** and start executing tasks according to atlas workflow\n\n## OUTPUT FORMAT\n\nWhen listing plans for selection:\n```\nAvailable Work Plans\n\nCurrent Time: {ISO timestamp}\nSession ID: {current session id}\n\n1. [plan-name-1.md] - Modified: {date} - Progress: 3/10 tasks\n2. [plan-name-2.md] - Modified: {date} - Progress: 0/5 tasks\n\nWhich plan would you like to work on? (Enter number or plan name)\n```\n\nWhen resuming existing work:\n```\nResuming Work Session\n\nActive Plan: {plan-name}\nProgress: {completed}/{total} tasks\nSessions: {count} (appending current session)\n\nReading plan and continuing from last incomplete task...\n```\n\nWhen auto-selecting single plan:\n```\nStarting Work Session\n\nPlan: {plan-name}\nSession ID: {session_id}\nStarted: {timestamp}\n\nReading plan and beginning execution...\n```\n\n## CRITICAL\n\n- The session_id is injected by the hook - use it directly\n- Always update boulder.json BEFORE starting work\n- Read the FULL plan file before delegating any tasks\n- Follow atlas delegation protocols (7-section format)";

package/dist/features/builtin-skills/index.d.ts

@@ -1,2 +1,2 @@
 export * from "./types";
-export { createBuiltinSkills } from "./skills";
+export { createBuiltinSkills, type CreateBuiltinSkillsOptions } from "./skills";

package/dist/features/builtin-skills/skills.d.ts

@@ -1,2 +1,6 @@
 import type { BuiltinSkill } from "./types";
-export declare function createBuiltinSkills(): BuiltinSkill[];
+import type { BrowserAutomationProvider } from "../../config/schema";
+export interface CreateBuiltinSkillsOptions {
+    browserProvider?: BrowserAutomationProvider;
+}
+export declare function createBuiltinSkills(options?: CreateBuiltinSkillsOptions): BuiltinSkill[];

package/dist/features/builtin-skills/skills.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/features/opencode-skill-loader/skill-content.d.ts

@@ -1,10 +1,11 @@
 import type { LoadedSkill } from "./types";
-import type { GitMasterConfig } from "../../config/schema";
+import type { GitMasterConfig, BrowserAutomationProvider } from "../../config/schema";
 export interface SkillResolutionOptions {
     gitMasterConfig?: GitMasterConfig;
+    browserProvider?: BrowserAutomationProvider;
 }
 declare function clearSkillCache(): void;
-declare function getAllSkills(): Promise<LoadedSkill[]>;
+declare function getAllSkills(options?: SkillResolutionOptions): Promise<LoadedSkill[]>;
 declare function extractSkillTemplate(skill: LoadedSkill): Promise<string>;
 export { clearSkillCache, getAllSkills, extractSkillTemplate };
 export declare function injectGitMasterConfig(template: string, config?: GitMasterConfig): string;

package/dist/features/tmux-subagent/action-executor.d.ts

@@ -0,0 +1,22 @@
+import type { TmuxConfig } from "../../config/schema";
+import type { PaneAction, WindowState } from "./types";
+export interface ActionResult {
+    success: boolean;
+    paneId?: string;
+    error?: string;
+}
+export interface ExecuteActionsResult {
+    success: boolean;
+    spawnedPaneId?: string;
+    results: Array<{
+        action: PaneAction;
+        result: ActionResult;
+    }>;
+}
+export interface ExecuteContext {
+    config: TmuxConfig;
+    serverUrl: string;
+    windowState: WindowState;
+}
+export declare function executeAction(action: PaneAction, ctx: ExecuteContext): Promise<ActionResult>;
+export declare function executeActions(actions: PaneAction[], ctx: ExecuteContext): Promise<ExecuteActionsResult>;

package/dist/features/tmux-subagent/decision-engine.d.ts

@@ -0,0 +1,38 @@
+import type { WindowState, PaneAction, SpawnDecision, CapacityConfig, TmuxPaneInfo, SplitDirection } from "./types";
+export interface SessionMapping {
+    sessionId: string;
+    paneId: string;
+    createdAt: Date;
+}
+export interface GridCapacity {
+    cols: number;
+    rows: number;
+    total: number;
+}
+export interface GridSlot {
+    row: number;
+    col: number;
+}
+export interface GridPlan {
+    cols: number;
+    rows: number;
+    slotWidth: number;
+    slotHeight: number;
+}
+export interface SpawnTarget {
+    targetPaneId: string;
+    splitDirection: SplitDirection;
+}
+export declare function getColumnCount(paneCount: number): number;
+export declare function getColumnWidth(agentAreaWidth: number, paneCount: number): number;
+export declare function isSplittableAtCount(agentAreaWidth: number, paneCount: number): boolean;
+export declare function findMinimalEvictions(agentAreaWidth: number, currentCount: number): number | null;
+export declare function canSplitPane(pane: TmuxPaneInfo, direction: SplitDirection): boolean;
+export declare function canSplitPaneAnyDirection(pane: TmuxPaneInfo): boolean;
+export declare function getBestSplitDirection(pane: TmuxPaneInfo): SplitDirection | null;
+export declare function calculateCapacity(windowWidth: number, windowHeight: number): GridCapacity;
+export declare function computeGridPlan(windowWidth: number, windowHeight: number, paneCount: number): GridPlan;
+export declare function mapPaneToSlot(pane: TmuxPaneInfo, plan: GridPlan, mainPaneWidth: number): GridSlot;
+export declare function findSpawnTarget(state: WindowState): SpawnTarget | null;
+export declare function decideSpawnActions(state: WindowState, sessionId: string, description: string, _config: CapacityConfig, sessionMappings: SessionMapping[]): SpawnDecision;
+export declare function decideCloseAction(state: WindowState, sessionId: string, sessionMappings: SessionMapping[]): PaneAction | null;

package/dist/features/tmux-subagent/decision-engine.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/features/tmux-subagent/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./manager";
+export * from "./types";
+export * from "./pane-state-querier";
+export * from "./decision-engine";
+export * from "./action-executor";

package/dist/features/tmux-subagent/manager.d.ts

@@ -0,0 +1,54 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+import type { TmuxConfig } from "../../config/schema";
+interface SessionCreatedEvent {
+    type: string;
+    properties?: {
+        info?: {
+            id?: string;
+            parentID?: string;
+            title?: string;
+        };
+    };
+}
+/**
+ * State-first Tmux Session Manager
+ *
+ * Architecture:
+ * 1. QUERY: Get actual tmux pane state (source of truth)
+ * 2. DECIDE: Pure function determines actions based on state
+ * 3. EXECUTE: Execute actions with verification
+ * 4. UPDATE: Update internal cache only after tmux confirms success
+ *
+ * The internal `sessions` Map is just a cache for sessionId<->paneId mapping.
+ * The REAL source of truth is always queried from tmux.
+ */
+export declare class TmuxSessionManager {
+    private client;
+    private tmuxConfig;
+    private serverUrl;
+    private sourcePaneId;
+    private sessions;
+    private pendingSessions;
+    private pollInterval?;
+    constructor(ctx: PluginInput, tmuxConfig: TmuxConfig);
+    private isEnabled;
+    private getCapacityConfig;
+    private getSessionMappings;
+    private waitForSessionReady;
+    onSessionCreated(event: SessionCreatedEvent): Promise<void>;
+    onSessionDeleted(event: {
+        sessionID: string;
+    }): Promise<void>;
+    private startPolling;
+    private stopPolling;
+    private pollSessions;
+    private closeSessionById;
+    createEventHandler(): (input: {
+        event: {
+            type: string;
+            properties?: unknown;
+        };
+    }) => Promise<void>;
+    cleanup(): Promise<void>;
+}
+export {};

package/dist/features/tmux-subagent/manager.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/features/tmux-subagent/pane-state-querier.d.ts

@@ -0,0 +1,2 @@
+import type { WindowState } from "./types";
+export declare function queryWindowState(sourcePaneId: string): Promise<WindowState | null>;

package/dist/features/tmux-subagent/types.d.ts

@@ -0,0 +1,51 @@
+export interface TrackedSession {
+    sessionId: string;
+    paneId: string;
+    description: string;
+    createdAt: Date;
+    lastSeenAt: Date;
+}
+export declare const MIN_PANE_WIDTH = 52;
+export declare const MIN_PANE_HEIGHT = 11;
+export interface TmuxPaneInfo {
+    paneId: string;
+    width: number;
+    height: number;
+    left: number;
+    top: number;
+    title: string;
+    isActive: boolean;
+}
+export interface WindowState {
+    windowWidth: number;
+    windowHeight: number;
+    mainPane: TmuxPaneInfo | null;
+    agentPanes: TmuxPaneInfo[];
+}
+export type SplitDirection = "-h" | "-v";
+export type PaneAction = {
+    type: "close";
+    paneId: string;
+    sessionId: string;
+} | {
+    type: "spawn";
+    sessionId: string;
+    description: string;
+    targetPaneId: string;
+    splitDirection: SplitDirection;
+} | {
+    type: "replace";
+    paneId: string;
+    oldSessionId: string;
+    newSessionId: string;
+    description: string;
+};
+export interface SpawnDecision {
+    canSpawn: boolean;
+    actions: PaneAction[];
+    reason?: string;
+}
+export interface CapacityConfig {
+    mainPaneMinWidth: number;
+    agentPaneWidth: number;
+}

package/dist/hooks/category-skill-reminder/index.d.ts

@@ -0,0 +1,22 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+interface ToolExecuteInput {
+    tool: string;
+    sessionID: string;
+    callID: string;
+    agent?: string;
+}
+interface ToolExecuteOutput {
+    title: string;
+    output: string;
+    metadata: unknown;
+}
+export declare function createCategorySkillReminderHook(_ctx: PluginInput): {
+    "tool.execute.after": (input: ToolExecuteInput, output: ToolExecuteOutput) => Promise<void>;
+    event: ({ event }: {
+        event: {
+            type: string;
+            properties?: unknown;
+        };
+    }) => Promise<void>;
+};
+export {};

package/dist/hooks/category-skill-reminder/index.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/hooks/index.d.ts

@@ -19,10 +19,12 @@ export { createKeywordDetectorHook } from "./keyword-detector";
 export { createNonInteractiveEnvHook } from "./non-interactive-env";
 export { createInteractiveBashSessionHook } from "./interactive-bash-session";
 export { createThinkingBlockValidatorHook } from "./thinking-block-validator";
+export { createCategorySkillReminderHook } from "./category-skill-reminder";
 export { createRalphLoopHook, type RalphLoopHook } from "./ralph-loop";
 export { createAutoSlashCommandHook } from "./auto-slash-command";
 export { createEditErrorRecoveryHook } from "./edit-error-recovery";
 export { createPrometheusMdOnlyHook } from "./prometheus-md-only";
+export { createSisyphusJuniorNotepadHook } from "./sisyphus-junior-notepad";
 export { createTaskResumeInfoHook } from "./task-resume-info";
 export { createStartWorkHook } from "./start-work";
 export { createAtlasHook } from "./atlas";

package/dist/hooks/sisyphus-junior-notepad/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const HOOK_NAME = "sisyphus-junior-notepad";
+export declare const NOTEPAD_DIRECTIVE = "\n<Work_Context>\n## Notepad Location (for recording learnings)\nNOTEPAD PATH: .sisyphus/notepads/{plan-name}/\n- learnings.md: Record patterns, conventions, successful approaches\n- issues.md: Record problems, blockers, gotchas encountered\n- decisions.md: Record architectural choices and rationales\n- problems.md: Record unresolved issues, technical debt\n\nYou SHOULD append findings to notepad files after completing work.\nIMPORTANT: Always APPEND to notepad files - never overwrite or use Edit tool.\n\n## Plan Location (READ ONLY)\nPLAN PATH: .sisyphus/plans/{plan-name}.md\n\nCRITICAL RULE: NEVER MODIFY THE PLAN FILE\n\nThe plan file (.sisyphus/plans/*.md) is SACRED and READ-ONLY.\n- You may READ the plan to understand tasks\n- You may READ checkbox items to know what to do\n- You MUST NOT edit, modify, or update the plan file\n- You MUST NOT mark checkboxes as complete in the plan\n- Only the Orchestrator manages the plan file\n\nVIOLATION = IMMEDIATE FAILURE. The Orchestrator tracks plan state.\n</Work_Context>\n";

package/dist/hooks/sisyphus-junior-notepad/index.d.ts

@@ -0,0 +1,12 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+export * from "./constants";
+export declare function createSisyphusJuniorNotepadHook(ctx: PluginInput): {
+    "tool.execute.before": (input: {
+        tool: string;
+        sessionID: string;
+        callID: string;
+    }, output: {
+        args: Record<string, unknown>;
+        message?: string;
+    }) => Promise<void>;
+};