@ai-accounts/vue-headless 0.3.0-alpha.2 → 0.3.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { Ref, App, InjectionKey } from 'vue';
-import { AiAccountsClient, WizardState, DetectResultDTO, BackendDTO, OnboardingMachineState, OAuthDeviceLoginDTO, AiAccountsEventHandler, AiAccountsEvent, BackendMetadata, UrlPrompt, TextPrompt, LoginFlowKind } from '@ai-accounts/ts-core';
+import { Ref, App, InjectionKey, ShallowRef } from 'vue';
+import { AiAccountsClient, WizardState, DetectResultDTO, BackendDTO, OnboardingMachineState, OAuthDeviceLoginDTO, AiAccountsEventHandler, AiAccountsEvent, BackendMetadata, UrlPrompt, TextPrompt, MenuPrompt, LoginFlowKind, ProcessGroupType, ToolCallDelta, ChatMessageDTO as ChatMessageDTO$1, ChatMode } from '@ai-accounts/ts-core';
 
 interface UseAccountWizardOptions {
     client: AiAccountsClient;
@@ -74,6 +74,7 @@ type UseLoginSession = {
     accountId: Ref<string | null>;
     urlPrompt: Ref<UrlPrompt | null>;
     textPrompt: Ref<TextPrompt | null>;
+    menuPrompt: Ref<MenuPrompt | null>;
     stdoutLines: Ref<string[]>;
     errorCode: Ref<string | null>;
     errorMessage: Ref<string | null>;
@@ -83,6 +84,123 @@ type UseLoginSession = {
 };
 declare function useLoginSession(): UseLoginSession;
 
+interface ChatMessageDTO {
+    id: string;
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string;
+    created_at: string;
+    model: string | null;
+    tokens_in: number | null;
+    tokens_out: number | null;
+}
+interface UseConversationReturn {
+    sessionId: Ref<string | null>;
+    messages: ShallowRef<ChatMessageDTO[]>;
+    isStreaming: Ref<boolean>;
+    streamingText: Ref<string>;
+    error: Ref<string | null>;
+    create: (backendId: string, model: string) => Promise<void>;
+    send: (content: string) => Promise<void>;
+    load: (id: string) => Promise<void>;
+}
+declare function useConversation(client: AiAccountsClient): UseConversationReturn;
+
+interface ProcessGroup {
+    id: string;
+    type: ProcessGroupType;
+    label: string;
+    content: string;
+    timestamp: string;
+    isExpanded: boolean;
+    autoCollapseMs: number;
+}
+interface UseProcessGroupsReturn {
+    groups: Ref<Map<string, ProcessGroup>>;
+    addGroup: (group: Omit<ProcessGroup, 'isExpanded'>) => void;
+    removeGroup: (id: string) => void;
+    toggleGroup: (id: string) => void;
+    collapseGroup: (id: string) => void;
+    expandGroup: (id: string) => void;
+    updateGroupContent: (id: string, content: string) => void;
+    clearGroups: () => void;
+    processToolCallDelta: (delta: ToolCallDelta) => void;
+}
+declare function useProcessGroups(): UseProcessGroupsReturn;
+
+interface BackendResponseState {
+    backend: string;
+    content: string;
+    status: 'streaming' | 'complete' | 'error' | 'timeout';
+    error?: string;
+}
+interface SynthesisStateRef {
+    status: 'waiting' | 'streaming' | 'complete' | 'error';
+    content: string;
+    primaryBackend: string;
+    backendsCollected: string[];
+    error?: string;
+}
+interface UseSmartChatReturn {
+    sessionId: Ref<string | null>;
+    messages: ShallowRef<ChatMessageDTO$1[]>;
+    isStreaming: Ref<boolean>;
+    streamingContent: Ref<string>;
+    error: Ref<string | null>;
+    chatMode: Ref<ChatMode>;
+    backendResponses: Ref<Map<string, BackendResponseState>>;
+    synthesisState: Ref<SynthesisStateRef | null>;
+    selectedBackend: Ref<string | null>;
+    selectedAccount: Ref<string | null>;
+    selectedModel: Ref<string | null>;
+    createSession: (backendId: string, model: string) => Promise<void>;
+    loadSession: (id: string) => Promise<void>;
+    send: (content: string) => Promise<void>;
+    setMode: (mode: ChatMode) => void;
+    selectBackend: (kind: string | null) => void;
+    processGroups: UseProcessGroupsReturn;
+    canFinalize: Ref<boolean>;
+    isFinalizing: Ref<boolean>;
+    detectedConfig: Ref<Record<string, unknown> | null>;
+    finalize: () => Promise<Record<string, unknown> | null>;
+    setConfigParser: (parser: ((content: string) => Record<string, unknown> | null) | null) => void;
+}
+declare function useSmartChat(): UseSmartChatReturn;
+
+interface UseSmartScrollReturn {
+    containerRef: Ref<HTMLElement | null>;
+    isNearBottom: Ref<boolean>;
+    showScrollButton: Ref<boolean>;
+    scrollToBottom: () => void;
+}
+declare function useSmartScroll(): UseSmartScrollReturn;
+
+interface UseStreamingParserOptions {
+    onFlush?: () => void;
+    /** Max buffered chars before pre-init writes are dropped (prevents leak when smd fails to resolve). */
+    maxPendingChars?: number;
+}
+interface UseStreamingParserReturn {
+    init: (container: HTMLElement) => void;
+    write: (text: string) => void;
+    finalize: () => void;
+    destroy: () => void;
+}
+/**
+ * Reusable smd.js streaming markdown parser with rAF-batched writes.
+ *
+ * Lifecycle: init(container) → write(text)* → finalize()
+ *
+ * smd is resolved lazily — via globalThis.__smd (consumer-injected) or a
+ * dynamic import of the optional `streaming-markdown` peer dependency.
+ * If the peer dep cannot be resolved, the composable logs a one-time warning
+ * and discards writes; the internal `smd`/`SmdModule` identifiers are the
+ * historical module alias for the streaming-markdown package.
+ *
+ * @param options.onFlush - called after each rAF batch is flushed (e.g. scroll-to-bottom)
+ * @param options.maxPendingChars - cap for the pre-init buffer (default 1M chars)
+ */
+declare function useStreamingParser(options?: UseStreamingParserOptions): UseStreamingParserReturn;
+
 declare const version = "0.3.0-alpha.1";
 
-export { type AiAccountsContext, type AiAccountsPluginOptions, type LoginStatus, type UseAccountWizardOptions, type UseAccountWizardReturn, type UseLoginSession, type UseOnboardingOptions, type UseOnboardingReturn, aiAccountsKey, aiAccountsPlugin, useAccountWizard, useAiAccounts, useBackendRegistry, useLoginSession, useOnboarding, version };
+export { type AiAccountsContext, type AiAccountsPluginOptions, type BackendResponseState, type LoginStatus, type ProcessGroup, type SynthesisStateRef, type UseAccountWizardOptions, type UseAccountWizardReturn, type UseConversationReturn, type UseLoginSession, type UseOnboardingOptions, type UseOnboardingReturn, type UseProcessGroupsReturn, type UseSmartChatReturn, type UseSmartScrollReturn, type UseStreamingParserOptions, type UseStreamingParserReturn, aiAccountsKey, aiAccountsPlugin, useAccountWizard, useAiAccounts, useBackendRegistry, useConversation, useLoginSession, useOnboarding, useProcessGroups, useSmartChat, useSmartScroll, useStreamingParser, version };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { Ref, App, InjectionKey } from 'vue';
-import { AiAccountsClient, WizardState, DetectResultDTO, BackendDTO, OnboardingMachineState, OAuthDeviceLoginDTO, AiAccountsEventHandler, AiAccountsEvent, BackendMetadata, UrlPrompt, TextPrompt, LoginFlowKind } from '@ai-accounts/ts-core';
+import { Ref, App, InjectionKey, ShallowRef } from 'vue';
+import { AiAccountsClient, WizardState, DetectResultDTO, BackendDTO, OnboardingMachineState, OAuthDeviceLoginDTO, AiAccountsEventHandler, AiAccountsEvent, BackendMetadata, UrlPrompt, TextPrompt, MenuPrompt, LoginFlowKind, ProcessGroupType, ToolCallDelta, ChatMessageDTO as ChatMessageDTO$1, ChatMode } from '@ai-accounts/ts-core';
 
 interface UseAccountWizardOptions {
     client: AiAccountsClient;
@@ -74,6 +74,7 @@ type UseLoginSession = {
     accountId: Ref<string | null>;
     urlPrompt: Ref<UrlPrompt | null>;
     textPrompt: Ref<TextPrompt | null>;
+    menuPrompt: Ref<MenuPrompt | null>;
     stdoutLines: Ref<string[]>;
     errorCode: Ref<string | null>;
     errorMessage: Ref<string | null>;
@@ -83,6 +84,123 @@ type UseLoginSession = {
 };
 declare function useLoginSession(): UseLoginSession;
 
+interface ChatMessageDTO {
+    id: string;
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string;
+    created_at: string;
+    model: string | null;
+    tokens_in: number | null;
+    tokens_out: number | null;
+}
+interface UseConversationReturn {
+    sessionId: Ref<string | null>;
+    messages: ShallowRef<ChatMessageDTO[]>;
+    isStreaming: Ref<boolean>;
+    streamingText: Ref<string>;
+    error: Ref<string | null>;
+    create: (backendId: string, model: string) => Promise<void>;
+    send: (content: string) => Promise<void>;
+    load: (id: string) => Promise<void>;
+}
+declare function useConversation(client: AiAccountsClient): UseConversationReturn;
+
+interface ProcessGroup {
+    id: string;
+    type: ProcessGroupType;
+    label: string;
+    content: string;
+    timestamp: string;
+    isExpanded: boolean;
+    autoCollapseMs: number;
+}
+interface UseProcessGroupsReturn {
+    groups: Ref<Map<string, ProcessGroup>>;
+    addGroup: (group: Omit<ProcessGroup, 'isExpanded'>) => void;
+    removeGroup: (id: string) => void;
+    toggleGroup: (id: string) => void;
+    collapseGroup: (id: string) => void;
+    expandGroup: (id: string) => void;
+    updateGroupContent: (id: string, content: string) => void;
+    clearGroups: () => void;
+    processToolCallDelta: (delta: ToolCallDelta) => void;
+}
+declare function useProcessGroups(): UseProcessGroupsReturn;
+
+interface BackendResponseState {
+    backend: string;
+    content: string;
+    status: 'streaming' | 'complete' | 'error' | 'timeout';
+    error?: string;
+}
+interface SynthesisStateRef {
+    status: 'waiting' | 'streaming' | 'complete' | 'error';
+    content: string;
+    primaryBackend: string;
+    backendsCollected: string[];
+    error?: string;
+}
+interface UseSmartChatReturn {
+    sessionId: Ref<string | null>;
+    messages: ShallowRef<ChatMessageDTO$1[]>;
+    isStreaming: Ref<boolean>;
+    streamingContent: Ref<string>;
+    error: Ref<string | null>;
+    chatMode: Ref<ChatMode>;
+    backendResponses: Ref<Map<string, BackendResponseState>>;
+    synthesisState: Ref<SynthesisStateRef | null>;
+    selectedBackend: Ref<string | null>;
+    selectedAccount: Ref<string | null>;
+    selectedModel: Ref<string | null>;
+    createSession: (backendId: string, model: string) => Promise<void>;
+    loadSession: (id: string) => Promise<void>;
+    send: (content: string) => Promise<void>;
+    setMode: (mode: ChatMode) => void;
+    selectBackend: (kind: string | null) => void;
+    processGroups: UseProcessGroupsReturn;
+    canFinalize: Ref<boolean>;
+    isFinalizing: Ref<boolean>;
+    detectedConfig: Ref<Record<string, unknown> | null>;
+    finalize: () => Promise<Record<string, unknown> | null>;
+    setConfigParser: (parser: ((content: string) => Record<string, unknown> | null) | null) => void;
+}
+declare function useSmartChat(): UseSmartChatReturn;
+
+interface UseSmartScrollReturn {
+    containerRef: Ref<HTMLElement | null>;
+    isNearBottom: Ref<boolean>;
+    showScrollButton: Ref<boolean>;
+    scrollToBottom: () => void;
+}
+declare function useSmartScroll(): UseSmartScrollReturn;
+
+interface UseStreamingParserOptions {
+    onFlush?: () => void;
+    /** Max buffered chars before pre-init writes are dropped (prevents leak when smd fails to resolve). */
+    maxPendingChars?: number;
+}
+interface UseStreamingParserReturn {
+    init: (container: HTMLElement) => void;
+    write: (text: string) => void;
+    finalize: () => void;
+    destroy: () => void;
+}
+/**
+ * Reusable smd.js streaming markdown parser with rAF-batched writes.
+ *
+ * Lifecycle: init(container) → write(text)* → finalize()
+ *
+ * smd is resolved lazily — via globalThis.__smd (consumer-injected) or a
+ * dynamic import of the optional `streaming-markdown` peer dependency.
+ * If the peer dep cannot be resolved, the composable logs a one-time warning
+ * and discards writes; the internal `smd`/`SmdModule` identifiers are the
+ * historical module alias for the streaming-markdown package.
+ *
+ * @param options.onFlush - called after each rAF batch is flushed (e.g. scroll-to-bottom)
+ * @param options.maxPendingChars - cap for the pre-init buffer (default 1M chars)
+ */
+declare function useStreamingParser(options?: UseStreamingParserOptions): UseStreamingParserReturn;
+
 declare const version = "0.3.0-alpha.1";
 
-export { type AiAccountsContext, type AiAccountsPluginOptions, type LoginStatus, type UseAccountWizardOptions, type UseAccountWizardReturn, type UseLoginSession, type UseOnboardingOptions, type UseOnboardingReturn, aiAccountsKey, aiAccountsPlugin, useAccountWizard, useAiAccounts, useBackendRegistry, useLoginSession, useOnboarding, version };
+export { type AiAccountsContext, type AiAccountsPluginOptions, type BackendResponseState, type LoginStatus, type ProcessGroup, type SynthesisStateRef, type UseAccountWizardOptions, type UseAccountWizardReturn, type UseConversationReturn, type UseLoginSession, type UseOnboardingOptions, type UseOnboardingReturn, type UseProcessGroupsReturn, type UseSmartChatReturn, type UseSmartScrollReturn, type UseStreamingParserOptions, type UseStreamingParserReturn, aiAccountsKey, aiAccountsPlugin, useAccountWizard, useAiAccounts, useBackendRegistry, useConversation, useLoginSession, useOnboarding, useProcessGroups, useSmartChat, useSmartScroll, useStreamingParser, version };