deepline 0.2.53 → 0.2.55

package/dist/{compiler-manifest-Cj3--4ZJ.d.mts → compiler-manifest-Bl8kmLx9.d.mts}

@@ -16,6 +16,91 @@ declare const PLAY_ARTIFACT_KINDS: {
 };
 type PlayArtifactKind = (typeof PLAY_ARTIFACT_KINDS)[keyof typeof PLAY_ARTIFACT_KINDS];
 
+type PlayDocflowNodeKind = 'action' | 'decision' | 'dataset' | 'play' | 'conceptual';
+type PlayDocflowNode = {
+    id: string;
+    label: string;
+    kind: PlayDocflowNodeKind;
+};
+/**
+ * Which arm of a conditional a drawn decision edge IS.
+ *
+ * The runtime's own two-valued vocabulary for a `runIf` (ADR 0019): the cell
+ * record says `branch: 'run' | 'else'`, and this is the same token on the
+ * diagram's side of the join. Deliberately NOT the arm's label — a label is the
+ * author's prose ("fit 65 or better", "nicht gefunden") and says nothing about
+ * polarity in any language.
+ */
+type PlayDocflowArm = 'run' | 'else';
+type PlayDocflowEdge = {
+    from: string;
+    to: string;
+    label?: string;
+    /**
+     * The conditional arm this edge is, when the author recorded it.
+     *
+     * ABSENT — never `null` — when unrecorded, and that is load-bearing rather
+     * than stylistic. `docflow` is whole-object serialized into
+     * `playStaticPipelineContractHash` (`src/lib/plays/artifact-storage.ts`),
+     * which is part of the immutable artifact storage key, and the canonicalizer
+     * there drops `undefined` but HASHES `null`. Emitting `arm: null` on an
+     * unannotated edge would change the contract hash of every diagrammed play
+     * ever published and force a republish. Omission is what keeps this additive.
+     */
+    arm?: PlayDocflowArm;
+};
+/**
+ * A Mermaid `subgraph … end` region. When an edge connects it to a dataset
+ * node, it models that dataset's per-row loop; its members represent the
+ * per-row column work. See `docs/play-syntax-spec.md`. `memberIds` records the
+ * innermost subgraph for nested regions.
+ */
+type PlayDocflowSubgraph = {
+    id: string;
+    label: string;
+    memberIds: string[];
+};
+type PlayDocflowBinding = {
+    nodeId: string;
+    line: number;
+    label?: string;
+    kind?: PlayDocflowNodeKind;
+    /** Symbolic values read by this business node. Never an arbitrary JS expression. */
+    inputs?: string[];
+    /** Symbolic values produced or changed by this business node. */
+    outputs?: string[];
+    /** Whether the contract was authored, safely inferred, or still needs help. */
+    ioConfidence?: 'explicit' | 'inferred' | 'ambiguous';
+    /**
+     * `arm:"run"` / `arm:"else"` — this node is that arm of the decision above it.
+     *
+     * Recorded on the annotation because the annotation is the only place the two
+     * halves of the join meet: a `@mermaid-node` binds a DIAGRAM id to the SOURCE
+     * statement directly beneath it, so the author writing it is the one person
+     * who knows both which drawn arm this is and which side of the `runIf` the
+     * code under it implements. Projected onto the incoming decision edge by
+     * {@link attachBindingsToBlocks}; the edge is what readers resolve against.
+     */
+    arm?: PlayDocflowArm;
+};
+type PlayDocflow = {
+    direction: 'LR' | 'RL' | 'TB' | 'TD' | 'BT';
+    nodes: PlayDocflowNode[];
+    edges: PlayDocflowEdge[];
+    bindings: PlayDocflowBinding[];
+    /** Authoring syntax used by the source file. Absent on older persisted graphs. */
+    syntax?: 'docflow' | 'mermaid';
+    /** Normalized Mermaid text, ready to pass directly to a Mermaid renderer. */
+    mermaidSource?: string;
+    /**
+     * Mermaid `subgraph` loop regions. Optional so older persisted graphs stay
+     * valid. Only populated for the Mermaid syntax; legacy `docflow` has none.
+     */
+    subgraphs?: PlayDocflowSubgraph[];
+    /** Mermaid directives accepted by the parser but not applied by React Flow. */
+    ignoredDirectives?: string[];
+};
+
 /**
  * A top-level key the play's function literally `return`s. Derived from the
  * `return { ... }` object literal — NOT from dataset `.withColumn(...)` names —
@@ -35,6 +120,8 @@ interface PlayStaticReturnField {
     datasetName?: string;
 }
 interface PlayStaticPipeline {
+    /** Authored business flow. Static analysis is used only when this is absent. */
+    docflow?: PlayDocflow;
     tableNamespace?: string;
     inputFields?: string[];
     rowKeyFields?: string[];
