oh-my-opencode-slim 2.0.1 → 2.0.3

package/dist/config/constants.d.ts

@@ -1,26 +1,20 @@
 export declare const AGENT_ALIASES: Record<string, string>;
 export declare const SUBAGENT_NAMES: readonly ["explorer", "librarian", "oracle", "designer", "fixer", "observer", "council", "councillor"];
-export declare const ORCHESTRATOR_NAME: "orchestrator";
 export declare const ALL_AGENT_NAMES: readonly ["orchestrator", "explorer", "librarian", "oracle", "designer", "fixer", "observer", "council", "councillor"];
 export type AgentName = (typeof ALL_AGENT_NAMES)[number];
-export declare const ORCHESTRATABLE_AGENTS: readonly ["explorer", "librarian", "oracle", "designer", "fixer", "observer", "council"];
 /** Agents that cannot be disabled even if listed in disabled_agents config. */
 export declare const PROTECTED_AGENTS: Set<string>;
 /**
  * Get the list of orchestratable agents, excluding any disabled agents.
  * This is used for delegation validation at runtime.
  */
-export declare function getOrchestratableAgents(disabledAgents?: Set<string>): string[];
-export declare const SUBAGENT_DELEGATION_RULES: Record<AgentName, readonly string[]>;
 export declare const DEFAULT_MODELS: Record<AgentName, string | undefined>;
 export declare const POLL_INTERVAL_MS = 500;
-export declare const POLL_INTERVAL_SLOW_MS = 1000;
 export declare const POLL_INTERVAL_BACKGROUND_MS = 2000;
-export declare const DEFAULT_TIMEOUT_MS: number;
 export declare const MAX_POLL_TIME_MS: number;
-export declare const FALLBACK_FAILOVER_TIMEOUT_MS = 15000;
 export declare const DEFAULT_MAX_SUBAGENT_DEPTH = 3;
 export declare const PHASE_REMINDER_TEXT = "!IMPORTANT! Scheduler workflow: plan lanes/dependencies \u2192 dispatch background specialists \u2192 track task IDs \u2192 wait for hook-driven completion \u2192 reconcile terminal results \u2192 verify. Do not poll running jobs, consume running-job output, or advance dependent work. !END!";
+export declare const PHASE_REMINDER = "<internal_reminder>!IMPORTANT! Scheduler workflow: plan lanes/dependencies \u2192 dispatch background specialists \u2192 track task IDs \u2192 wait for hook-driven completion \u2192 reconcile terminal results \u2192 verify. Do not poll running jobs, consume running-job output, or advance dependent work. !END!</internal_reminder>";
 export declare const WRITABLE_FILE_OPERATIONS_RULES = "**File Operations Rules**:\n- Prefer dedicated file tools for normal code work: glob/grep/ast_grep_search for discovery, read for file contents, and edit/write/apply_patch for targeted source changes.\n- Use bash for execution and automation: git, package managers, tests, builds, scripts, diagnostics, and shell-native filesystem operations.\n- Shell is acceptable for bulk or mechanical filesystem changes when it is clearer or safer than many individual edits (for example: truncate generated logs, remove build artifacts, batch rename/move files), especially when the user explicitly asks for that shell operation.\n- Before destructive or broad shell operations, verify the target set and quote paths. Prefer a dry-run/listing first when practical.\n- Do not use cat/head/tail/sed/awk only to read code into context; use read/grep unless a shell pipeline is genuinely the better diagnostic.";
 export declare const READONLY_FILE_OPERATIONS_RULES = "**File Operations Rules**:\n- READ-ONLY: inspect and report; do not modify files.\n- Prefer dedicated file tools for codebase inspection: glob/grep/ast_grep_search for discovery and read for file contents.\n- Bash is allowed for non-mutating diagnostics and shell-native inspection when it is the clearest tool, but not for modifying files.\n- Do not use cat/head/tail/sed/awk only to read code into context; use read/grep unless a shell pipeline is genuinely the better diagnostic.";
 export declare const NO_SHELL_READONLY_FILE_OPERATIONS_RULES = "**File Operations Rules**:\n- READ-ONLY: inspect and report; do not modify files.\n- Use glob/grep/ast_grep_search for discovery and read for file contents.\n- Do not use bash or shell commands.";

