opencode-orchestrator 1.2.34 → 1.2.35

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

@@ -0,0 +1,15 @@
+/**
+ * Sanity Check Hook
+ * Implements output anomaly detection.
+ */
+import type { PostToolUseHook, AssistantDoneHook, HookContext } 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>;
+    private checkToolOutput;
+    private checkFinalText;
+}

package/dist/hooks/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Initialize Hooks
+ * Registers all default hooks with explicit priority and dependency management.
+ */
+export declare function initializeHooks(): void;

package/dist/hooks/registry.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 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";
+export declare class HookRegistry {
+    private static instance;
+    private preToolHooks;
+    private postToolHooks;
+    private chatHooks;
+    private doneHooks;
+    private constructor();
+    static getInstance(): HookRegistry;
+    registerPreTool(hook: PreToolUseHook, metadata?: Partial<HookMetadata>): void;
+    registerPostTool(hook: PostToolUseHook, metadata?: Partial<HookMetadata>): void;
+    registerChat(hook: ChatMessageHook, metadata?: Partial<HookMetadata>): void;
+    registerDone(hook: AssistantDoneHook, metadata?: Partial<HookMetadata>): void;
+    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;
+    }>;
+    executeDone(ctx: HookContext, finalText: string): Promise<HookResult>;
+}

package/dist/hooks/types.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Hook System Types
+ * Defines the contract for all hooks in the system.
+ */
+import { HOOK_ACTIONS } from "./constants.js";
+export interface HookContext {
+    sessionID: string;
+    agent?: string;
+    directory: string;
+    sessions: Map<string, unknown>;
+}
+export interface HookMetadata {
+    name: string;
+    priority: number;
+    phase?: "early" | "normal" | "late";
+    dependencies?: string[];
+    errorHandling?: "continue" | "stop" | "retry";
+}
+export type HookResult = {
+    action: typeof HOOK_ACTIONS.CONTINUE;
+} | {
+    action: typeof HOOK_ACTIONS.STOP;
+    reason?: string;
+} | {
+    action: typeof HOOK_ACTIONS.INJECT;
+    prompts: 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;
+    }>;
+}
+/**
+ * Post-Tool Execution Hook
+ * Runs after a tool is executed. Can analyze output or trigger side effects.
+ */
+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;
+    }>;
+}
+/**
+ * Chat Message Hook
+ * Runs when a user sends a message. Can intercept commands.
+ */
+export interface ChatMessageHook {
+    name: string;
+    execute(context: HookContext, message: string): Promise<{
+        action: typeof HOOK_ACTIONS.PROCESS | typeof HOOK_ACTIONS.INTERCEPT;
+        modifiedMessage?: string;
+    }>;
+}
+/**
+ * Assistant Done Hook
+ * Runs when the assistant finishes a turn. Can inject continuation prompts.
+ */
+export interface AssistantDoneHook {
+    name: string;
+    execute(context: HookContext, finalText: string): Promise<HookResult>;
+}

package/dist/index.d.ts

@@ -1,3 +1,11 @@
+/**
+ * OpenCode Orchestrator Plugin
+ *
+ * This is the main entry point for the 4-Agent consolidated architecture.
+ * Handlers are modularized in src/plugin-handlers/ for maintainability.
+ *
+ * The agents are: Commander, Planner, Worker, Reviewer
+ */
 import type { Plugin } from "@opencode-ai/plugin";
 declare const OrchestratorPlugin: Plugin;
 export default OrchestratorPlugin;