@surething/cockpit 1.0.190 → 1.0.191

package/.next-prod/trace-build

@@ -1 +1 @@
-[{"name":"run-webpack","duration":14794325,"timestamp":140788328,"id":17,"parentId":1,"tags":{},"startTime":1776945369702,"traceId":"dd513241a496b942"},{"name":"run-typescript","duration":14812952,"timestamp":155586528,"id":1516,"parentId":1,"tags":{},"startTime":1776945384500,"traceId":"dd513241a496b942"},{"name":"static-check","duration":878884,"timestamp":170416539,"id":1519,"parentId":1,"tags":{},"startTime":1776945399330,"traceId":"dd513241a496b942"},{"name":"static-generation","duration":6321383,"timestamp":171505154,"id":1743,"parentId":1,"tags":{},"startTime":1776945400419,"traceId":"dd513241a496b942"},{"name":"collect-build-traces","duration":19135337,"timestamp":171296197,"id":1740,"parentId":1,"tags":{},"startTime":1776945400210,"traceId":"dd513241a496b942"},{"name":"telemetry-flush","duration":55,"timestamp":190434808,"id":1752,"parentId":1,"tags":{},"startTime":1776945419349,"traceId":"dd513241a496b942"},{"name":"next-build","duration":49807570,"timestamp":140627306,"id":1,"tags":{"buildMode":"default","version":"16.1.6","bundler":"webpack","has-custom-webpack-config":"false","use-build-worker":"true"},"startTime":1776945369541,"traceId":"dd513241a496b942"}]
+[{"name":"run-webpack","duration":12469889,"timestamp":258042084,"id":17,"parentId":1,"tags":{},"startTime":1776946064942,"traceId":"7edc58480cce636d"},{"name":"run-typescript","duration":14950615,"timestamp":270517130,"id":1516,"parentId":1,"tags":{},"startTime":1776946077417,"traceId":"7edc58480cce636d"},{"name":"static-check","duration":851998,"timestamp":285483513,"id":1519,"parentId":1,"tags":{},"startTime":1776946092384,"traceId":"7edc58480cce636d"},{"name":"static-generation","duration":6156212,"timestamp":286689558,"id":1743,"parentId":1,"tags":{},"startTime":1776946093590,"traceId":"7edc58480cce636d"},{"name":"collect-build-traces","duration":18913013,"timestamp":286338915,"id":1740,"parentId":1,"tags":{},"startTime":1776946093239,"traceId":"7edc58480cce636d"},{"name":"telemetry-flush","duration":58,"timestamp":305255163,"id":1752,"parentId":1,"tags":{},"startTime":1776946112155,"traceId":"7edc58480cce636d"},{"name":"next-build","duration":47383414,"timestamp":257871819,"id":1,"tags":{"buildMode":"default","version":"16.1.6","bundler":"webpack","has-custom-webpack-config":"false","use-build-worker":"true"},"startTime":1776946064772,"traceId":"7edc58480cce636d"}]

package/bin/cock-browser.mjs

@@ -353,6 +353,32 @@ async function run() {
 
 async function formatOutput(action, data) {
   if (data === undefined || data === null) {
+    // evaluate-family silently returning undefined/null is a major source of
+    // confusion for LLM callers — they can't tell "code ran but produced no
+    // value" from "something broke". Write a concrete hint to stderr so the
+    // Bash tool's empty-stdout annotation surfaces it alongside the
+    // "(exit 0 — empty stdout)" note instead of guessing causes.
+    if (action === 'evaluate' || action === 'evaluate_chunk') {
+      process.stderr.write(
+        `(evaluate returned ${data === null ? 'null' : 'undefined'} — nothing to print.\n` +
+        ` Common causes:\n` +
+        `  (a) bare arrow function: \`() => x\` defines but does not invoke — wrap as \`(() => x)()\` or \`(async()=>{...})()\`.\n` +
+        `  (b) a .then(...) callback didn't return the value — add an explicit \`return\` in each step of the chain.\n` +
+        `  (c) accessed a missing property — e.g. \`d.chat.x\` when response has no \`chat\` field, yielding undefined.\n` +
+        ` To force output: wrap the final value with \`JSON.stringify(...)\`, or return a short scalar.\n`
+      );
+    }
+    return;
+  }
+  if (typeof data === 'function') {
+    // Structured clone usually drops functions into undefined before this
+    // point, but if one slips through (e.g. from a custom bridge), surface
+    // it explicitly instead of swallowing.
+    process.stderr.write(
+      `(evaluate returned a function reference, which cannot be serialized.\n` +
+      ` If you defined an arrow function, invoke it: \`(async()=>{...})()\`.\n` +
+      ` To return the function's *result*, call it; to inspect the source, use \`fn.toString()\`.\n`
+    );
     return;
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@surething/cockpit",
-  "version": "1.0.190",
+  "version": "1.0.191",
   "description": "The Cockpit That Drives AI",
   "author": "Robert",
   "license": "MIT",