deepline 0.2.55 → 0.2.57

package/dist/{compiler-manifest-Bl8kmLx9.d.mts → compiler-manifest-TgaC4DeD.d.mts}

@@ -21,6 +21,19 @@ type PlayDocflowNode = {
     id: string;
     label: string;
     kind: PlayDocflowNodeKind;
+    /**
+     * No statement in this play runs this box — the author said so with
+     * `class <id> sketch`. See {@link SKETCH_CLASS}.
+     *
+     * Deliberately NOT a `kind`. What a box IS (an action, a decision, a dataset)
+     * and whether code binds it are two different questions, and folding the
+     * second into the first was wrong in a way the tests caught immediately: a
+     * sketched diamond stopped being a decision, so it lost its shape on the
+     * canvas and the branch-label lint stopped checking its arms. Absent rather
+     * than `false` when bound, so the JSON a bound diagram hashes to is byte for
+     * byte what it was before sketches existed.
+     */
+    sketch?: true;
 };
 /**
  * Which arm of a conditional a drawn decision edge IS.

package/dist/{compiler-manifest-Bl8kmLx9.d.ts → compiler-manifest-TgaC4DeD.d.ts}

@@ -21,6 +21,19 @@ type PlayDocflowNode = {
     id: string;
     label: string;
     kind: PlayDocflowNodeKind;
+    /**
+     * No statement in this play runs this box — the author said so with
+     * `class <id> sketch`. See {@link SKETCH_CLASS}.
+     *
+     * Deliberately NOT a `kind`. What a box IS (an action, a decision, a dataset)
+     * and whether code binds it are two different questions, and folding the
+     * second into the first was wrong in a way the tests caught immediately: a
+     * sketched diamond stopped being a decision, so it lost its shape on the
+     * canvas and the branch-label lint stopped checking its arms. Absent rather
+     * than `false` when bound, so the JSON a bound diagram hashes to is byte for
+     * byte what it was before sketches existed.
+     */
+    sketch?: true;
 };
 /**
  * Which arm of a conditional a drawn decision edge IS.

package/dist/index.d.mts

@@ -1,9 +1,10 @@
-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 { 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-TgaC4DeD.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-TgaC4DeD.mjs';
 import '@sinclair/typebox';
 
 declare const FIXTURE_BEHAVIOR_VERSION: 1;
 declare const FIXTURE_BEHAVIOR_RESPONSE_VERSION: 2;
+declare const FIXTURE_BEHAVIOR_REPLAY_VERSION: 3;
 type FixtureBehaviorV1 = {
     version: typeof FIXTURE_BEHAVIOR_VERSION;
     responseDelaySamplesMs: number[];
@@ -23,7 +24,17 @@ type FixtureBehaviorV2 = {
     version: typeof FIXTURE_BEHAVIOR_RESPONSE_VERSION;
     responseSamples: FixtureResponseSample[];
 };
-type FixtureBehavior = FixtureBehaviorV1 | FixtureBehaviorV2;
+type FixtureReplayBundle = {
+    bundleId: string;
+    manifestSha256: string;
+    syntheticFallbackToolIds?: string[];
+};
+type FixtureBehaviorV3 = {
+    version: typeof FIXTURE_BEHAVIOR_REPLAY_VERSION;
+    responseSamples: FixtureResponseSample[];
+    replayBundle: FixtureReplayBundle;
+};
+type FixtureBehavior = FixtureBehaviorV1 | FixtureBehaviorV2 | FixtureBehaviorV3;
 
 type PlayRuntimeSelection = {
     environment: 'preview';
@@ -1567,6 +1578,13 @@ interface StartPlayRunRequest {
     force?: boolean;
     /** Explicit cache-bypass flag for durable dataset and tool-call reuse. */
     forceToolRefresh?: boolean;
