@pagelines/sdk 1.0.472 → 1.0.473

package/dist/agent/AgentController.d.ts

@@ -53,6 +53,13 @@ export declare class AgentChatController extends SettingsObject<AgentChatControl
     get chatEnabled(): boolean;
     get chatUnavailableReason(): string | undefined;
     private mapChatError;
+    /**
+     * Errors we treat as recoverable mid-conversation: rate limits, timeouts,
+     * transient infra blips, dropped streams. We render an inline system bubble
+     * and keep the input enabled so the next attempt can succeed without
+     * forcing a manual reload. Hard errors (auth lost, agent missing) still
+     * fall through to handleError which marks the conversation dead.
+     */
     private isTransientError;
     private isDuplicateMessage;
     private addMessage;
@@ -63,6 +70,14 @@ export declare class AgentChatController extends SettingsObject<AgentChatControl
     private updateState;
     private resetState;
     private setupModeWatcher;
+    /**
+     * Hard error path. Resets the connection and surfaces an inline bubble so
+     * the user actually sees what happened — `connectionStatus: 'error'`
+     * alone doesn't render anywhere. The raw error is kept on console.error
+     * so devs can tell which pipeline stage failed (the `[api]` /
+     * `[stream-open]` / `[stream-read]` / `[no-reply]` tags from
+     * agent/client.ts survive into the console line).
+     */
     private handleError;
     setMode(mode: AgentMode): Promise<void>;
     startTextConversation(callbacks?: {

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

@@ -11,6 +11,8 @@ type __VLS_Props = {
     scopeName?: string;
     setupHint?: string;
     emptyStateMessage?: string;
+    /** Override the empty-state quick-prompts. Defaults to brief / triage / plan-this-week. */
+    starterPrompts?: readonly 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, {
     messagesContainer: HTMLDivElement;

package/dist/clients/ChatClient.d.ts

@@ -2,6 +2,11 @@ import { SDKContext } from './types';
 export declare class ChatClient {
     private ctx;
     constructor(ctx: SDKContext);
+    /**
+     * Public/visitor chat — anonymous chat against an agent's public handle.
+     * Stays on the legacy `AgentChatServer` route for now; substrate doesn't
+     * support visitor identities yet (deferred per `plans/features/chat.md`).
+     */
     chatStream(args: {
         handle: string;
         message: string;
@@ -24,6 +29,12 @@ export declare class ChatClient {
         onError: (error: string) => void;
         onStatus?: (status: string) => void;
     }): Promise<void>;
+    /**
+     * Authenticated chat — substrate-backed (POST /api/messages + SSE on
+     * /api/chat/:agentId/stream). Same callback contract as the legacy
+     * `chatStream` so callers don't need to know which transport runs underneath.
+     * Mirrors `src/modules/agent/client.ts → sendChatMessageStream`.
+     */
     chatStreamAuthenticated(args: {
         agentId: string;
         message: string;
@@ -34,7 +45,9 @@ export declare class ChatClient {
             mimeType: string;
             mediaId?: string;
         }>;
+        /** Reserved — substrate resolves conversation server-side from (userId, agentId). */
         conversationId?: string;
+        /** Reserved — substrate replays history from the canonical messages table. */
         history?: Array<{
             role: 'user' | 'assistant';
             content: string;
@@ -44,8 +57,6 @@ export declare class ChatClient {
         onError: (error: string) => void;
         onStatus?: (status: string) => void;
     }): Promise<void>;
-    /** Shared SSE streaming logic for both public and authenticated chat */
-    private _streamChat;
     chatMessage(args: {
         handle: string;
         message: string;