@@ -135,6 +222,12 @@ type PlayStaticSubstep = PlayStaticSubstepMetadata & ({
     waterfallIds?: string[];
     steps?: PlayStaticSubstep[];
     sheetContract?: PlaySheetContract | null;
+    /**
+     * Columns the author declared as deliberately absent from the `@mermaid`
+     * diagram via `.run({ undrawnColumns: [...] })`. The docflow column
+     * coverage gate reads this; nothing about execution does.
+     */
+    undrawnColumns?: string[];
     description?: string;
     sourceRange?: PlayStaticSourceRange;
     callDepth?: number;
@@ -1110,6 +1203,13 @@ type PlayAuthoringDatasetRunOptions<InputRow extends object> = {
     key?: PlayAuthoringDatasetRowKey<InputRow>;
     onRowError?: 'isolate' | 'fail';
     mode?: 'upsert' | 'net_new';
+    /**
+     * Computed columns this dataset produces that the authored `@mermaid`
+     * diagram deliberately does not draw. A diagrammed Play must account for
+     * every column it computes: draw it inside the dataset's `subgraph` loop
+     * region, or name it here. Nothing else opts a column out.
+     */
+    undrawnColumns?: readonly string[];
 };
 type PlayAuthoringDatasetBuilder<InputRow extends object, OutputRow extends object, TContext> = {
     /** Define one output column for every row in this dataset. */
@@ -2104,6 +2204,24 @@ declare const PLAY_AUTHORING_FIELD_REGISTRY: {
         readonly description: "Whether the dataset returns all rows or only newly admitted rows.";
         readonly errorMessage: "ctx.dataset run mode must be \"upsert\" or \"net_new\".";
     };
+    readonly 'ctx.dataset.run.undrawnColumns': {
+        readonly schema: _sinclair_typebox.TArray<_sinclair_typebox.TString>;
+        readonly fixtures: {
+            readonly valid: readonly ["miss_reason"];
+            readonly invalid: readonly [];
+            readonly absent: undefined;
+            readonly unresolved: {
+                readonly expression: "undrawnColumns";
+            };
+            readonly edition1: readonly ["miss_reason"];
+        };
+        readonly referenceType: "readonly string[]";
+        readonly required: false;
+        readonly resolution: "static-when-present";
+        readonly issueCode: "play_authoring_dataset_option_invalid";
+        readonly description: "Computed columns deliberately left out of the authored @mermaid diagram.";
+        readonly errorMessage: "ctx.dataset run undrawnColumns must be a non-empty array of static column-name strings.";
+    };
     readonly 'ctx.step.id': {
         readonly schema: _sinclair_typebox.TString;
         readonly fixtures: {

package/dist/{compiler-manifest-Cj3--4ZJ.d.ts → compiler-manifest-Bl8kmLx9.d.ts}

@@ -16,6 +16,91 @@ declare const PLAY_ARTIFACT_KINDS: {
 };
 type PlayArtifactKind = (typeof PLAY_ARTIFACT_KINDS)[keyof typeof PLAY_ARTIFACT_KINDS];
 
+type PlayDocflowNodeKind = 'action' | 'decision' | 'dataset' | 'play' | 'conceptual';
+type PlayDocflowNode = {
+    id: string;
+    label: string;
+    kind: PlayDocflowNodeKind;
+};
+/**
+ * Which arm of a conditional a drawn decision edge IS.
+ *
+ * The runtime's own two-valued vocabulary for a `runIf` (ADR 0019): the cell
+ * record says `branch: 'run' | 'else'`, and this is the same token on the
+ * diagram's side of the join. Deliberately NOT the arm's label — a label is the
+ * author's prose ("fit 65 or better", "nicht gefunden") and says nothing about
+ * polarity in any language.
+ */
+type PlayDocflowArm = 'run' | 'else';
+type PlayDocflowEdge = {
+    from: string;
+    to: string;
+    label?: string;
+    /**
+     * The conditional arm this edge is, when the author recorded it.
+     *
+     * ABSENT — never `null` — when unrecorded, and that is load-bearing rather
+     * than stylistic. `docflow` is whole-object serialized into
+     * `playStaticPipelineContractHash` (`src/lib/plays/artifact-storage.ts`),
+     * which is part of the immutable artifact storage key, and the canonicalizer
+     * there drops `undefined` but HASHES `null`. Emitting `arm: null` on an
+     * unannotated edge would change the contract hash of every diagrammed play
+     * ever published and force a republish. Omission is what keeps this additive.
+     */
+    arm?: PlayDocflowArm;
+};
+/**
+ * A Mermaid `subgraph … end` region. When an edge connects it to a dataset
+ * node, it models that dataset's per-row loop; its members represent the
+ * per-row column work. See `docs/play-syntax-spec.md`. `memberIds` records the
+ * innermost subgraph for nested regions.
+ */
+type PlayDocflowSubgraph = {
+    id: string;
+    label: string;
+    memberIds: string[];
+};
+type PlayDocflowBinding = {
+    nodeId: string;
+    line: number;
+    label?: string;
+    kind?: PlayDocflowNodeKind;
+    /** Symbolic values read by this business node. Never an arbitrary JS expression. */
+    inputs?: string[];
+    /** Symbolic values produced or changed by this business node. */
+    outputs?: string[];
+    /** Whether the contract was authored, safely inferred, or still needs help. */
+    ioConfidence?: 'explicit' | 'inferred' | 'ambiguous';
+    /**
+     * `arm:"run"` / `arm:"else"` — this node is that arm of the decision above it.
+     *
+     * Recorded on the annotation because the annotation is the only place the two
+     * halves of the join meet: a `@mermaid-node` binds a DIAGRAM id to the SOURCE
+     * statement directly beneath it, so the author writing it is the one person
+     * who knows both which drawn arm this is and which side of the `runIf` the
+     * code under it implements. Projected onto the incoming decision edge by
+     * {@link attachBindingsToBlocks}; the edge is what readers resolve against.
+     */
+    arm?: PlayDocflowArm;
+};
+type PlayDocflow = {
+    direction: 'LR' | 'RL' | 'TB' | 'TD' | 'BT';
+    nodes: PlayDocflowNode[];
+    edges: PlayDocflowEdge[];
+    bindings: PlayDocflowBinding[];
+    /** Authoring syntax used by the source file. Absent on older persisted graphs. */
+    syntax?: 'docflow' | 'mermaid';
+    /** Normalized Mermaid text, ready to pass directly to a Mermaid renderer. */
+    mermaidSource?: string;
+    /**
+     * Mermaid `subgraph` loop regions. Optional so older persisted graphs stay
+     * valid. Only populated for the Mermaid syntax; legacy `docflow` has none.
+     */
+    subgraphs?: PlayDocflowSubgraph[];
+    /** Mermaid directives accepted by the parser but not applied by React Flow. */
+    ignoredDirectives?: string[];
+};
+
 /**
  * A top-level key the play's function literally `return`s. Derived from the
  * `return { ... }` object literal — NOT from dataset `.withColumn(...)` names —
@@ -35,6 +120,8 @@ interface PlayStaticReturnField {
     datasetName?: string;
 }
 interface PlayStaticPipeline {
+    /** Authored business flow. Static analysis is used only when this is absent. */
+    docflow?: PlayDocflow;
     tableNamespace?: string;
     inputFields?: string[];
     rowKeyFields?: string[];
@@ -135,6 +222,12 @@ type PlayStaticSubstep = PlayStaticSubstepMetadata & ({
     waterfallIds?: string[];
     steps?: PlayStaticSubstep[];
     sheetContract?: PlaySheetContract | null;
+    /**
+     * Columns the author declared as deliberately absent from the `@mermaid`
+     * diagram via `.run({ undrawnColumns: [...] })`. The docflow column
+     * coverage gate reads this; nothing about execution does.
+     */
+    undrawnColumns?: string[];
     description?: string;
     sourceRange?: PlayStaticSourceRange;
     callDepth?: number;
@@ -1110,6 +1203,13 @@ type PlayAuthoringDatasetRunOptions<InputRow extends object> = {
     key?: PlayAuthoringDatasetRowKey<InputRow>;
     onRowError?: 'isolate' | 'fail';
     mode?: 'upsert' | 'net_new';
+    /**
+     * Computed columns this dataset produces that the authored `@mermaid`
+     * diagram deliberately does not draw. A diagrammed Play must account for
+     * every column it computes: draw it inside the dataset's `subgraph` loop
+     * region, or name it here. Nothing else opts a column out.
+     */
+    undrawnColumns?: readonly string[];
 };
 type PlayAuthoringDatasetBuilder<InputRow extends object, OutputRow extends object, TContext> = {
     /** Define one output column for every row in this dataset. */
@@ -2104,6 +2204,24 @@ declare const PLAY_AUTHORING_FIELD_REGISTRY: {
         readonly description: "Whether the dataset returns all rows or only newly admitted rows.";
         readonly errorMessage: "ctx.dataset run mode must be \"upsert\" or \"net_new\".";
     };
+    readonly 'ctx.dataset.run.undrawnColumns': {
+        readonly schema: _sinclair_typebox.TArray<_sinclair_typebox.TString>;
+        readonly fixtures: {
+            readonly valid: readonly ["miss_reason"];
+            readonly invalid: readonly [];
+            readonly absent: undefined;
+            readonly unresolved: {
+                readonly expression: "undrawnColumns";
+            };
+            readonly edition1: readonly ["miss_reason"];
+        };
+        readonly referenceType: "readonly string[]";
+        readonly required: false;
+        readonly resolution: "static-when-present";
+        readonly issueCode: "play_authoring_dataset_option_invalid";
+        readonly description: "Computed columns deliberately left out of the authored @mermaid diagram.";
+        readonly errorMessage: "ctx.dataset run undrawnColumns must be a non-empty array of static column-name strings.";
+    };
     readonly 'ctx.step.id': {
         readonly schema: _sinclair_typebox.TString;
         readonly fixtures: {

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { e as PlayRuntimeBackendId, c as PlayCompilerManifest, D as DeeplineError, f as ToolExecutionError, g as ToolExecutionErrorOptions, h as PlayAuthoringColumnMap, i as PlayAuthoringColumnResolver, j as PlayAuthoringRuntimeContext, k as PlayAuthoringConditionalStepResolver, l as PlayAuthoringCsvInput, m as PlayAuthoringCsvOptions, n as PlayAuthoringDatasetBuilder, o as PlayAuthoringDatasetColumnDefinition, p as PlayAuthoringDatasetColumnRunInput, q as ToolExecuteResult, r as PlayAuthoringReferenceLike, s as PlayReturnObject$1, t as PlayAuthoringDefineConfig, u as PlayAuthoringDefinedPlay, v as PlayAuthoringFetchOptions, w as PlayAuthoringFileInput, x as PlayAuthoringBindings, y as PlayAuthoringCallExecution, z as PlayAuthoringCallOptions, A as PlayAuthoringFetchResponse, B as PlayAuthoringInputContract, C as PlayAuthoringStepProgramStep, E as PlayAuthoringRuntimeStepOptions, F as PlaySqlListenerDeclaration, G as PlaySqlListenerEvent, H as PlaySqlListenerOperation, I as PlaySqlQuery, J as PlayAuthoringStepOptions, K as PlayAuthoringStepProgram, L as PlayAuthoringStepProgramResolver, M as PlayAuthoringStepResolver, N as PlayToolExecutionRequest } from './compiler-manifest-Cj3--4ZJ.mjs';
-export { O as DEEPLINE_EXTRACTOR_TARGETS, Q as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, R as DeeplineEmailStatusGetterValue, S as DeeplineExtractorTarget, U as DeeplineGetterValue, V as DeeplineGetterValueMap, W as JOB_CHANGE_STATUS_VALUES, X as JobChangeStatus, Y as PHONE_STATUS_VALUES, Z as PhoneStatus, _ as PlayDataset, $ as PlayDatasetInput, a0 as PreviousCell, a1 as ProviderTransientError, a2 as ProviderTransientErrorCategory, a3 as ToolExecutionErrorCategory, a4 as ToolExecutionErrorOrigin, a5 as ToolExecutionFailureV1, a6 as ToolExecutionNetworkKind, a7 as ToolExecutionNetworkScope, a8 as isDeeplineExtractorTarget } from './compiler-manifest-Cj3--4ZJ.mjs';
+import { e as PlayRuntimeBackendId, c as PlayCompilerManifest, D as DeeplineError, f as ToolExecutionError, g as ToolExecutionErrorOptions, h as PlayAuthoringColumnMap, i as PlayAuthoringColumnResolver, j as PlayAuthoringRuntimeContext, k as PlayAuthoringConditionalStepResolver, l as PlayAuthoringCsvInput, m as PlayAuthoringCsvOptions, n as PlayAuthoringDatasetBuilder, o as PlayAuthoringDatasetColumnDefinition, p as PlayAuthoringDatasetColumnRunInput, q as ToolExecuteResult, r as PlayAuthoringReferenceLike, s as PlayReturnObject$1, t as PlayAuthoringDefineConfig, u as PlayAuthoringDefinedPlay, v as PlayAuthoringFetchOptions, w as PlayAuthoringFileInput, x as PlayAuthoringBindings, y as PlayAuthoringCallExecution, z as PlayAuthoringCallOptions, A as PlayAuthoringFetchResponse, B as PlayAuthoringInputContract, C as PlayAuthoringStepProgramStep, E as PlayAuthoringRuntimeStepOptions, F as PlaySqlListenerDeclaration, G as PlaySqlListenerEvent, H as PlaySqlListenerOperation, I as PlaySqlQuery, J as PlayAuthoringStepOptions, K as PlayAuthoringStepProgram, L as PlayAuthoringStepProgramResolver, M as PlayAuthoringStepResolver, N as PlayToolExecutionRequest } from './compiler-manifest-Bl8kmLx9.mjs';
+export { O as DEEPLINE_EXTRACTOR_TARGETS, Q as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, R as DeeplineEmailStatusGetterValue, S as DeeplineExtractorTarget, U as DeeplineGetterValue, V as DeeplineGetterValueMap, W as JOB_CHANGE_STATUS_VALUES, X as JobChangeStatus, Y as PHONE_STATUS_VALUES, Z as PhoneStatus, _ as PlayDataset, $ as PlayDatasetInput, a0 as PreviousCell, a1 as ProviderTransientError, a2 as ProviderTransientErrorCategory, a3 as ToolExecutionErrorCategory, a4 as ToolExecutionErrorOrigin, a5 as ToolExecutionFailureV1, a6 as ToolExecutionNetworkKind, a7 as ToolExecutionNetworkScope, a8 as isDeeplineExtractorTarget } from './compiler-manifest-Bl8kmLx9.mjs';
 import '@sinclair/typebox';
 
 declare const FIXTURE_BEHAVIOR_VERSION: 1;
@@ -1359,6 +1359,14 @@ interface PlayCheckResult {
     graphHash?: string | null;
     /** SHA-256 of the exact source bytes checked by Deepline. */
     sourceHash?: string | null;
+    /**
+     * Per-export results, present ONLY when the checked file exports more than
+     * one play. Single-play files keep the exact flat shape they always had.
+     * Entry 0 is the default export and mirrors the top-level fields; the
+     * top-level `valid` is the AND over every entry, so an agent that reads only
+     * `valid` can never ship a file whose second play fails.
+     */
+    exports?: PlayCheckExportResult[];
     /** Enforceable byte budgets measured during cloud preflight. */
     limits?: {
         revisionStorage: {
@@ -1379,6 +1387,28 @@ interface PlayCheckResult {
         };
     };
 }
+/**
+ * One exported play's check result inside a multi-play file. Carries the same
+ * per-play fields as {@link PlayCheckResult}, unprefixed and unaggregated, so a
+ * consumer can attribute an error to the export that produced it.
+ */
+interface PlayCheckExportResult {
+    /** Canonical export name: `default`, or the named export (`batch`). */
+    exportName: string;
+    /** The `definePlay` name this export declares. */
+    name?: string | null;
+    valid: boolean;
+    errors: string[];
+    warnings?: string[];
+    issues?: PlayCheckIssue[];
+    staticPipeline?: Record<string, unknown> | null;
+    artifactHash?: string | null;
+    graphHash?: string | null;
+    sourceHash?: string | null;
+    summary?: string;
+    recognized?: PlayCheckRecognizedSummary;
+    triggers?: PlayCheckTriggersSummary | null;
+}
 /** Severity of a {@link PlayCheckIssue}. `error` fails the check; `warning` does not. */
 type PlayCheckIssueSeverity = 'error' | 'warning';
 /**
@@ -1392,6 +1422,12 @@ interface PlayCheckIssue {
     code: string;
     severity: PlayCheckIssueSeverity;
     message: string;
+    /**
+     * Which exported play raised this issue, when the checked file exports more
+     * than one and this is not the default export. Absent everywhere else, so
+     * the structured channel stays byte-identical for single-play files.
+     */
+    exportName?: string;
     path?: string;
     hint?: string;
     validOptions?: string[];
@@ -1404,9 +1440,15 @@ interface PlayCheckIssue {
 interface PlayCheckRecognizedSummary {
     triggers?: PlayCheckTriggersSummary;
     tools?: string[];
+    /**
+     * Durable datasets the play produces. `undrawnColumns` echoes the columns the
+     * author declared out of an authored `@mermaid` diagram with
+     * `.run({ undrawnColumns: [...] })`, so an opt-out is visible in check output.
+     */
     datasets?: {
         name: string;
         columns?: string[];
+        undrawnColumns?: string[];
     }[];
     inputs?: string[];
     outputs?: string[];
@@ -2796,6 +2838,9 @@ declare class DeeplineClient {
         sourceFiles?: Record<string, string>;
         description?: string;
         artifact: Record<string, unknown>;
+        /** Which exported play in `sourceCode` this artifact is, when the file
+         *  exports more than one. Omit for the default export. */
+        exportName?: string | null;
         integrationMode?: 'live' | 'eval_stub' | 'fixture';
         /**
          * Sibling plays from the same local bundle graph. Lets the server splice

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { e as PlayRuntimeBackendId, c as PlayCompilerManifest, D as DeeplineError, f as ToolExecutionError, g as ToolExecutionErrorOptions, h as PlayAuthoringColumnMap, i as PlayAuthoringColumnResolver, j as PlayAuthoringRuntimeContext, k as PlayAuthoringConditionalStepResolver, l as PlayAuthoringCsvInput, m as PlayAuthoringCsvOptions, n as PlayAuthoringDatasetBuilder, o as PlayAuthoringDatasetColumnDefinition, p as PlayAuthoringDatasetColumnRunInput, q as ToolExecuteResult, r as PlayAuthoringReferenceLike, s as PlayReturnObject$1, t as PlayAuthoringDefineConfig, u as PlayAuthoringDefinedPlay, v as PlayAuthoringFetchOptions, w as PlayAuthoringFileInput, x as PlayAuthoringBindings, y as PlayAuthoringCallExecution, z as PlayAuthoringCallOptions, A as PlayAuthoringFetchResponse, B as PlayAuthoringInputContract, C as PlayAuthoringStepProgramStep, E as PlayAuthoringRuntimeStepOptions, F as PlaySqlListenerDeclaration, G as PlaySqlListenerEvent, H as PlaySqlListenerOperation, I as PlaySqlQuery, J as PlayAuthoringStepOptions, K as PlayAuthoringStepProgram, L as PlayAuthoringStepProgramResolver, M as PlayAuthoringStepResolver, N as PlayToolExecutionRequest } from './compiler-manifest-Cj3--4ZJ.js';
-export { O as DEEPLINE_EXTRACTOR_TARGETS, Q as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, R as DeeplineEmailStatusGetterValue, S as DeeplineExtractorTarget, U as DeeplineGetterValue, V as DeeplineGetterValueMap, W as JOB_CHANGE_STATUS_VALUES, X as JobChangeStatus, Y as PHONE_STATUS_VALUES, Z as PhoneStatus, _ as PlayDataset, $ as PlayDatasetInput, a0 as PreviousCell, a1 as ProviderTransientError, a2 as ProviderTransientErrorCategory, a3 as ToolExecutionErrorCategory, a4 as ToolExecutionErrorOrigin, a5 as ToolExecutionFailureV1, a6 as ToolExecutionNetworkKind, a7 as ToolExecutionNetworkScope, a8 as isDeeplineExtractorTarget } from './compiler-manifest-Cj3--4ZJ.js';
+import { e as PlayRuntimeBackendId, c as PlayCompilerManifest, D as DeeplineError, f as ToolExecutionError, g as ToolExecutionErrorOptions, h as PlayAuthoringColumnMap, i as PlayAuthoringColumnResolver, j as PlayAuthoringRuntimeContext, k as PlayAuthoringConditionalStepResolver, l as PlayAuthoringCsvInput, m as PlayAuthoringCsvOptions, n as PlayAuthoringDatasetBuilder, o as PlayAuthoringDatasetColumnDefinition, p as PlayAuthoringDatasetColumnRunInput, q as ToolExecuteResult, r as PlayAuthoringReferenceLike, s as PlayReturnObject$1, t as PlayAuthoringDefineConfig, u as PlayAuthoringDefinedPlay, v as PlayAuthoringFetchOptions, w as PlayAuthoringFileInput, x as PlayAuthoringBindings, y as PlayAuthoringCallExecution, z as PlayAuthoringCallOptions, A as PlayAuthoringFetchResponse, B as PlayAuthoringInputContract, C as PlayAuthoringStepProgramStep, E as PlayAuthoringRuntimeStepOptions, F as PlaySqlListenerDeclaration, G as PlaySqlListenerEvent, H as PlaySqlListenerOperation, I as PlaySqlQuery, J as PlayAuthoringStepOptions, K as PlayAuthoringStepProgram, L as PlayAuthoringStepProgramResolver, M as PlayAuthoringStepResolver, N as PlayToolExecutionRequest } from './compiler-manifest-Bl8kmLx9.js';
+export { O as DEEPLINE_EXTRACTOR_TARGETS, Q as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, R as DeeplineEmailStatusGetterValue, S as DeeplineExtractorTarget, U as DeeplineGetterValue, V as DeeplineGetterValueMap, W as JOB_CHANGE_STATUS_VALUES, X as JobChangeStatus, Y as PHONE_STATUS_VALUES, Z as PhoneStatus, _ as PlayDataset, $ as PlayDatasetInput, a0 as PreviousCell, a1 as ProviderTransientError, a2 as ProviderTransientErrorCategory, a3 as ToolExecutionErrorCategory, a4 as ToolExecutionErrorOrigin, a5 as ToolExecutionFailureV1, a6 as ToolExecutionNetworkKind, a7 as ToolExecutionNetworkScope, a8 as isDeeplineExtractorTarget } from './compiler-manifest-Bl8kmLx9.js';
 import '@sinclair/typebox';
 
 declare const FIXTURE_BEHAVIOR_VERSION: 1;
@@ -1359,6 +1359,14 @@ interface PlayCheckResult {
     graphHash?: string | null;
     /** SHA-256 of the exact source bytes checked by Deepline. */
     sourceHash?: string | null;
+    /**
+     * Per-export results, present ONLY when the checked file exports more than
+     * one play. Single-play files keep the exact flat shape they always had.
+     * Entry 0 is the default export and mirrors the top-level fields; the
+     * top-level `valid` is the AND over every entry, so an agent that reads only
+     * `valid` can never ship a file whose second play fails.
+     */
+    exports?: PlayCheckExportResult[];
     /** Enforceable byte budgets measured during cloud preflight. */
     limits?: {
         revisionStorage: {
@@ -1379,6 +1387,28 @@ interface PlayCheckResult {
         };
     };
 }
+/**
+ * One exported play's check result inside a multi-play file. Carries the same
+ * per-play fields as {@link PlayCheckResult}, unprefixed and unaggregated, so a
+ * consumer can attribute an error to the export that produced it.
+ */
+interface PlayCheckExportResult {
+    /** Canonical export name: `default`, or the named export (`batch`). */
+    exportName: string;
+    /** The `definePlay` name this export declares. */
+    name?: string | null;
+    valid: boolean;
+    errors: string[];
+    warnings?: string[];
+    issues?: PlayCheckIssue[];
+    staticPipeline?: Record<string, unknown> | null;
+    artifactHash?: string | null;
+    graphHash?: string | null;
+    sourceHash?: string | null;
+    summary?: string;
+    recognized?: PlayCheckRecognizedSummary;
+    triggers?: PlayCheckTriggersSummary | null;
+}
 /** Severity of a {@link PlayCheckIssue}. `error` fails the check; `warning` does not. */
 type PlayCheckIssueSeverity = 'error' | 'warning';
 /**
@@ -1392,6 +1422,12 @@ interface PlayCheckIssue {
     code: string;
     severity: PlayCheckIssueSeverity;
     message: string;
+    /**
+     * Which exported play raised this issue, when the checked file exports more
+     * than one and this is not the default export. Absent everywhere else, so
+     * the structured channel stays byte-identical for single-play files.
+     */
+    exportName?: string;
     path?: string;
     hint?: string;
     validOptions?: string[];
@@ -1404,9 +1440,15 @@ interface PlayCheckIssue {
 interface PlayCheckRecognizedSummary {
     triggers?: PlayCheckTriggersSummary;
     tools?: string[];
+    /**
+     * Durable datasets the play produces. `undrawnColumns` echoes the columns the
+     * author declared out of an authored `@mermaid` diagram with
+     * `.run({ undrawnColumns: [...] })`, so an opt-out is visible in check output.
+     */
     datasets?: {
         name: string;
         columns?: string[];
+        undrawnColumns?: string[];
     }[];
     inputs?: string[];
     outputs?: string[];
@@ -2796,6 +2838,9 @@ declare class DeeplineClient {
         sourceFiles?: Record<string, string>;
         description?: string;
         artifact: Record<string, unknown>;
+        /** Which exported play in `sourceCode` this artifact is, when the file
+         *  exports more than one. Omit for the default export. */
+        exportName?: string | null;
         integrationMode?: 'live' | 'eval_stub' | 'fixture';
         /**
          * Sibling plays from the same local bundle graph. Lets the server splice