npm - @nextpa/chat-core - Versions diffs - 0.1.0 - Mend

@nextpa/chat-core 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (149) hide show

package/LICENSE +21 -0
package/README.md +53 -0
package/dist/constants/defaults.d.ts +6 -0
package/dist/constants/defaults.js +69 -0
package/dist/core/chat-manager.d.ts +17 -0
package/dist/core/chat-manager.js +39 -0
package/dist/core/config-manager.d.ts +14 -0
package/dist/core/config-manager.js +75 -0
package/dist/core/connection-manager.d.ts +68 -0
package/dist/core/connection-manager.js +273 -0
package/dist/core/connection-retry-handler.d.ts +11 -0
package/dist/core/connection-retry-handler.js +33 -0
package/dist/core/consent-manager.d.ts +15 -0
package/dist/core/consent-manager.js +40 -0
package/dist/core/conversation-persistence.d.ts +23 -0
package/dist/core/conversation-persistence.js +109 -0
package/dist/core/event-emitter.d.ts +7 -0
package/dist/core/event-emitter.js +27 -0
package/dist/core/greeting-gate.d.ts +16 -0
package/dist/core/greeting-gate.js +53 -0
package/dist/core/index.d.ts +9 -0
package/dist/core/index.js +7 -0
package/dist/core/link-target.d.ts +15 -0
package/dist/core/link-target.js +64 -0
package/dist/core/local-storage-persistence.d.ts +11 -0
package/dist/core/local-storage-persistence.js +111 -0
package/dist/core/navigation-manager.d.ts +24 -0
package/dist/core/navigation-manager.js +132 -0
package/dist/core/popover-manager.d.ts +14 -0
package/dist/core/popover-manager.js +36 -0
package/dist/core/session-beacon.d.ts +11 -0
package/dist/core/session-beacon.js +60 -0
package/dist/core/text-connection-manager.d.ts +58 -0
package/dist/core/text-connection-manager.js +200 -0
package/dist/core/text-mode-manager.d.ts +50 -0
package/dist/core/text-mode-manager.js +154 -0
package/dist/core/text-types.d.ts +20 -0
package/dist/core/text-types.js +1 -0
package/dist/core/text-widget-controller.d.ts +47 -0
package/dist/core/text-widget-controller.js +278 -0
package/dist/core/theme-manager.d.ts +10 -0
package/dist/core/theme-manager.js +25 -0
package/dist/core/types.d.ts +50 -0
package/dist/core/types.js +1 -0
package/dist/core/voice-state-manager.d.ts +85 -0
package/dist/core/voice-state-manager.js +317 -0
package/dist/core/widget-controller.d.ts +58 -0
package/dist/core/widget-controller.js +533 -0
package/dist/core/widget-core.d.ts +51 -0
package/dist/core/widget-core.js +160 -0
package/dist/google.d.ts +1 -0
package/dist/google.js +12 -0
package/dist/index.d.ts +37 -0
package/dist/index.js +40 -0
package/dist/openai.d.ts +1 -0
package/dist/openai.js +7 -0
package/dist/services/api.d.ts +114 -0
package/dist/services/api.js +336 -0
package/dist/services/index.d.ts +3 -0
package/dist/services/index.js +3 -0
package/dist/services/page-interaction/constants.d.ts +1 -0
package/dist/services/page-interaction/constants.js +1 -0
package/dist/services/page-interaction/content-extractor.d.ts +2 -0
package/dist/services/page-interaction/content-extractor.js +104 -0
package/dist/services/page-interaction/deep-query.d.ts +8 -0
package/dist/services/page-interaction/deep-query.js +44 -0
package/dist/services/page-interaction/dom-executor.d.ts +7 -0
package/dist/services/page-interaction/dom-executor.js +172 -0
package/dist/services/page-interaction/dom-extractor.d.ts +8 -0
package/dist/services/page-interaction/dom-extractor.js +252 -0
package/dist/services/page-interaction/extension-bridge.d.ts +10 -0
package/dist/services/page-interaction/extension-bridge.js +86 -0
package/dist/services/page-interaction/iframe-navigation-manager.d.ts +28 -0
package/dist/services/page-interaction/iframe-navigation-manager.js +154 -0
package/dist/services/page-interaction/index.d.ts +5 -0
package/dist/services/page-interaction/index.js +4 -0
package/dist/services/page-interaction/page-interaction-handler.d.ts +21 -0
package/dist/services/page-interaction/page-interaction-handler.js +129 -0
package/dist/services/page-interaction/selector-generator.d.ts +1 -0
package/dist/services/page-interaction/selector-generator.js +48 -0
package/dist/services/page-interaction/types.d.ts +75 -0
package/dist/services/page-interaction/types.js +1 -0
package/dist/services/realtime/google/google-audio.d.ts +44 -0
package/dist/services/realtime/google/google-audio.js +410 -0
package/dist/services/realtime/google/google-provider.d.ts +47 -0
package/dist/services/realtime/google/google-provider.js +465 -0
package/dist/services/realtime/google/google-tool-mapper.d.ts +3 -0
package/dist/services/realtime/google/google-tool-mapper.js +70 -0
package/dist/services/realtime/google/index.d.ts +1 -0
package/dist/services/realtime/google/index.js +1 -0
package/dist/services/realtime/openai/index.d.ts +1 -0
package/dist/services/realtime/openai/index.js +1 -0
package/dist/services/realtime/openai/openai-audio-monitor.d.ts +1 -0
package/dist/services/realtime/openai/openai-audio-monitor.js +55 -0
package/dist/services/realtime/openai/openai-provider.d.ts +50 -0
package/dist/services/realtime/openai/openai-provider.js +579 -0
package/dist/services/realtime/openai/openai-tool-mapper.d.ts +15 -0
package/dist/services/realtime/openai/openai-tool-mapper.js +14 -0
package/dist/services/realtime/provider-factory.d.ts +4 -0
package/dist/services/realtime/provider-factory.js +12 -0
package/dist/services/realtime/types.d.ts +78 -0
package/dist/services/realtime/types.js +1 -0
package/dist/services/realtime/vertexai/index.d.ts +1 -0
package/dist/services/realtime/vertexai/index.js +1 -0
package/dist/services/realtime/vertexai/vertexai-provider.d.ts +53 -0
package/dist/services/realtime/vertexai/vertexai-provider.js +561 -0
package/dist/services/realtime/voice-session-tracker.d.ts +10 -0
package/dist/services/realtime/voice-session-tracker.js +62 -0
package/dist/services/signalr.d.ts +37 -0
package/dist/services/signalr.js +145 -0
package/dist/services/thinking-audio-pulse.d.ts +2 -0
package/dist/services/thinking-audio-pulse.js +72 -0
package/dist/services/thinking-audio.d.ts +2 -0
package/dist/services/thinking-audio.js +105 -0
package/dist/services/voice-health-watchdog.d.ts +42 -0
package/dist/services/voice-health-watchdog.js +90 -0
package/dist/services/webrtc-event-handler.d.ts +4 -0
package/dist/services/webrtc-event-handler.js +42 -0
package/dist/services/webrtc-greeting.d.ts +3 -0
package/dist/services/webrtc-greeting.js +62 -0
package/dist/services/webrtc-microphone.d.ts +15 -0
package/dist/services/webrtc-microphone.js +64 -0
package/dist/services/webrtc.d.ts +44 -0
package/dist/services/webrtc.js +196 -0
package/dist/types/index.d.ts +151 -0
package/dist/types/index.js +1 -0
package/dist/utils/audio-context.d.ts +11 -0
package/dist/utils/audio-context.js +33 -0
package/dist/utils/connect-chime.d.ts +11 -0
package/dist/utils/connect-chime.js +230 -0
package/dist/utils/consent.d.ts +4 -0
package/dist/utils/consent.js +30 -0
package/dist/utils/language-detection.d.ts +1 -0
package/dist/utils/language-detection.js +17 -0
package/dist/utils/logger.d.ts +13 -0
package/dist/utils/logger.js +40 -0
package/dist/utils/mic-level-analyser.d.ts +13 -0
package/dist/utils/mic-level-analyser.js +50 -0
package/dist/utils/proactive-events.d.ts +5 -0
package/dist/utils/proactive-events.js +1 -0
package/dist/utils/styles.d.ts +4 -0
package/dist/utils/styles.js +35 -0
package/dist/utils/theme-detection.d.ts +3 -0
package/dist/utils/theme-detection.js +121 -0
package/dist/utils/tool-status.d.ts +10 -0
package/dist/utils/tool-status.js +61 -0
package/dist/utils/ui-sounds.d.ts +3 -0
package/dist/utils/ui-sounds.js +57 -0
package/package.json +56 -0

