ue-mcp 1.2.3 → 1.3.0

package/dist/python-gate.js

@@ -0,0 +1,175 @@
+/**
+ * The execute_python gate: matching a caller's rulings against the candidate
+ * actions a tool search returned (#960, #938).
+ *
+ * The gate is the front door to this project's feedback pipeline. Every Python
+ * escape hatch is a recorded gap, and the record only exists if the agent gets
+ * through the gate and runs the code. Two separate reporters found that it
+ * could not be satisfied at all, for two different reasons:
+ *
+ *  1. The refusal printed the qualified spelling, `editor(invoke_function)`,
+ *     and then matched what came back against the bare `invoke_function`.
+ *     Passing back exactly the strings the tool had just printed did not
+ *     satisfy it. Matching is now spelling-insensitive: bare, `tool(action)`
+ *     and `tool.action` all resolve to the same key.
+ *
+ *  2. The candidate set is recomputed from the taskSummary on every call, so
+ *     rewording the summary swapped in candidates that then had to be ruled out
+ *     as well. One reporter needed five re-justifications for one unchanged
+ *     intent. Accepted rulings are now remembered for the session, so a reword
+ *     can only ever add the candidates that are genuinely new, and the refusal
+ *     hands back the exact `ruledOut` array to send.
+ *
+ * A reason shorter than MIN_REASON_LENGTH used to be dropped in silence, which
+ * left the caller re-sending an entry the gate had thrown away without saying
+ * so. Those are now reported back by name.
+ */
+import { workaroundScope } from "./workaround-tracker.js";
+/** A ruling has to say something. Twelve characters is the long-standing bar. */
+export const MIN_REASON_LENGTH = 12;
+/** How many rulings one session remembers. Oldest are dropped first. */
+const RULING_HISTORY = 64;
+/**
+ * Reduce any spelling of an action reference to the bare action name.
+ *
+ * Accepted: `invoke_function`, `editor(invoke_function)`, `editor.invoke_function`,
+ * `editor:invoke_function`, `editor/invoke_function`, with any surrounding
+ * whitespace and in any case. Deliberately liberal: this is a gate that has to
+ * be passable, and an agent that names the right action in the wrong shape has
+ * done the thinking the gate exists to force.
+ */
+export function ruledOutKey(raw) {
+    let s = String(raw ?? "").trim().toLowerCase();
+    if (!s)
+        return "";
+    // tool(action) - keep what is inside the parentheses.
+    const call = /^[^()]*\(\s*([^()]*?)\s*\)$/.exec(s);
+    if (call)
+        s = call[1].trim();
+    // tool.action / tool:action / tool/action - keep the last segment.
+    const cut = Math.max(s.lastIndexOf("."), s.lastIndexOf(":"), s.lastIndexOf("/"));
+    if (cut >= 0)
+        s = s.slice(cut + 1);
+    return s.trim();
+}
+/** Every spelling of a candidate the gate will print, for a copy-paste answer. */
+export function candidateSpellings(c) {
+    return [c.action, `${c.tool}(${c.action})`, `${c.tool}.${c.action}`];
+}
+/** Read the caller's `ruledOut` parameter, separating what counts from what does not. */
+export function parseRulings(raw) {
+    const accepted = new Map();
+    const rejected = [];
+    if (!Array.isArray(raw))
+        return { accepted, rejected };
+    for (const item of raw) {
+        // A bare string is a common spelling. It carries no reason, so it cannot
+        // pass, but saying so beats ignoring it.
+        if (typeof item === "string") {
+            rejected.push({
+                entry: item,
+                why: `no reason given - send {action: "${item}", reason: "<why it does not fit>"}`,
+            });
+            continue;
+        }
+        const record = (item ?? {});
+        const label = String(record.action ?? record.tool ?? "").trim();
+        const key = ruledOutKey(label);
+        const reason = String(record.reason ?? "").trim();
+        if (!key) {
+            rejected.push({ entry: label || JSON.stringify(item), why: "no 'action' named" });
+            continue;
+        }
+        if (reason.length < MIN_REASON_LENGTH) {
+            rejected.push({
+                entry: label,
+                why: `reason is ${reason.length} characters, at least ${MIN_REASON_LENGTH} are required`,
+            });
+            continue;
+        }
+        accepted.set(key, reason);
+    }
+    return { accepted, rejected };
+}
+// ── Session-scoped memory ──────────────────────────────────────────────────────
+// Keyed the same way the workaround stack is, so one editor's rulings never
+// answer for another's.
+const remembered = new Map();
+function storeFor(scope) {
+    let store = remembered.get(scope);
+    if (!store) {
+        store = new Map();
+        remembered.set(scope, store);
+    }
+    return store;
+}
+/**
+ * Fold this call's rulings into what the session already knows, and return the
+ * union. This is what makes the gate converge: a reworded taskSummary produces
+ * a different candidate set, and without this every earlier justification would
+ * have to be typed again.
+ */
+export function recordRulings(ctx, rulings) {
+    const store = storeFor(workaroundScope(ctx));
+    for (const [key, reason] of rulings) {
+        // Re-insert so a repeated key moves to the newest end of the eviction order.
+        store.delete(key);
+        store.set(key, reason);
+    }
+    while (store.size > RULING_HISTORY) {
+        const oldest = store.keys().next();
+        if (oldest.done)
+            break;
+        store.delete(oldest.value);
+    }
+    return new Map(store);
+}
+/** What this session has already ruled out. Read-only view. */
+export function knownRulings(ctx) {
+    return new Map(storeFor(workaroundScope(ctx)));
+}
+/** Drop every partition. Test-only. */
+export function resetRulings() {
+    remembered.clear();
+}
+/**
+ * Decide whether the caller has cleared the gate, and if not, say precisely
+ * what is still needed.
+ */
+export function evaluateGate(candidates, rawRuledOut, ctx) {
+    const parsed = parseRulings(rawRuledOut);
+    const known = recordRulings(ctx, parsed.accepted);
+    const unresolved = candidates.filter((c) => !known.has(ruledOutKey(c.action)));
+    const satisfied = candidates
+        .filter((c) => known.has(ruledOutKey(c.action)))
+        .map((c) => `${c.tool}(${c.action})`);
+    return {
+        unresolved,
+        rejected: parsed.rejected,
+        satisfied,
+        ruledOutTemplate: unresolved.map((c) => ({
+            action: `${c.tool}(${c.action})`,
+            reason: `<why ${c.tool}(${c.action}) does not do this task>`,
+        })),
+    };
+}
+/**
+ * The refusal text. It has one job: make the next call the successful one, so
+ * it states the accepted spellings, names what is still missing, and shows the
+ * array to send rather than describing it.
+ */
+export function gateRefusalMessage(taskSummary, candidates, verdict) {
+    const lines = [
+        `execute_python is GATED. A tool search for "${taskSummary}" returned ${candidates.length} candidate action(s).`,
+        `Still need a reason for: ${verdict.unresolved.map((c) => `${c.tool}(${c.action})`).join(", ")}.`,
+    ];
+    if (verdict.satisfied.length > 0) {
+        lines.push(`Already ruled out this session (no need to repeat): ${verdict.satisfied.join(", ")}.`);
+    }
+    if (verdict.rejected.length > 0) {
+        lines.push(`These entries did not count: ${verdict.rejected.map((r) => `${r.entry} (${r.why})`).join("; ")}.`);
+    }
+    lines.push(`Re-call with the SAME taskSummary plus this ruledOut array, replacing each placeholder with a real reason of at least ${MIN_REASON_LENGTH} characters:`, JSON.stringify({ ruledOut: verdict.ruledOutTemplate }), `The action field accepts any of "${candidates[0].action}", "${candidates[0].tool}(${candidates[0].action})" or "${candidates[0].tool}.${candidates[0].action}".`, `Rulings are remembered for this session, so rewording the taskSummary does not ask you to justify the same action twice.`, `If one of these actually does the task, call it instead of Python.`);
+    return lines.join(" ");
+}
+//# sourceMappingURL=python-gate.js.map

