deepline 0.2.27 → 0.2.28

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

@@ -4490,10 +4490,22 @@ export class DeeplineClient {
    * // { status: "ok", version: "v2" }
    * ```
    */
-  async health(): Promise<{ status: string; version?: string }> {
-    return this.http.get<{ status: string; version?: string }>(
-      '/api/v2/health',
-    );
+  async health(): Promise<{
+    status: string;
+    version?: string;
+    status_banner?: {
+      message: string;
+      updatedAt: number;
+    };
+  }> {
+    return this.http.get<{
+      status: string;
+      version?: string;
+      status_banner?: {
+        message: string;
+        updatedAt: number;
+      };
+    }>('/api/v2/health');
   }
 }
 

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.27',
+  version: '0.2.28',
   contracts: {
     api: {
       name: 'sdk-http-api',

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

@@ -91,8 +91,8 @@ import {
   normalizePlayContractCompatibility,
 } from '@shared_libs/plays/contracts';
 import {
-  LEGACY_TOOL_EXECUTION_ERROR_SCHEMA_VERSION,
   serializeToolExecutionFailure,
+  TOOL_EXECUTION_ERROR_SCHEMA_VERSION,
   TOOL_EXECUTION_ERROR_SCHEMA_HEADER,
   type ToolExecutionErrorSchemaVersion,
   type ToolExecutionFailureV1,
@@ -1760,11 +1760,9 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
    * was published, even when the parent was published under another schema.
    */
   private get currentToolErrorSchemaVersion(): ToolExecutionErrorSchemaVersion {
-    return (
-      this.activeInlineComposition?.toolErrorSchemaVersion ??
-      this.#options.toolErrorSchemaVersion ??
-      LEGACY_TOOL_EXECUTION_ERROR_SCHEMA_VERSION
-    );
+    // Historical artifacts must not turn durable structured failures back into
+    // strings. Every runtime tool call and receipt rehydration uses v1.
+    return TOOL_EXECUTION_ERROR_SCHEMA_VERSION;
   }
 
   private get currentAuthoringContractEdition(): PlayAuthoringContractEdition {

package/dist/bundling-sources/shared_libs/play-runtime/durable-receipt-execution.ts

@@ -23,6 +23,7 @@ import { createRuntimeReceiptHeartbeatSupervisor } from './receipt-heartbeat-sup
 import {
   deserializeToolExecutionFailure,
   serializeToolExecutionFailure,
+  TOOL_EXECUTION_ERROR_SCHEMA_VERSION,
 } from '../tool-execution-error';
 import type {
   ToolExecutionErrorSchemaVersion,
@@ -308,14 +309,14 @@ export function runtimeReceiptOutput<T>(receipt: RuntimeStepReceipt): T {
 export function runtimeReceiptFailureError(
   receipt: RuntimeStepReceipt,
   legacyPrefix: string,
-  toolErrorSchemaVersion: ToolExecutionErrorSchemaVersion,
+  _toolErrorSchemaVersion: ToolExecutionErrorSchemaVersion,
 ): Error {
   const message = receipt.error ?? 'unknown error';
   return (
     deserializeToolExecutionFailure(
       message,
       receipt.errorPayload,
-      toolErrorSchemaVersion,
+      TOOL_EXECUTION_ERROR_SCHEMA_VERSION,
     ) ?? new Error(`${legacyPrefix}: ${message}`)
   );
 }

package/dist/bundling-sources/shared_libs/play-runtime/tool-http-errors.ts

@@ -1,6 +1,7 @@
 import type { WorkReceiptFailureKind } from './work-receipts';
 import {
   LEGACY_TOOL_EXECUTION_ERROR_SCHEMA_VERSION,
+  TOOL_EXECUTION_ERROR_SCHEMA_VERSION,
   ToolExecutionError,
   deserializeToolExecutionFailure,
   isProviderTransientFailure,
@@ -42,8 +43,8 @@ function applyToolHttpErrorFields(
 }
 
 /**
- * Historical play-runtime HTTP error. Existing artifacts must keep this exact
- * Error prototype; typed errors are an explicit artifact-contract opt-in.
+ * Retained only to deserialize direct SDK callers that explicitly request the
+ * retired schema-0 boundary. Play runtime execution always uses schema 1.
  */
 export class ToolHttpError extends Error {
   readonly billing: Record<string, unknown> | null;
@@ -156,6 +157,12 @@ function getStringField(value: unknown, key: string): string | null {
   return typeof field === 'string' && field.trim() ? field : null;
 }
 
+function getBooleanField(value: unknown, key: string): boolean | null {
+  if (!isRecord(value)) return null;
+  const field = value[key];
+  return typeof field === 'boolean' ? field : null;
+}
+
 function getObjectField(
   value: unknown,
   key: string,
@@ -377,7 +384,7 @@ export function normalizeToolHttpErrorMessage(input: {
   schemaVersion?: ToolExecutionErrorSchemaVersion;
 }): ToolHttpError {
   const schemaVersion =
-    input.schemaVersion ?? LEGACY_TOOL_EXECUTION_ERROR_SCHEMA_VERSION;
+    input.schemaVersion ?? TOOL_EXECUTION_ERROR_SCHEMA_VERSION;
   let parsed: Record<string, unknown> | null = null;
   try {
     const candidate = JSON.parse(input.bodyText);
@@ -419,7 +426,9 @@ export function normalizeToolHttpErrorMessage(input: {
     origin,
     category,
     retryable: trustworthy
-      ? (hydratedFailure?.retryable ?? input.retryable === true)
+      ? (hydratedFailure?.retryable ??
+        getBooleanField(parsed, 'retryable') ??
+        input.retryable === true)
       : false,
     statusCode: input.status,
     requestId:
@@ -469,9 +478,8 @@ export function normalizeToolHttpErrorMessage(input: {
         ? parsed
         : null;
   if (hardBillingPayload) {
-    const providerCapacity = isProviderAccountCapacityFailurePayload(
-      hardBillingPayload,
-    );
+    const providerCapacity =
+      isProviderAccountCapacityFailurePayload(hardBillingPayload);
     return createToolHttpError(
       schemaVersion,
       formatHardBillingFailureMessage({

package/dist/bundling-sources/shared_libs/plays/contracts.ts

@@ -1,5 +1,4 @@
 import {
-  LEGACY_TOOL_EXECUTION_ERROR_SCHEMA_VERSION,
   SUPPORTED_TOOL_EXECUTION_ERROR_SCHEMA_VERSIONS,
   TOOL_EXECUTION_ERROR_SCHEMA_VERSION,
   type ToolExecutionErrorSchemaVersion,
@@ -36,7 +35,7 @@ export type PlayContractCompatibilitySnapshot = {
   minRunnerVersion: number;
   runtimeFeatures: PlayRuntimeFeature[];
   runtimeBackend?: string | null;
-  /** Missing preserves the legacy contract used by artifacts stored before this field existed. */
+  /** Every Play run uses the structured tool-error contract. */
   toolErrorSchemaVersion?: ToolExecutionErrorSchemaVersion;
   /** Missing preserves edition 1 for artifacts stored before authoring contracts were pinned. */
   authoringContractEdition?: PlayAuthoringContractEdition;
@@ -66,8 +65,10 @@ export class InvalidPlayContractCompatibilityError extends Error {
 
 /**
  * Normalize the artifact-pinned compatibility facts without regenerating them.
- * A missing field is the historical production contract, not an opt-in to the
- * current runtime behavior.
+ *
+ * Play failures must retain their typed code across durable receipts. Historical
+ * artifacts therefore upgrade to schema 1 at execution time; schema 0's
+ * string-only failure shape is retired from Play execution.
  */
 export function normalizePlayContractCompatibility(
   compatibility: PlayContractCompatibilitySnapshot | null | undefined,
@@ -79,22 +80,20 @@ export function normalizePlayContractCompatibility(
   ) {
     throw new InvalidPlayContractCompatibilityError();
   }
-  const toolErrorSchemaVersion =
-    compatibility.toolErrorSchemaVersion ??
-    LEGACY_TOOL_EXECUTION_ERROR_SCHEMA_VERSION;
+  const requestedToolErrorSchemaVersion =
+    compatibility.toolErrorSchemaVersion ?? TOOL_EXECUTION_ERROR_SCHEMA_VERSION;
   if (
     !SUPPORTED_TOOL_EXECUTION_ERROR_SCHEMA_VERSIONS.includes(
-      toolErrorSchemaVersion as ToolExecutionErrorSchemaVersion,
+      requestedToolErrorSchemaVersion,
     )
   ) {
     throw new UnsupportedPlayToolErrorSchemaVersionError(
-      toolErrorSchemaVersion,
+      requestedToolErrorSchemaVersion,
     );
   }
   return {
     ...compatibility,
-    toolErrorSchemaVersion:
-      toolErrorSchemaVersion as ToolExecutionErrorSchemaVersion,
+    toolErrorSchemaVersion: TOOL_EXECUTION_ERROR_SCHEMA_VERSION,
     authoringContractEdition: normalizePlayAuthoringContractEdition(
       compatibility.authoringContractEdition,
     ),

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.27",
+  version: "0.2.28",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -5961,9 +5961,7 @@ var DeeplineClient = class {
    * ```
    */
   async health() {
-    return this.http.get(
-      "/api/v2/health"
-    );
+    return this.http.get("/api/v2/health");
   }
 };
 
