deepline 0.3.470 → 0.3.472

package/dist/cli/{chunk-ORO2GFH4.js → chunk-SKVMC6K6.js}

@@ -1,16 +1,16 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _chunkY4OE46HHjs = require('./chunk-Y4OE46HH.js');
+var _chunk7KAS4QOWjs = require('./chunk-7KAS4QOW.js');
 
 
 
-var _chunkCNQBCLQPjs = require('./chunk-CNQBCLQP.js');
+var _chunk5FHU67ATjs = require('./chunk-5FHU67AT.js');
 
 // src/client.ts
-var DeeplineClient2 = class extends _chunkY4OE46HHjs.DeeplineClient {
+var DeeplineClient2 = class extends _chunk7KAS4QOWjs.DeeplineClient {
   constructor(options) {
-    const config = _chunkCNQBCLQPjs.resolveConfig.call(void 0, options);
-    super(config, new (0, _chunkCNQBCLQPjs.HttpClient)(config), _optionalChain([options, 'optionalAccess', _ => _.timeout]));
+    const config = _chunk5FHU67ATjs.resolveConfig.call(void 0, options);
+    super(config, new (0, _chunk5FHU67ATjs.HttpClient)(config), _optionalChain([options, 'optionalAccess', _ => _.timeout]));
   }
 };
 

package/dist/cli/{chunk-AGIEKE3L.js → chunk-SYWOSAW7.js}

@@ -16,12 +16,12 @@ var _chunkXNYIZMNQjs = require('./chunk-XNYIZMNQ.js');
 var _chunkDIAWYWT5js = require('./chunk-DIAWYWT5.js');
 
 
-var _chunkNSAKJQLXjs = require('./chunk-NSAKJQLX.js');
+var _chunkUKKCS6Z4js = require('./chunk-UKKCS6Z4.js');
 
 // src/version.ts
-var SDK_VERSION = _chunkNSAKJQLXjs.SDK_RELEASE.version;
-var SDK_API_MAJOR = _chunkNSAKJQLXjs.SDK_RELEASE.contracts.api.currentMajor;
-var SDK_API_CONTRACT = _nullishCoalesce(_chunkNSAKJQLXjs.SDK_RELEASE.contracts.api.legacyWireIds[0], () => ( `api-v${SDK_API_MAJOR}`));
+var SDK_VERSION = _chunkUKKCS6Z4js.SDK_RELEASE.version;
+var SDK_API_MAJOR = _chunkUKKCS6Z4js.SDK_RELEASE.contracts.api.currentMajor;
+var SDK_API_CONTRACT = _nullishCoalesce(_chunkUKKCS6Z4js.SDK_RELEASE.contracts.api.legacyWireIds[0], () => ( `api-v${SDK_API_MAJOR}`));
 
 // src/agent-runtime.ts
 var _os = require('os');

package/dist/cli/{chunk-YFKOA4HW.mjs → chunk-T5H7ETIM.mjs}

@@ -1,6 +1,6 @@
 import {
   getActiveCliProgress
-} from "./chunk-3XLJPLXZ.mjs";
+} from "./chunk-R73LE2IM.mjs";
 import {
   DEFAULT_SKILL_AGENTS,
   KNOWN_SKILL_AGENTS,
@@ -12,7 +12,7 @@ import {
   sdkCliStateDirPath,
   skillsAgentPathSegment,
   writeSdkSkillsLocalVersion
-} from "./chunk-VL7OL7YR.mjs";
+} from "./chunk-KQJHIVCE.mjs";
 import {
   SDK_API_CONTRACT,
   SDK_API_MAJOR,
@@ -20,13 +20,13 @@ import {
   agentSessionIdFromEnvironment,
   deploymentProtectionHeaders,
   detectAgentRuntime
-} from "./chunk-SETIOXN4.mjs";
+} from "./chunk-OMPW5ELS.mjs";
 import {
   DeeplineError
 } from "./chunk-HBL4PM5Q.mjs";
 import {
   SDK_RELEASE
-} from "./chunk-DSOTGAXS.mjs";
+} from "./chunk-JRZW4LWK.mjs";
 
 // src/compat.ts
 import { randomUUID } from "crypto";

package/dist/cli/{chunk-5ADROBCY.mjs → chunk-TMMODGPV.mjs}