package/dist/python-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"python-gate.js","sourceRoot":"","sources":["../src/python-gate.ts"],"names":[],"mappings":"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"}

package/dist/tool-counts.json

@@ -1,25 +1,25 @@
 {
   "tools": 24,
-  "actions": 783,
-  "bridgeActions": 738,
-  "localActions": 45,
+  "actions": 845,
+  "bridgeActions": 798,
+  "localActions": 47,
   "perTool": {
-    "project": 36,
-    "asset": 107,
-    "blueprint": 60,
-    "level": 76,
-    "material": 41,
-    "animation": 88,
-    "landscape": 14,
+    "project": 37,
+    "asset": 114,
+    "blueprint": 64,
+    "level": 101,
+    "material": 42,
+    "animation": 98,
+    "landscape": 15,
     "pcg": 19,
-    "foliage": 5,
+    "foliage": 6,
     "niagara": 31,
     "audio": 36,
     "widget": 29,
-    "editor": 81,
+    "editor": 83,
     "reflection": 12,
-    "gameplay": 57,
-    "gas": 15,
+    "gameplay": 65,
+    "gas": 17,
     "networking": 11,
     "demo": 4,
     "feedback": 2,
@@ -31,6 +31,6 @@
   },
   "nativeToolsets": 52,
   "nativeToolActions": 830,
-  "generatedAt": "2026-08-07T18:06:12.066Z",
-  "version": "1.2.3"
+  "generatedAt": "2026-08-28T19:24:44.962Z",
+  "version": "1.3.0"
 }