deepline 0.3.258 → 0.3.259

package/dist/install-integrity.json

@@ -2,6 +2,7 @@
   "schemaVersion": 1,
   "packageFiles": [
     "dist/bundling-sources/sdk/src/agent-runtime.ts",
+    "dist/bundling-sources/sdk/src/api-error.ts",
     "dist/bundling-sources/sdk/src/client.ts",
     "dist/bundling-sources/sdk/src/compat.ts",
     "dist/bundling-sources/sdk/src/config.ts",
@@ -18,8 +19,10 @@
     "dist/bundling-sources/sdk/src/pagination.ts",
     "dist/bundling-sources/sdk/src/play.ts",
     "dist/bundling-sources/sdk/src/plays/bundle-play-file.ts",
+    "dist/bundling-sources/sdk/src/plays/csv-data-input.ts",
     "dist/bundling-sources/sdk/src/plays/input-example.ts",
     "dist/bundling-sources/sdk/src/plays/local-file-discovery.ts",
+    "dist/bundling-sources/sdk/src/plays/run-request.ts",
     "dist/bundling-sources/sdk/src/release.ts",
     "dist/bundling-sources/sdk/src/runs/observe-transport.ts",
     "dist/bundling-sources/sdk/src/runs/overview.ts",
@@ -301,6 +304,7 @@
     "dist/bundling-sources/shared_libs/play-runtime/resource-governor.ts",
     "dist/bundling-sources/shared_libs/play-runtime/row-isolation.ts",
     "dist/bundling-sources/shared_libs/play-runtime/run-execution-scope.ts",
+    "dist/bundling-sources/shared_libs/play-runtime/run-execution-state.ts",
     "dist/bundling-sources/shared_libs/play-runtime/run-failure.ts",
     "dist/bundling-sources/shared_libs/play-runtime/run-identity.ts",
     "dist/bundling-sources/shared_libs/play-runtime/run-ledger-event-transport.ts",
@@ -309,6 +313,7 @@
     "dist/bundling-sources/shared_libs/play-runtime/run-ledger.ts",
     "dist/bundling-sources/shared_libs/play-runtime/run-lifecycle-policy.ts",
     "dist/bundling-sources/shared_libs/play-runtime/run-log-buffer.ts",
+    "dist/bundling-sources/shared_libs/play-runtime/run-observation.ts",
     "dist/bundling-sources/shared_libs/play-runtime/run-snapshot-stream.ts",
     "dist/bundling-sources/shared_libs/play-runtime/run-terminal-source.ts",
     "dist/bundling-sources/shared_libs/play-runtime/runner-app/child-play-resolver.ts",
@@ -478,6 +483,7 @@
     "dist/bundling-sources/shared_libs/plays/bundling/index.ts",
     "dist/bundling-sources/shared_libs/plays/bundling/limits.ts",
     "dist/bundling-sources/shared_libs/plays/bundling/repository-adapter.ts",
+    "dist/bundling-sources/shared_libs/plays/cascade-falloff.ts",
     "dist/bundling-sources/shared_libs/plays/cell-staleness.ts",
     "dist/bundling-sources/shared_libs/plays/child-run-projection.ts",
     "dist/bundling-sources/shared_libs/plays/compiler-manifest.ts",
@@ -497,6 +503,7 @@
     "dist/bundling-sources/shared_libs/plays/deployment-status.ts",
     "dist/bundling-sources/shared_libs/plays/docflow-binding-owner.ts",
     "dist/bundling-sources/shared_libs/plays/docflow-binding.ts",
+    "dist/bundling-sources/shared_libs/plays/docflow-unreached-reason.ts",
     "dist/bundling-sources/shared_libs/plays/docflow.ts",
     "dist/bundling-sources/shared_libs/plays/email-status.ts",
     "dist/bundling-sources/shared_libs/plays/enrich-compat-adapter.ts",
@@ -542,6 +549,8 @@
     "dist/bundling-sources/shared_libs/plays/tool-response-contract.ts",
     "dist/bundling-sources/shared_libs/plays/tool-result-types.ts",
     "dist/bundling-sources/shared_libs/plays/transform-factor-structure.ts",
+    "dist/bundling-sources/shared_libs/plays/trigger-config-contract.ts",
+    "dist/bundling-sources/shared_libs/plays/trigger-config-route.ts",
     "dist/bundling-sources/shared_libs/plays/ts-ast.ts",
     "dist/bundling-sources/shared_libs/plays/user-code-safety.ts",
     "dist/bundling-sources/shared_libs/plays/webhook-payload.ts",
@@ -582,8 +591,10 @@
     "dist/cli/index.js",
     "dist/cli/index.mjs",
     "dist/cli/text-imports.d.ts",
-    "dist/compiler-manifest-C4mdRJOP.d.mts",
-    "dist/compiler-manifest-C4mdRJOP.d.ts",
+    "dist/client-B5XbKrrs.d.mts",
+    "dist/client-C9Y49yya.d.ts",
+    "dist/compiler-manifest-CUuh8C3b.d.mts",
+    "dist/compiler-manifest-CUuh8C3b.d.ts",
     "dist/helpers.d.mts",
     "dist/helpers.d.ts",
     "dist/helpers.js",
@@ -603,6 +614,14 @@
     "dist/plays/bundle-play-file.d.mts",
     "dist/plays/bundle-play-file.d.ts",
     "dist/plays/bundle-play-file.mjs",
+    "dist/plays/csv-data-input.d.mts",
+    "dist/plays/csv-data-input.d.ts",
+    "dist/plays/csv-data-input.js",
+    "dist/plays/csv-data-input.mjs",
+    "dist/plays/run-request.d.mts",
+    "dist/plays/run-request.d.ts",
+    "dist/plays/run-request.js",
+    "dist/plays/run-request.mjs",
     "dist/plays/text-imports.d.ts",
     "dist/release.d.mts",
     "dist/release.d.ts",

package/dist/plays/bundle-play-file.d.mts

@@ -1,6 +1,6 @@
 /// <reference path="./text-imports.d.ts" />
-import { P as PlayArtifactKind, a as PlayBundleArtifact, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-C4mdRJOP.mjs';
-export { d as PLAY_ARTIFACT_KINDS, e as PlayArtifactCompatibility, f as PlayImportPolicy, g as PlayPackageImport, h as PlayRuntimeFeature } from '../compiler-manifest-C4mdRJOP.mjs';
+import { P as PlayArtifactKind, a as PlayBundleArtifact, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-CUuh8C3b.mjs';
+export { d as PLAY_ARTIFACT_KINDS, e as PlayArtifactCompatibility, f as PlayImportPolicy, g as PlayPackageImport, h as PlayRuntimeFeature } from '../compiler-manifest-CUuh8C3b.mjs';
 import '@sinclair/typebox';
 
 type ImportedPlayDependency = {

package/dist/plays/bundle-play-file.d.ts

@@ -1,6 +1,6 @@
 /// <reference path="./text-imports.d.ts" />
-import { P as PlayArtifactKind, a as PlayBundleArtifact, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-C4mdRJOP.js';
-export { d as PLAY_ARTIFACT_KINDS, e as PlayArtifactCompatibility, f as PlayImportPolicy, g as PlayPackageImport, h as PlayRuntimeFeature } from '../compiler-manifest-C4mdRJOP.js';
+import { P as PlayArtifactKind, a as PlayBundleArtifact, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-CUuh8C3b.js';
+export { d as PLAY_ARTIFACT_KINDS, e as PlayArtifactCompatibility, f as PlayImportPolicy, g as PlayPackageImport, h as PlayRuntimeFeature } from '../compiler-manifest-CUuh8C3b.js';
 import '@sinclair/typebox';
 
 type ImportedPlayDependency = {

package/dist/plays/bundle-play-file.mjs

@@ -1708,11 +1708,26 @@ function isDefinePlayCall(node) {
   }
   return false;
 }
+function stringLiteralValue(node) {
+  const expression = unwrapStaticExpression(node);
+  return expression?.type === "Literal" && typeof expression.value === "string" ? expression.value : null;
+}
 function definePlayName(node) {
   const expression = unwrapStaticExpression(node);
   if (!expression || expression.type !== "CallExpression") return null;
-  const first = astArray(expression.arguments)[0] ?? null;
-  return first?.type === "Literal" && typeof first.value === "string" ? first.value : null;
+  const first = unwrapStaticExpression(
+    astArray(expression.arguments)[0] ?? null
+  );
+  if (first?.type !== "ObjectExpression") return stringLiteralValue(first);
+  let id = null;
+  for (const property of astArray(first.properties)) {
+    if (property.type !== "Property" || property.computed) continue;
+    const key = isAstNode(property.key) ? property.key : null;
+    const keyName = getIdentifierName(key) ?? (key?.type === "Literal" && typeof key.value === "string" ? key.value : null);
+    if (keyName !== "id") continue;
+    id = stringLiteralValue(isAstNode(property.value) ? property.value : null);
+  }
+  return id;
 }
 function listPlayFileExports(sourceCode) {
   const ast = parsePlaySourceForAnalysis(sourceCode);
@@ -2114,6 +2129,11 @@ function parseDocflowBlockGraph(mermaidSource, errors) {
       if (existing && existing.label === existing.id && label !== id) {
         existing.label = label;
         existing.kind = kind;
+        for (const subgraph of subgraphs.values()) {
+          const at = subgraph.memberIds.indexOf(id);
+          if (at !== -1) subgraph.memberIds.splice(at, 1);
+        }
+        subgraphStack[subgraphStack.length - 1]?.memberIds.push(id);
       } else if (existing && existing.label !== label) {
         errors.push(`Docflow node "${id}" has conflicting labels.`);
       } else if (!existing) {
@@ -2129,10 +2149,12 @@ function parseDocflowBlockGraph(mermaidSource, errors) {
       const id = opened[1];
       const rawLabel = opened[2]?.trim() ?? "";
       const label = rawLabel.length >= 2 && (rawLabel.startsWith('"') && rawLabel.endsWith('"') || rawLabel.startsWith("'") && rawLabel.endsWith("'")) ? rawLabel.slice(1, -1) : rawLabel;
+      const parent = subgraphStack[subgraphStack.length - 1];
       const subgraph = {
         id,
         label: label || id,
-        memberIds: []
+        memberIds: [],
+        ...parent ? { parentId: parent.id } : {}
       };
       subgraphs.set(id, subgraph);
       subgraphStack.push(subgraph);
@@ -3759,20 +3781,73 @@ function sourceLoaderForPath(path) {
   }
   return "ts";
 }
-function docflowContextIdentifierFromCall(call) {
+function isFunctionNode(node) {
+  return !!node && (node.type === "ArrowFunctionExpression" || node.type === "FunctionExpression");
+}
+function definePlayRunFunction(call) {
   if (!isDefinePlayCallExpression(call)) return null;
   const args = astArray(call.arguments);
-  const callback = args.find(
-    (argument) => argument.type === "ArrowFunctionExpression" || argument.type === "FunctionExpression"
-  );
-  if (!callback) return null;
-  return getIdentifierName3(astArray(callback.params)[0]);
+  const positional = args.find((argument) => isFunctionNode(argument));
+  if (positional) return positional;
+  const config = unwrapStaticExpression2(args[0] ?? null);
+  if (!config || config.type !== "ObjectExpression") return null;
+  let run = null;
+  for (const property of astArray(config.properties)) {
+    if (property.type !== "Property") continue;
+    if (propertyNameFromKey(property) !== "run") continue;
+    const value = unwrapStaticExpression2(
+      isAstNode(property.value) ? property.value : null
+    );
+    run = isFunctionNode(value) ? value : null;
+  }
+  return run;
 }
-function findDocflowContextIdentifier(input) {
+var DOCFLOW_INJECTED_CONTEXT_NAME = "__deeplineDocflowContext";
+function docflowContextFromCall(call, sourceCode) {
+  if (!isDefinePlayCallExpression(call)) return null;
+  const run = definePlayRunFunction(call);
+  if (!run) {
+    return {
+      kind: "unsupported",
+      reason: "its definePlay call does not declare the run function inline (pass `definePlay(name, async (ctx, input) => \u2026)` or `definePlay({ id, run: async (ctx, input) => \u2026 })`)"
+    };
+  }
+  const params = astArray(run.params);
+  const first = params[0];
+  if (first) {
+    const name = getIdentifierName3(first);
+    return name ? { kind: "named", name } : {
+      kind: "unsupported",
+      reason: `its run function's first parameter is not a plain identifier (found ${first.type}; declare the context as \`ctx\` and destructure inside the body)`
+    };
+  }
+  const runBounds = astNodeBounds(run);
+  const body = isAstNode(run.body) ? astNodeBounds(run.body) : null;
+  if (!runBounds || !body) {
+    return {
+      kind: "unsupported",
+      reason: "its run function has no source span"
+    };
+  }
+  const signature = sourceCode.slice(runBounds.start, body.start);
+  const emptyParams = /\(\s*\)/.exec(signature);
+  if (!emptyParams) {
+    return {
+      kind: "unsupported",
+      reason: "its parameterless run function has no `()` parameter list"
+    };
+  }
+  return {
+    kind: "inject",
+    name: DOCFLOW_INJECTED_CONTEXT_NAME,
+    at: runBounds.start + emptyParams.index + 1
+  };
+}
+function findDocflowContext(input) {
   let owner = input.statement;
   while (owner) {
-    const contextName = docflowContextIdentifierFromCall(owner);
-    if (contextName) return contextName;
+    const context = docflowContextFromCall(owner, input.sourceCode);
+    if (context) return context;
     owner = input.parents.get(owner) ?? null;
   }
   const lineStart = input.lineStarts[input.bindingLine - 1];
@@ -3794,7 +3869,7 @@ function findDocflowContextIdentifier(input) {
       else if (isAstNode(child)) pending.push(child);
     }
   }
-  return best ? docflowContextIdentifierFromCall(best) : null;
+  return best ? docflowContextFromCall(best, input.sourceCode) : null;
 }
 function docflowInputCaptureSource(paths) {
   return `[${paths.map((path) => {
@@ -3816,6 +3891,8 @@ function docflowObservationTarget(statement) {
     expression = statement.expression;
   } else if (statement.type === "IfStatement" && isAstNode(statement.test)) {
     expression = statement.test;
+  } else if (statement.type === "ThrowStatement" && isAstNode(statement.argument)) {
+    expression = statement.argument;
   }
   if (!expression) return null;
   const bounds = astNodeBounds(expression);
@@ -3823,11 +3900,13 @@ function docflowObservationTarget(statement) {
   return {
     ...bounds,
     awaitsResult: expressionContainsTopLevelAwait(expression),
-    expression
+    expression,
+    throws: statement.type === "ThrowStatement"
   };
 }
 function docflowObservedExpression(input) {
-  const callback = input.awaitsResult ? `async()=>(${input.expression})` : `()=>(${input.expression})`;
+  const body = input.throws ? `{throw (${input.expression})}` : `(${input.expression})`;
+  const callback = input.awaitsResult ? `async()=>${body}` : `()=>${body}`;
   const observation = `((runtimeContext,inputCaptures,execute)=>typeof runtimeContext.__deeplineObserveDocflowNode==="function"?runtimeContext.__deeplineObserveDocflowNode(${JSON.stringify(input.nodeId)},inputCaptures,${JSON.stringify(input.outputs)},execute):execute())(${input.contextName},${docflowInputCaptureSource(input.inputs)},${callback})`;
   return input.awaitsResult ? `(await ${observation})` : observation;
 }
@@ -3854,17 +3933,26 @@ function instrumentPlayDocflowRuntimeHits(sourceCode) {
   const lineStarts = sourceLineStarts(sourceCode);
   const replacements = [];
   const targets = [];
+  const injectedContextAt = /* @__PURE__ */ new Set();
   const parents = buildDocflowParentIndex(ast);
   for (const binding of parsed.bindings) {
     const resolution = resolveDocflowBinding(ast, binding, lineStarts, parents);
-    const contextName = findDocflowContextIdentifier({
+    const context = findDocflowContext({
       ast,
+      sourceCode,
       statement: resolution.statement,
       bindingLine: binding.line,
       lineStarts,
       parents
     });
-    if (!contextName) continue;
+    if (!context) continue;
+    if (context.kind === "unsupported") {
+      throw new Error(
+        `@mermaid-node ${binding.nodeId} (line ${binding.line}) cannot be observed at runtime: ${context.reason}.`
+      );
+    }
+    if (context.kind === "inject") injectedContextAt.add(context.at);
+    const contextName = context.kind === "inject" ? `(${context.name}??{})` : context.name;
     const target = docflowObservationTarget(resolution.statement);
     const observedRoot = docflowOutputRoot(binding);
     if (target && observedRoot && docflowExpressionWrapsStepBuilder(target.expression, observedRoot)) {
@@ -3897,6 +3985,7 @@ function instrumentPlayDocflowRuntimeHits(sourceCode) {
         start: target.start,
         end: target.end,
         awaitsResult: target.awaitsResult,
+        throws: target.throws,
         contextName: target.contextName,
         bindings: [target.binding]
       });
@@ -3904,6 +3993,7 @@ function instrumentPlayDocflowRuntimeHits(sourceCode) {
   }
   for (const group of groups) {
     let expression = sourceCode.slice(group.start, group.end);
+    let innermost = true;
     for (const binding of [...group.bindings].reverse()) {
       expression = docflowObservedExpression({
         contextName: group.contextName,
@@ -3911,8 +4001,10 @@ function instrumentPlayDocflowRuntimeHits(sourceCode) {
         inputs: binding.inputs ?? [],
         outputs: binding.outputs ?? [],
         expression,
-        awaitsResult: group.awaitsResult
+        awaitsResult: group.awaitsResult,
+        throws: group.throws && innermost
       });
+      innermost = false;
     }
     replacements.push({
       start: group.start,
@@ -3920,6 +4012,13 @@ function instrumentPlayDocflowRuntimeHits(sourceCode) {
       value: expression
     });
   }
+  for (const at of injectedContextAt) {
+    replacements.push({
+      start: at,
+      end: at,
+      value: DOCFLOW_INJECTED_CONTEXT_NAME
+    });
+  }
   return replacements.sort((left, right) => right.start - left.start).reduce(
     (source, replacement) => `${source.slice(0, replacement.start)}${replacement.value}${source.slice(replacement.end)}`,
     sourceCode

package/dist/plays/csv-data-input.d.mts

@@ -0,0 +1,37 @@
+/// <reference path="./text-imports.d.ts" />
+type CsvDataInputSource = {
+    /** Dotted path into the run input, for error messages. */
+    inputPath: string;
+    /** What the caller supplied: a CLI path or a dropped file's name. */
+    value: string;
+};
+type ParsedCsvDataInput = {
+    /** Trimmed header names, in column order. */
+    headers: string[];
+    /** Trimmed data records, positional (one entry per header, ragged allowed). */
+    records: string[][];
+};
+/**
+ * STRICT validation of the play's CSV DATA input (the row source):
+ *
+ * - parses with `relax_quotes: false` so an unclosed/ragged quote is a LOUD
+ *   error naming the line/character (prod run 20260611t145823-710 swallowed an
+ *   entire `"https://...`-no-closing-quote row into one giant linkedin_url),
+ * - detects EXACT-after-trim duplicate header names (prod run
+ *   20260611t145821-917 had two `linkedin_url` columns; the second silently
+ *   won) — case-DIFFERENT duplicates are handled play-side and not rejected,
+ * - rejects a header-only CSV with zero data rows.
+ *
+ * Any violation throws a `DeeplineError` (code `PLAY_INPUT_FILE_PREFLIGHT`)
+ * before any staging or API call, so no run is created and nothing is billed.
+ */
+declare function parseCsvDataInput(source: CsvDataInputSource, content: string, options?: {
+    /**
+     * Called after each parsed record (header included) with the running
+     * count. Observation only: it cannot change, drop, or reorder records.
+     * The dashboard's parser worker uses it to report row progress.
+     */
+    onRecord?: (recordCount: number) => void;
+}): ParsedCsvDataInput;
+
+export { type CsvDataInputSource, type ParsedCsvDataInput, parseCsvDataInput };

package/dist/plays/csv-data-input.d.ts

@@ -0,0 +1,37 @@
+/// <reference path="./text-imports.d.ts" />
+type CsvDataInputSource = {
+    /** Dotted path into the run input, for error messages. */
+    inputPath: string;
+    /** What the caller supplied: a CLI path or a dropped file's name. */
+    value: string;
+};
+type ParsedCsvDataInput = {
+    /** Trimmed header names, in column order. */
+    headers: string[];
+    /** Trimmed data records, positional (one entry per header, ragged allowed). */
+    records: string[][];
+};
+/**
+ * STRICT validation of the play's CSV DATA input (the row source):
+ *
+ * - parses with `relax_quotes: false` so an unclosed/ragged quote is a LOUD
+ *   error naming the line/character (prod run 20260611t145823-710 swallowed an
+ *   entire `"https://...`-no-closing-quote row into one giant linkedin_url),
+ * - detects EXACT-after-trim duplicate header names (prod run
+ *   20260611t145821-917 had two `linkedin_url` columns; the second silently
+ *   won) — case-DIFFERENT duplicates are handled play-side and not rejected,
+ * - rejects a header-only CSV with zero data rows.
+ *
+ * Any violation throws a `DeeplineError` (code `PLAY_INPUT_FILE_PREFLIGHT`)
+ * before any staging or API call, so no run is created and nothing is billed.
+ */
+declare function parseCsvDataInput(source: CsvDataInputSource, content: string, options?: {
+    /**
+     * Called after each parsed record (header included) with the running
+     * count. Observation only: it cannot change, drop, or reorder records.
+     * The dashboard's parser worker uses it to report row progress.
+     */
+    onRecord?: (recordCount: number) => void;
+}): ParsedCsvDataInput;
+
+export { type CsvDataInputSource, type ParsedCsvDataInput, parseCsvDataInput };