@elevo-ai/elevo-messenger-sdk 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+export interface ElevoMessengerSDK {
+    /** Send a message to the main window. */
+    sendMessage(channel: string, data: unknown): Promise<unknown>;
+    /**
+     * Subscribe to messages pushed from the main window.
+     * Returns an unsubscribe function.
+     */
+    onMessage(channel: string, fn: (data: unknown) => void): () => void;
+    getLabel(): string;
+    close(): Promise<unknown>;
+    readonly modelContext: ModelContext;
+}
+export interface ModelContext {
+    registerTool(tool: ModelContextTool): void;
+    unregisterTool(toolName: string): void;
+}
+export interface ModelContextTool {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    execute: ToolExecuteCallback;
+}
+export type ToolExecuteCallback = (input: Record<string, unknown>) => Promise<unknown>;
+export declare const elevoMessengerSDK: ElevoMessengerSDK;

package/dist/index.js

@@ -0,0 +1,2 @@
+export var elevoMessengerSDK = window
+    .elevoMessengerSDK;

package/dist/sdk.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/sdk.js

@@ -0,0 +1,153 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+(function () {
+    var global = window;
+    var tauriInternals = global.__TAURI_INTERNALS__;
+    if (global.elevoMessengerSDK ||
+        !tauriInternals)
+        return;
+    // __WEBVIEW_LABEL__ is replaced at runtime by Rust before injection.
+    var LABEL = __WEBVIEW_LABEL__;
+    var handlers = {};
+    // Called by Rust (via webview.eval) to push a message into this webview.
+    global.__ElevoMessengerSDK_receive__ = function (channel, data) {
+        var fns = handlers[channel] || [];
+        fns.forEach(function (fn) {
+            try {
+                fn(data);
+            }
+            catch (e) {
+                console.error("[ElevoMessengerSDK] handler error", e);
+            }
+        });
+    };
+    // Use postMessage transport directly to bypass ipc:// custom protocol,
+    // which is blocked by external-page CSP. Uses transformCallback so Tauri
+    // can route the response back to the correct promise.
+    var tauriInvoke = function (cmd, args) {
+        return new Promise(function (resolve, reject) {
+            var callback = tauriInternals.transformCallback(resolve, true);
+            var error = tauriInternals.transformCallback(reject, true);
+            tauriInternals.postMessage({ cmd: cmd, callback: callback, error: error, payload: args });
+        });
+    };
+    /** Send a message to the main window. */
+    var sendMessage = function (channel, data) {
+        return tauriInvoke("relay_sdk_message", {
+            sourceLabel: LABEL,
+            channel: channel,
+            data: data,
+        });
+    };
+    /**
+     * Subscribe to messages pushed from the main window.
+     * Returns an unsubscribe function.
+     */
+    var onMessage = function (channel, fn) {
+        if (!handlers[channel])
+            handlers[channel] = [];
+        handlers[channel].push(fn);
+        return function () {
+            handlers[channel] = (handlers[channel] || []).filter(function (h) {
+                return h !== fn;
+            });
+        };
+    };
+    var getLabel = function () {
+        return LABEL;
+    };
+    var close = function () {
+        return tauriInvoke("close_webview", { label: LABEL });
+    };
+    var modelContextTools = new Map();
+    var modelContext = Object.freeze({
+        registerTool: function (tool) {
+            var name = tool.name, description = tool.description, inputSchema = tool.inputSchema;
+            modelContextTools.set(name, tool);
+            sendMessage("client_tool_register", { name: name, description: description, inputSchema: inputSchema });
+        },
+        unregisterTool: function (toolName) {
+            modelContextTools.delete(toolName);
+            sendMessage("client_tool_unregister", toolName);
+        },
+    });
+    onMessage("client_tool_execute", function (data) {
+        return __awaiter(this, void 0, void 0, function () {
+            var _a, toolName, input, toolCallId, tool, output, e_1;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        _a = data, toolName = _a.toolName, input = _a.input, toolCallId = _a.toolCallId;
+                        tool = modelContextTools.get(toolName);
+                        if (!tool) {
+                            return [2 /*return*/];
+                        }
+                        _b.label = 1;
+                    case 1:
+                        _b.trys.push([1, 3, , 4]);
+                        return [4 /*yield*/, tool.execute(input)];
+                    case 2:
+                        output = _b.sent();
+                        sendMessage("client_tool_output", {
+                            toolCallId: toolCallId,
+                            output: output,
+                            success: true,
+                        });
+                        return [3 /*break*/, 4];
+                    case 3:
+                        e_1 = _b.sent();
+                        sendMessage("client_tool_output", {
+                            toolCallId: toolCallId,
+                            output: e_1 instanceof Error ? e_1.message : String(e_1),
+                            success: false,
+                        });
+                        return [3 /*break*/, 4];
+                    case 4: return [2 /*return*/];
+                }
+            });
+        });
+    });
+    global.elevoMessengerSDK = Object.freeze({
+        sendMessage: sendMessage,
+        onMessage: onMessage,
+        getLabel: getLabel,
+        close: close,
+        modelContext: modelContext,
+    });
+    console.log("[ElevoMessengerSDK] initialized, label:", LABEL);
+})();
+export {};

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@elevo-ai/elevo-messenger-sdk",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  }
+}

package/src/index.ts