package/dist/utils/consent.js ADDED Viewed

@@ -0,0 +1,30 @@
+const CONSENT_COOKIE_PREFIX = 'nextpa_tc_consent_';
+const CONSENT_EXPIRY_DAYS = 365;
+export function getConsentCookieName(assistantId) {
+    return `${CONSENT_COOKIE_PREFIX}${assistantId}`;
+}
+export function hasUserConsented(assistantId) {
+    const cookieName = getConsentCookieName(assistantId);
+    const cookies = document.cookie.split(';');
+    for (const cookie of cookies) {
+        const [name, value] = cookie.trim().split('=');
+        if (name === cookieName && value === 'true') {
+            return true;
+        }
+    }
+    return false;
+}
+export function setUserConsent(assistantId, consented) {
+    const cookieName = getConsentCookieName(assistantId);
+    if (consented) {
+        const expiryDate = new Date();
+        expiryDate.setDate(expiryDate.getDate() + CONSENT_EXPIRY_DAYS);
+        document.cookie = `${cookieName}=true; expires=${expiryDate.toUTCString()}; path=/; SameSite=Lax`;
+    }
+    else {
+        document.cookie = `${cookieName}=; expires=Thu, 01 Jan 1970 00:00:00 UTC; path=/;`;
+    }
+}
+export function clearUserConsent(assistantId) {
+    setUserConsent(assistantId, false);
+}

