@oh-my-pi/pi-coding-agent 15.1.0 → 15.1.2

package/dist/types/modes/components/extensions/state-manager.d.ts

@@ -0,0 +1,50 @@
+import type { DashboardState, Extension, FlatTreeItem, ProviderTab, TreeNode } from "./types";
+/**
+ * Settings manager interface for granular toggle persistence.
+ */
+export interface ExtensionSettingsManager {
+    getDisabledExtensions(): string[];
+    setDisabledExtensions(ids: string[]): void;
+}
+/**
+ * Load all extensions from all capabilities.
+ */
+export declare function loadAllExtensions(cwd?: string, disabledIds?: string[]): Promise<Extension[]>;
+/**
+ * Build sidebar tree from extensions.
+ * Groups by provider → kind.
+ */
+export declare function buildSidebarTree(extensions: Extension[]): TreeNode[];
+/**
+ * Flatten tree for keyboard navigation.
+ */
+export declare function flattenTree(tree: TreeNode[]): FlatTreeItem[];
+/**
+ * Apply fuzzy filter to extensions.
+ */
+export declare function applyFilter(extensions: Extension[], query: string): Extension[];
+/**
+ * Build provider tabs from extensions.
+ */
+export declare function buildProviderTabs(extensions: Extension[]): ProviderTab[];
+/**
+ * Filter extensions by provider tab.
+ */
+export declare function filterByProvider(extensions: Extension[], providerId: string): Extension[];
+/**
+ * Apply setting-backed item disable overrides to an existing dashboard state.
+ * This gives the UI immediate feedback while the full capability refresh runs.
+ */
+export declare function applyDisabledExtensionsToState(state: DashboardState, disabledIds: string[]): DashboardState;
+/**
+ * Create initial dashboard state.
+ */
+export declare function createInitialState(cwd?: string, disabledIds?: string[]): Promise<DashboardState>;
+/**
+ * Toggle provider enabled state.
+ */
+export declare function toggleProvider(providerId: string): boolean;
+/**
+ * Refresh state after toggle.
+ */
+export declare function refreshState(state: DashboardState, cwd?: string, disabledIds?: string[]): Promise<DashboardState>;

