@pagelines/sdk 1.0.645 → 1.0.646

package/dist/agent/AgentController.d.ts

@@ -1,7 +1,8 @@
-import { Ref } from 'vue';
+import { ComputedRef, Ref } from 'vue';
 import { AgentConfig, ChatToolActivityData, SettingsObject } from '@pagelines/core';
 import { PageLinesSDK } from '../sdkClient';
 import { AgentMode, ChatAttachment, ChatMessage, TextConnectionState, Agent } from './schema';
+import { VoiceRecorderController } from './VoiceRecorderController';
 /**
  * Structured error payload surfaced by the chat stream. Matches the
  * ApiResponse contract in plans/architecture/architecture-api.md — consumers switch on
@@ -56,6 +57,14 @@ export type ChatStreamFn = (args: {
     onToolActivity?: (activity: ChatToolActivityData) => void;
     onWorkingEnd?: () => void;
 }) => Promise<void>;
+export type ChatUploadFn = (args: {
+    file: File;
+}) => Promise<ChatAttachment>;
+export type AgentChatComposerState = {
+    text: string;
+    pendingAttachments: ChatAttachment[];
+    isUploading: boolean;
+};
 type AgentChatControllerSettings = {
     sdk?: PageLinesSDK;
     agent: Agent | AgentConfig;
@@ -65,6 +74,7 @@ type AgentChatControllerSettings = {
     cancelChatTurnFn?: (args: {
         conversationId?: string;
     }) => Promise<void> | void;
+    uploadFileFn?: ChatUploadFn;
 };
 /** @deprecated Use AgentChatControllerSettings */
 export type AgentControllerSettings = AgentChatControllerSettings;
@@ -77,6 +87,14 @@ export declare class AgentChatController extends SettingsObject<AgentChatControl
     textState: Ref<TextConnectionState>;
     agentMode: Ref<AgentMode>;
     sharedMessages: Ref<ChatMessage[]>;
+    readonly composerState: Ref<AgentChatComposerState>;
+    readonly canUseComposer: ComputedRef<boolean>;
+    readonly canAttachFile: ComputedRef<boolean>;
+    readonly canRecordAudio: ComputedRef<boolean>;
+    readonly voiceRecorder: VoiceRecorderController;
+    readonly canSend: ComputedRef<boolean>;
+    readonly canStop: ComputedRef<boolean>;
+    readonly composerAction: ComputedRef<'idle' | 'send' | 'stop'>;
     private _agent;
     constructor(settings: AgentChatControllerSettings);
     get chatEnabled(): boolean;
@@ -102,6 +120,17 @@ export declare class AgentChatController extends SettingsObject<AgentChatControl
      * feedback" miss flagged in design.md → Action Feedback Contract.
      */
     notify(text: string): void;