package/dist/utils/language-detection.d.ts ADDED Viewed

	@@ -0,0 +1 @@
1	+ export declare function detectHostLanguage(): string \| null;

package/dist/utils/language-detection.js ADDED Viewed

@@ -0,0 +1,17 @@
+import { logger } from './logger';
+export function detectHostLanguage() {
+    try {
+        const lang = document.documentElement.lang;
+        if (!lang) {
+            logger.debug('[LanguageDetection] No lang attribute on <html> element');
+            return null;
+        }
+        const baseLang = lang.split('-')[0].toLowerCase();
+        logger.debug('[LanguageDetection] Detected host language:', baseLang);
+        return baseLang;
+    }
+    catch {
+        logger.debug('[LanguageDetection] Failed to detect host language');
+        return null;
+    }
+}

package/dist/utils/logger.d.ts ADDED Viewed

@@ -0,0 +1,13 @@
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'none';
+declare class Logger {
+    private level;
+    private readonly prefix;
+    setLevel(level: LogLevel): void;
+    private shouldLog;
+    debug(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+}
+export declare const logger: Logger;
+export {};

package/dist/utils/logger.js ADDED Viewed

@@ -0,0 +1,40 @@
+const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+    none: 4,
+};
+class Logger {
+    level = 'info';
+    prefix = '[NextPA Widget]';
+    setLevel(level) {
+        this.level = level;
+    }
+    shouldLog(level) {
+        return LOG_LEVELS[level] >= LOG_LEVELS[this.level];
+    }
+    debug(...args) {
+        if (this.shouldLog('debug')) {
+            console.debug(this.prefix, ...args);
+        }
+    }
+    info(...args) {
+        if (this.shouldLog('info')) {
+            console.info(this.prefix, ...args);
+        }
+    }
+    warn(...args) {
+        if (this.shouldLog('warn')) {
+            console.warn(this.prefix, ...args);
+        }
+    }
+    error(...args) {
+        if (this.shouldLog('error')) {
+            console.error(this.prefix, ...args);
+        }
+    }
+}
+export const logger = new Logger();
+// Framework-neutral default; the host app raises/lowers verbosity via
+// `logger.setLevel(...)` (no build-time env coupling in the shared engine).

package/dist/utils/mic-level-analyser.d.ts ADDED Viewed

@@ -0,0 +1,13 @@
+/**
+ * Reports a 0..1 microphone amplitude (time-domain RMS) from a MediaStream each
+ * animation frame. Drives recording level meters (e.g. the dictation waveform)
+ * without needing a realtime connection. Fails silently if Web Audio is
+ * unavailable — the level simply stays at its last value.
+ */
+export declare class MicLevelAnalyser {
+    private context;
+    private analyser;
+    private rafId;
+    start(stream: MediaStream, onLevel: (level: number) => void): void;
+    stop(): void;
+}

package/dist/utils/mic-level-analyser.js ADDED Viewed