@@ -6804,6 +6802,14 @@ function printCommandEnvelope(envelope, options = {}) {
 var EXIT_OK = 0;
 var EXIT_AUTH = 3;
 var EXIT_SERVER = 5;
+function statusBannerLine(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+  const banner = value;
+  if (typeof banner.message !== "string") {
+    return null;
+  }
+  return `Service notice: ${banner.message}`;
+}
 function envFilePath(baseUrl) {
   return hostEnvFilePath(baseUrl);
 }
@@ -7260,11 +7266,14 @@ async function handleStatus(args) {
       hostStatusPayload = {
         host: baseUrl,
         hostStatus: hData.status || "ok",
-        hostVersion: hData.version || "(unknown)"
+        hostVersion: hData.version || "(unknown)",
+        status_banner: hData.status_banner ?? null
       };
       hostLines.push(`Host: ${baseUrl}`);
       hostLines.push(`Host status: ${hData.status || "ok"}`);
       hostLines.push(`Host version: ${hData.version || "(unknown)"}`);
+      const bannerLine = statusBannerLine(hData.status_banner);
+      if (bannerLine) hostLines.push(bannerLine);
     }
   } catch {
     hostStatusPayload = {

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.27",
+  version: "0.2.28",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -5947,9 +5947,7 @@ var DeeplineClient = class {
    * ```
    */
   async health() {
-    return this.http.get(
-      "/api/v2/health"
-    );
+    return this.http.get("/api/v2/health");
   }
 };
 
@@ -6802,6 +6800,14 @@ function printCommandEnvelope(envelope, options = {}) {
 var EXIT_OK = 0;
 var EXIT_AUTH = 3;
 var EXIT_SERVER = 5;
+function statusBannerLine(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+  const banner = value;
+  if (typeof banner.message !== "string") {
+    return null;
+  }
+  return `Service notice: ${banner.message}`;
+}
 function envFilePath(baseUrl) {
   return hostEnvFilePath(baseUrl);
 }
@@ -7258,11 +7264,14 @@ async function handleStatus(args) {
       hostStatusPayload = {
         host: baseUrl,
         hostStatus: hData.status || "ok",
-        hostVersion: hData.version || "(unknown)"
+        hostVersion: hData.version || "(unknown)",
+        status_banner: hData.status_banner ?? null
       };
       hostLines.push(`Host: ${baseUrl}`);
       hostLines.push(`Host status: ${hData.status || "ok"}`);
       hostLines.push(`Host version: ${hData.version || "(unknown)"}`);
+      const bannerLine = statusBannerLine(hData.status_banner);
+      if (bannerLine) hostLines.push(bannerLine);
     }
   } catch {
     hostStatusPayload = {

package/dist/index.d.mts

@@ -3394,6 +3394,10 @@ declare class DeeplineClient {
     health(): Promise<{
         status: string;
         version?: string;
+        status_banner?: {
+            message: string;
+            updatedAt: number;
+        };
     }>;
 }
 

package/dist/index.d.ts

@@ -3394,6 +3394,10 @@ declare class DeeplineClient {
     health(): Promise<{
         status: string;
         version?: string;
+        status_banner?: {
+            message: string;
+            updatedAt: number;
+        };
     }>;
 }
 

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.27",
+  version: "0.2.28",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -5680,9 +5680,7 @@ var DeeplineClient = class {
    * ```
    */
   async health() {
-    return this.http.get(
-      "/api/v2/health"
-    );
+    return this.http.get("/api/v2/health");
   }
 };
 

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.27",
+  version: "0.2.28",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -5606,9 +5606,7 @@ var DeeplineClient = class {
    * ```
    */
   async health() {
-    return this.http.get(
-      "/api/v2/health"
-    );
+    return this.http.get("/api/v2/health");
   }
 };
 

package/package.json

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