+    setComposerText(args: {
+        text: string;
+    }): void;
+    attachFile(args: {
+        file: File;
+    }): Promise<void>;
+    removeAttachment(args: {
+        index: number;
+    }): void;
+    sendComposerMessage(): Promise<void>;
+    handleComposerAction(): Promise<void>;
     getDynamicSettings(): {
         context: string;
         firstMessage: string;

package/dist/agent/VoiceRecorderController.d.ts

@@ -0,0 +1,77 @@
+import { ChatAttachment } from './schema';
+import { SettingsObject } from '@pagelines/core';
+type VoiceRecorderPhase = 'idle' | 'preparing' | 'recording' | 'sending';
+type VoiceRecorderLike = {
+    state: 'inactive' | 'recording' | 'paused';
+    mimeType: string;
+    start: () => void;
+    stop: () => void;
+    addEventListener: {
+        (type: 'dataavailable', listener: (event: {
+            data: Blob;
+        }) => void): void;
+        (type: 'stop', listener: () => void | Promise<void>): void;
+    };
+};
+export type VoiceRecorderControllerState = {
+    phase: VoiceRecorderPhase;
+    elapsedMs: number;
+};
+type VoiceRecorderChatController = {
+    sendChatMessage: (message: string, attachments?: ChatAttachment[]) => Promise<void>;
+    notify: (text: string) => void;
+};
+type VoiceRecorderControllerSettings = {
+    getCanRecord: () => boolean;
+    getUploadFn: () => ((file: File) => Promise<ChatAttachment>) | undefined;
+    getChatController: () => VoiceRecorderChatController | undefined;
+    onBeforeSend?: () => void;
+    getUserMedia?: (constraints: MediaStreamConstraints) => Promise<MediaStream>;
+    createRecorder?: (args: {
+        stream: MediaStream;
+        mimeType: string;
+    }) => VoiceRecorderLike;
+    now?: () => number;
+    setInterval?: (handler: () => void, timeout: number) => ReturnType<typeof setInterval>;
+    clearInterval?: (timer: ReturnType<typeof setInterval>) => void;
+};
+export declare function formatVoiceRecordingDuration(args: {
+    ms: number;
+}): string;
+export declare class VoiceRecorderController extends SettingsObject<VoiceRecorderControllerSettings> {
+    readonly state: import('vue').Ref<{
+        phase: VoiceRecorderPhase;
+        elapsedMs: number;
+    }, VoiceRecorderControllerState | {
+        phase: VoiceRecorderPhase;
+        elapsedMs: number;
+    }>;
+    readonly isActive: import('vue').ComputedRef<boolean>;
+    readonly isBusy: import('vue').ComputedRef<boolean>;
+    readonly elapsedLabel: import('vue').ComputedRef<string>;
+    readonly statusText: import('vue').ComputedRef<"Starting microphone" | "Sending voice message" | "Release to send">;
+    private recorder?;
+    private stream?;
+    private chunks;
+    private timer?;
+    private startedAt;
+    private cancelOnStop;
+    private stopAfterStart;
+    private startToken;
+    constructor(settings: VoiceRecorderControllerSettings);
+    get canUseBrowserRecording(): boolean;
+    start(): Promise<void>;
+    finish(args: {
+        cancelled: boolean;
+    }): void;
+    teardown(): void;
+    private getUserMedia;
+    private createRecorder;
+    private sendBlob;
+    private stopCapture;
+    private reset;
+    private now;
+    private setInterval;
+    private clearInterval;
+}
+export {};

package/dist/agent/index.d.ts

@@ -6,6 +6,6 @@ import { default as AgentWrap } from './ui/AgentWrap.vue';
 import { default as ElAgentChat } from './ui/ElAgentChat.vue';
 import { default as ElAgentChatPreview } from './ui/ElAgentChatPreview.vue';
 export { AgentChatController, AgentChatController as AgentController } from './AgentController';
-export type { ChatStreamFn } from './AgentController';
+export type { AgentChatComposerState, ChatStreamFn, ChatUploadFn } from './AgentController';
 export * from './schema';
 export { AgentChat, AgentModal, AgentProvider, AgentWidget, AgentWrap, ElAgentChat, ElAgentChatPreview };

package/dist/agent/test/VoiceRecorderController.unit.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/agent/ui/ElAgentChat.vue.d.ts

@@ -1,5 +1,4 @@
 import { AgentChatController } from '../AgentController';
-import { ChatAttachment } from '../schema';
 import { Agent } from '@pagelines/core';
 import { nextTick } from 'vue';
 type ChatScope = 'private' | 'org' | 'public';
@@ -7,11 +6,12 @@ type __VLS_Props = {
     chatController?: AgentChatController;
     agent: Agent;
     variant?: 'dark' | 'light';
-    uploadFn?: (file: File) => Promise<ChatAttachment>;
     scope?: ChatScope;
     scopeName?: string;
     setupHint?: string;
     emptyStateMessage?: string;
+    showHeader?: boolean;
+    headerMeta?: string;
 };
 declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     chatScroller: ({