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

package/dist/index.d.ts

@@ -0,0 +1,116 @@
+/**
+ * RTC Agent Component Library
+ *
+ * Public API — only <rtc-agent> is exported.
+ * Internal components are registered as side-effects and not exported.
+ */
+export { RtcAgent } from './components/rtc-agent/rtc-agent.js';
+/**
+ * Wait for the component module to load and initialize (ES module-style ready signal)
+ *
+ * @example
+ * ```ts
+ * import { whenReady } from '@rtc-agent/component';
+ * await whenReady();
+ * const agent = document.querySelector<RtcAgent>('#agent')!;
+ * agent.agentConfig = { persona: '...', functions: [...] };
+ * ```
+ */
+export { whenReady } from './core/ready.js';
+/**
+ * Internationalization API -- switch language at runtime
+ *
+ * @example
+ * ```ts
+ * import { switchLocale, getLocale } from '@rtc-agent/component';
+ * await switchLocale('en-US');
+ * console.log(getLocale()); // 'en-US'
+ * ```
+ */
+export { switchLocale, initLocale, getLocale, persistLocale, sourceLocale, targetLocales, localeContext, isValidLocale, } from './core/i18n.js';
+export type { SupportedLocale, LocaleContextValue } from './core/i18n.js';
+/**
+ * Theme API -- switch theme at runtime
+ *
+ * @example
+ * ```ts
+ * import { switchTheme, getEffectiveTheme } from '@rtc-agent/component';
+ * switchTheme('dark');
+ * console.log(getEffectiveTheme()); // 'dark'
+ * ```
+ */
+export { switchTheme, initTheme, getEffectiveTheme, getStoredTheme, persistTheme, } from './core/theme.js';
+export type { Theme } from './core/theme.js';
+/**
+ * Agent declarative configuration types
+ *
+ * Used for the <rtc-agent>.agentConfig property -- the primary integration method for host applications.
+ * No need to understand internal concepts like FunctionRegistry / toolRegistry.
+ */
+export type { AgentConfig, AgentFunctionGroup } from './types/agent-config.js';
+/**
+ * Component event detail type mapping (for TypeScript type-safe addEventListener)
+ *
+ * Works via global extension of HTMLElementEventMap; the RtcAgent instance returned by
+ * document.querySelector('rtc-agent') automatically gets type hints for the rtc-agent-ready event.
+ */
+export type { RtcAgentEventDetailMap } from './types/events.js';
+/**
+ * Global type extensions (HTMLElementTagNameMap, etc.)
+ *
+ * After importing this module, document.querySelector('rtc-agent') automatically returns the RtcAgent type.
+ * Usually no explicit import is needed -- the main entry already includes this extension.
+ */
+import './elements.js';
+/**
+ * Factory function -- declaratively create an <rtc-agent> instance
+ *
+ * @example
+ * ```ts
+ * import { createRtcAgent } from '@rtc-agent/component';
+ *
+ * const agent = createRtcAgent({
+ *   appLabel: 'My Assistant',
+ *   auth: { accessToken: '...', userId: 'user-123' },
+ * });
+ * document.body.appendChild(agent);
+ * ```
+ */
+export { createRtcAgent } from './factory.js';
+export type { RtcAgentConfig, RtcAgentWithLifecycle, AuthConfig, StaticTokenAuth, DynamicTokenAuth, AuthProvider, EventCallbacks, } from './types/factory.js';
+/**
+ * Session and Message types
+ *
+ * Needed for EventCallbacks — consumers use these to type callback parameters.
+ */
+export type { Session, Message } from './types/index.js';
+/**
+ * ConnectionState type
+ *
+ * Used by the `connectionStateChange` callback in EventCallbacks.
+ */
+export type { ConnectionState } from '@rtc-agent/client';
+/**
+ * Window and ActivityBar configuration types
+ *
+ * Used by `RtcAgentConfig.window` and `RtcAgentConfig.activityBar`.
+ */
+export type { WindowConfig } from './types/window-config.js';
+export type { ActivityBarConfig, Activity, ResolvedActivityBarConfig, } from './types/activity-bar-config.js';
+export { DEFAULT_ACTIVITY_BAR_CONFIG, resolveActivityBarConfig, } from './types/activity-bar-config.js';
+export { defineRegistry, FunctionRegistry, FunctionGroup } from './core/function-registry.js';
+export { loadScenariosFromURL, loadScenariosContent, parseFrontmatter } from './core/scenario-loader.js';
+export { generateFunctionMd, generateFunctionsIndex, generateScenariosIndex, generateAgentMd } from './core/markdown-generator.js';
+export { EventBus, eventBus, createEventBus } from './core/event-bus.js';
+export type { EventHandler, DefaultEventMap, FunctionRegistryEventMap } from './core/event-bus.js';
+export { SkillController } from './controllers/skill.controller.js';
+export type { SkillActions, SkillControllerConfig } from './controllers/skill.controller.js';
+export { SkillContext, DEFAULT_SKILL_STATE } from './contexts/skill.js';
+export type { SkillContextValue } from './contexts/skill.js';
+export type { OpenAPISchema, ParameterDef, ReturnDef, VisualHooks, FunctionDef, FunctionGroupDef, RegistryConfig, ScenarioDef, ScenarioManifest, } from './types/skill.js';
+export { CancelledError } from './types/skill.js';
+export type { FunctionStartEvent, FunctionSuccessEvent, FunctionErrorEvent, FunctionProgressEvent, } from './core/event-bus.js';
+export { z, validateParams, formatValidationError, buildValidator, withValidation, zodToParams, zodToOpenAPISchema, openApiToZod, withMeta, } from './validation/index.js';
+export type { ValidationError, ValidationResult, } from './validation/index.js';
+export type { LogLevel, LogEntry, ExecutionStatus, DebugHistoryItem, FunctionDebugState, HistoryPaginationState, } from './types/functions-debug.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -1,44 +1,47 @@
-import { C as s, D as t, E as o, F as n, a as r, R as i, S as l, b as c, c as d, d as g, e as m, f as L, h, i as u, j as T, k as S, l as p, m as E, n as F, o as A, p as R, q as f, r as v, t as w, u as x, v as C, w as y, x as B, y as I, z as M, A as V, B as k, G as z, H as b, I as D, J as G, K, L as P, M as U, N as _, O as j } from "./index-TrHSQq--.js";
+import { C as s, D as t, a as o, E as n, F as r, b as i, R as c, S as l, c as d, d as T, e as g, f as m, h as L, i as h, j as A, k as u, l as F, m as S, n as p, o as C, p as E, q as v, r as I, t as R, u as f, v as w, w as x, x as B, y, z as V, A as _, B as z, G as M, H as P, I as k, J as D, K as G, L as O, M as U, N as b, O as K, P as N, Q as j, T as q } from "./index-c20k11wZ.js";
 export {
   s as CancelledError,
-  t as DEFAULT_SKILL_STATE,
-  o as EventBus,
-  n as FunctionGroup,
-  r as FunctionRegistry,
-  i as RtcAgent,
+  t as DEFAULT_ACTIVITY_BAR_CONFIG,
+  o as DEFAULT_SKILL_STATE,
+  n as EventBus,
+  r as FunctionGroup,
+  i as FunctionRegistry,
+  c as RtcAgent,
   l as SkillContext,
-  c as SkillController,
-  d as buildValidator,
+  d as SkillController,
+  T as buildValidator,
   g as createEventBus,
   m as createRtcAgent,
   L as defineRegistry,
   h as eventBus,
-  u as formatValidationError,
-  T as generateAgentMd,
-  S as generateFunctionMd,
-  p as generateFunctionsIndex,
-  E as generateScenariosIndex,
-  F as getEffectiveTheme,
-  A as getLocale,
-  R as getStoredTheme,
-  f as initLocale,
-  v as initTheme,
-  w as isValidLocale,
-  x as loadScenariosContent,
-  C as loadScenariosFromURL,
-  y as localeContext,
-  B as openApiToZod,
-  I as parseFrontmatter,
-  M as persistLocale,
-  V as persistTheme,
-  k as sourceLocale,
-  z as switchLocale,
-  b as switchTheme,
-  D as targetLocales,
-  G as validateParams,
-  K as whenReady,
-  P as withMeta,
-  U as withValidation,
-  _ as z,
-  j as zodToParams
+  A as formatValidationError,
+  u as generateAgentMd,
+  F as generateFunctionMd,
+  S as generateFunctionsIndex,
+  p as generateScenariosIndex,
+  C as getEffectiveTheme,
+  E as getLocale,
+  v as getStoredTheme,
+  I as initLocale,
+  R as initTheme,
+  f as isValidLocale,
+  w as loadScenariosContent,
+  x as loadScenariosFromURL,
+  B as localeContext,
+  y as openApiToZod,
+  V as parseFrontmatter,
+  _ as persistLocale,
+  z as persistTheme,
+  M as resolveActivityBarConfig,
+  P as sourceLocale,
+  k as switchLocale,
+  D as switchTheme,
+  G as targetLocales,
+  O as validateParams,
+  U as whenReady,
+  b as withMeta,
+  K as withValidation,
+  N as z,
+  j as zodToOpenAPISchema,
+  q as zodToParams
 };