deepline 0.3.36 → 0.3.38

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

@@ -39,6 +39,7 @@ import {
   ABSURD_RELEASE_OVERRIDE_HEADER,
   COORDINATOR_INTERNAL_TOKEN_HEADER,
   COORDINATOR_URL_OVERRIDE_HEADER,
+  PREFERRED_RECEIPT_GATEWAY_MACHINE_ID_HEADER,
   RUNTIME_SCHEDULER_SCHEMA_OVERRIDE_HEADER,
   SYNTHETIC_RUN_HEADER,
   WORKER_CALLBACK_URL_OVERRIDE_HEADER,
@@ -249,6 +250,10 @@ export class HttpClient {
       typeof process !== 'undefined'
         ? process.env?.DEEPLINE_ABSURD_RELEASE
         : undefined;
+    const preferredReceiptGatewayMachineId =
+      typeof process !== 'undefined'
+        ? process.env?.DEEPLINE_PREFERRED_RECEIPT_GATEWAY_MACHINE_ID
+        : undefined;
     if (coordinatorUrl?.trim()) {
       headers[COORDINATOR_URL_OVERRIDE_HEADER] = coordinatorUrl.trim();
     }
@@ -289,12 +294,20 @@ export class HttpClient {
     if (absurdReleaseOverride?.trim() && coordinatorInternalToken?.trim()) {
       headers[ABSURD_RELEASE_OVERRIDE_HEADER] = absurdReleaseOverride.trim();
     }
+    if (
+      preferredReceiptGatewayMachineId?.trim() &&
+      coordinatorInternalToken?.trim()
+    ) {
+      headers[PREFERRED_RECEIPT_GATEWAY_MACHINE_ID_HEADER] =
+        preferredReceiptGatewayMachineId.trim();
+    }
     if (
       coordinatorInternalToken?.trim() &&
       (coordinatorUrl?.trim() ||
         workerCallbackUrl?.trim() ||
         runtimeTestFault?.trim() ||
-        absurdReleaseOverride?.trim())
+        absurdReleaseOverride?.trim() ||
+        preferredReceiptGatewayMachineId?.trim())
     ) {
       headers[COORDINATOR_INTERNAL_TOKEN_HEADER] =
         coordinatorInternalToken.trim();

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

@@ -199,7 +199,7 @@ export const SDK_RELEASE = {
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
-  version: '0.3.36',
+  version: '0.3.38',
   updateSummary:
     'Automatic CLI updates are now enabled by default. To opt out, run `deepline settings autoupdate off`; use `deepline settings autoupdate on` to re-enable updates or `deepline settings autoupdate pin <version>` to hold an exact release. This release also adds raw-v2 tool responses at toolResponse.rawV2 while preserving existing toolResponse.raw and declared getters.',
   packageCapabilities: {

package/dist/bundling-sources/shared_libs/observability/scheduled-work.ts

@@ -0,0 +1,165 @@
+export const SCHEDULED_WORK_OBSERVABILITY_VERSION = 1 as const;
+
+export type ScheduledWorkScheduler =
+  | 'convex_cron'
+  | 'convex_scheduled_action'
+  | 'github_actions'
+  | 'inngest'
+  | 'scheduled_play'
+  | 'vercel_cron';
+
+export type ScheduledWorkOutcome = 'running' | 'succeeded' | 'failed';
+
+export type ScheduledWorkVolume = {
+  unit: string;
+  attempted?: number;
+  completed?: number;
+  failed?: number;
+  skipped?: number;
+};
+
+/**
+ * The portable envelope emitted by every scheduler. Keep this deliberately
+ * small: it is both the durable health record and the Axiom graph contract.
+ */
+export type ScheduledWorkObservation = {
+  jobId: string;
+  jobName: string;
+  scheduler: ScheduledWorkScheduler;
+  owner: string;
+  criticality: string;
+  environment: string;
+  invocationId: string;
+  occurredAt: number;
+  outcome: ScheduledWorkOutcome;
+  expectedWithinMs: number;
+  durationMs?: number;
+  errorSummary?: string;
+  runUrl?: string;
+  volume?: ScheduledWorkVolume;
+};
+
+export function scheduledWorkTelemetryFields(
+  observation: ScheduledWorkObservation,
+): Record<string, string | number> {
+  return {
+    scheduledWorkSchemaVersion: SCHEDULED_WORK_OBSERVABILITY_VERSION,
+    scheduledWorkJobId: observation.jobId,
+    scheduledWorkJobName: observation.jobName,
+    scheduledWorkScheduler: observation.scheduler,
+    scheduledWorkOwner: observation.owner,
+    scheduledWorkCriticality: observation.criticality,
+    scheduledWorkOutcome: observation.outcome,
+    scheduledWorkInvocationId: observation.invocationId,
+    scheduledWorkExpectedWithinMs: observation.expectedWithinMs,
+    ...(observation.durationMs === undefined
+      ? {}
+      : { scheduledWorkDurationMs: observation.durationMs }),
+    ...(observation.errorSummary === undefined
+      ? {}
+      : { scheduledWorkErrorSummary: observation.errorSummary }),
+    ...(observation.runUrl === undefined
+      ? {}
+      : { scheduledWorkRunUrl: observation.runUrl }),
+    ...(observation.volume === undefined
+      ? {}
+      : scheduledWorkVolumeTelemetryFields(observation.volume)),
+  };
+}
+
+export function scheduledWorkVolumeTelemetryFields(
+  volume: ScheduledWorkVolume,
+): Record<string, string | number> {
+  const attempted = finiteNonNegative(volume.attempted);
+  const completed = finiteNonNegative(volume.completed);
+  const failed = finiteNonNegative(volume.failed);
+  const skipped = finiteNonNegative(volume.skipped);
+  const scale =
+    attempted ??
+    (completed === undefined && failed === undefined && skipped === undefined
+      ? 0
+      : (completed ?? 0) + (failed ?? 0) + (skipped ?? 0));
+  return {
+    scheduledWorkUnit: volume.unit,
+    ...(attempted === undefined ? {} : { scheduledWorkAttempted: attempted }),
+    ...(completed === undefined ? {} : { scheduledWorkCompleted: completed }),
+    ...(failed === undefined ? {} : { scheduledWorkFailed: failed }),
+    ...(skipped === undefined ? {} : { scheduledWorkSkipped: skipped }),
+    ...(scale > 0 && failed !== undefined
+      ? { scheduledWorkFailureRate: failed / scale }
+      : {}),
+  };
+}
+
+/**
+ * Safe default for existing roots. New roots should pass a domain-specific
+ * volume extractor, but familiar result shapes become useful immediately.
+ */
+export function inferScheduledWorkVolume(result: unknown): ScheduledWorkVolume {
+  if (!result || typeof result !== 'object' || Array.isArray(result)) {
+    return { unit: 'runs', attempted: 1, completed: 1 };
+  }
+  const record = result as Record<string, unknown>;
+  const attempted = firstFinite(record, [
+    'processed',
+    'scanned',
+    'orgsScanned',
+    'dueSubscriptions',
+    'queuedJobsFound',
+    'total',
+  ]);
+  const completed = firstFinite(record, [
+    'completed',
+    'processed',
+    'launched',
+    'started',
+    'queued',
+    'cleaned',
+    'deleted',
+  ]);
+  const failed = firstFinite(record, [
+    'failed',
+    'errorCount',
+    'error_count',
+    'scan_errors',
+    'notification_error_count',
+  ]);
+  const skipped = firstFinite(record, [
+    'skipped',
+    'deduped',
+    'skippedNotDue',
+    'skippedNoActiveSubscriptions',
+  ]);
+  if (
+    attempted === undefined &&
+    completed === undefined &&
+    failed === undefined &&
+    skipped === undefined
+  ) {
+    return { unit: 'runs', attempted: 1, completed: 1 };
+  }
+  return {
+    unit: 'items',
+    ...(attempted === undefined ? {} : { attempted }),
+    ...(completed === undefined ? {} : { completed }),
+    ...(failed === undefined ? {} : { failed }),
+    ...(skipped === undefined ? {} : { skipped }),
+  };
+}
+
+function firstFinite(
+  record: Record<string, unknown>,
+  keys: readonly string[],
+): number | undefined {
+  for (const key of keys) {
+    const value = finiteNonNegative(record[key]);
+    if (value !== undefined) return value;
+  }
+  return undefined;
+}
+
+function finiteNonNegative(value: unknown): number | undefined {
+  return typeof value === 'number' && Number.isFinite(value) && value >= 0
+    ? value
+    : undefined;
+}

package/dist/bundling-sources/shared_libs/play-runtime/app-runtime-api.ts

@@ -236,6 +236,8 @@ export type WorkerRuntimeApiContext = {
   integrationMode?: 'live' | 'eval_stub' | 'fixture' | null;
   vercelProtectionBypassToken?: string | null;
   runtimeTestFaultHeader?: string | null;
+  /** Internal deployment-fixture receipt gateway route preference. */
+  preferredReceiptGatewayMachineId?: string | null;
   fetch?: typeof fetch;
   requestTimeoutMs?: number | null;
   /** A higher-level writer owns retries and preserves the exact request body. */
@@ -1131,6 +1133,12 @@ async function postAppRuntimeApi<TResponse>(
           [PLAY_RUNTIME_CONTRACT_HEADER]: String(PLAY_RUNTIME_CONTRACT),
           [PLAY_RUNTIME_TRANSPORT_ATTEMPT_HEADER]: transportAttemptId,
           ...vercelHeaders,
+          ...(context.preferredReceiptGatewayMachineId?.trim()
+            ? {
+                'fly-prefer-instance-id':
+                  context.preferredReceiptGatewayMachineId.trim(),
+              }
+            : {}),
           ...(runtimeTestFaultHeader
             ? {
                 [PLAY_RUNTIME_TEST_FAULT_HEADER]: runtimeTestFaultHeader,
@@ -1140,6 +1148,17 @@ async function postAppRuntimeApi<TResponse>(
         body: JSON.stringify(body),
         signal: requestSignal,
       });
+      const preferredMachineId =
+        context.preferredReceiptGatewayMachineId?.trim() ?? '';
+      if (
+        preferredMachineId &&
+        response.headers.get('x-deepline-gateway-machine-id') !==
+          preferredMachineId
+      ) {
+        throw new Error(
+          `Receipt gateway candidate route fell back (expected=${preferredMachineId}, served=${response.headers.get('x-deepline-gateway-machine-id') ?? '<missing>'}).`,
+        );
+      }
     } catch (error) {
       if (context.signal?.aborted) {
         throw context.signal.reason ?? error;

package/dist/bundling-sources/shared_libs/play-runtime/coordinator-headers.ts

@@ -41,6 +41,14 @@ export const RUNTIME_ENVIRONMENT_TOKEN_HEADER =
  * keys cannot use it. When absent, the resolver chooses the registered lane.
  */
 export const ABSURD_RELEASE_OVERRIDE_HEADER = 'x-deepline-absurd-release';
+/**
+ * Deployment-canary-only route selection for the receipt gateway. The public
+ * API never accepts this header: a staged app may honor it only for an
+ * internally authenticated fixture run. It is copied into the signed launch
+ * contract, rather than forwarded from any sandbox or customer request.
+ */
+export const PREFERRED_RECEIPT_GATEWAY_MACHINE_ID_HEADER =
+  'x-deepline-preferred-receipt-gateway-machine-id';
 /**
  * CLI→app marker (NOT a coordinator header — it lives here only because both
  * the SDK HTTP client and the run route already import this module). Set by

package/dist/bundling-sources/shared_libs/play-runtime/protocol.ts

@@ -110,6 +110,12 @@ export interface PlayRunnerContextConfig {
    */
   executionGatewayBaseUrl?: string | null;
   receiptGatewayBaseUrl?: string | null;
+  /**
+   * Internal fixture-canary pin for a cordoned receipt-gateway candidate. This
+   * is a signed launch fact, never a customer-authored or sandbox-supplied
+   * header. It must therefore stay absent for ordinary executions.
+   */
+  preferredReceiptGatewayMachineId?: string | null;
   /**
    * Request execution through the relay's durable invocation fence. This is
    * required when the execution relay and receipt gateway have different

package/dist/bundling-sources/shared_libs/play-runtime/runner-backends/backends/daytona-payload-transport.ts

@@ -303,6 +303,7 @@ async function main() {
   const context = (config && config.context) || {};
   const push = context.runnerPushExecution;
   const gateway = String(context.receiptGatewayBaseUrl || '').replace(/\\/$/, '');
+  const preferredGatewayMachineId = String(context.preferredReceiptGatewayMachineId || '').trim();
   const token = context.executorToken;
   if (!push || !push.runId || !gateway || !token) {
     writeDiagnostic('[crash-terminal] no push config; skipping');
@@ -380,6 +381,9 @@ async function main() {
           'content-type': 'application/json',
           authorization: 'Bearer ' + token,
           '${PLAY_RUNTIME_CONTRACT_HEADER}': '${String(PLAY_RUNTIME_CONTRACT)}',
+          ...(preferredGatewayMachineId
+            ? { 'fly-prefer-instance-id': preferredGatewayMachineId }
+            : {}),
         },
         body: JSON.stringify({
           action: 'runner_terminal',

package/dist/bundling-sources/shared_libs/play-runtime/scheduler-backend.ts

@@ -163,6 +163,12 @@ export type PlaySchedulerSubmitInput = {
   absurdReleaseEnvironment?: 'preview' | 'production';
   /** Request-scoped Vercel Deployment Protection bypass for preview runtime callbacks. */
   vercelProtectionBypassToken?: string | null;
+  /**
+   * Internal deployment-fixture pin for a receipt gateway Machine. This is
+   * admitted only by the app route after internal authorization and is never
+   * supplied by a customer or forwarded from a sandbox.
+   */
+  preferredReceiptGatewayMachineId?: string | null;
   /** Request-scoped, dev-only runtime fault injection header for black-box durability tests. */
   runtimeTestFaultHeader?: string | null;
   /** Request-scoped, dev-only runtime policy overrides for black-box durability tests. */

package/dist/cli/index.js

@@ -1043,7 +1043,7 @@ var SDK_RELEASE = {
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
-  version: "0.3.36",
+  version: "0.3.38",
   updateSummary: "Automatic CLI updates are now enabled by default. To opt out, run `deepline settings autoupdate off`; use `deepline settings autoupdate on` to re-enable updates or `deepline settings autoupdate pin <version>` to hold an exact release. This release also adds raw-v2 tool responses at toolResponse.rawV2 while preserving existing toolResponse.raw and declared getters.",
   packageCapabilities: {
     updatePreferences: 1
@@ -1324,6 +1324,7 @@ var WORKER_CALLBACK_URL_OVERRIDE_HEADER = "x-deepline-worker-callback-url";
 var RUNTIME_SCHEDULER_SCHEMA_OVERRIDE_HEADER = "x-deepline-runtime-scheduler-schema";
 var RUNTIME_ENVIRONMENT_TOKEN_HEADER = "x-deepline-runtime-environment-token";
 var ABSURD_RELEASE_OVERRIDE_HEADER = "x-deepline-absurd-release";
+var PREFERRED_RECEIPT_GATEWAY_MACHINE_ID_HEADER = "x-deepline-preferred-receipt-gateway-machine-id";
 var SYNTHETIC_RUN_HEADER = "x-deepline-synthetic-run";
 
 // ../shared_libs/play-runtime/runtime-incident-drills.ts
@@ -1688,6 +1689,7 @@ var HttpClient = class {
     const coordinatorUrl = typeof process !== "undefined" ? process.env?.DEEPLINE_COORDINATOR_URL : void 0;
     const coordinatorInternalToken = typeof process !== "undefined" ? process.env?.DEEPLINE_INTERNAL_TOKEN : void 0;
     const absurdReleaseOverride = typeof process !== "undefined" ? process.env?.DEEPLINE_ABSURD_RELEASE : void 0;
+    const preferredReceiptGatewayMachineId = typeof process !== "undefined" ? process.env?.DEEPLINE_PREFERRED_RECEIPT_GATEWAY_MACHINE_ID : void 0;
     if (coordinatorUrl?.trim()) {
       headers[COORDINATOR_URL_OVERRIDE_HEADER] = coordinatorUrl.trim();
     }
@@ -1710,7 +1712,10 @@ var HttpClient = class {
     if (absurdReleaseOverride?.trim() && coordinatorInternalToken?.trim()) {
       headers[ABSURD_RELEASE_OVERRIDE_HEADER] = absurdReleaseOverride.trim();
     }
-    if (coordinatorInternalToken?.trim() && (coordinatorUrl?.trim() || workerCallbackUrl?.trim() || runtimeTestFault?.trim() || absurdReleaseOverride?.trim())) {
+    if (preferredReceiptGatewayMachineId?.trim() && coordinatorInternalToken?.trim()) {
+      headers[PREFERRED_RECEIPT_GATEWAY_MACHINE_ID_HEADER] = preferredReceiptGatewayMachineId.trim();
+    }
+    if (coordinatorInternalToken?.trim() && (coordinatorUrl?.trim() || workerCallbackUrl?.trim() || runtimeTestFault?.trim() || absurdReleaseOverride?.trim() || preferredReceiptGatewayMachineId?.trim())) {
       headers[COORDINATOR_INTERNAL_TOKEN_HEADER] = coordinatorInternalToken.trim();
     }
     return headers;

package/dist/cli/index.mjs

@@ -1029,7 +1029,7 @@ var SDK_RELEASE = {
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
-  version: "0.3.36",
+  version: "0.3.38",
   updateSummary: "Automatic CLI updates are now enabled by default. To opt out, run `deepline settings autoupdate off`; use `deepline settings autoupdate on` to re-enable updates or `deepline settings autoupdate pin <version>` to hold an exact release. This release also adds raw-v2 tool responses at toolResponse.rawV2 while preserving existing toolResponse.raw and declared getters.",
   packageCapabilities: {
     updatePreferences: 1
@@ -1310,6 +1310,7 @@ var WORKER_CALLBACK_URL_OVERRIDE_HEADER = "x-deepline-worker-callback-url";
 var RUNTIME_SCHEDULER_SCHEMA_OVERRIDE_HEADER = "x-deepline-runtime-scheduler-schema";
 var RUNTIME_ENVIRONMENT_TOKEN_HEADER = "x-deepline-runtime-environment-token";
 var ABSURD_RELEASE_OVERRIDE_HEADER = "x-deepline-absurd-release";
+var PREFERRED_RECEIPT_GATEWAY_MACHINE_ID_HEADER = "x-deepline-preferred-receipt-gateway-machine-id";
 var SYNTHETIC_RUN_HEADER = "x-deepline-synthetic-run";
 
 // ../shared_libs/play-runtime/runtime-incident-drills.ts
@@ -1674,6 +1675,7 @@ var HttpClient = class {
     const coordinatorUrl = typeof process !== "undefined" ? process.env?.DEEPLINE_COORDINATOR_URL : void 0;
     const coordinatorInternalToken = typeof process !== "undefined" ? process.env?.DEEPLINE_INTERNAL_TOKEN : void 0;
     const absurdReleaseOverride = typeof process !== "undefined" ? process.env?.DEEPLINE_ABSURD_RELEASE : void 0;
+    const preferredReceiptGatewayMachineId = typeof process !== "undefined" ? process.env?.DEEPLINE_PREFERRED_RECEIPT_GATEWAY_MACHINE_ID : void 0;
     if (coordinatorUrl?.trim()) {
       headers[COORDINATOR_URL_OVERRIDE_HEADER] = coordinatorUrl.trim();
     }
@@ -1696,7 +1698,10 @@ var HttpClient = class {
     if (absurdReleaseOverride?.trim() && coordinatorInternalToken?.trim()) {
       headers[ABSURD_RELEASE_OVERRIDE_HEADER] = absurdReleaseOverride.trim();
     }
-    if (coordinatorInternalToken?.trim() && (coordinatorUrl?.trim() || workerCallbackUrl?.trim() || runtimeTestFault?.trim() || absurdReleaseOverride?.trim())) {
+    if (preferredReceiptGatewayMachineId?.trim() && coordinatorInternalToken?.trim()) {
+      headers[PREFERRED_RECEIPT_GATEWAY_MACHINE_ID_HEADER] = preferredReceiptGatewayMachineId.trim();
+    }
+    if (coordinatorInternalToken?.trim() && (coordinatorUrl?.trim() || workerCallbackUrl?.trim() || runtimeTestFault?.trim() || absurdReleaseOverride?.trim() || preferredReceiptGatewayMachineId?.trim())) {
       headers[COORDINATOR_INTERNAL_TOKEN_HEADER] = coordinatorInternalToken.trim();
     }
     return headers;

package/dist/index.js

@@ -779,7 +779,7 @@ var SDK_RELEASE = {
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
-  version: "0.3.36",
+  version: "0.3.38",
   updateSummary: "Automatic CLI updates are now enabled by default. To opt out, run `deepline settings autoupdate off`; use `deepline settings autoupdate on` to re-enable updates or `deepline settings autoupdate pin <version>` to hold an exact release. This release also adds raw-v2 tool responses at toolResponse.rawV2 while preserving existing toolResponse.raw and declared getters.",
   packageCapabilities: {
     updatePreferences: 1
@@ -1051,6 +1051,7 @@ var WORKER_CALLBACK_URL_OVERRIDE_HEADER = "x-deepline-worker-callback-url";
 var RUNTIME_SCHEDULER_SCHEMA_OVERRIDE_HEADER = "x-deepline-runtime-scheduler-schema";
 var RUNTIME_ENVIRONMENT_TOKEN_HEADER = "x-deepline-runtime-environment-token";
 var ABSURD_RELEASE_OVERRIDE_HEADER = "x-deepline-absurd-release";
+var PREFERRED_RECEIPT_GATEWAY_MACHINE_ID_HEADER = "x-deepline-preferred-receipt-gateway-machine-id";
 var SYNTHETIC_RUN_HEADER = "x-deepline-synthetic-run";
 
 // ../shared_libs/play-runtime/runtime-incident-drills.ts
@@ -1415,6 +1416,7 @@ var HttpClient = class {
     const coordinatorUrl = typeof process !== "undefined" ? process.env?.DEEPLINE_COORDINATOR_URL : void 0;
     const coordinatorInternalToken = typeof process !== "undefined" ? process.env?.DEEPLINE_INTERNAL_TOKEN : void 0;
     const absurdReleaseOverride = typeof process !== "undefined" ? process.env?.DEEPLINE_ABSURD_RELEASE : void 0;
+    const preferredReceiptGatewayMachineId = typeof process !== "undefined" ? process.env?.DEEPLINE_PREFERRED_RECEIPT_GATEWAY_MACHINE_ID : void 0;
     if (coordinatorUrl?.trim()) {
       headers[COORDINATOR_URL_OVERRIDE_HEADER] = coordinatorUrl.trim();
     }
@@ -1437,7 +1439,10 @@ var HttpClient = class {
     if (absurdReleaseOverride?.trim() && coordinatorInternalToken?.trim()) {
       headers[ABSURD_RELEASE_OVERRIDE_HEADER] = absurdReleaseOverride.trim();
     }
-    if (coordinatorInternalToken?.trim() && (coordinatorUrl?.trim() || workerCallbackUrl?.trim() || runtimeTestFault?.trim() || absurdReleaseOverride?.trim())) {
+    if (preferredReceiptGatewayMachineId?.trim() && coordinatorInternalToken?.trim()) {
+      headers[PREFERRED_RECEIPT_GATEWAY_MACHINE_ID_HEADER] = preferredReceiptGatewayMachineId.trim();
+    }
+    if (coordinatorInternalToken?.trim() && (coordinatorUrl?.trim() || workerCallbackUrl?.trim() || runtimeTestFault?.trim() || absurdReleaseOverride?.trim() || preferredReceiptGatewayMachineId?.trim())) {
       headers[COORDINATOR_INTERNAL_TOKEN_HEADER] = coordinatorInternalToken.trim();
     }
     return headers;

package/dist/index.mjs

@@ -702,7 +702,7 @@ var SDK_RELEASE = {
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
-  version: "0.3.36",
+  version: "0.3.38",
   updateSummary: "Automatic CLI updates are now enabled by default. To opt out, run `deepline settings autoupdate off`; use `deepline settings autoupdate on` to re-enable updates or `deepline settings autoupdate pin <version>` to hold an exact release. This release also adds raw-v2 tool responses at toolResponse.rawV2 while preserving existing toolResponse.raw and declared getters.",
   packageCapabilities: {
     updatePreferences: 1
@@ -974,6 +974,7 @@ var WORKER_CALLBACK_URL_OVERRIDE_HEADER = "x-deepline-worker-callback-url";
 var RUNTIME_SCHEDULER_SCHEMA_OVERRIDE_HEADER = "x-deepline-runtime-scheduler-schema";
 var RUNTIME_ENVIRONMENT_TOKEN_HEADER = "x-deepline-runtime-environment-token";
 var ABSURD_RELEASE_OVERRIDE_HEADER = "x-deepline-absurd-release";
+var PREFERRED_RECEIPT_GATEWAY_MACHINE_ID_HEADER = "x-deepline-preferred-receipt-gateway-machine-id";
 var SYNTHETIC_RUN_HEADER = "x-deepline-synthetic-run";
 
 // ../shared_libs/play-runtime/runtime-incident-drills.ts
@@ -1338,6 +1339,7 @@ var HttpClient = class {
     const coordinatorUrl = typeof process !== "undefined" ? process.env?.DEEPLINE_COORDINATOR_URL : void 0;
     const coordinatorInternalToken = typeof process !== "undefined" ? process.env?.DEEPLINE_INTERNAL_TOKEN : void 0;
     const absurdReleaseOverride = typeof process !== "undefined" ? process.env?.DEEPLINE_ABSURD_RELEASE : void 0;
+    const preferredReceiptGatewayMachineId = typeof process !== "undefined" ? process.env?.DEEPLINE_PREFERRED_RECEIPT_GATEWAY_MACHINE_ID : void 0;
     if (coordinatorUrl?.trim()) {
       headers[COORDINATOR_URL_OVERRIDE_HEADER] = coordinatorUrl.trim();
     }
@@ -1360,7 +1362,10 @@ var HttpClient = class {
     if (absurdReleaseOverride?.trim() && coordinatorInternalToken?.trim()) {
       headers[ABSURD_RELEASE_OVERRIDE_HEADER] = absurdReleaseOverride.trim();
     }
-    if (coordinatorInternalToken?.trim() && (coordinatorUrl?.trim() || workerCallbackUrl?.trim() || runtimeTestFault?.trim() || absurdReleaseOverride?.trim())) {
+    if (preferredReceiptGatewayMachineId?.trim() && coordinatorInternalToken?.trim()) {
+      headers[PREFERRED_RECEIPT_GATEWAY_MACHINE_ID_HEADER] = preferredReceiptGatewayMachineId.trim();
+    }
+    if (coordinatorInternalToken?.trim() && (coordinatorUrl?.trim() || workerCallbackUrl?.trim() || runtimeTestFault?.trim() || absurdReleaseOverride?.trim() || preferredReceiptGatewayMachineId?.trim())) {
       headers[COORDINATOR_INTERNAL_TOKEN_HEADER] = coordinatorInternalToken.trim();
     }
     return headers;

package/dist/install-integrity.json

@@ -26,6 +26,7 @@
     "dist/bundling-sources/shared_libs/observability/node-tracing.ts",
     "dist/bundling-sources/shared_libs/observability/redaction.ts",
     "dist/bundling-sources/shared_libs/observability/scheduled-job-errors.ts",
+    "dist/bundling-sources/shared_libs/observability/scheduled-work.ts",
     "dist/bundling-sources/shared_libs/observability/telemetry.ts",
     "dist/bundling-sources/shared_libs/observability/tracing.ts",
     "dist/bundling-sources/shared_libs/observability/worker-telemetry.ts",

package/package.json

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