yaml-flow 5.1.0 → 5.2.0

package/dist/card-compute/index.d.cts

@@ -58,10 +58,10 @@ declare function validateLiveCardDefinition(node: unknown): ValidationResult;
  * Expressions are evaluated against { card_data, requires, fetched_sources, computed_values }.
  * computed_values is ephemeral — never persisted to disk.
  */
-/** A source definition: cli writes to outputFile; bindTo names the fetched_sources.* key in compute context. */
+/** A source definition: cli writes to outputFile; bindTo names the fetched_sources.* key in compute context. Both bindTo and outputFile must be unique across sources in a card. */
 interface ComputeSource {
     bindTo: string;
-    outputFile?: string;
+    outputFile: string;
     cli?: string;
     script?: string;
     optionalForCompletionGating?: boolean;

package/dist/card-compute/index.d.ts

@@ -58,10 +58,10 @@ declare function validateLiveCardDefinition(node: unknown): ValidationResult;
  * Expressions are evaluated against { card_data, requires, fetched_sources, computed_values }.
  * computed_values is ephemeral — never persisted to disk.
  */
-/** A source definition: cli writes to outputFile; bindTo names the fetched_sources.* key in compute context. */
+/** A source definition: cli writes to outputFile; bindTo names the fetched_sources.* key in compute context. Both bindTo and outputFile must be unique across sources in a card. */
 interface ComputeSource {
     bindTo: string;
-    outputFile?: string;
+    outputFile: string;
     cli?: string;
     script?: string;
     optionalForCompletionGating?: boolean;

package/dist/card-compute/index.js

@@ -6540,9 +6540,9 @@ var live_cards_schema_default = {
       }
     },
     source_def: {
-      description: "One source entry. The engine only cares about 'bindTo' (compute namespace key) and 'outputFile' (delivery signal). Every other property is yours \u2014 add whatever your task-executor needs: kind, url, headers, mailbox, channel, model, query, etc. The full object is passed verbatim as the --in JSON to the executor.",
+      description: "One source entry. The engine requires 'bindTo' (compute namespace key) and 'outputFile' (delivery signal path). bindTo and outputFile must be unique across all sources in a card. Every other property is yours \u2014 add whatever your task-executor needs: kind, url, headers, mailbox, channel, model, query, etc. The full object is passed verbatim as the --in JSON to the executor.",
       type: "object",
-      required: ["bindTo"],
+      required: ["bindTo", "outputFile"],
       additionalProperties: true,
       properties: {
         bindTo: { type: "string", description: "Key under fetched_sources.* available in compute expressions" },
@@ -6561,6 +6561,7 @@ var live_cards_schema_default = {
           enum: [
             "metric",
             "table",
+            "editable-table",
             "chart",
             "form",
             "filter",
@@ -6678,7 +6679,7 @@ var live_cards_schema_default = {
     view: { $ref: "#/definitions/view" },
     card_data: {
       type: "object",
-      description: "Authored card data supplied in the card definition",
+      description: "Authored card data and runtime metadata. Includes uploaded-file metadata maintained by host handlers and inference evaluation results.",
       properties: {
         files: {
           type: "array",
@@ -6706,6 +6707,18 @@ var live_cards_schema_default = {
             },
             additionalProperties: false
           }
+        },
+        llm_task_completion_inference: {
+          type: "object",
+          description: "Runtime state written by the inference adapter (advanced/undocumented). Prefer the standard sources \u2192 compute \u2192 provides pattern for LLM-based signals.",
+          properties: {
+            inferenceRequested: { type: "string", format: "date-time", description: "Timestamp when the latest inference request was initiated" },
+            inferenceCompletedAt: { type: "string", format: "date-time", description: "Timestamp when the latest inference request completed" },
+            isTaskCompleted: { type: "boolean", description: "Whether the task is considered complete by the adapter" },
+            reasoning: { type: "string", description: "Explanation of completion decision" },
+            evidence: { type: "array", description: "Supporting evidence from sources/compute" }
+          },
+          additionalProperties: true
         }
       },
       additionalProperties: true
@@ -6719,6 +6732,10 @@ var live_cards_schema_default = {
       type: "array",
       description: "Ordered array of compute steps. Each reads card_data.*/requires.*/fetched_sources.*/computed_values.* and writes to ephemeral computed_values[bindTo].",
       items: { $ref: "#/definitions/compute_step" }
+    },
+    when_is_task_completed: {
+      type: "string",
+      description: "Advanced/undocumented: invokes a registered inference adapter instead of the default source-delivery completion gate. Prefer the standard pattern: use an LLM-backed source, compute a verdict token, and publish it via provides."
     }
   }
 };
@@ -6787,12 +6804,35 @@ function getValidator() {
 function validateLiveCardSchema(node) {
   const validate = getValidator();
   const valid = validate(node);
-  if (valid) return { ok: true, errors: [] };
   const errors = (validate.errors ?? []).map((e) => {
     const path = e.instancePath || "/";
     return `${path}: ${e.message ?? "unknown error"}`;
   });
-  return { ok: false, errors };
+  if (node && typeof node === "object" && !Array.isArray(node)) {
+    const sources = node.sources;
+    if (Array.isArray(sources)) {
+      const bindTos = /* @__PURE__ */ new Set();
+      const outputFiles = /* @__PURE__ */ new Set();
+      sources.forEach((src, i) => {
+        if (!src || typeof src !== "object" || Array.isArray(src)) return;
+        const s = src;
+        if (typeof s.bindTo === "string" && s.bindTo) {
+          if (bindTos.has(s.bindTo)) {
+            errors.push(`/sources/${i}/bindTo: bindTo "${s.bindTo}" must be unique across all sources`);
+          }
+          bindTos.add(s.bindTo);
+        }
+        if (typeof s.outputFile === "string" && s.outputFile) {
+          if (outputFiles.has(s.outputFile)) {
+            errors.push(`/sources/${i}/outputFile: outputFile "${s.outputFile}" must be unique across all sources`);
+          }
+          outputFiles.add(s.outputFile);
+        }
+      });
+    }
+  }
+  if (!valid || errors.length > 0) return { ok: false, errors };
+  return { ok: true, errors: [] };
 }
 function validateLiveCardRuntimeExpressions(node) {
   const errors = [];
@@ -6962,13 +7002,29 @@ function validateNode(node) {
     if (!Array.isArray(n.sources)) {
       errors.push("sources: must be an array");
     } else {
+      const bindTos = /* @__PURE__ */ new Set();
+      const outputFiles = /* @__PURE__ */ new Set();
       n.sources.forEach((src, i) => {
         if (!src || typeof src !== "object" || Array.isArray(src)) {
           errors.push(`sources[${i}]: must be an object`);
         } else {
           const s = src;
-          if (typeof s.bindTo !== "string" || !s.bindTo) errors.push(`sources[${i}]: missing required "bindTo" property`);
-          if (s.outputFile != null && typeof s.outputFile !== "string") errors.push(`sources[${i}]: outputFile must be a string`);
+          if (typeof s.bindTo !== "string" || !s.bindTo) {
+            errors.push(`sources[${i}]: missing required "bindTo" property`);
+          } else {
+            if (bindTos.has(s.bindTo)) {
+              errors.push(`sources[${i}]: bindTo "${s.bindTo}" is not unique across sources`);
+            }
+            bindTos.add(s.bindTo);
+          }
+          if (typeof s.outputFile !== "string" || !s.outputFile) {
+            errors.push(`sources[${i}]: missing required "outputFile" property`);
+          } else {
+            if (outputFiles.has(s.outputFile)) {
+              errors.push(`sources[${i}]: outputFile "${s.outputFile}" is not unique across sources`);
+            }
+            outputFiles.add(s.outputFile);
+          }
           if (s.optionalForCompletionGating != null && typeof s.optionalForCompletionGating !== "boolean") {
             errors.push(`sources[${i}]: optionalForCompletionGating must be a boolean`);
           }