@skippr/live-agent-sdk 0.61.0 → 0.63.0

package/dist/types/capture/agentActionSignal.d.ts

@@ -2,3 +2,15 @@
 export declare function runAgentAction(dispatch: () => void): void;
 /** True while the agent's synthetic DOM event is dispatching. */
 export declare function isAgentActionInProgress(): boolean;
+/** DomCapture subscribes; returns an unsubscribe. */
+export declare function onSnapshotRequest(handler: () => void): () => void;
+/** PageActionHandler calls this after performing an agent action. */
+export declare function requestSnapshotAfterAction(): void;
+export declare function setActionsPaused(paused: boolean): void;
+export declare function isActionsPaused(): boolean;
+/** PageActionHandler subscribes to re-drain its held queue on resume; returns an unsubscribe. */
+export declare function onActionsPausedChange(cb: (paused: boolean) => void): () => void;
+export declare function setActionsBusy(busy: boolean): void;
+export declare function isActionsBusy(): boolean;
+/** Control bar subscribes to show/hide the Stop button; returns an unsubscribe. */
+export declare function subscribeActionsBusy(cb: (busy: boolean) => void): () => void;

package/dist/types/components/MessageList.d.ts

@@ -1,10 +1,12 @@
+import type { PlanCardData } from '../hooks/usePlanUpdates';
 import type { Message } from '../types';
 interface MessageListProps {
     messages: Message[];
     isStreaming: boolean;
     sendChatMessage: (message: string) => Promise<unknown>;
     isSendingChat: boolean;
+    plan?: PlanCardData | null;
     autoFocus?: boolean;
 }
-export declare function MessageList({ messages, isStreaming, sendChatMessage, isSendingChat, autoFocus, }: MessageListProps): import("react/jsx-runtime").JSX.Element;
+export declare function MessageList({ messages, isStreaming, sendChatMessage, isSendingChat, plan, autoFocus, }: MessageListProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/components/PlanCard.d.ts

@@ -0,0 +1,8 @@
+import type { PlanCardData } from '../hooks/usePlanUpdates';
+interface PlanCardProps {
+    plan: PlanCardData;
+    sendChatMessage: (message: string) => Promise<unknown>;
+    onDismiss: () => void;
+}
+export declare function PlanCard({ plan, sendChatMessage, onDismiss }: PlanCardProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/types/hooks/useActionControl.d.ts

@@ -0,0 +1,8 @@
+export interface UseActionControlValue {
+    /** True while the agent's on-screen action flow is running (single action or multi-step plan). */
+    actionsActive: boolean;
+    actionsPaused: boolean;
+    togglePaused: () => Promise<void>;
+}
+/** Owns the user's pause/resume control over the agent's on-screen action flow. */
+export declare function useActionControl(): UseActionControlValue;

package/dist/types/hooks/usePlanUpdates.d.ts

@@ -0,0 +1,14 @@
+export type PlanStepStatus = 'pending' | 'active' | 'done' | 'failed';
+export type PlanState = 'proposed' | 'executing' | 'completed' | 'abandoned';
+export interface PlanStep {
+    index: number;
+    label: string;
+    status: PlanStepStatus;
+}
+export interface PlanCardData {
+    planId: string;
+    steps: PlanStep[];
+    state: PlanState;
+}
+export declare function parsePlan(json: string): PlanCardData | null;
+export declare function usePlanUpdates(): PlanCardData | null;

package/dist/types/lib/constants.d.ts

@@ -7,4 +7,6 @@ export declare const DOM_EVENTS_TOPIC = "skippr.dom-events";
 export declare const HIGHLIGHT_TOPIC = "skippr.highlight";
 export declare const PAGE_ACTIONS_TOPIC = "skippr.page-actions";
 export declare const TEXT_MODE_TOPIC = "skippr.text-mode";
+export declare const ACTION_CONTROL_TOPIC = "skippr.action-control";
+export declare const PLAN_ATTR = "skippr.action-plan";
 export declare const NAME_MAX_CHARS = 80;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skippr/live-agent-sdk",
-  "version": "0.61.0",
+  "version": "0.63.0",
   "type": "module",
   "main": "dist/esm/lib-exports.js",
   "module": "dist/esm/lib-exports.js",