package/dist/types/modes/components/extensions/types.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Types for the Extension Control Center dashboard.
+ */
+import type { SourceMeta } from "../../../capability/types";
+/**
+ * Extension kinds matching capability types.
+ */
+export type ExtensionKind = "extension-module" | "skill" | "rule" | "tool" | "mcp" | "prompt" | "instruction" | "context-file" | "hook" | "slash-command";
+/**
+ * Extension state (active, disabled, or shadowed).
+ */
+export type ExtensionState = "active" | "disabled" | "shadowed";
+/**
+ * Reason why an extension is disabled.
+ */
+export type DisabledReason = "provider-disabled" | "item-disabled" | "shadowed";
+/**
+ * Unified extension representation for the dashboard.
+ * Normalizes all capability types into a common shape.
+ */
+export interface Extension {
+    /** Unique ID: `${kind}:${name}` */
+    id: string;
+    /** Extension kind */
+    kind: ExtensionKind;
+    /** Extension name */
+    name: string;
+    /** Display name (may differ from name) */
+    displayName: string;
+    /** Description if available */
+    description?: string;
+    /** Trigger pattern (slash command, glob, regex) */
+    trigger?: string;
+    /** Absolute path to source file */
+    path: string;
+    /** Source metadata */
+    source: {
+        provider: string;
+        providerName: string;
+        level: "user" | "project" | "native";
+    };
+    /** Current state */
+    state: ExtensionState;
+    /** Reason for disabled state */
+    disabledReason?: DisabledReason;
+    /** If shadowed, what shadows it */
+    shadowedBy?: string;
+    /** Raw item data for inspector */
+    raw: unknown;
+}
+/**
+ * Tree node types for sidebar hierarchy.
+ */
+export type TreeNodeType = "provider" | "kind" | "item";
+/**
+ * Sidebar tree node.
+ */
+export interface TreeNode {
+    /** Unique ID */
+    id: string;
+    /** Display label */
+    label: string;
+    /** Node type (provider can be toggled, kind groups items) */
+    type: TreeNodeType;
+    /** Whether this node/provider is enabled */
+    enabled: boolean;
+    /** Whether collapsed */
+    collapsed: boolean;
+    /** Child nodes */
+    children: TreeNode[];
+    /** Extension count (for display) */
+    count?: number;
+}
+/**
+ * Flattened tree item for navigation.
+ */
+export interface FlatTreeItem {
+    node: TreeNode;
+    depth: number;
+    index: number;
+}
+/**
+ * Focus region in the tabbed dashboard.
+ */
+export type FocusRegion = "tabs" | "list";
+/**
+ * Provider tab representation.
+ */
+export interface ProviderTab {
+    /** Provider ID (or "all" for the ALL tab) */
+    id: string;
+    /** Display label */
+    label: string;
+    /** Whether provider is enabled (always true for "all") */
+    enabled: boolean;
+    /** Extension count for this provider */
+    count: number;
+}
+/**
+ * Tabbed dashboard state.
+ */
+export interface DashboardState {
+    /** Provider tabs */
+    tabs: ProviderTab[];
+    /** Active tab index */
+    activeTabIndex: number;
+    /** All extensions (unfiltered) */
+    extensions: Extension[];
+    /** Extensions filtered by active tab */
+    tabFiltered: Extension[];
+    /** Extensions filtered by search (applied after tab filter) */
+    searchFiltered: Extension[];
+    /** Current search query */
+    searchQuery: string;
+    /** Selected index in main list */
+    listIndex: number;
+    /** Scroll offset for main list */
+    scrollOffset: number;
+    /** Currently selected extension for inspector */
+    selected: Extension | null;
+}
+/**
+ * @deprecated Use FocusRegion instead
+ */
+export type FocusPane = "sidebar" | "main" | "inspector";
+/**
+ * Callbacks from dashboard to parent.
+ */
+export interface DashboardCallbacks {
+    /** Called when provider is toggled */
+    onProviderToggle: (providerId: string, enabled: boolean) => void;
+    /** Called when extension item is toggled */
+    onExtensionToggle: (extensionId: string, enabled: boolean) => void;
+    /** Called when dashboard is closed */
+    onClose: () => void;
+}
+/**
+ * Create extension ID from kind and name.
+ */
+export declare function makeExtensionId(kind: ExtensionKind, name: string): string;
+/**
+ * Parse extension ID into kind and name.
+ */
+export declare function parseExtensionId(id: string): {
+    kind: ExtensionKind;
+    name: string;
+} | null;
+/**
+ * Map SourceMeta to extension source shape.
+ */
+export declare function sourceFromMeta(meta: SourceMeta): Extension["source"];

package/dist/types/modes/components/footer.d.ts

@@ -0,0 +1,30 @@
+import { type Component } from "@oh-my-pi/pi-tui";
+import type { AgentSession } from "../../session/agent-session";
+/**
+ * Footer component that shows pwd, token stats, and context usage
+ */
+export declare class FooterComponent implements Component {
+    #private;
+    private readonly session;
+    constructor(session: AgentSession);
+    setAutoCompactEnabled(enabled: boolean): void;
+    /**
+     * Set extension status text to display in the footer.
+     * Text is sanitized (newlines/tabs replaced with spaces) and truncated to terminal width.
+     * ANSI escape codes for styling are preserved.
+     * @param key - Unique key to identify this status
+     * @param text - Status text, or undefined to clear
+     */
+    setExtensionStatus(key: string, text: string | undefined): void;
+    /**
+     * Set up a file watcher on .git/HEAD to detect branch changes.
+     * Call the provided callback when branch changes.
+     */
+    watchBranch(onBranchChange: () => void): void;
+    /**
+     * Clean up the file watcher
+     */
+    dispose(): void;
+    invalidate(): void;
+    render(width: number): string[];
+}

package/dist/types/modes/components/history-search.d.ts

@@ -0,0 +1,7 @@
+import { Container } from "@oh-my-pi/pi-tui";
+import type { HistoryStorage } from "../../session/history-storage";
+export declare class HistorySearchComponent extends Container {
+    #private;
+    constructor(historyStorage: HistoryStorage, onSelect: (prompt: string) => void, onCancel: () => void);
+    handleInput(keyData: string): void;
+}

