@agent-native/toolkit 0.5.0 → 0.6.0

package/dist/composer/use-file-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-file-search.js","sourceRoot":"","sources":["../../src/composer/use-file-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAEpD,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAGnE,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,OAAgB;IAC3D,MAAM,EAAE,WAAW,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,GAAG,0BAA0B,EAAE,CAAC;IACtE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,EAAE,CAAC,CAAC;IACrD,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,QAAQ,GAAG,MAAM,CAAyB,IAAI,CAAC,CAAC;IAEtD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,QAAQ,CAAC,EAAE,CAAC,CAAC;YACb,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO;QACT,CAAC;QAED,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,MAAM,EAAE,GAAG,EAAE,YAAY,CAAC,OAAO,CAAC;QAClC,6EAA6E;QAC7E,0EAA0E;QAC1E,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,IAAI,eAAe,EAAE,CAAC;QACpC,QAAQ,CAAC,OAAO,GAAG,KAAK,CAAC;QAEzB,MAAM,KAAK,GAAG,UAAU,CACtB,KAAK,IAAI,EAAE;YACT,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,KAAK,CACrB,WAAW,CACT,qCAAqC,kBAAkB,CAAC,KAAK,CAAC,EAAE,CACjE,EACD,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CACzB,CAAC;gBACF,IAAI,CAAC,GAAG,CAAC,EAAE;oBAAE,MAAM,IAAI,KAAK,EAAE,CAAC;gBAC/B,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;gBAC9B,kDAAkD;gBAClD,IAAI,EAAE,KAAK,YAAY,CAAC,OAAO,EAAE,CAAC;oBAChC,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;gBAC7B,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAK,GAAa,EAAE,IAAI,KAAK,YAAY;oBAAE,OAAO;gBAClD,IAAI,EAAE,KAAK,YAAY,CAAC,OAAO,EAAE,CAAC;oBAChC,QAAQ,CAAC,EAAE,CAAC,CAAC;gBACf,CAAC;YACH,CAAC;oBAAS,CAAC;gBACT,IAAI,EAAE,KAAK,YAAY,CAAC,OAAO,EAAE,CAAC;oBAChC,YAAY,CAAC,KAAK,CAAC,CAAC;gBACtB,CAAC;YACH,CAAC;QACH,CAAC,EACD,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAC7B,CAAC;QAEF,OAAO,GAAG,EAAE;YACV,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;IAElC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AAC9B,CAAC"}

package/dist/composer/use-mention-search.d.ts

@@ -0,0 +1,6 @@
+import type { MentionItem } from "./types.js";
+export declare function useMentionSearch(query: string, enabled: boolean, resolvePathOverride?: (path: string) => string): {
+    items: MentionItem[];
+    isLoading: boolean;
+};
+//# sourceMappingURL=use-mention-search.d.ts.map

package/dist/composer/use-mention-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-mention-search.d.ts","sourceRoot":"","sources":["../../src/composer/use-mention-search.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,EAChB,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM;;;EAiF/C"}

package/dist/composer/use-mention-search.js

