@matrix-ai/plugin 1.6.0 → 1.6.1

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-import type { Event, createOpencodeClient, Project, Model, Provider, Permission, UserMessage, Message, Part, Auth, Config } from "@matrix-ai/sdk";
+import type { Event, createOpencodeClient, Project, Model, Provider, Permission, UserMessage, Message, Part, Auth, Config as SDKConfig } from "@matrix-ai/sdk";
+import type { Provider as ProviderV2, Model as ModelV2 } from "@matrix-ai/sdk/v2";
 import type { BunShell } from "./shell.js";
 import { type ToolDefinition } from "./tool.js";
 export * from "./tool.js";
@@ -15,7 +16,16 @@ export type PluginInput = {
     serverUrl: URL;
     $: BunShell;
 };
-export type Plugin = (input: PluginInput) => Promise<Hooks>;
+export type PluginOptions = Record<string, unknown>;
+export type Config = Omit<SDKConfig, "plugin"> & {
+    plugin?: Array<string | [string, PluginOptions]>;
+};
+export type Plugin = (input: PluginInput, options?: PluginOptions) => Promise<Hooks>;
+export type PluginModule = {
+    id?: string;
+    server: Plugin;
+    tui?: never;
+};
 type Rule = {
     key: string;
     op: "eq" | "neq";
@@ -49,7 +59,7 @@ export type AuthHook = {
             condition?: (inputs: Record<string, string>) => boolean;
             when?: Rule;
         }>;
-        authorize(inputs?: Record<string, string>): Promise<AuthOuathResult>;
+        authorize(inputs?: Record<string, string>): Promise<AuthOAuthResult>;
     } | {
         type: "api";
         label: string;
@@ -84,7 +94,7 @@ export type AuthHook = {
         }>;
     })[];
 };
