deepline 0.3.408 → 0.3.410

package/dist/cli/{workflow-PQXC2R47.mjs → workflow-FOEEEB7G.mjs}

@@ -6,9 +6,9 @@ import {
 } from "./chunk-H7HIDGZ7.mjs";
 import {
   DeeplineClient
-} from "./chunk-LOYISF7S.mjs";
-import "./chunk-6IKARAYD.mjs";
-import "./chunk-JI2B4RZP.mjs";
+} from "./chunk-4XQLVUC7.mjs";
+import "./chunk-L2VKAASU.mjs";
+import "./chunk-KCC3FKIW.mjs";
 import "./chunk-EIMG75BT.mjs";
 import "./chunk-UBKA33KY.mjs";
 import {
@@ -16,12 +16,12 @@ import {
   printJson,
   shouldEmitJson,
   sleep
-} from "./chunk-4CFULMRB.mjs";
-import "./chunk-SD7MXAJA.mjs";
-import "./chunk-YHPYUZZX.mjs";
+} from "./chunk-5V5Y37BC.mjs";
+import "./chunk-RFB25DSQ.mjs";
+import "./chunk-MAMVGOSC.mjs";
 import "./chunk-DLIRSHV6.mjs";
-import "./chunk-NXGCO4JB.mjs";
-import "./chunk-WTT6CLED.mjs";
+import "./chunk-E4IXDAZI.mjs";
+import "./chunk-2YR7BIIC.mjs";
 import "./chunk-WZYKRD7T.mjs";
 import "./chunk-KRD6H754.mjs";
 
