@happyvertical/smrt-planner 0.57.12 → 0.57.13

package/dist/assistant/transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/lib/assistant/transport.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/lib/assistant/transport.ts"],"names":[],"mappings":"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"}

package/dist/assistant/transport.js

@@ -1,8 +1,10 @@
 import { ASSISTANT_QUESTION_KIND, matchAssistantQuestionText, validateAssistantQuestionAnswer, } from '@happyvertical/smrt-chat/svelte';
 import { resolveRuntimeReportTimeRange } from '@happyvertical/smrt-reports/spec';
+import { applySampleContext } from "../data/sample-context.js";
 import { createSliceController, } from "../planner/commands/index.js";
 import { sourceFollowUp, whichSourceQuestion, } from "../reports/intent.js";
 import { buildResponseSchema, describeChange, parseChange, } from "./change.js";
+import { appliedCoaching } from "./coaching.js";
 import { buildMatchIndex, matchText } from "./match.js";
 import { buildSystemPrompt, REPORTS_RECIPE, } from "./prompt.js";
 const THREAD_TITLE = 'Plan your app';
@@ -27,8 +29,10 @@ const runSummary = (controller, name, input) => runCommand(controller, name, inp
  */
 function runCommands(controller, calls) {
     const lines = [];
+    const results = [];
     for (const call of calls) {
         const result = controller.run(call);
+        results.push(result);
         if (!result.ok) {
             lines.push(`The server's ${call.name} was refused: ${result.error.message}`);
             break;
@@ -36,7 +40,7 @@ function runCommands(controller, calls) {
         if (result.receipt.summary)
             lines.push(result.receipt.summary);
     }
-    return lines.join(' ');
+    return { summary: lines.join(' '), results };
 }
 /** Said when a turn changed nothing and the model's sentence was not a question. */
 export const NOTHING_CHANGED = 'Nothing in the app changed.';
@@ -228,7 +232,32 @@ export function createBrowserAssistantTransport(options) {
     };
     const messages = [];
     const seen = new Map();
+    const seeds = new Set();
+    const listeners = new Set();
+    let busy = false;
+    let sent = false;
+    let generation = 0;
+    const conversation = () => structuredClone(messages);
+    const persist = () => {
+        try {
+            options.conversationStorage?.setItem('smrt-planner:conversation:v1', JSON.stringify({ version: 1, messages, sent, counter }));
+            options.conversationStorage?.setItem('smrt-planner:conversation-seed:v1', JSON.stringify([...seeds]));
+        }
+        catch {
+            /* A blocked or full browser store must not break a turn. */
+        }
+    };
+    const notify = () => {
+        persist();
+        for (const listener of listeners)
+            listener(conversation());
+    };
+    const cookbooksForTurn = () => typeof options.cookbooks === 'function'
+        ? options.cookbooks()
+        : (options.cookbooks ?? []);
     let controller = null;
+    const owns = (operation) => operation.epoch === generation && controller === operation.controller;
+    const active = (operation) => owns(operation) && !operation.controller.signal.aborted;
     /**
      * The report follow-up waiting for an answer: the intent so far, the
      * question asked (its options from the source descriptor), and the words
@@ -242,8 +271,10 @@ export function createBrowserAssistantTransport(options) {
      * identical question twice is never done: the sensible default is taken
      * and the reply says so.
      */
-    async function buildReport(reports, intent, text, previous) {
+    async function buildReport(reports, intent, text, previous, current) {
         const defined = await reports.define(intent, text);
+        if (!current())
+            return { added: [], text: 'Stopped.' };
         if (defined.ok) {
             pending = null;
             // Reports must be on to keep the report; turning it on is a command
@@ -269,7 +300,9 @@ export function createBrowserAssistantTransport(options) {
         if (previous && sameFollowUp(previous, followUp)) {
             const pick = followUp.options.find((o) => o.value === followUp.default);
             if (pick) {
-                const next = await buildReport(reports, mergeIntent(intent, pick.apply), text, followUp);
+                const next = await buildReport(reports, mergeIntent(intent, pick.apply), text, followUp, current);
+                if (!current())
+                    return { added: [], text: 'Stopped.' };
                 return { ...next, text: `I went with ${pick.label}. ${next.text}` };
             }
         }
@@ -284,11 +317,13 @@ export function createBrowserAssistantTransport(options) {
         return followUp.options.find((o) => o.value === value);
     }
     /** Continue a pending report with a picked option, with no model turn. */
-    async function answerPending(reports, option, reply = '') {
+    async function answerPending(reports, option, reply, isCurrent) {
         const current = pending;
         if (!current)
             return { content: '' };
-        const built = await buildReport(reports, mergeIntent(current.intent, option.apply), `${current.text} ${reply}`.trim(), current.followUp);
+        const built = await buildReport(reports, mergeIntent(current.intent, option.apply), `${current.text} ${reply}`.trim(), current.followUp, isCurrent);
+        if (!isCurrent())
+            return { content: 'Stopped.' };
         const content = [
             describeChange({ added: built.added, removed: [], kept: [] }, options.recipes),
             built.text,
@@ -302,7 +337,7 @@ export function createBrowserAssistantTransport(options) {
     const reportsHost = () => options.recipes.some((r) => r.id === REPORTS_RECIPE)
         ? (options.reports?.() ?? null)
         : null;
-    const push = (role, content, clientRequestId, toolCallData) => {
+    const push = (role, content, clientRequestId, toolCallData, notifyChange = true) => {
         const message = {
             id: id('m'),
             threadId: thread.id,
@@ -316,6 +351,8 @@ export function createBrowserAssistantTransport(options) {
         messages.push(message);
         thread.messageCount = messages.length;
         thread.lastMessageAt = message.createdAt;
+        if (notifyChange)
+            notify();
         return message;
     };
     const planner = options.controller ??
@@ -324,11 +361,87 @@ export function createBrowserAssistantTransport(options) {
             settings: options.settings,
             theme: options.theme,
         });
-    const index = buildMatchIndex(options.recipes, options.cookbooks ?? [], {
-        theme: !!options.theme,
-    });
-    const greeting = push('assistant', GREETING);
-    async function turn(text) {
+    let greeting = push('assistant', GREETING, undefined, undefined, false);
+    try {
+        const raw = options.conversationStorage?.getItem('smrt-planner:conversation:v1');
+        const stored = raw && raw.length <= 2_000_000 ? JSON.parse(raw) : null;
+        if (stored?.version === 1 &&
+            Array.isArray(stored.messages) &&
+            stored.messages.length <= 2000 &&
+            stored.messages.every((m) => m &&
+                typeof m.id === 'string' &&
+                ['user', 'assistant'].includes(m.role) &&
+                typeof m.content === 'string' &&
+                m.content.length <= 100_000) &&
+            Number.isSafeInteger(stored.counter) &&
+            stored.counter >= stored.messages.length &&
+            typeof stored.sent === 'boolean') {
+            messages.splice(0, messages.length, ...structuredClone(stored.messages));
+            counter = stored.counter;
+            sent = stored.sent;
+            greeting = messages[0] ?? push('assistant', GREETING);
+            const ids = JSON.parse(options.conversationStorage?.getItem('smrt-planner:conversation-seed:v1') ?? '[]');
+            if (Array.isArray(ids) &&
+                ids.length <= 2000 &&
+                ids.every((value) => typeof value === 'string' && value.length <= 200))
+                for (const value of ids)
+                    seeds.add(value);
+        }
+    }
+    catch {
+        /* Invalid saved data carries no authority and is ignored. */
+    }
+    async function send(input, host) {
+        const cached = seen.get(input.clientRequestId);
+        if (cached)
+            return cached;
+        if (busy)
+            throw new Error('The assistant is still answering.');
+        sent = true;
+        busy = true;
+        const operation = { epoch: generation, controller: new AbortController() };
+        controller = operation.controller;
+        try {
+            const userMessage = push('user', input.content, input.clientRequestId);
+            let reply = null;
+            if (!host && options.hostTurn) {
+                try {
+                    reply = await options.hostTurn({
+                        userMessage: structuredClone(userMessage),
+                        conversation: conversation(),
+                        signal: operation.controller.signal,
+                    });
+                }
+                catch {
+                    reply = {
+                        content: 'Your request could not be confirmed. Please retry the same request.',
+                    };
+                }
+                if (!owns(operation))
+                    return { inProgress: false };
+                if (operation.controller.signal.aborted)
+                    reply = { content: 'Stopped.' };
+            }
+            reply ??= await turn(input.content, operation);
+            if (!owns(operation))
+                return { inProgress: false };
+            const result = {
+                inProgress: false,
+                userMessage,
+                assistantMessage: push('assistant', reply.content, undefined, reply.refs),
+            };
+            seen.set(input.clientRequestId, result);
+            return result;
+        }
+        finally {
+            if (owns(operation)) {
+                controller = null;
+                busy = false;
+                notify();
+            }
+        }
+    }
+    async function turn(text, operation) {
         // A typed answer to the pending report question resolves against its
         // options in code: no model turn, and "the date month" means the date by
         // month whatever the model would have made of it.
@@ -337,7 +450,7 @@ export function createBrowserAssistantTransport(options) {
             const option = directAnswer(pending.followUp, pending.question, text);
             // The reply's own time words ("status last month") still count.
             if (option)
-                return answerPending(pendingReports, option, text);
+                return answerPending(pendingReports, option, text, () => active(operation));
         }
         const model = options.model();
         if (!model) {
@@ -348,9 +461,11 @@ export function createBrowserAssistantTransport(options) {
                     'Download a model first, then I can help. The cards on the Planner page work without one.',
             };
         }
-        controller = new AbortController();
         try {
-            const cookbooks = options.cookbooks ?? [];
+            const cookbooks = cookbooksForTurn();
+            const index = buildMatchIndex(options.recipes, cookbooks, {
+                theme: !!options.theme,
+            });
             const prior = messages
                 .filter((m) => m !== greeting)
                 .slice(0, -1)
@@ -365,6 +480,14 @@ export function createBrowserAssistantTransport(options) {
             const reports = reportsHost();
             const reportSources = reports?.sources() ?? [];
             const asked = pending;
+            // Hosted structured replies describe this exact app revision. Local
+            // providers may perform their own supported tool work during message().
+            const hosted = typeof options.acceptCommands === 'function'
+                ? options.acceptCommands()
+                : options.acceptCommands;
+            const inferenceRevision = hosted
+                ? planner.snapshot().revision
+                : undefined;
             const raw = await model.message(text, {
                 history: [
                     {
@@ -382,8 +505,17 @@ export function createBrowserAssistantTransport(options) {
                 responseSchema: buildResponseSchema(options.recipes, cookbooks, !!options.settings, !!options.theme, menu.map((section) => section.id), reportSources.map((source) => source.id)),
                 temperature: 0,
                 maxTokens: MAX_REPLY_TOKENS,
-                signal: controller.signal,
+                signal: operation.controller.signal,
             });
+            // A provider may resolve after abort instead of rejecting. Never apply it.
+            if (!active(operation))
+                return { content: 'Stopped.' };
+            if (inferenceRevision !== undefined &&
+                planner.snapshot().revision !== inferenceRevision) {
+                return {
+                    content: 'The app changed while I was preparing that reply. I have kept your newer changes and applied nothing from this reply. Please try again.',
+                };
+            }
             const change = parseChange(raw, options.recipes, cookbooks, {
                 commands: typeof options.acceptCommands === 'function'
                     ? options.acceptCommands()
@@ -399,6 +531,7 @@ export function createBrowserAssistantTransport(options) {
                 change.remove = [];
                 delete change.open;
             }
+            const beforeCommands = planner.snapshot();
             const applied = applyRecipes(planner, change);
             const settingsText = options.settings && hasKeys(change.settings)
                 ? runSummary(planner, 'set_settings', change.settings)
@@ -410,9 +543,17 @@ export function createBrowserAssistantTransport(options) {
             const undo = themed?.undoId && options.themeUndos
                 ? options.themeUndos.record(previousTheme, themed.undoId)
                 : undefined;
-            const commandText = (change.commands ?? []).length
+            const commandRun = (change.commands ?? []).length
                 ? runCommands(planner, change.commands ?? [])
-                : '';
+                : { summary: '', results: [] };
+            if (change.sampleContext &&
+                commandRun.results.length === change.commands?.length &&
+                commandRun.results.every((result) => result.ok) &&
+                commandRun.results.some((result) => result.ok && result.receipt.changed)) {
+                applySampleContext(change.sampleContext);
+            }
+            const commandText = commandRun.summary;
+            const coaching = appliedCoaching(beforeCommands, planner.snapshot(), commandRun.results, options.recipes);
             // A request for a report or a summary of the data (the keyword match
             // finds reports.runtime) goes to Reports or nowhere: an `open` of any
             // other section (the product catalogue, say) is dropped.
@@ -447,7 +588,9 @@ export function createBrowserAssistantTransport(options) {
                 !!openText ||
                 !!change.cookbook;
             if (reports && reportIntent) {
-                const built = await buildReport(reports, reportIntent, reportWords, asked?.followUp ?? null);
+                const built = await buildReport(reports, reportIntent, reportWords, asked?.followUp ?? null, () => active(operation));
+                if (!active(operation))
+                    return { content: 'Stopped.' };
                 applied.added.push(...built.added);
                 reportText = built.text;
                 reportRef = built.ref;
@@ -456,7 +599,9 @@ export function createBrowserAssistantTransport(options) {
                 // A second miss: never the identical question again.
                 const pick = asked.followUp.options.find((o) => o.value === asked.followUp.default);
                 if (pick) {
-                    const built = await buildReport(reports, mergeIntent(asked.intent, pick.apply), asked.text, asked.followUp);
+                    const built = await buildReport(reports, mergeIntent(asked.intent, pick.apply), asked.text, asked.followUp, () => active(operation));
+                    if (!active(operation))
+                        return { content: 'Stopped.' };
                     applied.added.push(...built.added);
                     reportText = `I went with ${pick.label}. ${built.text}`;
                     reportRef = built.ref;
@@ -515,7 +660,9 @@ export function createBrowserAssistantTransport(options) {
                 ? cookbooks.find((c) => c.id === cookbookId)
                 : undefined;
             const line = change.reply || (offered ? `Set up ${offered.name}?` : '');
-            const reply = honestReply(line, summary, !!offer);
+            const reply = [honestReply(line, summary, !!offer), coaching]
+                .filter(Boolean)
+                .join(' ');
             if (reply)
                 options.onReply?.(reply);
             // One ref renders as is; several in one turn (a cookbook offer, a theme
@@ -525,16 +672,43 @@ export function createBrowserAssistantTransport(options) {
             return { content: reply, refs };
         }
         catch (error) {
-            if (controller?.signal.aborted)
+            if (!active(operation))
                 return { content: 'Stopped.' };
             const detail = error instanceof Error ? error.message : String(error);
             return { content: `Sorry, the model could not answer: ${detail}` };
         }
-        finally {
-            controller = null;
-        }
     }
     return {
+        conversation,
+        get resetRevision() {
+            return generation;
+        },
+        get busy() {
+            return busy;
+        },
+        subscribeConversation(listener) {
+            listeners.add(listener);
+            listener(conversation());
+            return () => listeners.delete(listener);
+        },
+        seed(input) {
+            if (!input ||
+                typeof input.id !== 'string' ||
+                !input.id.trim() ||
+                !Array.isArray(input.messages) ||
+                input.messages.some((message) => !message ||
+                    !['user', 'assistant'].includes(message.role) ||
+                    typeof message.content !== 'string') ||
+                seeds.has(input.id) ||
+                busy ||
+                sent)
+                return false;
+            seeds.add(input.id);
+            for (const message of input.messages)
+                push(message.role, message.content, undefined, undefined, false);
+            notify();
+            return true;
+        },
         async listThreads() {
             return [thread];
         },
@@ -544,19 +718,25 @@ export function createBrowserAssistantTransport(options) {
         async loadMessages() {
             return [...messages];
         },
-        async sendMessage(input) {
-            const cached = seen.get(input.clientRequestId);
-            if (cached)
-                return cached;
-            const userMessage = push('user', input.content, input.clientRequestId);
-            const reply = await turn(input.content);
-            const result = {
-                inProgress: false,
-                userMessage,
-                assistantMessage: push('assistant', reply.content, undefined, reply.refs),
-            };
-            seen.set(input.clientRequestId, result);
-            return result;
+        sendMessage(input) {
+            return send(input, false);
+        },
+        sendHostMessage(input) {
+            return send(input, true);
+        },
+        reset() {
+            generation += 1;
+            controller?.abort();
+            controller = null;
+            pending = null;
+            messages.splice(0);
+            seen.clear();
+            seeds.clear();
+            sent = false;
+            busy = false;
+            counter = 0;
+            greeting = push('assistant', GREETING);
+            notify();
         },
         /**
          * The report follow-up's form, submitted: its pick merges into the
@@ -567,6 +747,8 @@ export function createBrowserAssistantTransport(options) {
             const cached = seen.get(input.clientRequestId);
             if (cached)
                 return cached;
+            if (busy)
+                throw new Error('The assistant is still answering.');
             const reports = reportsHost();
             if (!pending || !reports || pending.question.id !== input.questionId) {
                 throw new Error('That question is no longer open. Ask again?');
@@ -577,27 +759,45 @@ export function createBrowserAssistantTransport(options) {
                 : undefined;
             if (!values || !option)
                 throw new Error('Choose one of the options.');
-            const asked = messages.find((m) => m.id === input.messageId);
-            if (asked) {
-                const mark = (ref) => {
-                    const item = ref;
-                    return item?.kind === ASSISTANT_QUESTION_KIND &&
-                        item.id === input.questionId
-                        ? { ...item, answer: values }
-                        : ref;
+            sent = true;
+            busy = true;
+            const operation = {
+                epoch: generation,
+                controller: new AbortController(),
+            };
+            controller = operation.controller;
+            try {
+                const asked = messages.find((m) => m.id === input.messageId);
+                if (asked) {
+                    const mark = (ref) => {
+                        const item = ref;
+                        return item?.kind === ASSISTANT_QUESTION_KIND &&
+                            item.id === input.questionId
+                            ? { ...item, answer: values }
+                            : ref;
+                    };
+                    asked.toolCallData = Array.isArray(asked.toolCallData)
+                        ? asked.toolCallData.map(mark)
+                        : mark(asked.toolCallData);
+                }
+                const reply = await answerPending(reports, option, '', () => active(operation));
+                if (!owns(operation))
+                    return { inProgress: false };
+                const result = {
+                    inProgress: false,
+                    ...(asked ? { messages: [asked] } : {}),
+                    assistantMessage: push('assistant', reply.content, undefined, reply.refs),
                 };
-                asked.toolCallData = Array.isArray(asked.toolCallData)
-                    ? asked.toolCallData.map(mark)
-                    : mark(asked.toolCallData);
+                seen.set(input.clientRequestId, result);
+                return result;
+            }
+            finally {
+                if (owns(operation)) {
+                    controller = null;
+                    busy = false;
+                    notify();
+                }
             }
-            const reply = await answerPending(reports, option);
-            const result = {
-                inProgress: false,
-                ...(asked ? { messages: [asked] } : {}),
-                assistantMessage: push('assistant', reply.content, undefined, reply.refs),
-            };
-            seen.set(input.clientRequestId, result);
-            return result;
         },
         recordReportOutcome(specHash, outcome) {
             for (const message of messages) {
@@ -612,6 +812,7 @@ export function createBrowserAssistantTransport(options) {
                     }
                 }
             }
+            notify();
         },
         async uploadAttachment(file) {
             throw new Error(`The assistant cannot take attachments (${file.name}).`);