deepline 0.3.392 → 0.3.393

package/dist/cli/{chunk-24VEN5PQ.mjs → chunk-UOGZUA24.mjs}

@@ -13,17 +13,17 @@ import {
   listPlayFileExports,
   parsePlaySourceForAnalysis,
   resolveEnabledExecutionProfile
-} from "./chunk-DSWSEHRX.mjs";
+} from "./chunk-6I73X254.mjs";
 import {
   parseCsvDataInput
 } from "./chunk-HQXL5526.mjs";
 import {
   registerDeprecatedSearchCommand
-} from "./chunk-HGYBEAQP.mjs";
+} from "./chunk-2LGC4EFT.mjs";
 import {
   handleDeploymentGet,
   handleDeploymentsList
-} from "./chunk-A3APGZFP.mjs";
+} from "./chunk-4PT2VA3A.mjs";
 import {
   pinLocalPlayImports,
   planLocalPlayExecution
@@ -42,7 +42,7 @@ import {
   normalizeRunEventOperationRequest,
   parseLogLevel,
   playInputExampleArgs
-} from "./chunk-YN6YA7ZZ.mjs";
+} from "./chunk-Q26LUSQ2.mjs";
 import {
   CSV_DATA_INPUT_KEY,
   buildNamedPlayRunRequest,
@@ -52,7 +52,7 @@ import {
   setDottedInputValue,
   stageFileInputs,
   stagedFileContentType
-} from "./chunk-Q6EOHNRH.mjs";
+} from "./chunk-JI2B4RZP.mjs";
 import {
   recordCliTrace,
   traceCliSpan
@@ -75,10 +75,10 @@ import {
   printJsonError,
   renderCommandEnvelopeText,
   shouldEmitJson
-} from "./chunk-2G7DXFHI.mjs";
+} from "./chunk-5PRVMXKB.mjs";
 import {
   fetchWithDeploymentProtection
-} from "./chunk-2GAHHSLB.mjs";
+} from "./chunk-LMMEAMA7.mjs";
 import {
   DeeplineError
 } from "./chunk-NXGCO4JB.mjs";
@@ -5562,6 +5562,13 @@ function resolveDaytonaSandboxComputeItem(input) {
   };
 }
 
+// ../play-runtime/runtime-constants.ts
+var STANDARD_PLAY_RUNTIME_LIMIT_SECONDS = 30 * 60;
+var PLAY_RUNNER_TERMINAL_GRACE_SECONDS = 90;
+var PLAY_RUNNER_STARTUP_GRACE_SECONDS = 4 * 60;
+var PLAY_RUNNER_TIMEOUT_SECONDS = 40 * 60;
+var WORKFLOW_EXECUTOR_TOKEN_TTL_SECONDS = MAX_PLAY_SANDBOX_RUNTIME_LIMITS.timeoutSeconds + (PLAY_RUNNER_TIMEOUT_SECONDS - STANDARD_PLAY_RUNTIME_LIMIT_SECONDS);
+
 // ../billing/compute-pricing-contract.ts
 var COMPUTE_BILLING_MARKUP_MULTIPLIER = 5;
 var DEFAULT_USD_PER_CUSTOMER_CREDIT = 0.1;
@@ -5570,10 +5577,13 @@ function roundUpCredits(value) {
   if (!Number.isFinite(value) || value <= 0) return 0;
   return Math.ceil(value * 100) / 100;
 }