@@ -230,7 +230,7 @@ function renderExecuteStep(command, options = {
   const runIfJs = options.nativeRunIf ? "null" : renderRunIfFunction(command) ?? "null";
   const description = command.description ? `,
       description: ${stringLiteral(command.description)}` : "";
-  const force = options.force ? `,
+  const force = options.force && !options.explicitFreshness ? `,
     force: true` : "";
   const legacyEnvelope = options.legacyEnvelope ? `,
     legacyEnvelope: true` : "";
@@ -309,8 +309,9 @@ function renderIdiomaticExecuteStep(command, options) {
     `    id: ${callId},`,
     `    tool: ${tool},`,
     `    input: ${input} as any,`,
+    ...options.explicitFreshness ? [`    staleAfterSeconds: 0,`] : [],
     `    description: ${stringLiteral((command.description ?? "").trim() || `Run ${command.alias} via ${command.tool}.`)},`,
-    ...options.force ? [`      force: true,`] : [],
+    ...options.force && !options.explicitFreshness ? [`      force: true,`] : [],
     `  });`,
     `  __dlAssertSuccessfulToolResult(result);`,
     `  return ${extraction};`,
@@ -341,7 +342,7 @@ function renderPlayStep(command, options) {
       // Enrich validates and normalizes this payload against the certified
       // prebuilt contract before code generation. The attachment retains
       // its concrete input type, while generated payloads are records.
-      `    await __dlRunInlinePlay(${inlineHandler}, stepCtx, payload as never, ${options.force});`
+      options.explicitFreshness ? `    await __dlRunInlinePlay_${inline.sourceHash.slice(0, 16)}(stepCtx, payload as never, ${options.force});` : `    await __dlRunInlinePlay(${inlineHandler}, stepCtx, payload as never, ${options.force});`
     ] : [
       `    await stepCtx.runPlay(${callId}, ${playRef}, payload, {`,
       `      description: ${stringLiteral(command.description ?? command.alias)}`,
@@ -499,7 +500,7 @@ function renderMetadataColumnStep(config) {
     `      )`
   ].join("\n");
 }
-function renderWaterfallColumns(command, forceAliases, inlineRunJavascript, idiomaticGetters) {
+function renderWaterfallColumns(command, forceAliases, inlineRunJavascript, idiomaticGetters, explicitFreshness) {
   const activeChildren = command.commands.filter(
     (nested) => !isWaterfall(nested) && !nested.disabled
   );
@@ -522,6 +523,7 @@ function renderWaterfallColumns(command, forceAliases, inlineRunJavascript, idio
       nested.alias,
       renderExecuteStep(nested, {
         force,
+        explicitFreshness,
         precheck,
         legacyEnvelope: Boolean(nested.extract_js),
         inlineRunJavascript,
@@ -576,7 +578,8 @@ function compileEnrichConfigToPlaySource(config, options = {}) {
           command,
           forceAliases,
           inlineRunJavascript,
-          idiomaticGetters
+          idiomaticGetters,
+          options.explicitFreshness === true
         )
       );
       return;
@@ -591,6 +594,7 @@ function compileEnrichConfigToPlaySource(config, options = {}) {
         command.alias,
         renderExecuteStep(command, {
           force,
+          explicitFreshness: options.explicitFreshness,
           inlineRunJavascript,
           idiomaticGetters,
           nativeRunIf: Boolean(runIfSource)
@@ -611,9 +615,10 @@ function compileEnrichConfigToPlaySource(config, options = {}) {
   const generatedDescription = describedColumns.length ? `Enrich CSV rows with ${describedColumns.join(", ")}.` : "Prepare CSV rows for enrichment.";
   const playOptionsSource = [
     `description: ${stringLiteral(generatedDescription)}`,
+    ...options.explicitFreshness === true ? [`compatibility: { authoringContract: 'explicit-freshness' }`] : [],
     ...options.maxCreditsPerRun === void 0 ? [] : [`billing: { maxCreditsPerRun: ${String(options.maxCreditsPerRun)} }`]
   ].join(", ");
-  const body = [
+  const legacyInlineHelper = options.explicitFreshness ? [] : [
     `function __dlRunInlinePlay<TContext, TInput, TOutput>(handler: (ctx: TContext, input: TInput) => Promise<TOutput>, scope: TContext, payload: TInput, force: boolean): Promise<TOutput> {`,
     `  if (!force) return handler(scope, payload);`,
     `  const runtimeScope = scope as TContext & { __deeplineRunWithForcedTools?: <T>(run: () => Promise<T>) => Promise<T> };`,
@@ -622,10 +627,24 @@ function compileEnrichConfigToPlaySource(config, options = {}) {
     `  }`,
     `  return runtimeScope.__deeplineRunWithForcedTools(() => handler(scope, payload));`,
     `}`,
-    ``,
+    ``
+  ];
+  const body = [
+    ...legacyInlineHelper,
     ...inlineHandlers.flatMap((inline) => [
       `const __dlInlinePlay_${inline.sourceHash.slice(0, 16)} = ${inline.functionExpressionSource};`,
-      ``
+      ``,
+      ...options.explicitFreshness ? [
+        `async function __dlRunInlinePlay_${inline.sourceHash.slice(0, 16)}(scope: Parameters<typeof __dlInlinePlay_${inline.sourceHash.slice(0, 16)}>[0], payload: Parameters<typeof __dlInlinePlay_${inline.sourceHash.slice(0, 16)}>[1], force: boolean): Promise<unknown> {`,
+        `  if (!force) return __dlInlinePlay_${inline.sourceHash.slice(0, 16)}(scope, payload);`,
+        `  const runtimeScope = scope as typeof scope & { __deeplineRunWithForcedTools?: <T>(run: () => Promise<T>) => Promise<T> };`,
+        `  if (typeof runtimeScope.__deeplineRunWithForcedTools !== 'function') {`,
+        `    throw new Error('This runtime does not support forced certified inline play execution.');`,
+        `  }`,
+        `  return runtimeScope.__deeplineRunWithForcedTools(() => __dlInlinePlay_${inline.sourceHash.slice(0, 16)}(scope, payload));`,
+        `}`,
+        ``
+      ] : []
     ]),
     `export default definePlay(${stringLiteral(playName)}, async (ctx, input: EnrichInput) => {`,
     `  const sourceRows = await ctx.csv<Record<string, unknown>>(input.file);`,
@@ -648,7 +667,10 @@ function compileEnrichConfigToPlaySource(config, options = {}) {
     `  return { rows: enriched, count: await enriched.count() };`,
     `}, { ${playOptionsSource} });`
   ];
-  const helpers = idiomaticGetters ? selectUsedHelpers(helperSource(), body.join("\n")) : helperSource();
+  const helpers = idiomaticGetters ? selectUsedHelpers(
+    helperSource(options.explicitFreshness),
+    body.join("\n")
+  ) : helperSource(options.explicitFreshness);
   const typeImports = idiomaticGetters ? inlineTypeImports : [.../* @__PURE__ */ new Set([...inlineTypeImports, "DeeplinePlayRuntimeContext"])].sort();
   return [
     ...inlineRunJavascript && configHasRunJavascript(config) ? ["// @ts-nocheck", "/* eslint-disable */", ""] : [],
@@ -687,7 +709,7 @@ function selectUsedHelpers(helperBlock, referenceSource) {
   }
   return blocks.filter((block) => used.has(block.name)).map((block) => block.source).join("\n\n");
 }
-function helperSource() {
+function helperSource(explicitFreshness = false) {
   return [
     `function __dlWholeNumber(value: unknown, fallback: number): number {`,
     `  const numeric = Number(value);`,
@@ -1414,8 +1436,9 @@ function helperSource() {
     `    id: input.callId,`,
     `    tool: input.tool,`,
     `    input: payload,`,
+    ...explicitFreshness ? [`    staleAfterSeconds: 0,`] : [],
     `    ...(input.description ? { description: input.description } : {}),`,
-    `    ...(input.force ? { force: true } : {}),`,
+    ...explicitFreshness ? [] : [`    ...(input.force ? { force: true } : {}),`],
     `  });`,
     `  __dlAssertSuccessfulToolResult(result);`,
     `  return __dlExtract(input.alias, result, input.row, input.extract, Boolean(input.legacyEnvelope));`,
@@ -1542,6 +1565,7 @@ function compileWorkflowConfigToPlay(config, options) {
   validateWorkflowConfigForPlay(config);
   const playName = deriveWorkflowPlayName(options.workflowName);
   const sourceCode = compileEnrichConfigToPlaySource(config, {
+    explicitFreshness: true,
     playName,
     inlineRunJavascript: true,
     idiomaticGetters: true
@@ -1676,7 +1700,7 @@ async function transformOne(api, workflowId, outDir, publish) {
     await writeFile(file, compiled.sourceCode, "utf8");
     let published = false;
     if (publish) {
-      const { handlePlayPublish } = await import("./play-GNC5CQAS.mjs");
+      const { handlePlayPublish } = await import("./play-DE7VH6NU.mjs");
       const code = await handlePlayPublish([file]);
       if (code !== 0) {
         return {

package/dist/cli/{workflow-6ODTCYXU.js → workflow-KOCK2FLW.js}

@@ -6,9 +6,9 @@ var _chunk3XX5TEA4js = require('./chunk-3XX5TEA4.js');
 var _chunk3KC45UVFjs = require('./chunk-3KC45UVF.js');
 
 
-var _chunkAUMD2VXPjs = require('./chunk-AUMD2VXP.js');
-require('./chunk-S6R3OX7B.js');
-require('./chunk-UHNDVD3P.js');
+var _chunk63S7X326js = require('./chunk-63S7X326.js');
+require('./chunk-E4CABWXL.js');
+require('./chunk-2H4EY7KH.js');
 require('./chunk-KXMNM4AQ.js');
 require('./chunk-XDVT3GOM.js');
 
@@ -16,12 +16,12 @@ require('./chunk-XDVT3GOM.js');
 
 
 
-var _chunkQ3PUHXOYjs = require('./chunk-Q3PUHXOY.js');
-require('./chunk-QUAQX3FQ.js');
-require('./chunk-Q2E4E4FJ.js');
+var _chunkNF4V5DTYjs = require('./chunk-NF4V5DTY.js');
+require('./chunk-FVLNYDI4.js');
+require('./chunk-NPBJI7RE.js');
 require('./chunk-XNYIZMNQ.js');
-require('./chunk-7P5AA3SN.js');
-require('./chunk-D6FFBSM5.js');
+require('./chunk-PPDBRJRW.js');
+require('./chunk-5UUQAGJS.js');
 require('./chunk-OG64RBAC.js');
 require('./chunk-COGTRVWW.js');
 
@@ -230,7 +230,7 @@ function renderExecuteStep(command, options = {
   const runIfJs = options.nativeRunIf ? "null" : _nullishCoalesce(renderRunIfFunction(command), () => ( "null"));
   const description = command.description ? `,
       description: ${stringLiteral(command.description)}` : "";
-  const force = options.force ? `,
+  const force = options.force && !options.explicitFreshness ? `,
     force: true` : "";
   const legacyEnvelope = options.legacyEnvelope ? `,
     legacyEnvelope: true` : "";
