deepline 0.3.144 → 0.3.146

package/dist/index.mjs

@@ -768,7 +768,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.144",
+  version: "0.3.146",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1
@@ -2970,19 +2970,32 @@ function summarizeRunRowOutcomes(snapshot) {
   let completedRows = 0;
   let failedRows = 0;
   let totalRows = 0;
+  let supersededRows = 0;
   for (const step of Object.values(snapshot.stepsById)) {
     const progress = step.progress;
     if (!progress) continue;
     completedRows += Math.max(0, finiteNumber(progress.completed) ?? 0);
     failedRows += Math.max(0, finiteNumber(progress.failed) ?? 0);
+    supersededRows += Math.max(0, finiteNumber(progress.supersededRows) ?? 0);
     const stepTotal = finiteNumber(progress.total);
-    totalRows += stepTotal !== null && stepTotal >= 0 ? stepTotal : Math.max(0, finiteNumber(progress.completed) ?? 0) + Math.max(0, finiteNumber(progress.failed) ?? 0);
-  }
+    totalRows += stepTotal !== null && stepTotal >= 0 ? stepTotal : Math.max(0, finiteNumber(progress.completed) ?? 0) + Math.max(0, finiteNumber(progress.failed) ?? 0) + Math.max(0, finiteNumber(progress.supersededRows) ?? 0);
+  }
+  const resultSummary = isRecord5(snapshot.resultSummary) ? snapshot.resultSummary : null;
+  const resultRowOutcomes = isRecord5(resultSummary?.rowOutcomes) ? resultSummary.rowOutcomes : null;
+  const terminalCompletedRows = finiteNumber(resultRowOutcomes?.completedRows);
+  const terminalFailedRows = finiteNumber(resultRowOutcomes?.failedRows);
+  const terminalTotalRows = finiteNumber(resultRowOutcomes?.totalRows);
+  const terminalSupersededRows = finiteNumber(
+    resultRowOutcomes?.supersededRows
+  );
+  const settledCompletedRows = terminalCompletedRows ?? completedRows;
+  const settledFailedRows = terminalFailedRows ?? failedRows;
   return {
-    completedRows,
-    failedRows,
-    totalRows,
-    hasRowFailures: failedRows > 0
+    completedRows: settledCompletedRows,
+    failedRows: settledFailedRows,
+    totalRows: terminalTotalRows ?? totalRows,
+    hasRowFailures: settledFailedRows > 0,
+    ...(terminalSupersededRows ?? supersededRows) > 0 ? { supersededRows: terminalSupersededRows ?? supersededRows } : {}
   };
 }
 function createEmptyPlayRunLedgerSnapshot(input) {
@@ -3140,6 +3153,7 @@ function normalizeStepProgress(value) {
     ...optionalFiniteNumber(value.activeRows) !== void 0 ? { activeRows: optionalFiniteNumber(value.activeRows) } : {},
     ...optionalFiniteNumber(value.waitingRows) !== void 0 ? { waitingRows: optionalFiniteNumber(value.waitingRows) } : {},
     ...optionalFiniteNumber(value.completedRows) !== void 0 ? { completedRows: optionalFiniteNumber(value.completedRows) } : {},
+    ...optionalFiniteNumber(value.supersededRows) !== void 0 ? { supersededRows: optionalFiniteNumber(value.supersededRows) } : {},
     ...optionalString(value.message) ? { message: optionalString(value.message) } : {},
     ...optionalNullableString(value.artifactTableNamespace) !== void 0 ? {
       artifactTableNamespace: optionalNullableString(
@@ -3291,6 +3305,7 @@ function buildSnapshotFromLedger(snapshot) {
       activeRows: step.progress.activeRows,
       waitingRows: step.progress.waitingRows,
       completedRows: step.progress.completedRows,
+      supersededRows: step.progress.supersededRows,
       message: step.progress.message,
       artifactTableNamespace: step.progress.artifactTableNamespace ?? step.artifactTableNamespace ?? null,
       startedAt: step.startedAt ?? null,
@@ -3304,7 +3319,8 @@ function buildSnapshotFromLedger(snapshot) {
     ...step.progress?.nodeIo ? { nodeIo: step.progress.nodeIo } : {}
   }));
   const liveStatus = normalizePlayRunLiveStatus(snapshot.status);
-  const rowOutcomes = isTerminalPlayRunLiveStatus(liveStatus) && Object.keys(snapshot.stepsById).length > 0 ? summarizeRunRowOutcomes(snapshot) : null;
+  const terminalRowOutcomes = isTerminalPlayRunLiveStatus(liveStatus) ? summarizeRunRowOutcomes(snapshot) : null;
+  const rowOutcomes = terminalRowOutcomes && (Object.keys(snapshot.stepsById).length > 0 || terminalRowOutcomes.totalRows > 0 || (terminalRowOutcomes.supersededRows ?? 0) > 0) ? terminalRowOutcomes : null;
   return {
     runId: snapshot.runId,
     status: liveStatus,
@@ -4678,6 +4694,7 @@ var DeeplineClient = class _DeeplineClient {
       invoices: {
         list: (options2) => this.listBillingInvoices(options2)
       },
+      usageEvent: (requestId) => this.getBillingUsageEvent(requestId),
       targetPlans: () => this.getTargetBillingPlans(),
       targetStatus: () => this.getTargetBillingStatus(),
       autoRecharge: {
@@ -5012,7 +5029,7 @@ var DeeplineClient = class _DeeplineClient {
    * guaranteed support for every model. Runtime AI SDK/Gateway errors remain
    * authoritative for model-gated values.
    *
-   * @param model - Gateway model id such as `"openai/gpt-5.5"`
+   * @param model - Exact-case Gateway model id such as `"openai/gpt-5.6-luna"`
    * @returns Model metadata, provider option shapes, and runnable examples
    */
   async describeModel(model) {
@@ -7049,6 +7066,33 @@ var DeeplineClient = class _DeeplineClient {
   async getBillingPlans() {
     return this.http.get("/api/v2/billing/catalog/current");
   }
+  /**
+   * Read the authenticated usage record for one execution request. The
+   * request id comes from the original `executeTool` result and is not a
+   * retry or idempotency token.
+   */
+  async getBillingUsageEvent(requestId) {
+    const normalizedRequestId = requestId.trim();
+    if (normalizedRequestId.length === 0 || normalizedRequestId.length > 200 || normalizedRequestId !== requestId) {
+      throw new DeeplineError(
+        "Usage request_id must contain 1\u2013200 characters with no leading or trailing whitespace.",
+        void 0,
+        "INVALID_USAGE_REQUEST_ID"
+      );
+    }
+    const response = await this.http.get(
+      `/api/v2/usage/events?request_id=${encodeURIComponent(normalizedRequestId)}`
+    );
+    const event = response.entries?.[0];
+    if (!event) {
+      throw new DeeplineError(
+        "No usage event was found for this request_id.",
+        void 0,
+        "USAGE_EVENT_NOT_FOUND"
+      );
+    }
+    return event;
+  }
   /**
    * Charge the saved payment method and add Deepline credits to the active
    * workspace. Prefer `client.billing.topUp(...)`.
@@ -8748,6 +8792,17 @@ function findFirstTargetByPath(result, paths) {
   }
   return null;
 }
+function findFirstExplicitNullTargetByPath(result, paths) {
+  for (const path of paths ?? []) {
+    for (const candidate of candidateResultPaths(path)) {
+      const explicitNull = valuesAtSegments(result, parsePath(candidate)).find(
+        (entry) => entry.value === null
+      );
+      if (explicitNull) return { value: null, path: explicitNull.path };
+    }
+  }
+  return null;
+}
 function firstValueForPaths(result, paths) {
   return findFirstTargetByPath(result, paths);
 }
@@ -9007,7 +9062,11 @@ function buildTargets(result, extractors, targetGetters) {
       continue;
     }
     const fromExtractor = findFirstTargetByPath(result, descriptor.paths);
-    if (!fromExtractor) continue;
+    if (!fromExtractor) {
+      const explicitNull = isSemanticStatus ? null : findFirstExplicitNullTargetByPath(result, descriptor.paths);
+      if (explicitNull) targets[target] = explicitNull;
+      continue;
+    }
     const transformed = coerceToEnum(
       applyExtractorTransforms(fromExtractor.value, descriptor),
       descriptor
@@ -9030,6 +9089,14 @@ function buildTargets(result, extractors, targetGetters) {
       targets[target] = fromMetadata;
       continue;
     }
+    const explicitNull = findFirstExplicitNullTargetByPath(
+      result,
+      targetGetters?.[target]
+    );
+    if (explicitNull) {
+      targets[target] = explicitNull;
+      continue;
+    }
     const fallback = findFirstTargetByKey(result, target);
     if (fallback) {
       targets[target] = fallback;
@@ -9037,6 +9104,7 @@ function buildTargets(result, extractors, targetGetters) {
   }
   if (metadataTargets.size === 0) {
     for (const target of ["email", "phone", "linkedin", "domain", "status"]) {
+      if (targets[target]) continue;
       const found = findFirstTargetByKey(result, target);
       if (found) targets[target] = found;
     }

package/dist/install-integrity.json

@@ -552,8 +552,8 @@
     "dist/cli/index.js",
     "dist/cli/index.mjs",
     "dist/cli/text-imports.d.ts",
-    "dist/compiler-manifest-BIqRyj5m.d.mts",
-    "dist/compiler-manifest-BIqRyj5m.d.ts",
+    "dist/compiler-manifest-BJBNPTWt.d.mts",
+    "dist/compiler-manifest-BJBNPTWt.d.ts",
     "dist/helpers.d.mts",
     "dist/helpers.d.ts",
     "dist/helpers.js",

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-BIqRyj5m.mjs';
-export { d as PLAY_ARTIFACT_KINDS, e as PlayArtifactCompatibility, f as PlayImportPolicy, g as PlayPackageImport, h as PlayRuntimeFeature } from '../compiler-manifest-BIqRyj5m.mjs';
+import { P as PlayArtifactKind, a as PlayBundleArtifact, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-BJBNPTWt.mjs';
+export { d as PLAY_ARTIFACT_KINDS, e as PlayArtifactCompatibility, f as PlayImportPolicy, g as PlayPackageImport, h as PlayRuntimeFeature } from '../compiler-manifest-BJBNPTWt.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-BIqRyj5m.js';
-export { d as PLAY_ARTIFACT_KINDS, e as PlayArtifactCompatibility, f as PlayImportPolicy, g as PlayPackageImport, h as PlayRuntimeFeature } from '../compiler-manifest-BIqRyj5m.js';
+import { P as PlayArtifactKind, a as PlayBundleArtifact, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-BJBNPTWt.js';
+export { d as PLAY_ARTIFACT_KINDS, e as PlayArtifactCompatibility, f as PlayImportPolicy, g as PlayPackageImport, h as PlayRuntimeFeature } from '../compiler-manifest-BJBNPTWt.js';
 import '@sinclair/typebox';
 
 type ImportedPlayDependency = {

package/dist/release.d.mts

@@ -149,7 +149,7 @@ type SdkRelease = {
     supportPolicy: SdkSupportPolicy;
 };
 declare const SDK_RELEASE: {
-    readonly version: "0.3.144";
+    readonly version: "0.3.146";
     readonly updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.";
     readonly packageCapabilities: {
         readonly updatePreferences: 1;

package/dist/release.d.ts

@@ -149,7 +149,7 @@ type SdkRelease = {
     supportPolicy: SdkSupportPolicy;
 };
 declare const SDK_RELEASE: {
-    readonly version: "0.3.144";
+    readonly version: "0.3.146";
     readonly updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.";
     readonly packageCapabilities: {
         readonly updatePreferences: 1;

package/dist/release.js

@@ -74,7 +74,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.144",
+  version: "0.3.146",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1

package/dist/release.mjs

@@ -48,7 +48,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.144",
+  version: "0.3.146",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.3.144",
+  "version": "0.3.146",
   "description": "GTM data CLI and TypeScript SDK for coding agents",
   "license": "MIT",
   "homepage": "https://code.deepline.com",