@rtc-agent/component 0.2.7-rc.3 → 0.2.8-rc.0

package/dist/controllers/toast.controller.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Toast Controller
+ *
+ * Manages toast notifications: show, auto-dismiss, manual remove.
+ * Extracted from <rtc-agent> root component to keep it under 300 lines.
+ *
+ * No context — toast state is consumed only by <rtc-toast> via root render.
+ */
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+import type { ToastItem, ToastType, ToastAction } from '../components/overlay/rtc-toast.js';
+export type { ToastItem, ToastType, ToastAction } from '../components/overlay/rtc-toast.js';
+export interface ToastActions {
+    show: (message: string, type?: ToastType, action?: ToastAction) => void;
+    remove: (id: number) => void;
+}
+export declare class ToastController implements ReactiveController {
+    private _host;
+    private _toasts;
+    /** Active auto-dismiss timers, keyed by toast ID */
+    private _timers;
+    readonly actions: ToastActions;
+    get toasts(): readonly ToastItem[];
+    constructor(host: ReactiveControllerHost);
+    hostConnected(): void;
+    hostDisconnected(): void;
+    private _show;
+    private _remove;
+}
+//# sourceMappingURL=toast.controller.d.ts.map

package/dist/controllers/toast.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast.controller.d.ts","sourceRoot":"","sources":["../../src/controllers/toast.controller.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAC,kBAAkB,EAAE,sBAAsB,EAAC,MAAM,KAAK,CAAC;AACpE,OAAO,KAAK,EAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAC,MAAM,oCAAoC,CAAC;AAE1F,YAAY,EAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAC,MAAM,oCAAoC,CAAC;AAE1F,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,IAAI,CAAC;IACxE,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAED,qBAAa,eAAgB,YAAW,kBAAkB;IACtD,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,OAAO,CAAmB;IAClC,oDAAoD;IACpD,OAAO,CAAC,OAAO,CAAoD;IAEnE,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAE/B,IAAI,MAAM,IAAI,SAAS,SAAS,EAAE,CAEjC;gBAEW,IAAI,EAAE,sBAAsB;IASxC,aAAa;IAEb,gBAAgB;IAchB,OAAO,CAAC,KAAK;IAab,OAAO,CAAC,OAAO;CAUlB"}

package/dist/controllers/tool-call.controller.d.ts

@@ -0,0 +1,38 @@
+/**
+ * ToolCall Controller
+ *
+ * Encapsulates tool call state machine: pending -> approved | denied.
+ * Supports approving individual calls or all calls for a given tool name.
+ * Dispatches `rtc-tool-call-*` events for external consumers.
+ *
+ * Also exposes `addPendingCall()` for the demo page and future protocol layer
+ * to inject new tool calls into the pending queue.
+ *
+ * Corresponds to: `toolCallContext` (defined in `contexts/tool-call.ts`).
+ * Provided by: `<rtc-agent>` (root)
+ * Consumed by: `<rtc-tool-confirm>`, `<rtc-overlay-manager>`
+ */
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+import type { ToolCall, ToolCallActions } from '../types/index.js';
+import type { ToolCallContextValue } from '../contexts/tool-call.js';
+export declare class ToolCallController implements ReactiveController {
+    host: ReactiveControllerHost & EventTarget;
+    private _state;
+    readonly actions: ToolCallActions;
+    get value(): ToolCallContextValue;
+    constructor(host: ReactiveControllerHost & EventTarget);
+    hostConnected(): void;
+    hostDisconnected(): void;
+    /**
+     * Add a pending tool call.
+     *
+     * **Note**: This method is not in the `ToolCallActions` interface and is not exposed via Context.
+     * It is only for direct use by the protocol layer (future) and demo page (task19) calling the Controller.
+     * User-triggered tool call operations (approve/deny) still go through Context actions.
+     */
+    addPendingCall(call: ToolCall): void;
+    private _approve;
+    private _approveAll;
+    private _deny;
+}
+//# sourceMappingURL=tool-call.controller.d.ts.map

