@opencode-ai/plugin 0.0.0-snapshot-tui-plugins-202603271347 → 0.0.0-tui-v2-202606261840

package/dist/example-workspace.d.ts

@@ -0,0 +1,3 @@
+import type { Plugin } from "@opencode-ai/plugin";
+export declare const FolderWorkspacePlugin: Plugin;
+export default FolderWorkspacePlugin;

package/dist/example-workspace.js

@@ -0,0 +1,30 @@
+import { mkdir, rm } from "node:fs/promises";
+export const FolderWorkspacePlugin = async ({ experimental_workspace }) => {
+    experimental_workspace.register("folder", {
+        name: "Folder",
+        description: "Create a blank folder",
+        configure(config) {
+            const rand = "" + Math.random();
+            return {
+                ...config,
+                directory: `/tmp/folder/folder-${rand}`,
+            };
+        },
+        async create(config) {
+            if (!config.directory)
+                return;
+            await mkdir(config.directory, { recursive: true });
+        },
+        async remove(config) {
+            await rm(config.directory, { recursive: true, force: true });
+        },
+        target(config) {
+            return {
+                type: "local",
+                directory: config.directory,
+            };
+        },
+    });
+    return {};
+};
+export default FolderWorkspacePlugin;

package/dist/example.js

@@ -1,5 +1,5 @@
 import { tool } from "./tool.js";