+    /**
+     * Per-run ceiling for concurrently resident provider-tool executions and
+     * direct ctx.fetch calls. The server validates the supported range.
+     */
+    maxConcurrentExternalCalls?: number;
+    /** Run-wide default and ceiling for live dataset-map row resolvers. */
+    maxConcurrentRows?: number;
     /** Optionally let the start request wait briefly and return a terminal result. */
     waitForCompletionMs?: number;
     /**

package/dist/index.d.ts

@@ -1,9 +1,10 @@
-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 { 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-TgaC4DeD.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-TgaC4DeD.js';
 import '@sinclair/typebox';
 
 declare const FIXTURE_BEHAVIOR_VERSION: 1;
 declare const FIXTURE_BEHAVIOR_RESPONSE_VERSION: 2;
+declare const FIXTURE_BEHAVIOR_REPLAY_VERSION: 3;
 type FixtureBehaviorV1 = {
     version: typeof FIXTURE_BEHAVIOR_VERSION;
     responseDelaySamplesMs: number[];
@@ -23,7 +24,17 @@ type FixtureBehaviorV2 = {
     version: typeof FIXTURE_BEHAVIOR_RESPONSE_VERSION;
     responseSamples: FixtureResponseSample[];
 };
-type FixtureBehavior = FixtureBehaviorV1 | FixtureBehaviorV2;
+type FixtureReplayBundle = {
+    bundleId: string;
+    manifestSha256: string;
+    syntheticFallbackToolIds?: string[];
+};
+type FixtureBehaviorV3 = {
+    version: typeof FIXTURE_BEHAVIOR_REPLAY_VERSION;
+    responseSamples: FixtureResponseSample[];
+    replayBundle: FixtureReplayBundle;
+};
+type FixtureBehavior = FixtureBehaviorV1 | FixtureBehaviorV2 | FixtureBehaviorV3;
 
 type PlayRuntimeSelection = {
     environment: 'preview';
@@ -1567,6 +1578,13 @@ interface StartPlayRunRequest {
     force?: boolean;
     /** Explicit cache-bypass flag for durable dataset and tool-call reuse. */
     forceToolRefresh?: boolean;
