deepline 0.3.408 → 0.3.410

package/dist/cli/chunk-J33TSWO5.js

@@ -0,0 +1,8 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});// ../plays/tool-list-getter-mode.ts
+function playToolListGetterMode(edition = void 0) {
+  return edition === void 0 || edition >= 10 ? "array" : "dataset";
+}
+
+
+
+exports.playToolListGetterMode = playToolListGetterMode;

package/dist/cli/{chunk-XXLXOUUU.mjs → chunk-JNXJZ577.mjs}

@@ -1,6 +1,6 @@
 import {
   resolveShellSpawn
-} from "./chunk-MJELBQBU.mjs";
+} from "./chunk-XIHWSXSV.mjs";
 
 // src/cli/npm-script-policy.ts
 import { spawnSync } from "child_process";

package/dist/cli/{chunk-JI2B4RZP.mjs → chunk-KCC3FKIW.mjs}

@@ -8,7 +8,7 @@ import {
 } from "./chunk-DLIRSHV6.mjs";
 import {
   DeeplineError
-} from "./chunk-NXGCO4JB.mjs";
+} from "./chunk-E4IXDAZI.mjs";
 
 // ../play-runtime/run-lifecycle-policy.ts
 var TERMINAL_PLAY_RUN_STATUSES = /* @__PURE__ */ new Set([
@@ -73,9 +73,21 @@ function decodePlayRunPublicStatus(value) {
 
 // src/plays/run-request.ts
 var PLAY_RUN_START_PATH = "/api/v2/plays/run";
+var CLI_PLAY_RUN_START_PATH = `${PLAY_RUN_START_PATH}/cli`;
+var CLI_PLAY_RUN_SUPPORTED_HEADER = "x-deepline-cli-play-admission";
 var PLAY_RUN_START_STREAM_PATH = `${PLAY_RUN_START_PATH}?stream=true`;
+var CLI_PLAY_RUN_START_STREAM_PATH = `${CLI_PLAY_RUN_START_PATH}?stream=true`;
 var PLAY_FILES_STAGE_PATH = "/api/v2/plays/files/stage";
 var PLAY_FILES_STAGE_MINT_PATH = `${PLAY_FILES_STAGE_PATH}/mint`;
+var CliPlayAdmissionUnsupportedError = class extends DeeplineError {
+  constructor(status) {
+    super(
+      "This server does not support CLI Play admission.",
+      status,
+      "CLI_PLAY_ADMISSION_UNSUPPORTED"
+    );
+  }
+};
 function buildPlayRunStartBody(request) {
   return {
     ...request.admissionOrgId ? { admissionOrgId: request.admissionOrgId } : {},
@@ -103,6 +115,7 @@ function buildPlayRunStartBody(request) {
     ...typeof request.maxConcurrentRows === "number" ? { maxConcurrentRows: request.maxConcurrentRows } : {},
     ...typeof request.maxCredits === "number" ? { maxCredits: request.maxCredits } : {},
     ...typeof request.waitForCompletionMs === "number" ? { waitForCompletionMs: request.waitForCompletionMs } : {},
+    ...request.terminalStatus === "full" ? { terminalStatus: "full" } : {},
     // Profile selection is the API's job, not the caller's. The server
     // defaults to absurd; callers normally omit this field.
     ...request.profile ? { profile: request.profile } : {},
@@ -112,11 +125,11 @@ function buildPlayRunStartBody(request) {
     ...request.testPolicyOverrides ? { testPolicyOverrides: request.testPolicyOverrides } : {}
   };
 }
-async function preparePlayRunAdmission(http, request, onSubmission) {
+async function preparePlayRunAdmission(http, request, onSubmission, options) {
   let capability = null;
   if (http.get) {
     try {
-      capability = await http.get(PLAY_RUN_START_PATH);
+      capability = await http.get(PLAY_RUN_START_PATH, options);
     } catch (error) {
       if (!(error instanceof DeeplineError) || ![404, 405].includes(error.statusCode ?? 0))
         throw error;
@@ -132,6 +145,7 @@ async function preparePlayRunAdmission(http, request, onSubmission) {
     }
   }
   const supportsCallerIntent = capability?.admissionContract === "caller-intent-v1";
+  options?.signal?.throwIfAborted();
   if (supportsCallerIntent && (!capability?.orgId || request.admissionOrgId && request.admissionOrgId !== capability.orgId)) {
     throw new DeeplineError(
       "The admission workspace could not be pinned to this request; execution was not submitted.",
@@ -146,6 +160,20 @@ async function preparePlayRunAdmission(http, request, onSubmission) {
       "PLAY_RUN_ADMISSION_RECOVERY_UNSUPPORTED"
     );
   }
+  if (request.maxTotalCredits !== void 0 && capability?.strictTotalBudget === "unbounded-v1") {
+    if (request.maxTotalCredits === 0) {
+      throw new DeeplineError(
+        "A zero-credit total budget cannot admit a Play: sandbox compute is billed even when provider tools are free.",
+        422,
+        "PLAY_TOTAL_BUDGET_COMPUTE_REQUIRED"
+      );
+    }
+    throw new DeeplineError(
+      "A strict total Play budget cannot currently be admitted: provider operations, Customer DB compute, and additional sandbox sessions do not have a finite admitted upper bound.",
+      422,
+      "PLAY_TOTAL_BUDGET_UNBOUNDED"
+    );
+  }
   if (request.maxTotalCredits !== void 0 && capability?.strictTotalBudget !== "fail-closed-v1") {
     throw new DeeplineError(
       "This server cannot honor a strict total Play budget. Execution was not submitted.",
@@ -186,21 +214,39 @@ async function preparePlayRunAdmission(http, request, onSubmission) {
   }
   return { body: submittedBody, workflowId, supportsCallerIntent };
 }
-async function startPlayRun(http, request, headers, onSubmission) {
+async function startPlayRun(http, request, headers, options) {
   const {
     body: submittedBody,
     workflowId,
     supportsCallerIntent
-  } = await preparePlayRunAdmission(http, request, onSubmission);
+  } = await preparePlayRunAdmission(
+    http,
+    request,
+    options?.onSubmission,
+    options
+  );
+  let cliAdmissionSupported = false;
   let response;
   try {
     response = await http.post(
-      PLAY_RUN_START_PATH,
+      options?.cliAdmission ? CLI_PLAY_RUN_START_PATH : PLAY_RUN_START_PATH,
       submittedBody,
       headers,
-      { maxRetries: 0, exactUrlOnly: true }
+      {
+        maxRetries: 0,
+        exactUrlOnly: true,
+        ...options?.signal ? { signal: options.signal } : {},
+        ...options?.cliAdmission ? {
+          onResponse: (response2) => {
+            cliAdmissionSupported = response2.headers.get(CLI_PLAY_RUN_SUPPORTED_HEADER) === "true";
+          }
+        } : {}
+      }
     );
   } catch (error) {
+    if (options?.cliAdmission && !cliAdmissionSupported && error instanceof DeeplineError && (error.statusCode === 404 || error.statusCode === 405)) {
+      throw new CliPlayAdmissionUnsupportedError(error.statusCode);
+    }
     if (error instanceof DeeplineError && ["NETWORK_TIMEOUT", "NETWORK_ERROR", "FETCH_FAILED"].includes(
       error.code ?? ""
     ) || error instanceof TypeError || error instanceof Error && ["AbortError", "TimeoutError"].includes(error.name)) {
@@ -223,7 +269,15 @@ async function startPlayRun(http, request, headers, onSubmission) {
     }
     throw error;
   }
-  return normalizePlayRunStart(response);
+  const started = normalizePlayRunStart(response);
+  if (options?.cliAdmission && (!started.workflowId || started.workflowId === "pending")) {
+    throw new DeeplineError(
+      "Play admission returned no run id. Check recent runs before submitting again.",
+      void 0,
+      "PLAY_START_MISSING_RUN_ID"
+    );
+  }
+  return started;
 }
 function isPlayRunPackage(value) {
   return Boolean(
@@ -245,7 +299,7 @@ function normalizePlayRunStart(raw) {
     name: runPackage.run.playName,
     status,
     ...runPackage.run.dashboardUrl ? { dashboardUrl: runPackage.run.dashboardUrl } : {},
-    ...isTerminalPlayRunLifecycleStatus(status) ? { finalStatus: runPackage } : {},
+    ...isTerminalPlayRunLifecycleStatus(status) ? raw.finalStatusView === "full" && raw.runId === runPackage.run.id ? { finalStatus: raw, finalStatusView: "full" } : { finalStatus: runPackage } : {},
     package: runPackage
   };
 }
@@ -631,11 +685,12 @@ function createSessionPlayRunHttp(fetchImpl = (...args) => fetch(...args)) {
     return parsed;
   };
   return {
-    get: (path) => send(path, { method: "GET" }),
-    post: (path, body, headers) => send(path, {
+    get: (path, options) => send(path, { method: "GET", ...options }),
+    post: (path, body, headers, options) => send(path, {
       method: "POST",
       headers: { "content-type": "application/json", ...headers },
-      body: JSON.stringify(body)
+      body: JSON.stringify(body),
+      ...options?.signal ? { signal: options.signal } : {}
     }),
     postFormData: (path, formData) => send(path, {
       method: "POST",
@@ -648,9 +703,13 @@ export {
   isTerminalPlayRunLifecycleStatus,
   decodePlayRunPublicStatus,
   PLAY_RUN_START_PATH,
+  CLI_PLAY_RUN_START_PATH,
+  CLI_PLAY_RUN_SUPPORTED_HEADER,
   PLAY_RUN_START_STREAM_PATH,
+  CLI_PLAY_RUN_START_STREAM_PATH,
   PLAY_FILES_STAGE_PATH,
   PLAY_FILES_STAGE_MINT_PATH,
+  CliPlayAdmissionUnsupportedError,
   buildPlayRunStartBody,
   preparePlayRunAdmission,
   startPlayRun,

package/dist/cli/{chunk-6IKARAYD.mjs → chunk-L2VKAASU.mjs}

@@ -28,9 +28,26 @@ var PLAY_BACKEND_DESCRIPTORS = {
 };
 
 // ../plays/tool-response-contract.ts
+var V2_TOOL_RESPONSE_CONTRACT = "v2-tool-response";
 var RAW_V2_TOOL_RESPONSE_CONTRACT = "raw-v2";
 var RAW_V2_TOOL_RESPONSE_RECEIPT_REVISION = "raw-v2-receipt-v1";
 var TOOL_RESPONSE_RECEIPT_REVISION_PATTERN = /^[A-Za-z0-9](?:[A-Za-z0-9._-]{0,63})$/;
+function isToolResponseContract(value) {
+  return value === V2_TOOL_RESPONSE_CONTRACT || value === RAW_V2_TOOL_RESPONSE_CONTRACT;
+}
+function declaredToolResponseContract(value) {
+  if (value == null) return void 0;
+  if (isToolResponseContract(value)) return value;
+  throw new UnsupportedToolResponseContractError(value);
+}
+var UnsupportedToolResponseContractError = class extends Error {
+  constructor(value) {
+    super(
+      `Unsupported tool response contract ${String(value)}. Supported contracts: ${V2_TOOL_RESPONSE_CONTRACT}, ${RAW_V2_TOOL_RESPONSE_CONTRACT}.`
+    );
+    this.name = "UnsupportedToolResponseContractError";
+  }
+};
 var InvalidToolResponseReceiptRevisionError = class extends Error {
   constructor(value) {
     super(
@@ -46,6 +63,9 @@ function normalizeToolResponseReceiptRevision(value) {
   }
   throw new InvalidToolResponseReceiptRevisionError(value);
 }
+function normalizeToolResponseContract(value) {
+  return declaredToolResponseContract(value) ?? V2_TOOL_RESPONSE_CONTRACT;
+}
 function legacyRawFromToolResponseRawV2(rawV2, view, responseMeta) {
   const legacyRaw = view === "data" && rawV2 && typeof rawV2 === "object" && !Array.isArray(rawV2) ? rawV2.data : rawV2;
   const deeplineBilling = responseMeta?.deepline_billing;
@@ -68,7 +88,10 @@ function providerMetaFromToolResponseRawV2(rawV2, view) {
 export {
   RAW_V2_TOOL_RESPONSE_CONTRACT,
   RAW_V2_TOOL_RESPONSE_RECEIPT_REVISION,
+  UnsupportedToolResponseContractError,
+  InvalidToolResponseReceiptRevisionError,
   normalizeToolResponseReceiptRevision,
+  normalizeToolResponseContract,
   legacyRawFromToolResponseRawV2,
   providerMetaFromToolResponseRawV2,
   PLAY_ARTIFACT_KINDS,

package/dist/cli/{chunk-PYZZMAJQ.mjs → chunk-LFSHGNT2.mjs}

@@ -763,7 +763,8 @@ Cost:
     core: `
 Purpose:
   Inventory of saved and prebuilt plays, one bounded page at a time.[[cli: It is
-  the command that carries cost estimates.]]
+  the command that carries cost estimates.]][[mcp: Search returns Play summaries;
+  deepline_describe_play returns input/output schemas and CSV contracts.]]
 When:
 [[cli:
   To price a play before running it: plays list --show-cost, then read the
@@ -787,6 +788,12 @@ Output (JSON):
   next (the next-page command), render.sections with a "cost estimate:"
   line per play.
 ]]
+[[mcp:
+Output:
+  data[] with Play names, references, descriptions, ownership, and revision
+  metadata. Use deepline_describe_play for input/output schemas and CSV
+  contracts before running a Play.
+]]
 Cost:
   Free.
 [[cli: