@dabalabs/agent 0.0.1-beta → 0.0.4-beta

package/dist/custom-element.cjs

@@ -1,17 +1,17 @@
 'use strict';
 
-var chunkEF6D33VT_cjs = require('./chunk-EF6D33VT.cjs');
-require('./chunk-N4TBGDUO.cjs');
+var chunk3BQ6LE6X_cjs = require('./chunk-3BQ6LE6X.cjs');
+require('./chunk-VAIC5ACS.cjs');
 
 
 
 Object.defineProperty(exports, "DabaAgentElement", {
   enumerable: true,
-  get: function () { return chunkEF6D33VT_cjs.DabaAgentElement; }
+  get: function () { return chunk3BQ6LE6X_cjs.DabaAgentElement; }
 });
 Object.defineProperty(exports, "defineDabaAgentElement", {
   enumerable: true,
-  get: function () { return chunkEF6D33VT_cjs.defineDabaAgentElement; }
+  get: function () { return chunk3BQ6LE6X_cjs.defineDabaAgentElement; }
 });
 //# sourceMappingURL=custom-element.cjs.map
 //# sourceMappingURL=custom-element.cjs.map

package/dist/custom-element.d.cts

@@ -1,2 +1,191 @@
-export { a as DabaAgentElement, d as defineDabaAgentElement } from './custom-element-XiZg8UN8.cjs';
-import './types-DYRGPzyp.cjs';
+import { D as DabaAgentOptions, a as DabaAgentStatus } from './types-BQRgqD4n.cjs';
+
+interface StoredConversation {
+    id: string;
+    title: string;
+    /** When the last message was added, not when the thread started — the
+     * list is ordered by recency, which is what "go back to my chat" means. */
+    updatedAt: number;
+    messageCount: number;
+    /** Path only, never the query string: a search page's URL can carry what
+     * the visitor typed, and this record outlives their session. */
+    path: string;
+}
+
+declare class DabaAgent {
+    private readonly options;
+    private readonly position;
+    private mode;
+    private readonly badge;
+    private readonly badgeLabel;
+    private readonly chatWindow;
+    private readonly messagesContainer;
+    private readonly inputElement;
+    private readonly micBtn;
+    /** The shortcut as a visitor reads it, or null when the embed disabled
+     *  it. Computed once and reused by the badge so the tooltip, the panel
+     *  hint and the accessible name can never name different keys. */
+    private readonly hotkeyText;
+    /** Parsed once. Re-parsing inside the keydown handler ran the whole
+     *  string through split/find on every keystroke the visitor typed. */
+    private readonly parsedHotkey;
+    private readonly heldModifier;
+    private readonly keydownHandler;
+    private readonly keyupHandler;
+    private readonly blurHandler;
+    private holdTimer;
+    /** Set the moment a hold activates and cleared only on the matching
+     *  keyup, so one physical press cannot start two sessions if the browser
+     *  repeats the modifier keydown. */
+    private holdFired;
+    private readonly restricted;
+    private status;
+    private isOpen;
+    private destroyed;
+    private ws;
+    private audioContext;
+    private mic;
+    private player;
+    private bargeInStreak;
+    private isReattaching;
+    private messages;
+    private currentStreamBubble;
+    private currentStreamRole;
+    private currentStreamText;
+    private readonly ui;
+    private readonly strings;
+    private readonly uiLang;
+    private conversationId;
+    private chatInFlight;
+    private remoteConfig;
+    private live;
+    constructor(options: DabaAgentOptions);
+    /** Put back what this thread already showed, so a reload or a
+     * navigate() lands the visitor mid-conversation, not on a blank intro
+     * while the model silently remembers the last four turns. */
+    private restoreTranscript;
+    /** Put a stored thread on screen and into `messages`. Shared by the
+     *  reload path and by opening something out of the archive, so a
+     *  reopened conversation behaves exactly like a resumed one. */
+    private renderMessages;
+    private saveTranscript;
+    /** The archive, newest first. Empty unless the embed opted in. */
+    listConversations(): StoredConversation[];
+    /**
+     * Reopen an archived conversation as the LIVE one.
+     *
+     * Resuming rather than previewing: the gateway keeps its own thread
+     * state keyed on the conversation id, so restoring the id means the
+     * model still has the context the visitor is looking at. A read-only
+     * view would show a conversation they cannot continue, which is the one
+     * thing "go back to my chat" does not mean.
+     */
+    openConversation(id: string): void;
+    deleteConversation(id: string): void;
+    clearHistory(): void;
+    /**
+     * Pull the project's own mode, theme, intro and locale from the gateway.
+     *
+     * Fire-and-forget on purpose: the widget is fully usable before this
+     * resolves and stays usable if it never does. A visitor must never be
+     * left unable to type because a styling fetch was slow, so every failure
+     * path here is a silent fall back to the built-in brand kit rather than
+     * an error the visitor has to read.
+     */
+    private loadRemoteConfig;
+    /** Show or hide the voice controls to match the resolved mode. Removing
+     * them rather than disabling them: a greyed-out microphone still
+     * promises voice the project has switched off. */
+    private applyMode;
+    private handleKeydown;
+    private handleKeyup;
+    /**
+     * What a completed hold does: START talking, never stop.
+     *
+     * The panel advertises this as "Hold ^ to talk". A visitor who keeps
+     * holding while they speak — which is what those words invite — was
+     * hanging up on themselves, because the hold used to call toggle() and
+     * the second completed hold ended the session. Ending a conversation is
+     * the badge's job, and the badge tooltip already says so.
+     */
+    private activate;
+    /** Releasing early, pressing another key, or leaving the tab all mean the
+     *  hold did not happen. Letting a stale timer survive any of those is how
+     *  a widget opens itself for no reason the visitor can see. */
+    private cancelHold;
+    private setStatus;
+    private emitError;
+    get currentStatus(): DabaAgentStatus;
+    get isActive(): boolean;
+    get isChatOpen(): boolean;
+    openChat(): void;
+    closeChat(): void;
+    toggleChat(): void;
+    /**
+     * Send one typed message.
+     *
+     * This used to call `startSession()`, which opens the Realtime
+     * WebSocket, and `onSocketOpen` then unconditionally grabbed the
+     * microphone — so typing a sentence demanded microphone permission and
+     * was billed as voice minutes. Typing now goes over plain HTTP and
+     * touches neither the mic, the AudioContext nor the socket.
+     *
+     * The one exception is a voice session that is ALREADY live: injecting
+     * the text there keeps a single continuous conversation, which is what a
+     * visitor switching medium mid-sentence expects. It is not a reason to
+     * start a session that does not exist.
+     */
+    sendText(text: string): Promise<void>;
+    private sendChatMessage;
+    /**
+     * Start a new conversation: clear the transcript, forget the history the
+     * gateway is keyed on, and put the intro back. A fresh id rather than a
+     * reset flag, so the old thread simply expires on its own TTL instead of
+     * needing a round trip to delete.
+     */
+    resetConversation(): void;
+    /** Voice, explicitly. Never reached in chat mode — the controls that
+     * would call it are not rendered there. */
+    private toggleVoice;
+    private handleTranscriptDelta;
+    toggle(): Promise<void>;
+    private get usesLiveEngine();
+    private startLiveSession;
+    private runVoiceTool;
+    private startSession;
+    private tryReattach;
+    private attachWebSocket;
+    private onSocketOpen;
+    private onMicFrame;
+    private onSocketMessage;
+    private executeTool;
+    private handleToolCall;
+    private stopSession;
+    private handleSocketClose;
+    private flashBadgeError;
+    private cleanupAfterClose;
+    destroy(): void;
+}
+
+type DabaAgentElementConstructor = new () => DabaAgentElement;
+/**
+ * The element's public shape.
+ *
+ * A type, not a class: `class ... extends HTMLElement` evaluates its
+ * extends clause the moment the module does, and on a server there is no
+ * HTMLElement — which is why importing the package root from a Next.js
+ * layout threw "HTMLElement is not defined" and forced every integrator
+ * into a dynamic import inside an effect. The real class is built by
+ * defineDabaAgentElement(), which only ever runs in a browser.
+ */
+interface DabaAgentElement extends HTMLElement {
+    readonly dabaAgent: DabaAgent | null;
+    sendText(text: string): Promise<void> | undefined;
+    openChat(): void;
+    closeChat(): void;
+    toggleChat(): void;
+}
+declare let DabaAgentElement: DabaAgentElementConstructor | undefined;
+declare function defineDabaAgentElement(tagName?: string): void;
+
+export { DabaAgent as D, DabaAgentElement, type DabaAgentElementConstructor, type StoredConversation as S, defineDabaAgentElement };

package/dist/custom-element.d.ts

@@ -1,2 +1,191 @@
-export { a as DabaAgentElement, d as defineDabaAgentElement } from './custom-element-CpPr7b2Z.js';
-import './types-DYRGPzyp.js';
+import { D as DabaAgentOptions, a as DabaAgentStatus } from './types-BQRgqD4n.js';
+
+interface StoredConversation {
+    id: string;
+    title: string;
+    /** When the last message was added, not when the thread started — the
+     * list is ordered by recency, which is what "go back to my chat" means. */
+    updatedAt: number;
+    messageCount: number;
+    /** Path only, never the query string: a search page's URL can carry what
+     * the visitor typed, and this record outlives their session. */
+    path: string;
+}
+
+declare class DabaAgent {
+    private readonly options;
+    private readonly position;
+    private mode;
+    private readonly badge;
+    private readonly badgeLabel;
+    private readonly chatWindow;
+    private readonly messagesContainer;
+    private readonly inputElement;
+    private readonly micBtn;
+    /** The shortcut as a visitor reads it, or null when the embed disabled
+     *  it. Computed once and reused by the badge so the tooltip, the panel
+     *  hint and the accessible name can never name different keys. */
+    private readonly hotkeyText;
+    /** Parsed once. Re-parsing inside the keydown handler ran the whole
+     *  string through split/find on every keystroke the visitor typed. */
+    private readonly parsedHotkey;
+    private readonly heldModifier;
+    private readonly keydownHandler;
+    private readonly keyupHandler;
+    private readonly blurHandler;
+    private holdTimer;
+    /** Set the moment a hold activates and cleared only on the matching
+     *  keyup, so one physical press cannot start two sessions if the browser
+     *  repeats the modifier keydown. */
+    private holdFired;
+    private readonly restricted;
+    private status;
+    private isOpen;
+    private destroyed;
+    private ws;
+    private audioContext;
+    private mic;
+    private player;
+    private bargeInStreak;
+    private isReattaching;
+    private messages;
+    private currentStreamBubble;
+    private currentStreamRole;
+    private currentStreamText;
+    private readonly ui;
+    private readonly strings;
+    private readonly uiLang;
+    private conversationId;
+    private chatInFlight;
+    private remoteConfig;
+    private live;
+    constructor(options: DabaAgentOptions);
+    /** Put back what this thread already showed, so a reload or a
+     * navigate() lands the visitor mid-conversation, not on a blank intro
+     * while the model silently remembers the last four turns. */
+    private restoreTranscript;
+    /** Put a stored thread on screen and into `messages`. Shared by the
+     *  reload path and by opening something out of the archive, so a
+     *  reopened conversation behaves exactly like a resumed one. */
+    private renderMessages;
+    private saveTranscript;
+    /** The archive, newest first. Empty unless the embed opted in. */
+    listConversations(): StoredConversation[];
+    /**
+     * Reopen an archived conversation as the LIVE one.
+     *
+     * Resuming rather than previewing: the gateway keeps its own thread
+     * state keyed on the conversation id, so restoring the id means the
+     * model still has the context the visitor is looking at. A read-only
+     * view would show a conversation they cannot continue, which is the one
+     * thing "go back to my chat" does not mean.
+     */
+    openConversation(id: string): void;
+    deleteConversation(id: string): void;
+    clearHistory(): void;
+    /**
+     * Pull the project's own mode, theme, intro and locale from the gateway.
+     *
+     * Fire-and-forget on purpose: the widget is fully usable before this
+     * resolves and stays usable if it never does. A visitor must never be
+     * left unable to type because a styling fetch was slow, so every failure
+     * path here is a silent fall back to the built-in brand kit rather than
+     * an error the visitor has to read.
+     */
+    private loadRemoteConfig;
+    /** Show or hide the voice controls to match the resolved mode. Removing
+     * them rather than disabling them: a greyed-out microphone still
+     * promises voice the project has switched off. */
+    private applyMode;
+    private handleKeydown;
+    private handleKeyup;
+    /**
+     * What a completed hold does: START talking, never stop.
+     *
+     * The panel advertises this as "Hold ^ to talk". A visitor who keeps
+     * holding while they speak — which is what those words invite — was
+     * hanging up on themselves, because the hold used to call toggle() and
+     * the second completed hold ended the session. Ending a conversation is
+     * the badge's job, and the badge tooltip already says so.
+     */
+    private activate;
+    /** Releasing early, pressing another key, or leaving the tab all mean the
+     *  hold did not happen. Letting a stale timer survive any of those is how
+     *  a widget opens itself for no reason the visitor can see. */
+    private cancelHold;
+    private setStatus;
+    private emitError;
+    get currentStatus(): DabaAgentStatus;
+    get isActive(): boolean;
+    get isChatOpen(): boolean;
+    openChat(): void;
+    closeChat(): void;
+    toggleChat(): void;
+    /**
+     * Send one typed message.
+     *
+     * This used to call `startSession()`, which opens the Realtime
+     * WebSocket, and `onSocketOpen` then unconditionally grabbed the
+     * microphone — so typing a sentence demanded microphone permission and
+     * was billed as voice minutes. Typing now goes over plain HTTP and
+     * touches neither the mic, the AudioContext nor the socket.
+     *
+     * The one exception is a voice session that is ALREADY live: injecting
+     * the text there keeps a single continuous conversation, which is what a
+     * visitor switching medium mid-sentence expects. It is not a reason to
+     * start a session that does not exist.
+     */
+    sendText(text: string): Promise<void>;
+    private sendChatMessage;
+    /**
+     * Start a new conversation: clear the transcript, forget the history the
+     * gateway is keyed on, and put the intro back. A fresh id rather than a
+     * reset flag, so the old thread simply expires on its own TTL instead of
+     * needing a round trip to delete.
+     */
+    resetConversation(): void;
+    /** Voice, explicitly. Never reached in chat mode — the controls that
+     * would call it are not rendered there. */
+    private toggleVoice;
+    private handleTranscriptDelta;
+    toggle(): Promise<void>;
+    private get usesLiveEngine();
+    private startLiveSession;
+    private runVoiceTool;
+    private startSession;
+    private tryReattach;
+    private attachWebSocket;
+    private onSocketOpen;
+    private onMicFrame;
+    private onSocketMessage;
+    private executeTool;
+    private handleToolCall;
+    private stopSession;
+    private handleSocketClose;
+    private flashBadgeError;
+    private cleanupAfterClose;
+    destroy(): void;
+}
+
+type DabaAgentElementConstructor = new () => DabaAgentElement;
+/**
+ * The element's public shape.
+ *
+ * A type, not a class: `class ... extends HTMLElement` evaluates its
+ * extends clause the moment the module does, and on a server there is no
+ * HTMLElement — which is why importing the package root from a Next.js
+ * layout threw "HTMLElement is not defined" and forced every integrator
+ * into a dynamic import inside an effect. The real class is built by
+ * defineDabaAgentElement(), which only ever runs in a browser.
+ */
+interface DabaAgentElement extends HTMLElement {
+    readonly dabaAgent: DabaAgent | null;
+    sendText(text: string): Promise<void> | undefined;
+    openChat(): void;
+    closeChat(): void;
+    toggleChat(): void;
+}
+declare let DabaAgentElement: DabaAgentElementConstructor | undefined;
+declare function defineDabaAgentElement(tagName?: string): void;
+
+export { DabaAgent as D, DabaAgentElement, type DabaAgentElementConstructor, type StoredConversation as S, defineDabaAgentElement };

package/dist/custom-element.js

@@ -1,4 +1,4 @@
-export { DabaAgentElement, defineDabaAgentElement } from './chunk-WJQ444GI.js';
-import './chunk-G22V7GGM.js';
+export { DabaAgentElement, defineDabaAgentElement } from './chunk-TYOHYQDK.js';
+import './chunk-ETI4LRM7.js';
 //# sourceMappingURL=custom-element.js.map
 //# sourceMappingURL=custom-element.js.map

package/dist/daba-agent.cjs

@@ -1,30 +1,21 @@
 'use strict';
 
-var chunkZXZX2D55_cjs = require('./chunk-ZXZX2D55.cjs');
-var chunkEF6D33VT_cjs = require('./chunk-EF6D33VT.cjs');
-var chunkN4TBGDUO_cjs = require('./chunk-N4TBGDUO.cjs');
+var chunk3BQ6LE6X_cjs = require('./chunk-3BQ6LE6X.cjs');
+var chunkVAIC5ACS_cjs = require('./chunk-VAIC5ACS.cjs');
 
 
 
-Object.defineProperty(exports, "DabaAgentComponent", {
-  enumerable: true,
-  get: function () { return chunkZXZX2D55_cjs.DabaAgentComponent; }
-});
-Object.defineProperty(exports, "DabaAgentReact", {
-  enumerable: true,
-  get: function () { return chunkZXZX2D55_cjs.DabaAgentComponent; }
-});
 Object.defineProperty(exports, "DabaAgentElement", {
   enumerable: true,
-  get: function () { return chunkEF6D33VT_cjs.DabaAgentElement; }
+  get: function () { return chunk3BQ6LE6X_cjs.DabaAgentElement; }
 });
 Object.defineProperty(exports, "defineDabaAgentElement", {
   enumerable: true,
-  get: function () { return chunkEF6D33VT_cjs.defineDabaAgentElement; }
+  get: function () { return chunk3BQ6LE6X_cjs.defineDabaAgentElement; }
 });
 Object.defineProperty(exports, "DabaAgent", {
   enumerable: true,
-  get: function () { return chunkN4TBGDUO_cjs.DabaAgent; }
+  get: function () { return chunkVAIC5ACS_cjs.DabaAgent; }
 });
 //# sourceMappingURL=daba-agent.cjs.map
 //# sourceMappingURL=daba-agent.cjs.map

package/dist/daba-agent.d.cts

@@ -1,4 +1,2 @@
-export { D as DabaAgent, a as DabaAgentElement, d as defineDabaAgentElement } from './custom-element-XiZg8UN8.cjs';
-export { DabaAgent as DabaAgentComponent, DabaAgentProps, DabaAgent as DabaAgentReact } from './react.cjs';
-export { C as ChatMessage, D as DabaAgentMode, a as DabaAgentOptions, b as DabaAgentPosition, c as DabaAgentStatus, d as DabaError } from './types-DYRGPzyp.cjs';
-import 'react';
+export { D as DabaAgent, DabaAgentElement, DabaAgentElementConstructor, S as StoredConversation, defineDabaAgentElement } from './custom-element.cjs';
+export { C as ChatMessage, b as DabaAgentMode, D as DabaAgentOptions, c as DabaAgentPosition, a as DabaAgentStatus, d as DabaCard, e as DabaCardKind, f as DabaCardMeta, g as DabaChatReply, h as DabaDirection, i as DabaError, j as DabaIntro, k as DabaLauncher, l as DabaLauncherShape, m as DabaPanel, n as DabaRemoteConfig, o as DabaTheme, p as DabaThemePreference, q as DabaVoiceEngine } from './types-BQRgqD4n.cjs';