@@ -0,0 +1,50 @@
+/**
+ * Reports a 0..1 microphone amplitude (time-domain RMS) from a MediaStream each
+ * animation frame. Drives recording level meters (e.g. the dictation waveform)
+ * without needing a realtime connection. Fails silently if Web Audio is
+ * unavailable — the level simply stays at its last value.
+ */
+export class MicLevelAnalyser {
+    context = null;
+    analyser = null;
+    rafId = null;
+    start(stream, onLevel) {
+        this.stop();
+        try {
+            this.context = new AudioContext();
+            const source = this.context.createMediaStreamSource(stream);
+            this.analyser = this.context.createAnalyser();
+            // 1024 samples ≈ 21 ms at 48 kHz — reacts to syllables, stable for RMS.
+            this.analyser.fftSize = 1024;
+            this.analyser.smoothingTimeConstant = 0.4;
+            source.connect(this.analyser);
+            const buffer = new Float32Array(this.analyser.fftSize);
+            const tick = () => {
+                if (!this.analyser)
+                    return;
+                this.analyser.getFloatTimeDomainData(buffer);
+                let sumSquares = 0;
+                for (const sample of buffer) {
+                    sumSquares += sample * sample;
+                }
+                onLevel(Math.min(1, Math.sqrt(sumSquares / buffer.length)));
+                this.rafId = requestAnimationFrame(tick);
+            };
+            this.rafId = requestAnimationFrame(tick);
+        }
+        catch {
+            this.stop();
+        }
+    }
+    stop() {
+        if (this.rafId !== null) {
+            cancelAnimationFrame(this.rafId);
+            this.rafId = null;
+        }
+        this.analyser = null;
+        if (this.context) {
+            void this.context.close();
+            this.context = null;
+        }
+    }
+}

package/dist/utils/proactive-events.d.ts ADDED Viewed

@@ -0,0 +1,5 @@
+export declare const PROACTIVE_OPEN_WIDGET_EVENT = "nextpa-widget:open-with-prompt";
+export interface ProactiveOpenWidgetEventDetail {
+    readonly prompt: string | null;
+}
+export type ProactiveOpenWidgetEvent = CustomEvent<ProactiveOpenWidgetEventDetail>;

package/dist/utils/proactive-events.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export const PROACTIVE_OPEN_WIDGET_EVENT = 'nextpa-widget:open-with-prompt';

package/dist/utils/styles.d.ts ADDED Viewed

@@ -0,0 +1,4 @@
+import type { WidgetConfig } from '../types';
+export declare function getPlacementClasses(placement: WidgetConfig['placement'] | undefined): string;
+export declare function getMinimizedWidthClasses(size: WidgetConfig['size'] | undefined): string;
+export declare function getMessageBubbleClasses(isUser: boolean, isDark: boolean): string;

package/dist/utils/styles.js ADDED Viewed

@@ -0,0 +1,35 @@
+export function getPlacementClasses(placement) {
+    switch (placement) {
+        case 'top-left':
+            return 'top-5 left-5';
+        case 'top-center':
+            return 'top-5 left-1/2 -translate-x-1/2';
+        case 'top-right':
+            return 'top-5 right-5';
+        case 'bottom-left':
+            return 'bottom-5 left-5';
+        case 'bottom-center':
+            return 'bottom-5 left-1/2 -translate-x-1/2';
+        case 'bottom-right':
+        default:
+            return 'bottom-5 right-5';
+    }
+}
+export function getMinimizedWidthClasses(size) {
+    switch (size) {
+        case 'small':
+            return 'min-w-[104px] w-auto';
+        case 'large':
+            return 'min-w-[232px] max-w-[320px] w-auto';
+        case 'compact':
+        default:
+            return 'min-w-[200px] max-w-[280px] w-auto';
+    }
+}
+export function getMessageBubbleClasses(isUser, isDark) {
+    const base = 'max-w-[90%] break-words rounded-2xl border px-3 py-2.5 text-sm leading-relaxed';
+    if (isUser) {
+        return `${base} whitespace-pre-wrap self-end ${isDark ? 'border-blue-500/30 bg-blue-600 text-white' : 'border-blue-500/20 bg-blue-500/10 text-gray-900'}`;
+    }
+    return `${base} self-start ${isDark ? 'border-gray-700 bg-gray-800 text-gray-100' : 'border-gray-200 bg-gray-100 text-gray-900'}`;
+}