package/dist/types/modes/components/hook-editor.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Multi-line editor component for hooks and ask custom input.
+ * Supports Ctrl+G for external editor.
+ *
+ * Two modes:
+ * - Default (hook): Enter inserts newline, Ctrl+Enter submits, bordered popup
+ * - Prompt-style (ask): Enter submits, Shift+Enter inserts newline, legacy ask chrome
+ */
+import { Container, type TUI } from "@oh-my-pi/pi-tui";
+export interface HookEditorOptions {
+    /** When true, use prompt-style keybindings with the legacy ask prompt chrome. */
+    promptStyle?: boolean;
+}
+export declare class HookEditorComponent extends Container {
+    #private;
+    constructor(tui: TUI, title: string, prefill: string | undefined, onSubmit: (value: string) => void, onCancel: () => void, options?: HookEditorOptions);
+    handleInput(keyData: string): void;
+}

package/dist/types/modes/components/hook-input.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Simple text input component for hooks.
+ */
+import { Container, type TUI } from "@oh-my-pi/pi-tui";
+export interface HookInputOptions {
+    tui?: TUI;
+    timeout?: number;
+    onTimeout?: () => void;
+}
+export declare class HookInputComponent extends Container {
+    #private;
+    constructor(title: string, _placeholder: string | undefined, onSubmit: (value: string) => void, onCancel: () => void, opts?: HookInputOptions);
+    handleInput(keyData: string): void;
+    dispose(): void;
+}

package/dist/types/modes/components/hook-message.d.ts

@@ -0,0 +1,15 @@
+import { Container } from "@oh-my-pi/pi-tui";
+import type { HookMessageRenderer } from "../../extensibility/hooks/types";
+import type { HookMessage } from "../../session/messages";
+/**
+ * Component that renders a custom message entry from hooks.
+ * Uses distinct styling to differentiate from user messages.
+ */
+export declare class HookMessageComponent extends Container {
+    #private;
+    private readonly message;
+    private readonly customRenderer?;
+    constructor(message: HookMessage<unknown>, customRenderer?: HookMessageRenderer | undefined);
+    setExpanded(expanded: boolean): void;
+    invalidate(): void;
+}

package/dist/types/modes/components/hook-selector.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Generic selector component for hooks.
+ * Displays a list of string options with keyboard navigation.
+ */
+import { Container, type TUI } from "@oh-my-pi/pi-tui";
+export interface HookSelectorOptions {
+    tui?: TUI;
+    timeout?: number;
+    onTimeout?: () => void;
+    initialIndex?: number;
+    outline?: boolean;
+    maxVisible?: number;
+    onLeft?: () => void;
+    onRight?: () => void;
+    onExternalEditor?: () => void;
+    helpText?: string;
+}
+export declare class HookSelectorComponent extends Container {
+    #private;
+    constructor(title: string, options: string[], onSelect: (option: string) => void, onCancel: () => void, opts?: HookSelectorOptions);
+    handleInput(keyData: string): void;
+    dispose(): void;
+}

package/dist/types/modes/components/index.d.ts

@@ -0,0 +1,35 @@
+export * from "./assistant-message";
+export * from "./bash-execution";
+export * from "./bordered-loader";
+export * from "./branch-summary-message";
+export * from "./compaction-summary-message";
+export * from "./countdown-timer";
+export * from "./custom-editor";
+export * from "./custom-message";
+export * from "./diff";
+export * from "./dynamic-border";
+export * from "./footer";
+export * from "./hook-editor";
+export * from "./hook-input";
+export * from "./hook-message";
+export * from "./hook-selector";
+export * from "./keybinding-hints";
+export * from "./login-dialog";
+export * from "./model-selector";
+export * from "./oauth-selector";
+export * from "./queue-mode-selector";
+export * from "./read-tool-group";
+export * from "./session-selector";
+export * from "./settings-selector";
+export * from "./show-images-selector";
+export * from "./status-line";
+export * from "./theme-selector";
+export * from "./thinking-selector";
+export * from "./todo-reminder";
+export * from "./tool-execution";
+export * from "./tree-selector";
+export * from "./ttsr-notification";
+export * from "./user-message";
+export * from "./user-message-selector";
+export * from "./visual-truncate";
+export * from "./welcome";

