dewee-webchat 0.1.0 → 0.2.0

package/dist/react.js

@@ -1,7 +1,7 @@
 import {
   defineDeweeChat
-} from "./chunk-RGAYYTL7.js";
-import "./chunk-MKTHKYLY.js";
+} from "./chunk-YV6PXYJZ.js";
+import "./chunk-JX6AH37X.js";
 
 // src/react.ts
 import { createElement, forwardRef, useEffect, useImperativeHandle, useRef } from "react";
@@ -11,12 +11,13 @@ var EVENTS = {
   onReply: "dewee:reply",
   onError: "dewee:error",
   onOpen: "dewee:open",
-  onClose: "dewee:close"
+  onClose: "dewee:close",
+  onAction: "dewee:action"
 };
 var DeweeChat = forwardRef(function DeweeChat2(props, ref) {
   const el = useRef(null);
-  const { className, style, onReady, onSend, onReply, onError, onOpen, onClose, ...config } = props;
-  const handlers = { onReady, onSend, onReply, onError, onOpen, onClose };
+  const { className, style, onReady, onSend, onReply, onError, onOpen, onClose, onAction, actions, confirm, getPageContext, ...config } = props;
+  const handlers = { onReady, onSend, onReply, onError, onOpen, onClose, onAction };
   const handlersRef = useRef(handlers);
   handlersRef.current = handlers;
   useImperativeHandle(ref, () => el.current, []);
@@ -25,6 +26,10 @@ var DeweeChat = forwardRef(function DeweeChat2(props, ref) {
     defineDeweeChat();
     el.current?.configure(JSON.parse(configKey));
   }, [configKey]);
+  useEffect(() => {
+    defineDeweeChat();
+    el.current?.configure({ actions, confirm, getPageContext });
+  });
   useEffect(() => {
     const node = el.current;
     if (!node) return;

package/dist/server.d.ts

@@ -1,5 +1,5 @@
-import { A as AgentInfo, H as HistoryMessage, C as ChatStreamEvent } from './protocol-CS8_4zC0.js';
-export { P as PublicConfig, S as SessionResponse } from './protocol-CS8_4zC0.js';
+import { A as AgentInfo, H as HistoryMessage, C as ChatStreamEvent, a as ActionManifestEntry } from './protocol-B72Ry-fY.js';
+export { b as ActionSensitivity, c as ChatRequestBody, P as PublicConfig, S as SessionResponse } from './protocol-B72Ry-fY.js';
 import { IncomingMessage, ServerResponse } from 'node:http';
 
 interface VisitorClaims {
@@ -122,4 +122,28 @@ declare function foldHistory(raw: any[]): HistoryMessage[];
 /** Lists agents via the gateway REST API. */
 declare function listAgents(creds: GatewayCredentials): Promise<AgentInfo[]>;
 
-export { AgentInfo, ChatStreamEvent, type DeweeHandlerOptions, GatewayConnection, type GatewayCredentials, GatewayError, HistoryMessage, type RateLimiter, type StreamChatOptions, buildSessionKey, createDeweeHandler, fetchHistory, foldHistory, listAgents, memoryRateLimiter, optionsFromEnv, signVisitorToken, streamChat, toNodeHandler, verifyVisitorToken };
+declare const ACTION_LIMITS: {
+    readonly maxActions: 32;
+    readonly maxDescription: 1000;
+    readonly maxParametersBytes: 4096;
+    readonly maxManifestBytes: 16384;
+    readonly maxPageContextBytes: 4096;
+};
+/** Validates and normalizes `body.actions` (fixed key order, so the hash is stable). Throws ActionInputError. */
+declare function normalizeManifest(input: unknown): ActionManifestEntry[];
+/** Short, opaque manifest fingerprint: first 16 hex chars of SHA-256 over the normalized JSON. */
+declare function hashManifest(manifest: ActionManifestEntry[]): Promise<string>;
+interface PageBlockInput {
+    manifest?: ActionManifestEntry[];
+    hash?: string;
+    /** False when the agent already received this exact manifest in the conversation. */
+    includeManifest?: boolean;
+    /** Pre-serialized page context JSON. */
+    pageContext?: string;
+}
+/** Builds the block prepended to the visitor message, or "" when there is nothing to add. */
+declare function buildPageBlock(p: PageBlockInput): string;
+/** Removes a leading page block from a stored user message (history display). */
+declare function stripPageBlock(content: string): string;
+
+export { ACTION_LIMITS, ActionManifestEntry, AgentInfo, ChatStreamEvent, type DeweeHandlerOptions, GatewayConnection, type GatewayCredentials, GatewayError, HistoryMessage, type RateLimiter, type StreamChatOptions, buildPageBlock, buildSessionKey, createDeweeHandler, fetchHistory, foldHistory, hashManifest, listAgents, memoryRateLimiter, normalizeManifest, optionsFromEnv, signVisitorToken, streamChat, stripPageBlock, toNodeHandler, verifyVisitorToken };

package/dist/server.js

@@ -1,8 +1,15 @@
 import {
+  ACTION_LIMITS,
+  ActionInputError,
   HEADER_GATEWAY_TOKEN,
   HEADER_GATEWAY_URL,
-  VERSION
-} from "./chunk-MKTHKYLY.js";
+  VERSION,
+  buildPageBlock,
+  hashManifest,
+  normalizeManifest,
+  serializePageContext,
+  stripPageBlock
+} from "./chunk-JX6AH37X.js";
 
 // src/server/gateway-client.ts
 var GatewayError = class extends Error {
@@ -220,7 +227,7 @@ function foldHistory(raw) {
   for (const m of raw) {
     if (m.role === "user") {
       current = null;
-      out.push({ role: "user", content: String(m.content ?? ""), createdAt: m.created_at });
+      out.push({ role: "user", content: stripPageBlock(String(m.content ?? "")), createdAt: m.created_at });
     } else if (m.role === "assistant") {
       if (!current) {
         current = { role: "assistant", content: "", createdAt: m.created_at };
@@ -468,6 +475,17 @@ function createDeweeHandler(options) {
     const conversationId = typeof body?.conversationId === "string" && ID_RE.test(body.conversationId) ? body.conversationId : randomId(9);
     const agent = await pickAgent(body?.agent, creds, isByo);
     if (!agent) return fail(req, 403, "Agent not allowed", "agent_not_allowed");
+    let pageBlock = "";
+    let actionsHash;
+    try {
+      const manifest = body?.actions != null ? normalizeManifest(body.actions) : void 0;
+      const pageContext = serializePageContext(body?.pageContext);
+      if (manifest?.length) actionsHash = await hashManifest(manifest);
+      pageBlock = buildPageBlock({ manifest, hash: actionsHash, includeManifest: body?.actionsHash !== actionsHash, pageContext });
+    } catch (e) {
+      if (e instanceof ActionInputError) return fail(req, e.status, e.message, e.code);
+      throw e;
+    }
     const sessionKey = buildSessionKey(agent, `webchat-${visitorId}-${conversationId}`);
     const abort = new AbortController();
     req.signal?.addEventListener("abort", () => abort.abort(), { once: true });
@@ -482,8 +500,8 @@ function createDeweeHandler(options) {
       let reply = "";
       let errMsg;
       try {
-        await send({ type: "start", conversationId, agent });
-        for await (const ev of streamChat({ creds, userId: o.userIdPrefix + visitorId, agent, sessionKey, message, signal: abort.signal, timeoutMs: o.timeoutMs })) {
+        await send(actionsHash ? { type: "start", conversationId, agent, actionsHash } : { type: "start", conversationId, agent });
+        for await (const ev of streamChat({ creds, userId: o.userIdPrefix + visitorId, agent, sessionKey, message: pageBlock + message, signal: abort.signal, timeoutMs: o.timeoutMs })) {
           if (ev.type === "start") continue;
           if (ev.type === "done") reply = ev.content;
           if (ev.type === "error") errMsg = ev.message;
@@ -616,17 +634,22 @@ function toNodeHandler(handler) {
   };
 }
 export {
+  ACTION_LIMITS,
   GatewayConnection,
   GatewayError,
+  buildPageBlock,
   buildSessionKey,
   createDeweeHandler,
   fetchHistory,
   foldHistory,
+  hashManifest,
   listAgents,
   memoryRateLimiter,
+  normalizeManifest,
   optionsFromEnv,
   signVisitorToken,
   streamChat,
+  stripPageBlock,
   toNodeHandler,
   verifyVisitorToken
 };

package/dist/vue.d.ts

@@ -1,7 +1,7 @@
 import * as vue from 'vue';
 import { PropType } from 'vue';
-export { DeweeChatConfig, DeweeChatElement } from './index.js';
-import './protocol-CS8_4zC0.js';
+export { ActionConfirmHook, ActionEventDetail, DeweeChatConfig, DeweeChatElement, PageAction, PageActionContext } from './index.js';
+import './protocol-B72Ry-fY.js';
 
 declare const DeweeChat: vue.DefineComponent<vue.ExtractPropTypes<{
     endpoint: {
@@ -108,9 +108,29 @@ declare const DeweeChat: vue.DefineComponent<vue.ExtractPropTypes<{
         type: PropType<any>;
         default: undefined;
     };
+    actions: {
+        type: PropType<any>;
+        default: undefined;
+    };
+    confirm: {
+        type: PropType<any>;
+        default: undefined;
+    };
+    getPageContext: {
+        type: PropType<any>;
+        default: undefined;
+    };
+    maxActionRounds: {
+        type: PropType<any>;
+        default: undefined;
+    };
+    actionTimeoutMs: {
+        type: PropType<any>;
+        default: undefined;
+    };
 }>, () => vue.VNode<vue.RendererNode, vue.RendererElement, {
     [key: string]: any;
-}>, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, ("open" | "close" | "error" | "send" | "ready" | "reply")[], "open" | "close" | "error" | "send" | "ready" | "reply", vue.PublicProps, Readonly<vue.ExtractPropTypes<{
+}>, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, ("open" | "ready" | "send" | "reply" | "error" | "close" | "action")[], "open" | "ready" | "send" | "reply" | "error" | "close" | "action", vue.PublicProps, Readonly<vue.ExtractPropTypes<{
     endpoint: {
         type: PropType<any>;
         default: undefined;
@@ -215,13 +235,34 @@ declare const DeweeChat: vue.DefineComponent<vue.ExtractPropTypes<{
         type: PropType<any>;
         default: undefined;
     };
+    actions: {
+        type: PropType<any>;
+        default: undefined;
+    };
+    confirm: {
+        type: PropType<any>;
+        default: undefined;
+    };
+    getPageContext: {
+        type: PropType<any>;
+        default: undefined;
+    };
+    maxActionRounds: {
+        type: PropType<any>;
+        default: undefined;
+    };
+    actionTimeoutMs: {
+        type: PropType<any>;
+        default: undefined;
+    };
 }>> & Readonly<{
+    onOpen?: ((...args: any[]) => any) | undefined;
     onReady?: ((...args: any[]) => any) | undefined;
     onSend?: ((...args: any[]) => any) | undefined;
     onReply?: ((...args: any[]) => any) | undefined;
     onError?: ((...args: any[]) => any) | undefined;
-    onOpen?: ((...args: any[]) => any) | undefined;
     onClose?: ((...args: any[]) => any) | undefined;
+    onAction?: ((...args: any[]) => any) | undefined;
 }>, {
     endpoint: any;
     agent: any;
@@ -249,6 +290,11 @@ declare const DeweeChat: vue.DefineComponent<vue.ExtractPropTypes<{
     width: any;
     height: any;
     zIndex: any;
+    actions: any;
+    confirm: any;
+    getPageContext: any;
+    maxActionRounds: any;
+    actionTimeoutMs: any;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
 
 export { DeweeChat, DeweeChat as default };

package/dist/vue.js

@@ -1,7 +1,7 @@
 import {
   defineDeweeChat
-} from "./chunk-RGAYYTL7.js";
-import "./chunk-MKTHKYLY.js";
+} from "./chunk-YV6PXYJZ.js";
+import "./chunk-JX6AH37X.js";
 
 // src/vue.ts
 import { defineComponent, h, onMounted, ref, watch } from "vue";
@@ -31,10 +31,15 @@ var keys = [
   "gatewayToken",
   "width",
   "height",
-  "zIndex"
+  "zIndex",
+  "actions",
+  "confirm",
+  "getPageContext",
+  "maxActionRounds",
+  "actionTimeoutMs"
 ];
 var props = Object.fromEntries(keys.map((k) => [k, { type: null, default: void 0 }]));
-var EVENTS = ["ready", "send", "reply", "error", "open", "close"];
+var EVENTS = ["ready", "send", "reply", "error", "open", "close", "action"];
 var DeweeChat = defineComponent({
   name: "DeweeChat",
   props,
@@ -54,7 +59,9 @@ var DeweeChat = defineComponent({
       open: () => el.value?.open(),
       close: () => el.value?.close(),
       send: (text) => el.value?.send(text),
-      newConversation: () => el.value?.newConversation()
+      newConversation: () => el.value?.newConversation(),
+      registerActions: (actions) => el.value?.registerActions(actions),
+      unregisterAction: (name) => el.value?.unregisterAction(name)
     });
     return () => h("dewee-chat", { ref: el, endpoint: p.endpoint, mode: p.mode });
   }

package/package.json

@@ -1,99 +1,99 @@
-{
-  "name": "dewee-webchat",
-  "version": "0.1.0",
-  "description": "Embeddable chat widget for Dewee AI agents — web component, React/Vue/Astro wrappers and a secure backend handler (Workers, Next.js, Node, Bun, Deno).",
-  "license": "MIT",
-  "type": "module",
-  "author": "NextLevelBuilder <hi@nextlevelbuilder.io>",
-  "homepage": "https://webchat.dewee.sh",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/nextlevelbuilder/dewee-webchat.git",
-    "directory": "packages/dewee-webchat"
-  },
-  "bugs": "https://github.com/nextlevelbuilder/dewee-webchat/issues",
-  "keywords": [
-    "dewee",
-    "goclaw",
-    "ai",
-    "agent",
-    "chatbot",
-    "chat-widget",
-    "web-component",
-    "react",
-    "vue",
-    "astro",
-    "nextjs",
-    "cloudflare-workers"
-  ],
-  "sideEffects": [
-    "./dist/index.js",
-    "./dist/dewee-webchat.js",
-    "./dist/chunk-*.js"
-  ],
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "unpkg": "./dist/dewee-webchat.js",
-  "jsdelivr": "./dist/dewee-webchat.js",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    },
-    "./server": {
-      "types": "./dist/server.d.ts",
-      "import": "./dist/server.js"
-    },
-    "./react": {
-      "types": "./dist/react.d.ts",
-      "import": "./dist/react.js"
-    },
-    "./vue": {
-      "types": "./dist/vue.d.ts",
-      "import": "./dist/vue.js"
-    },
-    "./astro": "./astro/DeweeChat.astro",
-    "./cdn": "./dist/dewee-webchat.js",
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "dist",
-    "astro",
-    "README.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "build": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsup",
-    "dev": "tsup --watch",
-    "test": "vitest run",
-    "typecheck": "tsc --noEmit"
-  },
-  "peerDependencies": {
-    "react": ">=18",
-    "vue": ">=3.3"
-  },
-  "peerDependenciesMeta": {
-    "react": {
-      "optional": true
-    },
-    "vue": {
-      "optional": true
-    }
-  },
-  "devDependencies": {
-    "@types/node": "^22.15.0",
-    "@types/react": "^19.1.0",
-    "@types/ws": "^8.18.2",
-    "happy-dom": "^18.0.1",
-    "react": "^19.1.0",
-    "tsup": "^8.5.0",
-    "typescript": "^5.9.2",
-    "vitest": "^3.2.4",
-    "vue": "^3.5.18",
-    "ws": "^8.22.0"
-  },
-  "engines": {
-    "node": ">=20"
-  }
-}
+{
+  "name": "dewee-webchat",
+  "version": "0.2.0",
+  "description": "Embeddable chat widget for Dewee AI agents — web component, React/Vue/Astro wrappers and a secure backend handler (Workers, Next.js, Node, Bun, Deno).",
+  "license": "MIT",
+  "type": "module",
+  "author": "NextLevelBuilder <hi@nextlevelbuilder.io>",
+  "homepage": "https://webchat.dewee.sh",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nextlevelbuilder/dewee-webchat.git",
+    "directory": "packages/dewee-webchat"
+  },
+  "bugs": "https://github.com/nextlevelbuilder/dewee-webchat/issues",
+  "keywords": [
+    "dewee",
+    "goclaw",
+    "ai",
+    "agent",
+    "chatbot",
+    "chat-widget",
+    "web-component",
+    "react",
+    "vue",
+    "astro",
+    "nextjs",
+    "cloudflare-workers"
+  ],
+  "sideEffects": [
+    "./dist/index.js",
+    "./dist/dewee-webchat.js",
+    "./dist/chunk-*.js"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "unpkg": "./dist/dewee-webchat.js",
+  "jsdelivr": "./dist/dewee-webchat.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js"
+    },
+    "./vue": {
+      "types": "./dist/vue.d.ts",
+      "import": "./dist/vue.js"
+    },
+    "./astro": "./astro/DeweeChat.astro",
+    "./cdn": "./dist/dewee-webchat.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "astro",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "react": ">=18",
+    "vue": ">=3.3"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "vue": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.0",
+    "@types/react": "^19.1.0",
+    "@types/ws": "^8.18.2",
+    "happy-dom": "^18.0.1",
+    "react": "^19.1.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.4",
+    "vue": "^3.5.18",
+    "ws": "^8.22.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}

package/dist/chunk-MKTHKYLY.js

@@ -1,10 +0,0 @@
-// src/protocol.ts
-var HEADER_GATEWAY_URL = "x-dewee-gateway-url";
-var HEADER_GATEWAY_TOKEN = "x-dewee-gateway-token";
-var VERSION = "0.1.0";
-
-export {
-  HEADER_GATEWAY_URL,
-  HEADER_GATEWAY_TOKEN,
-  VERSION
-};