package/dist/utils/theme-detection.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+export type ResolvedTheme = 'light' | 'dark';
+export declare function detectHostTheme(): ResolvedTheme;
+export declare function observeThemeChanges(callback: (theme: ResolvedTheme) => void): () => void;

package/dist/utils/theme-detection.js ADDED Viewed

@@ -0,0 +1,121 @@
+import { logger } from './logger';
+export function detectHostTheme() {
+    const root = document.documentElement;
+    const body = document.body;
+    if (hasDarkClass(root) || hasDarkClass(body)) {
+        logger.debug('[ThemeDetection] Detected dark theme via CSS class on html/body');
+        return 'dark';
+    }
+    if (hasLightClass(root) || hasLightClass(body)) {
+        logger.debug('[ThemeDetection] Detected light theme via CSS class on html/body');
+        return 'light';
+    }
+    if (hasDarkDataAttribute(root) || hasDarkDataAttribute(body)) {
+        logger.debug('[ThemeDetection] Detected dark theme via data attribute on html/body');
+        return 'dark';
+    }
+    if (hasLightDataAttribute(root) || hasLightDataAttribute(body)) {
+        logger.debug('[ThemeDetection] Detected light theme via data attribute on html/body');
+        return 'light';
+    }
+    const domTheme = detectThemeFromDomElements();
+    if (domTheme) {
+        logger.debug('[ThemeDetection] Detected', domTheme, 'theme via DOM element');
+        return domTheme;
+    }
+    if (globalThis.matchMedia('(prefers-color-scheme: dark)').matches) {
+        logger.debug('[ThemeDetection] Detected dark theme via system preference');
+        return 'dark';
+    }
+    logger.debug('[ThemeDetection] Defaulting to light theme');
+    return 'light';
+}
+function detectThemeFromDomElements() {
+    const darkClassSelectors = '.dark, .dark-mode, .theme-dark, .dark-theme';
+    const lightClassSelectors = '.light, .light-mode, .theme-light, .light-theme';
+    const dataAttributeSelectors = '[data-theme], [data-mode], [data-bs-theme], [data-color-scheme]';
+    const darkElement = document.querySelector(darkClassSelectors);
+    if (darkElement) {
+        return 'dark';
+    }
+    const lightElement = document.querySelector(lightClassSelectors);
+    if (lightElement) {
+        return 'light';
+    }
+    const elementsWithDataAttr = document.querySelectorAll(dataAttributeSelectors);
+    for (const element of elementsWithDataAttr) {
+        if (element instanceof HTMLElement) {
+            if (hasDarkDataAttribute(element)) {
+                return 'dark';
+            }
+            if (hasLightDataAttribute(element)) {
+                return 'light';
+            }
+        }
+    }
+    return null;
+}
+function hasDarkClass(element) {
+    return (element.classList.contains('dark') ||
+        element.classList.contains('dark-mode') ||
+        element.classList.contains('theme-dark') ||
+        element.classList.contains('dark-theme'));
+}
+function hasLightClass(element) {
+    return (element.classList.contains('light') ||
+        element.classList.contains('light-mode') ||
+        element.classList.contains('theme-light') ||
+        element.classList.contains('light-theme'));
+}
+function hasDarkDataAttribute(element) {
+    return (element.dataset.theme === 'dark' ||
+        element.dataset.mode === 'dark' ||
+        element.dataset.bsTheme === 'dark' ||
+        element.dataset.colorScheme === 'dark');
+}
+function hasLightDataAttribute(element) {
+    return (element.dataset.theme === 'light' ||
+        element.dataset.mode === 'light' ||
+        element.dataset.bsTheme === 'light' ||
+        element.dataset.colorScheme === 'light');
+}
+export function observeThemeChanges(callback) {
+    let currentTheme = detectHostTheme();
+    let debounceTimer = null;
+    const handlePotentialThemeChange = () => {
+        if (debounceTimer) {
+            clearTimeout(debounceTimer);
+        }
+        debounceTimer = setTimeout(() => {
+            const newTheme = detectHostTheme();
+            if (newTheme !== currentTheme) {
+                currentTheme = newTheme;
+                logger.debug('[ThemeDetection] Theme changed to:', newTheme);
+                callback(newTheme);
+            }
+        }, 50);
+    };
+    const observer = new MutationObserver(handlePotentialThemeChange);
+    observer.observe(document.documentElement, {
+        attributes: true,
+        attributeFilter: ['class', 'data-theme', 'data-mode', 'data-bs-theme', 'data-color-scheme'],
+        subtree: true,
+    });
+    const mediaQuery = globalThis.matchMedia('(prefers-color-scheme: dark)');
+    const mediaQueryHandler = () => {
+        const newTheme = detectHostTheme();
+        if (newTheme !== currentTheme) {
+            currentTheme = newTheme;
+            logger.debug('[ThemeDetection] System preference changed, theme is now:', newTheme);
+            callback(newTheme);
+        }
+    };
+    mediaQuery.addEventListener('change', mediaQueryHandler);
+    return () => {
+        if (debounceTimer) {
+            clearTimeout(debounceTimer);
+        }
+        observer.disconnect();
+        mediaQuery.removeEventListener('change', mediaQueryHandler);
+    };
+}

