dewee-webchat 0.1.1 → 0.3.0

package/dist/{protocol-CS8_4zC0.d.ts → protocol-B72Ry-fY.d.ts}

@@ -4,6 +4,7 @@ type ChatStreamEvent = {
     runId?: string;
     conversationId: string;
     agent: string;
+    actionsHash?: string;
 } | {
     type: "thinking";
     text: string;
@@ -67,5 +68,25 @@ interface HistoryMessage {
     toolCalls?: ToolCallView[];
     createdAt?: string;
 }
+/** How much an agent-invoked page action can change. `mutate`/`destructive` always need user approval. */
+type ActionSensitivity = "read" | "navigate" | "mutate" | "destructive";
+/** What the backend (and the agent) learns about a page action. Handlers never leave the browser. */
+interface ActionManifestEntry {
+    name: string;
+    description: string;
+    /** JSON Schema subset describing `args` (object). */
+    parameters: Record<string, unknown>;
+    sensitivity: ActionSensitivity;
+}
+/** Body of `POST {basePath}/chat`. `actions`/`actionsHash`/`pageContext` are optional (page actions). */
+interface ChatRequestBody {
+    message: string;
+    agent?: string;
+    conversationId?: string;
+    actions?: ActionManifestEntry[];
+    /** Hash from the `start` event of the last completed turn; the manifest is re-sent to the agent only when it differs. */
+    actionsHash?: string;
+    pageContext?: unknown;
+}
 
-export type { AgentInfo as A, ChatStreamEvent as C, HistoryMessage as H, PublicConfig as P, SessionResponse as S, ToolCallView as T };
+export type { AgentInfo as A, ChatStreamEvent as C, HistoryMessage as H, PublicConfig as P, SessionResponse as S, ToolCallView as T, ActionManifestEntry as a, ActionSensitivity as b, ChatRequestBody as c };

package/dist/react.d.ts

@@ -1,7 +1,8 @@
 import * as react from 'react';
 import { CSSProperties } from 'react';
-import { DeweeChatConfig, DeweeChatElement } from './index.js';
-import './protocol-CS8_4zC0.js';
+import { DeweeChatConfig, ActionEventDetail, DeweeChatElement } from './index.js';
+export { ActionConfirmHook, PageAction, PageActionContext, RequestHeadersOption } from './index.js';
+import './protocol-B72Ry-fY.js';
 
 interface DeweeChatProps extends Partial<DeweeChatConfig> {
     className?: string;
@@ -12,6 +13,8 @@ interface DeweeChatProps extends Partial<DeweeChatConfig> {
     onError?: (e: CustomEvent) => void;
     onOpen?: (e: CustomEvent) => void;
     onClose?: (e: CustomEvent) => void;
+    /** Page action telemetry (`dewee:action`, detail: ActionEventDetail). */
+    onAction?: (e: CustomEvent<ActionEventDetail>) => void;
 }
 declare const DeweeChat: react.ForwardRefExoticComponent<DeweeChatProps & react.RefAttributes<DeweeChatElement | null>>;
 
@@ -23,4 +26,4 @@ declare module "react" {
     }
 }
 
-export { DeweeChat, DeweeChatConfig, DeweeChatElement, type DeweeChatProps, DeweeChat as default };
+export { ActionEventDetail, DeweeChat, DeweeChatConfig, DeweeChatElement, type DeweeChatProps, DeweeChat as default };

package/dist/react.js

@@ -1,7 +1,7 @@
 import {
   defineDeweeChat
-} from "./chunk-D4JM2FOB.js";
-import "./chunk-WD6V3TAX.js";
+} from "./chunk-ZTVGWFXL.js";
+import "./chunk-W6A4HVFB.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, headers, fetch, ...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, headers, fetch });
+  });
   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-WD6V3TAX.js";
+  VERSION,
+  buildPageBlock,
+  hashManifest,
+  normalizeManifest,
+  serializePageContext,
+  stripPageBlock
+} from "./chunk-W6A4HVFB.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, RequestHeadersOption } from './index.js';
+import './protocol-B72Ry-fY.js';
 
 declare const DeweeChat: vue.DefineComponent<vue.ExtractPropTypes<{
     endpoint: {
@@ -108,9 +108,37 @@ 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;
+    };
+    headers: {
+        type: PropType<any>;
+        default: undefined;
+    };
+    fetch: {
+        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 +243,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;
+    };
+    headers: {
+        type: PropType<any>;
+        default: undefined;
+    };
+    fetch: {
+        type: PropType<any>;
+        default: undefined;
+    };
 }>> & Readonly<{
     onOpen?: ((...args: any[]) => any) | undefined;
     onReady?: ((...args: any[]) => any) | undefined;
@@ -222,6 +278,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 +306,13 @@ declare const DeweeChat: vue.DefineComponent<vue.ExtractPropTypes<{
     width: any;
     height: any;
     zIndex: any;
+    actions: any;
+    confirm: any;
+    getPageContext: any;
+    maxActionRounds: any;
+    actionTimeoutMs: any;
+    headers: any;
+    fetch: 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-ZTVGWFXL.js";
+import "./chunk-W6A4HVFB.js";
 
 // src/vue.ts
 import { defineComponent, h, onMounted, ref, watch } from "vue";
@@ -31,10 +31,17 @@ var keys = [
   "gatewayToken",
   "width",
   "height",
-  "zIndex"
+  "zIndex",
+  "actions",
+  "confirm",
+  "getPageContext",
+  "maxActionRounds",
+  "actionTimeoutMs",
+  "headers",
+  "fetch"
 ];
 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 +61,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.3.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
-};