package/dist/types/modes/components/keybinding-hints.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Utilities for formatting keybinding hints in the UI.
+ */
+import { type Keybinding } from "@oh-my-pi/pi-tui";
+import type { AppKeybinding, KeybindingsManager } from "../../config/keybindings";
+/**
+ * Get display string for an editor action.
+ */
+export declare function editorKey(action: Keybinding): string;
+/**
+ * Get display string for an app action.
+ */
+export declare function appKey(keybindings: KeybindingsManager, action: AppKeybinding): string;
+/**
+ * Format a keybinding hint with consistent styling: dim key, muted description.
+ * Looks up the key from editor keybindings automatically.
+ *
+ * @param action - Keybinding action name (e.g., "tui.select.confirm", "app.tools.expand")
+ * @param description - Description text (e.g., "to expand", "cancel")
+ * @returns Formatted string with dim key and muted description
+ */
+export declare function keyHint(action: Keybinding, description: string): string;
+/**
+ * Format a keybinding hint for app-level actions.
+ * Requires the KeybindingsManager instance.
+ *
+ * @param keybindings - KeybindingsManager instance
+ * @param action - App keybinding name (e.g., "app.interrupt", "app.editor.external")
+ * @param description - Description text
+ * @returns Formatted string with dim key and muted description
+ */
+export declare function appKeyHint(keybindings: KeybindingsManager, action: AppKeybinding, description: string): string;
+/**
+ * Format a raw key string with description (for non-configurable keys like ↑↓).
+ *
+ * @param key - Raw key string
+ * @param description - Description text
+ * @returns Formatted string with dim key and muted description
+ */
+export declare function rawKeyHint(key: string, description: string): string;

package/dist/types/modes/components/login-dialog.d.ts

@@ -0,0 +1,32 @@
+import { Container, type TUI } from "@oh-my-pi/pi-tui";
+/**
+ * Login dialog component - replaces editor during OAuth login flow
+ */
+export declare class LoginDialogComponent extends Container {
+    #private;
+    private onComplete;
+    constructor(tui: TUI, providerId: string, onComplete: (success: boolean, message?: string) => void);
+    get signal(): AbortSignal;
+    /**
+     * Called by onAuth callback - show URL and optional instructions
+     */
+    showAuth(url: string, instructions?: string): void;
+    /**
+     * Show input for manual code/URL entry (for callback server providers)
+     */
+    showManualInput(prompt: string): Promise<string>;
+    /**
+     * Called by onPrompt callback - show prompt and wait for input
+     * Note: Does NOT clear content, appends to existing (preserves URL from showAuth)
+     */
+    showPrompt(message: string, placeholder?: string): Promise<string>;
+    /**
+     * Show waiting message (for polling flows like GitHub Copilot)
+     */
+    showWaiting(message: string): void;
+    /**
+     * Called by onProgress callback
+     */
+    showProgress(message: string): void;
+    handleInput(data: string): void;
+}

package/dist/types/modes/components/mcp-add-wizard.d.ts

@@ -0,0 +1,25 @@
+/**
+ * MCP Add Wizard Component
+ *
+ * Interactive multi-step wizard for adding MCP servers.
+ */
+import { Container } from "@oh-my-pi/pi-tui";
+import type { MCPServerConfig } from "../../mcp/types";
+type Scope = "user" | "project";
+/**
+ * Result of the wizard's OAuth callback. `credentialId` is mandatory;
+ * `clientId`/`clientSecret` are populated when the OAuth provider performed
+ * dynamic client registration (or when the caller pre-supplied them) so the
+ * wizard can fold them into the final `mcp.json` entry for refresh.
+ */
+export interface MCPAddWizardOAuthResult {
+    credentialId: string;
+    clientId?: string;
+    clientSecret?: string;
+}
+export declare class MCPAddWizard extends Container {
+    #private;
+    constructor(onComplete: (name: string, config: MCPServerConfig, scope: Scope) => void, onCancel: () => void, onOAuth?: (authUrl: string, tokenUrl: string, clientId: string, clientSecret: string, scopes: string) => Promise<MCPAddWizardOAuthResult>, onTestConnection?: (config: MCPServerConfig) => Promise<void>, onRender?: () => void, initialName?: string);
+    handleInput(keyData: string): void;
+}
+export {};

