@blinq_ai/widget 0.1.0 → 0.1.2

package/dist/widget-core-D0ZdQY2E.d.cts

@@ -0,0 +1,253 @@
+interface ActionableElementHint {
+    type: "button" | "link" | "input" | "textarea" | "submit";
+    label?: string;
+    selector: string;
+    placeholder?: string;
+    href?: string;
+    form_selector?: string;
+    context_text?: string;
+    input_type?: string;
+}
+type SemanticToolKind = "add-item" | "delete-item" | "toggle-item" | "clear-completed" | "open-link" | "submit-form" | "activate-element";
+interface SemanticToolDescriptor {
+    name: string;
+    kind: SemanticToolKind;
+    title: string;
+    description: string;
+    target_summary: string;
+    keywords: string[];
+    input_schema?: Record<string, unknown>;
+    default_arguments?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}
+interface PageFormDescriptor {
+    selector: string;
+    title: string;
+    context_text?: string;
+    field_selector?: string;
+    field_label?: string;
+    submit_selector?: string;
+    submit_label?: string;
+}
+interface PageListItemActionDescriptor {
+    kind: "delete-item" | "toggle-item" | "open-link";
+    selector?: string;
+    href?: string;
+    label: string;
+    target_summary: string;
+}
+interface PageListItemDescriptor {
+    selector: string;
+    title: string;
+    context_text: string;
+    actions: PageListItemActionDescriptor[];
+}
+interface PageGraph {
+    forms: PageFormDescriptor[];
+    list_items: PageListItemDescriptor[];
+    standalone_actions: ActionableElementHint[];
+}
+interface NormalizedPageContext {
+    url: string;
+    title: string;
+    selection: string;
+    visible_text: string;
+    actionable_elements: ActionableElementHint[];
+    page_graph: PageGraph;
+    semantic_tools: SemanticToolDescriptor[];
+}
+declare function collectNormalizedPageContext(): NormalizedPageContext;
+
+type RuntimeMode = "native-webmcp-active" | "blinq-page-tools-active" | "read-only-fallback";
+interface ToolCapability {
+    name: string;
+    description: string;
+    read_only: boolean;
+}
+interface ActionPolicy {
+    actions_enabled: boolean;
+    action_mode: "guide_only" | "execute_with_confirmation";
+    pointer_overlay_enabled: boolean;
+}
+interface RuntimeCapability {
+    mode: RuntimeMode;
+    native_webmcp_supported: boolean;
+    embedded_page_tools_supported: boolean;
+    write_requires_confirmation: boolean;
+    tool_capabilities: ToolCapability[];
+    action_policy: ActionPolicy;
+}
+
+interface ToolExecutionRequest {
+    tool_name: string;
+    display_name?: string;
+    target_summary?: string;
+    requires_confirmation?: boolean;
+    arguments: Record<string, unknown>;
+}
+interface ToolExecutionOutcome {
+    status: "success" | "cancelled" | "error";
+    result?: Record<string, unknown>;
+    error?: string;
+}
+interface PageHighlightTarget {
+    selector: string;
+    label?: string;
+}
+interface HighlightTargetsOptions {
+    durationMs?: number;
+    interaction?: "explain" | "execute";
+}
+type ConfirmationHandler = (request: {
+    displayName: string;
+    targetSummary: string;
+    arguments: Record<string, unknown>;
+}) => Promise<boolean>;
+declare function detectNativeWebMcpSupport(): boolean;
+declare class PageToolRegistry {
+    private readonly confirmationHandler;
+    private readonly tools;
+    private readonly nativeRegistrations;
+    private latestPageContext;
+    private nativeToolsActive;
+    private highlightLayer;
+    private highlightTimer;
+    private actionPolicy;
+    constructor(confirmationHandler: ConfirmationHandler);
+    setActionPolicy(nextPolicy?: Partial<ActionPolicy>): void;
+    private buildBaseTools;
+    private refreshToolCatalog;
+    private onMutatingToolSuccess;
+    collectPageContext(): NormalizedPageContext;
+    getToolCapabilities(): ToolCapability[];
+    clearHighlights(): void;
+    private ensureHighlightLayer;
+    private ensureHighlightStyle;
+    highlightTargets(targets: PageHighlightTarget[], options?: HighlightTargetsOptions): boolean;
+    private isToolAllowed;
+    private previewToolRequest;
+    canExecuteWriteTools(): boolean;
+    executeTool(request: ToolExecutionRequest): Promise<ToolExecutionOutcome>;
+    unregisterNativeTools(): void;
+    registerNativeTools(): Promise<boolean>;
+    destroy(): void;
+}
+
+interface BlinqWidgetInitOptions {
+    publicToken: string;
+    apiBaseUrl?: string;
+    mcpEndpoint?: string;
+    mount?: string | HTMLElement;
+}
+type BlinqWidgetConfigFile = BlinqWidgetInitOptions;
+interface BlinqWidgetRuntimeStatus extends RuntimeCapability {
+    message: string;
+}
+declare class BlinqWidget {
+    private readonly options;
+    private readonly apiBaseUrl;
+    private sessionId;
+    private sessionToken;
+    private widgetConfig;
+    private runtimeStatus;
+    private registry;
+    private root;
+    private reactRoot;
+    private voiceController;
+    private history;
+    private items;
+    private minimized;
+    private isSending;
+    private inputValue;
+    private statusText;
+    private voiceSupported;
+    private voiceListening;
+    private voiceWaveform;
+    private voiceDurationMs;
+    private voiceStartedAt;
+    private lastVoiceSampleAt;
+    private confirmResolve;
+    private confirmItemId;
+    private activeRun;
+    private activeGuide;
+    private pendingAssistantIndicator;
+    private executedToolCounts;
+    private lastAutoResumeKey;
+    private readonly shellHandlers;
+    constructor(options: BlinqWidgetInitOptions);
+    private currentActionPolicy;
+    init(): Promise<this>;
+    getRuntimeStatus(): BlinqWidgetRuntimeStatus | null;
+    destroy(): void;
+    private currentState;
+    private renderReactApp;
+    private startSession;
+    private render;
+    private preferredSpeechLanguage;
+    private setupVoiceInput;
+    private syncVoiceState;
+    private startVoiceVisualization;
+    private resetVoiceVisualization;
+    private updateVoiceVisualization;
+    private submitComposerMessage;
+    private toggleVoiceInput;
+    private minimizedStorageKey;
+    private sessionStorageKey;
+    private restoreStoredSessionId;
+    private persistSessionId;
+    private restoreMinimizedState;
+    private persistMinimizedState;
+    private setMinimized;
+    private historyStorageKey;
+    private restoreHistory;
+    private persistHistory;
+    private rememberMessage;
+    private recentHistoryForRequest;
+    private restoreConversationView;
+    private normalizeGuideStep;
+    private normalizeGuidePayload;
+    private setGuideState;
+    private currentGuideStep;
+    private syncGuideHighlight;
+    private updateActionState;
+    private planItemId;
+    private upsertPlanItem;
+    private removeEmptyMessage;
+    private resolveConfirmation;
+    private confirmToolExecution;
+    private syncRuntimeStatus;
+    private setStatus;
+    private guideRequest;
+    private startGuide;
+    private advanceGuide;
+    private dismissGuide;
+    private completeGuide;
+    private runGuideStep;
+    private healGuideStep;
+    private appendMessage;
+    private updateMessage;
+    private latestAssistantMessage;
+    private finalizeAssistantMessage;
+    private showThinkingIndicator;
+    private hideThinkingIndicator;
+    private currentPageContext;
+    private currentRoute;
+    private normalizedUserPlanDecision;
+    private shouldAutoResumeActiveRun;
+    private handleToolRequest;
+    private streamChatStep;
+    sendMessage(message: string): Promise<string>;
+    private continueActiveRun;
+    respondToPlan(approved: boolean, options?: {
+        appendAssistantMessage?: boolean;
+        manageSendingState?: boolean;
+    }): Promise<string>;
+    endSession(): Promise<void>;
+}
+declare function init(options: BlinqWidgetInitOptions): Promise<BlinqWidget>;
+declare function initFromConfig(config: BlinqWidgetConfigFile | {
+    default: BlinqWidgetConfigFile;
+}): Promise<BlinqWidget>;
+declare function createBlinqWidget(options: BlinqWidgetInitOptions): Promise<BlinqWidget>;
+
+export { type ActionPolicy as A, BlinqWidget as B, type PageHighlightTarget as P, type RuntimeCapability as R, type BlinqWidgetConfigFile as a, type BlinqWidgetInitOptions as b, type BlinqWidgetRuntimeStatus as c, PageToolRegistry as d, collectNormalizedPageContext as e, createBlinqWidget as f, detectNativeWebMcpSupport as g, initFromConfig as h, init as i };

