@coffer-org/plugin-webchat 3.1.1 → 5.0.0

package/dist/index.js

@@ -4,19 +4,20 @@ import { field } from '@coffer-org/sdk/fields';
 export default definePlugin({
     id: 'webchat',
     version: '1.0.0',
-    dependsOn: ['orchestrator'],
+    dependsOn: [],
     settings: defineSettings({
         label: 'webchat.settings.label',
-        fields: [
-            field.select({
-                key: 'reasoning_display',
+        fields: {
+            reasoning_display: field.string({
                 label: 'webchat.settings.reasoning_display',
                 default: 'live',
+                strict: true,
+                noSearch: true,
                 options: [
                     { value: 'live', title: 'webchat.settings.reasoning_display_live' },
                     { value: 'off', title: 'webchat.settings.reasoning_display_off' },
                 ],
             }),
-        ],
+        },
     }),
 });

package/dist/runtime/actions.d.ts

@@ -1,5 +1,5 @@
 import { type ActionCaller } from '@coffer-org/server/plugin-hooks';
-import { type AgentDescriptor } from '@coffer-org/plugin-orchestrator/runtime';
+import { type AgentDescriptor } from '@coffer-org/server/orchestrator';
 import { type ThreadSelection } from './chain-store.ts';
 export interface ThreadSummary {
     convId: string;
@@ -13,6 +13,7 @@ export interface HistoryMsg {
     text: string;
     ts: number;
     reasoning?: string;
+    suggestions?: string[];
     attachments?: {
         name: string;
         mime?: string;
@@ -32,6 +33,7 @@ export declare function agentsAction(body: Record<string, unknown>, caller: Acti
     agents: AgentDescriptor[];
     defaultAgentId: string | null;
     selection: ThreadSelection;
+    starters: string[];
 }>;
 export declare function selectAgentAction(body: Record<string, unknown>, caller: ActionCaller): Promise<{
     selection: ThreadSelection;

package/dist/runtime/actions.js

@@ -1,7 +1,16 @@
 import { HttpError } from '@coffer-org/server/plugin-hooks';
-import { listAgentCatalog, getDefaultAgentId, listRegisteredAgents, } from '@coffer-org/plugin-orchestrator/runtime';
+import { listAgentCatalog, getDefaultAgentId, listRegisteredAgents, getConversationStarters, } from '@coffer-org/server/orchestrator';
 import { chatIdFor, conversations, history, getSelection, setSelection } from "./chain-store.js";
 const TITLE_MAX = 60;
+function parseSuggestions(text) {
+    try {
+        const parsed = JSON.parse(text);
+        return Array.isArray(parsed) && parsed.every((v) => typeof v === 'string') ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
 function title(firstUserText) {
     const t = firstUserText.trim().replace(/\s+/g, ' ');
     return t.length <= TITLE_MAX ? t : `${t.slice(0, TITLE_MAX - 1)}…`;
@@ -28,7 +37,11 @@ export async function historyAction(body, caller) {
     const convId = requireConvId(body);
     const rows = await history(chatIdFor(caller.id, convId));
     const reasoningByBot = new Map(rows.filter((m) => m.role === 'reasoning').map((m) => [m.msgId.slice(0, -2), m.text]));
-    const visible = rows.filter((m) => m.role !== 'reasoning');
+    const suggestionsByBot = new Map(rows
+        .filter((m) => m.role === 'suggestions')
+        .map((m) => [m.msgId.slice(0, -2), parseSuggestions(m.text)])
+        .filter((entry) => entry[1] !== null));
+    const visible = rows.filter((m) => m.role !== 'reasoning' && m.role !== 'suggestions');
     return {
         convId,
         messages: visible.map((m) => ({
@@ -37,6 +50,7 @@ export async function historyAction(body, caller) {
             text: m.text,
             ts: m.ts,
             ...(reasoningByBot.has(m.msgId) ? { reasoning: reasoningByBot.get(m.msgId) } : {}),
+            ...(suggestionsByBot.has(m.msgId) ? { suggestions: suggestionsByBot.get(m.msgId) } : {}),
             ...(m.attachments?.length ? { attachments: m.attachments } : {}),
         })),
         headMsgId: visible.at(-1)?.msgId ?? null,
@@ -48,6 +62,7 @@ export async function agentsAction(body, caller) {
         agents: await listAgentCatalog(),
         defaultAgentId: getDefaultAgentId() ?? null,
         selection: await getSelection(chatIdFor(caller.id, convId)),
+        starters: await getConversationStarters(),
     };
 }
 export async function selectAgentAction(body, caller) {

package/dist/runtime/chain-store.d.ts

@@ -1,6 +1,6 @@
 import { type ThreadChat, type StoredMsg } from '@coffer-org/server/thread-store';
 import { type ThreadSelection } from '@coffer-org/server/thread-state';
-import type { ConvMessage } from '@coffer-org/plugin-orchestrator/runtime';
+import type { ConvMessage } from '@coffer-org/server/orchestrator';
 export declare const CONNECTOR = "webchat";
 export declare function chatIdFor(userId: string, convId: string): string;
 export declare function chatPrefixFor(userId: string): string;
@@ -27,6 +27,13 @@ export declare function recordReasoning(m: {
     text: string;
     now: number;
 }): Promise<boolean>;
+export declare function recordSuggestions(m: {
+    chatId: string;
+    botMsgId: string;
+    parentMsgId: string | null;
+    suggestions: string[];
+    now: number;
+}): Promise<boolean>;
 export declare function buildChain(headMsgId: string, opts: {
     chatId: string;
     maxDepth?: number;

package/dist/runtime/chain-store.js

@@ -51,6 +51,20 @@ export async function recordReasoning(m) {
     });
     return true;
 }
+export async function recordSuggestions(m) {
+    if (!m.suggestions.length)
+        return false;
+    await putThreadMessage({
+        connector: CONNECTOR,
+        chatId: m.chatId,
+        msgId: `${m.botMsgId}~s`,
+        role: 'suggestions',
+        text: JSON.stringify(m.suggestions),
+        ts: m.now - 1,
+        replyToId: m.parentMsgId,
+    });
+    return true;
+}
 export async function buildChain(headMsgId, opts) {
     const max = opts.maxDepth ?? DEFAULT_MAX_DEPTH;
     const acc = [];
@@ -61,7 +75,7 @@ export async function buildChain(headMsgId, opts) {
         const stored = await getThreadMessage(CONNECTOR, opts.chatId, cur);
         if (!stored)
             break;
-        if (stored.role !== 'reasoning') {
+        if (stored.role !== 'reasoning' && stored.role !== 'suggestions') {
             acc.push({
                 role: stored.role,
                 content: stored.text,

package/dist/runtime/config.d.ts

@@ -1,2 +1,2 @@
-import type { GatePolicy } from '@coffer-org/plugin-orchestrator/runtime';
+import type { GatePolicy } from '@coffer-org/server/orchestrator';
 export declare function policy(): GatePolicy;

package/dist/runtime/connector.d.ts

@@ -1,9 +1,10 @@
-import type { Connector } from '@coffer-org/plugin-orchestrator/runtime';
-import { recordAssistant as storeAssistant, recordReasoning as storeReasoning } from './chain-store.ts';
+import type { Connector } from '@coffer-org/server/orchestrator';
+import { recordAssistant as storeAssistant, recordReasoning as storeReasoning, recordSuggestions as storeSuggestions } from './chain-store.ts';
 import type { ReasoningDisplay } from './settings.ts';
 export interface StreamingConnector {
     connector: Connector;
     recorded(): string | null;
+    suggestions(): string[] | null;
 }
 export interface StreamingConnectorOpts {
     chatId: string;
@@ -12,5 +13,6 @@ export interface StreamingConnectorOpts {
     display: ReasoningDisplay;
     record?: typeof storeAssistant;
     recordReasoning?: typeof storeReasoning;
+    recordSuggestions?: typeof storeSuggestions;
 }
 export declare function makeStreamingConnector(opts: StreamingConnectorOpts): StreamingConnector;

package/dist/runtime/connector.js

@@ -1,11 +1,13 @@
-import { makeLiveChannel, plainRender } from '@coffer-org/plugin-orchestrator/runtime';
-import { recordAssistant as storeAssistant, recordReasoning as storeReasoning } from "./chain-store.js";
+import { makeLiveChannel, plainRender } from '@coffer-org/server/orchestrator';
+import { recordAssistant as storeAssistant, recordReasoning as storeReasoning, recordSuggestions as storeSuggestions, } from "./chain-store.js";
 const WEBCHAT_THROTTLE_MS = 250;
 const WEBCHAT_MAX = 100_000;
 export function makeStreamingConnector(opts) {
     const record = opts.record ?? storeAssistant;
     const recordReasoningFn = opts.recordReasoning ?? storeReasoning;
+    const recordSuggestionsFn = opts.recordSuggestions ?? storeSuggestions;
     let recordedId = null;
+    let lastSuggestions = null;
     const connector = {
         id: 'webchat',
         reply(_chatId, _ctx) {
@@ -25,6 +27,10 @@ export function makeStreamingConnector(opts) {
             });
             return {
                 ...ch,
+                async finish(r) {
+                    lastSuggestions = r.suggestions;
+                    return ch.finish(r);
+                },
                 updateReasoning(acc) {
                     if (opts.display === 'off')
                         return;
@@ -51,10 +57,20 @@ export function makeStreamingConnector(opts) {
                     now,
                 });
             }
+            if (wrote && lastSuggestions?.length && m.botMsgId) {
+                await recordSuggestionsFn({
+                    chatId: opts.chatId,
+                    botMsgId: m.botMsgId,
+                    parentMsgId: m.parentMsgId,
+                    suggestions: lastSuggestions,
+                    now,
+                });
+            }
         },
     };
     return {
         connector,
         recorded: () => recordedId,
+        suggestions: () => lastSuggestions,
     };
 }

package/dist/runtime/format.d.ts

@@ -1 +1,2 @@
 export declare const WEB_FORMAT: string;
+export declare function webChannelSystem(): Promise<string>;

package/dist/runtime/format.js

@@ -1,3 +1,4 @@
+import { frontendInstructions } from '@coffer-org/server/frontend-agent';
 export const WEB_FORMAT = [
     'CRITICAL OUTPUT FORMAT — MARKDOWN ONLY. Format the reply strictly as Markdown (GFM). NEVER emit raw HTML tags — they are stripped before rendering and their content may be lost.',
     'Inline: **bold**, *italic*, `inline code`, ~~strikethrough~~. Links: [text](https://…).',
@@ -8,3 +9,7 @@ export const WEB_FORMAT = [
     'The reply is read in a narrow chat panel (~360px) — keep it short and skimmable: short paragraphs, lists over prose, narrow tables.',
     'Use Unicode symbols and emoji to structure replies: arrows (→), status marks (✅ ⚠️ ❌ ⏳), topic emoji (📅 💰 🏥 🛒 🌱 …).',
 ].join('\n');
+export async function webChannelSystem() {
+    const site = await frontendInstructions('');
+    return [WEB_FORMAT, site].filter(Boolean).join('\n\n');
+}

package/dist/runtime/index.js

@@ -3,7 +3,7 @@ import { pruneThreadState } from '@coffer-org/server/thread-state';
 import { threadsAction, historyAction, agentsAction, selectAgentAction } from "./actions.js";
 import { sendAction } from "./send.js";
 import { CONNECTOR } from "./chain-store.js";
-import { registerConnector } from '@coffer-org/plugin-orchestrator/runtime';
+import { registerConnector } from '@coffer-org/server/orchestrator';
 const THREAD_TTL_MS = Number(process.env['WEBCHAT_THREAD_TTL_MS'] ?? 30 * 86_400_000);
 let unregisterConnector;
 export { WEB_FORMAT } from "./format.js";

package/dist/runtime/send.d.ts

@@ -1,4 +1,4 @@
-import { handleIncoming } from '@coffer-org/plugin-orchestrator/runtime';
+import { handleIncoming } from '@coffer-org/server/orchestrator';
 import type { ActionCaller } from '@coffer-org/server/plugin-hooks';
 export interface SendDeps {
     handleIncoming?: typeof handleIncoming;

package/dist/runtime/send.js

@@ -1,9 +1,9 @@
 import { randomUUID } from 'node:crypto';
-import { handleIncoming, liveAgentId } from '@coffer-org/plugin-orchestrator/runtime';
+import { handleIncoming, liveAgentId } from '@coffer-org/server/orchestrator';
 import { chatIdFor, recordUser, buildChain, history, readSelectionForTurn } from "./chain-store.js";
 import { policy } from "./config.js";
 import { makeStreamingConnector } from "./connector.js";
-import { WEB_FORMAT } from "./format.js";
+import { webChannelSystem } from "./format.js";
 import { loadReasoningDisplay } from "./settings.js";
 export function pageContext(ctx) {
     if (typeof ctx !== 'object' || ctx === null)
@@ -41,24 +41,25 @@ export async function sendAction(body, ctx, deps = {}) {
     const replyTo = explicitReplyTo ?? (await history(chatId, 1)).at(-1)?.msgId ?? null;
     await recordUser({ chatId, msgId, sender: ctx.caller.id, text, attachments, ts: nowSec, replyToId: replyTo });
     const messages = await buildChain(msgId, { chatId });
-    const { connector, recorded } = makeStreamingConnector({
+    const { connector, recorded, suggestions } = makeStreamingConnector({
         chatId,
         botMsgId,
         emit: ctx.emit,
         display: await loadReasoningDisplay(),
     });
-    const volatileSystem = pageContext(body['context']);
+    const turnContext = pageContext(body['context']);
     await doHandle(connector, {
         connectorId: 'webchat',
-        channelSystem: WEB_FORMAT,
-        ...(volatileSystem ? { volatileSystem } : {}),
+        channelSystem: await webChannelSystem(),
+        ...(turnContext ? { turnContext } : {}),
         ...(agentId ? { agentId } : {}),
         ...(selection.presetId ? { presetId: selection.presetId } : {}),
         chatId,
         sender: { id: ctx.caller.id },
         messages,
+        supportsSuggestions: true,
     }, { policy: policy() });
-    ctx.emit('done', { msgId: recorded(), parentMsgId: msgId });
+    ctx.emit('done', { msgId: recorded(), parentMsgId: msgId, suggestions: suggestions() });
 }
 function parseAttachments(value) {
     if (!Array.isArray(value))