+    /**
+     * Per-run ceiling for concurrently resident provider-tool executions and
+     * direct ctx.fetch calls. The server validates the supported range.
+     */
+    maxConcurrentExternalCalls?: number;
+    /** Run-wide default and ceiling for live dataset-map row resolvers. */
+    maxConcurrentRows?: number;
     /** Optionally let the start request wait briefly and return a terminal result. */
     waitForCompletionMs?: number;
     /**

package/dist/index.js

@@ -763,7 +763,7 @@ var SDK_RELEASE = {
   // 0.2.0 makes Dataset Handles uniformly async-only after 0.1.320 briefly
   // exposed storage-dependent synchronous access. This deliberate minor
   // release keeps lazy paging semantics independent of row residency.
-  version: "0.2.55",
+  version: "0.2.57",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -1346,9 +1346,26 @@ var HttpClient = class {
         if (error instanceof AuthError || error instanceof DeeplineError) {
           throw error;
         }
-        lastError = error instanceof Error ? error : new Error(String(error));
+        const normalized = error instanceof Error ? error : new Error(String(error));
+        if (isAbortLikeError(normalized) && options?.signal?.aborted) {
+          throw new DeeplineError(
+            `Stream from ${this.config.baseUrl} was aborted by the caller.`,
+            void 0,
+            "ABORTED"
+          );
+        }
+        lastError = normalized;
       }
     }
+    if (lastError && isAbortLikeError(lastError)) {
+      throw new DeeplineError(
+        withCoworkNetworkHint(
+          `Unable to stream from ${this.config.baseUrl}. The remote stream was interrupted.`
+        ),
+        void 0,
+        "PLAY_STREAM_NETWORK_ABORTED"
+      );
+    }
     throw new DeeplineError(
       withCoworkNetworkHint(
         lastError?.message ? `Unable to stream from ${this.config.baseUrl}. ${lastError.message}` : `Unable to stream from ${this.config.baseUrl}.`
@@ -1611,6 +1628,9 @@ function streamReconnectDelayMs(attempt) {
   return Math.max(1, Math.floor(Math.random() * (cappedExponentialMs + 1)));
 }
 function isTransientPlayStreamError(error) {
+  if (error instanceof DeeplineError && error.code === "PLAY_STREAM_NETWORK_ABORTED") {
+    return true;
+  }
   if (error instanceof DeeplineError && typeof error.statusCode === "number") {
     return error.statusCode >= 500 && error.statusCode < 600;
   }
@@ -1763,6 +1783,7 @@ var RUNTIME_RECEIPT_OUTPUT_MAX_BYTES = 10 * 1024 * 1024;
 var RUNTIME_RECEIPT_COMPLETION_BUFFER_MAX_BYTES = 32 * 1024 * 1024;
 var RUNNER_TERMINAL_PUSH_MAX_BODY_BYTES = 16 * 1024 * 1024;
 var RUNTIME_RECEIPT_GATEWAY_BATCH_MAX_BYTES = 12 * 1024 * 1024;
+var RUNTIME_RECEIPT_WRITER_TARGET_BATCH_BYTES = 4 * 1024 * 1024;
 var RUNNER_POST_TERMINAL_DIAGNOSTIC_MAX_BYTES = 64 * 1024;
 
 // ../shared_libs/play-runtime/ledger-safe-payload.ts
@@ -4345,6 +4366,10 @@ var DeeplineClient = class {
         ...request.packagedFiles?.length ? { packagedFiles: request.packagedFiles } : {},
         ...request.force ? { force: true } : {},
         ...forceToolRefresh ? { forceToolRefresh: true } : {},
+        ...typeof request.maxConcurrentExternalCalls === "number" ? {
+          maxConcurrentExternalCalls: request.maxConcurrentExternalCalls
+        } : {},
+        ...typeof request.maxConcurrentRows === "number" ? { maxConcurrentRows: request.maxConcurrentRows } : {},
         ...typeof request.waitForCompletionMs === "number" ? { waitForCompletionMs: request.waitForCompletionMs } : {},
         // Profile selection is the API's job, not the CLI's. The server
         // defaults to absurd; callers normally omit this field.
@@ -4397,6 +4422,8 @@ var DeeplineClient = class {
       ...request.packagedFiles?.length ? { packagedFiles: request.packagedFiles } : {},
       ...request.force ? { force: true } : {},
       ...forceToolRefresh ? { forceToolRefresh: true } : {},
+      ...typeof request.maxConcurrentExternalCalls === "number" ? { maxConcurrentExternalCalls: request.maxConcurrentExternalCalls } : {},
+      ...typeof request.maxConcurrentRows === "number" ? { maxConcurrentRows: request.maxConcurrentRows } : {},
       ...typeof request.waitForCompletionMs === "number" ? { waitForCompletionMs: request.waitForCompletionMs } : {},
       ...request.profile ? { profile: request.profile } : {},
       ...integrationMode ? { integrationMode } : {},

package/dist/index.mjs

@@ -689,7 +689,7 @@ var SDK_RELEASE = {
   // 0.2.0 makes Dataset Handles uniformly async-only after 0.1.320 briefly
   // exposed storage-dependent synchronous access. This deliberate minor
   // release keeps lazy paging semantics independent of row residency.
-  version: "0.2.55",
+  version: "0.2.57",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -1272,9 +1272,26 @@ var HttpClient = class {
         if (error instanceof AuthError || error instanceof DeeplineError) {
           throw error;
         }
-        lastError = error instanceof Error ? error : new Error(String(error));
+        const normalized = error instanceof Error ? error : new Error(String(error));
+        if (isAbortLikeError(normalized) && options?.signal?.aborted) {
+          throw new DeeplineError(
+            `Stream from ${this.config.baseUrl} was aborted by the caller.`,
+            void 0,
+            "ABORTED"
+          );
+        }
+        lastError = normalized;
       }
     }
+    if (lastError && isAbortLikeError(lastError)) {
+      throw new DeeplineError(
+        withCoworkNetworkHint(
+          `Unable to stream from ${this.config.baseUrl}. The remote stream was interrupted.`
+        ),
+        void 0,
+        "PLAY_STREAM_NETWORK_ABORTED"
+      );
+    }
     throw new DeeplineError(
       withCoworkNetworkHint(
         lastError?.message ? `Unable to stream from ${this.config.baseUrl}. ${lastError.message}` : `Unable to stream from ${this.config.baseUrl}.`
@@ -1537,6 +1554,9 @@ function streamReconnectDelayMs(attempt) {
   return Math.max(1, Math.floor(Math.random() * (cappedExponentialMs + 1)));
 }
 function isTransientPlayStreamError(error) {
+  if (error instanceof DeeplineError && error.code === "PLAY_STREAM_NETWORK_ABORTED") {
+    return true;
+  }
   if (error instanceof DeeplineError && typeof error.statusCode === "number") {
     return error.statusCode >= 500 && error.statusCode < 600;
   }
@@ -1689,6 +1709,7 @@ var RUNTIME_RECEIPT_OUTPUT_MAX_BYTES = 10 * 1024 * 1024;
 var RUNTIME_RECEIPT_COMPLETION_BUFFER_MAX_BYTES = 32 * 1024 * 1024;
 var RUNNER_TERMINAL_PUSH_MAX_BODY_BYTES = 16 * 1024 * 1024;
 var RUNTIME_RECEIPT_GATEWAY_BATCH_MAX_BYTES = 12 * 1024 * 1024;
+var RUNTIME_RECEIPT_WRITER_TARGET_BATCH_BYTES = 4 * 1024 * 1024;
 var RUNNER_POST_TERMINAL_DIAGNOSTIC_MAX_BYTES = 64 * 1024;
 
 // ../shared_libs/play-runtime/ledger-safe-payload.ts
@@ -4271,6 +4292,10 @@ var DeeplineClient = class {
         ...request.packagedFiles?.length ? { packagedFiles: request.packagedFiles } : {},
         ...request.force ? { force: true } : {},
         ...forceToolRefresh ? { forceToolRefresh: true } : {},
+        ...typeof request.maxConcurrentExternalCalls === "number" ? {
+          maxConcurrentExternalCalls: request.maxConcurrentExternalCalls
+        } : {},
+        ...typeof request.maxConcurrentRows === "number" ? { maxConcurrentRows: request.maxConcurrentRows } : {},
         ...typeof request.waitForCompletionMs === "number" ? { waitForCompletionMs: request.waitForCompletionMs } : {},
         // Profile selection is the API's job, not the CLI's. The server
         // defaults to absurd; callers normally omit this field.
@@ -4323,6 +4348,8 @@ var DeeplineClient = class {
       ...request.packagedFiles?.length ? { packagedFiles: request.packagedFiles } : {},
       ...request.force ? { force: true } : {},
       ...forceToolRefresh ? { forceToolRefresh: true } : {},
+      ...typeof request.maxConcurrentExternalCalls === "number" ? { maxConcurrentExternalCalls: request.maxConcurrentExternalCalls } : {},
+      ...typeof request.maxConcurrentRows === "number" ? { maxConcurrentRows: request.maxConcurrentRows } : {},
       ...typeof request.waitForCompletionMs === "number" ? { waitForCompletionMs: request.waitForCompletionMs } : {},
       ...request.profile ? { profile: request.profile } : {},
       ...integrationMode ? { integrationMode } : {},

package/dist/install-integrity.json

@@ -225,8 +225,8 @@
     "dist/cli/index.d.ts",
     "dist/cli/index.js",
     "dist/cli/index.mjs",
-    "dist/compiler-manifest-Bl8kmLx9.d.mts",
-    "dist/compiler-manifest-Bl8kmLx9.d.ts",
+    "dist/compiler-manifest-TgaC4DeD.d.mts",
+    "dist/compiler-manifest-TgaC4DeD.d.ts",
     "dist/helpers.d.mts",
     "dist/helpers.d.ts",
     "dist/helpers.js",

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

@@ -1,5 +1,5 @@
-import { T as ToolExecutionErrorSchemaVersion, P as PlayAuthoringContractEdition, a as PlayArtifactKind$1, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-Bl8kmLx9.mjs';
-export { d as PLAY_ARTIFACT_KINDS } from '../compiler-manifest-Bl8kmLx9.mjs';
+import { T as ToolExecutionErrorSchemaVersion, P as PlayAuthoringContractEdition, a as PlayArtifactKind$1, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-TgaC4DeD.mjs';
+export { d as PLAY_ARTIFACT_KINDS } from '../compiler-manifest-TgaC4DeD.mjs';
 import '@sinclair/typebox';
 
 type PlayPackageImport = {

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

@@ -1,5 +1,5 @@
-import { T as ToolExecutionErrorSchemaVersion, P as PlayAuthoringContractEdition, a as PlayArtifactKind$1, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-Bl8kmLx9.js';
-export { d as PLAY_ARTIFACT_KINDS } from '../compiler-manifest-Bl8kmLx9.js';
+import { T as ToolExecutionErrorSchemaVersion, P as PlayAuthoringContractEdition, a as PlayArtifactKind$1, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-TgaC4DeD.js';
+export { d as PLAY_ARTIFACT_KINDS } from '../compiler-manifest-TgaC4DeD.js';
 import '@sinclair/typebox';
 
 type PlayPackageImport = {

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

@@ -4059,6 +4059,12 @@ function isDefinePlayCall(node) {
   }
   return false;
 }
+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;
+}
 function listPlayFileExports(sourceCode) {
   const ast = parsePlaySourceForAnalysis(sourceCode);
   if (!ast) return null;
@@ -4108,13 +4114,24 @@ function listPlayFileExports(sourceCode) {
   if (defaultIsPlay) {
     const aliases = defaultLocalName ? [...namedExports.entries()].filter(([, local]) => local === defaultLocalName).map(([exported]) => exported) : [];
     if (defaultLocalName) aliasedLocals.add(defaultLocalName);
-    exports.push({ name: PLAY_DEFAULT_EXPORT, aliases });
+    exports.push({
+      name: PLAY_DEFAULT_EXPORT,
+      aliases,
+      playName: definePlayName(
+        defaultLocalName ? declarations.get(defaultLocalName) ?? null : defaultExpression
+      )
+    });
   }
   for (const [exportedName, localName] of namedExports) {
     if (exportedName === PLAY_DEFAULT_EXPORT) continue;
     if (aliasedLocals.has(localName)) continue;
-    if (!isDefinePlayCall(declarations.get(localName) ?? null)) continue;
-    exports.push({ name: exportedName, aliases: [] });
+    const declaration = declarations.get(localName) ?? null;
+    if (!isDefinePlayCall(declaration)) continue;
+    exports.push({
+      name: exportedName,
+      aliases: [],
+      playName: definePlayName(declaration)
+    });
   }
   return exports;
 }
@@ -4125,10 +4142,17 @@ function canonicalPlayExportName(exportName, exports) {
       return entry.name;
     }
   }
+  for (const entry of exports) {
+    if (entry.playName === requested) return entry.name;
+  }
   return null;
 }
 function playExportNamesForMessage(exports) {
-  return exports.flatMap((entry) => [entry.name, ...entry.aliases]);
+  return exports.flatMap((entry) => [
+    ...entry.playName ? [entry.playName] : [],
+    entry.name,
+    ...entry.aliases
+  ]);
 }
 
 // ../shared_libs/plays/docflow.ts
@@ -4150,6 +4174,7 @@ var ATTRIBUTE = /([A-Za-z][\w-]*)\s*:\s*"([^"\n]*)"/y;
 var MERMAID_NODE_ATTRIBUTES = ["label", "type", "in", "out", "arm"];
 var LEGACY_DOCFLOW_ATTRIBUTES = ["id", ...MERMAID_NODE_ATTRIBUTES];
 var MERMAID_NODE_ID = /^[A-Za-z][\w-]*/;