package/dist/config/council-schema.d.ts

@@ -69,8 +69,6 @@ export declare const CouncilConfigSchema: z.ZodPipe<z.ZodObject<{
     }>>;
     councillor_retries: z.ZodDefault<z.ZodNumber>;
     master: z.ZodOptional<z.ZodUnknown>;
-    master_timeout: z.ZodOptional<z.ZodUnknown>;
-    master_fallback: z.ZodOptional<z.ZodUnknown>;
 }, z.core.$strip>, z.ZodTransform<{
     presets: Record<string, Record<string, {
         model: string;
@@ -94,22 +92,9 @@ export declare const CouncilConfigSchema: z.ZodPipe<z.ZodObject<{
     councillor_execution_mode: "parallel" | "serial";
     councillor_retries: number;
     master?: unknown;
-    master_timeout?: unknown;
-    master_fallback?: unknown;
 }>>;
 export type CouncilConfig = z.infer<typeof CouncilConfigSchema>;
 export type CouncillorExecutionMode = z.infer<typeof CouncillorExecutionModeSchema>;
-/**
- * A sensible default council configuration that users can copy into their
- * opencode.jsonc. Provides a 3-councillor preset using common models.
- *
- * Users should replace models with ones they have access to.
- *
- * ```jsonc
- * "council": DEFAULT_COUNCIL_CONFIG
- * ```
- */
-export declare const DEFAULT_COUNCIL_CONFIG: z.input<typeof CouncilConfigSchema>;
 /**
  * Result of a council session.
  */

package/dist/config/index.d.ts

@@ -2,4 +2,4 @@ export * from './constants';
 export * from './council-schema';
 export { deepMerge, loadAgentPrompt, loadPluginConfig, } from './loader';
 export * from './schema';
-export { getAgentOverride, getCustomAgentNames } from './utils';
+export { getAcpAgentNames, getAgentOverride, getCustomAgentNames, } from './utils';

package/dist/config/runtime-preset.d.ts

@@ -9,4 +9,3 @@ export declare function setActiveRuntimePreset(name: string | null): void;
 export declare function getActiveRuntimePreset(): string | null;
 export declare function getPreviousRuntimePreset(): string | null;
 export declare function setActiveRuntimePresetWithPrevious(name: string | null): void;
-export declare function rollbackRuntimePreset(previous: string | null): void;

package/dist/config/schema.d.ts

@@ -1,5 +1,4 @@
 import { z } from 'zod';
-declare const FALLBACK_AGENT_NAMES: readonly ["orchestrator", "oracle", "designer", "explorer", "librarian", "fixer"];
 declare const MANUAL_AGENT_NAMES: readonly ["orchestrator", "oracle", "designer", "explorer", "librarian", "fixer"];
 export declare const ProviderModelIdSchema: z.ZodString;
 export declare const ManualAgentPlanSchema: z.ZodObject<{
@@ -49,7 +48,6 @@ export declare const ManualPlanSchema: z.ZodObject<{
 export type ManualAgentName = (typeof MANUAL_AGENT_NAMES)[number];
 export type ManualAgentPlan = z.infer<typeof ManualAgentPlanSchema>;
 export type ManualPlan = z.infer<typeof ManualPlanSchema>;
-export type FallbackAgentName = (typeof FALLBACK_AGENT_NAMES)[number];
 export declare const AgentOverrideConfigSchema: z.ZodObject<{
     model: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
         id: z.ZodString;
@@ -177,19 +175,12 @@ export declare const FailoverConfigSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     timeoutMs: z.ZodDefault<z.ZodNumber>;
     retryDelayMs: z.ZodDefault<z.ZodNumber>;
-    chains: z.ZodDefault<z.ZodObject<{
-        orchestrator: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        oracle: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        designer: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        explorer: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        librarian: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        fixer: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$catchall<z.ZodArray<z.ZodString>>>>;
     retry_on_empty: z.ZodDefault<z.ZodBoolean>;
-}, z.core.$strip>;
+}, z.core.$strict>;
 export type FailoverConfig = z.infer<typeof FailoverConfigSchema>;
 export declare const CompanionConfigSchema: z.ZodObject<{
     enabled: z.ZodOptional<z.ZodBoolean>;
+    binaryPath: z.ZodOptional<z.ZodString>;
     position: z.ZodOptional<z.ZodEnum<{
         "bottom-right": "bottom-right";
         "bottom-left": "bottom-left";
@@ -201,56 +192,61 @@ export declare const CompanionConfigSchema: z.ZodObject<{
         medium: "medium";
         large: "large";
     }>>;
+    gifPack: z.ZodOptional<z.ZodEnum<{
+        default: "default";
+    }>>;
+    loopStyle: z.ZodOptional<z.ZodEnum<{
+        classic: "classic";
+        smooth: "smooth";
+    }>>;
+    speed: z.ZodOptional<z.ZodNumber>;
+    debug: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export type CompanionConfig = z.infer<typeof CompanionConfigSchema>;
+export declare const AcpAgentPermissionModeSchema: z.ZodEnum<{
+    allow: "allow";
+    ask: "ask";
+    reject: "reject";
+}>;
+export declare const AcpAgentConfigSchema: z.ZodObject<{
+    command: z.ZodString;
+    args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    cwd: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    prompt: z.ZodOptional<z.ZodString>;
+    orchestratorPrompt: z.ZodOptional<z.ZodString>;
+    wrapperModel: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodDefault<z.ZodNumber>;
+    permissionMode: z.ZodDefault<z.ZodEnum<{
+        allow: "allow";
+        ask: "ask";
+        reject: "reject";
+    }>>;
+}, z.core.$strict>;
+export declare const AcpAgentsConfigSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
+    command: z.ZodString;
+    args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    cwd: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    prompt: z.ZodOptional<z.ZodString>;
+    orchestratorPrompt: z.ZodOptional<z.ZodString>;
+    wrapperModel: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodDefault<z.ZodNumber>;
+    permissionMode: z.ZodDefault<z.ZodEnum<{
+        allow: "allow";
+        ask: "ask";
+        reject: "reject";
+    }>>;
+}, z.core.$strict>>;
+export type AcpAgentPermissionMode = z.infer<typeof AcpAgentPermissionModeSchema>;
+export type AcpAgentConfig = z.infer<typeof AcpAgentConfigSchema>;
+export type AcpAgentsConfig = z.infer<typeof AcpAgentsConfigSchema>;
 export declare const PluginConfigSchema: z.ZodObject<{
     preset: z.ZodOptional<z.ZodString>;
     setDefaultAgent: z.ZodOptional<z.ZodBoolean>;
-    scoringEngineVersion: z.ZodOptional<z.ZodEnum<{
-        v1: "v1";
-        "v2-shadow": "v2-shadow";
-        v2: "v2";
-    }>>;
-    balanceProviderUsage: z.ZodOptional<z.ZodBoolean>;
     autoUpdate: z.ZodOptional<z.ZodBoolean>;
-    manualPlan: z.ZodOptional<z.ZodObject<{
-        orchestrator: z.ZodObject<{
-            primary: z.ZodString;
-            fallback1: z.ZodString;
-            fallback2: z.ZodString;
-            fallback3: z.ZodString;
-        }, z.core.$strip>;
-        oracle: z.ZodObject<{
-            primary: z.ZodString;
-            fallback1: z.ZodString;
-            fallback2: z.ZodString;
-            fallback3: z.ZodString;
-        }, z.core.$strip>;
-        designer: z.ZodObject<{
-            primary: z.ZodString;
-            fallback1: z.ZodString;
-            fallback2: z.ZodString;
-            fallback3: z.ZodString;
-        }, z.core.$strip>;
-        explorer: z.ZodObject<{
-            primary: z.ZodString;
-            fallback1: z.ZodString;
-            fallback2: z.ZodString;
-            fallback3: z.ZodString;
-        }, z.core.$strip>;
-        librarian: z.ZodObject<{
-            primary: z.ZodString;
-            fallback1: z.ZodString;
-            fallback2: z.ZodString;
-            fallback3: z.ZodString;
-        }, z.core.$strip>;
-        fixer: z.ZodObject<{
-            primary: z.ZodString;
-            fallback1: z.ZodString;
-            fallback2: z.ZodString;
-            fallback3: z.ZodString;
-        }, z.core.$strip>;
-    }, z.core.$strict>>;
     presets: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodObject<{
         model: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
             id: z.ZodString;
@@ -334,16 +330,8 @@ export declare const PluginConfigSchema: z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         timeoutMs: z.ZodDefault<z.ZodNumber>;
         retryDelayMs: z.ZodDefault<z.ZodNumber>;
-        chains: z.ZodDefault<z.ZodObject<{
-            orchestrator: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            oracle: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            designer: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            explorer: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            librarian: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            fixer: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        }, z.core.$catchall<z.ZodArray<z.ZodString>>>>;
         retry_on_empty: z.ZodDefault<z.ZodBoolean>;
-    }, z.core.$strip>>;
+    }, z.core.$strict>>;
     council: z.ZodOptional<z.ZodPipe<z.ZodObject<{
         presets: z.ZodRecord<z.ZodString, z.ZodPipe<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>, z.ZodTransform<Record<string, {
             model: string;
@@ -358,8 +346,6 @@ export declare const PluginConfigSchema: z.ZodObject<{
         }>>;
         councillor_retries: z.ZodDefault<z.ZodNumber>;
         master: z.ZodOptional<z.ZodUnknown>;
-        master_timeout: z.ZodOptional<z.ZodUnknown>;
-        master_fallback: z.ZodOptional<z.ZodUnknown>;
     }, z.core.$strip>, z.ZodTransform<{
         presets: Record<string, Record<string, {
             model: string;
@@ -383,11 +369,10 @@ export declare const PluginConfigSchema: z.ZodObject<{
         councillor_execution_mode: "parallel" | "serial";
         councillor_retries: number;
         master?: unknown;
-        master_timeout?: unknown;
-        master_fallback?: unknown;
     }>>>;
     companion: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodOptional<z.ZodBoolean>;
+        binaryPath: z.ZodOptional<z.ZodString>;
         position: z.ZodOptional<z.ZodEnum<{
             "bottom-right": "bottom-right";
             "bottom-left": "bottom-left";
@@ -399,7 +384,32 @@ export declare const PluginConfigSchema: z.ZodObject<{
             medium: "medium";
             large: "large";
         }>>;
+        gifPack: z.ZodOptional<z.ZodEnum<{
+            default: "default";
+        }>>;
+        loopStyle: z.ZodOptional<z.ZodEnum<{
+            classic: "classic";
+            smooth: "smooth";
+        }>>;
+        speed: z.ZodOptional<z.ZodNumber>;
+        debug: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
+    acpAgents: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        command: z.ZodString;
+        args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        cwd: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        prompt: z.ZodOptional<z.ZodString>;
+        orchestratorPrompt: z.ZodOptional<z.ZodString>;
+        wrapperModel: z.ZodOptional<z.ZodString>;
+        timeoutMs: z.ZodDefault<z.ZodNumber>;
+        permissionMode: z.ZodDefault<z.ZodEnum<{
+            allow: "allow";
+            ask: "ask";
+            reject: "reject";
+        }>>;
+    }, z.core.$strict>>>;
 }, z.core.$strip>;
 export type PluginConfig = z.infer<typeof PluginConfigSchema>;
 export type { AgentName } from './constants';

package/dist/config/utils.d.ts

@@ -15,3 +15,4 @@ export declare function getAgentOverride(config: PluginConfig | undefined, name:
  * legacy aliases.
  */
 export declare function getCustomAgentNames(config: PluginConfig | undefined): string[];
+export declare function getAcpAgentNames(config: PluginConfig | undefined): string[];

package/dist/hooks/auto-update-checker/skill-sync.d.ts

@@ -0,0 +1,9 @@
+export interface SkillSyncResult {
+    installed: string[];
+    skippedExisting: string[];
+    failed: string[];
+}
+/**
+ * Synchronizes bundled skills from the newly installed package root to OpenCode config skills directory.
+ */
+export declare function syncBundledSkillsFromPackage(packageRoot: string): SkillSyncResult;

package/dist/hooks/auto-update-checker/types.d.ts

@@ -1,3 +1,4 @@
+import type { CompanionConfig } from '../../config/schema';
 export interface NpmDistTags {
     latest: string;
     [key: string]: string;
@@ -23,6 +24,7 @@ export interface PackageJson {
 }
 export interface AutoUpdateCheckerOptions {
     autoUpdate?: boolean;
+    companion?: CompanionConfig;
 }
 export interface PluginEntryInfo {
     entry: string;

package/dist/hooks/filter-available-skills/index.d.ts

@@ -5,19 +5,7 @@
  */
 import type { PluginInput } from '@opencode-ai/plugin';
 import { type PluginConfig } from '../../config';
-interface MessageInfo {
-    role: string;
-    agent?: string;
-}
-interface MessagePart {
-    type: string;
-    text?: string;
-    [key: string]: unknown;
-}
-interface MessageWithParts {
-    info: MessageInfo;
-    parts: MessagePart[];
-}
+import type { MessageWithParts } from '../types';
 type SkillRule = 'allow' | 'ask' | 'deny';
 declare function filterAvailableSkillsText(text: string, permissionRules: Record<string, SkillRule>): string;
 /**

package/dist/hooks/foreground-fallback/index.d.ts

@@ -20,7 +20,7 @@ export declare function isRateLimitError(error: unknown): boolean;
  * Manages runtime model fallback for foreground agent sessions.
  *
  * Constructed at plugin init with the ordered fallback chains for each agent
- * (built from _modelArray entries merged with fallback.chains config).
+ * (built from _modelArray entries in agents.<name>.model).
  */
 export declare class ForegroundFallbackManager {
     private readonly client;

package/dist/hooks/image-hook.d.ts

@@ -1,19 +1,7 @@
-interface MessageWithParts {
-    info: {
-        role: string;
-        agent?: string;
-        sessionID?: string;
-    };
-    parts: Array<{
-        type: string;
-        text?: string;
-        [key: string]: unknown;
-    }>;
-}
+import type { MessageWithParts } from './types';
 export declare function processImageAttachments(args: {
     messages: MessageWithParts[];
     workDir: string;
     disabledAgents: Set<string>;
     log: (msg: string) => void;
 }): void;
-export {};

package/dist/hooks/index.d.ts

@@ -3,11 +3,12 @@ export type { AutoUpdateCheckerOptions } from './auto-update-checker';
 export { createAutoUpdateCheckerHook } from './auto-update-checker';
 export { createChatHeadersHook } from './chat-headers';
 export { createDeepworkCommandHook } from './deepwork';
-export { createDelegateTaskRetryHook } from './delegate-task-retry';
+export { createDelegateTaskRetryHook } from './delegate-task-retry/hook';
 export { createFilterAvailableSkillsHook } from './filter-available-skills';
 export { ForegroundFallbackManager, isRateLimitError, } from './foreground-fallback';
 export { processImageAttachments } from './image-hook';
-export { createJsonErrorRecoveryHook } from './json-error-recovery';
+export { createJsonErrorRecoveryHook } from './json-error-recovery/hook';
 export { createPhaseReminderHook } from './phase-reminder';
 export { createPostFileToolNudgeHook } from './post-file-tool-nudge';
+export { createReflectCommandHook } from './reflect';
 export { createTaskSessionManagerHook } from './task-session-manager';

package/dist/hooks/phase-reminder/index.d.ts

@@ -1,18 +1,13 @@
-export declare const PHASE_REMINDER = "<internal_reminder>!IMPORTANT! Scheduler workflow: plan lanes/dependencies \u2192 dispatch background specialists \u2192 track task IDs \u2192 wait for hook-driven completion \u2192 reconcile terminal results \u2192 verify. Do not poll running jobs, consume running-job output, or advance dependent work. !END!</internal_reminder>";
-interface MessageInfo {
-    role: string;
-    agent?: string;
-    sessionID?: string;
-}
-interface MessagePart {
-    type: string;
-    text?: string;
-    [key: string]: unknown;
-}
-interface MessageWithParts {
-    info: MessageInfo;
-    parts: MessagePart[];
-}
+/**
+ * Phase reminder to append after each latest user message.
+ *
+ * Keeping this at the tail preserves immediate workflow guidance without
+ * mutating the cached system prompt or prepending request-local content ahead
+ * of the user's actual turn.
+ */
+import { PHASE_REMINDER } from '../../config/constants';
+import type { MessageWithParts } from '../types';
+export { PHASE_REMINDER };
 /**
  * Creates the experimental.chat.messages.transform hook for phase reminder injection.
  * This hook runs right before sending to API, so it doesn't affect UI display.
@@ -23,4 +18,3 @@ export declare function createPhaseReminderHook(): {
         messages: MessageWithParts[];
     }) => Promise<void>;
 };
-export {};

package/dist/hooks/reflect/index.d.ts

@@ -0,0 +1,13 @@
+export declare function createReflectCommandHook(): {
+    registerCommand: (config: Record<string, unknown>) => void;
+    handleCommandExecuteBefore: (input: {
+        command: string;
+        sessionID: string;
+        arguments: string;
+    }, output: {
+        parts: Array<{
+            type: string;
+            text?: string;
+        }>;
+    }) => Promise<void>;
+};

package/dist/hooks/task-session-manager/index.d.ts

@@ -1,19 +1,6 @@
 import type { PluginInput } from '@opencode-ai/plugin';
 import { BackgroundJobBoard } from '../../utils';
-interface ChatMessagePart {
-    type: string;
-    text?: string;
-    [key: string]: unknown;
-}
-interface ChatMessage {
-    info: {
-        role: string;
-        agent?: string;
-        sessionID?: string;
-        id?: string;
-    };
-    parts: ChatMessagePart[];
-}
+import type { MessageWithParts } from '../types';
 export declare function createTaskSessionManagerHook(_ctx: PluginInput, options: {
     maxSessionsPerAgent: number;
     readContextMinLines?: number;
@@ -37,7 +24,7 @@ export declare function createTaskSessionManagerHook(_ctx: PluginInput, options:
         metadata?: unknown;
     }) => Promise<void>;
     'experimental.chat.messages.transform': (_input: Record<string, never>, output: {
-        messages: ChatMessage[];
+        messages: MessageWithParts[];
     }) => Promise<void>;
     event: (input: {
         event: {
@@ -58,4 +45,3 @@ export declare function createTaskSessionManagerHook(_ctx: PluginInput, options:
         };
     }) => Promise<void>;
 };
-export {};

package/dist/hooks/types.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Shared message type shapes for the OpenCode plugin API's `messages` array.
+ *
+ * These types describe the structure of chat messages passed through
+ * `experimental.chat.messages.transform` and related hooks. All fields
+ * are unioned across the files that previously defined them privately —
+ * optional extras are harmless under structural typing.
+ */
+export type MessageInfo = {
+    role: string;
+    agent?: string;
+    sessionID?: string;
+    id?: string;
+};
+export type MessagePart = {
+    type: string;
+    text?: string;
+    [key: string]: unknown;
+};
+export type MessageWithParts = {
+    info: MessageInfo;
+    parts: MessagePart[];
+};