package/dist/controllers/tool-call.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-call.controller.d.ts","sourceRoot":"","sources":["../../src/controllers/tool-call.controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAC,kBAAkB,EAAE,sBAAsB,EAAC,MAAM,KAAK,CAAC;AACpE,OAAO,KAAK,EAAC,QAAQ,EAAiB,eAAe,EAAC,MAAM,mBAAmB,CAAC;AAChF,OAAO,KAAK,EAAC,oBAAoB,EAAC,MAAM,0BAA0B,CAAC;AAGnE,qBAAa,kBAAmB,YAAW,kBAAkB;IACzD,IAAI,EAAE,sBAAsB,GAAG,WAAW,CAAC;IAE3C,OAAO,CAAC,MAAM,CAA+C;IAE7D,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAElC,IAAI,KAAK,IAAI,oBAAoB,CAEhC;gBAEW,IAAI,EAAE,sBAAsB,GAAG,WAAW;IAUtD,aAAa;IACb,gBAAgB;IAEhB;;;;;;OAMG;IACH,cAAc,CAAC,IAAI,EAAE,QAAQ;IAO7B,OAAO,CAAC,QAAQ;IAchB,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,KAAK;CAYhB"}

package/dist/controllers/window-interaction.controller.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Window Interaction Controller
+ *
+ * Manages drag-to-move, resize, and keyboard controls for the floating window.
+ * Does NOT own position/size state — delegates to WindowStateController via callbacks.
+ *
+ * Features:
+ * - Drag via title bar (mouse/touch)
+ * - Resize from 8 directions (4 corners + 4 edges)
+ * - Keyboard controls with explicit mode activation
+ * - Viewport boundary constraints
+ * - Reduced motion support
+ *
+ * @example
+ * ```typescript
+ * const controller = new WindowInteractionController(this);
+ *
+ * // After Shadow DOM ready
+ * controller.bindElements(this, titleBarElement);
+ *
+ * // Wire callbacks to WindowStateController
+ * controller.onPositionChange = (x, y) => windowState.actions.setPosition(x, y);
+ * controller.onSizeChange = (w, h) => windowState.actions.setSize(w, h);
+ *
+ * controller.actions.enable();
+ * ```
+ */
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+export interface InteractionState {
+    isDragging: boolean;
+    isResizing: boolean;
+    interactionMode: 'none' | 'move' | 'resize';
+}
+export interface InteractionActions {
+    enable(): void;
+    disable(): void;
+    enterMoveMode(): void;
+    enterResizeMode(): void;
+    exitInteractionMode(): void;
+}
+export interface WindowInteractionValue {
+    state: InteractionState;
+    actions: InteractionActions;
+}
+export declare class WindowInteractionController implements ReactiveController {
+    value: WindowInteractionValue;
+    onPositionChange?: (x: number, y: number) => void;
+    onSizeChange?: (width: number, height: number) => void;
+    private _host;
+    private _windowElement?;
+    private _titleBarElement?;
+    private _state;
+    private _isEnabled;
+    /** Window configuration */
+    private _draggable;
+    private _resizable;
+    /** Defer config update (cache during interaction) */
+    private _pendingConfig?;
+    /** Ghost preview element (lightweight visual feedback during drag/resize) */
+    private _ghostElement?;
+    /** Ghost start state (used to compute delta) */
+    private _ghostStartRect?;
+    /** Cumulative drag offset (during drag) */
+    private _ghostDragOffset;
+    /** Cached margin value (reused during drag/resize to avoid repeated getComputedStyle calls) */
+    private _cachedMargin;
+    /** Bound keydown handler — stored so it can be removed on cleanup. */
+    private _boundOnKeydown;
+    constructor(host: ReactiveControllerHost, config?: {
+        draggable?: boolean;
+        resizable?: boolean;
+    });
+    /** Update config */
+    setConfig(config: {
+        draggable?: boolean;
+        resizable?: boolean;
+    }): void;
+    /** Whether dragging is allowed */
+    get draggable(): boolean;
+    /** Whether resizing is allowed */
+    get resizable(): boolean;
+    /**
+     * Bind DOM elements after Shadow DOM is ready.
+     * Must be called before enable().
+     */
+    bindElements(windowElement: HTMLElement, titleBarElement: HTMLElement): void;
+    hostConnected(): void;
+    hostDisconnected(): void;
+    /**
+     * Cleanup interact.js instances and ghost element.
+     */
+    destroy(): void;
+    private _enable;
+    private _disable;
+    private _initInteractions;
+    private _initDrag;
+    private _initResize;
+    private _initKeyboard;
+    /**
+     * Keyboard handler for title bar interactions.
+     *
+     * - Enter/Space: activate move mode
+     * - Arrow keys (in move mode): nudge window position
+     * - Escape: exit interaction mode
+     */
+    private _handleKeydown;
+    private _enterMoveMode;
+    private _enterResizeMode;
+    private _exitInteractionMode;
+    private _onDragStart;
+    private _onDragMove;
+    private _onDragEnd;
+    private _onResizeStart;
+    private _onResizeMove;
+    private _onResizeEnd;
+    private _getMargin;
+    private _getMinSize;
+    /**
+     * Create Ghost preview element
+     *
+     * Creates a lightweight dashed-border element in document.body
+     * to provide visual feedback during drag/resize, avoiding Lit re-renders.
+     */
+    private _createGhostElement;
+    /**
+     * Destroy Ghost preview element
+     */
+    private _destroyGhostElement;
+}
+//# sourceMappingURL=window-interaction.controller.d.ts.map