+var SKETCH_CLASS = /^\s*class\s+([A-Za-z][\w-]*(?:\s*,\s*[A-Za-z][\w-]*)*)\s+sketch\s*;?\s*$/;
 var MERMAID_NODE_SHAPES = [
   ["[[", "]]"],
   ["[(", ")]"],
@@ -4375,7 +4400,7 @@ function inferBindingIo(statement) {
 }
 var MERMAID_BLOCK = /\/\*\*\s*@mermaid(?:\s|\r?\n)([\s\S]*?)\*\//g;
 var LEGACY_BLOCK = /\/\*\*\s*@docflow(?:\s|\r?\n)([\s\S]*?)\*\//;
-var BLOCK_EXPORT_HEADER = /^[A-Za-z_$][\w$]*$/;
+var BLOCK_EXPORT_HEADER = /^[A-Za-z_$][\w$-]*$/;
 function cleanBlockBody(raw) {
   return raw.split(/\r?\n/).map((line) => /^\s*\*/.test(line) ? line.replace(/^\s*\* ?/, "") : line).join("\n").trim();
 }
@@ -4407,6 +4432,7 @@ function parseDocflowBlockGraph(mermaidSource, syntax, errors) {
   const edges = [];
   const subgraphs = /* @__PURE__ */ new Map();
   const ignoredDirectives = [];
+  const sketchIds = /* @__PURE__ */ new Set();
   const subgraphStack = [];
   const subgraphIds = /* @__PURE__ */ new Set();
   if (syntax === "mermaid") {
@@ -4483,7 +4509,15 @@ function parseDocflowBlockGraph(mermaidSource, syntax, errors) {
     let declaredOnThisLine = false;
     const isDirective = /^\s*(?:direction|classDef|class|style|linkStyle|click)\b/i.test(line);
     if (syntax === "mermaid" && isDirective) {
-      ignoredDirectives.push(line.trim());
+      const sketch = SKETCH_CLASS.exec(line);
+      if (sketch) {
+        for (const id of sketch[1].split(",")) {
+          const trimmed = id.trim();
+          if (trimmed) sketchIds.add(trimmed);
+        }
+      } else {
+        ignoredDirectives.push(line.trim());
+      }
     }
     if (syntax === "mermaid" && !isDirective) {
       declaredOnThisLine = addNodes(line, line);
@@ -4532,7 +4566,17 @@ function parseDocflowBlockGraph(mermaidSource, syntax, errors) {
       `Docflow node "${node.id}" is referenced by an edge but never declared with a shape and label, so the canvas would show its id. Declare it once, e.g. \`${node.id}["What this step does"]\`.`
     );
   }
-  return { direction, nodes, edges, subgraphs, ignoredDirectives };
+  for (const id of sketchIds) {
+    const node = nodes.get(id);
+    if (!node) {
+      errors.push(
+        subgraphs.has(id) ? `Docflow \`class ${id} sketch\` names a subgraph. A subgraph is a region, not a box, and never binds code \u2014 drop it from the class line.` : `Docflow \`class ${id} sketch\` names "${id}", which this diagram does not draw.`
+      );
+      continue;
+    }
+    node.sketch = true;
+  }
+  return { direction, nodes, edges, subgraphs, ignoredDirectives, sketchIds };
 }
 function materializeDocflow(block) {
   return {
@@ -4548,7 +4592,8 @@ function materializeDocflow(block) {
 }
 function parsePlayDocflowFile(sourceCode) {
   const errors = [];
-  const bindings = parseDocflowBindings(sourceCode, errors);
+  const rejectedNodeIds = /* @__PURE__ */ new Set();
+  const bindings = parseDocflowBindings(sourceCode, errors, rejectedNodeIds);
   const rawBlocks = [];
   MERMAID_BLOCK.lastIndex = 0;
   for (const match of sourceCode.matchAll(MERMAID_BLOCK)) {
@@ -4576,7 +4621,13 @@ function parsePlayDocflowFile(sourceCode) {
     });
   }
   resolveBlockExports(sourceCode, parsedBlocks, errors);
-  attachBindingsToBlocks(sourceCode, parsedBlocks, bindings, errors);
+  attachBindingsToBlocks(
+    sourceCode,
+    parsedBlocks,
+    bindings,
+    errors,
+    rejectedNodeIds
+  );
   return {
     blocks: parsedBlocks.filter((block) => block.exportName !== null).map((block) => ({
       exportName: block.exportName,
@@ -4723,7 +4774,7 @@ function projectRecordedArms(block, errors) {
     edge.arm = binding.arm;
   }
 }
-function attachBindingsToBlocks(sourceCode, blocks, bindings, errors) {
+function attachBindingsToBlocks(sourceCode, blocks, bindings, errors, rejectedNodeIds) {
   const lineStarts = sourceLineStartsForDocflow(sourceCode);
   const exportRanges = playExportSourceRanges(sourceCode);
   for (const binding of bindings) {
@@ -4764,17 +4815,22 @@ function attachBindingsToBlocks(sourceCode, blocks, bindings, errors) {
     for (const binding of block.bindings) {
       const node = block.nodes.get(binding.nodeId);
       if (binding.label) node.label = binding.label;
+      if (block.sketchIds.has(binding.nodeId)) {
+        errors.push(
+          `Docflow box "${binding.nodeId}" is declared \`class ${binding.nodeId} sketch\` and also bound by \`// @mermaid-node ${binding.nodeId}\` on line ${binding.line}. It is one or the other: drop it from the class line, or drop the annotation.`
+        );
+        continue;
+      }
       if (binding.kind) node.kind = binding.kind;
     }
     projectRecordedArms(block, errors);
-    if (block.syntax !== "docflow") continue;
     const bound = new Set(block.bindings.map((binding) => binding.nodeId));
     for (const node of block.nodes.values()) {
-      if (node.kind !== "conceptual" && !bound.has(node.id)) {
-        errors.push(
-          `Docflow node "${node.id}" has no code binding; mark it type:"conceptual" or bind it.`
-        );
-      }
+      if (node.sketch || node.kind === "conceptual" || bound.has(node.id) || rejectedNodeIds.has(node.id))
+        continue;
+      errors.push(
+        block.syntax === "docflow" ? `Docflow node "${node.id}" has no code binding; mark it type:"conceptual" or bind it.` : `Docflow box "${node.id}" in \`${blockLabel(block)}\` points at nothing, so the canvas can only draw it and say nothing about it. Either put \`// @mermaid-node ${node.id}\` above the statement it runs, or \u2014 if this play has no such statement, because the work happens in another module or inside a loop \u2014 add it to a \`class ${node.id} sketch\` line in the block to declare it a sketch.`
+      );
     }
   }
 }
@@ -4785,7 +4841,7 @@ function sourceLineStartsForDocflow(sourceCode) {
   }
   return starts;
 }
-function parseDocflowBindings(sourceCode, errors) {
+function parseDocflowBindings(sourceCode, errors, rejectedNodeIds) {
   const lines = sourceCode.split(/\r?\n/);
   const bindings = [];
   for (let index = 0; index < lines.length; index += 1) {
@@ -4794,6 +4850,8 @@ function parseDocflowBindings(sourceCode, errors) {
     const legacyMatch = PUT.exec(lines[index]);
     const mermaidMatch = MERMAID_NODE.exec(lines[index]);
     if (!legacyMatch && !mermaidMatch) continue;
+    const annotatedId = mermaidMatch?.[1]?.trim();
+    if (annotatedId) rejectedNodeIds.add(annotatedId);
     const attributes = parseAttributes(
       mermaidMatch ? mermaidMatch[2] ?? "" : legacyMatch[1],
       {
@@ -4803,11 +4861,12 @@ function parseDocflowBindings(sourceCode, errors) {
       }
     );
     if (!attributes) continue;
-    const id = (mermaidMatch ? mermaidMatch[1] : attributes.id)?.trim();
+    const id = (annotatedId ?? attributes.id)?.trim();
     if (!id) {
       errors.push(`Docflow annotation on line ${index + 1} requires id:"\u2026".`);
       continue;
     }
+    rejectedNodeIds.add(id);
     const kind = nodeKind(attributes.type);
     if (attributes.type && !kind) {
       errors.push(
@@ -4853,6 +4912,7 @@ function parseDocflowBindings(sourceCode, errors) {
       ...outputs ? { outputs } : {},
       ioConfidence: "explicit"
     } : inferBindingIo(lines[nextLine]);
+    rejectedNodeIds.delete(id);
     bindings.push({
       nodeId: id,
       line: nextLine + 1,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.2.55",
+  "version": "0.2.57",
   "description": "Deepline SDK + CLI — B2B data enrichment powered by durable cloud execution",
   "license": "MIT",
   "repository": {