package/dist/utils/tool-status.d.ts ADDED Viewed

@@ -0,0 +1,10 @@
+export declare function isGerman(language?: string): boolean;
+export declare const DELEGATION_TOOLS: Set<string>;
+export declare function getIntermediateStatus(language?: string): string;
+export declare function getSynthesizingStatus(language?: string): string;
+export declare function getToolStatusLabel(toolName: string, language?: string): string;
+export interface ToolCallState {
+    readonly agentStatus: string | null;
+    readonly isDelegationActive: boolean;
+}
+export declare function resolveToolCallState(toolName: string, status: string, isDelegationActive: boolean, language?: string, agentLabel?: string): ToolCallState;

package/dist/utils/tool-status.js ADDED Viewed

@@ -0,0 +1,61 @@
+const toolStatusLabelsDe = {
+    search_web: 'Durchsuche das Web...',
+    fetch_page: 'Lade Webseite...',
+    fetch_pages: 'Lade mehrere Webseiten...',
+    read_page: 'Lese Seiteninhalt...',
+    fill_fields: 'Fülle Formularfelder aus...',
+    click_element: 'Klicke auf Element...',
+    navigate_to: 'Navigiere...',
+    delegate_research: 'Recherchiere...',
+    interact_with_page: 'Arbeite auf der Seite...',
+    fan_out_research: 'Parallele Recherche...',
+};
+const toolStatusLabelsEn = {
+    search_web: 'Searching the web...',
+    fetch_page: 'Reading a web page...',
+    fetch_pages: 'Reading multiple pages...',
+    read_page: 'Reading page content...',
+    fill_fields: 'Filling form fields...',
+    click_element: 'Clicking element...',
+    navigate_to: 'Navigating...',
+    delegate_research: 'Researching...',
+    interact_with_page: 'Working on page...',
+    fan_out_research: 'Parallel research...',
+};
+export function isGerman(language) {
+    return language?.startsWith('de') ?? true;
+}
+export const DELEGATION_TOOLS = new Set(['delegate_research', 'interact_with_page', 'fan_out_research']);
+export function getIntermediateStatus(language) {
+    return isGerman(language) ? 'Analysiere Ergebnisse...' : 'Analyzing results...';
+}
+export function getSynthesizingStatus(language) {
+    return isGerman(language) ? 'Bereite Antwort vor...' : 'Preparing response...';
+}
+export function getToolStatusLabel(toolName, language) {
+    const labels = isGerman(language) ? toolStatusLabelsDe : toolStatusLabelsEn;
+    const fallback = isGerman(language) ? 'Arbeite...' : 'Working...';
+    return labels[toolName] ?? fallback;
+}
+export function resolveToolCallState(toolName, status, isDelegationActive, language, agentLabel) {
+    if (status === 'started' || status === 'in_progress') {
+        const baseLabel = getToolStatusLabel(toolName, language);
+        const label = agentLabel ? `${agentLabel}: ${baseLabel}` : baseLabel;
+        return {
+            agentStatus: label,
+            isDelegationActive: isDelegationActive || DELEGATION_TOOLS.has(toolName),
+        };
+    }
+    if (status === 'synthesizing' && isDelegationActive) {
+        return { agentStatus: getSynthesizingStatus(language), isDelegationActive };
+    }
+    if (DELEGATION_TOOLS.has(toolName) && (status === 'completed' || status === 'failed')) {
+        return { agentStatus: getSynthesizingStatus(language), isDelegationActive: false };
+    }
+    if (isDelegationActive) {
+        const baseLabel = getIntermediateStatus(language);
+        const label = agentLabel ? `${agentLabel}: ${baseLabel}` : baseLabel;
+        return { agentStatus: label, isDelegationActive };
+    }
+    return { agentStatus: null, isDelegationActive };
+}