package/dist/types/modes/components/message-frame.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Shared rendering for extension/hook custom message frames.
+ *
+ * Both `CustomMessageComponent` and `HookMessageComponent` wrap a
+ * `Spacer(1) + Box` layout, try a user-supplied renderer first, and fall
+ * back to a label + markdown body when the renderer returns nothing or
+ * throws. The only meaningful difference is that hook messages collapse to
+ * the first N lines when not expanded; extension messages render in full.
+ */
+import type { TextContent } from "@oh-my-pi/pi-ai";
+import type { Box, Component } from "@oh-my-pi/pi-tui";
+import { type Theme } from "../../modes/theme/theme";
+/** Message shape consumed by the shared frame. */
+export interface FramedMessage {
+    customType: string;
+    content: string | (TextContent | {
+        type: string;
+    })[];
+}
+/**
+ * Callable signature shared by `MessageRenderer` (extensions) and
+ * `HookMessageRenderer` (hooks). Both narrow `message` to their own type;
+ * this signature is the structural intersection callers can hand off here.
+ */
+export type FramedRenderer<M extends FramedMessage> = (message: M, options: {
+    expanded: boolean;
+}, theme: Theme) => Component | undefined;
+export interface RebuildFrameOptions<M extends FramedMessage> {
+    message: M;
+    box: Box;
+    expanded: boolean;
+    /** Collapse the markdown body to this many lines when `expanded` is false. Omit to never collapse. */
+    collapseAfterLines?: number;
+    customRenderer?: FramedRenderer<M>;
+}
+/**
+ * Attempt the custom renderer; on failure or undefined return, populate
+ * `box` with the default `[customType]` label + markdown body and return
+ * undefined. When the custom renderer succeeds, return its Component so the
+ * caller can mount it and skip the default box.
+ */
+export declare function renderFramedMessage<M extends FramedMessage>(opts: RebuildFrameOptions<M>): Component | undefined;

package/dist/types/modes/components/model-selector.d.ts

@@ -0,0 +1,26 @@
+import { ThinkingLevel } from "@oh-my-pi/pi-agent-core";
+import { type Model } from "@oh-my-pi/pi-ai";
+import { Container, Input, type TUI } from "@oh-my-pi/pi-tui";
+import type { ModelRegistry } from "../../config/model-registry";
+import type { Settings } from "../../config/settings";
+interface ScopedModelItem {
+    model: Model;
+    thinkingLevel?: string;
+}
+/**
+ * Component that renders a model selector with provider tabs and context menu.
+ * - Tab/Arrow Left/Right: Switch between provider tabs
+ * - Arrow Up/Down: Navigate model list
+ * - Enter: Open context menu to select action
+ * - Escape: Close menu or selector
+ */
+export declare class ModelSelectorComponent extends Container {
+    #private;
+    constructor(tui: TUI, _currentModel: Model | undefined, settings: Settings, modelRegistry: ModelRegistry, scopedModels: ReadonlyArray<ScopedModelItem>, onSelect: (model: Model, role: string | null, thinkingLevel?: ThinkingLevel, selector?: string) => void, onCancel: () => void, options?: {
+        temporaryOnly?: boolean;
+        initialSearchInput?: string;
+    });
+    handleInput(keyData: string): void;
+    getSearchInput(): Input;
+}
+export {};

package/dist/types/modes/components/oauth-selector.d.ts

@@ -0,0 +1,14 @@
+import { Container } from "@oh-my-pi/pi-tui";
+import type { AuthStorage } from "../../session/auth-storage";
+/**
+ * Component that renders an OAuth provider selector.
+ */
+export declare class OAuthSelectorComponent extends Container {
+    #private;
+    constructor(mode: "login" | "logout", authStorage: AuthStorage, onSelect: (providerId: string) => void, onCancel: () => void, options?: {
+        validateAuth?: (providerId: string) => Promise<boolean>;
+        requestRender?: () => void;
+    });
+    stopValidation(): void;
+    handleInput(keyData: string): void;
+}

package/dist/types/modes/components/plugin-selector.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Interactive marketplace plugin selector.
+ *
+ * Shows available plugins from all configured marketplaces in a SelectList.
+ * Selecting a plugin triggers installation. Esc cancels.
+ */
+import { Container, SelectList } from "@oh-my-pi/pi-tui";
+export interface PluginSelectorCallbacks {
+    onSelect: (pluginName: string, marketplace: string, scope?: "user" | "project") => void;
+    onCancel: () => void;
+}
+export interface PluginItem {
+    plugin: {
+        name: string;
+        version?: string;
+        description?: string;
+    };
+    marketplace: string;
+    /** Scope of this entry. When set, appended to the label and forwarded to onSelect. */
+    scope?: "user" | "project";
+}
+export declare class PluginSelectorComponent extends Container {
+    #private;
+    constructor(marketplaceCount: number, plugins: PluginItem[], installedIds: Set<string>, callbacks: PluginSelectorCallbacks);
+    getSelectList(): SelectList;
+}

