@gakim-digital/dexter-bridge 0.11.13 → 0.11.15

package/README.md

@@ -47,18 +47,15 @@ Native shell, filesystem, web, and unrelated-project access are disabled for
 Framer outcome runs. Publishing is denied unless a future assignment explicitly
 authorizes it.
 
-Bridges advertise `framer-interaction-verification-v3`,
-`framer-behavior-contract-v1`, and `framer-mechanism-verification-v1` only
-when interaction work is declared as observable behavior, checked against the
-selected Framer mechanism before mutation, and verified from live canonical
-Framer nodes afterward. Verification is tri-state: `verified`,
-`contradicted`, or `unknown`. Unknown evidence cannot trigger a repair or
-reject a mechanism. Native navigation is verified from link and component
-control destinations instead of requiring synthetic frame events. Repeated
-behavior is verified on one declared representative target before the
-remaining targets are changed. Only a concrete contradiction may receive one
-scoped `SET` repair. Repeated unchanged evidence is bounded and exits as a
-partial result rather than looping.
+Bridges advertise `framer-interaction-verification-v4`. Dexter does not model
+Framer's interaction features: the model builds behaviors with any capability
+the Framer guidance documents, declares each behavior with the nodes that
+should carry it, and then names the Framer property that carries it on each
+node (for example `loopEffect` or `link`). The bridge confirms that property on
+the live node. Results are `verified`, `contradicted` (the value differs), or
+`unknown` (the property was not found). Unknown never blocks edits and is
+reported as unverified; an unchecked target or a contradiction leaves the run
+incomplete.
 
 Project connection is handled inside Dexter and completes before the model
 starts:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gakim-digital/dexter-bridge",
-  "version": "0.11.13",
+  "version": "0.11.15",
   "description": "Local bridge for InstaWebAI and Dexter — runs Codex, Claude Code, or OpenCode on your machine.",
   "type": "module",
   "bin": {
@@ -39,12 +39,13 @@
     "@ai-sdk/openai-compatible": "^3.0.41",
     "@ai-sdk/xai": "^4.0.50",
     "@anthropic-ai/claude-agent-sdk": "^0.2.73",
-    "@framer/agent": "0.0.44",
+    "@framer/agent": "0.0.46",
     "@modelcontextprotocol/sdk": "^1.30.0",
     "@opencode-ai/sdk": "^1.18.25",
     "@openrouter/ai-sdk-provider": "^3.0.0",
     "ai": "^7.0.85",
     "cross-spawn": "^7.0.6",
+    "js-tokens": "^10.0.0",
     "jsonrepair": "^3.15.0",
     "zod": "^4.5.4"
   }

package/src/agent.js

