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

package/dist/core/function-registry.d.ts

@@ -0,0 +1,196 @@
+/**
+ * Function Registry
+ *
+ * Manages function registration, resolution, and chain calls.
+ * Uses Proxy to implement rtcAgent.user.register() syntax.
+ */
+import type { FunctionDef, FunctionGroupDef, RegistryConfig, ScenarioDef } from '../types/skill.js';
+/**
+ * FunctionGroup instance
+ * Supports chain registration and invocation
+ */
+export declare class FunctionGroup {
+    private registry;
+    private groupName;
+    private functions;
+    constructor(registry: FunctionRegistry, groupDef: FunctionGroupDef);
+    /**
+     * Register a function to the current group
+     *
+     * @param funcDef Function definition, name is required (function name within the group, without group prefix)
+     */
+    register(funcDef: Omit<FunctionDef, 'name'> & {
+        name: string;
+    }): FunctionDef;
+    /**
+     * Get all functions within the group
+     */
+    listFunctions(): FunctionDef[];
+    /**
+     * Support chain calls via Proxy: rtcAgent.task.list(params)
+     *
+     * Whitelist methods are returned directly; other property names are treated as function names within the group,
+     * returning a function that calls registry.execute('group.funcName', params).
+     */
+    createProxy(): FunctionGroup & Record<string, (params?: Record<string, unknown>) => Promise<unknown>>;
+}
+/**
+ * FunctionRegistry - Global registry
+ */
+export declare class FunctionRegistry {
+    private config;
+    private functions;
+    private groups;
+    private groupProxies;
+    private groupDefs;
+    constructor(config: RegistryConfig);
+    /**
+     * Register a single function
+     *
+     * M10: Note that document generation (_updateFunctionDoc) is an async fire-and-forget operation.
+     * After register() returns, the document may not yet be written to the virtual file system.
+     * Documents will typically be ready within a few hundred milliseconds, but completion at register() return is not guaranteed.
+     * If you need to ensure the document is ready, manually call the virtual file system's read and wait.
+     */
+    register(funcDef: FunctionDef): FunctionDef;
+    /**
+     * Internal method: Register a function (called by FunctionGroup)
+     *
+     * @internal For internal use only; external callers should use the register() method
+     *
+     * M10: Same as register(), document generation is async fire-and-forget and may be delayed in becoming ready.
+     */
+    registerInternal(funcDef: FunctionDef, groupName: string): void;
+    /**
+     * Normalize a FunctionDef by deriving parameters from zodSchema when parameters is not set.
+     *
+     * Ensures all downstream consumers (debugger, default params, markdown generator)
+     * can rely on `fn.parameters` being populated.
+     */
+    private _normalizeFunctionDef;
+    /**
+     * Create a FunctionGroup
+     *
+     * Returns a Proxy-wrapped FunctionGroup supporting chain calls:
+     * rtcAgent.task.list(params) → rtcAgent.execute('task.list', params)
+     */
+    createGroup(groupDef: FunctionGroupDef): FunctionGroup & Record<string, (params?: Record<string, unknown>) => Promise<unknown>>;
+    /**
+     * Unregister a function
+     *
+     * Removes the function definition from memory, deletes the document in the virtual file system, and updates the index.
+     *
+     * MD9: Design rationale for unregister being async while register is sync:
+     * - register only updates the in-memory Map (synchronous operation); document generation is background fire-and-forget
+     * - unregister needs to delete document files in the virtual file system and update the index, which are I/O operations
+     * - Callers typically need to confirm file system cleanup after unregister completes, so unregister returns a Promise
+     */
+    unregister(name: string): Promise<void>;
+    /**
+     * Resolve a function path
+     */
+    resolve(path: string): FunctionDef | undefined;
+    /**
+     * List all functions
+     */
+    listFunctions(): FunctionDef[];
+    /**
+     * List all groups
+     */
+    listGroups(): FunctionGroupDef[];
+    /**
+     * Regenerate all documents (used after database initialization)
+     *
+     * Solves timing issue: when register() is called before database initialization, document writes will fail.
+     * After database initialization completes, call this method to regenerate all documents.
+     *
+     * Should use generateAllDocsContent() + WorkerBridge.batchWriteFiles()
+     */
+    regenerateAllDocs(): Promise<void>;
+    /**
+     * Generate all document content (without writing to VirtualFS), and calculate orphan paths to delete
+     *
+     * Usage: main thread generates content, sends it to Worker via WorkerBridge.batchWriteFiles() for writing.
+     * Also queries existing function documents in VFS to calculate orphan paths that are no longer registered, and passes them to Worker for deletion.
+     *
+     * @param scenarioCount Number of scenarios (used for generating AGENT.md)
+     * @returns files: list of files to write, deletePaths: orphan paths to delete
+     */
+    generateAllDocsContent(scenarioCount?: number): Promise<{
+        files: Array<{
+            path: string;
+            content: string;
+        }>;
+        deletePaths: string[];
+    }>;
+    /**
+     * Execute a function
+     *
+     * Uses event-driven architecture, does not directly invoke UI:
+     * - Emits function:start/success/error/progress events
+     * - UI layer listens to events and handles them
+     *
+     * CancelledError handling:
+     * - CancelledError thrown by onStart does not trigger onError
+     *
+     * M11: onSuccess uses fire-and-forget, no ordering guarantee with eventBus.emit('function:success').
+     *      onSuccess may complete before or after the function:success event.
+     *     For strict ordering, use event listeners instead of hooks.
+     */
+    execute(path: string, params: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Write a scenario
+     *
+     * m8: scenario.id field is ignored; filename is always generated from title slug.
+     * Reason: virtual file system paths are based on title slug; id is only used for database indexing.
+     * scenario.id is used for unique identification in scenario-loader's manifest, but does not affect file storage path.
+     *
+     * Write strategy: uses 'create-new' mode; does not overwrite if file already exists (protects user-edited content)
+     */
+    writeScenario(scenario: ScenarioDef): Promise<void>;
+    /**
+     * Update function documentation
+     */
+    private _updateFunctionDoc;
+    /**
+     * Update Functions index
+     *
+     * Write strategy: uses 'overwrite' mode (index file is always up to date)
+     */
+    private _updateFunctionsIndex;
+    /**
+     * Update Scenarios index
+     *
+     * Write strategy: uses 'overwrite' mode (index file is always up to date)
+     */
+    private _updateScenariosIndex;
+    /**
+     * Update AGENT.md
+     *
+     * Write strategy: uses 'create-new' mode; does not overwrite if file already exists (protects user-edited content)
+     */
+    private _updateAgentMd;
+    /**
+     * Convert string to slug
+     *
+     * Supports CJK characters (Chinese, Japanese, Korean)
+     * If the result is empty, uses timestamp + random number
+     *
+     * MD10: slug is truncated to 100 characters to avoid overly long filenames
+     */
+    private _slugify;
+    /**
+     * M12: Support chain calls via Proxy: rtcAgent.user.register(params)
+     *
+     * Uses whitelist to expose methods, without exposing private properties like functions/groups
+     */
+    createProxy(): FunctionRegistry & Record<string, FunctionGroup>;
+}
+/**
+ * Create global Registry
+ *
+ * Automatically registers the built-in system tool group (delay/uuid/now/random/time),
+ * allowing scripts to access commonly used platform APIs sandboxed via rtcAgent.system.*.
+ */
+export declare function defineRegistry(config: RegistryConfig): FunctionRegistry & Record<string, FunctionGroup>;
+//# sourceMappingURL=function-registry.d.ts.map

package/dist/core/function-registry.d.ts.map

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

package/dist/core/i18n.d.ts

@@ -0,0 +1,25 @@
+export declare const sourceLocale: "zh-CN";
+export declare const targetLocales: readonly ["en-US"];
+export type SupportedLocale = typeof targetLocales[number] | typeof sourceLocale;
+export declare const getLocale: (() => string) & {
+    _LIT_LOCALIZE_GET_LOCALE_?: never;
+}, _setLocale: ((newLocale: string) => Promise<void>) & {
+    _LIT_LOCALIZE_SET_LOCALE_?: never;
+};
+export interface LocaleContextValue {
+    locale: SupportedLocale;
+    setLocale: (locale: SupportedLocale) => Promise<void>;
+    locales: readonly SupportedLocale[];
+}
+export declare const localeContext: {
+    __context__: LocaleContextValue;
+};
+export declare function isValidLocale(value: string): value is SupportedLocale;
+export declare function initLocale(hostLang?: string): Promise<void>;
+export declare function persistLocale(locale: SupportedLocale): void;
+/**
+ * Switch language and synchronize all related state
+ * Components should call this function instead of calling _setLocale directly
+ */
+export declare function switchLocale(locale: SupportedLocale): Promise<void>;
+//# sourceMappingURL=i18n.d.ts.map

package/dist/core/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/core/i18n.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,YAAY,EAAG,OAAgB,CAAC;AAC7C,eAAO,MAAM,aAAa,oBAAqB,CAAC;AAChD,MAAM,MAAM,eAAe,GAAG,OAAO,aAAa,CAAC,MAAM,CAAC,GAAG,OAAO,YAAY,CAAC;AAWjF,eAAO,MAAQ,SAAS;;GAAa,UAAU;;CAmB7C,CAAC;AAGH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;CACrC;AAED,eAAO,MAAM,aAAa;;CAAsD,CAAC;AAKjF,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,eAAe,CAErE;AA0BD,wBAAsB,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOjE;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAO3D;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAIzE"}

package/dist/core/locale-controller.d.ts

@@ -0,0 +1,25 @@
+import { type ReactiveController, type ReactiveControllerHost } from 'lit';
+/**
+ * Wraps locale context consumption logic to reduce component boilerplate
+ *
+ * @example
+ * ```typescript
+ * @localized()
+ * @customElement('rtc-settings')
+ * export class RtcSettings extends LitElement {
+ *   private _locale = new LocaleController(this);
+ *
+ *   render() {
+ *     return html`<p>Current: ${this._locale.locale}</p>`;
+ *   }
+ * }
+ * ```
+ */
+export declare class LocaleController implements ReactiveController {
+    private _consumer;
+    constructor(host: ReactiveControllerHost & HTMLElement);
+    get locale(): import("./i18n.js").SupportedLocale;
+    get locales(): readonly import("./i18n.js").SupportedLocale[];
+    hostUpdated(): void;
+}
+//# sourceMappingURL=locale-controller.d.ts.map

package/dist/core/locale-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-controller.d.ts","sourceRoot":"","sources":["../../src/core/locale-controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,sBAAsB,EAAE,MAAM,KAAK,CAAC;AAI3E;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,gBAAiB,YAAW,kBAAkB;IACzD,OAAO,CAAC,SAAS,CAA8E;gBAEnF,IAAI,EAAE,sBAAsB,GAAG,WAAW;IAQtD,IAAI,MAAM,wCAET;IAED,IAAI,OAAO,mDAEV;IAED,WAAW;CAGZ"}

package/dist/core/markdown-generator.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Markdown Generator
+ *
+ * Generates markdown documentation from FunctionDef.
+ * Uses OpenAPI Schema format to describe parameters and return values.
+ */
+import type { FunctionDef, FunctionGroupDef, RegistryConfig, OpenAPISchema } from '../types/skill.js';
+/**
+ * Convert OpenAPI Schema to a readable type string
+ *
+ * References openapi-markdown's dataTypes.js logic
+ */
+export declare function schemaToTypeString(schema: OpenAPISchema): string;
+/**
+ * Generate markdown documentation for a single Function
+ *
+ * Adds a generation identifier comment at the file header to mark it as auto-generated
+ */
+export declare function generateFunctionMd(funcDef: FunctionDef, groupName?: string): string;
+/**
+ * Generate example value based on OpenAPI Schema
+ */
+export declare function getExampleValue(schema: OpenAPISchema): string;
+/**
+ * Generate Functions index (organized by group)
+ */
+export declare function generateFunctionsIndex(functions: FunctionDef[], groups: FunctionGroupDef[]): string;
+/**
+ * Generate Scenarios index
+ */
+export declare function generateScenariosIndex(scenarios: Array<{
+    path: string;
+    metadata: {
+        name?: string;
+        tags?: string[];
+        description?: string;
+    };
+}>): string;
+/**
+ * Generate AGENT.md
+ *
+ * Agent Prompt defines the Agent's identity, workflow, and capabilities.
+ * The frontend generates this content; the server has a default fallback implementation.
+ */
+export declare function generateAgentMd(config: RegistryConfig, functions: FunctionDef[], groups: FunctionGroupDef[], scenarioCount: number): string;
+//# sourceMappingURL=markdown-generator.d.ts.map

package/dist/core/markdown-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-generator.d.ts","sourceRoot":"","sources":["../../src/core/markdown-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,cAAc,EAAE,aAAa,EAAgB,MAAM,mBAAmB,CAAC;AAMpH;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAqChE;AAuED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAgInF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAyC7D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,WAAW,EAAE,EACxB,MAAM,EAAE,gBAAgB,EAAE,GACzB,MAAM,CAsCR;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,KAAK,CAAC;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACpE,CAAC,GAAG,MAAM,CAgBV;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,WAAW,EAAE,EACxB,MAAM,EAAE,gBAAgB,EAAE,EAC1B,aAAa,EAAE,MAAM,GACpB,MAAM,CAaR"}

package/dist/core/ready.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Module Ready Signal
+ *
+ * Provides two mechanisms for the host application to wait for <rtc-agent> component initialization:
+ * 1. `whenReady()` Promise — ES module style
+ * 2. `rtc-agent-ready` custom event — Web Component style (dispatched by RtcAgent component)
+ *
+ * Internal use: component calls _markReady() on firstUpdated.
+ */
+/**
+ * Wait for the <rtc-agent> component module to load and initialize
+ *
+ * @example
+ * ```ts
+ * import { whenReady } from '@rtc-agent/component';
+ * await whenReady();
+ * const agent = document.querySelector<RtcAgent>('#agent')!;
+ * agent.agentConfig = { persona: '...' };
+ * ```
+ */
+export declare const whenReady: Promise<void>;
+/**
+ * Mark the module as ready (internal use)
+ *
+ * Called by RtcAgent component on firstUpdated.
+ * Safe to call multiple times (subsequent calls return immediately).
+ */
+export declare function _markReady(): void;
+/**
+ * Check whether the module is ready (internal use, mainly for testing)
+ */
+export declare function _isReady(): boolean;
+//# sourceMappingURL=ready.d.ts.map

package/dist/core/ready.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ready.d.ts","sourceRoot":"","sources":["../../src/core/ready.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS,EAAE,OAAO,CAAC,IAAI,CAElC,CAAC;AAEH;;;;;GAKG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAIjC;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAElC"}

package/dist/core/scenario-loader.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Scenario Loader
+ *
+ * Loads Scenario markdown files from a URL
+ */
+/**
+ * Parse YAML frontmatter
+ *
+ * Format:
+ * ---
+ * title: "Title"
+ * tags: [tag1, tag2]
+ * ---
+ *
+ * Content...
+ *
+ * Supported fields: title, id, name, description, tags, author, createdAt
+ * Limitations: does not support multi-line values or complex YAML structures
+ */
+export declare function parseFrontmatter(content: string): {
+    id?: string;
+    title?: string;
+    name?: string;
+    description?: string;
+    tags?: string[];
+    author?: string;
+    createdAt?: string;
+    body: string;
+};
+/**
+ * Load Scenarios from URL
+ *
+ * @param baseURL Base URL for Scenario files (e.g. '/scenarios/')
+ * @param timeoutMs Timeout per request in milliseconds (default 10000)
+ * @returns Number of Scenarios loaded
+ */
+export declare function loadScenariosFromURL(baseURL: string, timeoutMs?: number): Promise<number>;
+/**
+ * Load Scenarios content from URL (without writing to VirtualFS), and compute orphan paths to delete
+ *
+ * Usage: main thread fetches content, then sends it via WorkerBridge.batchWriteFiles() to the Worker for writing.
+ * Also queries existing scenario files in VFS to compute orphan paths not in the manifest, passing them to the Worker for deletion.
+ *
+ * @param baseURL Base URL for Scenario files
+ * @param timeoutMs Timeout per request
+ * @returns files: files to write, deletePaths: orphan paths to delete
+ */
+export declare function loadScenariosContent(baseURL: string, timeoutMs?: number): Promise<{
+    files: Array<{
+        path: string;
+        content: string;
+        metadata: {
+            name?: string;
+            description?: string;
+            tags?: string[];
+        };
+    }>;
+    deletePaths: string[];
+}>;
+//# sourceMappingURL=scenario-loader.d.ts.map

package/dist/core/scenario-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario-loader.d.ts","sourceRoot":"","sources":["../../src/core/scenario-loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG;IACjD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd,CAuEA;AAiBD;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,MAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAwFtG;AAED;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,MAAc,GACxB,OAAO,CAAC;IACT,KAAK,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;SAAC,CAAA;KAAC,CAAC,CAAA;IAC/G,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC,CA+ED"}

package/dist/core/theme.d.ts

@@ -0,0 +1,29 @@
+export type Theme = 'light' | 'dark' | 'system';
+/**
+ * Get the current effective theme (resolves 'system' to 'light' or 'dark')
+ */
+export declare function getEffectiveTheme(theme?: Theme): 'light' | 'dark';
+/**
+ * Get the stored theme preference from localStorage
+ */
+export declare function getStoredTheme(): Theme;
+/**
+ * Persist theme preference to localStorage
+ */
+export declare function persistTheme(theme: Theme): void;
+/**
+ * Switch theme for all <rtc-agent> elements and persist the preference
+ *
+ * @example
+ * ```ts
+ * import { switchTheme } from '@rtc-agent/component';
+ * await switchTheme('dark');
+ * ```
+ */
+export declare function switchTheme(theme: Theme): void;
+/**
+ * Initialize theme from stored preference
+ * Should be called once on app startup
+ */
+export declare function initTheme(): void;
+//# sourceMappingURL=theme.d.ts.map

package/dist/core/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/core/theme.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AAKhD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,GAAE,KAAwB,GAAG,OAAO,GAAG,MAAM,CAKnF;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,KAAK,CAUtC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAM/C;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAiB9C;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,IAAI,CAIhC"}

package/dist/debug-api-core.d.ts

@@ -0,0 +1,9 @@
+import type { RtcAgentDebugAPI } from './debug-api-types.js';
+/**
+ * Build core debug API methods.
+ *
+ * Returns a partial implementation covering state, data, auth, events,
+ * VirtualFS, logs, UI control, and component reference.
+ */
+export declare function buildCoreAPI(): Pick<RtcAgentDebugAPI, 'getState' | 'clearData' | 'seedData' | 'loginAs' | 'logout' | 'triggerEvent' | 'listFiles' | 'readFile' | 'writeFile' | 'deleteFile' | 'logs' | 'clearLogs' | 'click' | 'scrollIntoView' | 'typeText' | 'element' | 'waitForReady' | 'waitForConnected' | 'sendMessage' | 'getMessages' | 'addDemoMessage' | 'clearMessages'>;
+//# sourceMappingURL=debug-api-core.d.ts.map

package/dist/debug-api-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-api-core.d.ts","sourceRoot":"","sources":["../src/debug-api-core.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,sBAAsB,CAAC;AAU3D;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAChC,gBAAgB,EACd,UAAU,GAAG,WAAW,GAAG,UAAU,GACrC,SAAS,GAAG,QAAQ,GACpB,cAAc,GACd,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,YAAY,GACrD,MAAM,GAAG,WAAW,GACpB,OAAO,GAAG,gBAAgB,GAAG,UAAU,GACvC,SAAS,GAAG,cAAc,GAAG,kBAAkB,GAC/C,aAAa,GAAG,aAAa,GAAG,gBAAgB,GAAG,eAAe,CACvE,CAoaA"}

package/dist/debug-api-ext.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Debug API — extended implementation.
+ *
+ * Builds the extended debug API methods: session management, tool call
+ * simulation, toast notifications, settings, activity control, performance
+ * metrics, and network simulation.
+ */
+import type { RtcAgentDebugAPI } from './debug-api-types.js';
+/**
+ * Build extended debug API methods.
+ *
+ * Returns a partial implementation covering session management, tool calls,
+ * toast, settings, activity, metrics, and network simulation.
+ */
+export declare function buildExtAPI(): Pick<RtcAgentDebugAPI, 'createSession' | 'switchSession' | 'deleteSession' | 'renameSession' | 'getSessions' | 'getCurrentSessionId' | 'getToolCalls' | 'addPendingToolCall' | 'approveToolCall' | 'denyToolCall' | 'approveAllToolCalls' | 'showToast' | 'getToasts' | 'getSettings' | 'updateSettings' | 'setActivity' | 'getActivity' | 'getMetrics' | 'simulateOffline' | 'restoreNetwork' | 'isOffline'>;
+//# sourceMappingURL=debug-api-ext.d.ts.map

package/dist/debug-api-ext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-api-ext.d.ts","sourceRoot":"","sources":["../src/debug-api-ext.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,sBAAsB,CAAC;AA0C3D;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAC/B,gBAAgB,EACd,eAAe,GAAG,eAAe,GAAG,eAAe,GAAG,eAAe,GACrE,aAAa,GAAG,qBAAqB,GACrC,cAAc,GAAG,oBAAoB,GAAG,iBAAiB,GAAG,cAAc,GAAG,qBAAqB,GAClG,WAAW,GAAG,WAAW,GACzB,aAAa,GAAG,gBAAgB,GAChC,aAAa,GAAG,aAAa,GAC7B,YAAY,GACZ,iBAAiB,GAAG,gBAAgB,GAAG,WAAW,CACvD,CA6bA"}

package/dist/debug-api-helpers.d.ts

@@ -0,0 +1,28 @@
+import type { RtcAgent } from './components/rtc-agent/rtc-agent.js';
+export declare const log: import("@rtc-agent/client").Logger;
+/**
+ * Ensure the database singleton is initialized before VirtualFS operations.
+ *
+ * VirtualFS methods call `getDatabase()` without a name, which fails if no
+ * database has been opened yet. This helper lazily opens a debug-specific
+ * database so that VirtualFS operations work even when persistence is not
+ * connected (e.g., standalone debug pages without a server).
+ *
+ * Safe to call multiple times (idempotent).
+ */
+export declare function ensureDatabase(): void;
+/** Maximum number of log entries retained in the ring buffer. */
+export declare const LOG_BUFFER_MAX = 500;
+/** Ring buffer that captures recent log entries for replay in tests. */
+export declare const logBuffer: string[];
+export declare function installLogCapture(): void;
+/**
+ * Query a CSS selector that may cross shadow DOM boundaries.
+ *
+ * Supports `>>>` as a shadow-piercing combinator.
+ * Example: `'rtc-agent >>> rtc-chat-layout >>> rtc-input-area'`
+ */
+export declare function deepQuerySelector(root: Node, selector: string): Element | null;
+/** Get the <rtc-agent> element from the page. */
+export declare function getAgentElement(): RtcAgent | null;
+//# sourceMappingURL=debug-api-helpers.d.ts.map

package/dist/debug-api-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-api-helpers.d.ts","sourceRoot":"","sources":["../src/debug-api-helpers.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,qCAAqC,CAAC;AAElE,eAAO,MAAM,GAAG,oCAA2B,CAAC;AAK5C;;;;;;;;;GASG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAOrC;AAID,iEAAiE;AACjE,eAAO,MAAM,cAAc,MAAM,CAAC;AAElC,wEAAwE;AACxE,eAAO,MAAM,SAAS,EAAE,MAAM,EAAO,CAAC;AAyBtC,wBAAgB,iBAAiB,IAAI,IAAI,CAexC;AAID;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CA6B9E;AAID,iDAAiD;AACjD,wBAAgB,eAAe,IAAI,QAAQ,GAAG,IAAI,CAEjD"}