package/dist/utils/ui-sounds.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+export declare function playMuteSound(): void;
+export declare function playUnmuteSound(): void;
+export declare function playEndCallSound(): void;

package/dist/utils/ui-sounds.js ADDED Viewed

@@ -0,0 +1,57 @@
+import { getSharedAudioContext, withResumedContext } from './audio-context';
+import { logger } from './logger';
+const MUTE_PULSES = [
+    { frequency: 523.25, durationSec: 0.06 },
+    { frequency: 349.23, durationSec: 0.08 },
+];
+const UNMUTE_PULSES = [
+    { frequency: 349.23, durationSec: 0.06 },
+    { frequency: 523.25, durationSec: 0.08 },
+];
+const END_CALL_PULSES = [
+    { frequency: 440, durationSec: 0.07 },
+    { frequency: 329.63, durationSec: 0.07 },
+    { frequency: 246.94, durationSec: 0.1 },
+];
+const PEAK_GAIN = 0.18;
+const ATTACK_SEC = 0.004;
+const HOLD_SEC = 0.01;
+const GAP_SEC = 0.015;
+function schedulePulse(ctx, pulse, startAt, destination) {
+    const envelope = ctx.createGain();
+    const peakAt = startAt + ATTACK_SEC;
+    const holdEnd = peakAt + HOLD_SEC;
+    const releaseAt = startAt + pulse.durationSec;
+    envelope.gain.setValueAtTime(0.0001, startAt);
+    envelope.gain.exponentialRampToValueAtTime(PEAK_GAIN, peakAt);
+    envelope.gain.setValueAtTime(PEAK_GAIN, holdEnd);
+    envelope.gain.exponentialRampToValueAtTime(0.0001, releaseAt);
+    envelope.connect(destination);
+    const osc = ctx.createOscillator();
+    osc.type = 'sine';
+    osc.frequency.value = pulse.frequency;
+    osc.connect(envelope);
+    osc.start(startAt);
+    osc.stop(releaseAt + 0.02);
+}
+function playPulseSequence(label, pulses) {
+    const ctx = getSharedAudioContext();
+    if (!ctx)
+        return;
+    withResumedContext(ctx, () => {
+        let cursor = ctx.currentTime + 0.01;
+        for (const pulse of pulses) {
+            schedulePulse(ctx, pulse, cursor, ctx.destination);
+            cursor += pulse.durationSec + GAP_SEC;
+        }
+    }, (err) => logger.debug(`[UiSounds] ${label} failed`, err));
+}
+export function playMuteSound() {
+    playPulseSequence('mute', MUTE_PULSES);
+}
+export function playUnmuteSound() {
+    playPulseSequence('unmute', UNMUTE_PULSES);
+}
+export function playEndCallSound() {
+    playPulseSequence('end-call', END_CALL_PULSES);
+}

package/package.json ADDED Viewed

@@ -0,0 +1,56 @@
+{
+    "name": "@nextpa/chat-core",
+    "version": "0.1.0",
+    "description": "Framework-neutral voice & text chat engine for the NextPA platform.",
+    "type": "module",
+    "license": "MIT",
+    "homepage": "https://developers.nextpa.dev",
+    "bugs": {
+        "url": "https://developers.nextpa.dev"
+    },
+    "keywords": [
+        "nextpa",
+        "chat",
+        "voice",
+        "realtime",
+        "ai",
+        "assistant",
+        "sdk",
+        "openai",
+        "gemini"
+    ],
+    "publishConfig": {
+        "access": "public"
+    },
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "default": "./dist/index.js"
+        },
+        "./openai": {
+            "types": "./dist/openai.d.ts",
+            "default": "./dist/openai.js"
+        },
+        "./google": {
+            "types": "./dist/google.d.ts",
+            "default": "./dist/google.js"
+        },
+        "./package.json": "./package.json"
+    },
+    "files": [
+        "dist"
+    ],
+    "peerDependencies": {
+        "@google/genai": "^2.8.0",
+        "@microsoft/signalr": "^10.0.0",
+        "@openai/agents-realtime": "^0.11.6"
+    },
+    "peerDependenciesMeta": {
+        "@google/genai": {
+            "optional": true
+        },
+        "@openai/agents-realtime": {
+            "optional": true
+        }
+    }
+}