package/dist/types/modes/components/plugin-settings.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Plugin settings UI components.
+ *
+ * Provides a hierarchical settings interface:
+ * - Plugin list (shows all installed plugins)
+ *   - Plugin detail (enable/disable, features, config)
+ *     - Feature toggles
+ *     - Config value editor
+ */
+import { Container } from "@oh-my-pi/pi-tui";
+import { PluginManager } from "../../extensibility/plugins/manager";
+import type { InstalledPlugin } from "../../extensibility/plugins/types";
+/**
+ * Forwards a keystroke to `input`, but cancels via `onCancel` when the user presses Escape.
+ */
+export declare function handleInputOrEscape(data: string, input: {
+    handleInput(data: string): void;
+}, onCancel: () => void): void;
+export interface PluginListCallbacks {
+    onPluginSelect: (plugin: InstalledPlugin) => void;
+    onCancel: () => void;
+}
+/**
+ * Shows list of installed plugins with enable/disable status.
+ * Selecting a plugin opens its detail view.
+ */
+export declare class PluginListComponent extends Container {
+    #private;
+    private readonly plugins;
+    constructor(plugins: InstalledPlugin[], callbacks: PluginListCallbacks);
+    handleInput(data: string): void;
+}
+export interface PluginDetailCallbacks {
+    onEnabledChange: (enabled: boolean) => void;
+    onFeatureChange: (feature: string, enabled: boolean) => void;
+    onConfigChange: (key: string, value: unknown) => void;
+    onBack: () => void;
+}
+/**
+ * Shows detail settings for a single plugin:
+ * - Enable/disable toggle
+ * - Feature toggles
+ * - Config settings
+ */
+export declare class PluginDetailComponent extends Container {
+    #private;
+    private plugin;
+    private readonly manager;
+    private readonly callbacks;
+    constructor(plugin: InstalledPlugin, manager: PluginManager, callbacks: PluginDetailCallbacks);
+    handleInput(data: string): void;
+}
+export interface PluginSettingsCallbacks {
+    onClose: () => void;
+    onPluginChanged: () => void;
+}
+/**
+ * Top-level plugin settings component.
+ * Manages navigation between plugin list and plugin detail views.
+ */
+export declare class PluginSettingsComponent extends Container {
+    #private;
+    private readonly callbacks;
+    constructor(cwd: string, callbacks: PluginSettingsCallbacks);
+    handleInput(data: string): void;
+}

package/dist/types/modes/components/queue-mode-selector.d.ts

@@ -0,0 +1,9 @@
+import { Container, SelectList } from "@oh-my-pi/pi-tui";
+/**
+ * Component that renders a queue mode selector with borders
+ */
+export declare class QueueModeSelectorComponent extends Container {
+    #private;
+    constructor(currentMode: "all" | "one-at-a-time", onSelect: (mode: "all" | "one-at-a-time") => void, onCancel: () => void);
+    getSelectList(): SelectList;
+}

package/dist/types/modes/components/read-tool-group.d.ts

@@ -0,0 +1,30 @@
+import type { Component } from "@oh-my-pi/pi-tui";
+import { Container } from "@oh-my-pi/pi-tui";
+import type { ToolExecutionHandle } from "./tool-execution";
+export declare function readArgsHaveTarget(args: unknown): boolean;
+export declare function readArgsTargetInternalUrl(args: unknown): boolean;
+type ReadRenderArgs = {
+    path?: string;
+    file_path?: string;
+    sel?: string;
+};
+type ReadToolGroupOptions = {
+    showContentPreview?: boolean;
+};
+export declare class ReadToolGroupComponent extends Container implements ToolExecutionHandle {
+    #private;
+    constructor(options?: ReadToolGroupOptions);
+    updateArgs(args: ReadRenderArgs, toolCallId?: string): void;
+    updateResult(result: {
+        content: Array<{
+            type: string;
+            text?: string;
+        }>;
+        details?: unknown;
+        isError?: boolean;
+    }, isPartial?: boolean, toolCallId?: string): void;
+    setArgsComplete(_toolCallId?: string): void;
+    setExpanded(expanded: boolean): void;
+    getComponent(): Component;
+}
+export {};