@@ -51,6 +51,7 @@ import { createLocalAgentAdapter } from './providers/index.js';
 import { discoverClaudeCodeModels } from './providers/claudeAgentSdk.js';
 import {
   collectOutcomeWorkspaceChanges,
+  materializeModelTurnImages,
   materializeOutcomeReferenceAssets,
   materializeOutcomeWorkspace,
   removeOutcomeReferenceAssets,
@@ -1829,6 +1830,15 @@ function agentErrorWithOutputUsage(agent, error) {
 }
 
 async function executeModelTurnRun(run, send, agent, options = {}) {
+  const images = materializeModelTurnImages(run?.modelTurn?.messages);
+  try {
+    return await executeModelTurn(run, send, agent, { ...options, imageFiles: images.files });
+  } finally {
+    images.remove();
+  }
+}
+
+async function executeModelTurn(run, send, agent, options = {}) {
   const product = normalizeBridgeProduct(run?.product || options.product);
   const productName = product.name;
   if (normalizeAgentName(agent) === 'dry-run' && !options.providerAdapter) {
@@ -1954,6 +1964,7 @@ async function executeModelTurnRun(run, send, agent, options = {}) {
         1000,
       ),
       nativeSkills,
+      imageFiles: options.imageFiles,
     };
     const adapterOptions = {
       send,
@@ -2568,27 +2579,36 @@ async function executeOutcomeRun(run, send, agent, options = {}) {
   let providerAttempts = 0;
   let result;
   try {
-    if (framerAgentOutcome) {
-      await Promise.race([harnessTools.preflight(), cancellation]);
-    }
+    const preflight = framerAgentOutcome
+      ? await Promise.race([harnessTools.preflight(), cancellation])
+      : null;
     const framerGuidance = framerAgentOutcome
       ? await Promise.race([
           harnessTools.loadProjectGuidance(),
           cancellation,
         ])
       : null;
-    harnessTools.configurePromptContext?.({
-      doctrineLoaded: Boolean(run?.doctrine),
-      doctrineVersion: run?.doctrineVersion,
-    });
     prompt = buildOutcomePrompt(executionOutcome, product, {
       doctrine: run?.doctrine,
       doctrineVersion: run?.doctrineVersion,
       framerGuidance: framerGuidance?.content,
     });
+    const unresolvedTargets = preflight?.unresolvedTargets || [];
+    if (unresolvedTargets.length > 0) {
+      prompt = [
+        prompt,
+        '',
+        `These selected layer IDs do not resolve to native nodes on the active page: ${unresolvedTargets.map((target) => target.id).join(', ')}. The user still means those layers. Locate them by name and position in the provided context and the live tree, treat the matching native nodes as the selection, and ask only if no layer clearly matches.`,
+      ].join('\n');
+    }
     if (materializedNativeSkills) {
       prompt = claudeNativeSkillPrompt(prompt, materializedNativeSkills);
     }
+    harnessTools.configurePromptContext?.({
+      doctrineLoaded: Boolean(run?.doctrine),
+      doctrineVersion: run?.doctrineVersion,
+      promptBytes: Buffer.byteLength(prompt, 'utf8'),
+    });
     const gateway =
       definition.id === 'codex' ? null : await harnessTools.startGateway();
     const mcpServer = gateway
@@ -2785,7 +2805,7 @@ async function executeOutcomeRun(run, send, agent, options = {}) {
       rawCompletion.status === successStatus
       && typeof harnessTools.verificationRepairPrompt === 'function'
         ? harnessTools.verificationRepairPrompt()
-        : null;
+        : harnessTools.unblockedFailurePrompt?.(rawCompletion) || null;
     if (
       repairPrompt
       && Date.now() - callStartedAt < outcomeMaxDurationMs - 5_000
@@ -2794,7 +2814,9 @@ async function executeOutcomeRun(run, send, agent, options = {}) {
         kind: 'status_update',
         source: 'harness',
         message:
-          'I’m completing the final Framer verification before I finish.',
+          rawCompletion.status === successStatus
+            ? 'I’m completing the final Framer verification before I finish.'
+            : 'Nothing is blocking this change, so I’m continuing the work.',
       });
       const repairResult = await Promise.race([
         executeProviderOutcome(

package/src/cli.js

@@ -232,13 +232,63 @@ function isInvalidPairingError(error) {
   return isCompanionPairingInvalidError(error);
 }
 
-function clearInvalidPairing(configDir, cause) {
-  const product = normalizeBridgeProduct(readConfig(configDir).product);
-  saveConfigPatch({
-    deviceToken: null,
-    device: null,
-    pairedAt: null,
-  }, configDir);
+const HOMEBREW_FORMULA = 'gakim-digital/tap/dexter-bridge';
+const SELF_UPDATE_INTERVAL_MS = 60 * 60 * 1000;
+const PAIRING_WAIT_POLL_MS = 5000;
+
+// The Homebrew background service must recover on its own: the user never sees
+// its terminal, so exiting would leave Dexter silently offline.
+function runsAsBackgroundService() {
+  return process.env.DEXTER_BRIDGE_INSTALL_METHOD === 'homebrew' && !process.stdin.isTTY;
+}
+
+function isUpdateRequiredError(error) {
+  return error?.status === 426 || error?.body?.code === 'FRAMER_COMPANION_UPDATE_REQUIRED';
+}
+
+function runCommand(command, args) {
+  return new Promise((resolve) => {
+    const child = spawn(command, args, { stdio: 'inherit' });
+    child.on('error', () => resolve(false));
+    child.on('exit', (code) => resolve(code === 0));
+  });
+}
+
+// Upgrades the Homebrew install at most once an hour. On success the process
+// exits non-zero so launchd restarts the service on the new version.
+async function selfUpdateWithHomebrew(configDir, logger) {
+  const lastAttempt = Date.parse(readConfig(configDir).lastSelfUpdateAt || '');
+  if (Number.isFinite(lastAttempt) && Date.now() - lastAttempt < SELF_UPDATE_INTERVAL_MS) return;
+  saveConfigPatch({ lastSelfUpdateAt: new Date().toISOString() }, configDir);
+  console.log('A newer Dexter Bridge is required. Updating with Homebrew...');
+  const updated = await runCommand('brew', ['upgrade', HOMEBREW_FORMULA]);
+  logger.info('self_update_finished', { updated });
+  if (!updated) return;
+  const restart = new Error('Dexter Bridge updated. Restarting on the new version.');
+  restart.exitCode = 75;
+  throw restart;
+}
+
+async function waitForPairing(configDir) {
+  console.log('Waiting for a new pairing from Dexter...');
+  while (true) {
+    const token = readConfig(configDir).deviceToken;
+    if (token) return token;
+    await wait(PAIRING_WAIT_POLL_MS);
+  }
+}
+
+function clearInvalidPairing(configDir, cause, rejectedToken) {
+  const current = readConfig(configDir);
+  const product = normalizeBridgeProduct(current.product);
+  // Another bridge command may have just saved a fresh pairing; keep it.
+  if (!rejectedToken || current.deviceToken === rejectedToken) {
+    saveConfigPatch({
+      deviceToken: null,
+      device: null,
+      pairedAt: null,
+    }, configDir);
+  }
   const error = new Error(
     `This ${product.name} Bridge pairing was disconnected. Reopen ${product.name} and run the new pairing command.`,
     { cause },
@@ -534,14 +584,19 @@ async function startCommand({ apiBaseUrl, config, flags, configDir }) {
   let deviceToken = config.deviceToken;
   if (!deviceToken) {
     // First run: pair interactively so `npx @gakim-digital/dexter-bridge` alone is
-    if (!process.stdin.isTTY) requireDeviceToken(config);
-    console.log('This local agent bridge is not paired yet.');
-    console.log('Open the product connection screen and generate a new bridge command.');
-    const code = await promptForPairingCode();
-    if (!code) requireDeviceToken(config);
-    await pairCommand({ apiBaseUrl, args: [code], flags, configDir });
-    activeConfig = readConfig(configDir);
-    deviceToken = activeConfig.deviceToken;
+    if (runsAsBackgroundService()) {
+      deviceToken = await waitForPairing(configDir);
+      activeConfig = readConfig(configDir);
+    } else {
+      if (!process.stdin.isTTY) requireDeviceToken(config);
+      console.log('This local agent bridge is not paired yet.');
+      console.log('Open the product connection screen and generate a new bridge command.');
+      const code = await promptForPairingCode();
+      if (!code) requireDeviceToken(config);
+      await pairCommand({ apiBaseUrl, args: [code], flags, configDir });
+      activeConfig = readConfig(configDir);
+      deviceToken = activeConfig.deviceToken;
+    }
   }
   const product = normalizeBridgeProduct(activeConfig.product);
   const runtimeSelection = requestedRuntime(flags, activeConfig);
@@ -651,9 +706,22 @@ async function startCommand({ apiBaseUrl, config, flags, configDir }) {
             status: error.status,
             code: error.body?.code || null,
           });
-          const disconnected = clearInvalidPairing(configDir, error);
+          const savedToken = readConfig(configDir).deviceToken;
+          if (savedToken && savedToken !== deviceToken) {
+            // Re-paired by another bridge command; adopt the new pairing.
+            deviceToken = savedToken;
+            pollFailureCount = 0;
+            continue;
+          }
+          const disconnected = clearInvalidPairing(configDir, error, deviceToken);
           console.log(disconnected.message);
-          return;
+          if (!runsAsBackgroundService()) return;
+          deviceToken = await waitForPairing(configDir);
+          pollFailureCount = 0;
+          continue;
+        }
+        if (isUpdateRequiredError(error) && runsAsBackgroundService()) {
+          await selfUpdateWithHomebrew(configDir, pollLogger);
         }
         if (once) throw error;
         pollFailureCount += 1;

package/src/config.js

@@ -43,9 +43,7 @@ export const BRIDGE_CAPABILITIES = [
   'framer-agent-v1',
   'framer-project-bootstrap-v1',
   'framer-project-verification-v1',
-  'framer-interaction-verification-v3',
-  'framer-behavior-contract-v1',
-  'framer-mechanism-verification-v1',
+  'framer-interaction-verification-v4',
   'project-shell-v1',
   'build-fingerprint-v1',
   'tool-schema-parity-v1',