@bridgeline-digital/hawkai-assistant 1.0.0-beta.0

package/dist/main.d.ts

@@ -0,0 +1,7 @@
+import { Config } from './types';
+export declare const initialize: (config: Config) => void;
+export declare const setActorId: (value: string | undefined) => void;
+export declare const setContext: (context: Record<string, unknown> | undefined) => void;
+export declare const toggle: (open: boolean) => void;
+export declare const sendMessage: (message?: string, files?: File[]) => Promise<void>;
+export declare const clearChat: () => void;

package/dist/session-manager.d.ts

@@ -0,0 +1,8 @@
+export declare const loadSessionState: () => void;
+export declare const getSessionId: () => string;
+export declare const getActorId: () => string;
+export declare const regenerateSessionId: () => void;
+export declare const ensureSessionId: () => void;
+export declare const setActorId: (value: string | undefined) => void;
+export declare const getContext: () => Record<string, unknown> | undefined;
+export declare const setContext: (value: Record<string, unknown> | undefined) => void;

package/dist/tools/display-products-tool.d.ts

@@ -0,0 +1,6 @@
+import { Product, Tool } from '../types';
+interface DisplayProductsInput {
+    products: Product[];
+}
+export declare const getDisplayProductsTool: () => Tool<DisplayProductsInput, string>;
+export {};

package/dist/tools/page-context-tool.d.ts

@@ -0,0 +1,12 @@
+import { Tool } from '../types';
+interface PageContextOutput {
+    url: string;
+    title: string;
+    description: string;
+    ogTitle: string;
+    h1: string;
+    mainContent: string;
+    structuredData: string;
+}
+export declare const getRetrievePageContextTool: () => Tool<Record<string, never>, PageContextOutput>;
+export {};

package/dist/types.d.ts

@@ -0,0 +1,81 @@
+export type ToolRenderStatus = 'pending' | 'success' | 'error';
+export interface RenderToolData<TInput> {
+    input: TInput;
+    status: ToolRenderStatus | undefined;
+}
+export interface RenderToolHelpers {
+    sendMessage: (text: string) => Promise<void>;
+}
+export type RenderToolResult = import('preact').ComponentChild | HTMLElement | null;
+export type AsyncRenderToolResult = RenderToolResult | Promise<RenderToolResult>;
+export interface Tool<TInput, TOutput> {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+    execute: (input: TInput) => Promise<TOutput>;
+    render?: (data: RenderToolData<TInput>, helpers: RenderToolHelpers) => AsyncRenderToolResult;
+}
+export type AnyTool = Tool<any, any>;
+export interface UiConfig {
+    open?: boolean;
+    display?: 'window' | 'drawer';
+    position?: 'left' | 'right';
+    theme?: 'light' | 'dark' | 'automatic';
+    allowFullScreen?: boolean;
+    allowFileUpload?: boolean;
+    logoUrl?: string;
+    heading?: string;
+    initialMessage?: string;
+    promptOptions?: string[];
+    placeholder?: string;
+    colors?: {
+        primary?: {
+            default: string;
+            hover: string;
+        };
+    };
+    styles?: string;
+    stylesheetUrl?: string;
+}
+export interface Product {
+    id: string;
+    title: string;
+    url: string;
+    imageUrl?: string;
+    price?: number;
+    salePrice?: number;
+    rating?: number;
+    brand?: string;
+    sku?: string;
+    description?: string;
+}
+export interface Config {
+    apiUrl: string;
+    accountId: string;
+    agentId: string;
+    actorId?: string;
+    context?: Record<string, unknown>;
+    addToCart?: (product: Product) => void;
+    tools?: AnyTool[];
+    ui?: UiConfig;
+}
+declare global {
+    interface HawkAINamespace {
+        Assistant: {
+            config: Config;
+            initialize: (config: Config) => void;
+            setActorId: (value: string | undefined) => void;
+            setContext: (context: Record<string, unknown> | undefined) => void;
+            toggle: (open: boolean) => void;
+            sendMessage: (message?: string, files?: File[]) => Promise<void>;
+            clearChat: () => void;
+        };
+    }
+    interface Window {
+        HawkAI: HawkAINamespace;
+    }
+}

package/dist/utilities/parseMarkdown.d.ts

@@ -0,0 +1,28 @@
+import { JSX } from 'preact';
+export interface MarkdownClasses {
+    a: string;
+    blockquote: string;
+    code: string;
+    em: string;
+    h1: string;
+    h2: string;
+    h3: string;
+    h4: string;
+    h5: string;
+    h6: string;
+    hr: string;
+    li: string;
+    ol: string;
+    p: string;
+    pre: string;
+    strong: string;
+    table: string;
+    tbody: string;
+    td: string;
+    th: string;
+    thead: string;
+    tr: string;
+    ul: string;
+}
+export declare const DEFAULT_CLASSES: MarkdownClasses;
+export declare const parseMarkdown: (content: string, classes?: Partial<MarkdownClasses>) => JSX.Element;

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@bridgeline-digital/hawkai-assistant",
+  "version": "1.0.0-beta.0",
+  "type": "module",
+  "packageManager": "pnpm@10.33.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": ["dist"],
+  "main": "./dist/hawkai-assistant.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -b && vite build && vite build --config vite.library.config.ts",
+    "preview": "vite preview",
+    "lint": "biome check --fix .",
+    "prepare": "husky || true",
+    "prepack": "pnpm build",
+    "version:bump-beta": "node scripts/bump-beta-version.js",
+    "version:finalize-stable": "node scripts/finalize-stable-version.js"
+  },
+  "lint-staged": {
+    "*.{ts,tsx,js,json}": ["biome check --write"]
+  },
+  "dependencies": {
+    "@heroicons/react": "^2.2.0",
+    "clsx": "^2.1.1",
+    "dompurify": "^3.4.5",
+    "eventsource-parser": "^3.0.8",
+    "marked": "^18.0.4",
+    "preact": "^10.29.2",
+    "uuid": "^14.0.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.15",
+    "@preact/preset-vite": "^2.10.5",
+    "@tailwindcss/vite": "^4.3.0",
+    "@types/dompurify": "^3.2.0",
+    "@types/node": "^24.12.4",
+    "husky": "^9.1.7",
+    "lint-staged": "^17.0.5",
+    "tailwindcss": "^4.3.0",
+    "typescript": "~6.0.3",
+    "vite": "^8.0.13",
+    "vite-plugin-dts": "^5.0.1"
+  }
+}