deepline 0.2.37 → 0.2.38

package/dist/bundling-sources/sdk/src/release.ts

@@ -160,7 +160,7 @@ export const 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.37',
+  version: '0.2.38',
   contracts: {
     api: {
       name: 'sdk-http-api',

package/dist/cli/index.js

@@ -1044,7 +1044,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.37",
+  version: "0.2.38",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -24840,6 +24840,9 @@ function renderWaterfallColumns(command, forceAliases, inlineRunJavascript, idio
   ];
 }
 function compileEnrichConfigToPlaySource(config, options = {}) {
+  if (options.maxCreditsPerRun !== void 0 && (!Number.isFinite(options.maxCreditsPerRun) || options.maxCreditsPerRun <= 0)) {
+    throw new Error("maxCreditsPerRun must be a number greater than 0.");
+  }
   const compatibility = buildEnrichCompatibilityPlan(options);
   const { playName, mapName } = compatibility;
   const inlineRunJavascript = options.inlineRunJavascript ?? false;
@@ -24891,6 +24894,10 @@ function compileEnrichConfigToPlaySource(config, options = {}) {
   const metadataColumnSource = renderMetadataColumnStep(config);
   const generatedAliases = collectGeneratedAliases(config.commands);
   const runOptionsSource = options.failFast ? `{ key: (row, index) => __dlEnrichRowKey(row, index + rowStart), onRowError: 'fail' as const }` : `{ key: (row, index) => __dlEnrichRowKey(row, index + rowStart) }`;
+  const playOptionsSource = [
+    `description: ${stringLiteral("Read a CSV file, run the configured Deepline enrich commands, and return enriched rows.")}`,
+    ...options.maxCreditsPerRun === void 0 ? [] : [`billing: { maxCreditsPerRun: ${String(options.maxCreditsPerRun)} }`]
+  ].join(", ");
   const body = [
     `function __dlRunInlinePlay<TContext, TInput, TOutput>(handler: (ctx: TContext, input: TInput) => Promise<TOutput>, scope: TContext, payload: TInput, force: boolean): Promise<TOutput> {`,
     `  if (!force) return handler(scope, payload);`,
@@ -24924,7 +24931,7 @@ function compileEnrichConfigToPlaySource(config, options = {}) {
     ...metadataColumnSource ? [metadataColumnSource] : [],
     `    .run(${runOptionsSource});`,
     `  return { rows: enriched, count: await enriched.count() };`,
-    `}, { description: ${stringLiteral("Read a CSV file, run the configured Deepline enrich commands, and return enriched rows.")} });`
+    `}, { ${playOptionsSource} });`
   ];
   const helpers = idiomaticGetters ? selectUsedHelpers(helperSource(), body.join("\n")) : helperSource();
   const typeImports = idiomaticGetters ? inlineTypeImports : [.../* @__PURE__ */ new Set([...inlineTypeImports, "DeeplinePlayRuntimeContext"])].sort();
@@ -26125,7 +26132,8 @@ async function buildPlanArgs(args) {
     "--rows",
     "--with-force",
     "--timeout",
-    "--profile"
+    "--profile",
+    "--max-credits-per-run"
   ]);
   const localBooleanOptions = /* @__PURE__ */ new Set([
     "--dry-run",
@@ -26284,6 +26292,16 @@ function parseRows(value, all) {
   }
   return { rowStart: single, rowEnd: single };
 }
+function parseMaxCreditsPerRun(value) {
+  if (value === void 0) {
+    return void 0;
+  }
+  const parsed = Number(value.trim());
+  if (!Number.isFinite(parsed) || parsed <= 0) {
+    throw new Error("--max-credits-per-run must be a number greater than 0.");
+  }
+  return parsed;
+}
 function summarizePlan(config, playSource) {
   const steps = [];
   for (const command of config.commands) {
@@ -29150,6 +29168,9 @@ function registerEnrichCommand(program) {
   ).option(
     "--fail-fast",
     "Fail the generated play when any selected row errors, while preserving recovered runtime-sheet rows for export."
+  ).option(
+    "--max-credits-per-run <credits>",
+    "Set a hard Deepline-credit ceiling enforced by the runtime for this run."
   ).action(async (options, _command) => {
     if (currentEnrichArgs().some(
       (arg) => arg === "--no-open" || arg.startsWith("--no-open=")
@@ -29174,6 +29195,7 @@ function registerEnrichCommand(program) {
     }
     const client2 = new DeeplineClient();
     const args = currentEnrichArgs();
+    const maxCreditsPerRun = parseMaxCreditsPerRun(options.maxCreditsPerRun);
     const config = await compileConfig({ client: client2, args, options });
     emitEnrichDebugValidationLines(config);
     if (options.dryRun) {
@@ -29182,7 +29204,8 @@ function registerEnrichCommand(program) {
         forceAliases: forceAliases2,
         playName: options.name,
         inlineRunJavascript: true,
-        failFast: options.failFast
+        failFast: options.failFast,
+        maxCreditsPerRun
       });
       const summary = summarizePlan(config, playSource2);
       if (options.json) {
@@ -29214,7 +29237,8 @@ function registerEnrichCommand(program) {
       forceAliases,
       playName: options.name,
       inlineRunJavascript: true,
-      failFast: options.failFast
+      failFast: options.failFast,
+      maxCreditsPerRun
     });
     const selectedRange = selectedSourceCsvRange(sourceCsvPath, rows);
     const sdkEnrichTelemetry = createSdkEnrichTelemetryContext({

package/dist/cli/index.mjs

@@ -1030,7 +1030,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.37",
+  version: "0.2.38",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -24884,6 +24884,9 @@ function renderWaterfallColumns(command, forceAliases, inlineRunJavascript, idio
   ];
 }
 function compileEnrichConfigToPlaySource(config, options = {}) {
+  if (options.maxCreditsPerRun !== void 0 && (!Number.isFinite(options.maxCreditsPerRun) || options.maxCreditsPerRun <= 0)) {
+    throw new Error("maxCreditsPerRun must be a number greater than 0.");
+  }
   const compatibility = buildEnrichCompatibilityPlan(options);
   const { playName, mapName } = compatibility;
   const inlineRunJavascript = options.inlineRunJavascript ?? false;
@@ -24935,6 +24938,10 @@ function compileEnrichConfigToPlaySource(config, options = {}) {
   const metadataColumnSource = renderMetadataColumnStep(config);
   const generatedAliases = collectGeneratedAliases(config.commands);
   const runOptionsSource = options.failFast ? `{ key: (row, index) => __dlEnrichRowKey(row, index + rowStart), onRowError: 'fail' as const }` : `{ key: (row, index) => __dlEnrichRowKey(row, index + rowStart) }`;
+  const playOptionsSource = [
+    `description: ${stringLiteral("Read a CSV file, run the configured Deepline enrich commands, and return enriched rows.")}`,
+    ...options.maxCreditsPerRun === void 0 ? [] : [`billing: { maxCreditsPerRun: ${String(options.maxCreditsPerRun)} }`]
+  ].join(", ");
   const body = [
     `function __dlRunInlinePlay<TContext, TInput, TOutput>(handler: (ctx: TContext, input: TInput) => Promise<TOutput>, scope: TContext, payload: TInput, force: boolean): Promise<TOutput> {`,
     `  if (!force) return handler(scope, payload);`,
@@ -24968,7 +24975,7 @@ function compileEnrichConfigToPlaySource(config, options = {}) {
     ...metadataColumnSource ? [metadataColumnSource] : [],
     `    .run(${runOptionsSource});`,
     `  return { rows: enriched, count: await enriched.count() };`,
-    `}, { description: ${stringLiteral("Read a CSV file, run the configured Deepline enrich commands, and return enriched rows.")} });`
+    `}, { ${playOptionsSource} });`
   ];
   const helpers = idiomaticGetters ? selectUsedHelpers(helperSource(), body.join("\n")) : helperSource();
   const typeImports = idiomaticGetters ? inlineTypeImports : [.../* @__PURE__ */ new Set([...inlineTypeImports, "DeeplinePlayRuntimeContext"])].sort();
@@ -26169,7 +26176,8 @@ async function buildPlanArgs(args) {
     "--rows",
     "--with-force",
     "--timeout",
-    "--profile"
+    "--profile",
+    "--max-credits-per-run"
   ]);
   const localBooleanOptions = /* @__PURE__ */ new Set([
     "--dry-run",
@@ -26328,6 +26336,16 @@ function parseRows(value, all) {
   }
   return { rowStart: single, rowEnd: single };
 }
+function parseMaxCreditsPerRun(value) {
+  if (value === void 0) {
+    return void 0;
+  }
+  const parsed = Number(value.trim());
+  if (!Number.isFinite(parsed) || parsed <= 0) {
+    throw new Error("--max-credits-per-run must be a number greater than 0.");
+  }
+  return parsed;
+}
 function summarizePlan(config, playSource) {
   const steps = [];
   for (const command of config.commands) {
@@ -29194,6 +29212,9 @@ function registerEnrichCommand(program) {
   ).option(
     "--fail-fast",
     "Fail the generated play when any selected row errors, while preserving recovered runtime-sheet rows for export."
+  ).option(
+    "--max-credits-per-run <credits>",
+    "Set a hard Deepline-credit ceiling enforced by the runtime for this run."
   ).action(async (options, _command) => {
     if (currentEnrichArgs().some(
       (arg) => arg === "--no-open" || arg.startsWith("--no-open=")
@@ -29218,6 +29239,7 @@ function registerEnrichCommand(program) {
     }
     const client2 = new DeeplineClient();
     const args = currentEnrichArgs();
+    const maxCreditsPerRun = parseMaxCreditsPerRun(options.maxCreditsPerRun);
     const config = await compileConfig({ client: client2, args, options });
     emitEnrichDebugValidationLines(config);
     if (options.dryRun) {
@@ -29226,7 +29248,8 @@ function registerEnrichCommand(program) {
         forceAliases: forceAliases2,
         playName: options.name,
         inlineRunJavascript: true,
-        failFast: options.failFast
+        failFast: options.failFast,
+        maxCreditsPerRun
       });
       const summary = summarizePlan(config, playSource2);
       if (options.json) {
@@ -29258,7 +29281,8 @@ function registerEnrichCommand(program) {
       forceAliases,
       playName: options.name,
       inlineRunJavascript: true,
-      failFast: options.failFast
+      failFast: options.failFast,
+      maxCreditsPerRun
     });
     const selectedRange = selectedSourceCsvRange(sourceCsvPath, rows);
     const sdkEnrichTelemetry = createSdkEnrichTelemetryContext({

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.37",
+  version: "0.2.38",
   contracts: {
     api: {
       name: "sdk-http-api",

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.37",
+  version: "0.2.38",
   contracts: {
     api: {
       name: "sdk-http-api",

package/package.json

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