package/dist/controllers/window-interaction.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"window-interaction.controller.d.ts","sourceRoot":"","sources":["../../src/controllers/window-interaction.controller.ts"],"names":[],"mappings":"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"}

package/dist/controllers/window-state.controller.d.ts

@@ -0,0 +1,79 @@
+/**
+ * WindowState Controller
+ *
+ * Encapsulates floating-window state logic: mode, position, size, and restore.
+ * Extracted from <rtc-agent> root component to keep it under 300 lines.
+ *
+ * Corresponds to: `windowStateContext` (defined in `contexts/window-state.ts`).
+ * Provided by: `<rtc-agent>` (root)
+ * Consumed by: `<rtc-title-bar>`, `<rtc-content-wrapper>`
+ */
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+import type { WindowStateActions } from '../types/index.js';
+import type { WindowStateContextValue } from '../contexts/window-state.js';
+import type { ResolvedWindowConfig } from '../types/window-config.js';
+export declare class WindowStateController implements ReactiveController {
+    host: ReactiveControllerHost;
+    private _state;
+    /** Whether state was restored from localStorage (used to skip initial position setup). */
+    private _restored;
+    /** Window configuration */
+    private _config;
+    /** Callback when viewport is too small for the window (triggers auto-minimize). */
+    onViewportTooSmall?: () => void;
+    readonly actions: WindowStateActions;
+    get value(): WindowStateContextValue;
+    /** Whether window state was restored from localStorage. */
+    get restored(): boolean;
+    constructor(host: ReactiveControllerHost, config?: ResolvedWindowConfig);
+    /** Update config */
+    setConfig(config: ResolvedWindowConfig): void;
+    /** Get config */
+    get config(): ResolvedWindowConfig;
+    hostConnected(): void;
+    hostDisconnected(): void;
+    /** Viewport resize handler — bound once in constructor. */
+    private _boundOnViewportResize;
+    /**
+     * Handle viewport resize (e.g. DevTools open/close/resize).
+     *
+     * - embedded: no action (fills parent container via CSS)
+     * - minimized: recalculate bubble position from bubblePosition config + new viewport size
+     * - normal: clamp position to keep window visible; auto-minimize if viewport too small
+     * - maximized: no action needed (CSS inset:0 handles it)
+     */
+    private _handleViewportResize;
+    private _restoreState;
+    /**
+     * Clamp window position and size to current viewport bounds
+     *
+     * After refresh, browser devtools/zoom level may have changed;
+     * directly restoring the last position may cause the window to overflow the viewport (e.g., obscured by right-side devtools).
+     */
+    private _clampToViewport;
+    private _persistState;
+    private _setMode;
+    /**
+     * Calculate initial window state based on bubblePosition.corner
+     *
+     * The corner determines which corner of the window aligns with the bubble position:
+     * - bottom-right: window's bottom-right aligns with bubble (expand to upper-left)
+     * - top-left: window's top-left aligns with bubble (expand to lower-right)
+     * - etc.
+     */
+    private _calculateInitialWindowState;
+    private _updateState;
+    /**
+     * Apply position/size state to a host element as inline styles.
+     *
+     * Inline styles override CSS rules (including :host([data-mode=...])),
+     * so we clear them when leaving 'normal' mode to let CSS take over.
+     *
+     * When the host has `data-embedded` attribute, skip all inline geometry —
+     * the component fills its parent container via CSS (position: relative).
+     *
+     * @param el - The host element to apply geometry to (typically the root component).
+     */
+    applyGeometry(el: HTMLElement): void;
+}
+//# sourceMappingURL=window-state.controller.d.ts.map

