@coffer-org/plugin-webchat 7.2.0 → 7.3.0

package/dist/{ChatWidget-BIPLpTMp.js → ChatWidget-DocoFt8q.js}

@@ -1,5 +1,5 @@
 import * as __fedReact from "react";
-import { Button, Dialog, DialogContent, Icon, MarkdownView, fileSizeLabel, uploadFile, useMinWidth } from "@coffer-org/web-ui";
+import { Button, Dialog, DialogContent, Icon, MarkdownView, fileSizeLabel, recordGone, refreshData, uploadFile, useMinWidth } from "@coffer-org/web-ui";
 import { createContext, createElement, forwardRef, memo, useCallback, useContext, useEffect, useId, useMemo, useRef, useState } from "react";
 import { useLocation } from "react-router-dom";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
@@ -1051,6 +1051,12 @@ async function openChannel(convId, handlers, signal) {
 			parentMsgId: String(data["parentMsgId"] ?? ""),
 			suggestions: Array.isArray(data["suggestions"]) ? data["suggestions"] : null
 		});
+		else if (frame.event === "refresh") handlers.onRefresh({
+			...typeof data["library"] === "string" ? { library: data["library"] } : {},
+			...typeof data["shelf"] === "string" ? { shelf: data["shelf"] } : {},
+			...typeof data["id"] === "string" ? { id: data["id"] } : {},
+			...data["gone"] === true ? { gone: true } : {}
+		});
 		else if (frame.event === "error") handlers.onError({
 			message: data["message"] ?? null,
 			parentMsgId: typeof data["parentMsgId"] === "string" ? data["parentMsgId"] : null
@@ -1245,6 +1251,11 @@ function useChat() {
 					kind: "done",
 					data
 				}),
+				onRefresh: ({ gone, ...scope }) => {
+					if (cancelled) return;
+					if (gone) recordGone(scope);
+					else refreshData(scope);
+				},
 				onError: (data) => dispatch({
 					kind: "error",
 					data

package/dist/runtime/format.js

@@ -1,6 +1,14 @@
 import { frontendInstructions } from '@coffer-org/server/frontend-agent';
 import { NEUTRAL_FORMAT } from '@coffer-org/markdown';
+const LIVE_PAGE = [
+    'You are answering inside the app, in a panel over a page the person is reading.',
+    'That page does not reload itself. After you create, update, delete or restore a record,',
+    'call `refresh_open_page` — naming the record when you know which one — so what they see matches',
+    'what you just told them. If you DELETED the record, pass `deleted: true` with it, so the page',
+    'showing it returns to the list instead of sitting on something that is no longer there.',
+    'Skip the call when you only read.',
+].join(' ');
 export async function webChannelSystem() {
     const site = await frontendInstructions('');
-    return [NEUTRAL_FORMAT, site].filter(Boolean).join('\n\n');
+    return [NEUTRAL_FORMAT, site, LIVE_PAGE].filter(Boolean).join('\n\n');
 }

package/dist/runtime/index.d.ts

@@ -1,6 +1,7 @@
 import type { PluginHooks } from '@coffer-org/server/plugin-hooks';
 export type { ThreadSummary, HistoryMsg } from './actions.ts';
 export { makeStreamingConnector } from './connector.ts';
+export { makeRefreshTool } from './refresh-tool.ts';
 export { getConversation as getSelection, setConversation as setSelection, } from '@coffer-org/server/conversation-store';
 export { sendAction, pageContext } from './send.ts';
 export declare const serverHooks: PluginHooks;

package/dist/runtime/index.js

@@ -6,6 +6,7 @@ import { initFanout, teardownFanout } from "./channel-registry.js";
 const THREAD_TTL_MS = Number(process.env['WEBCHAT_THREAD_TTL_MS'] ?? 30 * 86_400_000);
 let unregisterConnector;
 export { makeStreamingConnector } from "./connector.js";
+export { makeRefreshTool } from "./refresh-tool.js";
 export { getConversation as getSelection, setConversation as setSelection, } from '@coffer-org/server/conversation-store';
 export { sendAction, pageContext } from "./send.js";
 export const serverHooks = {

package/dist/runtime/refresh-tool.d.ts

@@ -0,0 +1,2 @@
+import type { AgentToolProvider } from '@coffer-org/server/orchestrator';
+export declare function makeRefreshTool(conversationId: string): AgentToolProvider;

package/dist/runtime/refresh-tool.js

@@ -0,0 +1,49 @@
+import { getLogger } from '@coffer-org/sdk/logger';
+import { broadcast, subscriberCount } from "./channel-registry.js";
+const log = getLogger('webchat');
+function str(value) {
+    return typeof value === 'string' && value.trim() ? value.trim() : '';
+}
+export function makeRefreshTool(conversationId) {
+    return {
+        tools: [
+            {
+                name: 'mcp__coffer__refresh_open_page',
+                description: 'Reload the data on the page the user currently has open in the browser. ' +
+                    'Call it right after you create, update, delete or restore a record, so what they see ' +
+                    'matches what you just changed — otherwise the page keeps showing the values it loaded ' +
+                    'before your edit. Name the record you touched when you know it. ' +
+                    'When you DELETED or trashed the record, pass deleted: true with its library, shelf and ' +
+                    'id: the page showing it then returns to the list instead of sitting on a record that is ' +
+                    'no longer there. ' +
+                    'It is a display-only call: it changes no data, costs the user nothing, and is safe to ' +
+                    'repeat. Do not call it when you only READ records.',
+                inputSchema: {
+                    library: { type: 'string', description: 'Library of the record you changed, e.g. health' },
+                    shelf: { type: 'string', description: 'Shelf of the record you changed, e.g. drug' },
+                    id: { type: 'string', description: 'Id of the record you changed' },
+                    deleted: {
+                        type: 'boolean',
+                        description: 'True when you deleted or trashed that record, so the page leaves it',
+                    },
+                },
+                handler: async (args) => {
+                    const library = str(args['library']);
+                    const shelf = str(args['shelf']);
+                    const id = str(args['id']);
+                    const gone = args['deleted'] === true && Boolean(id);
+                    const scope = {
+                        ...(library ? { library } : {}),
+                        ...(shelf ? { shelf } : {}),
+                        ...(id ? { id } : {}),
+                        ...(gone ? { gone: true } : {}),
+                    };
+                    broadcast(conversationId, 'refresh', scope);
+                    const viewers = subscriberCount(conversationId);
+                    log.info(`refresh_open_page ${JSON.stringify(scope)} → ${viewers} viewer(s) on ${conversationId}`);
+                    return { requested: true, gone, viewers };
+                },
+            },
+        ],
+    };
+}

package/dist/runtime/send.js

@@ -7,6 +7,7 @@ import { getConversation, setConversation, readAndTouchConversation, } from '@co
 import { mayWrite, mayRead } from '@coffer-org/server/orchestrator';
 import { policy } from "./config.js";
 import { makeStreamingConnector } from "./connector.js";
+import { makeRefreshTool } from "./refresh-tool.js";
 import { broadcast, initFanout } from "./channel-registry.js";
 import { webChannelSystem } from "./format.js";
 import { loadReasoningDisplay } from "./settings.js";
@@ -87,6 +88,7 @@ export async function sendAction(body, caller, deps = {}) {
                     replyToMsgId: replyTo,
                 },
                 capabilities: CAPABILITIES,
+                toolProvider: makeRefreshTool(conversationId),
                 systemPrompt: { channel: [await webChannelSystem()] },
                 ...(turnContext.length ? { turnContext } : {}),
                 ...(agentId ? { agentId } : {}),

package/dist/web.js

@@ -11,7 +11,7 @@ import { definePluginUI } from "@coffer-org/web-ui";
 var ui_default = definePluginUI({ slots: [{
 	slot: "overlay",
 	id: "webchat",
-	load: () => import("./ChatWidget-BIPLpTMp.js")
+	load: () => import("./ChatWidget-DocoFt8q.js")
 }] });
 //#endregion
 export { ui_default as default };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coffer-org/plugin-webchat",
-  "version": "7.2.0",
+  "version": "7.3.0",
   "type": "module",
   "engines": {
     "node": ">=24"
@@ -29,7 +29,7 @@
   "dependencies": {
     "@coffer-org/markdown": "^7.4.0",
     "@coffer-org/sdk": "^7.4.1",
-    "@coffer-org/server": "^7.5.0",
+    "@coffer-org/server": "^7.6.0",
     "lucide-react": "^1.17.0"
   },
   "coffer": {