deepline 0.2.37 → 0.2.39

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.39',
   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.39",
   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({
@@ -30370,7 +30394,7 @@ function monitorsErrorExitCode(error) {
     const status = error.statusCode;
     if (status === 401 || status === 403) return 3;
     if (status === 404) return 4;
-    if (status === 400 || status === 422) return 7;
+    if (status === 400 || status === 409 || status === 422) return 7;
     return 5;
   }
   return 5;
@@ -30805,6 +30829,8 @@ function renderDeployedListText(payload, requestedStatus) {
     const name = asString(entry.name);
     const outputTable = asString(entry.output_table);
     const webhookState = asString(entry.webhook_state);
+    const hasLastReceivedEvent = "last_received_event" in entry;
+    const lastReceivedEvent = asString(entry.last_received_event);
     const boundPlays = Array.isArray(entry.bound_plays) ? entry.bound_plays.length : void 0;
     lines.push(
       `  ${key}${status ? `  ${status}` : ""}${tool ? `  ${tool}` : ""}${name ? `  (${name})` : ""}`
@@ -30818,6 +30844,9 @@ function renderDeployedListText(payload, requestedStatus) {
         ].filter(Boolean).join("  ")}`
       );
     }
+    if (hasLastReceivedEvent) {
+      lines.push(`    last received: ${lastReceivedEvent ?? "never"}`);
+    }
   }
   const applied = asString(payload.status_filter_applied) ?? requestedStatus ?? "active";
   lines.push(
@@ -30894,6 +30923,8 @@ function renderMonitorGet(payload) {
   const tool = asString(payload.tool);
   if (!key || !tool) return void 0;
   const status = asString(payload.status);
+  const hasLastReceivedEvent = "last_received_event" in payload;
+  const lastReceivedEvent = asString(payload.last_received_event);
   const definition = asRecord2(payload.definition);
   const pricingLine = monitorPricingLine(payload.pricing);
   const billing = asRecord2(payload.billing);
@@ -30906,6 +30937,7 @@ function renderMonitorGet(payload) {
     `Monitor: ${key}`,
     `Tool: ${tool}`,
     ...status ? [`Status: ${status}`] : [],
+    ...hasLastReceivedEvent ? [`Last received: ${lastReceivedEvent ?? "never"}`] : [],
     ...pricingLine ? [`Pricing: ${pricingLine}`] : [],
     ...nextRenewalAt ? [`Next renewal: ${nextRenewalAt}`] : []
   ];

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.39",
   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({
@@ -30421,7 +30445,7 @@ function monitorsErrorExitCode(error) {
     const status = error.statusCode;
     if (status === 401 || status === 403) return 3;
     if (status === 404) return 4;
-    if (status === 400 || status === 422) return 7;
+    if (status === 400 || status === 409 || status === 422) return 7;
     return 5;
   }
   return 5;
@@ -30856,6 +30880,8 @@ function renderDeployedListText(payload, requestedStatus) {
     const name = asString(entry.name);
     const outputTable = asString(entry.output_table);
     const webhookState = asString(entry.webhook_state);
+    const hasLastReceivedEvent = "last_received_event" in entry;
+    const lastReceivedEvent = asString(entry.last_received_event);
     const boundPlays = Array.isArray(entry.bound_plays) ? entry.bound_plays.length : void 0;
     lines.push(
       `  ${key}${status ? `  ${status}` : ""}${tool ? `  ${tool}` : ""}${name ? `  (${name})` : ""}`
@@ -30869,6 +30895,9 @@ function renderDeployedListText(payload, requestedStatus) {
         ].filter(Boolean).join("  ")}`
       );
     }
+    if (hasLastReceivedEvent) {
+      lines.push(`    last received: ${lastReceivedEvent ?? "never"}`);
+    }
   }
   const applied = asString(payload.status_filter_applied) ?? requestedStatus ?? "active";
   lines.push(
@@ -30945,6 +30974,8 @@ function renderMonitorGet(payload) {
   const tool = asString(payload.tool);
   if (!key || !tool) return void 0;
   const status = asString(payload.status);
+  const hasLastReceivedEvent = "last_received_event" in payload;
+  const lastReceivedEvent = asString(payload.last_received_event);
   const definition = asRecord2(payload.definition);
   const pricingLine = monitorPricingLine(payload.pricing);
   const billing = asRecord2(payload.billing);
@@ -30957,6 +30988,7 @@ function renderMonitorGet(payload) {
     `Monitor: ${key}`,
     `Tool: ${tool}`,
     ...status ? [`Status: ${status}`] : [],
+    ...hasLastReceivedEvent ? [`Last received: ${lastReceivedEvent ?? "never"}`] : [],
     ...pricingLine ? [`Pricing: ${pricingLine}`] : [],
     ...nextRenewalAt ? [`Next renewal: ${nextRenewalAt}`] : []
   ];

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.39",
   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.39",
   contracts: {
     api: {
       name: "sdk-http-api",

package/package.json

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