package/dist/controllers/window-state.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"window-state.controller.d.ts","sourceRoot":"","sources":["../../src/controllers/window-state.controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAC,kBAAkB,EAAE,sBAAsB,EAAC,MAAM,KAAK,CAAC;AACpE,OAAO,KAAK,EAER,kBAAkB,EAErB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAC,uBAAuB,EAAC,MAAM,6BAA6B,CAAC;AAGzE,OAAO,KAAK,EAAC,oBAAoB,EAAC,MAAM,2BAA2B,CAAC;AAQpE,qBAAa,qBAAsB,YAAW,kBAAkB;IAC5D,IAAI,EAAE,sBAAsB,CAAC;IAE7B,OAAO,CAAC,MAAM,CAA0C;IACxD,0FAA0F;IAC1F,OAAO,CAAC,SAAS,CAAS;IAC1B,2BAA2B;IAC3B,OAAO,CAAC,OAAO,CAAuB;IACtC,mFAAmF;IACnF,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;IAEhC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IAErC,IAAI,KAAK,IAAI,uBAAuB,CAEnC;IAED,2DAA2D;IAC3D,IAAI,QAAQ,IAAI,OAAO,CAEtB;gBAEW,IAAI,EAAE,sBAAsB,EAAE,MAAM,CAAC,EAAE,oBAAoB;IA+BvE,oBAAoB;IACpB,SAAS,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI;IAS7C,iBAAiB;IACjB,IAAI,MAAM,IAAI,oBAAoB,CAEjC;IAED,aAAa;IAIb,gBAAgB;IAIhB,2DAA2D;IAC3D,OAAO,CAAC,sBAAsB,CAAsC;IAEpE;;;;;;;OAOG;IACH,OAAO,CAAC,qBAAqB;IA0D7B,OAAO,CAAC,aAAa;IAgCrB;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAsBxB,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,QAAQ;IAkBhB;;;;;;;OAOG;IACH,OAAO,CAAC,4BAA4B;IA4CpC,OAAO,CAAC,YAAY;IAMpB;;;;;;;;;;OAUG;IACH,aAAa,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI;CA+HvC"}

