@xopcai/xopc 0.0.160 → 0.0.162

package/dist/src/gateway/service.js

@@ -78,6 +78,8 @@ import { runBootstrapMigrationsSync } from "../migrations/runner.js";
 import { MobileNotificationService } from "../mobile/notification-service.js";
 import { LocalAppService } from "../local-apps/service.js";
 import "../local-apps/index.js";
+import { createRuntimeBrowserRecipeService } from "../browser/recipes/runtime-service.js";
+import "../browser/recipes/index.js";
 import { scheduleGatewayUpdateCheck } from "../infra/update-startup.js";
 import { resolveChannelConnectDeferSet } from "./resolve-channel-connect-defer.js";
 import { restartGatewayProcessWithFreshPid } from "./respawn.js";
@@ -108,6 +110,7 @@ var GatewayService = class {
 	_agentService = null;
 	channelManager;
 	automationService;
+	browserRecipeService = null;
 	notesService;
 	extensionLoader = null;
 	extensionMetadataSnapshot = null;
@@ -126,6 +129,13 @@ var GatewayService = class {
 	getConfig() {
 		return this.config;
 	}
+	get browserRecipes() {
+		if (!this.browserRecipeService) this.browserRecipeService = createRuntimeBrowserRecipeService({
+			getConfig: () => this.config,
+			emit: (type, payload) => this.emit(type, payload)
+		});
+		return this.browserRecipeService;
+	}
 	stopGatewayUpdateCheck = null;
 	/** When set (e.g. by `GatewayServer`), `triggerGatewayProcessRestart` can stop HTTP then exit. */
 	gatewayShutdownForRestart = null;
@@ -322,6 +332,7 @@ var GatewayService = class {
 			},
 			extensionRegistry: this.extensionLoader?.getRegistry(),
 			getAutomationService: () => this.automationService,
+			getBrowserRecipeService: () => this.browserRecipes,
 			getNotesService: () => this.notesService,
 			getProjectService: () => this.projects,
 			getWorkItemService: () => new WorkItemService(),
@@ -361,6 +372,7 @@ var GatewayService = class {
 			getDefaultAgentId: () => getDefaultAgentId(this.config),
 			getProjectWorkspaceRoot: (projectId) => this.projects.get(projectId)?.workspaceRoot,
 			workflowRunService: this.createWorkflowRunService(),
+			browserRecipeService: this.browserRecipes,
 			onRunCompleted: (run) => this.handleAutomationRunCompleted(run)
 		});
 		this._agentService.persistentGoals.setWebchatContinuationScheduler((sessionKey, message) => {
@@ -671,6 +683,7 @@ var GatewayService = class {
 			agentService: this.agentService,
 			getDefaultAgentId: () => getDefaultAgentId(this.config),
 			workflowRunService: this.createWorkflowRunService(),
+			browserRecipeService: this.browserRecipes,
 			onRunCompleted: (run) => this.handleAutomationRunCompleted(run)
 		});
 		this.startAutomationProductEventBridge();
@@ -822,6 +835,7 @@ var GatewayService = class {
 		this.connectorMemorySyncCoordinator = null;
 		this.connectedKnowledgeCoordinator?.stop();
 		this.connectedKnowledgeCoordinator = null;
+		await this.browserRecipeService?.shutdown();
 		if (this.browserExtensionRelease) {
 			await this.browserExtensionRelease();
 			this.browserExtensionRelease = null;

package/dist/src/local-apps/preview-runtime-bridge.d.ts

@@ -1,4 +1,4 @@
 import type { LocalAppAcceptanceConfig } from './acceptance.js';
-export declare const LOCAL_APP_RUNTIME_BRIDGE_SCRIPT = "(() => {\n  let hostPort = null;\n  const pending = [];\n  const send = (type, detail) => {\n    const message = { source: 'xopc-local-app-preview', version: 1, type, detail };\n    if (hostPort) hostPort.postMessage(message);\n    else pending.push(message);\n  };\n  const connect = (event) => {\n    const message = event.data;\n    if (event.source !== parent || message?.source !== 'xopc-local-app-host' || message?.version !== 1 || message?.type !== 'connect' || !event.ports[0]) return;\n    event.stopImmediatePropagation();\n    removeEventListener('message', connect, true);\n    hostPort = event.ports[0];\n    hostPort.start();\n    for (const queued of pending.splice(0)) hostPort.postMessage(queued);\n  };\n  addEventListener('message', connect, true);\n  const text = (value) => String(value ?? '').slice(0, 500);\n  let runtimeFailure = '';\n  const visible = (element) => {\n    const style = getComputedStyle(element);\n    const rect = element.getBoundingClientRect();\n    return style.display !== 'none' && style.visibility !== 'hidden' && Number(style.opacity) !== 0 && rect.width > 0 && rect.height > 0;\n  };\n  const accessibleName = (element) => {\n    const labelledBy = text(element.getAttribute('aria-labelledby'));\n    const labelledText = labelledBy.split(/\\s+/).map((id) => document.getElementById(id)?.textContent).filter(Boolean).join(' ');\n    return text(element.getAttribute('aria-label') || labelledText || element.labels?.[0]?.textContent || element.textContent || element.getAttribute('alt') || element.getAttribute('title') || element.getAttribute('placeholder') || element.getAttribute('name')).trim();\n  };\n  const target = (id) => Array.from(document.querySelectorAll('[data-xopc-test-id]'))\n    .find((element) => element.getAttribute('data-xopc-test-id') === id);\n  const pause = () => new Promise((resolve) => setTimeout(resolve, 50));\n  const readCriteria = () => {\n    const encoded = document.querySelector('meta[name=\"xopc-local-app-acceptance\"]')?.content;\n    if (!encoded) return { schemaVersion: 1, scenarios: [] };\n    const base64 = encoded.replace(/-/g, '+').replace(/_/g, '/');\n    const padded = base64.padEnd(Math.ceil(base64.length / 4) * 4, '=');\n    const bytes = Uint8Array.from(atob(padded), (char) => char.charCodeAt(0));\n    return JSON.parse(new TextDecoder().decode(bytes));\n  };\n  addEventListener('error', (event) => {\n    runtimeFailure = text(event.message || 'A preview resource failed to load');\n    send('error', {\n      kind: 'script_error',\n      message: runtimeFailure,\n      filename: text(event.filename),\n      line: Number(event.lineno) || undefined,\n      column: Number(event.colno) || undefined,\n    });\n  }, true);\n  addEventListener('unhandledrejection', (event) => {\n    runtimeFailure = text(event.reason instanceof Error ? event.reason.message : event.reason);\n    send('error', { kind: 'unhandled_rejection', message: runtimeFailure });\n  });\n  const runAcceptance = () => {\n    const checks = [];\n    const bodyReady = Boolean(document.body);\n    checks.push({ id: 'document', status: bodyReady ? 'passed' : 'failed', message: bodyReady ? 'Preview document loaded' : 'Preview document has no body' });\n    const contentNodes = bodyReady ? Array.from(document.body.querySelectorAll('*')).slice(0, 300) : [];\n    const hasVisibleContent = contentNodes.some((element) => visible(element) && (text(element.textContent).trim() || /^(IMG|SVG|CANVAS|VIDEO)$/.test(element.tagName)));\n    checks.push({ id: 'content', status: hasVisibleContent ? 'passed' : 'failed', message: hasVisibleContent ? 'Visible content rendered' : 'No visible content was rendered' });\n    const controls = bodyReady ? Array.from(document.body.querySelectorAll('a[href], button, input, select, textarea, [role=\"button\"], [tabindex]')).filter((element) => visible(element) && !element.disabled && element.getAttribute('aria-disabled') !== 'true') : [];\n    const unnamed = controls.filter((element) => !accessibleName(element));\n    let interactionStatus = controls.length ? 'passed' : 'skipped';\n    let interactionMessage = controls.length ? controls.length + ' interactive control(s) are discoverable' : 'No interactive controls to exercise';\n    if (unnamed.length) {\n      interactionStatus = 'failed';\n      interactionMessage = unnamed.length + ' interactive control(s) need an accessible name';\n    } else if (controls.length) {\n      const previous = document.activeElement;\n      controls[0].focus({ preventScroll: true });\n      if (document.activeElement !== controls[0]) {\n        interactionStatus = 'failed';\n        interactionMessage = 'The first interactive control could not receive focus';\n      }\n      if (previous && typeof previous.focus === 'function') previous.focus({ preventScroll: true });\n      else controls[0].blur();\n    }\n    checks.push({ id: 'interaction', status: interactionStatus, message: interactionMessage });\n    send('acceptance', {\n      status: checks.some((check) => check.status === 'failed') ? 'failed' : 'passed',\n      checks,\n      interactiveCount: controls.length,\n    });\n  };\n  const runCriteria = async () => {\n    const params = new URLSearchParams(location.search);\n    if (params.get('xopcAcceptance') !== '1') return;\n    let config;\n    try {\n      config = readCriteria();\n    } catch (error) {\n      send('criteria', { status: 'failed', scenarioCount: 0, scenarios: [{ id: 'config', name: 'Acceptance config', status: 'failed', message: text(error instanceof Error ? error.message : error) }] });\n      return;\n    }\n    const requestedScenario = params.get('xopcScenario');\n    const selectedScenarios = requestedScenario\n      ? (config.scenarios || []).filter((scenario) => scenario.id === requestedScenario)\n      : config.scenarios || [];\n    if (requestedScenario && !selectedScenarios.length) {\n      send('criteria', { status: 'failed', scenarioCount: 1, scenarios: [{ id: requestedScenario, name: requestedScenario, status: 'failed', message: 'Requested scenario was not found' }] });\n      return;\n    }\n    const scenarios = [];\n    for (const scenario of selectedScenarios) {\n      let failure = '';\n      for (let index = 0; index < scenario.steps.length; index += 1) {\n        const step = scenario.steps[index];\n        try {\n          if (step.action === 'click') {\n            const element = target(step.target);\n            if (!(element instanceof HTMLElement)) throw new Error('Target \"' + step.target + '\" was not found');\n            if ('disabled' in element && element.disabled || element.getAttribute('aria-disabled') === 'true') throw new Error('Target \"' + step.target + '\" is disabled');\n            element.click();\n            await pause();\n          } else if (step.action === 'fill') {\n            const element = target(step.target);\n            if (!(element instanceof HTMLInputElement || element instanceof HTMLTextAreaElement || element instanceof HTMLSelectElement)) throw new Error('Target \"' + step.target + '\" cannot be filled');\n            const prototype = element instanceof HTMLInputElement ? HTMLInputElement.prototype : element instanceof HTMLTextAreaElement ? HTMLTextAreaElement.prototype : HTMLSelectElement.prototype;\n            const setter = Object.getOwnPropertyDescriptor(prototype, 'value')?.set;\n            if (setter) setter.call(element, step.value);\n            else element.value = step.value;\n            element.dispatchEvent(new Event('input', { bubbles: true }));\n            element.dispatchEvent(new Event('change', { bubbles: true }));\n            await pause();\n          } else if (step.assert === 'text_visible') {\n            const found = Array.from(document.body.querySelectorAll('*')).some((element) => visible(element) && text(element.textContent).includes(step.text));\n            if (!found) throw new Error('Visible text was not found: \"' + step.text + '\"');\n          } else if (step.assert === 'element_exists') {\n            if (!target(step.target)) throw new Error('Target \"' + step.target + '\" was not found');\n          } else if (step.assert === 'value_equals') {\n            const element = target(step.target);\n            if (!element || !('value' in element) || element.value !== step.value) throw new Error('Target \"' + step.target + '\" does not have the expected value');\n          }\n          if (runtimeFailure) throw new Error(runtimeFailure);\n        } catch (error) {\n          failure = 'Step ' + (index + 1) + ': ' + text(error instanceof Error ? error.message : error);\n          break;\n        }\n      }\n      scenarios.push({ id: scenario.id, name: scenario.name, status: failure ? 'failed' : 'passed', message: failure || 'Scenario passed' });\n    }\n    send('criteria', {\n      status: scenarios.some((scenario) => scenario.status === 'failed') ? 'failed' : 'passed',\n      scenarioCount: scenarios.length,\n      scenarios,\n    });\n  };\n  const loaded = () => {\n    send('ready', { readyState: document.readyState });\n    const run = () => { runAcceptance(); void runCriteria(); };\n    if (typeof requestAnimationFrame === 'function') requestAnimationFrame(() => requestAnimationFrame(run));\n    else setTimeout(run, 0);\n  };\n  if (document.readyState === 'complete') queueMicrotask(loaded);\n  else addEventListener('load', loaded, { once: true });\n})();";
+export declare const LOCAL_APP_RUNTIME_BRIDGE_SCRIPT = "(() => {\n  let hostPort = null;\n  const latest = new Map();\n  const send = (type, detail) => {\n    const message = { source: 'xopc-local-app-preview', version: 1, type, detail };\n    latest.set(type, message);\n    hostPort?.postMessage(message);\n  };\n  const connect = (event) => {\n    const message = event.data;\n    if (event.source !== parent || message?.source !== 'xopc-local-app-host' || message?.version !== 1 || message?.type !== 'connect' || !event.ports[0]) return;\n    event.stopImmediatePropagation();\n    hostPort?.close();\n    hostPort = event.ports[0];\n    hostPort.start();\n    for (const message of latest.values()) hostPort.postMessage(message);\n  };\n  addEventListener('message', connect, true);\n  const text = (value) => String(value ?? '').slice(0, 500);\n  let runtimeFailure = '';\n  const visible = (element) => {\n    const style = getComputedStyle(element);\n    const rect = element.getBoundingClientRect();\n    return style.display !== 'none' && style.visibility !== 'hidden' && Number(style.opacity) !== 0 && rect.width > 0 && rect.height > 0;\n  };\n  const accessibleName = (element) => {\n    const labelledBy = text(element.getAttribute('aria-labelledby'));\n    const labelledText = labelledBy.split(/\\s+/).map((id) => document.getElementById(id)?.textContent).filter(Boolean).join(' ');\n    return text(element.getAttribute('aria-label') || labelledText || element.labels?.[0]?.textContent || element.textContent || element.getAttribute('alt') || element.getAttribute('title') || element.getAttribute('placeholder') || element.getAttribute('name')).trim();\n  };\n  const target = (id) => Array.from(document.querySelectorAll('[data-xopc-test-id]'))\n    .find((element) => element.getAttribute('data-xopc-test-id') === id);\n  const settle = async () => {\n    await Promise.resolve();\n    await Promise.resolve();\n  };\n  const readCriteria = () => {\n    const encoded = document.querySelector('meta[name=\"xopc-local-app-acceptance\"]')?.content;\n    if (!encoded) return { schemaVersion: 1, scenarios: [] };\n    const base64 = encoded.replace(/-/g, '+').replace(/_/g, '/');\n    const padded = base64.padEnd(Math.ceil(base64.length / 4) * 4, '=');\n    const bytes = Uint8Array.from(atob(padded), (char) => char.charCodeAt(0));\n    return JSON.parse(new TextDecoder().decode(bytes));\n  };\n  addEventListener('error', (event) => {\n    runtimeFailure = text(event.message || 'A preview resource failed to load');\n    send('error', {\n      kind: 'script_error',\n      message: runtimeFailure,\n      filename: text(event.filename),\n      line: Number(event.lineno) || undefined,\n      column: Number(event.colno) || undefined,\n    });\n  }, true);\n  addEventListener('unhandledrejection', (event) => {\n    runtimeFailure = text(event.reason instanceof Error ? event.reason.message : event.reason);\n    send('error', { kind: 'unhandled_rejection', message: runtimeFailure });\n  });\n  const runAcceptance = () => {\n    const checks = [];\n    const bodyReady = Boolean(document.body);\n    checks.push({ id: 'document', status: bodyReady ? 'passed' : 'failed', message: bodyReady ? 'Preview document loaded' : 'Preview document has no body' });\n    const contentNodes = bodyReady ? Array.from(document.body.querySelectorAll('*')).slice(0, 300) : [];\n    const hasVisibleContent = contentNodes.some((element) => visible(element) && (text(element.textContent).trim() || /^(IMG|SVG|CANVAS|VIDEO)$/.test(element.tagName)));\n    checks.push({ id: 'content', status: hasVisibleContent ? 'passed' : 'failed', message: hasVisibleContent ? 'Visible content rendered' : 'No visible content was rendered' });\n    const controls = bodyReady ? Array.from(document.body.querySelectorAll('a[href], button, input, select, textarea, [role=\"button\"], [tabindex]')).filter((element) => visible(element) && !element.disabled && element.getAttribute('aria-disabled') !== 'true') : [];\n    const unnamed = controls.filter((element) => !accessibleName(element));\n    let interactionStatus = controls.length ? 'passed' : 'skipped';\n    let interactionMessage = controls.length ? controls.length + ' interactive control(s) are discoverable' : 'No interactive controls to exercise';\n    if (unnamed.length) {\n      interactionStatus = 'failed';\n      interactionMessage = unnamed.length + ' interactive control(s) need an accessible name';\n    } else if (controls.length) {\n      const previous = document.activeElement;\n      controls[0].focus({ preventScroll: true });\n      if (document.activeElement !== controls[0]) {\n        interactionStatus = 'failed';\n        interactionMessage = 'The first interactive control could not receive focus';\n      }\n      if (previous && typeof previous.focus === 'function') previous.focus({ preventScroll: true });\n      else controls[0].blur();\n    }\n    checks.push({ id: 'interaction', status: interactionStatus, message: interactionMessage });\n    send('acceptance', {\n      status: checks.some((check) => check.status === 'failed') ? 'failed' : 'passed',\n      checks,\n      interactiveCount: controls.length,\n    });\n  };\n  const runCriteria = async () => {\n    const params = new URLSearchParams(location.search);\n    if (params.get('xopcAcceptance') !== '1') return;\n    let config;\n    try {\n      config = readCriteria();\n    } catch (error) {\n      send('criteria', { status: 'failed', scenarioCount: 0, scenarios: [{ id: 'config', name: 'Acceptance config', status: 'failed', message: text(error instanceof Error ? error.message : error) }] });\n      return;\n    }\n    const requestedScenario = params.get('xopcScenario');\n    const selectedScenarios = requestedScenario\n      ? (config.scenarios || []).filter((scenario) => scenario.id === requestedScenario)\n      : config.scenarios || [];\n    if (requestedScenario && !selectedScenarios.length) {\n      send('criteria', { status: 'failed', scenarioCount: 1, scenarios: [{ id: requestedScenario, name: requestedScenario, status: 'failed', message: 'Requested scenario was not found' }] });\n      return;\n    }\n    const scenarios = [];\n    for (const scenario of selectedScenarios) {\n      let failure = '';\n      for (let index = 0; index < scenario.steps.length; index += 1) {\n        const step = scenario.steps[index];\n        try {\n          if (step.action === 'click') {\n            const element = target(step.target);\n            if (!(element instanceof HTMLElement)) throw new Error('Target \"' + step.target + '\" was not found');\n            if ('disabled' in element && element.disabled || element.getAttribute('aria-disabled') === 'true') throw new Error('Target \"' + step.target + '\" is disabled');\n            element.click();\n            await settle();\n          } else if (step.action === 'fill') {\n            const element = target(step.target);\n            if (!(element instanceof HTMLInputElement || element instanceof HTMLTextAreaElement || element instanceof HTMLSelectElement)) throw new Error('Target \"' + step.target + '\" cannot be filled');\n            const prototype = element instanceof HTMLInputElement ? HTMLInputElement.prototype : element instanceof HTMLTextAreaElement ? HTMLTextAreaElement.prototype : HTMLSelectElement.prototype;\n            const setter = Object.getOwnPropertyDescriptor(prototype, 'value')?.set;\n            if (setter) setter.call(element, step.value);\n            else element.value = step.value;\n            element.dispatchEvent(new Event('input', { bubbles: true }));\n            element.dispatchEvent(new Event('change', { bubbles: true }));\n            await settle();\n          } else if (step.assert === 'text_visible') {\n            const found = Array.from(document.body.querySelectorAll('*')).some((element) => visible(element) && text(element.textContent).includes(step.text));\n            if (!found) throw new Error('Visible text was not found: \"' + step.text + '\"');\n          } else if (step.assert === 'element_exists') {\n            if (!target(step.target)) throw new Error('Target \"' + step.target + '\" was not found');\n          } else if (step.assert === 'value_equals') {\n            const element = target(step.target);\n            if (!element || !('value' in element) || element.value !== step.value) throw new Error('Target \"' + step.target + '\" does not have the expected value');\n          }\n          if (runtimeFailure) throw new Error(runtimeFailure);\n        } catch (error) {\n          failure = 'Step ' + (index + 1) + ': ' + text(error instanceof Error ? error.message : error);\n          break;\n        }\n      }\n      scenarios.push({ id: scenario.id, name: scenario.name, status: failure ? 'failed' : 'passed', message: failure || 'Scenario passed' });\n    }\n    send('criteria', {\n      status: scenarios.some((scenario) => scenario.status === 'failed') ? 'failed' : 'passed',\n      scenarioCount: scenarios.length,\n      scenarios,\n    });\n  };\n  const loaded = () => {\n    send('ready', { readyState: document.readyState });\n    void runCriteria();\n    if (typeof requestAnimationFrame === 'function') requestAnimationFrame(() => requestAnimationFrame(runAcceptance));\n    else setTimeout(runAcceptance, 0);\n  };\n  if (document.readyState === 'complete') queueMicrotask(loaded);\n  else addEventListener('load', loaded, { once: true });\n})();";
 export declare const LOCAL_APP_RUNTIME_BRIDGE_HASH: string;
 export declare function injectLocalAppRuntimeBridge(html: string, acceptance?: LocalAppAcceptanceConfig): string;

package/dist/src/local-apps/preview-runtime-bridge.js

@@ -3,20 +3,20 @@ import { createHash } from "node:crypto";
 //#region src/local-apps/preview-runtime-bridge.ts
 const LOCAL_APP_RUNTIME_BRIDGE_SCRIPT = `(() => {
   let hostPort = null;
-  const pending = [];
+  const latest = new Map();
   const send = (type, detail) => {
     const message = { source: 'xopc-local-app-preview', version: 1, type, detail };
-    if (hostPort) hostPort.postMessage(message);
-    else pending.push(message);
+    latest.set(type, message);
+    hostPort?.postMessage(message);
   };
   const connect = (event) => {
     const message = event.data;
     if (event.source !== parent || message?.source !== 'xopc-local-app-host' || message?.version !== 1 || message?.type !== 'connect' || !event.ports[0]) return;
     event.stopImmediatePropagation();
-    removeEventListener('message', connect, true);
+    hostPort?.close();
     hostPort = event.ports[0];
     hostPort.start();
-    for (const queued of pending.splice(0)) hostPort.postMessage(queued);
+    for (const message of latest.values()) hostPort.postMessage(message);
   };
   addEventListener('message', connect, true);
   const text = (value) => String(value ?? '').slice(0, 500);
@@ -33,7 +33,10 @@ const LOCAL_APP_RUNTIME_BRIDGE_SCRIPT = `(() => {
   };
   const target = (id) => Array.from(document.querySelectorAll('[data-xopc-test-id]'))
     .find((element) => element.getAttribute('data-xopc-test-id') === id);
-  const pause = () => new Promise((resolve) => setTimeout(resolve, 50));
+  const settle = async () => {
+    await Promise.resolve();
+    await Promise.resolve();
+  };
   const readCriteria = () => {
     const encoded = document.querySelector('meta[name="xopc-local-app-acceptance"]')?.content;
     if (!encoded) return { schemaVersion: 1, scenarios: [] };
@@ -116,7 +119,7 @@ const LOCAL_APP_RUNTIME_BRIDGE_SCRIPT = `(() => {
             if (!(element instanceof HTMLElement)) throw new Error('Target "' + step.target + '" was not found');
             if ('disabled' in element && element.disabled || element.getAttribute('aria-disabled') === 'true') throw new Error('Target "' + step.target + '" is disabled');
             element.click();
-            await pause();
+            await settle();
           } else if (step.action === 'fill') {
             const element = target(step.target);
             if (!(element instanceof HTMLInputElement || element instanceof HTMLTextAreaElement || element instanceof HTMLSelectElement)) throw new Error('Target "' + step.target + '" cannot be filled');
@@ -126,7 +129,7 @@ const LOCAL_APP_RUNTIME_BRIDGE_SCRIPT = `(() => {
             else element.value = step.value;
             element.dispatchEvent(new Event('input', { bubbles: true }));
             element.dispatchEvent(new Event('change', { bubbles: true }));
-            await pause();
+            await settle();
           } else if (step.assert === 'text_visible') {
             const found = Array.from(document.body.querySelectorAll('*')).some((element) => visible(element) && text(element.textContent).includes(step.text));
             if (!found) throw new Error('Visible text was not found: "' + step.text + '"');
@@ -152,9 +155,9 @@ const LOCAL_APP_RUNTIME_BRIDGE_SCRIPT = `(() => {
   };
   const loaded = () => {
     send('ready', { readyState: document.readyState });
-    const run = () => { runAcceptance(); void runCriteria(); };
-    if (typeof requestAnimationFrame === 'function') requestAnimationFrame(() => requestAnimationFrame(run));
-    else setTimeout(run, 0);
+    void runCriteria();
+    if (typeof requestAnimationFrame === 'function') requestAnimationFrame(() => requestAnimationFrame(runAcceptance));
+    else setTimeout(runAcceptance, 0);
   };
   if (document.readyState === 'complete') queueMicrotask(loaded);
   else addEventListener('load', loaded, { once: true });

package/dist/src/proactive/insight-repository.d.ts

@@ -13,6 +13,8 @@ export declare function createProactiveInsight(input: {
     whyItMatters: string;
     nextAction: string;
     evidence: ProactiveEvidence[];
+    valueScore: number;
+    valueReasons: string[];
     nowMs?: number;
 }): ProactiveInsight | null;
 export declare function setProactiveInsightStatus(id: string, status: ProactiveInsightStatus, nowMs?: number, expectedStatus?: ProactiveInsightStatus): ProactiveInsight | null;

package/dist/src/proactive/insight-repository.js

@@ -14,6 +14,8 @@ function insightFromRow(row) {
 		nextAction: row.next_action,
 		evidence: JSON.parse(row.evidence_json),
 		status: row.status,
+		valueScore: row.value_score,
+		valueReasons: JSON.parse(row.value_reasons_json),
 		createdAt: row.created_at,
 		updatedAt: row.updated_at
 	};
@@ -58,8 +60,9 @@ function createProactiveInsight(input) {
 	runSqliteWriteTransaction((db) => {
 		created = db.prepare(`INSERT OR IGNORE INTO proactive_insights (
         insight_id, watch_id, run_id, kind, title, summary, why_it_matters,
-        next_action, evidence_json, content_hash, status, created_at, updated_at
-      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 'unread', ?, ?)`).run(id, input.watchId, input.runId, input.kind, input.title, input.summary, input.whyItMatters, input.nextAction, JSON.stringify(input.evidence), contentHash, now, now).changes > 0;
+        next_action, evidence_json, content_hash, status, value_score,
+        value_reasons_json, created_at, updated_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 'unread', ?, ?, ?, ?)`).run(id, input.watchId, input.runId, input.kind, input.title, input.summary, input.whyItMatters, input.nextAction, JSON.stringify(input.evidence), contentHash, input.valueScore, JSON.stringify(input.valueReasons), now, now).changes > 0;
 	});
 	return created ? listProactiveInsights({ limit: 100 }).find((item) => item.id === id) ?? null : null;
 }

package/dist/src/proactive/run-processor.js

@@ -1,7 +1,10 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
+import { getRelationshipSettings, isProactiveSupportAllowed } from "../storage/sqlite/relationship-settings-repository.js";
+import "../storage/sqlite/index.js";
 import { getFocusWatchByAutomationId, recordFocusWatchRun } from "./watch-repository.js";
-import { createProactiveInsight } from "./insight-repository.js";
+import { createProactiveInsight, listProactiveInsights } from "./insight-repository.js";
+import { scoreProactiveValue } from "./value-score.js";
 //#region src/proactive/run-processor.ts
 init_logger();
 const log = createLogger("ProactiveRunProcessor");
@@ -105,6 +108,22 @@ function processFocusAutomationRun(run) {
 		nowMs: run.endedAtMs
 	})) return { handled: true };
 	if (!result.meaningful) return { handled: true };
+	if (!isProactiveSupportAllowed(getRelationshipSettings(), {
+		now: new Date(run.endedAtMs),
+		topic: watch.kind
+	})) return { handled: true };
+	const history = listProactiveInsights({
+		status: ["approved", "dismissed"],
+		limit: 50
+	});
+	const value = scoreProactiveValue({
+		kind: watch.kind,
+		evidenceCount: result.evidence.length,
+		hasNextAction: Boolean(result.nextAction),
+		approvedCount: history.filter((item) => item.status === "approved").length,
+		dismissedCount: history.filter((item) => item.status === "dismissed").length
+	});
+	if (!value.shouldDeliver) return { handled: true };
 	const insight = createProactiveInsight({
 		watchId: watch.id,
 		runId: run.id,
@@ -114,6 +133,8 @@ function processFocusAutomationRun(run) {
 		whyItMatters: result.whyItMatters,
 		nextAction: result.nextAction,
 		evidence: result.evidence,
+		valueScore: value.score,
+		valueReasons: value.reasons,
 		nowMs: run.endedAtMs
 	});
 	return insight ? {

package/dist/src/proactive/types.d.ts

@@ -49,6 +49,8 @@ export interface ProactiveInsight {
     whyItMatters: string;
     nextAction: string;
     evidence: ProactiveEvidence[];
+    valueScore: number;
+    valueReasons: string[];
     status: ProactiveInsightStatus;
     createdAt: number;
     updatedAt: number;

package/dist/src/proactive/value-score.d.ts

@@ -0,0 +1,13 @@
+import type { FocusWatchKind } from './types.js';
+export interface ProactiveValueScore {
+    score: number;
+    reasons: string[];
+    shouldDeliver: boolean;
+}
+export declare function scoreProactiveValue(input: {
+    kind: FocusWatchKind;
+    evidenceCount: number;
+    hasNextAction: boolean;
+    approvedCount: number;
+    dismissedCount: number;
+}): ProactiveValueScore;

package/dist/src/proactive/value-score.js

@@ -0,0 +1,30 @@
+//#region src/proactive/value-score.ts
+function scoreProactiveValue(input) {
+	const reasons = [];
+	let score = .15;
+	if (input.evidenceCount > 0) {
+		score += Math.min(.25, input.evidenceCount * .1);
+		reasons.push("evidence_backed");
+	}
+	if (input.hasNextAction) {
+		score += .25;
+		reasons.push("actionable");
+	}
+	const urgency = input.kind === "deadline" ? .25 : input.kind === "staleness" ? .2 : .15;
+	score += urgency;
+	reasons.push(input.kind === "deadline" ? "time_sensitive" : "focus_relevant");
+	const rated = input.approvedCount + input.dismissedCount;
+	if (rated > 0) {
+		const approvalRate = input.approvedCount / rated;
+		score += (approvalRate - .5) * .4;
+		reasons.push(approvalRate >= .5 ? "historically_useful" : "historically_dismissed");
+	}
+	score = Math.max(0, Math.min(1, score));
+	return {
+		score,
+		reasons,
+		shouldDeliver: score >= .65
+	};
+}
+//#endregion
+export { scoreProactiveValue };

package/dist/src/share/share-types.js

@@ -3,9 +3,9 @@
 const SHARE_CONFIG_DEFAULTS = {
 	enabled: true,
 	defaultTtlMs: 864e5,
-	maxTtlMs: 6048e5,
-	maxActiveShares: 100,
-	maxFileSize: 104857600,
+	maxTtlMs: 2592e6,
+	maxActiveShares: 500,
+	maxFileSize: 524288e3,
 	inlinePreviewMimes: [
 		"image/png",
 		"image/jpeg",
@@ -20,8 +20,8 @@ const SHARE_CONFIG_DEFAULTS = {
 	],
 	directory: {
 		enabled: true,
-		maxFolderSize: 1073741824,
-		maxFileCount: 1e3,
+		maxFolderSize: 2147483648,
+		maxFileCount: 1e4,
 		maxDepth: 20,
 		listingCacheMs: 6e4,
 		zipConcurrency: 1

package/dist/src/share/site-share-types.d.ts

@@ -60,7 +60,7 @@ export interface CreateSiteShareParams {
     path?: string;
     /** Proxy: full upstream URL (must be loopback or whitelisted). */
     upstreamUrl?: string;
-    /** Default 6h. */
+    /** Default 24h. */
     ttlMs?: number;
     /** Optional friendly description. */
     description?: string;

package/dist/src/share/site-share-types.js

@@ -2,13 +2,13 @@
 const SITE_SHARE_CONFIG_DEFAULTS = {
 	enabled: true,
 	publicHostSuffix: "share.xopc.ai",
-	defaultTtlMs: 216e5,
-	maxTtlMs: 6048e5,
-	maxActiveSites: 5,
+	defaultTtlMs: 864e5,
+	maxTtlMs: 2592e6,
+	maxActiveSites: 50,
 	static: {
 		enabled: true,
-		maxRootDirSize: 524288e3,
-		maxFileCount: 1e4,
+		maxRootDirSize: 1073741824,
+		maxFileCount: 2e4,
 		rewriteEnabledByDefault: false
 	},
 	proxy: {

package/dist/src/storage/sqlite/index.d.ts

@@ -5,6 +5,9 @@ export { DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, } from './m
 export { discoverSqlMigrations, listRegisteredMigrationTargets } from './migrations/discover.js';
 export { closeXopcDatabase, getXopcDatabase, isXopcDatabaseOpen, openXopcDatabase, requireXopcDatabase, resetXopcDatabaseSingletonForTest, type OpenXopcDatabaseOptions, type XopcDatabase, } from './connection.js';
 export { getSqliteDatabase, runSqliteWriteTransaction } from './transaction.js';
+export { getInteractionState, setInteractionState, updateInteractionStateFromMessage, type InteractionState, } from './interaction-state-repository.js';
+export { buildRelationshipPrompt, getRelationshipSettings, isProactiveSupportAllowed, updateRelationshipSettings, type RelationshipSettings, type SupportMode, } from './relationship-settings-repository.js';
+export { completeTaskOutcome, findTaskOutcomeForAssistant, getTaskOutcome, listTaskOutcomes, setTaskOutcomeFeedback, startTaskOutcome, summarizeTaskOutcomes, updateTaskOutcome, type TaskContract, type TaskEvidence, type TaskFeedbackOutcome, type TaskOutcome, type TaskOutcomeMetrics, type TaskOutcomeStatus, } from './task-outcome-repository.js';
 export { buildDefaultSessionMetadata, type SessionMetadataSeed, } from './session-metadata.js';
 export { buildGlobalSessionStats, classifyStoredRow, estimateTokensFromMessages, extractFtsContent, metadataToSessionInsert, sessionConfigRowToConfig, sessionRowToMetadata, transcriptEntryRowToStoredRow, type SessionConfigRow, type SessionRow, type TranscriptEntryRow, } from './row-mappers.js';
 export { deleteSessionRecord, ensureSessionRecord, getCurrentSessionId, getGlobalSessionStats, findSessionKeyBySessionId, getSessionPersistedLevels, getSessionMetadata, incrementSessionStatsOnAppend, listSessionMetadata, listSessionsByAgent, patchSessionMetadata, resetSessionRecord, resolveSessionAgentId, updateSessionStats, } from './session-repository.js';

package/dist/src/storage/sqlite/index.js

@@ -6,6 +6,9 @@ import { XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_SCHEMA_VERSION, applyPendingMi
 import { ensureXopcDatabaseSchema } from "./schema.js";
 import { closeXopcDatabase, getXopcDatabase, isXopcDatabaseOpen, openXopcDatabase, requireXopcDatabase, resetXopcDatabaseSingletonForTest } from "./connection.js";
 import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
+import { getInteractionState, setInteractionState, updateInteractionStateFromMessage } from "./interaction-state-repository.js";
+import { buildRelationshipPrompt, getRelationshipSettings, isProactiveSupportAllowed, updateRelationshipSettings } from "./relationship-settings-repository.js";
+import { completeTaskOutcome, findTaskOutcomeForAssistant, getTaskOutcome, listTaskOutcomes, setTaskOutcomeFeedback, startTaskOutcome, summarizeTaskOutcomes, updateTaskOutcome } from "./task-outcome-repository.js";
 import { buildDefaultSessionMetadata } from "./session-metadata.js";
 import { buildGlobalSessionStats, classifyStoredRow, estimateTokensFromMessages, extractFtsContent, metadataToSessionInsert, sessionConfigRowToConfig, sessionRowToMetadata, transcriptEntryRowToStoredRow } from "./row-mappers.js";
 import { deleteSessionRecord, ensureSessionRecord, findSessionKeyBySessionId, getCurrentSessionId, getGlobalSessionStats, getSessionMetadata, getSessionPersistedLevels, incrementSessionStatsOnAppend, listSessionMetadata, listSessionsByAgent, patchSessionMetadata, resetSessionRecord, resolveSessionAgentId, updateSessionStats } from "./session-repository.js";
@@ -21,4 +24,4 @@ import { appendConnectorExecutionAudit, claimConnectorWebhookDelivery, completeC
 import { getUserTrustPolicy, setUserTrustPolicy } from "./user-trust-repository.js";
 import { consumeMemoryReferenceConsent, decideMemoryReferenceConsent, ensureMemoryReferenceConsentRequest, hasMemoryReferenceConsent, listMemoryReferenceConsents, revokeMemoryReferenceConsent } from "./memory-reference-consent-repository.js";
 import { getUserProfilePromptState, setUserProfilePromptState } from "./user-profile-setup-repository.js";
-export { DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, SCHEMA_META_SCHEMA_VERSION_KEY, USER_UNDERSTANDING_REMEDIATION_POLICY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_FILENAME, XOPC_DB_SCHEMA_VERSION, appendConnectorExecutionAudit, appendMemorySignal, appendMemoryTraceEvent, appendTranscriptEntry, applyPendingMigrations, attachMemoryEvidence, buildDefaultSessionMetadata, buildGlobalSessionStats, captureCompactionCheckpoint, claimConnectorWebhookDelivery, claimKnowledgeSourceItems, classifyStoredRow, closeXopcDatabase, completeConnectorWebhookDelivery, completeKnowledgeSourceItemSynthesis, consumeConnectorApproval, consumeMemoryReferenceConsent, createConnectorApproval, createObjectLinkRecord, decideConnectorApproval, decideMemoryReferenceConsent, deleteConnectorConnection, deleteConnectorInstallation, deleteMemoryEvidenceForRecord, deleteMemoryRecord, deleteNoteAgentContextRecord, deleteNoteRecord, deleteSessionConfig, deleteSessionRecord, discoverSqlMigrations, ensureMemoryReferenceConsentRequest, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, findLatestMemoryInjectTrace, findSessionKeyBySessionId, finishKnowledgeSyncRun, getActivityEventRecord, getCachedConnectorCatalogEntry, getCompactionCheckpointDetail, getConnectorApproval, getConnectorConnection, getConnectorInstallation, getCurrentSessionId, getGlobalSessionStats, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, getMemoryProviderState, getMemoryRecord, getNoteAgentContextRecord, getNoteRecord, getSessionConfig, getSessionMetadata, getSessionPersistedLevels, getSqliteDatabase, getUserProfilePromptState, getUserTrustPolicy, getXopcDatabase, hasMemoryReferenceConsent, hasSessionConfig, hasUnresolvedMemoryConflict, incrementSessionStatsOnAppend, inspectSchemaMigrationStatus, isXopcDatabaseOpen, listActivityRecords, listCachedConnectorCatalogEntries, listCompactionCheckpoints, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, listMemoryRecords, listMemoryReferenceConsents, listMemorySignals, listMemoryTraceEvents, listNoteRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, loadCheckpointRows, loadLlmMessagesForSession, loadTranscriptRows, loadTranscriptRowsForSession, markMemoryRecordsConflicted, metadataToSessionInsert, openXopcDatabase, paginateTranscriptMessages, patchSessionMetadata, readSchemaVersion, readSchemaVersionForTest, recordActivityEvent, releaseConnectorWebhookDelivery, replaceConnectorCatalogEntries, replaceTranscriptRows, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreCompactionCheckpoint, revokeMemoryReferenceConsent, runSqliteWriteTransaction, searchMemoryIndex, searchMemoryRecords, sessionConfigRowToConfig, sessionRowToMetadata, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, setLatestMemoryInjectFeedback, setMemoryProviderState, setMemoryTraceFeedback, setSessionConfig, setUserProfilePromptState, setUserTrustPolicy, startKnowledgeSyncRun, summarizeMemoryRecallFeedback, summarizeUserUnderstandingQuality, syncMemoryIndex, transcriptEntryRowToStoredRow, updateSessionConfig, updateSessionStats, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation, upsertKnowledgeSourceItems, upsertMemoryRecord, upsertNoteAgentContextRecord, upsertNoteRecord };
+export { DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, SCHEMA_META_SCHEMA_VERSION_KEY, USER_UNDERSTANDING_REMEDIATION_POLICY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_FILENAME, XOPC_DB_SCHEMA_VERSION, appendConnectorExecutionAudit, appendMemorySignal, appendMemoryTraceEvent, appendTranscriptEntry, applyPendingMigrations, attachMemoryEvidence, buildDefaultSessionMetadata, buildGlobalSessionStats, buildRelationshipPrompt, captureCompactionCheckpoint, claimConnectorWebhookDelivery, claimKnowledgeSourceItems, classifyStoredRow, closeXopcDatabase, completeConnectorWebhookDelivery, completeKnowledgeSourceItemSynthesis, completeTaskOutcome, consumeConnectorApproval, consumeMemoryReferenceConsent, createConnectorApproval, createObjectLinkRecord, decideConnectorApproval, decideMemoryReferenceConsent, deleteConnectorConnection, deleteConnectorInstallation, deleteMemoryEvidenceForRecord, deleteMemoryRecord, deleteNoteAgentContextRecord, deleteNoteRecord, deleteSessionConfig, deleteSessionRecord, discoverSqlMigrations, ensureMemoryReferenceConsentRequest, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, findLatestMemoryInjectTrace, findSessionKeyBySessionId, findTaskOutcomeForAssistant, finishKnowledgeSyncRun, getActivityEventRecord, getCachedConnectorCatalogEntry, getCompactionCheckpointDetail, getConnectorApproval, getConnectorConnection, getConnectorInstallation, getCurrentSessionId, getGlobalSessionStats, getInteractionState, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, getMemoryProviderState, getMemoryRecord, getNoteAgentContextRecord, getNoteRecord, getRelationshipSettings, getSessionConfig, getSessionMetadata, getSessionPersistedLevels, getSqliteDatabase, getTaskOutcome, getUserProfilePromptState, getUserTrustPolicy, getXopcDatabase, hasMemoryReferenceConsent, hasSessionConfig, hasUnresolvedMemoryConflict, incrementSessionStatsOnAppend, inspectSchemaMigrationStatus, isProactiveSupportAllowed, isXopcDatabaseOpen, listActivityRecords, listCachedConnectorCatalogEntries, listCompactionCheckpoints, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, listMemoryRecords, listMemoryReferenceConsents, listMemorySignals, listMemoryTraceEvents, listNoteRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, listTaskOutcomes, loadCheckpointRows, loadLlmMessagesForSession, loadTranscriptRows, loadTranscriptRowsForSession, markMemoryRecordsConflicted, metadataToSessionInsert, openXopcDatabase, paginateTranscriptMessages, patchSessionMetadata, readSchemaVersion, readSchemaVersionForTest, recordActivityEvent, releaseConnectorWebhookDelivery, replaceConnectorCatalogEntries, replaceTranscriptRows, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreCompactionCheckpoint, revokeMemoryReferenceConsent, runSqliteWriteTransaction, searchMemoryIndex, searchMemoryRecords, sessionConfigRowToConfig, sessionRowToMetadata, setInteractionState, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, setLatestMemoryInjectFeedback, setMemoryProviderState, setMemoryTraceFeedback, setSessionConfig, setTaskOutcomeFeedback, setUserProfilePromptState, setUserTrustPolicy, startKnowledgeSyncRun, startTaskOutcome, summarizeMemoryRecallFeedback, summarizeTaskOutcomes, summarizeUserUnderstandingQuality, syncMemoryIndex, transcriptEntryRowToStoredRow, updateInteractionStateFromMessage, updateRelationshipSettings, updateSessionConfig, updateSessionStats, updateTaskOutcome, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation, upsertKnowledgeSourceItems, upsertMemoryRecord, upsertNoteAgentContextRecord, upsertNoteRecord };

package/dist/src/storage/sqlite/interaction-state-repository.d.ts

@@ -0,0 +1,17 @@
+import { type InteractionStateSignal } from '../../user-context/interaction-state.js';
+export interface InteractionState extends InteractionStateSignal {
+    sessionKey: string;
+    expiresAt: number;
+    updatedAt: number;
+}
+export declare function getInteractionState(sessionKey: string, now?: number): InteractionState | undefined;
+export declare function setInteractionState(input: {
+    sessionKey: string;
+    signal: InteractionStateSignal;
+    now?: number;
+}): InteractionState;
+export declare function updateInteractionStateFromMessage(input: {
+    sessionKey: string;
+    message: string;
+    now?: number;
+}): InteractionState;

package/dist/src/storage/sqlite/interaction-state-repository.js

@@ -0,0 +1,60 @@
+import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
+import { inferInteractionState } from "../../user-context/interaction-state.js";
+//#region src/storage/sqlite/interaction-state-repository.ts
+const STATE_TTL_MS = 360 * 60 * 1e3;
+function fromRow(row) {
+	return {
+		sessionKey: row.session_key,
+		supportNeed: row.support_need,
+		...row.emotion_hypothesis ? { emotionHypothesis: row.emotion_hypothesis } : {},
+		confidence: row.confidence,
+		source: row.source,
+		repairStatus: row.repair_status,
+		...row.repair_reason ? { repairReason: row.repair_reason } : {},
+		expiresAt: row.expires_at,
+		updatedAt: row.updated_at
+	};
+}
+function getInteractionState(sessionKey, now = Date.now()) {
+	const row = getSqliteDatabase().prepare(`SELECT session_key, support_need, emotion_hypothesis, confidence, source,
+            repair_status, repair_reason, expires_at, updated_at
+     FROM interaction_states WHERE session_key = ? AND expires_at > ?`).get(sessionKey, now);
+	return row ? fromRow(row) : void 0;
+}
+function setInteractionState(input) {
+	const now = input.now ?? Date.now();
+	const expiresAt = now + STATE_TTL_MS;
+	runSqliteWriteTransaction((db) => {
+		db.prepare(`INSERT INTO interaction_states (
+        session_key, support_need, emotion_hypothesis, confidence, source,
+        repair_status, repair_reason, expires_at, updated_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+      ON CONFLICT(session_key) DO UPDATE SET
+        support_need = excluded.support_need,
+        emotion_hypothesis = excluded.emotion_hypothesis,
+        confidence = excluded.confidence,
+        source = excluded.source,
+        repair_status = excluded.repair_status,
+        repair_reason = excluded.repair_reason,
+        expires_at = excluded.expires_at,
+        updated_at = excluded.updated_at`).run(input.sessionKey, input.signal.supportNeed, input.signal.emotionHypothesis ?? null, input.signal.confidence, input.signal.source, input.signal.repairStatus, input.signal.repairReason ?? null, expiresAt, now);
+	});
+	return getInteractionState(input.sessionKey, now);
+}
+function updateInteractionStateFromMessage(input) {
+	const now = input.now ?? Date.now();
+	const previous = getInteractionState(input.sessionKey, now);
+	const inferred = inferInteractionState(input.message);
+	const signal = previous?.repairStatus === "needed" && inferred.repairStatus === "none" ? {
+		...inferred,
+		repairStatus: "needed",
+		repairReason: previous.repairReason
+	} : inferred;
+	return setInteractionState({
+		sessionKey: input.sessionKey,
+		signal,
+		now
+	});
+}
+//#endregion
+export { getInteractionState, setInteractionState, updateInteractionStateFromMessage };

package/dist/src/storage/sqlite/memory-records-repository.js

@@ -1,6 +1,6 @@
 import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
-import { buildFts5SearchQuery, fts5RankToScore, memoryLexicalSimilarity } from "./fts.js";
 import { LOCAL_USER_ID } from "../../user-context/owner.js";
+import { buildFts5SearchQuery, fts5RankToScore, memoryLexicalSimilarity } from "./fts.js";
 import { randomUUID } from "node:crypto";
 //#region src/storage/sqlite/memory-records-repository.ts
 const USER_UNDERSTANDING_REMEDIATION_POLICY = {

package/dist/src/storage/sqlite/migrations/053_browser_recipes.sql

@@ -0,0 +1,45 @@
+CREATE TABLE IF NOT EXISTS browser_recipes (
+  recipe_id TEXT PRIMARY KEY,
+  revision INTEGER NOT NULL,
+  name TEXT NOT NULL,
+  description TEXT,
+  status TEXT NOT NULL CHECK (status IN ('published', 'disabled')),
+  yaml_source TEXT NOT NULL,
+  risk_level TEXT NOT NULL CHECK (risk_level IN ('read_only', 'account_write', 'sensitive')),
+  domains_json TEXT NOT NULL,
+  created_at_ms INTEGER NOT NULL,
+  updated_at_ms INTEGER NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS browser_recipe_runs (
+  run_id TEXT PRIMARY KEY,
+  recipe_id TEXT NOT NULL,
+  recipe_revision INTEGER NOT NULL,
+  recipe_yaml TEXT NOT NULL,
+  status TEXT NOT NULL CHECK (status IN ('queued', 'running', 'succeeded', 'failed', 'cancelled')),
+  args_json TEXT NOT NULL,
+  result_json TEXT,
+  error TEXT,
+  created_at_ms INTEGER NOT NULL,
+  started_at_ms INTEGER,
+  ended_at_ms INTEGER,
+  duration_ms INTEGER,
+  FOREIGN KEY (recipe_id) REFERENCES browser_recipes(recipe_id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_browser_recipe_runs_recipe_created
+  ON browser_recipe_runs(recipe_id, created_at_ms DESC);
+
+CREATE TABLE IF NOT EXISTS browser_recipe_run_events (
+  event_id TEXT PRIMARY KEY,
+  run_id TEXT NOT NULL,
+  seq INTEGER NOT NULL,
+  type TEXT NOT NULL,
+  data_json TEXT,
+  created_at_ms INTEGER NOT NULL,
+  UNIQUE(run_id, seq),
+  FOREIGN KEY (run_id) REFERENCES browser_recipe_runs(run_id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_browser_recipe_run_events_run_seq
+  ON browser_recipe_run_events(run_id, seq ASC);

package/dist/src/storage/sqlite/migrations/054_task_outcomes.sql

@@ -0,0 +1,24 @@
+CREATE TABLE task_outcomes (
+  run_id TEXT PRIMARY KEY,
+  session_key TEXT NOT NULL,
+  channel TEXT NOT NULL,
+  objective TEXT NOT NULL,
+  status TEXT NOT NULL CHECK (status IN ('running', 'succeeded', 'failed', 'cancelled')),
+  summary TEXT,
+  contract_json TEXT,
+  evidence_json TEXT NOT NULL DEFAULT '[]',
+  feedback_outcome TEXT CHECK (feedback_outcome IN ('helpful', 'not_helpful')),
+  feedback_reason TEXT,
+  needs_correction INTEGER CHECK (needs_correction IN (0, 1)),
+  support_fit INTEGER CHECK (support_fit IN (0, 1)),
+  started_at INTEGER NOT NULL,
+  completed_at INTEGER,
+  updated_at INTEGER NOT NULL,
+  FOREIGN KEY (session_key) REFERENCES sessions(session_key) ON DELETE CASCADE
+);
+
+CREATE INDEX idx_task_outcomes_session_started
+  ON task_outcomes(session_key, started_at DESC);
+
+CREATE INDEX idx_task_outcomes_status_started
+  ON task_outcomes(status, started_at DESC);

package/dist/src/storage/sqlite/migrations/055_relationship_settings.sql

@@ -0,0 +1,14 @@
+CREATE TABLE relationship_settings (
+  owner_id TEXT PRIMARY KEY CHECK (owner_id = 'local-owner'),
+  support_mode TEXT NOT NULL CHECK (support_mode IN ('efficient', 'coach', 'companion', 'auto')),
+  proactive_enabled INTEGER NOT NULL CHECK (proactive_enabled IN (0, 1)),
+  quiet_start TEXT,
+  quiet_end TEXT,
+  allowed_topics_json TEXT NOT NULL,
+  blocked_topics_json TEXT NOT NULL,
+  updated_at INTEGER NOT NULL
+);
+
+INSERT INTO relationship_settings (
+  owner_id, support_mode, proactive_enabled, allowed_topics_json, blocked_topics_json, updated_at
+) VALUES ('local-owner', 'auto', 0, '[]', '[]', unixepoch() * 1000);

package/dist/src/storage/sqlite/migrations/056_task_verification.sql

@@ -0,0 +1,6 @@
+ALTER TABLE task_outcomes ADD COLUMN verification_status TEXT NOT NULL DEFAULT 'unverified'
+  CHECK (verification_status IN ('passed', 'failed', 'unverified'));
+ALTER TABLE task_outcomes ADD COLUMN verification_json TEXT NOT NULL DEFAULT '{"checks":[]}';
+ALTER TABLE task_outcomes ADD COLUMN failure_code TEXT;
+ALTER TABLE task_outcomes ADD COLUMN failure_phase TEXT;
+ALTER TABLE task_outcomes ADD COLUMN recovery_action TEXT;

package/dist/src/storage/sqlite/migrations/057_interaction_states.sql

@@ -0,0 +1,11 @@
+CREATE TABLE interaction_states (
+  session_key TEXT PRIMARY KEY REFERENCES sessions(session_key) ON DELETE CASCADE,
+  support_need TEXT NOT NULL CHECK (support_need IN ('listen', 'clarify', 'advise', 'act', 'unknown')),
+  emotion_hypothesis TEXT,
+  confidence REAL NOT NULL CHECK (confidence >= 0 AND confidence <= 1),
+  source TEXT NOT NULL CHECK (source IN ('explicit', 'inferred')),
+  repair_status TEXT NOT NULL CHECK (repair_status IN ('none', 'needed', 'repaired')),
+  repair_reason TEXT,
+  expires_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL
+);

package/dist/src/storage/sqlite/migrations/058_proactive_value.sql

@@ -0,0 +1,3 @@
+ALTER TABLE proactive_insights ADD COLUMN value_score REAL NOT NULL DEFAULT 0
+  CHECK (value_score >= 0 AND value_score <= 1);
+ALTER TABLE proactive_insights ADD COLUMN value_reasons_json TEXT NOT NULL DEFAULT '[]';

package/dist/src/storage/sqlite/migrations/runner.d.ts

@@ -3,7 +3,7 @@ import type { ApplyMigrationsOptions } from './types.js';
 /** Baseline schema version applied from schema.sql on first open. */
 export declare const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;
 /** Latest schema version this release supports (increment when adding migrations). */
-export declare const XOPC_DB_SCHEMA_VERSION = 52;
+export declare const XOPC_DB_SCHEMA_VERSION = 58;
 export declare function resolveMigrationsDir(override?: string): string;
 /**
  * Apply sequential SQL migrations from (currentVersion + 1) through targetVersion.