yaml-flow 5.1.0 → 5.2.0

package/dist/index.cjs

@@ -8590,15 +8590,30 @@ function selectOptimalTasks(candidates, graph, state, conflictStrategy) {
 }
 
 // src/event-graph/task-transitions.ts
-function applyTaskStart(state, taskName) {
+function applyTaskStart(state, taskName, graph) {
   const existingTask = state.tasks[taskName] ?? createDefaultGraphEngineStore2();
+  const startConsumedHashes = {};
+  if (graph) {
+    const taskConfig = graph.tasks[taskName];
+    const requires = getRequires(taskConfig);
+    for (const token of requires) {
+      for (const [otherName, otherConfig] of Object.entries(graph.tasks)) {
+        if (getProvides(otherConfig).includes(token)) {
+          const otherState = state.tasks[otherName];
+          if (otherState?.lastDataHash) startConsumedHashes[token] = otherState.lastDataHash;
+          break;
+        }
+      }
+    }
+  }
   const updatedTask = {
     ...existingTask,
     status: "running",
     startedAt: (/* @__PURE__ */ new Date()).toISOString(),
     lastUpdated: (/* @__PURE__ */ new Date()).toISOString(),
     progress: 0,
-    error: void 0
+    error: void 0,
+    startConsumedHashes
   };
   return {
     ...state,
@@ -8618,16 +8633,18 @@ function applyTaskCompletion(state, graph, taskName, result, dataHash, data) {
   } else {
     outputTokens = getProvides(taskConfig);
   }
-  const lastConsumedHashes = { ...existingTask.lastConsumedHashes };
-  const requires = taskConfig.requires ?? [];
-  for (const token of requires) {
-    for (const [otherName, otherConfig] of Object.entries(graph.tasks)) {
-      if (getProvides(otherConfig).includes(token)) {
-        const otherState = state.tasks[otherName];
-        if (otherState?.lastDataHash) {
-          lastConsumedHashes[token] = otherState.lastDataHash;
+  const lastConsumedHashes = existingTask.startConsumedHashes ? { ...existingTask.startConsumedHashes } : { ...existingTask.lastConsumedHashes };
+  if (!existingTask.startConsumedHashes) {
+    const requires = taskConfig.requires ?? [];
+    for (const token of requires) {
+      for (const [otherName, otherConfig] of Object.entries(graph.tasks)) {
+        if (getProvides(otherConfig).includes(token)) {
+          const otherState = state.tasks[otherName];
+          if (otherState?.lastDataHash) {
+            lastConsumedHashes[token] = otherState.lastDataHash;
+          }
+          break;
         }
-        break;
       }
     }
   }
@@ -8749,7 +8766,7 @@ function apply(state, event, graph) {
   }
   switch (event.type) {
     case "task-started":
-      return applyTaskStart(state, event.taskName);
+      return applyTaskStart(state, event.taskName, graph);
     case "task-completed":
       return applyTaskCompletion(state, graph, event.taskName, event.result, event.dataHash, event.data);
     case "task-failed":
@@ -10103,7 +10120,7 @@ function applyEvent(live, event) {
   switch (event.type) {
     // --- Execution state transitions ---
     case "task-started":
-      return { config, state: applyTaskStart(state, event.taskName) };
+      return { config, state: applyTaskStart(state, event.taskName, config) };
     case "task-completed":
       return { config, state: applyTaskCompletion(state, config, event.taskName, event.result, event.dataHash, event.data) };
     case "task-failed":
@@ -11671,9 +11688,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" },
@@ -11692,6 +11709,7 @@ var live_cards_schema_default = {
           enum: [
             "metric",
             "table",
+            "editable-table",
             "chart",
             "form",
             "filter",
@@ -11809,7 +11827,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",
@@ -11837,6 +11855,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
@@ -11850,6 +11880,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."
     }
   }
 };
@@ -11918,12 +11952,35 @@ function getValidator3() {
 function validateLiveCardSchema(node) {
   const validate = getValidator3();
   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 = [];
@@ -12093,13 +12150,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`);
           }