-export const ExamplePlugin = async (ctx) => {
+export const ExamplePlugin = async (_ctx) => {
     return {
         tool: {
             mytool: tool({

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-import type { Event, createOpencodeClient, Project, Model, Provider, Permission, UserMessage, Message, Part, Auth, Config as SDKConfig } from "@opencode-ai/sdk";
+import type { Event, createOpencodeClient, Project, Model, Provider, Permission, UserMessage, Message, Part, Config as SDKConfig } from "@opencode-ai/sdk";
+import type { Provider as ProviderV2, Model as ModelV2, Auth } from "@opencode-ai/sdk/v2";
 import type { BunShell } from "./shell.js";
 import { type ToolDefinition } from "./tool.js";
 export * from "./tool.js";
@@ -7,11 +8,39 @@ export type ProviderContext = {
     info: Provider;
     options: Record<string, any>;
 };
+export type WorkspaceInfo = {
+    id: string;
+    type: string;
+    name: string;
+    branch: string | null;
+    directory: string | null;
+    extra: unknown | null;
+    projectID: string;
+};
+export type WorkspaceTarget = {
+    type: "local";
+    directory: string;
+} | {
+    type: "remote";
+    url: string | URL;
+    headers?: HeadersInit;
+};
+export type WorkspaceAdapter = {
+    name: string;
+    description: string;
+    configure(config: WorkspaceInfo): WorkspaceInfo | Promise<WorkspaceInfo>;
+    create(config: WorkspaceInfo, env: Record<string, string | undefined>, from?: WorkspaceInfo): Promise<void>;
+    remove(config: WorkspaceInfo): Promise<void>;
+    target(config: WorkspaceInfo): WorkspaceTarget | Promise<WorkspaceTarget>;
+};
 export type PluginInput = {
     client: ReturnType<typeof createOpencodeClient>;
     project: Project;
     directory: string;
     worktree: string;
+    experimental_workspace: {
+        register(type: string, adapter: WorkspaceAdapter): void;
+    };
     serverUrl: URL;
     $: BunShell;
 };
@@ -22,7 +51,8 @@ export type Config = Omit<SDKConfig, "plugin"> & {
 export type Plugin = (input: PluginInput, options?: PluginOptions) => Promise<Hooks>;
 export type PluginModule = {
     id?: string;
-    server?: Plugin;
+    server: Plugin;
+    tui?: never;
 };
 type Rule = {
     key: string;
@@ -87,6 +117,7 @@ export type AuthHook = {
             type: "success";
             key: string;
             provider?: string;
+            metadata?: Record<string, string>;
         } | {
             type: "failed";
         }>;
@@ -108,6 +139,7 @@ export type AuthOAuthResult = {
         enterpriseUrl?: string;
     } | {
         key: string;
+        metadata?: Record<string, string>;
     })) | {
         type: "failed";
     }>;
@@ -124,13 +156,22 @@ export type AuthOAuthResult = {
         enterpriseUrl?: string;
     } | {
         key: string;
+        metadata?: Record<string, string>;
     })) | {
         type: "failed";
     }>;
 });
+export type ProviderHookContext = {
+    auth?: Auth;
+};
+export type ProviderHook = {
+    id: string;
+    models?: (provider: ProviderV2, ctx: ProviderHookContext) => Promise<Record<string, ModelV2>>;
+};
 /** @deprecated Use AuthOAuthResult instead. */
 export type AuthOuathResult = AuthOAuthResult;
 export interface Hooks {
+    dispose?: () => Promise<void>;
     event?: (input: {
         event: Event;
     }) => Promise<void>;
@@ -139,6 +180,7 @@ export interface Hooks {
         [key: string]: ToolDefinition;
     };
     auth?: AuthHook;
+    provider?: ProviderHook;
     /**
      * Called when a new message is received
      */
@@ -168,6 +210,7 @@ export interface Hooks {
         temperature: number;
         topP: number;
         topK: number;
+        maxOutputTokens: number | undefined;
         options: Record<string, any>;
     }) => Promise<void>;
     "chat.headers"?: (input: {
@@ -225,6 +268,11 @@ export interface Hooks {
     }, output: {
         system: string[];
     }) => Promise<void>;
+    "experimental.provider.small_model"?: (input: {
+        provider: ProviderV2;
+    }, output: {
+        model?: ModelV2;
+    }) => Promise<void>;
     /**
      * Called before session compaction starts. Allows plugins to customize
      * the compaction prompt.
@@ -238,6 +286,23 @@ export interface Hooks {
         context: string[];
         prompt?: string;
     }) => Promise<void>;
+    /**
+     * Called after compaction succeeds and before a synthetic user
+     * auto-continue message is added.
+     *
+     * - `enabled`: Defaults to `true`. Set to `false` to skip the synthetic
+     *   user "continue" turn.
+     */
+    "experimental.compaction.autocontinue"?: (input: {
+        sessionID: string;
+        agent: string;
+        model: Model;
+        provider: ProviderContext;
+        message: UserMessage;
+        overflow: boolean;
+    }, output: {
+        enabled: boolean;
+    }) => Promise<void>;
     "experimental.text.complete"?: (input: {
         sessionID: string;
         messageID: string;

package/dist/tool.d.ts

@@ -30,14 +30,28 @@ type AskInput = {
         [key: string]: any;
     };
 };
+export type ToolAttachment = {
+    type: "file";
+    mime: string;
+    url: string;
+    filename?: string;
+};
+export type ToolResult = string | {
+    title?: string;
+    output: string;
+    metadata?: {
+        [key: string]: any;
+    };
+    attachments?: ToolAttachment[];
+};
 export declare function tool<Args extends z.ZodRawShape>(input: {
     description: string;
     args: Args;
-    execute(args: z.infer<z.ZodObject<Args>>, context: ToolContext): Promise<string>;
+    execute(args: z.infer<z.ZodObject<Args>>, context: ToolContext): Promise<ToolResult>;
 }): {
     description: string;
     args: Args;
-    execute(args: z.infer<z.ZodObject<Args>>, context: ToolContext): Promise<string>;
+    execute(args: z.infer<z.ZodObject<Args>>, context: ToolContext): Promise<ToolResult>;
 };
 export declare namespace tool {
     var schema: typeof z;

package/dist/tui.d.ts

@@ -1,15 +1,22 @@
-import type { OpencodeClient, Event, LspStatus, McpStatus, Todo, Message, Part, Provider, PermissionRequest, QuestionRequest, SessionStatus, Workspace, Config as SdkConfig } from "@opencode-ai/sdk/v2";
-import type { CliRenderer, ParsedKey, RGBA } from "@opentui/core";
+import type { AgentPart, OpencodeClient, Event, FilePart, LspStatus, McpStatus, Todo, Message, Part, Provider, PermissionRequest, QuestionRequest, Session, SessionStatus, TextPart, Config as SdkConfig } from "@opencode-ai/sdk/v2";
+import type { CliRenderer, KeyEvent, RGBA, Renderable, SlotMode } from "@opentui/core";
+import type { Binding, Keymap } from "@opentui/keymap";
+import { type BindingConfig, type CreateBindingLookupOptions, type KeySequenceFormatPart, type SequenceBindingLike } from "@opentui/keymap/extras";
 import type { JSX, SolidPlugin } from "@opentui/solid";
-import type { Config as PluginConfig, PluginModule, PluginOptions } from "./index.js";
-export type { CliRenderer, SlotMode } from "@opentui/core";
+import type { Config as PluginConfig, PluginOptions } from "./index.js";
+export type { CliRenderer, KeyEvent, Renderable, SlotMode } from "@opentui/core";
+export { stringifyKeySequence, stringifyKeyStroke } from "@opentui/keymap";
+export type { Binding, KeyLike, KeySequencePart, KeyStringifyInput, StringifyOptions } from "@opentui/keymap";
+export { formatCommandBindings, formatKeySequence } from "@opentui/keymap/extras";
+export type { BindingConfig, BindingLookup, BindingValue, CreateBindingLookupOptions, FormatCommandBindingsOptions, FormatKeySequenceOptions, KeySequenceFormatPart, SequenceBindingLike, } from "@opentui/keymap/extras";
+export declare function createBindingLookup(config: BindingConfig<Renderable, KeyEvent> | undefined, options?: CreateBindingLookupOptions<Renderable, KeyEvent>): import("@opentui/keymap/extras").BindingLookup<Renderable, KeyEvent>;
 export type TuiRouteCurrent = {
     name: "home";
 } | {
     name: "session";
     params: {
         sessionID: string;
-        initialPrompt?: unknown;
+        prompt?: unknown;
     };
 } | {
     name: string;
@@ -21,6 +28,20 @@ export type TuiRouteDefinition = {
         params?: Record<string, unknown>;
     }) => JSX.Element;
 };
+export type TuiKeys = {
+    formatSequence: (parts: readonly KeySequenceFormatPart[] | undefined) => string;
+    formatBindings: (bindings: readonly SequenceBindingLike[] | undefined) => string | undefined;
+};
+export type TuiKeymap = Keymap<Renderable, KeyEvent>;
+export type TuiModeApi = {
+    current: () => string;
+    push: (mode: string) => () => void;
+};
+/**
+ * Legacy `api.command` shape kept so v1 plugins can initialize. Remove in v2.
+ *
+ * @deprecated Use `api.keymap.registerLayer({ commands, bindings })` instead.
+ */
 export type TuiCommand = {
     title: string;
     value: string;
@@ -34,22 +55,21 @@ export type TuiCommand = {
         name: string;
         aliases?: string[];
     };
-    onSelect?: () => void;
-};
-export type TuiKeybind = {
-    name: string;
-    ctrl: boolean;
-    meta: boolean;
-    shift: boolean;
-    super?: boolean;
-    leader: boolean;
-};
-export type TuiKeybindMap = Record<string, string>;
-export type TuiKeybindSet = {
-    readonly all: TuiKeybindMap;
-    get: (name: string) => string;
-    match: (name: string, evt: ParsedKey) => boolean;
-    print: (name: string) => string;
+    onSelect?: (dialog?: TuiDialogStack) => void | Promise<void>;
+};
+/**
+ * Legacy `api.command` API kept so v1 plugins can initialize. Remove in v2.
+ *
+ * @deprecated Use `api.keymap.registerLayer`, `api.keymap.dispatchCommand`, and
+ * `api.keymap.dispatchCommand("command.palette.show")` instead.
+ */
+export type TuiCommandApi = {
+    /** @deprecated Use `api.keymap.registerLayer({ commands, bindings })` instead. */
+    register: (cb: () => TuiCommand[]) => () => void;
+    /** @deprecated Use `api.keymap.dispatchCommand(name)` instead. */
+    trigger: (value: string) => void;
+    /** @deprecated Use `api.keymap.dispatchCommand("command.palette.show")` instead. */
+    show: () => void;
 };
 export type TuiDialogProps = {
     size?: "medium" | "large" | "xlarge";
@@ -80,6 +100,8 @@ export type TuiDialogPromptProps = {
     description?: () => JSX.Element;
     placeholder?: string;
     value?: string;
+    busy?: boolean;
+    busyText?: string;
     onConfirm?: (value: string) => void;
     onCancel?: () => void;
 };
@@ -103,12 +125,96 @@ export type TuiDialogSelectProps<Value = unknown> = {
     skipFilter?: boolean;
     current?: Value;
 };
+export type TuiPromptInfo = {
+    input: string;
+    mode?: "normal" | "shell";
+    parts: (Omit<FilePart, "id" | "messageID" | "sessionID"> | Omit<AgentPart, "id" | "messageID" | "sessionID"> | (Omit<TextPart, "id" | "messageID" | "sessionID"> & {
+        source?: {
+            text: {
+                start: number;
+                end: number;
+                value: string;
+            };
+        };
+    }))[];
+};
+export type TuiPromptRef = {
+    focused: boolean;
+    current: TuiPromptInfo;
+    set(prompt: TuiPromptInfo): void;
+    reset(): void;
+    blur(): void;
+    focus(): void;
+    submit(): void;
+};
+export type TuiPromptProps = {
+    sessionID?: string;
+    visible?: boolean;
+    disabled?: boolean;
+    onSubmit?: () => void;
+    ref?: (ref: TuiPromptRef | undefined) => void;
+    hint?: JSX.Element;
+    right?: JSX.Element;
+    showPlaceholder?: boolean;
+    placeholders?: {
+        normal?: string[];
+        shell?: string[];
+    };
+};
 export type TuiToast = {
     variant?: "info" | "success" | "warning" | "error";
     title?: string;
     message: string;
     duration?: number;
 };
+export type TuiAttentionWhen = "always" | "focused" | "blurred";
+export declare const TuiAttentionSoundNames: readonly ["default", "question", "permission", "error", "done", "subagent_done"];
+export type TuiAttentionSoundName = (typeof TuiAttentionSoundNames)[number];
+export type TuiAttentionSound = boolean | {
+    name?: TuiAttentionSoundName;
+    volume?: number;
+    when?: TuiAttentionWhen;
+};
+export type TuiAttentionNotification = boolean | {
+    when?: TuiAttentionWhen;
+};
+export type TuiAttentionSoundPack = {
+    id: string;
+    name?: string;
+    sounds: Partial<Record<TuiAttentionSoundName, string>>;
+};
+export type TuiAttentionSoundPackInfo = {
+    id: string;
+    name?: string;
+    active: boolean;
+    builtin: boolean;
+};
+export type TuiAttentionSoundboardActivateOptions = {
+    persist?: boolean;
+};
+export type TuiAttentionSoundboard = {
+    registerPack(pack: TuiAttentionSoundPack): () => void;
+    activate(id: string, options?: TuiAttentionSoundboardActivateOptions): boolean;
+    current(): string;
+    list(): ReadonlyArray<TuiAttentionSoundPackInfo>;
+};
+export type TuiAttentionNotifyInput = {
+    title?: string;
+    message: string;
+    notification?: TuiAttentionNotification;
+    sound?: TuiAttentionSound;
+};
+export type TuiAttentionNotifySkipReason = "attention_disabled" | "empty_message" | "blurred" | "focused" | "focus_unknown" | "renderer_destroyed";
+export type TuiAttentionNotifyResult = {
+    ok: boolean;
+    notification: boolean;
+    sound: boolean;
+    skipped?: TuiAttentionNotifySkipReason;
+};
+export type TuiAttention = {
+    notify(input: TuiAttentionNotifyInput): Promise<TuiAttentionNotifyResult>;
+    soundboard: TuiAttentionSoundboard;
+};
 export type TuiThemeCurrent = {
     readonly primary: RGBA;
     readonly secondary: RGBA;
@@ -190,13 +296,11 @@ export type TuiState = {
     };
     readonly vcs: {
         branch?: string;
+        default_branch?: string;
     } | undefined;
-    readonly workspace: {
-        list: () => ReadonlyArray<Workspace>;
-        get: (workspaceID: string) => Workspace | undefined;
-    };
     session: {
         count: () => number;
+        get: (sessionID: string) => Session | undefined;
         diff: (sessionID: string) => ReadonlyArray<TuiSidebarFileItem>;
         todo: (sessionID: string) => ReadonlyArray<TuiSidebarTodoItem>;
         messages: (sessionID: string) => ReadonlyArray<Message>;
@@ -208,8 +312,27 @@ export type TuiState = {
     lsp: () => ReadonlyArray<TuiSidebarLspItem>;
     mcp: () => ReadonlyArray<TuiSidebarMcpItem>;
 };
-type TuiConfigView = Pick<PluginConfig, "$schema" | "theme" | "keybinds" | "plugin"> & NonNullable<PluginConfig["tui"]> & {
+type TuiBindingLookupView = {
+    readonly bindings: ReadonlyArray<Binding<Renderable, KeyEvent>>;
+    get: (command: string) => ReadonlyArray<Binding<Renderable, KeyEvent>>;
+    has: (command: string) => boolean;
+    gather: (name: string, commands: readonly string[]) => ReadonlyArray<Binding<Renderable, KeyEvent>>;
+    pick: (name: string, commands: readonly string[]) => Binding<Renderable, KeyEvent>[];
+    omit: (name: string, commands: readonly string[]) => Binding<Renderable, KeyEvent>[];
+};
+type TuiAttentionConfigView = {
+    enabled: boolean;
+    notifications: boolean;
+    sound: boolean;
+    volume: number;
+    sound_pack: string;
+    sounds: Partial<Record<TuiAttentionSoundName, string>>;
+};
+type TuiConfigView = Pick<PluginConfig, "$schema" | "theme" | "plugin"> & NonNullable<PluginConfig["tui"]> & {
+    leader_timeout: number;
+    attention: TuiAttentionConfigView;
     plugin_enabled?: Record<string, boolean>;
+    keybinds: TuiBindingLookupView;
 };
 export type TuiApp = {
     readonly version: string;
@@ -229,10 +352,26 @@ export type TuiSidebarFileItem = {
     additions: number;
     deletions: number;
 };
-export type TuiSlotMap = {
+export type TuiHostSlotMap = {
     app: {};
+    app_bottom: {};
     home_logo: {};
+    home_prompt: {
+        ref?: (ref: TuiPromptRef | undefined) => void;
+    };
+    home_prompt_right: {};
+    session_prompt: {
+        session_id: string;
+        visible?: boolean;
+        disabled?: boolean;
+        on_submit?: () => void;
+        ref?: (ref: TuiPromptRef | undefined) => void;
+    };
+    session_prompt_right: {
+        session_id: string;
+    };
     home_bottom: {};
+    home_footer: {};
     sidebar_title: {
         session_id: string;
         title: string;
@@ -245,15 +384,25 @@ export type TuiSlotMap = {
         session_id: string;
     };
 };
+export type TuiSlotMap<Slots extends Record<string, object> = {}> = TuiHostSlotMap & Slots;
+type TuiSlotShape<Name extends string, Slots extends Record<string, object>> = Name extends keyof TuiHostSlotMap ? TuiHostSlotMap[Name] : Name extends keyof Slots ? Slots[Name] : Record<string, unknown>;
+export type TuiSlotProps<Name extends string = string, Slots extends Record<string, object> = {}> = {
+    name: Name;
+    mode?: SlotMode;
+    children?: JSX.Element;
+} & TuiSlotShape<Name, Slots>;
 export type TuiSlotContext = {
     theme: TuiTheme;
 };
-type SlotCore = SolidPlugin<TuiSlotMap, TuiSlotContext>;
-export type TuiSlotPlugin = Omit<SlotCore, "id"> & {
+type SlotCore<Slots extends Record<string, object> = {}> = SolidPlugin<TuiSlotMap<Slots>, TuiSlotContext>;
+export type TuiSlotPlugin<Slots extends Record<string, object> = {}> = Omit<SlotCore<Slots>, "id"> & {
     id?: never;
 };
 export type TuiSlots = {
-    register: (plugin: TuiSlotPlugin) => string;
+    register: {
+        (plugin: TuiSlotPlugin): string;
+        <Slots extends Record<string, object>>(plugin: TuiSlotPlugin<Slots>): string;
+    };
 };
 export type TuiEventBus = {
     on: <Type extends Event["type"]>(type: Type, handler: (event: Extract<Event, {
@@ -309,10 +458,17 @@ export type TuiWorkspace = {
 };
 export type TuiPluginApi = {
     app: TuiApp;
-    command: {
-        register: (cb: () => TuiCommand[]) => () => void;
-        trigger: (value: string) => void;
-    };
+    attention: TuiAttention;
+    /**
+     * Legacy `api.command` API kept so v1 plugins can initialize. Remove in v2.
+     *
+     * @deprecated Use `api.keymap.registerLayer`, `api.keymap.dispatchCommand`, and
+     * `api.keymap.dispatchCommand("command.palette.show")` instead.
+     */
+    command?: TuiCommandApi;
+    keys: TuiKeys;
+    keymap: TuiKeymap;
+    mode: TuiModeApi;
     route: {
         register: (routes: TuiRouteDefinition[]) => () => void;
         navigate: (name: string, params?: Record<string, unknown>) => void;
@@ -324,21 +480,16 @@ export type TuiPluginApi = {
         DialogConfirm: (props: TuiDialogConfirmProps) => JSX.Element;
         DialogPrompt: (props: TuiDialogPromptProps) => JSX.Element;
         DialogSelect: <Value = unknown>(props: TuiDialogSelectProps<Value>) => JSX.Element;
+        Slot: <Name extends string>(props: TuiSlotProps<Name>) => JSX.Element | null;
+        Prompt: (props: TuiPromptProps) => JSX.Element;
         toast: (input: TuiToast) => void;
         dialog: TuiDialogStack;
     };
-    keybind: {
-        match: (key: string, evt: ParsedKey) => boolean;
-        print: (key: string) => string;
-        create: (defaults: TuiKeybindMap, overrides?: Record<string, unknown>) => TuiKeybindSet;
-    };
     readonly tuiConfig: Frozen<TuiConfigView>;
     kv: TuiKV;
     state: TuiState;
     theme: TuiTheme;
     client: OpencodeClient;
-    scopedClient: (workspaceID?: string) => OpencodeClient;
-    workspace: TuiWorkspace;
     event: TuiEventBus;
     renderer: CliRenderer;
     slots: TuiSlots;
@@ -352,6 +503,8 @@ export type TuiPluginApi = {
     lifecycle: TuiLifecycle;
 };
 export type TuiPlugin = (api: TuiPluginApi, options: PluginOptions | undefined, meta: TuiPluginMeta) => Promise<void>;
-export type TuiPluginModule = PluginModule & {
-    tui?: TuiPlugin;
+export type TuiPluginModule = {
+    id?: string;
+    tui: TuiPlugin;
+    server?: never;
 };

package/dist/tui.js

@@ -1 +1,7 @@
-export {};
+import { createBindingLookup as createKeymapBindingLookup, } from "@opentui/keymap/extras";
+export { stringifyKeySequence, stringifyKeyStroke } from "@opentui/keymap";
+export { formatCommandBindings, formatKeySequence } from "@opentui/keymap/extras";
+export function createBindingLookup(config, options) {
+    return createKeymapBindingLookup(config ?? {}, options);
+}
+export const TuiAttentionSoundNames = ["default", "question", "permission", "error", "done", "subagent_done"];

package/dist/v2/effect/agent.d.ts

@@ -0,0 +1,12 @@
+import type { AgentV2Info } from "@opencode-ai/sdk/v2/types";
+import type { Hooks } from "./registration.js";
+export interface AgentDraft {
+    list(): readonly AgentV2Info[];
+    get(id: string): AgentV2Info | undefined;
+    default(id: string | undefined): void;
+    update(id: string, update: (agent: AgentV2Info) => void): void;
+    remove(id: string): void;
+}
+export type AgentHooks = Hooks<{
+    transform: AgentDraft;
+}>;

package/dist/v2/effect/agent.js

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

package/dist/v2/effect/aisdk.d.ts

@@ -0,0 +1,17 @@
+import type { LanguageModelV3 } from "@ai-sdk/provider";
+import type { ModelV2Info } from "@opencode-ai/sdk/v2/types";
+import type { Hooks } from "./registration.js";
+export type AISDKHooks = Hooks<{
+    sdk: {
+        readonly model: ModelV2Info;
+        readonly package: string;
+        readonly options: Record<string, any>;
+        sdk?: any;
+    };
+    language: {
+        readonly model: ModelV2Info;
+        readonly sdk: any;
+        readonly options: Record<string, any>;
+        language?: LanguageModelV3;
+    };
+}>;

package/dist/v2/effect/aisdk.js

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

package/dist/v2/effect/catalog.d.ts

@@ -0,0 +1,29 @@
+import type { ModelV2Info, ProviderV2Info } from "@opencode-ai/sdk/v2/types";
+import type { Hooks } from "./registration.js";
+export interface CatalogProviderRecord {
+    readonly provider: ProviderV2Info;
+    readonly models: ReadonlyMap<string, ModelV2Info>;
+}
+export interface CatalogDraft {
+    readonly provider: {
+        list(): readonly CatalogProviderRecord[];
+        get(providerID: string): CatalogProviderRecord | undefined;
+        update(providerID: string, update: (provider: ProviderV2Info) => void): void;
+        remove(providerID: string): void;
+    };
+    readonly model: {
+        get(providerID: string, modelID: string): ModelV2Info | undefined;
+        update(providerID: string, modelID: string, update: (model: ModelV2Info) => void): void;
+        remove(providerID: string, modelID: string): void;
+        readonly default: {
+            get(): {
+                providerID: string;
+                modelID: string;
+            } | undefined;
+            set(providerID: string, modelID: string): void;
+        };
+    };
+}
+export type CatalogHooks = Hooks<{
+    transform: CatalogDraft;
+}>;

package/dist/v2/effect/catalog.js

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

package/dist/v2/effect/command.d.ts

@@ -0,0 +1,11 @@
+import type { CommandV2Info } from "@opencode-ai/sdk/v2/types";
+import type { Hooks } from "./registration.js";
+export interface CommandDraft {
+    list(): readonly CommandV2Info[];
+    get(name: string): CommandV2Info | undefined;
+    update(name: string, update: (command: CommandV2Info) => void): void;
+    remove(name: string): void;
+}
+export type CommandHooks = Hooks<{
+    transform: CommandDraft;
+}>;

package/dist/v2/effect/command.js

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

package/dist/v2/effect/context.d.ts

@@ -0,0 +1,21 @@
+import type { PluginOptions } from "../options.js";
+import type { AgentHooks } from "./agent.js";
+import type { AISDKHooks } from "./aisdk.js";
+import type { CatalogHooks } from "./catalog.js";
+import type { CommandHooks } from "./command.js";
+import type { IntegrationHooks } from "./integration.js";
+import type { PluginDomain } from "./plugin.js";
+import type { ReferenceHooks } from "./reference.js";
+import type { SkillHooks } from "./skill.js";
+import type { Reload } from "./registration.js";
+export interface PluginContext {
+    readonly options: PluginOptions;
+    readonly agent: AgentHooks & Reload;
+    readonly aisdk: AISDKHooks;
+    readonly catalog: CatalogHooks & Reload;
+    readonly command: CommandHooks & Reload;
+    readonly integration: IntegrationHooks & Reload;
+    readonly plugin: PluginDomain;
+    readonly reference: ReferenceHooks & Reload;
+    readonly skill: SkillHooks & Reload;
+}

package/dist/v2/effect/context.js

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

package/dist/v2/effect/event.d.ts

@@ -0,0 +1,8 @@
+import type { Event as SDKEvent } from "@opencode-ai/sdk/v2/types";
+import type { Stream } from "effect";
+export type EventMap = {
+    [Item in SDKEvent as Item["type"]]: Item;
+};
+export interface Event {
+    subscribe<Type extends keyof EventMap>(type: Type): Stream.Stream<EventMap[Type]>;
+}

package/dist/v2/effect/event.js

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

package/dist/v2/effect/filesystem.d.ts

@@ -0,0 +1,23 @@
+import type { FileSystemEntry } from "@opencode-ai/sdk/v2/types";
+import type { Effect } from "effect";
+export interface FileSystem {
+    read(input: {
+        readonly path: string;
+    }): Effect.Effect<{
+        readonly content: Uint8Array;
+        readonly mime: string;
+    }>;
+    list(input?: {
+        readonly path?: string;
+    }): Effect.Effect<FileSystemEntry[]>;
+    find(input: {
+        readonly query: string;
+        readonly type?: "file" | "directory";
+        readonly limit?: number;
+    }): Effect.Effect<FileSystemEntry[]>;
+    glob(input: {
+        readonly pattern: string;
+        readonly path?: string;
+        readonly limit?: number;
+    }): Effect.Effect<readonly FileSystemEntry[]>;
+}

package/dist/v2/effect/filesystem.js

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

package/dist/v2/effect/index.d.ts

@@ -0,0 +1,3 @@
+export type { PluginContext } from "./context.js";
+export { define } from "./plugin.js";
+export type { Plugin } from "./plugin.js";

package/dist/v2/effect/index.js

@@ -0,0 +1 @@
+export { define } from "./plugin.js";

package/dist/v2/effect/integration.d.ts

@@ -0,0 +1,46 @@
+import type { ConnectionInfo, CredentialOAuth, CredentialValue, IntegrationEnvMethod, IntegrationInputs, IntegrationKeyMethod, IntegrationMethod, IntegrationOAuthMethod, IntegrationRef } from "@opencode-ai/sdk/v2/types";
+import type { Effect, Scope } from "effect";
+import type { Hooks } from "./registration.js";
+export type IntegrationOAuthAuthorization = {
+    readonly url: string;
+    readonly instructions: string;
+} & ({
+    readonly mode: "auto";
+    readonly callback: Effect.Effect<CredentialOAuth, unknown>;
+} | {
+    readonly mode: "code";
+    readonly callback: (code: string) => Effect.Effect<CredentialOAuth, unknown>;
+});
+export type IntegrationOAuthMethodRegistration = {
+    readonly integrationID: string;
+    readonly method: IntegrationOAuthMethod;
+    readonly authorize: (inputs: IntegrationInputs) => Effect.Effect<IntegrationOAuthAuthorization, unknown, Scope.Scope>;
+    readonly refresh?: (credential: CredentialOAuth) => Effect.Effect<CredentialOAuth, unknown>;
+    readonly label?: (credential: CredentialOAuth) => string | undefined;
+};
+export type IntegrationMethodRegistration = IntegrationOAuthMethodRegistration | {
+    readonly integrationID: string;
+    readonly method: IntegrationKeyMethod;
+} | {
+    readonly integrationID: string;
+    readonly method: IntegrationEnvMethod;
+};
+export interface IntegrationDraft {
+    list(): readonly IntegrationRef[];
+    get(id: string): IntegrationRef | undefined;
+    update(id: string, update: (integration: IntegrationRef) => void): void;
+    remove(id: string): void;
+    readonly method: {
+        list(integrationID: string): readonly IntegrationMethod[];
+        update(input: IntegrationMethodRegistration): void;
+        remove(integrationID: string, method: IntegrationMethod): void;
+    };
+}
+export interface IntegrationHooks extends Hooks<{
+    transform: IntegrationDraft;
+}> {
+    readonly connection: {
+        readonly active: (integrationID: string) => Effect.Effect<ConnectionInfo | undefined>;
+        readonly resolve: (connection: ConnectionInfo) => Effect.Effect<CredentialValue | undefined, unknown>;
+    };
+}

package/dist/v2/effect/integration.js

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

package/dist/v2/effect/location.d.ts

@@ -0,0 +1,6 @@
+export interface Location {
+    readonly directory: string;
+    readonly project: {
+        readonly directory: string;
+    };
+}

package/dist/v2/effect/location.js

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

package/dist/v2/effect/npm.d.ts

@@ -0,0 +1,7 @@
+import type { Effect } from "effect";
+export interface Npm {
+    add(pkg: string): Effect.Effect<{
+        readonly directory: string;
+        readonly entrypoint?: string;
+    }, unknown>;
+}

package/dist/v2/effect/npm.js

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

package/dist/v2/effect/path.d.ts

@@ -0,0 +1,8 @@
+export interface Path {
+    readonly home: string;
+    readonly data: string;
+    readonly cache: string;
+    readonly config: string;
+    readonly state: string;
+    readonly temp: string;
+}

package/dist/v2/effect/path.js

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

package/dist/v2/effect/plugin.d.ts

@@ -0,0 +1,11 @@
+import type { Effect, Scope } from "effect";
+import type { PluginContext } from "./context.js";
+export interface Plugin<R = Scope.Scope> {
+    readonly id: string;
+    readonly effect: (context: PluginContext) => Effect.Effect<void, never, R>;
+}
+export declare function define<R = Scope.Scope>(plugin: Plugin<R>): Plugin<R>;
+export interface PluginDomain {
+    readonly add: (plugin: Plugin) => Effect.Effect<void>;
+    readonly remove: (id: string) => Effect.Effect<void>;
+}

package/dist/v2/effect/plugin.js

@@ -0,0 +1,3 @@
+export function define(plugin) {
+    return plugin;
+}

package/dist/v2/effect/reference.d.ts

@@ -0,0 +1,10 @@
+import type { ReferenceGitSource, ReferenceLocalSource } from "@opencode-ai/sdk/v2/types";
+import type { Hooks } from "./registration.js";
+export interface ReferenceDraft {
+    add(name: string, source: ReferenceLocalSource | ReferenceGitSource): void;
+    remove(name: string): void;
+    list(): readonly (readonly [string, ReferenceLocalSource | ReferenceGitSource])[];
+}
+export type ReferenceHooks = Hooks<{
+    transform: ReferenceDraft;
+}>;

package/dist/v2/effect/reference.js

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

package/dist/v2/effect/registration.d.ts

@@ -0,0 +1,10 @@
+import type { Effect, Scope } from "effect";
+export interface Registration {
+    readonly dispose: Effect.Effect<void>;
+}
+export interface Reload {
+    readonly reload: () => Effect.Effect<void>;
+}
+export type Hooks<Spec> = {
+    readonly [Name in keyof Spec]: (callback: (input: Spec[Name]) => Effect.Effect<void> | void) => Effect.Effect<Registration, never, Scope.Scope>;
+};

package/dist/v2/effect/registration.js

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

package/dist/v2/effect/skill.d.ts

@@ -0,0 +1,9 @@
+import type { SkillV2Source } from "@opencode-ai/sdk/v2/types";
+import type { Hooks } from "./registration.js";
+export interface SkillDraft {
+    source(source: SkillV2Source): void;
+    list(): readonly SkillV2Source[];
+}
+export type SkillHooks = Hooks<{
+    transform: SkillDraft;
+}>;

package/dist/v2/effect/skill.js

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

package/dist/v2/options.d.ts

@@ -0,0 +1 @@
+export type PluginOptions = Readonly<Record<string, any>>;

package/dist/v2/options.js

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

package/dist/v2/promise/agent.d.ts

@@ -0,0 +1,6 @@
+import type { AgentDraft } from "../effect/agent.js";
+import type { Hooks } from "./registration.js";
+export type { AgentDraft };
+export type AgentHooks = Hooks<{
+    transform: AgentDraft;
+}>;

package/dist/v2/promise/agent.js

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

package/dist/v2/promise/aisdk.d.ts

@@ -0,0 +1,17 @@
+import type { LanguageModelV3 } from "@ai-sdk/provider";
+import type { ModelV2Info } from "@opencode-ai/sdk/v2/types";
+import type { Hooks } from "./registration.js";
+export type AISDKHooks = Hooks<{
+    sdk: {
+        readonly model: ModelV2Info;
+        readonly package: string;
+        readonly options: Record<string, any>;
+        sdk?: any;
+    };
+    language: {
+        readonly model: ModelV2Info;
+        readonly sdk: any;
+        readonly options: Record<string, any>;
+        language?: LanguageModelV3;
+    };
+}>;

package/dist/v2/promise/aisdk.js

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

package/dist/v2/promise/catalog.d.ts

@@ -0,0 +1,6 @@
+import type { CatalogDraft, CatalogProviderRecord } from "../effect/catalog.js";
+import type { Hooks } from "./registration.js";
+export type { CatalogDraft, CatalogProviderRecord };
+export type CatalogHooks = Hooks<{
+    transform: CatalogDraft;
+}>;

package/dist/v2/promise/catalog.js

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

package/dist/v2/promise/command.d.ts

@@ -0,0 +1,6 @@
+import type { CommandDraft } from "../effect/command.js";
+import type { Hooks } from "./registration.js";
+export type { CommandDraft };
+export type CommandHooks = Hooks<{
+    transform: CommandDraft;
+}>;

package/dist/v2/promise/command.js

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

package/dist/v2/promise/context.d.ts

@@ -0,0 +1,21 @@
+import type { PluginOptions } from "../options.js";
+import type { AgentHooks } from "./agent.js";
+import type { AISDKHooks } from "./aisdk.js";
+import type { CatalogHooks } from "./catalog.js";
+import type { CommandHooks } from "./command.js";
+import type { IntegrationHooks } from "./integration.js";
+import type { PluginDomain } from "./plugin.js";
+import type { ReferenceHooks } from "./reference.js";
+import type { SkillHooks } from "./skill.js";
+import type { Reload } from "./registration.js";
+export interface PluginContext {
+    readonly options: PluginOptions;
+    readonly agent: AgentHooks & Reload;
+    readonly aisdk: AISDKHooks;
+    readonly catalog: CatalogHooks & Reload;
+    readonly command: CommandHooks & Reload;
+    readonly integration: IntegrationHooks & Reload;
+    readonly plugin: PluginDomain;
+    readonly reference: ReferenceHooks & Reload;
+    readonly skill: SkillHooks & Reload;
+}

package/dist/v2/promise/context.js

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

package/dist/v2/promise/index.d.ts

@@ -0,0 +1,12 @@
+export type { PluginContext } from "./context.js";
+export type { PluginOptions } from "../options.js";
+export { define } from "./plugin.js";
+export type { Plugin, PluginDomain } from "./plugin.js";
+export type { Registration, Reload } from "./registration.js";
+export type { AgentDraft, AgentHooks } from "./agent.js";
+export type { AISDKHooks } from "./aisdk.js";
+export type { CatalogDraft, CatalogHooks, CatalogProviderRecord } from "./catalog.js";
+export type { CommandDraft, CommandHooks } from "./command.js";
+export type { IntegrationDraft, IntegrationHooks, IntegrationMethodRegistration } from "./integration.js";
+export type { ReferenceDraft, ReferenceHooks } from "./reference.js";
+export type { SkillDraft, SkillHooks } from "./skill.js";

package/dist/v2/promise/index.js

@@ -0,0 +1 @@
+export { define } from "./plugin.js";

package/dist/v2/promise/integration.d.ts

@@ -0,0 +1,12 @@
+import type { IntegrationDraft, IntegrationMethodRegistration } from "../effect/integration.js";
+import type { CredentialValue } from "@opencode-ai/sdk/v2/types";
+import type { Hooks } from "./registration.js";
+export type { IntegrationDraft, IntegrationMethodRegistration };
+export interface IntegrationHooks extends Hooks<{
+    transform: IntegrationDraft;
+}> {
+    readonly connection: {
+        readonly active: (integrationID: string) => Promise<import("@opencode-ai/sdk/v2/types").ConnectionInfo | undefined>;
+        readonly resolve: (connection: import("@opencode-ai/sdk/v2/types").ConnectionInfo) => Promise<CredentialValue | undefined>;
+    };
+}

package/dist/v2/promise/integration.js

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

package/dist/v2/promise/plugin.d.ts

@@ -0,0 +1,10 @@
+import type { PluginContext } from "./context.js";
+export interface Plugin {
+    readonly id: string;
+    readonly setup: (context: PluginContext) => Promise<void> | void;
+}
+export declare function define(plugin: Plugin): Plugin;
+export interface PluginDomain {
+    readonly add: (plugin: Plugin) => Promise<void>;
+    readonly remove: (id: string) => Promise<void>;
+}

package/dist/v2/promise/plugin.js

@@ -0,0 +1,3 @@
+export function define(plugin) {
+    return plugin;
+}

package/dist/v2/promise/reference.d.ts

@@ -0,0 +1,6 @@
+import type { ReferenceDraft } from "../effect/reference.js";
+import type { Hooks } from "./registration.js";
+export type { ReferenceDraft };
+export type ReferenceHooks = Hooks<{
+    transform: ReferenceDraft;
+}>;

package/dist/v2/promise/reference.js

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

package/dist/v2/promise/registration.d.ts

@@ -0,0 +1,9 @@
+export interface Registration {
+    readonly dispose: () => Promise<void>;
+}
+export interface Reload {
+    readonly reload: () => Promise<void>;
+}
+export type Hooks<Spec> = {
+    readonly [Name in keyof Spec]: (callback: (input: Spec[Name]) => Promise<void> | void) => Promise<Registration>;
+};

package/dist/v2/promise/registration.js

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

package/dist/v2/promise/skill.d.ts

@@ -0,0 +1,6 @@
+import type { SkillDraft } from "../effect/skill.js";
+import type { Hooks } from "./registration.js";
+export type { SkillDraft };
+export type SkillHooks = Hooks<{
+    transform: SkillDraft;
+}>;

package/dist/v2/promise/skill.js

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@opencode-ai/plugin",
-  "version": "0.0.0-snapshot-tui-plugins-202603271347",
+  "version": "0.0.0-tui-v2-202606261840",
   "type": "module",
   "license": "MIT",
   "scripts": {
@@ -20,32 +20,55 @@
     "./tui": {
       "import": "./dist/tui.js",
       "types": "./dist/tui.d.ts"
+    },
+    "./v2/effect": {
+      "import": "./dist/v2/effect/index.js",
+      "types": "./dist/v2/effect/index.d.ts"
+    },
+    "./v2/effect/integration": {
+      "import": "./dist/v2/effect/integration.js",
+      "types": "./dist/v2/effect/integration.d.ts"
+    },
+    "./v2/effect/plugin": {
+      "import": "./dist/v2/effect/plugin.js",
+      "types": "./dist/v2/effect/plugin.d.ts"
+    },
+    "./v2/promise": {
+      "import": "./dist/v2/promise/index.js",
+      "types": "./dist/v2/promise/index.d.ts"
     }
   },
   "files": [
     "dist"
   ],
   "dependencies": {
-    "@opencode-ai/sdk": "0.0.0-snapshot-tui-plugins-202603271347",
+    "@ai-sdk/provider": "3.0.8",
+    "@opencode-ai/sdk": "0.0.0-tui-v2-202606261840",
+    "effect": "4.0.0-beta.83",
     "zod": "4.1.8"
   },
   "peerDependencies": {
-    "@opentui/core": ">=0.1.90",
-    "@opentui/solid": ">=0.1.90"
+    "@opentui/core": ">=0.3.4",
+    "@opentui/keymap": ">=0.3.4",
+    "@opentui/solid": ">=0.3.4"
   },
   "peerDependenciesMeta": {
     "@opentui/core": {
       "optional": true
     },
+    "@opentui/keymap": {
+      "optional": true
+    },
     "@opentui/solid": {
       "optional": true
     }
   },
   "devDependencies": {
-    "@opentui/core": "0.1.90",
-    "@opentui/solid": "0.1.90",
+    "@opentui/core": "0.3.4",
+    "@opentui/keymap": "0.3.4",
+    "@opentui/solid": "0.3.4",
     "@tsconfig/node22": "22.0.2",
-    "@types/node": "22.13.9",
+    "@types/node": "24.12.2",
     "typescript": "5.8.2",
     "@typescript/native-preview": "7.0.0-dev.20251207.1"
   }