package/dist/widget-core-D0ZdQY2E.d.ts

@@ -0,0 +1,253 @@
+interface ActionableElementHint {
+    type: "button" | "link" | "input" | "textarea" | "submit";
+    label?: string;
+    selector: string;
+    placeholder?: string;
+    href?: string;
+    form_selector?: string;
+    context_text?: string;
+    input_type?: string;
+}
+type SemanticToolKind = "add-item" | "delete-item" | "toggle-item" | "clear-completed" | "open-link" | "submit-form" | "activate-element";
+interface SemanticToolDescriptor {
+    name: string;
+    kind: SemanticToolKind;
+    title: string;
+    description: string;
+    target_summary: string;
+    keywords: string[];
+    input_schema?: Record<string, unknown>;
+    default_arguments?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}
+interface PageFormDescriptor {
+    selector: string;
+    title: string;
+    context_text?: string;
+    field_selector?: string;
+    field_label?: string;
+    submit_selector?: string;
+    submit_label?: string;
+}
+interface PageListItemActionDescriptor {
+    kind: "delete-item" | "toggle-item" | "open-link";
+    selector?: string;
+    href?: string;
+    label: string;
+    target_summary: string;
+}
+interface PageListItemDescriptor {
+    selector: string;
+    title: string;
+    context_text: string;
+    actions: PageListItemActionDescriptor[];
+}
+interface PageGraph {
+    forms: PageFormDescriptor[];
+    list_items: PageListItemDescriptor[];
+    standalone_actions: ActionableElementHint[];
+}
+interface NormalizedPageContext {
+    url: string;
+    title: string;
+    selection: string;
+    visible_text: string;
+    actionable_elements: ActionableElementHint[];
+    page_graph: PageGraph;
+    semantic_tools: SemanticToolDescriptor[];
+}
+declare function collectNormalizedPageContext(): NormalizedPageContext;
+
+type RuntimeMode = "native-webmcp-active" | "blinq-page-tools-active" | "read-only-fallback";
+interface ToolCapability {
+    name: string;
+    description: string;
+    read_only: boolean;
+}
+interface ActionPolicy {
+    actions_enabled: boolean;
+    action_mode: "guide_only" | "execute_with_confirmation";
+    pointer_overlay_enabled: boolean;
+}
+interface RuntimeCapability {
+    mode: RuntimeMode;
+    native_webmcp_supported: boolean;
+    embedded_page_tools_supported: boolean;
+    write_requires_confirmation: boolean;
+    tool_capabilities: ToolCapability[];
+    action_policy: ActionPolicy;
+}
+
+interface ToolExecutionRequest {
+    tool_name: string;
+    display_name?: string;
+    target_summary?: string;
+    requires_confirmation?: boolean;
+    arguments: Record<string, unknown>;
+}
+interface ToolExecutionOutcome {
+    status: "success" | "cancelled" | "error";
+    result?: Record<string, unknown>;
+    error?: string;
+}
+interface PageHighlightTarget {
+    selector: string;
+    label?: string;
+}
+interface HighlightTargetsOptions {
+    durationMs?: number;
+    interaction?: "explain" | "execute";
+}
+type ConfirmationHandler = (request: {
+    displayName: string;
+    targetSummary: string;
+    arguments: Record<string, unknown>;
+}) => Promise<boolean>;
+declare function detectNativeWebMcpSupport(): boolean;
+declare class PageToolRegistry {
+    private readonly confirmationHandler;
+    private readonly tools;
+    private readonly nativeRegistrations;
+    private latestPageContext;
+    private nativeToolsActive;
+    private highlightLayer;
+    private highlightTimer;
+    private actionPolicy;
+    constructor(confirmationHandler: ConfirmationHandler);
+    setActionPolicy(nextPolicy?: Partial<ActionPolicy>): void;
+    private buildBaseTools;
+    private refreshToolCatalog;
+    private onMutatingToolSuccess;
+    collectPageContext(): NormalizedPageContext;
+    getToolCapabilities(): ToolCapability[];
+    clearHighlights(): void;
+    private ensureHighlightLayer;
+    private ensureHighlightStyle;
+    highlightTargets(targets: PageHighlightTarget[], options?: HighlightTargetsOptions): boolean;
+    private isToolAllowed;
+    private previewToolRequest;
+    canExecuteWriteTools(): boolean;
+    executeTool(request: ToolExecutionRequest): Promise<ToolExecutionOutcome>;
+    unregisterNativeTools(): void;
+    registerNativeTools(): Promise<boolean>;
+    destroy(): void;
+}
+
+interface BlinqWidgetInitOptions {
+    publicToken: string;
+    apiBaseUrl?: string;
+    mcpEndpoint?: string;
+    mount?: string | HTMLElement;
+}
+type BlinqWidgetConfigFile = BlinqWidgetInitOptions;
+interface BlinqWidgetRuntimeStatus extends RuntimeCapability {
+    message: string;
+}
+declare class BlinqWidget {
+    private readonly options;
+    private readonly apiBaseUrl;
+    private sessionId;
+    private sessionToken;
+    private widgetConfig;
+    private runtimeStatus;
+    private registry;
+    private root;
+    private reactRoot;
+    private voiceController;
+    private history;
+    private items;
+    private minimized;
+    private isSending;
+    private inputValue;
+    private statusText;
+    private voiceSupported;
+    private voiceListening;
+    private voiceWaveform;
+    private voiceDurationMs;
+    private voiceStartedAt;
+    private lastVoiceSampleAt;
+    private confirmResolve;
+    private confirmItemId;
+    private activeRun;
+    private activeGuide;
+    private pendingAssistantIndicator;
+    private executedToolCounts;
+    private lastAutoResumeKey;
+    private readonly shellHandlers;
+    constructor(options: BlinqWidgetInitOptions);
+    private currentActionPolicy;
+    init(): Promise<this>;
+    getRuntimeStatus(): BlinqWidgetRuntimeStatus | null;
+    destroy(): void;
+    private currentState;
+    private renderReactApp;
+    private startSession;
+    private render;
+    private preferredSpeechLanguage;
+    private setupVoiceInput;
+    private syncVoiceState;
+    private startVoiceVisualization;
+    private resetVoiceVisualization;
+    private updateVoiceVisualization;
+    private submitComposerMessage;
+    private toggleVoiceInput;
+    private minimizedStorageKey;
+    private sessionStorageKey;
+    private restoreStoredSessionId;
+    private persistSessionId;
+    private restoreMinimizedState;
+    private persistMinimizedState;
+    private setMinimized;
+    private historyStorageKey;
+    private restoreHistory;
+    private persistHistory;
+    private rememberMessage;
+    private recentHistoryForRequest;
+    private restoreConversationView;
+    private normalizeGuideStep;
+    private normalizeGuidePayload;
+    private setGuideState;
+    private currentGuideStep;
+    private syncGuideHighlight;
+    private updateActionState;
+    private planItemId;
+    private upsertPlanItem;
+    private removeEmptyMessage;
+    private resolveConfirmation;
+    private confirmToolExecution;
+    private syncRuntimeStatus;
+    private setStatus;
+    private guideRequest;
+    private startGuide;
+    private advanceGuide;
+    private dismissGuide;
+    private completeGuide;
+    private runGuideStep;
+    private healGuideStep;
+    private appendMessage;
+    private updateMessage;
+    private latestAssistantMessage;
+    private finalizeAssistantMessage;
+    private showThinkingIndicator;
+    private hideThinkingIndicator;
+    private currentPageContext;
+    private currentRoute;
+    private normalizedUserPlanDecision;
+    private shouldAutoResumeActiveRun;
+    private handleToolRequest;
+    private streamChatStep;
+    sendMessage(message: string): Promise<string>;
+    private continueActiveRun;
+    respondToPlan(approved: boolean, options?: {
+        appendAssistantMessage?: boolean;
+        manageSendingState?: boolean;
+    }): Promise<string>;
+    endSession(): Promise<void>;
+}
+declare function init(options: BlinqWidgetInitOptions): Promise<BlinqWidget>;
+declare function initFromConfig(config: BlinqWidgetConfigFile | {
+    default: BlinqWidgetConfigFile;
+}): Promise<BlinqWidget>;
+declare function createBlinqWidget(options: BlinqWidgetInitOptions): Promise<BlinqWidget>;
+
+export { type ActionPolicy as A, BlinqWidget as B, type PageHighlightTarget as P, type RuntimeCapability as R, type BlinqWidgetConfigFile as a, type BlinqWidgetInitOptions as b, type BlinqWidgetRuntimeStatus as c, PageToolRegistry as d, collectNormalizedPageContext as e, createBlinqWidget as f, detectNativeWebMcpSupport as g, initFromConfig as h, init as i };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blinq_ai/widget",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Blinq AI browser widget, SDK, and CLI.",
   "repository": {
     "type": "git",
@@ -27,7 +27,7 @@
     "access": "public"
   },
   "bin": {
-    "blinq-widget": "./dist/cli.js"
+    "widget": "dist/cli.js"
   },
   "exports": {
     ".": {
@@ -44,6 +44,7 @@
   ],
   "dependencies": {
     "@assistant-ui/react": "^0.12.23",
+    "lucide-react": "^1.7.0",
     "react": "19.2.4",
     "react-dom": "19.2.4"
   },