@@ -1,10 +1,10 @@
 import {
   PlayClient
-} from "./chunk-QW6HNDS7.mjs";
+} from "./chunk-YK64LQPQ.mjs";
 import {
   HttpClient,
   resolveConfig
-} from "./chunk-VL7OL7YR.mjs";
+} from "./chunk-KQJHIVCE.mjs";
 
 // src/plays/local-play-execution.ts
 function importedNodes(graph) {

package/dist/cli/{chunk-NSAKJQLX.js → chunk-UKKCS6Z4.js}

@@ -49,7 +49,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.470",
+  version: "0.3.472",
   updateSummary: {
     introducedIn: "0.3.90",
     summary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release."

package/dist/cli/{chunk-KBNAI5BY.js → chunk-UPXGN62E.js}

@@ -4,20 +4,20 @@
 
 
 
-var _chunk6R5UKWRWjs = require('./chunk-6R5UKWRW.js');
+var _chunkGJPRBELOjs = require('./chunk-GJPRBELO.js');
 
 
-var _chunkEM2E7YISjs = require('./chunk-EM2E7YIS.js');
+var _chunk3L76SFGNjs = require('./chunk-3L76SFGN.js');
 
 
 
-var _chunk57F5VKHVjs = require('./chunk-57F5VKHV.js');
+var _chunkH7YFUC3Jjs = require('./chunk-H7YFUC3J.js');
 
 
-var _chunkCNQBCLQPjs = require('./chunk-CNQBCLQP.js');
+var _chunk5FHU67ATjs = require('./chunk-5FHU67AT.js');
 
 
-var _chunkAGIEKE3Ljs = require('./chunk-AGIEKE3L.js');
+var _chunkSYWOSAW7js = require('./chunk-SYWOSAW7.js');
 
 // src/cli/compatibility-catalog.ts
 var readers = /* @__PURE__ */ new WeakMap();
@@ -44,7 +44,7 @@ function trustedAutoUpdateRegistryUrl(baseUrl) {
 async function reportAutoUpdateEvent(input) {
   let apiKey = "";
   try {
-    apiKey = _chunkCNQBCLQPjs.resolveApiKeyForBaseUrl.call(void 0, input.baseUrl);
+    apiKey = _chunk5FHU67ATjs.resolveApiKeyForBaseUrl.call(void 0, input.baseUrl);
   } catch (e2) {
     return;
   }
@@ -60,15 +60,15 @@ async function reportAutoUpdateEvent(input) {
       headers: {
         Authorization: `Bearer ${apiKey}`,
         "Content-Type": "application/json",
-        "User-Agent": `deepline-ts-sdk/${_chunkAGIEKE3Ljs.SDK_VERSION}`,
+        "User-Agent": `deepline-ts-sdk/${_chunkSYWOSAW7js.SDK_VERSION}`,
         "X-Deepline-Client-Family": "sdk",
         "X-Deepline-CLI-Family": "sdk",
-        "X-Deepline-CLI-Version": _chunkAGIEKE3Ljs.SDK_VERSION,
-        "X-Deepline-SDK-Version": _chunkAGIEKE3Ljs.SDK_VERSION
+        "X-Deepline-CLI-Version": _chunkSYWOSAW7js.SDK_VERSION,
+        "X-Deepline-SDK-Version": _chunkSYWOSAW7js.SDK_VERSION
       },
       body: JSON.stringify({
         event: input.event,
-        current_version: _optionalChain([input, 'access', _4 => _4.response, 'access', _5 => _5.current, 'optionalAccess', _6 => _6.trim, 'call', _7 => _7()]) || _chunkAGIEKE3Ljs.SDK_VERSION,
+        current_version: _optionalChain([input, 'access', _4 => _4.response, 'access', _5 => _5.current, 'optionalAccess', _6 => _6.trim, 'call', _7 => _7()]) || _chunkSYWOSAW7js.SDK_VERSION,
         target_version: input.response.latest,
         reason: _optionalChain([input, 'access', _8 => _8.response, 'access', _9 => _9.auto_update, 'optionalAccess', _10 => _10.reason]),
         command: _nullishCoalesce(input.response.command, () => ( null)),
@@ -87,13 +87,13 @@ function envTruthy(name) {
   return value === "1" || value === "true" || value === "yes";
 }
 function shouldSkipSelfUpdate(policy) {
-  return policy === "off" || envTruthy("DEEPLINE_SKIP_SELF_UPDATE") || envTruthy("DEEPLINE_NO_AUTO_UPDATE") || envTruthy("DEEPLINE_SKIP_SDK_AUTO_UPDATE") || envTruthy("DEEPLINE_DISABLE_AUTO_UPDATE") || !_chunk6R5UKWRWjs.shouldRunCliAutoUpdate.call(void 0, ) || _chunkEM2E7YISjs.isCiEnvironment.call(void 0, );
+  return policy === "off" || envTruthy("DEEPLINE_SKIP_SELF_UPDATE") || envTruthy("DEEPLINE_NO_AUTO_UPDATE") || envTruthy("DEEPLINE_SKIP_SDK_AUTO_UPDATE") || envTruthy("DEEPLINE_DISABLE_AUTO_UPDATE") || !_chunkGJPRBELOjs.shouldRunCliAutoUpdate.call(void 0, ) || _chunk3L76SFGNjs.isCiEnvironment.call(void 0, );
 }
 function isDowngradeAutoUpdateResponse(response) {
   const target = _optionalChain([response, 'optionalAccess', _17 => _17.latest, 'optionalAccess', _18 => _18.trim, 'call', _19 => _19()]);
-  const current = _optionalChain([response, 'optionalAccess', _20 => _20.current, 'optionalAccess', _21 => _21.trim, 'call', _22 => _22()]) || _chunkAGIEKE3Ljs.SDK_VERSION;
+  const current = _optionalChain([response, 'optionalAccess', _20 => _20.current, 'optionalAccess', _21 => _21.trim, 'call', _22 => _22()]) || _chunkSYWOSAW7js.SDK_VERSION;
   if (!target) return false;
-  return _chunk6R5UKWRWjs.compareUpdateVersions.call(void 0, target, current) < 0;
+  return _chunkGJPRBELOjs.compareUpdateVersions.call(void 0, target, current) < 0;
 }
 function relaunchCurrentCommand(plan, runtime = {}) {
   return new Promise((resolve) => {
@@ -146,7 +146,7 @@ async function maybeAutoUpdateAndRelaunch(response, baseUrl, policy = "configure
   }
   if (isDowngradeAutoUpdateResponse(response)) {
     const target = response.latest;
-    const current = _optionalChain([response, 'access', _26 => _26.current, 'optionalAccess', _27 => _27.trim, 'call', _28 => _28()]) || _chunkAGIEKE3Ljs.SDK_VERSION;
+    const current = _optionalChain([response, 'access', _26 => _26.current, 'optionalAccess', _27 => _27.trim, 'call', _28 => _28()]) || _chunkSYWOSAW7js.SDK_VERSION;
     process.stderr.write(
       `Deepline SDK/CLI auto-update refused: server advertised older ${target} than current ${current}. Continuing without mutating the CLI.
 `
@@ -154,21 +154,21 @@ async function maybeAutoUpdateAndRelaunch(response, baseUrl, policy = "configure
     return false;
   }
   const packageSpec = response.latest ? `deepline@${response.latest}` : void 0;
-  const plan = _chunk6R5UKWRWjs.resolveUpdatePlan.call(void 0, {
+  const plan = _chunkGJPRBELOjs.resolveUpdatePlan.call(void 0, {
     packageSpec,
     requireVerifiedNpmOwnership: true,
     npmFallbackRegistryUrl: trustedAutoUpdateRegistryUrl(baseUrl)
   });
-  if (!_chunk6R5UKWRWjs.canAutomaticallyApplyUpdatePlan.call(void 0, plan)) {
+  if (!_chunkGJPRBELOjs.canAutomaticallyApplyUpdatePlan.call(void 0, plan)) {
     return false;
   }
   if (!autoUpdate.required && autoUpdate.reason !== "rollback_forced") {
     deferredAutoUpdate = async () => {
       await applyAutoUpdate(response, baseUrl, plan, "next_command");
     };
-    if (_chunk57F5VKHVjs.isJsonOutputMode.call(void 0, )) {
+    if (_chunkH7YFUC3Jjs.isJsonOutputMode.call(void 0, )) {
       const target = _optionalChain([response, 'access', _29 => _29.latest, 'optionalAccess', _30 => _30.trim, 'call', _31 => _31()]);
-      _chunk57F5VKHVjs.addJsonNotice.call(void 0, {
+      _chunkH7YFUC3Jjs.addJsonNotice.call(void 0, {
         code: "sdk_update_queued",
         message: `Deepline SDK/CLI update${target ? ` to ${target}` : ""} is queued after this command; the next command will use it if installation succeeds.`
       });
@@ -181,7 +181,7 @@ async function maybeAutoUpdateAndRelaunch(response, baseUrl, policy = "configure
   return true;
 }
 async function applyAutoUpdate(response, baseUrl, plan, takesEffect) {
-  if (!_chunk6R5UKWRWjs.canAutomaticallyApplyUpdatePlan.call(void 0, plan)) return false;
+  if (!_chunkGJPRBELOjs.canAutomaticallyApplyUpdatePlan.call(void 0, plan)) return false;
   const autoUpdate = response.auto_update;
   const label = _optionalChain([autoUpdate, 'optionalAccess', _32 => _32.reason]) === "rollback_forced" ? "has a server rollback pending and needs the latest rollback-aware CLI" : _optionalChain([autoUpdate, 'optionalAccess', _33 => _33.reason]) === "deprecated" ? "is deprecated and will update automatically" : _optionalChain([autoUpdate, 'optionalAccess', _34 => _34.required]) ? "requires an update" : "has an update available and will update automatically";
   process.stderr.write(
@@ -194,7 +194,7 @@ async function applyAutoUpdate(response, baseUrl, plan, takesEffect) {
     event: "started",
     installKind: plan.kind
   });
-  const updateResult = await _chunk6R5UKWRWjs.runAutomaticUpdatePlan.call(void 0, plan);
+  const updateResult = await _chunkGJPRBELOjs.runAutomaticUpdatePlan.call(void 0, plan);
   if (updateResult.status === "skipped_previous_failure") {
     void reportAutoUpdateEvent({
       baseUrl,
@@ -245,7 +245,7 @@ var _crypto = require('crypto');
 var TOOL_EXECUTE_PROGRESS_INTERVAL_MS = 15e3;
 var activeToolExecuteCommand = null;
 function progressLine(line) {
-  if (!_chunk57F5VKHVjs.isJsonOutputMode.call(void 0, )) console.error(line);
+  if (!_chunkH7YFUC3Jjs.isJsonOutputMode.call(void 0, )) console.error(line);
 }
 function beginToolExecuteCommand() {
   if (activeToolExecuteCommand) return activeToolExecuteCommand.invocationId;

package/dist/cli/{chunk-SV3B6KW4.mjs → chunk-UXFUD2MB.mjs}

@@ -1,19 +1,19 @@
 import {
   npmSupportsAllowScripts,
   readNpmVersion
-} from "./chunk-GLSFZYZB.mjs";
+} from "./chunk-YMB2CD55.mjs";
 import {
   runSkillsCommand
-} from "./chunk-SOME764Z.mjs";
+} from "./chunk-NZBZFEVA.mjs";
 import {
   resolveShellSpawn
-} from "./chunk-YFKOA4HW.mjs";
+} from "./chunk-T5H7ETIM.mjs";
 import {
   printCommandEnvelope
-} from "./chunk-QG7UPPOK.mjs";
+} from "./chunk-4NFBYW7X.mjs";
 import {
   autoDetectBaseUrl
-} from "./chunk-VL7OL7YR.mjs";
+} from "./chunk-KQJHIVCE.mjs";
 
 // src/cli/commands/update.ts
 import { spawn, spawnSync } from "child_process";

package/dist/cli/{chunk-N72VIY7R.js → chunk-VDHDTXCK.js}

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _chunkEM2E7YISjs = require('./chunk-EM2E7YIS.js');
+var _chunk3L76SFGNjs = require('./chunk-3L76SFGN.js');
 
 // src/cli/npm-script-policy.ts
 var _child_process = require('child_process');
@@ -13,7 +13,7 @@ function npmSupportsAllowScripts(version) {
 }
 function readNpmVersion(env) {
   try {
-    const plan = _chunkEM2E7YISjs.resolveShellSpawn.call(void 0, "npm", ["--version"], process.platform, env);
+    const plan = _chunk3L76SFGNjs.resolveShellSpawn.call(void 0, "npm", ["--version"], process.platform, env);
     const result = _child_process.spawnSync.call(void 0, plan.command, plan.args, {
       encoding: "utf8",
       env,

package/dist/cli/{chunk-MXAB4W6E.js → chunk-XSSIBO74.js}

@@ -1,10 +1,10 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
 
-var _chunk57F5VKHVjs = require('./chunk-57F5VKHV.js');
+var _chunkH7YFUC3Jjs = require('./chunk-H7YFUC3J.js');
 
 
-var _chunkAGIEKE3Ljs = require('./chunk-AGIEKE3L.js');
+var _chunkSYWOSAW7js = require('./chunk-SYWOSAW7.js');
 
 // src/cli/commands/sessions.ts
 
@@ -139,7 +139,7 @@ function currentSessionFile(agent) {
   const newestFirst = listSessionFiles(agent).sort(
     (a, b) => b.mtimeMs - a.mtimeMs
   );
-  const sessionId = _chunkAGIEKE3Ljs.agentSessionIdFromEnvironment.call(void 0, 
+  const sessionId = _chunkSYWOSAW7js.agentSessionIdFromEnvironment.call(void 0, 
     process.env,
     agent === "auto" ? void 0 : agent === "claude" ? "claude_code" : "codex"
   );
@@ -451,7 +451,7 @@ function buildSessionUploadContent(raw) {
   return { encodedContent: encoded, needsChunking: true };
 }
 async function uploadPayload(path, payload) {
-  const { http } = _chunk57F5VKHVjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkH7YFUC3Jjs.getAuthedHttpClient.call(void 0, );
   return await http.post(path, payload);
 }
 async function uploadChunkedSessions(sessions, options) {
@@ -484,7 +484,7 @@ async function uploadChunkedSessions(sessions, options) {
     ...options.rating ? { rating: options.rating } : {}
   });
   const sessionIds = sessions.map((session) => session.sessionId);
-  _chunk57F5VKHVjs.printCommandEnvelope.call(void 0, 
+  _chunkH7YFUC3Jjs.printCommandEnvelope.call(void 0, 
     {
       ...response,
       ok: true,
@@ -516,7 +516,7 @@ async function handleSessionsSend(options) {
       filename: _path.basename.call(void 0, filePath),
       ...rating ? { rating } : {}
     });
-    _chunk57F5VKHVjs.printCommandEnvelope.call(void 0, 
+    _chunkH7YFUC3Jjs.printCommandEnvelope.call(void 0, 
       {
         ...response2,
         ok: true,
@@ -566,7 +566,7 @@ async function handleSessionsSend(options) {
     ...rating ? { rating } : {}
   });
   const sessionIds = built.map((session) => session.sessionId);
-  _chunk57F5VKHVjs.printCommandEnvelope.call(void 0, 
+  _chunkH7YFUC3Jjs.printCommandEnvelope.call(void 0, 
     {
       ...response,
       ok: true,
@@ -674,7 +674,7 @@ ${refreshMeta}
 </body>
 </html>`;
   _fs.writeFileSync.call(void 0, outputPath, html, "utf8");
-  _chunk57F5VKHVjs.printCommandEnvelope.call(void 0, 
+  _chunkH7YFUC3Jjs.printCommandEnvelope.call(void 0, 
     {
       ok: true,
       file: outputPath,

package/dist/cli/{chunk-QW6HNDS7.mjs → chunk-YK64LQPQ.mjs}

@@ -15,7 +15,7 @@ import {
   preparePlayRunAdmission,
   stagePlayFiles,
   startPlayRun
-} from "./chunk-FAG4DFUC.mjs";
+} from "./chunk-NELMCOWK.mjs";
 import {
   describePlayDetail,
   describePlayListItem
@@ -26,7 +26,7 @@ import {
   RETAINED_PIPELINE_RECEIVERS_HEADER,
   RUNTIME_ENVIRONMENT_TOKEN_HEADER,
   SDK_API_MAJOR
-} from "./chunk-SETIOXN4.mjs";
+} from "./chunk-OMPW5ELS.mjs";
 import {
   CustomerDbQueryOutcomeUnknownError
 } from "./chunk-4QF2K7TM.mjs";
@@ -5195,6 +5195,7 @@ var DeeplineClient = class _DeeplineClient {
     if (paginateInventory && !options?.grep?.trim())
       params.set("inventory_paginated", "1");
     if (options?.origin) params.set("origin", options.origin);
+    if (options?.summaryOnly) params.set("summary_only", "1");
     if (options?.categories) {
       params.set(
         "categories",
@@ -5633,6 +5634,10 @@ var DeeplineClient = class _DeeplineClient {
   async getPlay(name, options) {
     return this.playClient.getPlay(name, options);
   }
+  /** Estimate one Play without reading the rest of the workspace catalog. */
+  async getPlayCostEstimate(name) {
+    return this.http.get(`/api/v2/plays/${encodeURIComponent(name)}/cost`);
+  }
   /** Read one trigger inventory page without loading run histories. */
   async listPlayTriggerInventory(options) {
     const params = new URLSearchParams({ view: "inventory" });

package/dist/cli/{chunk-GLSFZYZB.mjs → chunk-YMB2CD55.mjs}

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

package/dist/cli/{chunk-F4L7WMLK.mjs → chunk-YNW47NOJ.mjs}

@@ -1,10 +1,10 @@
 import {
   getAuthedHttpClient,
   printCommandEnvelope
-} from "./chunk-QG7UPPOK.mjs";
+} from "./chunk-4NFBYW7X.mjs";
 import {
   agentSessionIdFromEnvironment
-} from "./chunk-SETIOXN4.mjs";
+} from "./chunk-OMPW5ELS.mjs";
 
 // src/cli/commands/sessions.ts
 import {

package/dist/cli/{chunk-FVYAEBGO.mjs → chunk-YUNPYX5T.mjs}

@@ -707,7 +707,7 @@ When:
 The sequence:
   search "<input you have -> result you need>"   find the play
   describe <ref>                required input, CSV columns, output fields
-  plays list --show-cost        per-row or per-run credit estimate
+  plays cost <ref>              per-row or per-run credit estimate
   run <ref> --input '{"csv":"file.csv"}' --csv-out out.csv   run it, save rows
 Writing a play:
   Start from code that already works, not a blank file.
@@ -848,17 +848,30 @@ Output (JSON):
 ]]
 Cost:
   Free.
+`
+  },
+  "plays cost": {
+    core: `
+Purpose:
+  Read the advisory cost estimate for one saved or prebuilt Play.
+Input:
+  <play> is a bare name or qualified reference.[[cli: --json prints the exact result.]]
+Output:
+  reference, costEstimate, and for prebuilts observedCost. Estimates include
+  the output unit, observed or static range, sample size and compute ceiling.
+Cost:
+  Read-only. Uses the current workspace's pricing; does not start a run.
 `
   },
   "plays list": {
     core: `
 Purpose:
-  Inventory of saved and prebuilt plays, one bounded page at a time.[[cli: It is
-  the command that carries cost estimates.]][[mcp: Search returns Play summaries;
+  Inventory of saved and prebuilt plays, one bounded page at a time.[[cli:
+  Add --show-cost for estimates across the page.]][[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
+  To price a catalog page: plays list --show-cost, then read the
   cost estimate line for the play, or in JSON observedCost (prebuilts) or
   costEstimate.
 ]]
@@ -868,7 +881,8 @@ When:
 ]]
 [[cli:
 Input:
-  --show-cost adds estimates. --limit and --cursor page. --categories
+  --show-cost adds estimates. --summary loads metadata without source or
+  revision payloads. --limit and --cursor page. --categories
   filters by tool category. --json prints JSON.
 ]]
 [[cli:
@@ -1058,7 +1072,9 @@ Output (JSON, printed when the run ends):
   datasets[] {datasetId, name, storage {schema, table}}, and actions holding
   exact follow-up commands: getRunCmd, getFullRunCmd, getBillingCmd,
   getLogsCmd, exportDatasetCmds[], queryTableSqlCmds[]. Rows are not in this
-  payload. Progress lines are printed while it waits; the JSON is the last
+  payload. When the play's rateLimit window is held, no run starts: the
+  package is the latest run plus rateLimited {latestRunId, nextAllowedAt,
+  message}. Progress lines are printed while it waits; the JSON is the last
   thing printed. To parse it, add --json: progress is suppressed and stdout
   is one JSON document.
 ]]
@@ -1069,7 +1085,9 @@ Output:
   rowOutcomes, warnings, datasets[] {tableNamespace, sqlQualifiedTableName,
   actions}, and next {inspect, full, billing, logs}, each naming the MCP call
   for that follow-up. Pass a dataset's tableNamespace as table_namespace to
-  deepline_read_play_output for its rows; rows are not in this payload.
+  deepline_read_play_output for its rows; rows are not in this payload. A
+  held rateLimit window starts no run and returns the latest run with
+  rateLimited {latestRunId, nextAllowedAt, message}.
 ]]
 Cost:
   Spends Deepline credits through the play's tool calls. Validation errors

package/dist/cli/{chunk-WG3KGAII.js → chunk-Z52WEIBR.js}

@@ -167,6 +167,7 @@ var PLAY_AUTHORING_BINDING_FIELDS = {
     "compatibility",
     "cron",
     "inline",
+    "rateLimit",
     "runtime",
     "secrets",
     "sqlListeners",
@@ -1371,6 +1372,22 @@ var PLAY_AUTHORING_FIELD_REGISTRY = {
     description: "Play-level sandbox deadline. The default is 30m; use a static duration such as 90m or 2h, up to 4h.",
     errorMessage: 'runtime.timeout must be a static duration such as "90m" or "2h".'
   },
+  "rateLimit.every": {
+    schema: _typebox.Type.String({ pattern: "^\\d+\\s*[smh]$" }),
+    fixtures: {
+      valid: "5m",
+      invalid: "5 minutes",
+      absent: void 0,
+      unresolved: { expression: "every" },
+      edition1: "5m"
+    },
+    referenceType: "string",
+    required: false,
+    resolution: "static-required",
+    issueCode: "play_authoring_binding_invalid",
+    description: "Start at most one run per window, such as 30s, 5m, or 1h (10s to 24h).",
+    errorMessage: 'rateLimit.every must be a static duration from "10s" to "24h", such as "5m".'
+  },
   "runtime.size": {
     schema: _typebox.Type.Literal("standard"),
     fixtures: {
@@ -1712,6 +1729,7 @@ var PLAY_AUTHORING_CLOUD_TYPE_DECLARATIONS = [
   `  inline?: ${cloudReferenceType("inline")};`,
   `  billing?: { maxCreditsPerRun?: ${cloudReferenceType("billing.maxCreditsPerRun")} };`,
   `  runtime?: { timeout?: ${cloudReferenceType("runtime.timeout")}; size?: ${cloudReferenceType("runtime.size")} };`,
+  `  rateLimit?: { every: ${cloudReferenceType("rateLimit.every")} };`,
   `  webhook?: { hmac?: { algorithm?: ${cloudReferenceType("bindings.webhook.hmac.algorithm")}; header?: ${cloudReferenceType("bindings.webhook.hmac.header")}; signaturePrefix?: ${cloudReferenceType("bindings.webhook.hmac.signaturePrefix")}; secretEnv: ${cloudReferenceType("bindings.webhook.hmac.secretEnv")} }; auth?: { type: ${cloudReferenceType("bindings.webhook.auth.type")}; headerFamily: ${cloudReferenceType("bindings.webhook.auth.headerFamily")}; signingSecrets: readonly ${cloudReferenceType("bindings.webhook.auth.signingSecrets[]")}[]; toleranceSeconds?: ${cloudReferenceType("bindings.webhook.auth.toleranceSeconds")} } };`,
   `  cron?: { schedule: ${cloudReferenceType("bindings.cron.schedule")}; timezone?: ${cloudReferenceType("bindings.cron.timezone")}; input?: PlayCronInput<TInput> };`,
   "  sqlListeners?: readonly SqlListenerDeclaration[];",
@@ -1736,7 +1754,7 @@ var PLAY_AUTHORING_CLOUD_TYPE_DECLARATIONS = [
   `export type PlayAsyncCallOptions = { description: ${cloudReferenceType("ctx.runPlayAsync.options.description")} };`,
   "declare const PLAY_RUN_ID_BRAND: unique symbol;",
   "export type PlayRunId = string & { readonly [PLAY_RUN_ID_BRAND]: 'PlayRunId' };",
-  "export type AsyncPlayRunRef = Readonly<{ runId: PlayRunId }>;",
+  "export type AsyncPlayRunRef = Readonly<{ runId: PlayRunId; rateLimited?: { latestRunId: string; nextAllowedAt: string; message: string } }>;",
   `export type RuntimeStepOptions = { semanticKey?: ${cloudReferenceType("ctx.step.semanticKey")}; staleAfterSeconds?: ${cloudReferenceType("ctx.step.staleAfterSeconds")} };`,
   `export type FetchOptions = { staleAfterSeconds?: ${cloudReferenceType("ctx.fetch.staleAfterSeconds")}; transient?: boolean };`,
   "export type CallFreshnessMetadata = { requestedStaleAfterSeconds: number | null; effectiveStaleAfterSeconds: number | null; source: 'executed' | 'operation_recovery' | 'reusable_result' | 'live_observation'; resultAgeMs: number; completedAt: number; operationReceiptKey?: string; unavailableReason?: string };",

package/dist/cli/{chunk-BWLXHUKH.mjs → chunk-ZZQIS3TH.mjs}

@@ -2,7 +2,7 @@ import {
   argsWantJson,
   openInBrowser,
   printCommandEnvelope
-} from "./chunk-QG7UPPOK.mjs";
+} from "./chunk-4NFBYW7X.mjs";
 import {
   ACTIVE_ORG_ID_ENV,
   ACTIVE_ORG_NAME_ENV,
@@ -22,12 +22,12 @@ import {
   saveHostEnvValues,
   saveProjectDeeplineEnvValues,
   storedHostApiKey
-} from "./chunk-VL7OL7YR.mjs";
+} from "./chunk-KQJHIVCE.mjs";
 import {
   SDK_API_CONTRACT,
   SDK_VERSION,
   detectAgentRuntime
-} from "./chunk-SETIOXN4.mjs";
+} from "./chunk-OMPW5ELS.mjs";
 
 // src/cli/commands/auth.ts
 import {

package/dist/cli/command-docs.js

@@ -6,7 +6,7 @@
 
 
 
-var _chunkHNP5V5BNjs = require('./chunk-HNP5V5BN.js');
+var _chunk6ZTSHKJFjs = require('./chunk-6ZTSHKJF.js');
 require('./chunk-COGTRVWW.js');
 
 
@@ -16,4 +16,4 @@ require('./chunk-COGTRVWW.js');
 
 
 
-exports.CLI_DOC_SURFACE = _chunkHNP5V5BNjs.CLI_DOC_SURFACE; exports.COMMAND_DOCS = _chunkHNP5V5BNjs.COMMAND_DOCS; exports.commandDocKey = _chunkHNP5V5BNjs.commandDocKey; exports.helpDetailFromArgv = _chunkHNP5V5BNjs.helpDetailFromArgv; exports.renderActionExplanation = _chunkHNP5V5BNjs.renderActionExplanation; exports.renderCommandExplanation = _chunkHNP5V5BNjs.renderCommandExplanation; exports.renderDocText = _chunkHNP5V5BNjs.renderDocText;
+exports.CLI_DOC_SURFACE = _chunk6ZTSHKJFjs.CLI_DOC_SURFACE; exports.COMMAND_DOCS = _chunk6ZTSHKJFjs.COMMAND_DOCS; exports.commandDocKey = _chunk6ZTSHKJFjs.commandDocKey; exports.helpDetailFromArgv = _chunk6ZTSHKJFjs.helpDetailFromArgv; exports.renderActionExplanation = _chunk6ZTSHKJFjs.renderActionExplanation; exports.renderCommandExplanation = _chunk6ZTSHKJFjs.renderCommandExplanation; exports.renderDocText = _chunk6ZTSHKJFjs.renderDocText;

package/dist/cli/command-docs.mjs

@@ -6,7 +6,7 @@ import {
   renderActionExplanation,
   renderCommandExplanation,
   renderDocText
-} from "./chunk-FVYAEBGO.mjs";
+} from "./chunk-YUNPYX5T.mjs";
 import "./chunk-KRD6H754.mjs";
 export {
   CLI_DOC_SURFACE,

package/dist/cli/{csv-D3JPZVUN.mjs → csv-OSDYY3QW.mjs}

@@ -4,13 +4,13 @@ import {
   printCommandEnvelope,
   printJson,
   readCsvRows
-} from "./chunk-QG7UPPOK.mjs";
-import "./chunk-VL7OL7YR.mjs";
-import "./chunk-SETIOXN4.mjs";
+} from "./chunk-4NFBYW7X.mjs";
+import "./chunk-KQJHIVCE.mjs";
+import "./chunk-OMPW5ELS.mjs";
 import "./chunk-4QF2K7TM.mjs";
 import "./chunk-DLIRSHV6.mjs";
 import "./chunk-HBL4PM5Q.mjs";
-import "./chunk-DSOTGAXS.mjs";
+import "./chunk-JRZW4LWK.mjs";
 import "./chunk-WZYKRD7T.mjs";
 import "./chunk-KRD6H754.mjs";