@@ -0,0 +1,75 @@
+import { useState, useEffect, useRef } from "react";
+import { useComposerRuntimeAdapters } from "./runtime-adapters.js";
+export function useMentionSearch(query, enabled, resolvePathOverride) {
+    const { resolvePath = (path) => path } = useComposerRuntimeAdapters();
+    const resolveRequestPath = resolvePathOverride ?? resolvePath;
+    const [items, setItems] = useState([]);
+    const [isLoading, setIsLoading] = useState(false);
+    const abortRef = useRef(null);
+    const requestIdRef = useRef(0);
+    useEffect(() => {
+        if (!enabled) {
+            setItems([]);
+            setIsLoading(false);
+            return;
+        }
+        // Cancel any in-flight stream
+        abortRef.current?.abort();
+        const abort = new AbortController();
+        abortRef.current = abort;
+        const id = ++requestIdRef.current;
+        setItems([]);
+        setIsLoading(true);
+        const debounceMs = query.length === 0 ? 0 : 150;
+        const timer = setTimeout(async () => {
+            try {
+                const res = await fetch(resolveRequestPath(`/_agent-native/agent-chat/mentions?q=${encodeURIComponent(query)}`), { signal: abort.signal });
+                if (!res.ok || !res.body)
+                    throw new Error();
+                const reader = res.body.getReader();
+                const decoder = new TextDecoder();
+                let buf = "";
+                while (true) {
+                    const { done, value } = await reader.read();
+                    if (done)
+                        break;
+                    buf += decoder.decode(value, { stream: true });
+                    const lines = buf.split("\n");
+                    buf = lines.pop(); // last line may be incomplete
+                    for (const line of lines) {
+                        if (!line.trim())
+                            continue;
+                        try {
+                            const { items: batch } = JSON.parse(line);
+                            if (id === requestIdRef.current && batch?.length) {
+                                setItems((prev) => {
+                                    // Deduplicate by id
+                                    const seen = new Set(prev.map((x) => x.id));
+                                    const fresh = batch.filter((x) => !seen.has(x.id));
+                                    return fresh.length ? [...prev, ...fresh] : prev;
+                                });
+                            }
+                        }
+                        catch { }
+                    }
+                }
+            }
+            catch (err) {
+                if (err instanceof Error && err.name === "AbortError")
+                    return;
+                if (id === requestIdRef.current)
+                    setItems([]);
+            }
+            finally {
+                if (id === requestIdRef.current)
+                    setIsLoading(false);
+            }
+        }, debounceMs);
+        return () => {
+            clearTimeout(timer);
+            abort.abort();
+        };
+    }, [query, enabled, resolveRequestPath]);
+    return { items, isLoading };
+}
+//# sourceMappingURL=use-mention-search.js.map

package/dist/composer/use-mention-search.js.map

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

package/dist/composer/use-skills.d.ts

@@ -0,0 +1,7 @@
+import type { SkillResult } from "./types.js";
+export declare function useSkills(enabled: boolean): {
+    skills: SkillResult[];
+    hint: string | undefined;
+    isLoading: boolean;
+};
+//# sourceMappingURL=use-skills.d.ts.map

package/dist/composer/use-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-skills.d.ts","sourceRoot":"","sources":["../../src/composer/use-skills.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO;;;;EAuCzC"}

package/dist/composer/use-skills.js

@@ -0,0 +1,40 @@
+import { useState, useEffect, useRef } from "react";
+import { useComposerRuntimeAdapters } from "./runtime-adapters.js";
+export function useSkills(enabled) {
+    const { resolvePath = (path) => path } = useComposerRuntimeAdapters();
+    const [skills, setSkills] = useState([]);
+    const [hint, setHint] = useState();
+    const [isLoading, setIsLoading] = useState(false);
+    const requestIdRef = useRef(0);
+    useEffect(() => {
+        if (!enabled) {
+            return;
+        }
+        setIsLoading(true);
+        const id = ++requestIdRef.current;
+        fetch(resolvePath("/_agent-native/agent-chat/skills"))
+            .then((res) => {
+            if (!res.ok)
+                throw new Error();
+            return res.json();
+        })
+            .then((data) => {
+            if (id === requestIdRef.current) {
+                setSkills(data.skills || []);
+                setHint(data.hint);
+            }
+        })
+            .catch(() => {
+            if (id === requestIdRef.current) {
+                setSkills([]);
+            }
+        })
+            .finally(() => {
+            if (id === requestIdRef.current) {
+                setIsLoading(false);
+            }
+        });
+    }, [enabled, resolvePath]);
+    return { skills, hint, isLoading };
+}
+//# sourceMappingURL=use-skills.js.map

