deepline 0.2.13 → 0.2.15

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

@@ -32,10 +32,11 @@ import type { ToolExecutionErrorSchemaVersion } from '../../tool-execution-error
 import type { PlaySandboxRuntimeDeclaration } from '../../play-runtime/sandbox-runtime-limits';
 import { validatePlaySourceFilesHaveNoInlineSecrets } from '../secret-guardrails';
 import { MAX_PLAY_BUNDLE_BYTES } from './limits';
+import { PLAY_AUTHORING_CONTRACT_EDITION } from '../authoring-contract';
 
 // The authored tool-error schema is part of the artifact bytes. Do not reuse a
 // local bundle cached before compatibility selection entered graph analysis.
-const PLAY_BUNDLE_CACHE_VERSION = 27;
+const PLAY_BUNDLE_CACHE_VERSION = 28;
 const PLAY_ARTIFACT_CACHE_DIR = join(
   tmpdir(),
   `deepline-play-artifacts-v${PLAY_BUNDLE_CACHE_VERSION}`,
@@ -1833,7 +1834,7 @@ export async function bundlePlayFile(
       exportName,
     );
     analysis.graphHash = sha256(
-      `${analysis.graphHash}\nentry-export:${exportName}`,
+      `${analysis.graphHash}\nentry-export:${exportName}\nauthoring-contract-edition:${PLAY_AUTHORING_CONTRACT_EDITION}`,
     );
     try {
       validatePlaySourceFilesHaveNoInlineSecrets(analysis.sourceFiles);

package/dist/bundling-sources/shared_libs/plays/compiler-manifest.ts

@@ -1,5 +1,6 @@
 import type { PlayArtifactKind } from '../play-runtime/backend';
 import type { PlayStaticPipeline } from './static-pipeline';
+import type { AdmittedPlayAuthoringContract } from './authoring-contract';
 
 export const PLAY_COMPILER_MANIFEST_VERSION = 1;
 
@@ -22,6 +23,7 @@ export type PlayCompilerManifest = {
   artifactKind?: PlayArtifactKind;
   staticPipeline: PlayStaticPipeline;
   importedPlayDependencies: PlayCompilerDependencyManifest[];
+  authoringContract?: AdmittedPlayAuthoringContract;
 };
 
 export type PlayRuntimeManifest = {

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

@@ -5,6 +5,12 @@ import {
   type ToolExecutionErrorSchemaVersion,
 } from '../tool-execution-error';
 import { CURRENT_PLAY_ARTIFACT_CONTRACT_VERSION } from './artifact-contract-version';
+import {
+  PLAY_AUTHORING_CONTRACT_EDITION,
+  normalizePlayAuthoringContractEdition,
+  type PlayAuthoringContractEdition,
+  type AdmittedPlayAuthoringContract,
+} from './authoring-contract';
 
 export type PlayContractSource = 'ad_hoc' | 'draft' | 'published';
 
@@ -32,11 +38,14 @@ export type PlayContractCompatibilitySnapshot = {
   runtimeBackend?: string | null;
   /** Missing preserves the legacy contract used by artifacts stored before this field existed. */
   toolErrorSchemaVersion?: ToolExecutionErrorSchemaVersion;
+  /** Missing preserves edition 1 for artifacts stored before authoring contracts were pinned. */
+  authoringContractEdition?: PlayAuthoringContractEdition;
 };
 
 export type NormalizedPlayContractCompatibilitySnapshot =
   PlayContractCompatibilitySnapshot & {
     toolErrorSchemaVersion: ToolExecutionErrorSchemaVersion;
+    authoringContractEdition: PlayAuthoringContractEdition;
   };
 
 export class UnsupportedPlayToolErrorSchemaVersionError extends Error {
@@ -86,12 +95,16 @@ export function normalizePlayContractCompatibility(
     ...compatibility,
     toolErrorSchemaVersion:
       toolErrorSchemaVersion as ToolExecutionErrorSchemaVersion,
+    authoringContractEdition: normalizePlayAuthoringContractEdition(
+      compatibility.authoringContractEdition,
+    ),
   };
 }
 
 export function buildPlayContractCompatibility(input?: {
   runtimeBackend?: string | null;
   toolErrorSchemaVersion?: ToolExecutionErrorSchemaVersion;
+  authoringContractEdition?: PlayAuthoringContractEdition;
 }): PlayContractCompatibilitySnapshot {
   return {
     apiVersion: PLAY_PUBLIC_API_VERSION,
@@ -101,6 +114,8 @@ export function buildPlayContractCompatibility(input?: {
     runtimeBackend: input?.runtimeBackend ?? null,
     toolErrorSchemaVersion:
       input?.toolErrorSchemaVersion ?? TOOL_EXECUTION_ERROR_SCHEMA_VERSION,
+    authoringContractEdition:
+      input?.authoringContractEdition ?? PLAY_AUTHORING_CONTRACT_EDITION,
   };
 }
 
@@ -122,4 +137,5 @@ export type PlayRunContractSnapshot = {
   codeFormat?: 'function' | 'cjs_module' | 'esm_module' | null;
   sourceCode?: string | null;
   compatibility?: PlayContractCompatibilitySnapshot | null;
+  authoringContract?: AdmittedPlayAuthoringContract | null;
 };

package/dist/bundling-sources/shared_libs/plays/input-contract-definition.ts

@@ -0,0 +1,28 @@
+import type { PlayAuthoringInputContract } from './authoring-contract';
+
+function freezeInputSchema(
+  schema: Record<string, unknown>,
+): Record<string, unknown> {
+  const visited = new WeakSet<object>();
+  const freeze = (value: unknown): void => {
+    if (value === null || typeof value !== 'object' || visited.has(value)) {
+      return;
+    }
+    visited.add(value);
+    for (const child of Object.values(value)) freeze(child);
+    Object.freeze(value);
+  };
+  freeze(schema);
+  return schema;
+}
+
+export function createPlayInputContract<TInput>(
+  schema: Record<string, unknown>,
+): PlayAuthoringInputContract<TInput> {
+  if (!schema || typeof schema !== 'object' || Array.isArray(schema)) {
+    throw new Error(
+      'defineInput<T>(schema) requires a JSON-schema-like object.',
+    );
+  }
+  return Object.freeze({ schema: freezeInputSchema(schema) });
+}

package/dist/bundling-sources/shared_libs/plays/input-contract.ts

@@ -8,7 +8,7 @@ import {
 
 export type PlayInputKind = 'csv' | 'typed' | 'none';
 
-export type PlayInputContract = {
+export type PlayEntryInputContract = {
   callInputFields: string[];
   csvHeaderFields: string[];
   rowKeyFields: string[];
@@ -17,7 +17,7 @@ export type PlayInputContract = {
   summary: string;
 };
 
-export type PlayEntryContract = PlayInputContract & {
+export type PlayEntryContract = PlayEntryInputContract & {
   outputFields: string[];
   outputDatasetFields?: ReadonlySet<string>;
 };
@@ -26,7 +26,7 @@ export function buildPlayInputContract(input: {
   pipeline: PlayStaticPipeline;
   displaySubsteps?: readonly PlayStaticSubstep[];
   inputFields?: readonly string[];
-}): PlayInputContract {
+}): PlayEntryInputContract {
   const displaySubsteps =
     input.displaySubsteps ?? getTopLevelPipelineSubsteps(input.pipeline);
   const datasetInputs = collectDatasetInputDetails(displaySubsteps);