opencode-orchestrator 1.3.5 → 1.3.7

package/README.md

@@ -6,7 +6,7 @@
   [![MIT License](https://img.shields.io/badge/license-MIT-red.svg)](LICENSE)
   [![npm](https://img.shields.io/npm/v/opencode-orchestrator.svg)](https://www.npmjs.com/package/opencode-orchestrator)
   <!-- VERSION:START -->
-  **Version:** `1.3.5`
+  **Version:** `1.3.7`
   <!-- VERSION:END -->
 </div>
 
@@ -139,6 +139,8 @@ Useful references:
 3. OpenCode keybinds: https://opencode.ai/docs/keybinds/
 4. Project issues: https://github.com/agnusdei1207/opencode-orchestrator/issues
 
+Contributions are welcome: open an issue or pull request when you find a bug, compatibility gap, or focused improvement.
+
 Config logs:
 
 | Platform | Path |

package/dist/agents/prompts/02_discovery/agents/discovery_commander.d.ts

@@ -1,5 +1 @@
-/**
- * Placeholder for commander in discovery category.
- * Generated to match PROMPT_ARCHITECTURE_PROPOSAL.md
- */
-export declare const DISCOVERY_COMMANDER = "\n# TODO: Implement commander specific prompt\n";
+export declare const DISCOVERY_COMMANDER = "\n# Discovery: Commander\n\n- Confirm repository root, active branch, package manager, and configured OpenCode runtime before delegating.\n- Identify entry points, public exports, generated artifacts, and dynamic plugin hooks that can affect the mission.\n- Turn unknowns into explicit questions or Planner tasks instead of treating assumptions as facts.\n";

package/dist/agents/prompts/02_discovery/agents/discovery_planner.d.ts

@@ -1,5 +1 @@
-/**
- * Placeholder for planner in discovery category.
- * Generated to match PROMPT_ARCHITECTURE_PROPOSAL.md
- */
-export declare const DISCOVERY_PLANNER = "\n# TODO: Implement planner specific prompt\n";
+export declare const DISCOVERY_PLANNER = "\n# Discovery: Planner\n\n- Map inputs, outputs, dependencies, and dynamic registration points for the assigned area.\n- Read the files that define the behavior before proposing a plan.\n- Report confirmed facts separately from risks, gaps, and assumptions that still need verification.\n";

package/dist/agents/prompts/03_planning/agents/planning_commander.d.ts

@@ -1,5 +1 @@
-/**
- * Placeholder for commander in planning category.
- * Generated to match PROMPT_ARCHITECTURE_PROPOSAL.md
- */
-export declare const PLANNING_COMMANDER = "\n# TODO: Implement commander specific prompt\n";
+export declare const PLANNING_COMMANDER = "\n# Planning: Commander\n\n- Convert the mission into ordered work with clear owners, dependencies, and verification gates.\n- Keep parallel work file-disjoint unless the dependency graph proves it is safe.\n- Prefer the smallest plan that satisfies the request and leaves documentation, tests, and release state synchronized.\n";

package/dist/agents/prompts/04_execution/agents/execution_commander.d.ts

@@ -1,5 +1 @@
-/**
- * Placeholder for commander in execution category.
- * Generated to match PROMPT_ARCHITECTURE_PROPOSAL.md
- */
-export declare const EXECUTION_COMMANDER = "\n# TODO: Implement commander specific prompt\n";
+export declare const EXECUTION_COMMANDER = "\n# Execution: Commander\n\n- Delegate scoped implementation tasks only after discovery and planning evidence exists.\n- Monitor each task for progress, conflicts, and missing validation instead of assuming completion.\n- Re-plan when verification exposes a real mismatch between intended and observed behavior.\n";

package/dist/agents/prompts/04_execution/agents/execution_worker.d.ts

@@ -1,5 +1 @@
-/**
- * Placeholder for worker in execution category.
- * Generated to match PROMPT_ARCHITECTURE_PROPOSAL.md
- */
-export declare const EXECUTION_WORKER = "\n# TODO: Implement worker specific prompt\n";
+export declare const EXECUTION_WORKER = "\n# Execution: Worker\n\n- Modify only the files assigned by Commander unless new evidence shows the scope is incomplete.\n- Keep changes focused, preserve existing behavior outside the assignment, and remove obsolete code after migration.\n- Return exact files changed, commands run, observed results, and remaining risks.\n";

package/dist/agents/prompts/04_execution/execution_error_handling.d.ts

@@ -1,5 +1 @@
-/**
- * Placeholder for error handling in execution category.
- * Generated to match PROMPT_ARCHITECTURE_PROPOSAL.md
- */
-export declare const EXECUTION_ERROR_HANDLING = "\n# TODO: Implement error handling specific prompt\n";
+export declare const EXECUTION_ERROR_HANDLING = "\n# Execution Error Handling\n\n- Treat failing commands as evidence, not noise; capture the command, exit state, and relevant output.\n- Classify failures as environmental, dependency, test, type, runtime, or design before retrying.\n- Retry only transient failures with a changed condition; otherwise inspect the affected path and adapt the plan.\n";

package/dist/agents/prompts/05_verification/agents/verification_commander.d.ts

@@ -1,5 +1 @@
-/**
- * Placeholder for commander in verification category.
- * Generated to match PROMPT_ARCHITECTURE_PROPOSAL.md
- */
-export declare const VERIFICATION_COMMANDER = "\n# TODO: Implement commander specific prompt\n";
+export declare const VERIFICATION_COMMANDER = "\n# Verification: Commander\n\n- Require evidence for every completed task: file reads, command output, tests, or direct runtime observation.\n- Ask Reviewer for final integration verification before declaring the mission complete.\n- Keep unresolved failures visible in the mission summary with owner, cause, and next step.\n";

package/dist/agents/prompts/05_verification/verification_build.d.ts

@@ -1,5 +1 @@
-/**
- * Placeholder for build in verification category.
- * Generated to match PROMPT_ARCHITECTURE_PROPOSAL.md
- */
-export declare const VERIFICATION_BUILD = "\n# TODO: Implement build specific prompt\n";
+export declare const VERIFICATION_BUILD = "\n# Build Verification\n\n- Run the repository build or the narrowest build command that covers the changed surface.\n- Treat generated artifacts, package metadata, and exported types as part of the build contract.\n- If a build cannot run in the current environment, state the exact blocker and run the closest lower-level checks.\n";

package/dist/agents/prompts/05_verification/verification_test.d.ts

@@ -1,5 +1 @@
-/**
- * Placeholder for test in verification category.
- * Generated to match PROMPT_ARCHITECTURE_PROPOSAL.md
- */
-export declare const VERIFICATION_TEST = "\n# TODO: Implement test specific prompt\n";
+export declare const VERIFICATION_TEST = "\n# Test Verification\n\n- Run targeted tests for changed behavior before broader suites.\n- Add or update regression tests when the change fixes a bug or guards a public contract.\n- Report pass, fail, or skipped status with exact command evidence.\n";

package/dist/agents/prompts/06_mission/agents/mission_commander.d.ts

@@ -1,5 +1 @@
-/**
- * Placeholder for commander in mission category.
- * Generated to match PROMPT_ARCHITECTURE_PROPOSAL.md
- */
-export declare const MISSION_COMMANDER = "\n# TODO: Implement commander specific prompt\n";
+export declare const MISSION_COMMANDER = "\n# Mission: Commander\n\n- Preserve the user objective, active plan, evidence, and verification state across continuation turns.\n- Continue only while the mission is active, incomplete, and below the configured iteration ceiling.\n- Finish with a concise outcome, validation evidence, known risks, and follow-up state.\n";

package/dist/agents/prompts/06_mission/mission_lifecycle.d.ts

@@ -1,5 +1 @@
-/**
- * Placeholder for lifecycle in mission category.
- * Generated to match PROMPT_ARCHITECTURE_PROPOSAL.md
- */
-export declare const MISSION_LIFECYCLE = "\n# TODO: Implement lifecycle specific prompt\n";
+export declare const MISSION_LIFECYCLE = "\n# Mission Lifecycle\n\n- /task starts a persisted mission with objective, iteration budget, evidence trail, and active session state.\n- Idle continuation may proceed only after a completed assistant turn for the current user message.\n- /cancel, /stop, or an interrupt without current completion evidence deactivates continuation until a new mission starts.\n";

package/dist/agents/prompts/07_agents/commander/commander_mandate.d.ts

@@ -1,5 +1 @@
-/**
- * Placeholder for mandate in agents category.
- * Generated to match PROMPT_ARCHITECTURE_PROPOSAL.md
- */
-export declare const COMMANDER_MANDATE = "\n# TODO: Implement mandate specific prompt\n";
+export declare const COMMANDER_MANDATE = "\n# Commander Mandate\n\n- Own mission interpretation, task decomposition, delegation, progress monitoring, and final completion.\n- Keep subagents context-isolated while preserving shared truth through the mission state and evidence trail.\n- Do not mark completion until implementation, documentation, and verification evidence all agree.\n";

package/dist/agents/prompts/07_agents/planner/planner_mandate.d.ts

@@ -1,5 +1 @@
-/**
- * Placeholder for mandate in agents category.
- * Generated to match PROMPT_ARCHITECTURE_PROPOSAL.md
- */
-export declare const PLANNER_MANDATE = "\n# TODO: Implement mandate specific prompt\n";
+export declare const PLANNER_MANDATE = "\n# Planner Mandate\n\n- Produce evidence-backed plans with affected files, dependency order, risks, and validation commands.\n- Keep TODO state aligned with the latest verified scope.\n- Prefer incremental migration paths that avoid overlapping file ownership.\n";

package/dist/agents/prompts/07_agents/reviewer/reviewer_mandate.d.ts

@@ -1,5 +1 @@
-/**
- * Placeholder for mandate in agents category.
- * Generated to match PROMPT_ARCHITECTURE_PROPOSAL.md
- */
-export declare const REVIEWER_MANDATE = "\n# TODO: Implement mandate specific prompt\n";
+export declare const REVIEWER_MANDATE = "\n# Reviewer Mandate\n\n- Verify claimed completion against source files, tests, build output, and integration paths.\n- Mark TODO items complete only after direct evidence confirms the requested behavior.\n- Report residual risk clearly when the environment prevents full validation.\n";

package/dist/agents/prompts/07_agents/worker/worker_mandate.d.ts

@@ -1,5 +1 @@
-/**
- * Placeholder for mandate in agents category.
- * Generated to match PROMPT_ARCHITECTURE_PROPOSAL.md
- */
-export declare const WORKER_MANDATE = "\n# TODO: Implement mandate specific prompt\n";
+export declare const WORKER_MANDATE = "\n# Worker Mandate\n\n- Implement the assigned scope with minimal, tested edits.\n- Preserve public contracts unless Commander explicitly assigns a behavior change.\n- Return enough evidence for Reviewer to reproduce the validation path.\n";

package/dist/agents/prompts/08_tools/tools_code_editing.d.ts

@@ -1,5 +1 @@
-/**
- * Placeholder for code editing in tools category.
- * Generated to match PROMPT_ARCHITECTURE_PROPOSAL.md
- */
-export declare const TOOLS_CODE_EDITING = "\n# TODO: Implement code editing specific prompt\n";
+export declare const TOOLS_CODE_EDITING = "\n# Code Editing Tools\n\n- Read the surrounding file before editing so imports, exports, formatting, and local conventions stay coherent.\n- Use structured parsers or existing helpers when they are available for the file type.\n- After editing, re-open the changed file and verify the connected import/export and configuration paths.\n";

package/dist/agents/prompts/08_tools/tools_testing.d.ts

@@ -1,5 +1 @@
-/**
- * Placeholder for testing in tools category.
- * Generated to match PROMPT_ARCHITECTURE_PROPOSAL.md
- */
-export declare const TOOLS_TESTING = "\n# TODO: Implement testing specific prompt\n";
+export declare const TOOLS_TESTING = "\n# Testing Tools\n\n- Run the narrowest meaningful test first, then broaden when shared behavior or release artifacts are affected.\n- Prefer deterministic fixtures, isolated temporary directories, and explicit assertions over timing assumptions.\n- Record the exact command and observed result in the mission evidence.\n";

package/dist/core/memory/interfaces.d.ts

@@ -16,7 +16,7 @@ export interface MemoryEntry {
     level: MemoryLevel;
     content: string;
     timestamp: number;
-    metadata?: Record<string, any>;
+    metadata?: Record<string, unknown>;
     importance: number;
 }
 export interface MemorySnapshot {

package/dist/core/memory/memory-manager.d.ts

@@ -12,7 +12,7 @@ export declare class MemoryManager {
     /**
      * Add a memory entry
      */
-    add(level: MemoryLevel, content: string, importance?: number, metadata?: Record<string, any>): string;
+    add(level: MemoryLevel, content: string, importance?: number, metadata?: Record<string, unknown>): string;
     /**
      * Retrieve memory for prompt construction
      */

package/dist/core/orchestrator/session-manager.d.ts

@@ -1,8 +1,24 @@
+interface ManagedSessionState {
+    active: boolean;
+    step: number;
+    timestamp: number;
+    startTime: number;
+    lastStepTime: number;
+    lastCompletedMessageID?: string;
+    lastUserMessageAt?: number;
+    lastAssistantCompletedAt?: number;
+    lastAbortAt?: number;
+    tokens: {
+        totalInput: number;
+        totalOutput: number;
+        estimatedCost: number;
+    };
+}
 /**
  * Ensures a local session object exists in the plugin context map.
  * Now WITH disk-based rehydration for robustness.
  */
-export declare function ensureSessionInitialized(sessions: Map<string, any>, sessionID: string, directory?: string): any;
+export declare function ensureSessionInitialized(sessions: Map<string, unknown>, sessionID: string, directory?: string): ManagedSessionState;
 /**
  * Activates the global mission state for a specific session.
  */
@@ -19,7 +35,7 @@ export declare function deactivateMissionState(sessionID: string): void;
 /**
  * Updates token usage and estimated cost for a session.
  */
-export declare function updateSessionTokens(sessions: Map<string, any>, sessionID: string, inputLen: number, outputLen: number): void;
+export declare function updateSessionTokens(sessions: Map<string, unknown>, sessionID: string, inputLen: number, outputLen: number): void;
 /**
  * Anomaly Management
  */
@@ -29,3 +45,4 @@ export declare function resetAnomaly(sessionID: string): void;
  * Task Tracking
  */
 export declare function updateCurrentTask(sessionID: string, taskID: string): void;
+export {};

package/dist/core/queue/async-utils.d.ts

@@ -17,4 +17,4 @@ export declare function withTimeout<T>(promise: Promise<T>, timeoutMs: number, e
 /**
  * Debounce async function
  */
-export declare function debounceAsync<T extends (...args: any[]) => Promise<any>>(fn: T, delayMs: number): T;
+export declare function debounceAsync<TArgs extends unknown[], TResult>(fn: (...args: TArgs) => Promise<TResult>, delayMs: number): (...args: TArgs) => Promise<TResult>;

package/dist/hooks/compatibility/external-plugin.d.ts

@@ -3,8 +3,8 @@
  *
  * Detects if other major plugins are present and ensures orchestrator plays nicely.
  */
-import type { ChatMessageHook, AssistantDoneHook, HookContext } from "../types.js";
-export declare class ExternalPluginCompatHook implements ChatMessageHook, AssistantDoneHook {
+import type { ChatMessageHook, ChatMessageResult, HookContext } from "../types.js";
+export declare class ExternalPluginCompatHook implements ChatMessageHook {
     name: string;
-    execute(ctx: HookContext, input: any): Promise<any>;
+    execute(ctx: HookContext, input: string): Promise<ChatMessageResult>;
 }

package/dist/hooks/custom/agent-ui.d.ts

@@ -5,16 +5,8 @@
  * - Agent headers (e.g. [P] PLANNER Working...)
  * - Task ID tracking
  */
-import type { PostToolUseHook, HookContext } from "../types.js";
+import type { PostToolUseHook, HookContext, PostToolResult, ToolInput, ToolOutput } from "../types.js";
 export declare class AgentUIHook implements PostToolUseHook {
     name: "AgentUI";
-    execute(ctx: HookContext, tool: string, input: any, output: {
-        title: string;
-        output: string;
-        metadata: any;
-    }): Promise<{
-        output?: undefined;
-    } | {
-        output: string;
-    }>;
+    execute(ctx: HookContext, tool: string, input: ToolInput, output: ToolOutput): Promise<PostToolResult>;
 }

package/dist/hooks/custom/memory-gate.d.ts

@@ -1,15 +1,12 @@
 /**
  * MemoryGate Hook - Intercepts tool usage and turn completion to maintain memory.
  */
-import { PostToolUseHook, AssistantDoneHook, HookContext } from "../types.js";
+import type { PostToolUseHook, AssistantDoneHook, HookContext, HookResult, PostToolResult, ToolInput, ToolOutput } from "../types.js";
 export declare class MemoryGateHook implements PostToolUseHook, AssistantDoneHook {
     name: "MemoryGate";
     private memoryManager;
-    execute(context: HookContext, toolOrText: string, input?: any, output?: {
-        title: string;
-        output: string;
-        metadata: any;
-    }): Promise<any>;
+    execute(context: HookContext, tool: string, input: ToolInput, output: ToolOutput): Promise<PostToolResult>;
+    execute(context: HookContext, finalText: string): Promise<HookResult>;
     /**
      * Post-Tool: Capture tool outputs to TASK memory
      */

package/dist/hooks/custom/metrics.d.ts

@@ -1,14 +1,12 @@
 /**
  * MetricsHook - Collects telemetry during mission execution
  */
-import { PreToolUseHook, PostToolUseHook, AssistantDoneHook, HookContext } from "../types.js";
+import type { PreToolUseHook, PostToolUseHook, AssistantDoneHook, HookContext, HookResult, PostToolResult, PreToolResult, ToolInput, ToolOutput } from "../types.js";
 export declare class MetricsHook implements PreToolUseHook, PostToolUseHook, AssistantDoneHook {
     name: "MetricsTelemetry";
     private startTimes;
     private metrics;
-    execute(context: HookContext, toolOrText: string, input?: any, output?: {
-        title: string;
-        output: string;
-        metadata: any;
-    }): Promise<any>;
+    execute(context: HookContext, tool: string, input: ToolInput): Promise<PreToolResult>;
+    execute(context: HookContext, tool: string, input: ToolInput, output: ToolOutput): Promise<PostToolResult>;
+    execute(context: HookContext, finalText: string): Promise<HookResult>;
 }

package/dist/hooks/custom/resource-control.d.ts

@@ -4,10 +4,11 @@
  * Unifies resource tracking, monitoring, and active memory compaction.
  * Replaces separate ResourceUsageHook and MemoryCompactionHook.
  */
-import type { PostToolUseHook, AssistantDoneHook, HookContext } from "../types.js";
+import type { PostToolUseHook, AssistantDoneHook, HookContext, HookResult, PostToolResult, ToolInput, ToolOutput } from "../types.js";
 export declare class ResourceControlHook implements PostToolUseHook, AssistantDoneHook {
     name: "ResourceControl";
     private lastCompactionTime;
-    execute(ctx: HookContext, toolOrText: string, input?: any, output?: any): Promise<any>;
+    execute(ctx: HookContext, tool: string, input: ToolInput, output: ToolOutput): Promise<PostToolResult>;
+    execute(ctx: HookContext, finalText: string): Promise<HookResult>;
     private checkMemoryHealth;
 }

package/dist/hooks/custom/secret-scanner.d.ts

@@ -4,16 +4,8 @@
  * Scans tool outputs for potential secrets (API Keys, etc) and masks them.
  * This prevents leaking secrets into the context window or logs.
  */
-import type { PostToolUseHook, HookContext } from "../types.js";
+import type { PostToolUseHook, HookContext, PostToolResult, ToolInput, ToolOutput } from "../types.js";
 export declare class SecretScannerHook implements PostToolUseHook {
     name: "SecretScanner";
-    execute(ctx: HookContext, tool: string, input: any, output: {
-        title: string;
-        output: string;
-        metadata: any;
-    }): Promise<{
-        output: string;
-    } | {
-        output?: undefined;
-    }>;
+    execute(ctx: HookContext, tool: string, input: ToolInput, output: ToolOutput): Promise<PostToolResult>;
 }

package/dist/hooks/custom/strict-role-guard.d.ts

@@ -5,17 +5,8 @@
  * - Planner: Cannot write code or run commands.
  * - Reviewer: Cannot write code (only review).
  */
-import type { PreToolUseHook, HookContext } from "../types.js";
+import type { PreToolUseHook, HookContext, PreToolResult, ToolInput } from "../types.js";
 export declare class StrictRoleGuardHook implements PreToolUseHook {
     name: "StrictRoleGuard";
-    execute(ctx: HookContext, tool: string, args: any): Promise<{
-        action: "block";
-        reason: "Fork bomb detected.";
-    } | {
-        action: "block";
-        reason: "Root deletion blocked.";
-    } | {
-        action: "allow";
-        reason?: undefined;
-    }>;
+    execute(ctx: HookContext, tool: string, args: ToolInput): Promise<PreToolResult>;
 }

package/dist/hooks/custom/user-activity.d.ts

@@ -4,8 +4,8 @@
  * Tracks user interaction (chat messages) to pause auto-continuation/loops
  * and update activity timestamps.
  */
-import type { ChatMessageHook, HookContext } from "../types.js";
+import type { ChatMessageHook, ChatMessageResult, HookContext } from "../types.js";
 export declare class UserActivityHook implements ChatMessageHook {
     name: "UserActivity";
-    execute(ctx: HookContext, message: string): Promise<any>;
+    execute(ctx: HookContext, message: string): Promise<ChatMessageResult>;
 }

package/dist/hooks/features/mission-loop.d.ts

@@ -6,10 +6,11 @@
  * - Auto-continuation injection (Loop)
  * - User cancellation detection
  */
-import type { AssistantDoneHook, ChatMessageHook, HookContext } from "../types.js";
+import type { AssistantDoneHook, ChatMessageHook, ChatMessageResult, HookContext, HookResult } from "../types.js";
 export declare class MissionControlHook implements AssistantDoneHook, ChatMessageHook {
     name: "MissionLoop";
-    execute(ctx: HookContext, text: string): Promise<any>;
+    execute(ctx: HookContext, text: string): Promise<ChatMessageResult>;
+    execute(ctx: HookContext, text: string): Promise<HookResult>;
     private handleChatCommand;
     private cancelMission;
     private handleMissionProgress;

package/dist/hooks/features/sanity-check.d.ts

@@ -2,14 +2,11 @@
  * Sanity Check Hook
  * Implements output anomaly detection.
  */
-import type { PostToolUseHook, AssistantDoneHook, HookContext } from "../types.js";
+import type { PostToolUseHook, AssistantDoneHook, HookContext, HookResult, PostToolResult, ToolInput, ToolOutput } from "../types.js";
 export declare class SanityCheckHook implements PostToolUseHook, AssistantDoneHook {
     name: "SanityCheck";
-    execute(ctx: HookContext, toolOrText: string, input?: any, output?: {
-        title: string;
-        output: string;
-        metadata: any;
-    }): Promise<any>;
+    execute(ctx: HookContext, tool: string, input: ToolInput, output: ToolOutput): Promise<PostToolResult>;
+    execute(ctx: HookContext, finalText: string): Promise<HookResult>;
     private checkToolOutput;
     private checkFinalText;
 }

package/dist/hooks/registry.d.ts

@@ -2,8 +2,7 @@
  * Hook Registry
  * Manages registration and execution of hooks with priority and dependency support.
  */
-import type { PreToolUseHook, PostToolUseHook, ChatMessageHook, AssistantDoneHook, HookContext, HookResult, HookMetadata } from "./types.js";
-import { HOOK_ACTIONS } from "./constants.js";
+import type { PreToolUseHook, PostToolUseHook, ChatMessageHook, AssistantDoneHook, HookContext, HookResult, HookMetadata, ChatMessageResult, PreToolResult, ToolInput, ToolOutput } from "./types.js";
 export declare class HookRegistry {
     private static instance;
     private preToolHooks;
@@ -19,19 +18,8 @@ export declare class HookRegistry {
     private prepareMetadata;
     private sortHooks;
     private topologicalSort;
-    executePreTool(ctx: HookContext, tool: string, args: Record<string, unknown>): Promise<{
-        action: typeof HOOK_ACTIONS.ALLOW | typeof HOOK_ACTIONS.BLOCK | typeof HOOK_ACTIONS.MODIFY;
-        modifiedArgs?: Record<string, unknown>;
-        reason?: string;
-    }>;
-    executePostTool(ctx: HookContext, tool: string, input: Record<string, unknown>, output: {
-        title: string;
-        output: string;
-        metadata: Record<string, unknown>;
-    }): Promise<void>;
-    executeChat(ctx: HookContext, message: string): Promise<{
-        action: typeof HOOK_ACTIONS.PROCESS | typeof HOOK_ACTIONS.INTERCEPT;
-        modifiedMessage?: string;
-    }>;
+    executePreTool(ctx: HookContext, tool: string, args: ToolInput): Promise<PreToolResult>;
+    executePostTool(ctx: HookContext, tool: string, input: ToolInput, output: ToolOutput): Promise<void>;
+    executeChat(ctx: HookContext, message: string): Promise<ChatMessageResult>;
     executeDone(ctx: HookContext, finalText: string): Promise<HookResult>;
 }

package/dist/hooks/types.d.ts

@@ -25,17 +25,31 @@ export type HookResult = {
     action: typeof HOOK_ACTIONS.INJECT;
     prompts: string[];
 };
+export type ToolInput = Record<string, unknown>;
+export interface ToolOutput {
+    title: string;
+    output: string;
+    metadata: Record<string, unknown>;
+}
+export type PreToolResult = {
+    action: typeof HOOK_ACTIONS.ALLOW | typeof HOOK_ACTIONS.BLOCK | typeof HOOK_ACTIONS.MODIFY;
+    modifiedArgs?: ToolInput;
+    reason?: string;
+};
+export type PostToolResult = {
+    output?: string;
+};
+export type ChatMessageResult = {
+    action: typeof HOOK_ACTIONS.PROCESS | typeof HOOK_ACTIONS.INTERCEPT;
+    modifiedMessage?: string;
+};
 /**
  * Pre-Tool Execution Hook
  * Runs before a tool is executed. Can block execution or modify arguments.
  */
 export interface PreToolUseHook {
     name: string;
-    execute(context: HookContext, tool: string, args: Record<string, unknown>): Promise<{
-        action: typeof HOOK_ACTIONS.ALLOW | typeof HOOK_ACTIONS.BLOCK | typeof HOOK_ACTIONS.MODIFY;
-        modifiedArgs?: Record<string, unknown>;
-        reason?: string;
-    }>;
+    execute(context: HookContext, tool: string, args: ToolInput): Promise<PreToolResult>;
 }
 /**
  * Post-Tool Execution Hook
@@ -43,13 +57,7 @@ export interface PreToolUseHook {
  */
 export interface PostToolUseHook {
     name: string;
-    execute(context: HookContext, tool: string, input: Record<string, unknown>, output: {
-        title: string;
-        output: string;
-        metadata: Record<string, unknown>;
-    }): Promise<{
-        output?: string;
-    }>;
+    execute(context: HookContext, tool: string, input: ToolInput, output: ToolOutput): Promise<PostToolResult>;
 }
 /**
  * Chat Message Hook
@@ -57,10 +65,7 @@ export interface PostToolUseHook {
  */
 export interface ChatMessageHook {
     name: string;
-    execute(context: HookContext, message: string): Promise<{
-        action: typeof HOOK_ACTIONS.PROCESS | typeof HOOK_ACTIONS.INTERCEPT;
-        modifiedMessage?: string;
-    }>;
+    execute(context: HookContext, message: string): Promise<ChatMessageResult>;
 }
 /**
  * Assistant Done Hook

package/dist/index.js

@@ -1037,7 +1037,7 @@ function show(options) {
           } catch {
           }
         }, timeoutMs);
-        const promise3 = client.tui.showToast?.({
+        const payload = {
           body: {
             title: toast.title,
             message: toast.message,
@@ -1045,15 +1045,11 @@ function show(options) {
             duration: toast.duration
           },
           signal: ac.signal
+        };
+        Promise.resolve(client.tui.showToast(payload)).finally(() => {
+          clearTimeout(timer);
+        }).catch(() => {
         });
-        if (promise3 && typeof promise3.then === "function") {
-          Promise.resolve(promise3).finally(() => {
-            if (timer) {
-              clearTimeout(timer);
-            }
-          }).catch(() => {
-          });
-        }
       } catch {
       }
     }
@@ -36891,30 +36887,26 @@ function normalizeContinuationContext(state2, input) {
 // src/core/orchestrator/session-manager.ts
 function ensureSessionInitialized(sessions, sessionID, directory) {
   if (!sessions.has(sessionID)) {
-    const now = Date.now();
-    const newSession = {
-      active: true,
-      step: 0,
-      timestamp: now,
-      startTime: now,
-      lastStepTime: now,
-      lastCompletedMessageID: void 0,
-      lastUserMessageAt: void 0,
-      lastAssistantCompletedAt: void 0,
-      lastAbortAt: void 0,
-      tokens: { totalInput: 0, totalOutput: 0, estimatedCost: 0 }
-    };
+    const newSession2 = createManagedSession();
     if (directory) {
       const diskState = readLoopState(directory);
       if (diskState && diskState.sessionID === sessionID) {
-        newSession.step = diskState.iteration;
-        newSession.startTime = new Date(diskState.startedAt).getTime();
+        newSession2.step = diskState.iteration;
+        newSession2.startTime = new Date(diskState.startedAt).getTime();
         log(`[SessionManager] Rehydrated session from disk: ${sessionID}`);
       }
     }
-    sessions.set(sessionID, newSession);
+    sessions.set(sessionID, newSession2);
+    return newSession2;
   }
-  return sessions.get(sessionID);
+  const session = sessions.get(sessionID);
+  if (isManagedSessionState(session)) return session;
+  if (isRecord(session)) {
+    return normalizeManagedSession(session);
+  }
+  const newSession = createManagedSession();
+  sessions.set(sessionID, newSession);
+  return newSession;
 }
 function ensureGlobalState(sessionID, directory) {
   let stateSession = state.sessions.get(sessionID);
@@ -36978,6 +36970,43 @@ function updateSessionTokens(sessions, sessionID, inputLen, outputLen) {
   const cost = session.tokens.totalInput / 1e3 * COST_PER_1K_INPUT + session.tokens.totalOutput / 1e3 * COST_PER_1K_OUTPUT;
   session.tokens.estimatedCost = Number(cost.toFixed(4));
 }
+function createManagedSession() {
+  const now = Date.now();
+  return {
+    active: true,
+    step: 0,
+    timestamp: now,
+    startTime: now,
+    lastStepTime: now,
+    lastCompletedMessageID: void 0,
+    lastUserMessageAt: void 0,
+    lastAssistantCompletedAt: void 0,
+    lastAbortAt: void 0,
+    tokens: { totalInput: 0, totalOutput: 0, estimatedCost: 0 }
+  };
+}
+function normalizeManagedSession(session) {
+  const now = Date.now();
+  if (typeof session.active !== "boolean") session.active = true;
+  if (typeof session.step !== "number") session.step = 0;
+  if (typeof session.timestamp !== "number") session.timestamp = now;
+  if (typeof session.startTime !== "number") session.startTime = now;
+  if (typeof session.lastStepTime !== "number") session.lastStepTime = now;
+  if (!isTokenUsage(session.tokens)) {
+    session.tokens = { totalInput: 0, totalOutput: 0, estimatedCost: 0 };
+  }
+  return session;
+}
+function isManagedSessionState(value) {
+  return isRecord(value) && typeof value.active === "boolean" && typeof value.step === "number" && typeof value.timestamp === "number" && typeof value.startTime === "number" && typeof value.lastStepTime === "number" && isTokenUsage(value.tokens);
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isTokenUsage(value) {
+  if (!isRecord(value)) return false;
+  return typeof value.totalInput === "number" && typeof value.totalOutput === "number" && typeof value.estimatedCost === "number";
+}
 function recordAnomaly(sessionID) {
   const session = ensureGlobalState(sessionID);
   session.anomalyCount = (session.anomalyCount || 0) + 1;
@@ -37000,6 +37029,7 @@ var SanityCheckHook = class {
       if (toolOrText === TOOL_NAMES.CALL_AGENT) {
         return this.checkToolOutput(ctx, input, output);
       }
+      return {};
     } else {
       return this.checkFinalText(ctx, toolOrText);
     }
@@ -37008,7 +37038,7 @@ var SanityCheckHook = class {
     const sanityResult = checkOutputSanity(toolOutput.output);
     if (!sanityResult.isHealthy) {
       const count = recordAnomaly(ctx.sessionID);
-      const agentName = toolInput?.agent || "unknown";
+      const agentName = typeof toolInput?.agent === "string" ? toolInput.agent : "unknown";
       const recoveryText = count >= 2 ? ESCALATION_PROMPT : RECOVERY_PROMPT;
       const errorMsg = MISSION_MESSAGES.ANOMALY_DETECTED_TITLE(agentName.toUpperCase()) + "\n\n" + MISSION_MESSAGES.ANOMALY_DETECTED_BODY(sanityResult.reason || "Unknown anomaly", count, recoveryText);
       return { output: errorMsg };
@@ -37756,7 +37786,7 @@ var MissionControlHook = class {
     deactivateMissionState(sessionID);
     clearSession2(sessionID);
     const session = sessions.get(sessionID);
-    if (isRecord(session)) {
+    if (isRecord2(session)) {
       session.active = false;
     }
   }
@@ -37872,11 +37902,11 @@ var MissionControlHook = class {
     }
   }
 };
-function isRecord(value) {
+function isRecord2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function isMissionSessionState(value) {
-  return isRecord(value) && typeof value.step === "number" && typeof value.startTime === "number" && typeof value.lastStepTime === "number";
+  return isRecord2(value) && typeof value.step === "number" && typeof value.startTime === "number" && typeof value.lastStepTime === "number";
 }
 
 // src/hooks/custom/strict-role-guard.ts
@@ -37909,7 +37939,7 @@ var StrictRoleGuardHook = class {
   name = HOOK_NAMES2.STRICT_ROLE_GUARD;
   async execute(ctx, tool2, args) {
     if (tool2 === TOOL_NAMES.RUN_COMMAND || tool2 === TOOL_NAMES.RUN_BACKGROUND) {
-      const cmd = args?.command;
+      const cmd = typeof args.command === "string" ? args.command : void 0;
       if (cmd) {
         if (cmd.includes(SECURITY_PATTERNS.FORK_BOMB)) {
           return { action: HOOK_ACTIONS.BLOCK, reason: MISSION_MESSAGES.BLOCK_REASON_FORK_BOMB };
@@ -37948,14 +37978,15 @@ var AgentUIHook = class {
   name = HOOK_NAMES2.AGENT_UI;
   async execute(ctx, tool2, input, output) {
     if (tool2 !== TOOL_NAMES.CALL_AGENT) return {};
-    if (input?.task) {
-      const taskIdMatch = input.task.match(UI_PATTERNS.TASK_ID);
+    const task = typeof input.task === "string" ? input.task : void 0;
+    if (task) {
+      const taskIdMatch = task.match(UI_PATTERNS.TASK_ID);
       if (taskIdMatch) {
         updateCurrentTask(ctx.sessionID, taskIdMatch[1].toUpperCase());
       }
     }
-    if (input?.agent) {
-      const agentName = input.agent;
+    const agentName = typeof input.agent === "string" ? input.agent : void 0;
+    if (agentName) {
       const indicator = agentName[0].toUpperCase();
       const header = MISSION_MESSAGES.AGENT_HEADER_FORMAT(indicator, agentName.toUpperCase());
       if (!output.output.startsWith("[" + indicator + "]")) {
@@ -38072,25 +38103,21 @@ var ResourceControlHook = class {
   name = HOOK_NAMES2.RESOURCE_CONTROL;
   lastCompactionTime = /* @__PURE__ */ new Map();
   async execute(ctx, toolOrText, input, output) {
-    let inputLen = 0;
-    let outputLen = 0;
-    if (input) {
-      const inputStr = typeof input === "string" ? input : JSON.stringify(input);
-      inputLen = inputStr.length;
-    }
-    if (output) {
-      const outputStr = typeof output === "string" ? output : JSON.stringify(output);
-      outputLen = outputStr.length;
-    }
-    if (arguments.length === 2 && typeof toolOrText === "string") {
+    const isAssistantDone = input === void 0 && output === void 0;
+    const inputLen = isAssistantDone ? 0 : getSerializedLength(input);
+    let outputLen = getSerializedLength(output);
+    if (isAssistantDone) {
       outputLen = toolOrText.length;
     }
     updateSessionTokens(ctx.sessions, ctx.sessionID, inputLen, outputLen);
+    if (!isAssistantDone) {
+      return {};
+    }
     const session = ctx.sessions.get(ctx.sessionID);
     return this.checkMemoryHealth(ctx, session);
   }
   async checkMemoryHealth(ctx, session) {
-    if (!session?.tokens) return { action: HOOK_ACTIONS.CONTINUE };
+    if (!hasTokenUsage(session)) return { action: HOOK_ACTIONS.CONTINUE };
     const totalUsed = session.tokens.totalInput + session.tokens.totalOutput;
     const maxTokens = CONTEXT_MONITOR_CONFIG.DEFAULT_MAX_TOKENS;
     const usage = calculateUsage(totalUsed, maxTokens);
@@ -38112,6 +38139,22 @@ var ResourceControlHook = class {
     };
   }
 };
+function getSerializedLength(value) {
+  if (value === void 0 || value === null) return 0;
+  if (typeof value === "string") return value.length;
+  try {
+    return JSON.stringify(value)?.length ?? 0;
+  } catch {
+    return String(value).length;
+  }
+}
+function hasTokenUsage(session) {
+  if (typeof session !== "object" || session === null || Array.isArray(session)) return false;
+  const tokens = session.tokens;
+  if (typeof tokens !== "object" || tokens === null || Array.isArray(tokens)) return false;
+  const candidate = tokens;
+  return typeof candidate.totalInput === "number" && typeof candidate.totalOutput === "number";
+}
 
 // src/core/loop/todo-continuation.ts
 init_shared();
@@ -41183,11 +41226,11 @@ var CONCURRENCY_KEYS = [
   "providerConcurrency",
   "modelConcurrency"
 ];
-function isRecord2(value) {
+function isRecord3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function readLimitMap(value) {
-  if (!isRecord2(value)) return void 0;
+  if (!isRecord3(value)) return void 0;
   const result = {};
   for (const [key, limit] of Object.entries(value)) {
     if (typeof limit === "number" && Number.isFinite(limit) && limit >= 0) {
@@ -41197,7 +41240,7 @@ function readLimitMap(value) {
   return Object.keys(result).length > 0 ? result : void 0;
 }
 function extractConcurrencyConfig(source) {
-  if (!isRecord2(source)) return {};
+  if (!isRecord3(source)) return {};
   const config3 = {};
   if (typeof source.defaultConcurrency === "number" && source.defaultConcurrency >= 0) {
     config3.defaultConcurrency = source.defaultConcurrency;
@@ -41211,7 +41254,7 @@ function extractConcurrencyConfig(source) {
   return config3;
 }
 function hasConcurrencyConfig(source) {
-  if (!isRecord2(source)) return false;
+  if (!isRecord3(source)) return false;
   return CONCURRENCY_KEYS.some((key) => source[key] !== void 0);
 }
 function mergeConcurrencyConfig(base, override) {
@@ -41235,14 +41278,14 @@ function mergeConcurrencyConfig(base, override) {
 
 // src/core/config/plugin-options.ts
 function parseOrchestratorPluginOptions(options) {
-  const source = isRecord3(options) ? options : {};
+  const source = isRecord4(options) ? options : {};
   return {
     concurrency: extractConcurrencyConfig(source),
     missionLoop: readMissionLoopOptions(source.missionLoop)
   };
 }
 function readMissionLoopOptions(value) {
-  if (!isRecord3(value)) return DEFAULT_MISSION_RUNTIME_OPTIONS;
+  if (!isRecord4(value)) return DEFAULT_MISSION_RUNTIME_OPTIONS;
   return {
     ledger: readBoolean(value.ledger, DEFAULT_MISSION_RUNTIME_OPTIONS.ledger),
     markdownMemory: readBoolean(value.markdownMemory, DEFAULT_MISSION_RUNTIME_OPTIONS.markdownMemory),
@@ -41258,7 +41301,7 @@ function readBoolean(value, fallback) {
 function readPositiveInteger(value, fallback) {
   return typeof value === "number" && Number.isInteger(value) && value > 0 ? value : fallback;
 }
-function isRecord3(value) {
+function isRecord4(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
@@ -41380,7 +41423,7 @@ This plugin runs in "Claude Code Compatibility Mode".
 }
 
 // src/plugin-handlers/config-handler.ts
-function isRecord4(value) {
+function isRecord5(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function isPermissionAction(value) {
@@ -41390,10 +41433,10 @@ function mergePermission(globalPermission, agentPermission) {
   if (agentPermission === void 0) {
     return globalPermission;
   }
-  if (isRecord4(globalPermission) && isRecord4(agentPermission)) {
+  if (isRecord5(globalPermission) && isRecord5(agentPermission)) {
     return { ...globalPermission, ...agentPermission };
   }
-  if (isPermissionAction(globalPermission) && isRecord4(agentPermission)) {
+  if (isPermissionAction(globalPermission) && isRecord5(agentPermission)) {
     return { "*": globalPermission, ...agentPermission };
   }
   return agentPermission;
@@ -43081,6 +43124,20 @@ Use \`delegate_task\` with background=true for parallel work.
 // src/index.ts
 var require2 = createRequire(import.meta.url);
 var { version: PLUGIN_VERSION } = require2("../package.json");
+function isRecord6(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function readStringField(source, key) {
+  const value = source[key];
+  return typeof value === "string" ? value : void 0;
+}
+function readCreatedSessionID(properties) {
+  if (!isRecord6(properties)) return void 0;
+  const directID = readStringField(properties, "sessionID") ?? readStringField(properties, "id");
+  if (directID) return directID;
+  const info = properties.info;
+  return isRecord6(info) ? readStringField(info, "sessionID") : void 0;
+}
 var OrchestratorPlugin = async (input, options) => {
   const { directory, client } = input;
   const orchestratorOptions = parseOrchestratorPluginOptions(options);
@@ -43140,8 +43197,8 @@ var OrchestratorPlugin = async (input, options) => {
     event: async (payload) => {
       const result = await createEventHandler(handlerContext)(payload);
       const { event } = payload;
-      if (event.type === SESSION_EVENTS.CREATED && event.properties) {
-        const sessionID = event.properties.sessionID || event.properties.id || event.properties.info?.sessionID;
+      if (event.type === SESSION_EVENTS.CREATED) {
+        const sessionID = readCreatedSessionID(event.properties);
         if (sessionID) {
           todoSync.registerSession(sessionID);
         }

package/dist/tools/lsp/diagnostics-cache.d.ts

@@ -1,13 +1,13 @@
 export interface CachedDiagnostics {
-    diagnostics: any;
+    diagnostics: string;
     timestamp: number;
     filesMtime: number;
 }
 export declare class DiagnosticsCache {
     private cache;
     private defaultTTL;
-    get(directory: string, file?: string): Promise<any | null>;
-    set(directory: string, file: string | undefined, diagnostics: any): Promise<void>;
+    get(directory: string, file?: string): Promise<string | null>;
+    set(directory: string, file: string | undefined, diagnostics: string): Promise<void>;
     private getCacheKey;
     private getFilesMtime;
 }

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "opencode-orchestrator",
   "displayName": "OpenCode Orchestrator",
-  "description": "Distributed Cognitive Architecture for OpenCode. Turns simple prompts into specialized multi-agent workflows (Planner, Coder, Reviewer).",
-  "version": "1.3.5",
+  "description": "Multi-agent mission control for OpenCode with Commander, Planner, Worker, and Reviewer workflows.",
+  "version": "1.3.7",
   "author": "agnusdei1207",
   "license": "MIT",
   "repository": {