@pagelines/sdk 1.0.448 → 1.0.449

package/dist/agent/AgentController.d.ts

@@ -5,11 +5,18 @@ import { AgentMode, ChatAttachment, ChatMessage, TextConnectionState, Agent } fr
 /**
  * Structured error payload surfaced by the chat stream. Matches the
  * ApiResponse contract in plans/standards/api.md — consumers switch on
- * `code` (stable identifier), render `error` (user-facing copy).
+ * `code` (stable identifier), render `error` (user-facing copy). When
+ * the server emits a ChatIssueWireFrame (chat-gate.ts), the bucket +
+ * actionLabel + actionUrl triad lets the UI render a CTA inside the
+ * error bubble.
  */
 export interface ChatStreamError {
     code: string;
     error: string;
+    bucket?: 'account' | 'error';
+    actionLabel?: string;
+    actionUrl?: string;
+    help?: string;
 }
 export type ChatStreamFn = (args: {
     message: string;
@@ -62,6 +69,14 @@ export declare class AgentChatController extends SettingsObject<AgentChatControl
         onConnect?: () => void;
     }): Promise<void>;
     endConversation(): Promise<void>;
+    /**
+     * Start a fresh conversation — clears the visible transcript and unsets
+     * conversationId so the next send creates a new thread on the server.
+     * Prior session stays in DB for history; only the in-memory view resets.
+     * Use when an issue bubble (billing, error) is blocking the current
+     * conversation and the user wants a clean slate after resolving it.
+     */
+    newConversation(): void;
     sendChatMessage(message: string, attachments?: ChatAttachment[]): Promise<void>;
     private buildHistory;
     /** Seed the controller with previously-loaded messages (e.g. from a server thread). */

package/dist/agent/schema.d.ts

@@ -7,12 +7,20 @@ export interface ChatAttachment {
     mimeType: string;
     mediaId?: string;
 }
+export interface ChatMessageIssue {
+    code: string;
+    bucket: 'account' | 'error';
+    actionLabel: string;
+    actionUrl: string;
+    help?: string;
+}
 export interface ChatMessage {
     id: string;
     text: string;
     sender: 'user' | 'agent' | 'system';
     timestamp: string;
     attachments?: ChatAttachment[];
+    issue?: ChatMessageIssue;
 }
 export interface TextConnectionState {
     isActive: boolean;
@@ -20,6 +28,14 @@ export interface TextConnectionState {
     isThinking: boolean;
     connectionStatus: 'connecting' | 'connected' | 'disconnected' | 'error';
     error?: string;
+    /**
+     * Set when the server emits a persistent `bucket: 'account'` issue
+     * (billing past-due, credit limit, budget cap). Stays true until the
+     * user starts a new conversation — further sends are blocked because
+     * retrying just hits the same error and looks like the product is
+     * silently failing. Cleared by newConversation().
+     */
+    accountGated?: boolean;
 }
 export declare const AGENT_MODES: readonly [{
     readonly mode: "self";