package/dist/composer/use-skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-skills.js","sourceRoot":"","sources":["../../src/composer/use-skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAEpD,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAGnE,MAAM,UAAU,SAAS,CAAC,OAAgB;IACxC,MAAM,EAAE,WAAW,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,GAAG,0BAA0B,EAAE,CAAC;IACtE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAgB,EAAE,CAAC,CAAC;IACxD,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,EAAsB,CAAC;IACvD,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAE/B,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QAED,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,MAAM,EAAE,GAAG,EAAE,YAAY,CAAC,OAAO,CAAC;QAElC,KAAK,CAAC,WAAW,CAAC,kCAAkC,CAAC,CAAC;aACnD,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;YACZ,IAAI,CAAC,GAAG,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,EAAE,CAAC;YAC/B,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;QACpB,CAAC,CAAC;aACD,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;YACb,IAAI,EAAE,KAAK,YAAY,CAAC,OAAO,EAAE,CAAC;gBAChC,SAAS,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;gBAC7B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC;QACH,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE;YACV,IAAI,EAAE,KAAK,YAAY,CAAC,OAAO,EAAE,CAAC;gBAChC,SAAS,CAAC,EAAE,CAAC,CAAC;YAChB,CAAC;QACH,CAAC,CAAC;aACD,OAAO,CAAC,GAAG,EAAE;YACZ,IAAI,EAAE,KAAK,YAAY,CAAC,OAAO,EAAE,CAAC;gBAChC,YAAY,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;QACH,CAAC,CAAC,CAAC;IACP,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;IAE3B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AACrC,CAAC"}

package/dist/composer/useRealtimeVoiceMode.d.ts