@@ -0,0 +1,36 @@
+export interface ElevoMessengerSDK {
+  /** Send a message to the main window. */
+  sendMessage(channel: string, data: unknown): Promise<unknown>;
+  /**
+   * Subscribe to messages pushed from the main window.
+   * Returns an unsubscribe function.
+   */
+  onMessage(channel: string, fn: (data: unknown) => void): () => void;
+  getLabel(): string;
+  close(): Promise<unknown>;
+
+  readonly modelContext: ModelContext;
+}
+
+export interface ModelContext {
+  registerTool(tool: ModelContextTool): void;
+  unregisterTool(toolName: string): void;
+}
+
+export interface ModelContextTool {
+  name: string;
+  description: string;
+  inputSchema: Record<string, unknown>;
+  execute: ToolExecuteCallback;
+}
+
+export type ToolExecuteCallback = (
+  input: Record<string, unknown>,
+) => Promise<unknown>;
+
+interface WindowWithElevoMessengerSDK extends Window {
+  elevoMessengerSDK?: ElevoMessengerSDK;
+}
+
+export const elevoMessengerSDK = (window as WindowWithElevoMessengerSDK)
+  .elevoMessengerSDK!;

package/src/sdk.ts

@@ -0,0 +1,147 @@
+import type {
+  ElevoMessengerSDK,
+  ModelContext,
+  ModelContextTool,
+} from "./index";
+
+interface WindowWithElevoMessengerSDK extends Window {
+  elevoMessengerSDK?: ElevoMessengerSDK;
+  /** @internal Called by Rust to push messages into this webview. */
+  __ElevoMessengerSDK_receive__?: (channel: string, data: unknown) => void;
+  readonly __TAURI_INTERNALS__?: TauriInternals;
+}
+
+interface TauriInternals {
+  transformCallback(fn: (value: unknown) => void, once?: boolean): number;
+  postMessage(msg: unknown): void;
+}
+
+/** @internal Replaced at runtime by Rust before injection. */
+declare const __WEBVIEW_LABEL__: string;
+
+(function () {
+  const global = window as WindowWithElevoMessengerSDK;
+  const tauriInternals = global.__TAURI_INTERNALS__;
+
+  if (
+    (global as WindowWithElevoMessengerSDK).elevoMessengerSDK ||
+    !tauriInternals
+  )
+    return;
+
+  // __WEBVIEW_LABEL__ is replaced at runtime by Rust before injection.
+  const LABEL: string = __WEBVIEW_LABEL__;
+
+  type Handler = (data: unknown) => void;
+  const handlers: Record<string, Handler[]> = {};
+
+  // Called by Rust (via webview.eval) to push a message into this webview.
+  global.__ElevoMessengerSDK_receive__ = function (
+    channel: string,
+    data: unknown,
+  ) {
+    const fns = handlers[channel] || [];
+    fns.forEach(function (fn) {
+      try {
+        fn(data);
+      } catch (e) {
+        console.error("[ElevoMessengerSDK] handler error", e);
+      }
+    });
+  };
+
+  // Use postMessage transport directly to bypass ipc:// custom protocol,
+  // which is blocked by external-page CSP. Uses transformCallback so Tauri
+  // can route the response back to the correct promise.
+  const tauriInvoke = (
+    cmd: string,
+    args: Record<string, unknown>,
+  ): Promise<unknown> => {
+    return new Promise(function (resolve, reject) {
+      const callback = tauriInternals.transformCallback(resolve, true);
+      const error = tauriInternals.transformCallback(reject, true);
+      tauriInternals.postMessage({ cmd, callback, error, payload: args });
+    });
+  };
+
+  /** Send a message to the main window. */
+  const sendMessage = (channel: string, data: unknown) => {
+    return tauriInvoke("relay_sdk_message", {
+      sourceLabel: LABEL,
+      channel,
+      data,
+    });
+  };
+
+  /**
+   * Subscribe to messages pushed from the main window.
+   * Returns an unsubscribe function.
+   */
+  const onMessage = (channel: string, fn: Handler) => {
+    if (!handlers[channel]) handlers[channel] = [];
+    handlers[channel].push(fn);
+    return function () {
+      handlers[channel] = (handlers[channel] || []).filter(function (h) {
+        return h !== fn;
+      });
+    };
+  };
+
+  const getLabel = () => {
+    return LABEL;
+  };
+
+  const close = () => {
+    return tauriInvoke("close_webview", { label: LABEL });
+  };
+
+  const modelContextTools = new Map<string, ModelContextTool>();
+
+  const modelContext: ModelContext = Object.freeze({
+    registerTool(tool: ModelContextTool) {
+      const { name, description, inputSchema } = tool;
+      modelContextTools.set(name, tool);
+      sendMessage("client_tool_register", { name, description, inputSchema });
+    },
+    unregisterTool(toolName: string) {
+      modelContextTools.delete(toolName);
+      sendMessage("client_tool_unregister", toolName);
+    },
+  });
+
+  onMessage("client_tool_execute", async function (data) {
+    const { toolName, input, toolCallId } = data as {
+      toolName: string;
+      input: Record<string, unknown>;
+      toolCallId: string;
+    };
+    const tool = modelContextTools.get(toolName);
+    if (!tool) {
+      return;
+    }
+    try {
+      const output = await tool.execute(input);
+      sendMessage("client_tool_output", {
+        toolCallId,
+        output,
+        success: true,
+      });
+    } catch (e) {
+      sendMessage("client_tool_output", {
+        toolCallId,
+        output: e instanceof Error ? e.message : String(e),
+        success: false,
+      });
+    }
+  });
+
+  global.elevoMessengerSDK = Object.freeze({
+    sendMessage,
+    onMessage,
+    getLabel,
+    close,
+    modelContext,
+  });
+
+  console.log("[ElevoMessengerSDK] initialized, label:", LABEL);
+})();

package/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES5",
+    "lib": ["ES2015", "DOM"],
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "noEmitOnError": true,
+    "outDir": "dist",
+    "declaration": true,
+    "removeComments": false
+  },
+  "include": ["src"]
+}