+function maximumPlaySandboxBillingSeconds(limits) {
+  return limits.timeoutSeconds + PLAY_RUNNER_TERMINAL_GRACE_SECONDS;
+}
 function estimateDaytonaMaximumComputeCredits(limits) {
   const item = resolveDaytonaSandboxComputeItem({
     itemId: "estimate",
-    wallTimeSeconds: limits.timeoutSeconds,
+    wallTimeSeconds: maximumPlaySandboxBillingSeconds(limits),
     cpu: limits.cpu,
     memoryGiB: limits.memoryGiB,
     diskGiB: limits.diskGiB
@@ -7519,6 +7529,8 @@ function parsePlayRunOptions(args, initialInput = null) {
   let playName = null;
   let input = initialInput === null ? null : structuredClone(initialInput);
   let revisionId = null;
+  let workflowId = null;
+  let maxTotalCredits = null;
   let revisionSelector = null;
   const watch = !args.includes("--no-wait");
   const dryRun = args.includes("--dry-run");
@@ -7539,6 +7551,22 @@ function parsePlayRunOptions(args, initialInput = null) {
   let headers = null;
   for (let index = 0; index < args.length; index += 1) {
     const arg = args[index];
+    if (arg === "--workflow-id") {
+      const value = args[++index];
+      if (!value || value.startsWith("--"))
+        throw new Error("--workflow-id requires the original caller run ID.");
+      workflowId = value;
+      continue;
+    }
+    if (arg === "--max-total-credits") {
+      const value = args[++index];
+      if (value === void 0 || value.trim() === "" || !Number.isFinite(Number(value)) || Number(value) < 0)
+        throw new Error(
+          "--max-total-credits requires a non-negative number, including zero."
+        );
+      maxTotalCredits = Number(value);
+      continue;
+    }
     if (arg === "--header" || arg.startsWith("--header=")) {
       const raw = arg === "--header" ? args[index + 1] : arg.slice("--header=".length);
       if (raw === void 0 || arg === "--header" && raw.startsWith("--")) {
@@ -7777,6 +7805,8 @@ function parsePlayRunOptions(args, initialInput = null) {
     target: filePath ? { kind: "file", path: filePath } : { kind: "name", name: playName },
     input,
     revisionId,
+    workflowId,
+    maxTotalCredits,
     revisionSelector,
     watch,
     emitLogs,
@@ -7842,6 +7872,11 @@ function resolvePlayRunCliOptions(target, options, inputArgs = []) {
       "--live, --latest, and --revision-id only apply to named plays."
     );
   const dryRun = options.dryRun ?? base.dryRun;
+  const maxTotalCredits = options.maxTotalCredits === void 0 ? base.maxTotalCredits : Number(options.maxTotalCredits);
+  if (maxTotalCredits !== null && (!Number.isFinite(maxTotalCredits) || maxTotalCredits < 0 || options.maxTotalCredits?.trim() === ""))
+    throw new Error(
+      "--max-total-credits requires a non-negative number, including zero."
+    );
   if (dryRun && resolvedTarget.kind !== "file")
     throw new Error("--dry-run currently requires a local Play file.");
   const profile = stringOption(options.profile, "--profile")?.trim() ?? base.profile;
@@ -7910,6 +7945,8 @@ function resolvePlayRunCliOptions(target, options, inputArgs = []) {
     dryRun,
     input: base.input,
     revisionId,
+    workflowId: stringOption(options.workflowId, "--workflow-id") ?? base.workflowId,
+    maxTotalCredits,
     revisionSelector: options.live ? "live" : options.latest ? "latest" : base.revisionSelector,
     profile,
     fixtureBehavior,
@@ -9628,9 +9665,18 @@ async function waitForPlayCompletionByWatch(input) {
   }
 }
 async function startAndWaitForPlayCompletionByStream(input) {
-  for (let attempt = 0; attempt <= PLAY_START_TRANSIENT_RETRY_DELAYS_MS.length; attempt += 1) {
-    const status = await startAndWaitForPlayCompletionByStreamOnce(input);
-    const retryDelayMs = PLAY_START_TRANSIENT_RETRY_DELAYS_MS[attempt];
+  const prepared = await input.client.preparePlayRunAdmission(input.request, {
+    onSubmission: input.onSubmission
+  });
+  const pinnedInput = {
+    ...input,
+    request: prepared.body,
+    startStream: prepared.startStream
+  };
+  const retryDelays = prepared.supportsCallerIntent ? PLAY_START_TRANSIENT_RETRY_DELAYS_MS : [];
+  for (let attempt = 0; attempt <= retryDelays.length; attempt += 1) {
+    const status = await startAndWaitForPlayCompletionByStreamOnce(pinnedInput);
+    const retryDelayMs = retryDelays[attempt];
     if (retryDelayMs === void 0 || !isRetryablePendingStartFailure(status)) {
       return status;
     }
@@ -9715,7 +9761,7 @@ async function startAndWaitForPlayCompletionByStreamOnce(input) {
     } : null;
   };
   try {
-    for await (const event of input.client.startPlayRunStream(input.request, {
+    for await (const event of input.startStream({
       signal: controller.signal
     })) {
       eventCount += 1;
@@ -13197,6 +13243,8 @@ async function handleFileBackedRun(options, hooks) {
     ...options.debugMapLatency ? { mapLatencyProfile: true } : {}
   };
   const startRequest = {
+    ...options.workflowId ? { workflowId: options.workflowId } : {},
+    ...options.maxTotalCredits !== null ? { maxTotalCredits: options.maxTotalCredits } : {},
     name: playName,
     sourceCode: bundleResult.sourceCode,
     sourceFiles: bundleResult.sourceFiles,
@@ -13234,6 +13282,7 @@ async function handleFileBackedRun(options, hooks) {
         open: options.open,
         progress,
         onRunStarted: hooks?.onRunStarted,
+        onSubmission: hooks?.onSubmission,
         onRunAdmitted: hooks?.onRunAdmitted
       }).catch(async (error) => {
         throw await normalizePlayStartError(client, error, playName);
@@ -13271,7 +13320,7 @@ async function handleFileBackedRun(options, hooks) {
   const started = await traceCliSpan(
     "cli.play_start_unwatched",
     { targetKind: "file", playName },
-    () => client.startPlayRun(startRequest).catch(async (error) => {
+    () => client.startPlayRun(startRequest, { onSubmission: hooks?.onSubmission }).catch(async (error) => {
       throw await normalizePlayStartError(client, error, playName);
     })
   );
@@ -13395,6 +13444,8 @@ async function handleNamedRun(options, hooks) {
     runtimeInput,
     stagedFileInputs,
     extra: {
+      ...options.workflowId ? { workflowId: options.workflowId } : {},
+      ...options.maxTotalCredits !== null ? { maxTotalCredits: options.maxTotalCredits } : {},
       ...options.force ? { force: true } : {},
       ...options.forceToolRefresh ? { forceToolRefresh: true } : {},
       ...options.maxConcurrentExternalCalls !== null ? { maxConcurrentExternalCalls: options.maxConcurrentExternalCalls } : {},
@@ -13423,6 +13474,7 @@ async function handleNamedRun(options, hooks) {
         open: options.open,
         progress,
         onRunStarted: hooks?.onRunStarted,
+        onSubmission: hooks?.onSubmission,
         onRunAdmitted: hooks?.onRunAdmitted
       }).catch(async (error) => {
         throw await normalizePlayStartError(client, error, playName, {
@@ -13463,7 +13515,7 @@ async function handleNamedRun(options, hooks) {
   const started = await traceCliSpan(
     "cli.play_start_unwatched",
     { targetKind: "name", playName },
-    () => client.startPlayRun(startRequest).catch(async (error) => {
+    () => client.startPlayRun(startRequest, { onSubmission: hooks?.onSubmission }).catch(async (error) => {
       throw await normalizePlayStartError(client, error, playName, {
         suggestMissingPlay: true
       });
@@ -13499,12 +13551,36 @@ async function handlePlayRun(args, hooks) {
   } : parsedOptions;
   const runHooks = options.runIdFile ? {
     ...hooks,
+    onSubmission: async (intent) => {
+      const destination = `${options.runIdFile}.submission.json`;
+      const tempPath = runIdFileTempPath(destination);
+      try {
+        const handle = await open(tempPath, "wx", 384);
+        try {
+          await handle.writeFile(
+            JSON.stringify({
+              version: 1,
+              admissionState: "submitted_unknown",
+              baseUrl: new DeeplineClient().baseUrl,
+              ...intent
+            })
+          );
+          await handle.sync();
+        } finally {
+          await handle.close();
+        }
+        await link(tempPath, destination);
+      } finally {
+        await removeRunIdTempFile(tempPath);
+      }
+      await hooks?.onSubmission?.(intent);
+    },
     onRunStarted: async (runId) => {
       try {
         await writePlayRunIdFile(options.runIdFile, runId);
       } catch (error) {
         throw new Error(
-          `Run ${runId} was accepted, but its identity could not be persisted to ${options.runIdFile}: ${error instanceof Error ? error.message : String(error)}. Inspect it with 'deepline runs get ${runId} --full'; do not submit a replacement run.`,
+          `Run ${runId} was accepted, but its identity could not be persisted to ${options.runIdFile}: ${error instanceof Error ? error.message : String(error)}. Inspect it with 'deepline runs get ${runId} --full --json'; do not submit a replacement run.`,
           { cause: error }
         );
       }
@@ -16136,6 +16212,58 @@ Common commands:
   deepline plays get prebuilt/person-linkedin-to-email
 `
   );
+  play.command("resume-submission <path>").description(
+    "Inspect or explicitly resubmit the same saved admission intent, preserving its run ID and original revision."
+  ).option(
+    "--inspect",
+    "Read the local submission identity only; no API calls or execution"
+  ).option("--json", "Emit the identity or admission response as JSON").action(
+    async (path, options) => {
+      const saved = JSON.parse(
+        await readFileAsync(resolve5(path), "utf8")
+      );
+      const { callerPlayWorkflowIdMatchesRequest } = await import("./run-identity-MRNCEGV2.mjs");
+      if (saved.version !== 1 || typeof saved.workflowId !== "string" || typeof saved.orgId !== "string" || typeof saved.baseUrl !== "string" || !saved.request || saved.request.admissionOrgId !== saved.orgId || saved.request.workflowId !== saved.workflowId || !callerPlayWorkflowIdMatchesRequest(
+        saved.workflowId,
+        saved.request
+      )) {
+        throw new Error(
+          "The submission file does not contain a complete matching immutable admission intent."
+        );
+      }
+      if (options.inspect) {
+        const result2 = {
+          workflowId: saved.workflowId,
+          admissionState: "unknown",
+          next: {
+            inspect: `deepline runs get ${saved.workflowId} --json`,
+            resume: `deepline plays resume-submission ${shellQuote(path)} --json`
+          }
+        };
+        printCommandEnvelope(result2, {
+          json: options.json,
+          text: `Submission ${saved.workflowId}: admission is unknown. ${result2.next.inspect}
+`
+        });
+        return;
+      }
+      const client = new DeeplineClient();
+      if (new URL(saved.baseUrl).origin !== new URL(client.baseUrl).origin) {
+        throw new Error(
+          "The submission belongs to a different API origin. Select its original host before recovery."
+        );
+      }
+      const result = await client.startPlayRun(saved.request);
+      printCommandEnvelope(
+        { ...result },
+        {
+          json: options.json,
+          text: `Admission ${result.workflowId}: ${result.status ?? "observed"}.
+`
+        }
+      );
+    }
+  );
   play.command("check <target>").description("Check a local play file or named/prebuilt play contract.").addHelpText(
     "after",
     `
@@ -16278,6 +16406,12 @@ Examples:
       "Compatibility alias; run waits by default"
     ).hideHelp()
   ).option("--no-wait", "Start the run and return immediately").option(
+    "--workflow-id <id>",
+    "Reconcile or replay the same immutable request with its original caller run ID"
+  ).option(
+    "--max-total-credits <credits>",
+    "Require a strict total spend ceiling including compute; unbounded work is refused before admission"
+  ).option(
     "--run-id-file <path>",
     "Atomically write the accepted run id to a new JSON file"
   ).addOption(
@@ -16546,7 +16680,7 @@ Examples:
         process.exitCode = await ownView();
         return;
       }
-      const { describeAnything } = await import("./describe-E3DE3ZK3.mjs");
+      const { describeAnything } = await import("./describe-WT6MM2GO.mjs");
       process.exitCode = await describeAnything(
         name,
         {
@@ -16789,6 +16923,31 @@ Examples:
   registerRunChildrenCommand(runs);
   registerRunHistoryCommand(runs);
   registerRunEventsCommand(runs);
+  runs.command("rows-history <runId>").description(
+    "Read one immutable run-row history page; incomplete historical capture is reported explicitly."
+  ).requiredOption("--play <name>", "Play reference owning this dataset").requiredOption(
+    "--dataset <namespace>",
+    "Recorded table namespace from the run dataset metadata"
+  ).option("--limit <rows>", "History entries per page (1 to 1000)", "200").option("--cursor <cursor>", "Opaque nextCursor from the previous page").option("--json", "Emit rows and coverage metadata as JSON").action(
+    async (runId, options) => {
+      const limit = Number(options.limit);
+      if (!Number.isSafeInteger(limit) || limit < 1 || limit > 1e3)
+        throw new Error("--limit must be an integer from 1 to 1000.");
+      const result = await new DeeplineClient().runs.rowHistory({
+        playName: options.play,
+        runId,
+        tableNamespace: options.dataset,
+        limit,
+        cursor: options.cursor
+      });
+      printCompactJson({
+        ...result,
+        ...result.nextCursor ? {
+          next: `deepline runs rows-history ${shellQuote(runId)} --play ${shellQuote(options.play)} --dataset ${shellQuote(options.dataset)} --limit ${limit} --cursor ${shellQuote(result.nextCursor)} --json`
+        } : {}
+      });
+    }
+  );
   runs.command("status <runId>").description(
     "Legacy scalar-only read. Use runs get for canonical status, progress, logs, and results."
   ).option("--json", "Emit JSON output").action(async (runId, options) => {
@@ -16988,7 +17147,10 @@ Examples:
       ...options.logLevel ? ["--log-level", options.logLevel] : []
     ]);
   });
-  const runLogsCommand = runs.command("logs [runId]").description("Read a run\u2019s logs or search recent events.").addHelpText("after", renderRunLogsHelp()).option("--limit <count>", "Maximum results: logs 200; events 100, max 200").option("--out <path>", "Save the full available text log").option("--failed", "Last 20 lines of a failed run").option("--log-level <level>", "debug (default), info, warn or error").option("--step <id>", "Query structured logs from this authored step").option(
+  const runLogsCommand = runs.command("logs [runId]").description("Read a run\u2019s logs or search recent events.").addHelpText("after", renderRunLogsHelp()).option("--limit <count>", "Maximum results: logs 200; events 100, max 200").option("--out <path>", "Save the full available text log").option(
+    "--failed",
+    "Terminal log tail of an overall failed run; completed runs with failed rows use runs events --kind receipt.failed --payloads"
+  ).option("--log-level <level>", "debug (default), info, warn or error").option("--step <id>", "Query structured logs from this authored step").option(
     "--level <level>",
     "Query structured logs at this severity or above"
   ).option(