@@ -0,0 +1,179 @@
+import { type ReactNode } from "react";
+import { type RealtimeVoiceAudioLevelStore } from "./realtime-voice-audio-level.js";
+import { type RealtimeVoiceModeCopy, type RealtimeVoiceModeState } from "./RealtimeVoiceMode.js";
+export declare const REALTIME_VOICE_LANGUAGES: readonly ["auto", "en", "es", "fr", "de", "it", "pt", "ja", "ko", "zh"];
+export declare const REALTIME_VOICE_INTELLIGENCE_LEVELS: readonly ["instant", "balanced", "deep"];
+export declare const REALTIME_VOICES: readonly ["marin", "cedar", "coral", "sage", "verse", "alloy", "ash", "ballad", "echo", "shimmer"];
+export type RealtimeVoiceLanguage = (typeof REALTIME_VOICE_LANGUAGES)[number];
+export type RealtimeVoiceIntelligence = (typeof REALTIME_VOICE_INTELLIGENCE_LEVELS)[number];
+export type RealtimeVoice = (typeof REALTIME_VOICES)[number];
+export interface RealtimeVoicePreferences {
+    language: RealtimeVoiceLanguage;
+    intelligence: RealtimeVoiceIntelligence;
+    voice: RealtimeVoice;
+}
+export declare const DEFAULT_REALTIME_VOICE_PREFERENCES: RealtimeVoicePreferences;
+export declare const REALTIME_VOICE_AUDIO_CONSTRAINTS: MediaTrackConstraints;
+type RealtimeServerEvent = Record<string, unknown> & {
+    type?: string;
+};
+export interface RealtimeVoiceToolResult {
+    callId: string;
+    status: "completed" | "failed" | "approval_required";
+    output: string;
+    approvalKey?: string;
+    expandedTools?: RealtimeVoiceFunctionTool[];
+}
+export interface RealtimeVoiceSessionAnswer {
+    sdp: string;
+    capability?: string;
+}
+export interface RealtimeVoiceFunctionTool {
+    type: "function";
+    name: string;
+    description?: string;
+    parameters?: Record<string, unknown>;
+}
+export interface RealtimeVoiceModeApi {
+    state: "idle" | RealtimeVoiceModeState;
+    active: boolean;
+    errorMessage: string | null;
+    chatVisible: boolean;
+    audioLevels: RealtimeVoiceAudioLevelStore;
+    preferences: RealtimeVoicePreferences;
+    microphones: readonly RealtimeVoiceMicrophone[];
+    microphoneDeviceId: string;
+    microphoneSwitching: boolean;
+    microphoneError: string | null;
+    voiceChangePending: boolean;
+    setLanguage: (language: RealtimeVoiceLanguage) => void;
+    setIntelligence: (intelligence: RealtimeVoiceIntelligence) => void;
+    setVoice: (voice: RealtimeVoice) => void;
+    setMicrophone: (deviceId: string) => Promise<void>;
+    start: () => Promise<void>;
+    end: () => void;
+    toggleChat: () => void;
+}
+export interface RealtimeVoiceMicrophone {
+    deviceId: string;
+    label: string;
+}
+export declare function createRealtimeVoiceAudioConstraints(deviceId?: string, exact?: boolean): MediaTrackConstraints;
+export declare function replaceRealtimeVoiceMicrophone(options: {
+    mediaDevices: Pick<MediaDevices, "getUserMedia">;
+    peer: Pick<RTCPeerConnection, "getSenders">;
+    currentStream: MediaStream | null;
+    deviceId: string;
+}): Promise<MediaStream>;
+export declare function normalizeRealtimeVoicePreferences(value: unknown): RealtimeVoicePreferences;
+export declare function resolveRealtimeVoiceLanguage(language: RealtimeVoiceLanguage, browserLanguages?: readonly string[]): Exclude<RealtimeVoiceLanguage, "auto">;
+export declare function realtimeVoiceReasoningEffort(intelligence: RealtimeVoiceIntelligence): "minimal" | "low" | "medium";
+export declare function createRealtimeVoicePreferenceUpdate(preferences: RealtimeVoicePreferences, options?: {
+    browserLanguages?: readonly string[];
+    includeVoice?: boolean;
+}): Record<string, unknown>;
+export interface CompletedRealtimeVoiceTranscript {
+    role: "user" | "assistant";
+    text: string;
+    providerId?: string;
+}
+export interface RealtimeVoiceTranscriptSequencer {
+    handle: (event: RealtimeServerEvent) => void;
+    reset: () => void;
+}
+/**
+ * Input transcription is produced by a separate ASR model and can finish after
+ * the assistant response. Reserve each message's position when OpenAI adds it
+ * to the conversation, then publish only the contiguous completed prefix.
+ */
+export declare function createRealtimeVoiceTranscriptSequencer(publish: (transcript: CompletedRealtimeVoiceTranscript) => void): RealtimeVoiceTranscriptSequencer;
+export declare function createRealtimeVoiceGreetingEvent(): Record<string, unknown>;
+export declare function createRealtimeVoiceGreetingStarter(send: (event: Record<string, unknown>) => void): {
+    start: () => boolean;
+    reset: () => void;
+};
+/**
+ * Voice mode owns the chat only temporarily. Restore the captured transcript
+ * when it is still the user's active thread (or the chat has no active thread)
+ * but never pull them back after they deliberately selected another thread.
+ */
+export declare function shouldRestoreRealtimeVoiceTranscriptThread(transcriptThreadId: string | undefined, activeThreadId: string | undefined): transcriptThreadId is string;
+export declare function extractCompletedRealtimeVoiceTranscript(event: RealtimeServerEvent): CompletedRealtimeVoiceTranscript | null;
+export interface RealtimeVoiceModeProviderProps {
+    children: ReactNode;
+    browserTabId?: string;
+}
+export declare function isRealtimeVoiceAbortError(error: unknown): boolean;
+export declare function isRealtimeVoiceSetupRequiredError(error: unknown): boolean;
+export declare function createRealtimeVoiceConnectionTimeout(onTimeout: () => void, timeoutMs?: number): () => void;
+export declare function createRealtimeVoiceConnectionGate(onTimeout: () => void, timeoutMs?: number): {
+    markTransportReady: () => void;
+    markSessionCreated: () => void;
+    cancel: () => void;
+};
+interface RealtimeVoiceSessionOptions {
+    browserTabId?: string;
+    signal?: AbortSignal;
+    preferences?: RealtimeVoicePreferences;
+    browserLanguages?: readonly string[];
+}
+export declare function createRealtimeVoiceSessionWithCapability(offerSdp: string, options?: RealtimeVoiceSessionOptions): Promise<RealtimeVoiceSessionAnswer>;
+/** Backwards-compatible SDP-only session helper for existing client callers. */
+export declare function createRealtimeVoiceSession(offerSdp: string, options?: RealtimeVoiceSessionOptions): Promise<string>;
+export declare function executeRealtimeVoiceTool(input: {
+    name: string;
+    args: Record<string, unknown>;
+    callId: string;
+    sessionId?: string;
+    browserTabId?: string;
+    capability?: string;
+    signal?: AbortSignal;
+}): Promise<RealtimeVoiceToolResult>;
+export declare function extractRealtimeVoiceSessionTools(event: RealtimeServerEvent): RealtimeVoiceFunctionTool[] | null;
+/**
+ * Merge search-discovered schemas into the live manifest. Pinned navigation
+ * and discovery tools stay available, then the newest discoveries take the
+ * remaining slots ahead of lower-priority tools from the original manifest.
+ */
+export declare function mergeRealtimeVoiceToolManifest(currentTools: readonly RealtimeVoiceFunctionTool[], expandedTools: readonly RealtimeVoiceFunctionTool[]): RealtimeVoiceFunctionTool[];
+export interface RealtimeVoiceToolManifestCoordinator {
+    enqueue: (result: RealtimeVoiceToolResult) => void;
+    setSessionTools: (tools: readonly RealtimeVoiceFunctionTool[]) => void;
+    handleError: (eventId: string | undefined, message?: string) => boolean;
+    reset: () => void;
+    getTools: () => readonly RealtimeVoiceFunctionTool[];
+}
+/**
+ * Realtime treats `session.update.tools` as a full replacement. Serialize
+ * discovery updates and wait for a confirming `session.updated` manifest
+ * before returning the search result and allowing the next model response.
+ */
+export declare function createRealtimeVoiceToolManifestCoordinator(send: (event: Record<string, unknown>) => void, timeoutMs?: number): RealtimeVoiceToolManifestCoordinator;
+export declare function extractRealtimeVoiceFunctionCalls(event: RealtimeServerEvent): Array<{
+    name: string;
+    callId: string;
+    argumentsText: string;
+}>;
+export declare function listenForRealtimeVoicePageHide(cleanup: () => void): () => void;
+export declare function useRealtimeVoiceModeCopy(): RealtimeVoiceModeCopy;
+export declare function RealtimeVoiceModeProvider({ children, browserTabId, }: RealtimeVoiceModeProviderProps): import("react").JSX.Element;
+/**
+ * Ensure standalone/full-page composers get realtime voice without nesting a
+ * second session owner inside the persistent AgentSidebar provider.
+ */
+export declare function RealtimeVoiceModeBoundary({ children, browserTabId, }: RealtimeVoiceModeProviderProps): import("react").JSX.Element;
+export declare function useRealtimeVoiceMode(): RealtimeVoiceModeApi;
+export declare function useRealtimeVoiceModeOptional(): RealtimeVoiceModeApi | null;
+export declare function readRealtimeVoiceContext(): Promise<{
+    navigation: unknown;
+    url: unknown;
+}>;
+export declare function readRealtimeVoiceContextWith(options: {
+    readAppState?: (key: string) => Promise<unknown> | unknown;
+    resolvePath?: (path: string) => string;
+}): Promise<{
+    navigation: unknown;
+    url: unknown;
+}>;
+export {};
+//# sourceMappingURL=useRealtimeVoiceMode.d.ts.map

package/dist/composer/useRealtimeVoiceMode.d.ts.map

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