package/dist/daba-agent.d.ts

@@ -1,4 +1,2 @@
-export { D as DabaAgent, a as DabaAgentElement, d as defineDabaAgentElement } from './custom-element-CpPr7b2Z.js';
-export { DabaAgent as DabaAgentComponent, DabaAgentProps, DabaAgent as DabaAgentReact } from './react.js';
-export { C as ChatMessage, D as DabaAgentMode, a as DabaAgentOptions, b as DabaAgentPosition, c as DabaAgentStatus, d as DabaError } from './types-DYRGPzyp.js';
-import 'react';
+export { D as DabaAgent, DabaAgentElement, DabaAgentElementConstructor, S as StoredConversation, defineDabaAgentElement } from './custom-element.js';
+export { C as ChatMessage, b as DabaAgentMode, D as DabaAgentOptions, c as DabaAgentPosition, a as DabaAgentStatus, d as DabaCard, e as DabaCardKind, f as DabaCardMeta, g as DabaChatReply, h as DabaDirection, i as DabaError, j as DabaIntro, k as DabaLauncher, l as DabaLauncherShape, m as DabaPanel, n as DabaRemoteConfig, o as DabaTheme, p as DabaThemePreference, q as DabaVoiceEngine } from './types-BQRgqD4n.js';

package/dist/daba-agent.js

@@ -1,5 +1,4 @@
-export { DabaAgentComponent, DabaAgentComponent as DabaAgentReact } from './chunk-QM6HDEVV.js';
-export { DabaAgentElement, defineDabaAgentElement } from './chunk-WJQ444GI.js';
-export { DabaAgent } from './chunk-G22V7GGM.js';
+export { DabaAgentElement, defineDabaAgentElement } from './chunk-TYOHYQDK.js';
+export { DabaAgent } from './chunk-ETI4LRM7.js';
 //# sourceMappingURL=daba-agent.js.map
 //# sourceMappingURL=daba-agent.js.map