@@ -309,8 +309,9 @@ function renderIdiomaticExecuteStep(command, options) {
     `    id: ${callId},`,
     `    tool: ${tool},`,
     `    input: ${input} as any,`,
+    ...options.explicitFreshness ? [`    staleAfterSeconds: 0,`] : [],
     `    description: ${stringLiteral((_nullishCoalesce(command.description, () => ( ""))).trim() || `Run ${command.alias} via ${command.tool}.`)},`,
-    ...options.force ? [`      force: true,`] : [],
+    ...options.force && !options.explicitFreshness ? [`      force: true,`] : [],
     `  });`,
     `  __dlAssertSuccessfulToolResult(result);`,
     `  return ${extraction};`,
@@ -341,7 +342,7 @@ function renderPlayStep(command, options) {
       // Enrich validates and normalizes this payload against the certified
       // prebuilt contract before code generation. The attachment retains
       // its concrete input type, while generated payloads are records.
-      `    await __dlRunInlinePlay(${inlineHandler}, stepCtx, payload as never, ${options.force});`
+      options.explicitFreshness ? `    await __dlRunInlinePlay_${inline.sourceHash.slice(0, 16)}(stepCtx, payload as never, ${options.force});` : `    await __dlRunInlinePlay(${inlineHandler}, stepCtx, payload as never, ${options.force});`
     ] : [
       `    await stepCtx.runPlay(${callId}, ${playRef}, payload, {`,
       `      description: ${stringLiteral(_nullishCoalesce(command.description, () => ( command.alias)))}`,
@@ -499,7 +500,7 @@ function renderMetadataColumnStep(config) {
     `      )`
   ].join("\n");
 }
-function renderWaterfallColumns(command, forceAliases, inlineRunJavascript, idiomaticGetters) {
+function renderWaterfallColumns(command, forceAliases, inlineRunJavascript, idiomaticGetters, explicitFreshness) {
   const activeChildren = command.commands.filter(
     (nested) => !isWaterfall(nested) && !nested.disabled
   );
@@ -522,6 +523,7 @@ function renderWaterfallColumns(command, forceAliases, inlineRunJavascript, idio
       nested.alias,
       renderExecuteStep(nested, {
         force,
+        explicitFreshness,
         precheck,
         legacyEnvelope: Boolean(nested.extract_js),
         inlineRunJavascript,
@@ -576,7 +578,8 @@ function compileEnrichConfigToPlaySource(config, options = {}) {
           command,
           forceAliases,
           inlineRunJavascript,
-          idiomaticGetters
+          idiomaticGetters,
+          options.explicitFreshness === true
         )
       );
       return;
@@ -591,6 +594,7 @@ function compileEnrichConfigToPlaySource(config, options = {}) {
         command.alias,
         renderExecuteStep(command, {
           force,
+          explicitFreshness: options.explicitFreshness,
           inlineRunJavascript,
           idiomaticGetters,
           nativeRunIf: Boolean(runIfSource)
@@ -611,9 +615,10 @@ function compileEnrichConfigToPlaySource(config, options = {}) {
   const generatedDescription = describedColumns.length ? `Enrich CSV rows with ${describedColumns.join(", ")}.` : "Prepare CSV rows for enrichment.";
   const playOptionsSource = [
     `description: ${stringLiteral(generatedDescription)}`,
+    ...options.explicitFreshness === true ? [`compatibility: { authoringContract: 'explicit-freshness' }`] : [],
     ...options.maxCreditsPerRun === void 0 ? [] : [`billing: { maxCreditsPerRun: ${String(options.maxCreditsPerRun)} }`]
   ].join(", ");
-  const body = [
+  const legacyInlineHelper = options.explicitFreshness ? [] : [
     `function __dlRunInlinePlay<TContext, TInput, TOutput>(handler: (ctx: TContext, input: TInput) => Promise<TOutput>, scope: TContext, payload: TInput, force: boolean): Promise<TOutput> {`,
     `  if (!force) return handler(scope, payload);`,
     `  const runtimeScope = scope as TContext & { __deeplineRunWithForcedTools?: <T>(run: () => Promise<T>) => Promise<T> };`,
@@ -622,10 +627,24 @@ function compileEnrichConfigToPlaySource(config, options = {}) {
     `  }`,
     `  return runtimeScope.__deeplineRunWithForcedTools(() => handler(scope, payload));`,
     `}`,
-    ``,
+    ``
+  ];
+  const body = [
+    ...legacyInlineHelper,
     ...inlineHandlers.flatMap((inline) => [
       `const __dlInlinePlay_${inline.sourceHash.slice(0, 16)} = ${inline.functionExpressionSource};`,
-      ``
+      ``,
+      ...options.explicitFreshness ? [
+        `async function __dlRunInlinePlay_${inline.sourceHash.slice(0, 16)}(scope: Parameters<typeof __dlInlinePlay_${inline.sourceHash.slice(0, 16)}>[0], payload: Parameters<typeof __dlInlinePlay_${inline.sourceHash.slice(0, 16)}>[1], force: boolean): Promise<unknown> {`,
+        `  if (!force) return __dlInlinePlay_${inline.sourceHash.slice(0, 16)}(scope, payload);`,
+        `  const runtimeScope = scope as typeof scope & { __deeplineRunWithForcedTools?: <T>(run: () => Promise<T>) => Promise<T> };`,
+        `  if (typeof runtimeScope.__deeplineRunWithForcedTools !== 'function') {`,
+        `    throw new Error('This runtime does not support forced certified inline play execution.');`,
+        `  }`,
+        `  return runtimeScope.__deeplineRunWithForcedTools(() => __dlInlinePlay_${inline.sourceHash.slice(0, 16)}(scope, payload));`,
+        `}`,
+        ``
+      ] : []
     ]),
     `export default definePlay(${stringLiteral(playName)}, async (ctx, input: EnrichInput) => {`,
     `  const sourceRows = await ctx.csv<Record<string, unknown>>(input.file);`,
@@ -648,7 +667,10 @@ function compileEnrichConfigToPlaySource(config, options = {}) {
     `  return { rows: enriched, count: await enriched.count() };`,
     `}, { ${playOptionsSource} });`
   ];
-  const helpers = idiomaticGetters ? selectUsedHelpers(helperSource(), body.join("\n")) : helperSource();
+  const helpers = idiomaticGetters ? selectUsedHelpers(
+    helperSource(options.explicitFreshness),
+    body.join("\n")
+  ) : helperSource(options.explicitFreshness);
   const typeImports = idiomaticGetters ? inlineTypeImports : [.../* @__PURE__ */ new Set([...inlineTypeImports, "DeeplinePlayRuntimeContext"])].sort();
   return [
     ...inlineRunJavascript && configHasRunJavascript(config) ? ["// @ts-nocheck", "/* eslint-disable */", ""] : [],
@@ -687,7 +709,7 @@ function selectUsedHelpers(helperBlock, referenceSource) {
   }
   return blocks.filter((block) => used.has(block.name)).map((block) => block.source).join("\n\n");
 }
-function helperSource() {
+function helperSource(explicitFreshness = false) {
   return [
     `function __dlWholeNumber(value: unknown, fallback: number): number {`,
     `  const numeric = Number(value);`,
@@ -1414,8 +1436,9 @@ function helperSource() {
     `    id: input.callId,`,
     `    tool: input.tool,`,
     `    input: payload,`,
+    ...explicitFreshness ? [`    staleAfterSeconds: 0,`] : [],
     `    ...(input.description ? { description: input.description } : {}),`,
-    `    ...(input.force ? { force: true } : {}),`,
+    ...explicitFreshness ? [] : [`    ...(input.force ? { force: true } : {}),`],
     `  });`,
     `  __dlAssertSuccessfulToolResult(result);`,
     `  return __dlExtract(input.alias, result, input.row, input.extract, Boolean(input.legacyEnvelope));`,
@@ -1542,6 +1565,7 @@ function compileWorkflowConfigToPlay(config, options) {
   validateWorkflowConfigForPlay(config);
   const playName = deriveWorkflowPlayName(options.workflowName);
   const sourceCode = compileEnrichConfigToPlaySource(config, {
+    explicitFreshness: true,
     playName,
     inlineRunJavascript: true,
     idiomaticGetters: true
@@ -1603,18 +1627,18 @@ function noticeToStderr(command) {
   );
 }
 function emitPassThrough(command, payload, options) {
-  const json = _chunkQ3PUHXOYjs.shouldEmitJson.call(void 0, options.json);
+  const json = _chunkNF4V5DTYjs.shouldEmitJson.call(void 0, options.json);
   const deprecation = migrationDeprecation(command);
   if (json) {
     const enriched = payload && typeof payload === "object" && !Array.isArray(payload) ? { ...payload, deprecation } : { result: payload, deprecation };
-    _chunkQ3PUHXOYjs.printJson.call(void 0, enriched);
+    _chunkNF4V5DTYjs.printJson.call(void 0, enriched);
     return;
   }
-  _chunkQ3PUHXOYjs.printJson.call(void 0, payload);
+  _chunkNF4V5DTYjs.printJson.call(void 0, payload);
   noticeToStderr(command);
 }
 function client() {
-  return new (0, _chunkAUMD2VXPjs.DeeplineClient)();
+  return new (0, _chunk63S7X326js.DeeplineClient)();
 }
 function clientWithTimeout(timeoutSeconds) {
   if (!timeoutSeconds) return client();
@@ -1622,7 +1646,7 @@ function clientWithTimeout(timeoutSeconds) {
   if (!Number.isFinite(seconds) || seconds <= 0) {
     throw new Error("--timeout must be a positive number of seconds.");
   }
-  return new (0, _chunkAUMD2VXPjs.DeeplineClient)({ timeout: seconds * 1e3 });
+  return new (0, _chunk63S7X326js.DeeplineClient)({ timeout: seconds * 1e3 });
 }
 function readStatus(payload) {
   if (!payload || typeof payload !== "object") return null;
@@ -1676,7 +1700,7 @@ async function transformOne(api, workflowId, outDir, publish) {
     await _promises.writeFile.call(void 0, file, compiled.sourceCode, "utf8");
     let published = false;
     if (publish) {
-      const { handlePlayPublish } = await Promise.resolve().then(() => _interopRequireWildcard(require("./play-YG5L4BWQ.js")));
+      const { handlePlayPublish } = await Promise.resolve().then(() => _interopRequireWildcard(require("./play-XXTPPP23.js")));
       const code = await handlePlayPublish([file]);
       if (code !== 0) {
         return {
@@ -1751,10 +1775,10 @@ async function handleTransform(id, options) {
   for (const workflowId of ids) {
     outcomes.push(await transformOne(api, workflowId, outDir, publish));
   }
-  _chunkQ3PUHXOYjs.printCommandEnvelope.call(void 0, 
+  _chunkNF4V5DTYjs.printCommandEnvelope.call(void 0, 
     { outcomes, deprecation: null },
     {
-      json: _chunkQ3PUHXOYjs.shouldEmitJson.call(void 0, options.json),
+      json: _chunkNF4V5DTYjs.shouldEmitJson.call(void 0, options.json),
       text: renderTransformReport(outcomes)
     }
   );
@@ -1775,11 +1799,11 @@ async function handleDelete(id, options) {
 }
 async function handleDisable(id, options) {
   const result = await client().disableWorkflow(id);
-  _chunkQ3PUHXOYjs.printJson.call(void 0, result);
+  _chunkNF4V5DTYjs.printJson.call(void 0, result);
 }
 async function handleEnable(id, options) {
   const result = await client().enableWorkflow(id);
-  _chunkQ3PUHXOYjs.printJson.call(void 0, result);
+  _chunkNF4V5DTYjs.printJson.call(void 0, result);
 }
 async function handleApply(options) {
   const body = await readJsonOption(options.payload, options.file);
@@ -1844,7 +1868,7 @@ async function handleTail(id, runId, options) {
     if (status && TERMINAL_RUN_STATUSES.has(status) || Date.now() > deadline) {
       return;
     }
-    await _chunkQ3PUHXOYjs.sleep.call(void 0, intervalMs);
+    await _chunkNF4V5DTYjs.sleep.call(void 0, intervalMs);
   }
 }
 function registerWorkflowCommands(program) {