@gakim-digital/dexter-bridge 0.11.23 → 0.11.24

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gakim-digital/dexter-bridge",
-  "version": "0.11.23",
+  "version": "0.11.24",
   "description": "Local bridge for InstaWebAI and Dexter — runs Codex, Claude Code, or OpenCode on your machine.",
   "type": "module",
   "bin": {

package/src/agent.js

@@ -2738,7 +2738,9 @@ async function executeOutcomeRun(run, send, agent, options = {}) {
       });
   let prompt = '';
   const successStatus = outcomeSuccessStatus(executionOutcome, product);
-  const schema = outcomeOutputSchema(successStatus);
+  const schema = outcomeOutputSchema(successStatus, {
+    reportsProjectChange: framerAgentOutcome,
+  });
   assertOutcomeResponseContract(
     STRUCTURED_RESPONSE_CONTRACTS.OUTCOME,
     schema,
@@ -2996,10 +2998,13 @@ async function executeOutcomeRun(run, send, agent, options = {}) {
     ) {
       synchronization = await harnessTools.synchronize();
     }
+    const unappliedChangePrompt =
+      rawCompletion.status === successStatus
+        ? harnessTools.unappliedChangePrompt?.(rawCompletion) || null
+        : null;
     const repairPrompt =
       rawCompletion.status === successStatus
-      && typeof harnessTools.verificationRepairPrompt === 'function'
-        ? harnessTools.verificationRepairPrompt()
+        ? harnessTools.verificationRepairPrompt?.() || unappliedChangePrompt
         : harnessTools.unblockedFailurePrompt?.(rawCompletion) || null;
     if (
       repairPrompt
@@ -3009,9 +3014,11 @@ async function executeOutcomeRun(run, send, agent, options = {}) {
         kind: 'status_update',
         source: 'harness',
         message:
-          rawCompletion.status === successStatus
-            ? 'I’m completing the final Framer verification before I finish.'
-            : 'Nothing is blocking this change, so I’m continuing the work.',
+          repairPrompt === unappliedChangePrompt
+            ? 'Nothing has changed in Framer yet, so I’m making the change 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/framerAgentTools.js

@@ -22,6 +22,8 @@ const MAX_MODEL_RESULT_BYTES = 120 * 1024;
 const MAX_CODE_FILE_CONTENT_CHARS = 200_000;
 const MAX_SVG_MARKUP_CHARS = 200_000;
 const MAX_SVG_ATTRIBUTES = 24;
+// Dexter reads this check name to record a claimed-but-unapplied change.
+export const UNAPPLIED_CHANGE_CHECK = 'Harness change check';
 const UNSAFE_SVG_PATTERN =
   /<\s*(?:script|foreignObject|iframe)\b|\son[a-z]+\s*=|javascript:|(?:xlink:)?href\s*=\s*["']\s*(?:[a-z][a-z0-9+.-]*:|\/\/)/i;
 const MUTATION_TOOL_NAMES = new Set([
@@ -2135,7 +2137,31 @@ export function createFramerAgentToolRuntime({
     };
   };
 
+  // The run claims a project change, yet no change was applied.
+  const claimsUnappliedChange = (completion) =>
+    completion?.status === 'completed'
+    && completion?.projectChanged === true
+    && mutationCalls === 0;
+
   const finalizeCompletion = (completion) => {
+    if (claimsUnappliedChange(completion)) {
+      return {
+        ...completion,
+        status: 'failed',
+        projectChanged: false,
+        summary:
+          'I didn’t change anything in Framer this time, even though I was about to say I had. Please try again, or select the element you want changed.',
+        checks: [
+          ...(Array.isArray(completion?.checks) ? completion.checks : []),
+          {
+            command: UNAPPLIED_CHANGE_CHECK,
+            status: 'failed',
+            output: 'The summary reported a project change, but this run applied none.',
+          },
+        ],
+        blockedReason: null,
+      };
+    }
     if (completion?.status !== 'completed' || mutationCalls === 0) {
       return completion;
     }
@@ -2175,6 +2201,19 @@ export function createFramerAgentToolRuntime({
     };
   };
 
+  // A summary must never describe a change the project did not receive. A
+  // run that claims one gets a single prompt to make the change or say what
+  // it could not find.
+  const unappliedChangePrompt = (completion) => {
+    if (!claimsUnappliedChange(completion)) return null;
+    return [
+      'Your summary says you changed the Framer project, but this run applied no change: nothing in the project is different yet.',
+      'Continue the same task: find every target the user meant, apply the change, verify it, then return the required JSON outcome.',
+      'Text on buttons, cards, and other components often lives in a component instance control, such as a label, rather than in a text layer; read the instances and their controls to find it.',
+      'If you cannot find or change a target, name it in the summary and set projectChanged to false. Never describe a change that was not applied.',
+    ].join(' ');
+  };
+
   // A model that reports failure without changing anything and without a
   // refused plan or edit gave up on its own. It gets one prompt to continue.
   const unblockedFailurePrompt = (completion) => {
@@ -3186,6 +3225,7 @@ export function createFramerAgentToolRuntime({
     inspect: inspectFinalState,
     finalizeCompletion,
     verificationRepairPrompt,
+    unappliedChangePrompt,
     unblockedFailurePrompt,
     sourceHash: () => null,
     hasPendingChanges: () => false,

package/src/protocol.js

@@ -497,8 +497,9 @@ export function buildFramerOutcomePrompt(outcome = {}, product, promptContext =
     'Dexter will not perform a second design verification after you finish. Structural verification must be described honestly and must never be called runtime-tested unless an interaction was actually exercised.',
     'If Framer authorization or a required user decision is missing, return blocked with a concise explanation. Otherwise return completed only after you have finished and verified the work.',
     'A greeting, thanks, or question that needs no project change is not blocked: answer it in summary without reading or editing the project and return completed.',
+    'Set projectChanged to true only when this run applied a change to the Framer project. The summary must describe only changes that were applied; if you could not find or change something, say so plainly instead.',
     'When finished, return exactly one JSON object and no markdown.',
-    '{"status":"completed|blocked|failed","summary":"one or two short, non-technical sentences for the designer","checks":[{"command":"what you verified","status":"passed|failed|skipped","output":"short result"}],"blockedReason":null}',
+    '{"status":"completed|blocked|failed","summary":"one or two short, non-technical sentences for the designer","checks":[{"command":"what you verified","status":"passed|failed|skipped","output":"short result"}],"blockedReason":null,"projectChanged":false}',
     doctrine
       ? `\nDexter design and execution doctrine (${String(promptContext.doctrineVersion || 'current')}):\n${doctrine}`
       : '',
@@ -588,8 +589,11 @@ export function buildOutcomePrompt(outcome = {}, product, promptContext = {}) {
   ].join('\n');
 }
 
-export function outcomeOutputSchema(successStatus = 'completed') {
-  return {
+export function outcomeOutputSchema(
+  successStatus = 'completed',
+  { reportsProjectChange = false } = {},
+) {
+  const schema = {
     type: 'object',
     properties: {
       status: {
@@ -621,6 +625,13 @@ export function outcomeOutputSchema(successStatus = 'completed') {
     required: ['status', 'summary', 'checks', 'blockedReason'],
     additionalProperties: false,
   };
+  // Framer runs say whether their summary reports a project change, so the
+  // harness can refuse a summary that claims a change nothing applied.
+  if (reportsProjectChange) {
+    schema.properties.projectChanged = { type: 'boolean' };
+    schema.required.push('projectChanged');
+  }
+  return schema;
 }
 
 export function normalizeOutcomeCompletion(
@@ -673,5 +684,6 @@ export function normalizeOutcomeCompletion(
         : null,
     synchronized: false,
     sourceHash: null,
+    ...(typeof raw.projectChanged === 'boolean' ? { projectChanged: raw.projectChanged } : {}),
   };
 }