chatablex-web-sdk 1.0.0 → 1.0.3

package/dist/index.d.mts

@@ -66,31 +66,6 @@ interface ToolResult {
     duration?: number;
 }
 type ToolExecuteHandler = (params: Record<string, unknown>) => Promise<Record<string, unknown>>;
-interface Skill {
-    id: string;
-    name: string;
-    description: string;
-    version: string;
-    author?: string;
-    category?: string;
-    toolIds: string[];
-    variables: SkillVariable[];
-    installed: boolean;
-}
-interface SkillVariable {
-    name: string;
-    type: string;
-    description: string;
-    required: boolean;
-    default?: unknown;
-}
-interface SkillResult {
-    success: boolean;
-    data?: unknown;
-    error?: string;
-    skillId: string;
-    toolResults?: ToolResult[];
-}
 type NotificationType = 'info' | 'success' | 'warning' | 'error';
 interface FilePickerOptions {
     type?: 'any' | 'image' | 'video' | 'audio' | 'custom';
@@ -155,10 +130,6 @@ interface ChatableXTools {
     execute(toolId: string, params: Record<string, unknown>): Promise<ToolResult>;
     executeWithConfirm(toolId: string, params: Record<string, unknown>): Promise<ToolResult>;
 }
-interface ChatableXSkills {
-    list(): Promise<Skill[]>;
-    execute(skillId: string, variables: Record<string, unknown>): Promise<SkillResult>;
-}
 interface ChatableXUI {
     showNotification(message: string, type?: NotificationType): Promise<void>;
     showConfirm(title: string, message: string): Promise<boolean>;
@@ -181,14 +152,18 @@ interface ChatableXToolModule {
     getInfo(): ToolInfo;
     onExecute(handler: ToolExecuteHandler): void;
 }
+interface ChatableXPlatform {
+    /** Open URL in system browser with auth handoff (WebView only; implemented by Flutter host). */
+    openInBrowser(targetUrl: string): Promise<void>;
+}
 interface ChatableXSDK {
     ai: ChatableXAI;
     tools: ChatableXTools;
-    skills: ChatableXSkills;
     ui: ChatableXUI;
     events: ChatableXEvents;
     storage: ChatableXStorage;
     tool: ChatableXToolModule;
+    platform: ChatableXPlatform;
 }
 declare global {
     interface Window {
@@ -224,7 +199,7 @@ declare class Bridge {
     /** Wait for ChatableXBridge (set by Flutter) to become available. */
     waitForBridge(timeoutMs: number): Promise<void>;
     /** Send a request to Flutter and wait for a response. */
-    sendMessage(method: string, params?: Record<string, unknown>, requestTimeoutMs?: number): Promise<unknown>;
+    sendMessage(method: string, params?: object, requestTimeoutMs?: number): Promise<unknown>;
     private _handleResponse;
     private _handleEvent;
     addEventListener(eventType: string, handler: EventHandler): () => void;
@@ -255,7 +230,7 @@ declare class Bridge {
  * ```
  */
 
-declare const SDK_VERSION = "1.0.0";
+declare const SDK_VERSION: string;
 /**
  * Main entry point. Provides `ChatableX.init()` to bootstrap the SDK.
  */
@@ -277,4 +252,4 @@ declare const ChatableX: {
     version: string;
 };
 
-export { type AiResponseEventData, Bridge, type ChatOptions, type ChatResponse, ChatableX, type ChatableXAI, type ChatableXEvents, type ChatableXInitConfig, type ChatableXSDK, type ChatableXSkills, type ChatableXStorage, type ChatableXToolModule, type ChatableXTools, type ChatableXUI, type CloseEventData, type EventCallbackMap, type EventType, type FilePickerOptions, type Message, type NotificationType, SDK_VERSION, type SessionContext, type Skill, type SkillResult, type SkillVariable, type StateUpdate, type StreamingContentEventData, type TabConfig, type ToolCall, type ToolExecuteHandler, type ToolExecutionEventData, type ToolInfo, type ToolParameter, type ToolResult, type Unsubscribe, type UserMessageEventData };
+export { type AiResponseEventData, Bridge, type ChatOptions, type ChatResponse, ChatableX, type ChatableXAI, type ChatableXEvents, type ChatableXInitConfig, type ChatableXPlatform, type ChatableXSDK, type ChatableXStorage, type ChatableXToolModule, type ChatableXTools, type ChatableXUI, type CloseEventData, type EventCallbackMap, type EventType, type FilePickerOptions, type Message, type NotificationType, SDK_VERSION, type SessionContext, type StateUpdate, type StreamingContentEventData, type TabConfig, type ToolCall, type ToolExecuteHandler, type ToolExecutionEventData, type ToolInfo, type ToolParameter, type ToolResult, type Unsubscribe, type UserMessageEventData };

package/dist/index.d.ts

@@ -66,31 +66,6 @@ interface ToolResult {
     duration?: number;
 }
 type ToolExecuteHandler = (params: Record<string, unknown>) => Promise<Record<string, unknown>>;
-interface Skill {
-    id: string;
-    name: string;
-    description: string;
-    version: string;
-    author?: string;
-    category?: string;
-    toolIds: string[];
-    variables: SkillVariable[];
-    installed: boolean;
-}
-interface SkillVariable {
-    name: string;
-    type: string;
-    description: string;
-    required: boolean;
-    default?: unknown;
-}
-interface SkillResult {
-    success: boolean;
-    data?: unknown;
-    error?: string;
-    skillId: string;
-    toolResults?: ToolResult[];
-}
 type NotificationType = 'info' | 'success' | 'warning' | 'error';
 interface FilePickerOptions {
     type?: 'any' | 'image' | 'video' | 'audio' | 'custom';
@@ -155,10 +130,6 @@ interface ChatableXTools {
     execute(toolId: string, params: Record<string, unknown>): Promise<ToolResult>;
     executeWithConfirm(toolId: string, params: Record<string, unknown>): Promise<ToolResult>;
 }
-interface ChatableXSkills {
-    list(): Promise<Skill[]>;
-    execute(skillId: string, variables: Record<string, unknown>): Promise<SkillResult>;
-}
 interface ChatableXUI {
     showNotification(message: string, type?: NotificationType): Promise<void>;
     showConfirm(title: string, message: string): Promise<boolean>;
@@ -181,14 +152,18 @@ interface ChatableXToolModule {
     getInfo(): ToolInfo;
     onExecute(handler: ToolExecuteHandler): void;
 }
+interface ChatableXPlatform {
+    /** Open URL in system browser with auth handoff (WebView only; implemented by Flutter host). */
+    openInBrowser(targetUrl: string): Promise<void>;
+}
 interface ChatableXSDK {
     ai: ChatableXAI;
     tools: ChatableXTools;
-    skills: ChatableXSkills;
     ui: ChatableXUI;
     events: ChatableXEvents;
     storage: ChatableXStorage;
     tool: ChatableXToolModule;
+    platform: ChatableXPlatform;
 }
 declare global {
     interface Window {
@@ -224,7 +199,7 @@ declare class Bridge {
     /** Wait for ChatableXBridge (set by Flutter) to become available. */
     waitForBridge(timeoutMs: number): Promise<void>;
     /** Send a request to Flutter and wait for a response. */
-    sendMessage(method: string, params?: Record<string, unknown>, requestTimeoutMs?: number): Promise<unknown>;
+    sendMessage(method: string, params?: object, requestTimeoutMs?: number): Promise<unknown>;
     private _handleResponse;
     private _handleEvent;
     addEventListener(eventType: string, handler: EventHandler): () => void;
@@ -255,7 +230,7 @@ declare class Bridge {
  * ```
  */
 
-declare const SDK_VERSION = "1.0.0";
+declare const SDK_VERSION: string;
 /**
  * Main entry point. Provides `ChatableX.init()` to bootstrap the SDK.
  */
@@ -277,4 +252,4 @@ declare const ChatableX: {
     version: string;
 };
 
-export { type AiResponseEventData, Bridge, type ChatOptions, type ChatResponse, ChatableX, type ChatableXAI, type ChatableXEvents, type ChatableXInitConfig, type ChatableXSDK, type ChatableXSkills, type ChatableXStorage, type ChatableXToolModule, type ChatableXTools, type ChatableXUI, type CloseEventData, type EventCallbackMap, type EventType, type FilePickerOptions, type Message, type NotificationType, SDK_VERSION, type SessionContext, type Skill, type SkillResult, type SkillVariable, type StateUpdate, type StreamingContentEventData, type TabConfig, type ToolCall, type ToolExecuteHandler, type ToolExecutionEventData, type ToolInfo, type ToolParameter, type ToolResult, type Unsubscribe, type UserMessageEventData };
+export { type AiResponseEventData, Bridge, type ChatOptions, type ChatResponse, ChatableX, type ChatableXAI, type ChatableXEvents, type ChatableXInitConfig, type ChatableXPlatform, type ChatableXSDK, type ChatableXStorage, type ChatableXToolModule, type ChatableXTools, type ChatableXUI, type CloseEventData, type EventCallbackMap, type EventType, type FilePickerOptions, type Message, type NotificationType, SDK_VERSION, type SessionContext, type StateUpdate, type StreamingContentEventData, type TabConfig, type ToolCall, type ToolExecuteHandler, type ToolExecutionEventData, type ToolInfo, type ToolParameter, type ToolResult, type Unsubscribe, type UserMessageEventData };

package/dist/index.js

@@ -286,20 +286,82 @@ function createToolsModule(bridge) {
   };
 }
 
-// src/modules/skills.ts
-function createSkillsModule(bridge) {
+// src/modules/platform.ts
+function createPlatformModule(bridge) {
   return {
-    list() {
-      return bridge.sendMessage("skills.list", {});
-    },
-    execute(skillId, variables) {
-      return bridge.sendMessage("skills.execute", { skillId, variables });
+    async openInBrowser(targetUrl) {
+      const url = typeof targetUrl === "string" ? targetUrl.trim() : "";
+      if (!url) {
+        throw new Error("openInBrowser: targetUrl is required");
+      }
+      await bridge.sendMessage("host.openInBrowser", { url });
     }
   };
 }
 
+// package.json
+var package_default = {
+  name: "chatablex-web-sdk",
+  version: "1.0.3",
+  description: "ChatableX Web SDK for AI App WebUI development. Provides bridge communication with the ChatableX Flutter client.",
+  main: "dist/index.js",
+  module: "dist/index.mjs",
+  types: "dist/index.d.ts",
+  exports: {
+    ".": {
+      types: "./dist/index.d.ts",
+      import: "./dist/index.mjs",
+      require: "./dist/index.js"
+    }
+  },
+  files: [
+    "dist",
+    "src",
+    "README.md",
+    "README.zh-CN.md"
+  ],
+  scripts: {
+    build: "tsup src/index.ts --format cjs,esm --dts --clean",
+    dev: "tsup src/index.ts --format cjs,esm --dts --watch",
+    typecheck: "tsc --noEmit",
+    test: "vitest run",
+    "test:watch": "vitest",
+    "test:examples": "npm test --prefix examples/counter-app && npm test --prefix examples/todo-app",
+    "build:examples": "npm run build --prefix examples/counter-app && npm run build --prefix examples/todo-app",
+    "deploy:examples": "bash scripts/deploy-examples.sh",
+    "test:e2e": "node scripts/e2e-verify.mjs",
+    "verify:all": "npm test && npm run test:examples && npm run build:examples && npm run deploy:examples && npm run test:e2e",
+    "sync-version": "node scripts/sync-version.mjs",
+    prepublishOnly: "npm run build"
+  },
+  keywords: [
+    "chatablex",
+    "sdk",
+    "webui",
+    "ai",
+    "flutter",
+    "webview",
+    "bridge"
+  ],
+  author: "ChatableX Team",
+  license: "MIT",
+  repository: {
+    type: "git",
+    url: "https://github.com/chatablex/chatablex-web-sdk.git"
+  },
+  devDependencies: {
+    jsdom: "^26.0.0",
+    tsup: "^8.0.1",
+    typescript: "^5.3.0",
+    vitest: "^3.0.0"
+  },
+  engines: {
+    node: ">=16.0.0"
+  }
+};
+
 // src/index.ts
-var SDK_VERSION = "1.0.0";
+var SDK_VERSION = package_default.version;
 var _instance = null;
 var ChatableX = {
   /**
@@ -335,11 +397,11 @@ var ChatableX = {
     const sdk = {
       ai: createAIModule(bridge),
       tools: createToolsModule(bridge),
-      skills: createSkillsModule(bridge),
       ui: createUIModule(bridge),
       events: createEventsModule(bridge),
       storage: createStorageModule(bridge),
-      tool: toolModule
+      tool: toolModule,
+      platform: createPlatformModule(bridge)
     };
     window.ChatableX = sdk;
     _instance = sdk;

package/dist/index.mjs

@@ -258,20 +258,82 @@ function createToolsModule(bridge) {
   };
 }
 
-// src/modules/skills.ts
-function createSkillsModule(bridge) {
+// src/modules/platform.ts
+function createPlatformModule(bridge) {
   return {
-    list() {
-      return bridge.sendMessage("skills.list", {});
-    },
-    execute(skillId, variables) {
-      return bridge.sendMessage("skills.execute", { skillId, variables });
+    async openInBrowser(targetUrl) {
+      const url = typeof targetUrl === "string" ? targetUrl.trim() : "";
+      if (!url) {
+        throw new Error("openInBrowser: targetUrl is required");
+      }
+      await bridge.sendMessage("host.openInBrowser", { url });
     }
   };
 }
 
+// package.json
+var package_default = {
+  name: "chatablex-web-sdk",
+  version: "1.0.3",
+  description: "ChatableX Web SDK for AI App WebUI development. Provides bridge communication with the ChatableX Flutter client.",
+  main: "dist/index.js",
+  module: "dist/index.mjs",
+  types: "dist/index.d.ts",
+  exports: {
+    ".": {
+      types: "./dist/index.d.ts",
+      import: "./dist/index.mjs",
+      require: "./dist/index.js"
+    }
+  },
+  files: [
+    "dist",
+    "src",
+    "README.md",
+    "README.zh-CN.md"
+  ],
+  scripts: {
+    build: "tsup src/index.ts --format cjs,esm --dts --clean",
+    dev: "tsup src/index.ts --format cjs,esm --dts --watch",
+    typecheck: "tsc --noEmit",
+    test: "vitest run",
+    "test:watch": "vitest",
+    "test:examples": "npm test --prefix examples/counter-app && npm test --prefix examples/todo-app",
+    "build:examples": "npm run build --prefix examples/counter-app && npm run build --prefix examples/todo-app",
+    "deploy:examples": "bash scripts/deploy-examples.sh",
+    "test:e2e": "node scripts/e2e-verify.mjs",
+    "verify:all": "npm test && npm run test:examples && npm run build:examples && npm run deploy:examples && npm run test:e2e",
+    "sync-version": "node scripts/sync-version.mjs",
+    prepublishOnly: "npm run build"
+  },
+  keywords: [
+    "chatablex",
+    "sdk",
+    "webui",
+    "ai",
+    "flutter",
+    "webview",
+    "bridge"
+  ],
+  author: "ChatableX Team",
+  license: "MIT",
+  repository: {
+    type: "git",
+    url: "https://github.com/chatablex/chatablex-web-sdk.git"
+  },
+  devDependencies: {
+    jsdom: "^26.0.0",
+    tsup: "^8.0.1",
+    typescript: "^5.3.0",
+    vitest: "^3.0.0"
+  },
+  engines: {
+    node: ">=16.0.0"
+  }
+};
+
 // src/index.ts
-var SDK_VERSION = "1.0.0";
+var SDK_VERSION = package_default.version;
 var _instance = null;
 var ChatableX = {
   /**
@@ -307,11 +369,11 @@ var ChatableX = {
     const sdk = {
       ai: createAIModule(bridge),
       tools: createToolsModule(bridge),
-      skills: createSkillsModule(bridge),
       ui: createUIModule(bridge),
       events: createEventsModule(bridge),
       storage: createStorageModule(bridge),
-      tool: toolModule
+      tool: toolModule,
+      platform: createPlatformModule(bridge)
     };
     window.ChatableX = sdk;
     _instance = sdk;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chatablex-web-sdk",
-  "version": "1.0.0",
+  "version": "1.0.3",
   "description": "ChatableX Web SDK for AI App WebUI development. Provides bridge communication with the ChatableX Flutter client.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -22,6 +22,14 @@
     "build": "tsup src/index.ts --format cjs,esm --dts --clean",
     "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
     "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:examples": "npm test --prefix examples/counter-app && npm test --prefix examples/todo-app",
+    "build:examples": "npm run build --prefix examples/counter-app && npm run build --prefix examples/todo-app",
+    "deploy:examples": "bash scripts/deploy-examples.sh",
+    "test:e2e": "node scripts/e2e-verify.mjs",
+    "verify:all": "npm test && npm run test:examples && npm run build:examples && npm run deploy:examples && npm run test:e2e",
+    "sync-version": "node scripts/sync-version.mjs",
     "prepublishOnly": "npm run build"
   },
   "keywords": [
@@ -37,12 +45,13 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/ersa-org/co-work.git",
-    "directory": "chatablex-web-sdk"
+    "url": "https://github.com/chatablex/chatablex-web-sdk.git"
   },
   "devDependencies": {
+    "jsdom": "^26.0.0",
     "tsup": "^8.0.1",
-    "typescript": "^5.3.0"
+    "typescript": "^5.3.0",
+    "vitest": "^3.0.0"
   },
   "engines": {
     "node": ">=16.0.0"

package/src/bridge.ts

@@ -70,7 +70,7 @@ export class Bridge {
   // -------------------------------------------------------------------------
 
   /** Send a request to Flutter and wait for a response. */
-  sendMessage(method: string, params: Record<string, unknown> = {}, requestTimeoutMs = 30_000): Promise<unknown> {
+  sendMessage(method: string, params: object = {}, requestTimeoutMs = 30_000): Promise<unknown> {
     return new Promise((resolve, reject) => {
       const id = this._nextId();
       const message = { id, method, params, timestamp: Date.now() };

package/src/index.ts

@@ -25,10 +25,11 @@ import { createAIModule } from './modules/ai';
 import { createUIModule } from './modules/ui';
 import { createStorageModule } from './modules/storage';
 import { createToolsModule } from './modules/tools';
-import { createSkillsModule } from './modules/skills';
+import { createPlatformModule } from './modules/platform';
 import type { ChatableXSDK, ChatableXInitConfig, ToolInfo } from './types';
+import pkg from '../package.json';
 
-export const SDK_VERSION = '1.0.0';
+export const SDK_VERSION = pkg.version;
 
 let _instance: ChatableXSDK | null = null;
 
@@ -80,11 +81,11 @@ export const ChatableX = {
     const sdk: ChatableXSDK = {
       ai: createAIModule(bridge),
       tools: createToolsModule(bridge),
-      skills: createSkillsModule(bridge),
       ui: createUIModule(bridge),
       events: createEventsModule(bridge),
       storage: createStorageModule(bridge),
       tool: toolModule,
+      platform: createPlatformModule(bridge),
     };
 
     // Expose on window for debugging / Flutter interop

package/src/modules/platform.ts

@@ -0,0 +1,14 @@
+import type { Bridge } from '../bridge';
+import type { ChatableXPlatform } from '../types';
+
+export function createPlatformModule(bridge: Bridge): ChatableXPlatform {
+  return {
+    async openInBrowser(targetUrl: string): Promise<void> {
+      const url = typeof targetUrl === 'string' ? targetUrl.trim() : '';
+      if (!url) {
+        throw new Error('openInBrowser: targetUrl is required');
+      }
+      await bridge.sendMessage('host.openInBrowser', { url });
+    },
+  };
+}

package/src/modules/ui.ts

@@ -16,11 +16,11 @@ export function createUIModule(bridge: Bridge): ChatableXUI {
     },
 
     openTab(config: TabConfig): Promise<void> {
-      return bridge.sendMessage('ui.openTab', config as unknown as Record<string, unknown>) as Promise<void>;
+      return bridge.sendMessage('ui.openTab', config) as Promise<void>;
     },
 
     updateState(state: StateUpdate): Promise<void> {
-      return bridge.sendMessage('ui.updateState', state as Record<string, unknown>) as Promise<void>;
+      return bridge.sendMessage('ui.updateState', state) as Promise<void>;
     },
   };
 }

package/src/types.ts

@@ -80,38 +80,6 @@ export interface ToolResult {
 
 export type ToolExecuteHandler = (params: Record<string, unknown>) => Promise<Record<string, unknown>>;
 
-// ---------------------------------------------------------------------------
-// Skill
-// ---------------------------------------------------------------------------
-
-export interface Skill {
-  id: string;
-  name: string;
-  description: string;
-  version: string;
-  author?: string;
-  category?: string;
-  toolIds: string[];
-  variables: SkillVariable[];
-  installed: boolean;
-}
-
-export interface SkillVariable {
-  name: string;
-  type: string;
-  description: string;
-  required: boolean;
-  default?: unknown;
-}
-
-export interface SkillResult {
-  success: boolean;
-  data?: unknown;
-  error?: string;
-  skillId: string;
-  toolResults?: ToolResult[];
-}
-
 // ---------------------------------------------------------------------------
 // UI
 // ---------------------------------------------------------------------------
@@ -211,11 +179,6 @@ export interface ChatableXTools {
   executeWithConfirm(toolId: string, params: Record<string, unknown>): Promise<ToolResult>;
 }
 
-export interface ChatableXSkills {
-  list(): Promise<Skill[]>;
-  execute(skillId: string, variables: Record<string, unknown>): Promise<SkillResult>;
-}
-
 export interface ChatableXUI {
   showNotification(message: string, type?: NotificationType): Promise<void>;
   showConfirm(title: string, message: string): Promise<boolean>;
@@ -242,14 +205,19 @@ export interface ChatableXToolModule {
   onExecute(handler: ToolExecuteHandler): void;
 }
 
+export interface ChatableXPlatform {
+  /** Open URL in system browser with auth handoff (WebView only; implemented by Flutter host). */
+  openInBrowser(targetUrl: string): Promise<void>;
+}
+
 export interface ChatableXSDK {
   ai: ChatableXAI;
   tools: ChatableXTools;
-  skills: ChatableXSkills;
   ui: ChatableXUI;
   events: ChatableXEvents;
   storage: ChatableXStorage;
   tool: ChatableXToolModule;
+  platform: ChatableXPlatform;
 }
 
 // ---------------------------------------------------------------------------

package/src/modules/skills.ts

@@ -1,14 +0,0 @@
-import type { Bridge } from '../bridge';
-import type { Skill, SkillResult, ChatableXSkills } from '../types';
-
-export function createSkillsModule(bridge: Bridge): ChatableXSkills {
-  return {
-    list(): Promise<Skill[]> {
-      return bridge.sendMessage('skills.list', {}) as Promise<Skill[]>;
-    },
-
-    execute(skillId: string, variables: Record<string, unknown>): Promise<SkillResult> {
-      return bridge.sendMessage('skills.execute', { skillId, variables }) as Promise<SkillResult>;
-    },
-  };
-}