deepline 0.3.33 → 0.3.34

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.33',
+  version: '0.3.34',
   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/play-runtime/execution-protocol.ts

@@ -0,0 +1,71 @@
+/**
+ * Execution ABI for a persisted Play launch.
+ *
+ * This is deliberately separate from a customer Play artifact version and a
+ * worker image/release id. The artifact is immutable customer code; this
+ * protocol names the stable coordinator <-> worker <-> runner contract used
+ * to resume that artifact. A worker may support several protocol versions,
+ * but it must reject an unknown one loudly rather than guessing how to replay
+ * a persisted run.
+ */
+export const PLAY_RUNTIME_PROTOCOL = {
+  /** Launches written before this field existed. */
+  legacy: 0,
+  /** Current scheduler/runner protocol. */
+  current: 1,
+} as const;
+
+export type PlayRuntimeProtocolVersion =
+  (typeof PLAY_RUNTIME_PROTOCOL)[keyof typeof PLAY_RUNTIME_PROTOCOL];
+
+const SUPPORTED_PROTOCOLS = new Set<number>([
+  PLAY_RUNTIME_PROTOCOL.legacy,
+  PLAY_RUNTIME_PROTOCOL.current,
+]);
+
+/** New launches always get an explicit protocol snapshot. */
+export function protocolForNewPlayRuntimeLaunch(
+  value?: PlayRuntimeProtocolVersion | null,
+): PlayRuntimeProtocolVersion {
+  return value == null
+    ? PLAY_RUNTIME_PROTOCOL.current
+    : protocolForPersistedPlayRuntimeLaunch(value);
+}
+
+/** Missing is valid only for historic rows written before the field existed. */
+export function protocolForPersistedPlayRuntimeLaunch(
+  value: unknown,
+): PlayRuntimeProtocolVersion {
+  if (value == null) return PLAY_RUNTIME_PROTOCOL.legacy;
+  if (
+    typeof value === 'number' &&
+    Number.isSafeInteger(value) &&
+    SUPPORTED_PROTOCOLS.has(value)
+  ) {
+    return value as PlayRuntimeProtocolVersion;
+  }
+  throw new Error(
+    `Unsupported Play runtime protocol ${JSON.stringify(value)}. The run remains durable but requires a worker with an explicit compatibility handler.`,
+  );
+}
+
+/**
+ * A worker declares the persisted protocols it can execute. Keep an old
+ * protocol here until every open run using it is terminal and retained history
+ * no longer needs replay support; do not use deployment SHA as this boundary.
+ */
+export const WORKER_SUPPORTED_PLAY_RUNTIME_PROTOCOLS = [
+  PLAY_RUNTIME_PROTOCOL.legacy,
+  PLAY_RUNTIME_PROTOCOL.current,
+] as const satisfies readonly PlayRuntimeProtocolVersion[];
+
+export function assertWorkerSupportsPlayRuntimeProtocol(
+  value: unknown,
+  supported: readonly PlayRuntimeProtocolVersion[] = WORKER_SUPPORTED_PLAY_RUNTIME_PROTOCOLS,
+): PlayRuntimeProtocolVersion {
+  const protocol = protocolForPersistedPlayRuntimeLaunch(value);
+  if (supported.includes(protocol)) return protocol;
+  throw new Error(
+    `Play runtime protocol ${protocol} is not supported by this worker. Refuse to execute rather than replaying with an incompatible runtime.`,
+  );
+}

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

@@ -22,6 +22,7 @@ import type { PlayRunnerRuntimeTiming } from './protocol';
 import type { RuntimeTestPolicyOverrides } from './test-runtime-seams';
 import type { PlayRunInputPayload } from './play-input';
 import type { RuntimeSandboxPlacementPolicyId } from './runtime-sandbox-placement-policy';
+import type { PlayRuntimeProtocolVersion } from './execution-protocol';
 
 export const PLAY_SCHEDULER_BACKENDS = {
   /**
@@ -48,6 +49,8 @@ export type PlaySchedulerSubmitInput = {
   runtimeArtifact?: unknown;
   artifactHash: string;
   graphHash: string;
+  /** Immutable scheduler/worker/runner ABI snapshot (not a Git SHA). */
+  runtimeProtocolVersion?: PlayRuntimeProtocolVersion | null;
   input: PlayRunInputPayload;
   /** Convex metadata for the exact input saved before scheduler submission. */
   inputFileId?: string;

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.33",
+  version: "0.3.34",
   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

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.33",
+  version: "0.3.34",
   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

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.33",
+  version: "0.3.34",
   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

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.33",
+  version: "0.3.34",
   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

package/dist/install-integrity.json

@@ -67,6 +67,7 @@
     "dist/bundling-sources/shared_libs/play-runtime/execution-capabilities.ts",
     "dist/bundling-sources/shared_libs/play-runtime/execution-ledger-store.ts",
     "dist/bundling-sources/shared_libs/play-runtime/execution-plan.ts",
+    "dist/bundling-sources/shared_libs/play-runtime/execution-protocol.ts",
     "dist/bundling-sources/shared_libs/play-runtime/extractor-targets.ts",
     "dist/bundling-sources/shared_libs/play-runtime/fixture-behavior.ts",
     "dist/bundling-sources/shared_libs/play-runtime/fullenrich-batching.ts",

package/package.json

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