dewee-webchat 0.1.1 → 0.2.0

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-WD6V3TAX.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" | "ready" | "send" | "reply" | "error" | "close")[], "open" | "ready" | "send" | "reply" | "error" | "close", 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,6 +235,26 @@ 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;
@@ -222,6 +262,7 @@ declare const DeweeChat: vue.DefineComponent<vue.ExtractPropTypes<{
     onReply?: ((...args: any[]) => any) | undefined;
     onError?: ((...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-D4JM2FOB.js";
-import "./chunk-WD6V3TAX.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,6 +1,6 @@
 {
   "name": "dewee-webchat",
-  "version": "0.1.1",
+  "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",

package/dist/chunk-WD6V3TAX.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.1";
-
-export {
-  HEADER_GATEWAY_URL,
-  HEADER_GATEWAY_TOKEN,
-  VERSION
-};