-export type AuthOuathResult = {
+export type AuthOAuthResult = {
     url: string;
     instructions: string;
 } & ({
@@ -97,6 +107,7 @@ export type AuthOuathResult = {
         access: string;
         expires: number;
         accountId?: string;
+        enterpriseUrl?: string;
     } | {
         key: string;
     })) | {
@@ -112,12 +123,22 @@ export type AuthOuathResult = {
         access: string;
         expires: number;
         accountId?: string;
+        enterpriseUrl?: string;
     } | {
         key: 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 {
     event?: (input: {
         event: Event;
@@ -127,6 +148,7 @@ export interface Hooks {
         [key: string]: ToolDefinition;
     };
     auth?: AuthHook;
+    provider?: ProviderHook;
     /**
      * Called when a new message is received
      */
@@ -188,17 +210,10 @@ export interface Hooks {
         cwd: string;
         sessionID?: string;
         callID?: string;
+        command?: string;
     }, output: {
         env: Record<string, string>;
     }) => Promise<void>;
-    "shell.pre-exec"?: (input: {
-        command: string;
-        cwd: string;
-        env: Record<string, string>;
-    }, output: {
-        env: Record<string, string>;
-        command?: string;
-    }) => Promise<void>;
     "tool.execute.after"?: (input: {
         tool: string;
         sessionID: string;

package/dist/tui.d.ts

@@ -0,0 +1,429 @@
+import type { AgentPart, OpencodeClient, Event, FilePart, LspStatus, McpStatus, Todo, Message, Part, Provider, PermissionRequest, QuestionRequest, SessionStatus, TextPart, Workspace, Config as SdkConfig } from "@matrix-ai/sdk/v2";
+import type { CliRenderer, ParsedKey, RGBA, SlotMode } from "@opentui/core";
+import type { JSX, SolidPlugin } from "@opentui/solid";
+import type { Config as PluginConfig, PluginOptions } from "./index.js";
+export type { CliRenderer, SlotMode } from "@opentui/core";
+export type TuiRouteCurrent = {
+    name: "home";
+} | {
+    name: "session";
+    params: {
+        sessionID: string;
+        initialPrompt?: unknown;
+    };
+} | {
+    name: string;
+    params?: Record<string, unknown>;
+};
+export type TuiRouteDefinition = {
+    name: string;
+    render: (input: {
+        params?: Record<string, unknown>;
+    }) => JSX.Element;
+};
+export type TuiCommand = {
+    title: string;
+    value: string;
+    description?: string;
+    category?: string;
+    keybind?: string;
+    suggested?: boolean;
+    hidden?: boolean;
+    enabled?: boolean;
+    slash?: {
+        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;
+};
+export type TuiDialogProps = {
+    size?: "medium" | "large" | "xlarge";
+    onClose: () => void;
+    children?: JSX.Element;
+};
+export type TuiDialogStack = {
+    replace: (render: () => JSX.Element, onClose?: () => void) => void;
+    clear: () => void;
+    setSize: (size: "medium" | "large" | "xlarge") => void;
+    readonly size: "medium" | "large" | "xlarge";
+    readonly depth: number;
+    readonly open: boolean;
+};
+export type TuiDialogAlertProps = {
+    title: string;
+    message: string;
+    onConfirm?: () => void;
+};
+export type TuiDialogConfirmProps = {
+    title: string;
+    message: string;
+    onConfirm?: () => void;
+    onCancel?: () => void;
+};
+export type TuiDialogPromptProps = {
+    title: string;
+    description?: () => JSX.Element;
+    placeholder?: string;
+    value?: string;
+    busy?: boolean;
+    busyText?: string;
+    onConfirm?: (value: string) => void;
+    onCancel?: () => void;
+};
+export type TuiDialogSelectOption<Value = unknown> = {
+    title: string;
+    value: Value;
+    description?: string;
+    footer?: JSX.Element | string;
+    category?: string;
+    disabled?: boolean;
+    onSelect?: () => void;
+};
+export type TuiDialogSelectProps<Value = unknown> = {
+    title: string;
+    placeholder?: string;
+    options: TuiDialogSelectOption<Value>[];
+    flat?: boolean;
+    onMove?: (option: TuiDialogSelectOption<Value>) => void;
+    onFilter?: (query: string) => void;
+    onSelect?: (option: TuiDialogSelectOption<Value>) => void;
+    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;
+    workspaceID?: 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 TuiThemeCurrent = {
+    readonly primary: RGBA;
+    readonly secondary: RGBA;
+    readonly accent: RGBA;
+    readonly error: RGBA;
+    readonly warning: RGBA;
+    readonly success: RGBA;
+    readonly info: RGBA;
+    readonly text: RGBA;
+    readonly textMuted: RGBA;
+    readonly selectedListItemText: RGBA;
+    readonly background: RGBA;
+    readonly backgroundPanel: RGBA;
+    readonly backgroundElement: RGBA;
+    readonly backgroundMenu: RGBA;
+    readonly border: RGBA;
+    readonly borderActive: RGBA;
+    readonly borderSubtle: RGBA;
+    readonly diffAdded: RGBA;
+    readonly diffRemoved: RGBA;
+    readonly diffContext: RGBA;
+    readonly diffHunkHeader: RGBA;
+    readonly diffHighlightAdded: RGBA;
+    readonly diffHighlightRemoved: RGBA;
+    readonly diffAddedBg: RGBA;
+    readonly diffRemovedBg: RGBA;
+    readonly diffContextBg: RGBA;
+    readonly diffLineNumber: RGBA;
+    readonly diffAddedLineNumberBg: RGBA;
+    readonly diffRemovedLineNumberBg: RGBA;
+    readonly markdownText: RGBA;
+    readonly markdownHeading: RGBA;
+    readonly markdownLink: RGBA;
+    readonly markdownLinkText: RGBA;
+    readonly markdownCode: RGBA;
+    readonly markdownBlockQuote: RGBA;
+    readonly markdownEmph: RGBA;
+    readonly markdownStrong: RGBA;
+    readonly markdownHorizontalRule: RGBA;
+    readonly markdownListItem: RGBA;
+    readonly markdownListEnumeration: RGBA;
+    readonly markdownImage: RGBA;
+    readonly markdownImageText: RGBA;
+    readonly markdownCodeBlock: RGBA;
+    readonly syntaxComment: RGBA;
+    readonly syntaxKeyword: RGBA;
+    readonly syntaxFunction: RGBA;
+    readonly syntaxVariable: RGBA;
+    readonly syntaxString: RGBA;
+    readonly syntaxNumber: RGBA;
+    readonly syntaxType: RGBA;
+    readonly syntaxOperator: RGBA;
+    readonly syntaxPunctuation: RGBA;
+    readonly thinkingOpacity: number;
+};
+export type TuiTheme = {
+    readonly current: TuiThemeCurrent;
+    readonly selected: string;
+    has: (name: string) => boolean;
+    set: (name: string) => boolean;
+    install: (jsonPath: string) => Promise<void>;
+    mode: () => "dark" | "light";
+    readonly ready: boolean;
+};
+export type TuiKV = {
+    get: <Value = unknown>(key: string, fallback?: Value) => Value;
+    set: (key: string, value: unknown) => void;
+    readonly ready: boolean;
+};
+export type TuiState = {
+    readonly ready: boolean;
+    readonly config: SdkConfig;
+    readonly provider: ReadonlyArray<Provider>;
+    readonly path: {
+        state: string;
+        config: string;
+        worktree: string;
+        directory: string;
+    };
+    readonly vcs: {
+        branch?: string;
+    } | undefined;
+    readonly workspace: {
+        list: () => ReadonlyArray<Workspace>;
+        get: (workspaceID: string) => Workspace | undefined;
+    };
+    session: {
+        count: () => number;
+        diff: (sessionID: string) => ReadonlyArray<TuiSidebarFileItem>;
+        todo: (sessionID: string) => ReadonlyArray<TuiSidebarTodoItem>;
+        messages: (sessionID: string) => ReadonlyArray<Message>;
+        status: (sessionID: string) => SessionStatus | undefined;
+        permission: (sessionID: string) => ReadonlyArray<PermissionRequest>;
+        question: (sessionID: string) => ReadonlyArray<QuestionRequest>;
+    };
+    part: (messageID: string) => ReadonlyArray<Part>;
+    lsp: () => ReadonlyArray<TuiSidebarLspItem>;
+    mcp: () => ReadonlyArray<TuiSidebarMcpItem>;
+};
+type TuiConfigView = Pick<PluginConfig, "$schema" | "theme" | "keybinds" | "plugin"> & NonNullable<PluginConfig["tui"]> & {
+    plugin_enabled?: Record<string, boolean>;
+};
+export type TuiApp = {
+    readonly version: string;
+};
+type Frozen<Value> = Value extends (...args: never[]) => unknown ? Value : Value extends ReadonlyArray<infer Item> ? ReadonlyArray<Frozen<Item>> : Value extends object ? {
+    readonly [Key in keyof Value]: Frozen<Value[Key]>;
+} : Value;
+export type TuiSidebarMcpItem = {
+    name: string;
+    status: McpStatus["status"];
+    error?: string;
+};
+export type TuiSidebarLspItem = Pick<LspStatus, "id" | "root" | "status">;
+export type TuiSidebarTodoItem = Pick<Todo, "content" | "status">;
+export type TuiSidebarFileItem = {
+    file: string;
+    additions: number;
+    deletions: number;
+};
+export type TuiHostSlotMap = {
+    app: {};
+    home_logo: {};
+    home_prompt: {
+        workspace_id?: string;
+        ref?: (ref: TuiPromptRef | undefined) => void;
+    };
+    home_prompt_right: {
+        workspace_id?: string;
+    };
+    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;
+        share_url?: string;
+    };
+    sidebar_content: {
+        session_id: string;
+    };
+    sidebar_footer: {
+        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<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;
+        <Slots extends Record<string, object>>(plugin: TuiSlotPlugin<Slots>): string;
+    };
+};
+export type TuiEventBus = {
+    on: <Type extends Event["type"]>(type: Type, handler: (event: Extract<Event, {
+        type: Type;
+    }>) => void) => () => void;
+};
+export type TuiDispose = () => void | Promise<void>;
+export type TuiLifecycle = {
+    readonly signal: AbortSignal;
+    onDispose: (fn: TuiDispose) => () => void;
+};
+export type TuiPluginState = "first" | "updated" | "same";
+export type TuiPluginEntry = {
+    id: string;
+    source: "file" | "npm" | "internal";
+    spec: string;
+    target: string;
+    requested?: string;
+    version?: string;
+    modified?: number;
+    first_time: number;
+    last_time: number;
+    time_changed: number;
+    load_count: number;
+    fingerprint: string;
+};
+export type TuiPluginMeta = TuiPluginEntry & {
+    state: TuiPluginState;
+};
+export type TuiPluginStatus = {
+    id: string;
+    source: TuiPluginEntry["source"];
+    spec: string;
+    target: string;
+    enabled: boolean;
+    active: boolean;
+};
+export type TuiPluginInstallOptions = {
+    global?: boolean;
+};
+export type TuiPluginInstallResult = {
+    ok: true;
+    dir: string;
+    tui: boolean;
+} | {
+    ok: false;
+    message: string;
+    missing?: boolean;
+};
+export type TuiWorkspace = {
+    current: () => string | undefined;
+    set: (workspaceID?: string) => void;
+};
+export type TuiPluginApi = {
+    app: TuiApp;
+    command: {
+        register: (cb: () => TuiCommand[]) => () => void;
+        trigger: (value: string) => void;
+        show: () => void;
+    };
+    route: {
+        register: (routes: TuiRouteDefinition[]) => () => void;
+        navigate: (name: string, params?: Record<string, unknown>) => void;
+        readonly current: TuiRouteCurrent;
+    };
+    ui: {
+        Dialog: (props: TuiDialogProps) => JSX.Element;
+        DialogAlert: (props: TuiDialogAlertProps) => JSX.Element;
+        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;
+    plugins: {
+        list: () => ReadonlyArray<TuiPluginStatus>;
+        activate: (id: string) => Promise<boolean>;
+        deactivate: (id: string) => Promise<boolean>;
+        add: (spec: string) => Promise<boolean>;
+        install: (spec: string, options?: TuiPluginInstallOptions) => Promise<TuiPluginInstallResult>;
+    };
+    lifecycle: TuiLifecycle;
+};
+export type TuiPlugin = (api: TuiPluginApi, options: PluginOptions | undefined, meta: TuiPluginMeta) => Promise<void>;
+export type TuiPluginModule = {
+    id?: string;
+    tui: TuiPlugin;
+    server?: never;
+};

package/dist/tui.js

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@matrix-ai/plugin",
-  "version": "1.6.0",
+  "version": "1.6.1",
   "type": "module",
   "license": "MIT",
   "scripts": {
@@ -16,16 +16,34 @@
     "./tool": {
       "import": "./dist/tool.js",
       "types": "./dist/tool.d.ts"
+    },
+    "./tui": {
+      "import": "./dist/tui.js",
+      "types": "./dist/tui.d.ts"
     }
   },
   "files": [
     "dist"
   ],
   "dependencies": {
-    "@matrix-ai/sdk": "1.6.0",
+    "@matrix-ai/sdk": "1.6.1",
     "zod": "4.1.8"
   },
+  "peerDependencies": {
+    "@opentui/core": ">=0.1.96",
+    "@opentui/solid": ">=0.1.96"
+  },
+  "peerDependenciesMeta": {
+    "@opentui/core": {
+      "optional": true
+    },
+    "@opentui/solid": {
+      "optional": true
+    }
+  },
   "devDependencies": {
+    "@opentui/core": "0.1.96",
+    "@opentui/solid": "0.1.96",
     "@tsconfig/node22": "22.0.2",
     "@types/node": "22.13.9",
     "typescript": "5.8.2",