@astermind/cybernetic-chatbot-client 1.0.6

package/dist/types.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Configuration for CyberneticClient
+ */
+export interface CyberneticConfig {
+    /** Backend API URL */
+    apiUrl: string;
+    /** API key for authentication */
+    apiKey: string;
+    /** License key (JWT token) for AsterMind licensing */
+    licenseKey?: string;
+    /** Fallback/offline configuration */
+    fallback?: {
+        /** Enable offline fallback (default: true) */
+        enabled?: boolean;
+        /** Cache max age in milliseconds (default: 24 hours) */
+        cacheMaxAge?: number;
+        /** Sync documents on connect (default: true) */
+        cacheOnConnect?: boolean;
+        /** Storage type (default: 'indexeddb') */
+        cacheStorage?: 'indexeddb' | 'localstorage';
+    };
+    /** Retry configuration */
+    retry?: {
+        /** Max retries before fallback (default: 2) */
+        maxRetries?: number;
+        /** Initial delay in ms (default: 1000) */
+        initialDelay?: number;
+        /** Use exponential backoff (default: true) */
+        exponentialBackoff?: boolean;
+    };
+    /** Event callbacks */
+    onStatusChange?: (status: ConnectionStatus) => void;
+    onError?: (error: CyberneticError) => void;
+    /** Optional agentic capabilities configuration (requires importing CyberneticAgent) */
+    agentic?: AgenticConfig;
+}
+/**
+ * Agentic capabilities configuration
+ * Only active when CyberneticAgent is imported AND enabled
+ */
+export interface AgenticConfig {
+    /** Enable agentic DOM interactions (default: false) */
+    enabled: boolean;
+    /** Confidence threshold for action execution (default: 0.8) */
+    confidenceThreshold?: number;
+    /** Allowed DOM actions */
+    allowedActions?: ('click' | 'fill' | 'scroll' | 'navigate' | 'select')[];
+    /** Require user confirmation before actions (default: true) */
+    confirmActions?: boolean;
+    /**
+     * Alias for confirmActions - require user confirmation before actions
+     * Use this or confirmActions, not both
+     */
+    requireConfirmation?: boolean;
+    /** Maximum actions per conversation turn (default: 5) */
+    maxActionsPerTurn?: number;
+    /** CSS selectors to never interact with */
+    blockedSelectors?: string[];
+    /** Only allow actions within these selectors */
+    allowedSelectors?: string[];
+}
+/**
+ * Connection status
+ */
+export type ConnectionStatus = 'online' | 'offline' | 'connecting' | 'error';
+/**
+ * Confidence level of response
+ */
+export type ConfidenceLevel = 'high' | 'medium' | 'low' | 'none';
+/**
+ * Source document from RAG
+ */
+export interface Source {
+    title: string;
+    snippet: string;
+    relevance: number;
+    documentId?: string;
+}
+/**
+ * Response from CyberneticClient
+ * Always returned, never throws
+ */
+export interface CyberneticResponse {
+    /** The response text */
+    reply: string;
+    /** Confidence level of the response */
+    confidence: ConfidenceLevel;
+    /** Source documents used */
+    sources: Source[];
+    /** Whether response came from offline fallback */
+    offline: boolean;
+    /** Session ID for conversation continuity */
+    sessionId?: string;
+    /** Seconds until retry is suggested (only on failures) */
+    retryAfter?: number;
+    /** Why confidence is reduced (for debugging) */
+    degradedReason?: string;
+}
+/**
+ * Request options for ask()
+ */
+export interface AskOptions {
+    /** Session ID for conversation continuity */
+    sessionId?: string;
+    /** Context metadata */
+    context?: {
+        currentPage?: string;
+        pageTitle?: string;
+    };
+    /** Skip offline fallback for this request */
+    skipFallback?: boolean;
+}
+/**
+ * Streaming callback for SSE responses
+ */
+export interface StreamCallbacks {
+    onToken?: (token: string) => void;
+    onSources?: (sources: Source[]) => void;
+    onComplete?: (response: CyberneticResponse) => void;
+    onError?: (error: CyberneticError) => void;
+}
+/**
+ * Cached document for offline RAG
+ */
+export interface CachedDocument {
+    id: string;
+    title: string;
+    content: string;
+    updatedAt: string;
+    embedding?: number[];
+}
+/**
+ * Cache status
+ */
+export interface CacheStatus {
+    documentCount: number;
+    lastSyncAt: string | null;
+    cacheSize: number;
+    isStale: boolean;
+}
+/**
+ * Error type for Cybernetic operations
+ */
+export interface CyberneticError {
+    code: 'NETWORK_ERROR' | 'AUTH_ERROR' | 'RATE_LIMIT' | 'SERVER_ERROR' | 'CACHE_ERROR' | 'LOCAL_RAG_ERROR';
+    message: string;
+    retryAfter?: number;
+    originalError?: Error;
+}
+/**
+ * System-wide settings from server (ADR-200)
+ */
+export interface SystemSettings {
+    /** Hours to retain cached data (default: 168 = 7 days) */
+    cacheRetentionHours: number;
+    /** When true, clients should use cached data only */
+    maintenanceMode: boolean;
+    /** Optional message to display during maintenance */
+    maintenanceMessage?: string;
+    /** Force all clients to operate in offline mode */
+    forceOfflineClients: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "@astermind/cybernetic-chatbot-client",
+  "version": "1.0.6",
+  "type": "module",
+  "description": "Offline-capable AI chatbot client with local RAG fallback and agentic capabilities for AsterMind",
+  "main": "dist/cybernetic-chatbot-client.umd.js",
+  "module": "dist/cybernetic-chatbot-client.esm.js",
+  "types": "dist/index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/cybernetic-chatbot-client.esm.js",
+      "require": "./dist/cybernetic-chatbot-client.umd.js"
+    },
+    "./full": {
+      "types": "./dist/full.d.ts",
+      "import": "./dist/cybernetic-chatbot-client-full.esm.js",
+      "require": "./dist/cybernetic-chatbot-client-full.umd.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "prebuild": "node scripts/bump-version.js",
+    "build": "rollup -c",
+    "build:clean": "rm -rf dist && npm run build",
+    "dev": "rollup -c -w",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest --coverage",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit",
+    "audit": "npm audit",
+    "prerelease": "npm run build:clean && npm run typecheck && npm run test && npm run audit",
+    "version:patch": "node scripts/bump-version.js patch",
+    "version:minor": "node scripts/bump-version.js minor",
+    "version:major": "node scripts/bump-version.js major",
+    "prepublishOnly": "npm run typecheck && npm run test && npm run build"
+  },
+  "dependencies": {
+    "idb": "^7.1.1"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^25.0.0",
+    "@rollup/plugin-node-resolve": "^15.0.0",
+    "@rollup/plugin-terser": "^0.4.0",
+    "@rollup/plugin-typescript": "^11.0.0",
+    "@types/node": "^20.0.0",
+    "jsdom": "^27.4.0",
+    "rollup": "^4.0.0",
+    "tslib": "^2.8.1",
+    "typescript": "^5.0.0",
+    "vitest": "^4.0.17"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "keywords": [
+    "chatbot",
+    "rag",
+    "ai",
+    "offline",
+    "offline-first",
+    "agentic",
+    "astermind",
+    "cybernetic",
+    "indexeddb",
+    "cache",
+    "streaming",
+    "sse",
+    "dom-automation",
+    "intent-classification",
+    "client-sdk"
+  ],
+  "author": "AsterMind Team",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "homepage": "https://astermind.ai"
+}