package/dist/core/builtin-system-group.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Built-in system tool group
+ *
+ * Registered by default to every FunctionRegistry, providing commonly used system-level utility functions for scripts.
+ * These functions wrap gray-area APIs blocked by the sandbox (setTimeout, crypto.randomUUID, etc.),
+ * exposing them to scripts via rtcAgent.system.* so the LLM doesn't need direct access to platform APIs.
+ *
+ * Registration: follows the standard FunctionDef specification and auto-generates virtual docs (/functions/system/*.md)
+ * The LLM discovers these functions via /AGENT.md -> /functions/INDEX.md.
+ *
+ * Note: This file demonstrates Zod schema registration (recommended), while remaining compatible with OpenAPI Schema.
+ */
+import type { FunctionDef } from '../types/skill.js';
+import type { FunctionRegistry } from './function-registry.js';
+/**
+ * system group definition
+ */
+export declare const SYSTEM_GROUP_DEF: {
+    name: string;
+    description: string;
+};
+/**
+ * Register the built-in system tool group to the registry
+ *
+ * Uses the standard createGroup + group.register flow to auto-generate virtual docs.
+ * Should be called automatically in defineRegistry() so all registries have the system group by default.
+ */
+export declare function registerBuiltinSystemGroup(registry: FunctionRegistry): void;
+/**
+ * system.delay(ms) — Promise-based sleep
+ *
+ * Wraps setTimeout, subject to script timeout control (Promise.race rejects on script timeout).
+ *
+ * Uses Zod schema for parameter definition (recommended)
+ */
+export declare const DELAY_DEF: FunctionDef;
+/**
+ * system.uuid() — Generate UUID v4
+ *
+ * Uses crypto.randomUUID() (supported by all modern browsers).
+ *
+ * Uses Zod schema for parameter definition (recommended)
+ */
+export declare const UUID_DEF: FunctionDef;
+/**
+ * system.now() — Current timestamp
+ */
+export declare const NOW_DEF: FunctionDef;
+/**
+ * system.random(options?) — Random number generation
+ *
+ * Uses Zod schema for parameter definition (recommended)
+ * Uses withMeta to add example values
+ */
+export declare const RANDOM_DEF: FunctionDef;
+/**
+ * system.time(format?) — Formatted current time
+ *
+ * Uses Zod schema for parameter definition (recommended)
+ */
+export declare const TIME_DEF: FunctionDef;
+/**
+ * system.timezone() — Get local timezone information
+ *
+ * Returns the local timezone's IANA name (e.g. 'Asia/Shanghai') and current UTC offset.
+ * Uses Intl.DateTimeFormat API, no third-party library needed.
+ */
+export declare const TIMEZONE_DEF: FunctionDef;
+/**
+ * All built-in system function definitions
+ */
+export declare const SYSTEM_FUNCTIONS: FunctionDef[];
+//# sourceMappingURL=builtin-system-group.d.ts.map

package/dist/core/builtin-system-group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-system-group.d.ts","sourceRoot":"","sources":["../../src/core/builtin-system-group.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG/D;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;CAG5B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAQ3E;AAED;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,EAAE,WAyBvB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,EAAE,WAqBtB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,WAWrB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,UAAU,EAAE,WAwBxB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,WAuBtB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,WAsB1B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,WAAW,EAOzC,CAAC"}

package/dist/core/event-bus.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Event Bus
+ *
+ * Simple event bus for decoupling FunctionRegistry and UI.
+ *
+ * Usage scenarios:
+ * - FunctionRegistry emits function:start/success/error/progress events
+ * - UI layer listens to events and displays toast/confirm/progress
+ * - Host applications (Flutter) listen to events and forward via postMessage
+ */
+/**
+ * Event handler type
+ */
+export type EventHandler<T = unknown> = (event: T) => void | Promise<void>;
+/**
+ * MD8: Event map interface - provides type safety for event names
+ *
+ * Usage:
+ * ```ts
+ * interface MyEvents {
+ *   'user:login': { userId: string };
+ *   'user:logout': void;
+ * }
+ * const bus = createEventBus<MyEvents>();
+ * bus.on('user:login', (event) => { ... }); // event type is { userId: string }
+ * ```
+ */
+export interface DefaultEventMap {
+    [event: string]: unknown;
+}
+/**
+ * Event bus
+ *
+ * @typeParam TEventMap - Mapping from event names to data types (MD8)
+ */
+export declare class EventBus<TEventMap extends DefaultEventMap = DefaultEventMap> {
+    private handlers;
+    /**
+     * Subscribe to event
+     *
+     * @returns Unsubscribe function
+     */
+    on<K extends keyof TEventMap & string>(event: K, handler: EventHandler<TEventMap[K]>): () => void;
+    /**
+     * Subscribe to one-time event
+     */
+    once<K extends keyof TEventMap & string>(event: K, handler: EventHandler<TEventMap[K]>): () => void;
+    /**
+     * Unsubscribe
+     */
+    off<K extends keyof TEventMap & string>(event: K, handler: EventHandler<TEventMap[K]>): void;
+    /**
+     * Emit event (synchronous)
+     *
+     * M8: Snapshot handlers (Array.from) before iteration to avoid concurrent modification when handler calls off
+     */
+    emit<K extends keyof TEventMap & string>(event: K, data: TEventMap[K]): void;
+    /**
+     * Emit event (async, wait for all handlers to complete)
+     *
+     * M9: Note: this method always resolves; errors in handlers are caught and output via log.error.
+     * If error propagation is needed (handler errors cause emitAsync to reject), use emitAsyncStrict.
+     */
+    emitAsync<K extends keyof TEventMap & string>(event: K, data: TEventMap[K]): Promise<void>;
+    /**
+     * M9: Strict async event emit - handler errors cause Promise rejection
+     *
+     * Unlike emitAsync, this method does not swallow errors from handlers.
+     * If any handler throws, the returned Promise will reject.
+     */
+    emitAsyncStrict<K extends keyof TEventMap & string>(event: K, data: TEventMap[K]): Promise<void>;
+    /**
+     * m6: Clear all handlers for all events (renamed to clearAll for symmetry with clearEvent)
+     */
+    clearAll(): void;
+    /**
+     * Clear all handlers for a specific event
+     */
+    clearEvent(event: string): void;
+}
+/**
+ * Function execution related events
+ */
+export interface FunctionStartEvent {
+    path: string;
+    params: Record<string, unknown>;
+}
+export interface FunctionSuccessEvent {
+    path: string;
+    result: unknown;
+}
+export interface FunctionErrorEvent {
+    path: string;
+    error: Error;
+}
+export interface FunctionProgressEvent {
+    path: string;
+    progress: number;
+}
+/**
+ * MD8: Event map used by FunctionRegistry
+ */
+export interface FunctionRegistryEventMap extends DefaultEventMap {
+    'function:start': FunctionStartEvent;
+    'function:success': FunctionSuccessEvent;
+    'function:error': FunctionErrorEvent;
+    'function:progress': FunctionProgressEvent;
+    'ui:toast': {
+        message: string;
+        type: string;
+    };
+    'ui:confirm-request': {
+        requestId: string;
+        path: string;
+        message: string;
+    };
+    'ui:confirm-response': {
+        requestId: string;
+        confirmed: boolean;
+    };
+}
+/**
+ * MD7: Event bus factory function
+ *
+ * Uses factory function to create new event bus instances, avoiding global singleton issues.
+ * The global instance `defaultEventBus` is just the default export; applications can create their own instances.
+ */
+export declare function createEventBus<TEventMap extends DefaultEventMap = DefaultEventMap>(): EventBus<TEventMap>;
+/**
+ * Global default event bus instance (MD7: only as default export; recommended to use createEventBus() to create independent instances)
+ */
+export declare const eventBus: EventBus<FunctionRegistryEventMap>;
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/core/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/core/event-bus.ts"],"names":[],"mappings":"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"}