feat(scripts): enhance script return structure and context handling

- Introduced a new contract for script returns, requiring an object with `output`, `context`, and `skipRemaining` fields.
- Refactored existing scripts to align with the new return structure, ensuring compatibility with the updated context management.
- Added utility functions for normalizing context and step results, improving the handling of script execution context.
- Updated various scripts (e.g., fetch-binary, fetch-html, fetch-http) to return structured output and context, enhancing data flow and usability.
- Improved error handling for script returns, ensuring clearer feedback when invalid structures are returned.

This update significantly enhances the flexibility and clarity of script interactions within workflows.

packages/server/scripts/get-secret.js

@@ -1,3 +1,17 @@
+function passContext(ctx) {
+  if (ctx?.context != null && typeof ctx.context === "object" && !Array.isArray(ctx.context)) {
+    return { ...ctx.context };
+  }
+  return {};
+}
+
+function mergeData(data) {
+  if (data != null && typeof data === "object" && !Array.isArray(data)) {
+    return { ...data };
+  }
+  return {};
+}
+
 async function getSecret(ctx) {
   const name = ctx.config?.name;
   if (typeof name !== "string" || name.length === 0) {
@@ -9,19 +23,16 @@ async function getSecret(ctx) {
       : name;
 
   const value = await $secrets.get(name);
-  const base =
-    ctx != null && typeof ctx === "object" && !Array.isArray(ctx) ? { ...ctx } : {};
-  const data =
-    base.data != null && typeof base.data === "object" && !Array.isArray(base.data)
-      ? { ...base.data }
-      : {};
-  data[as] = value;
-  return { ...base, data };
+  const extra = { [as]: value };
+  return {
+    output: { ...mergeData(ctx.data), ...extra },
+    context: { ...passContext(ctx), ...extra },
+  };
 }
 
 getSecret.meta = {
   description:
-    "Load a named secret for this workflow owner into ctx.data. The value is wrapped and redacted in logs.",
+    "Load a named secret for this workflow owner onto output and context. The value is wrapped and redacted in logs.",
   previewConfigKey: "name",
   config: {
     name: {
@@ -32,16 +43,12 @@ getSecret.meta = {
     as: {
       type: "string",
       required: false,
-      description: "ctx.data field to write (defaults to name)",
+      description: "Field name on output and context (defaults to name)",
     },
   },
   input: {},
-  output: {
-    data: {
-      type: "object",
-      description: "Previous ctx.data plus the retrieved Secret at [as]",
-    },
-  },
+  output: {},
+  context: {},
   example: {
     data: {},
     config: { name: "ntfy_token", as: "ntfyToken" },