@mcp-b/embedded-agent 1.2.5-beta.1 → 1.2.6

package/dist/web-component.d.ts

@@ -1,73 +1,52 @@
-import { FC } from "react";
-
 //#region src/web-component.d.ts
-
 /**
- * Development mode configuration
+ * WebMCP Agent
  *
- * In dev mode, you provide your own API keys for testing.
- * Requests still go through WebMCP infrastructure (Cloudflare Workers),
- * but use your keys so there's no cost to us during development.
- */
-interface DevModeConfig {
-  /** Your Anthropic API key for chat (required for dev mode) */
-  anthropicApiKey: string;
-  /** Your OpenAI API key for voice mode (optional) */
-  openaiApiKey?: string;
-  /** Use window.location.origin instead of production API (for internal development) */
-  useLocalApi?: boolean;
-}
-/**
- * Props for the EmbeddedAgent component
- */
-interface EmbeddedAgentProps {
-  /** Your WebMCP app ID - get one at webmcp.ai */
-  appId: string;
-  /**
-   * Development mode - use your own API keys for testing.
-   * In production, leave this undefined to use your WebMCP plan.
-   */
-  devMode?: DevModeConfig;
-  /**
-   * Disable shadow DOM style isolation.
-   * NOT RECOMMENDED - only use this if you need to customize internal styles
-   * and understand the risks of style conflicts with the host page.
-   *
-   * When enabled:
-   * - Styles are injected globally into document.head
-   * - Host page styles may affect the agent widget
-   * - Agent styles may leak to the host page
-   *
-   * @default false
-   */
-  disableShadowDOM?: boolean;
-}
-/**
- * EmbeddedAgent - Drop-in AI chat widget
+ * An Intercom-like AI chat widget with MCP tool support and voice mode.
+ * Drop it into your app and you're done - uses your existing SSO token.
+ *
+ * Styles are isolated by default using Shadow DOM. Customize appearance
+ * via CSS variables on the host element.
+ *
+ * @example SSO-First (production usage)
+ * ```tsx
+ * // Use your existing IDP token - no additional login needed
+ * const { session } = useOktaAuth() // or Azure, Auth0, Google, etc.
  *
- * A fully self-contained chat widget with:
- * - MCP tool support (connect to any MCP server)
- * - Voice mode (talk to your AI assistant)
- * - Action-first UI (shows what the AI is doing, not just typing)
- * - Shadow DOM isolation (styles don't leak in or out)
+ * <webmcp-agent auth-token={session.idToken} />
+ * ```
  *
- * Just add your app ID and you're done. Everything else is handled.
+ * @example React
+ * ```tsx
+ * import '@mcp-b/embedded-agent/web-component'
+ *
+ * function App() {
+ *   const { session } = useOktaAuth()
+ *   return <webmcp-agent auth-token={session.idToken} />
+ * }
+ * ```
+ *
+ * @example Stateless (dev/anonymous - no auth required)
+ * ```tsx
+ * // No auth token = stateless mode (messages in memory only)
+ * <webmcp-agent />
+ * ```
+ *
+ * @example CSS variable theming
+ * ```css
+ * webmcp-agent {
+ *   --wm-color-primary: #0f766e;
+ *   --wm-radius: 12px;
+ * }
+ * ```
  */
-declare const EmbeddedAgent: FC<EmbeddedAgentProps>;
 /**
  * Register the <webmcp-agent> custom element
  *
  * Called automatically when importing this module.
- *
- * With shadow DOM (default):
- * - Styles are injected into the shadow root, not the document
- * - Complete isolation from host page styles
- *
- * With disableShadowDOM:
- * - Styles are injected into document.head on first render
- * - May conflict with host page styles
+ * Styles are injected into the shadow root by ShadowRoot component.
  */
 declare function registerWebMCPAgent(tagName?: string): void;
 //#endregion
-export { DevModeConfig, EmbeddedAgent, EmbeddedAgentProps, registerWebMCPAgent };
+export { registerWebMCPAgent };
 //# sourceMappingURL=web-component.d.ts.map

package/dist/web-component.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web-component.d.ts","names":[],"sources":["../src/web-component.tsx"],"sourcesContent":[],"mappings":";;;;;;;;;;;UAuEiB,aAAA;;;;;;;;;;;UAYA,kBAAA;;;;;;;YAQN;;;;;;;;;;;;;;;;;;;;;;;;;;cA4BE,eAAe,GAAG;;;;;;;;;;;;;;iBA8Ef,mBAAA"}
+{"version":3,"file":"web-component.d.ts","names":[],"sources":["../src/web-component.tsx"],"sourcesContent":[],"mappings":";;AA8OA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAgB,mBAAA"}