deepline 0.3.461 → 0.3.463

package/dist/cli/{providers-4WEC2EQN.mjs → providers-CCXZ3SQF.mjs}

@@ -1,19 +1,21 @@
 import {
   DeeplineClient
-} from "./chunk-VZBCEA5S.mjs";
+} from "./chunk-NTLI6P6Y.mjs";
+import "./chunk-RD6IQ2JY.mjs";
 import "./chunk-L2VKAASU.mjs";
 import "./chunk-FAG4DFUC.mjs";
-import "./chunk-EIMG75BT.mjs";
+import "./chunk-S3A4IXBQ.mjs";
 import "./chunk-UBKA33KY.mjs";
 import {
   printCommandEnvelope,
   shouldEmitJson
-} from "./chunk-QAJAJPKK.mjs";
-import "./chunk-RY4IVOU3.mjs";
+} from "./chunk-WUMIYOXQ.mjs";
+import "./chunk-F2RHUPVH.mjs";
+import "./chunk-I624J4H5.mjs";
 import "./chunk-4QF2K7TM.mjs";
 import "./chunk-DLIRSHV6.mjs";
 import "./chunk-HBL4PM5Q.mjs";
-import "./chunk-T3MVIPHG.mjs";
+import "./chunk-XDWS2JJT.mjs";
 import "./chunk-WZYKRD7T.mjs";
 import "./chunk-KRD6H754.mjs";
 

package/dist/cli/{providers-ZQV6QLVQ.js → providers-WFEUNPGC.js}

@@ -1,27 +1,29 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
 
-var _chunkMDJPEGVNjs = require('./chunk-MDJPEGVN.js');
+var _chunkSKU6ECIYjs = require('./chunk-SKU6ECIY.js');
+require('./chunk-UC4SFYNU.js');
 require('./chunk-E4CABWXL.js');
 require('./chunk-JKVRBCZL.js');
-require('./chunk-KXMNM4AQ.js');
+require('./chunk-NMU3VR5U.js');
 require('./chunk-XDVT3GOM.js');
 
 
 
-var _chunk5MDIZX7Mjs = require('./chunk-5MDIZX7M.js');
-require('./chunk-YQDUODZW.js');
+var _chunk5LHXOIPTjs = require('./chunk-5LHXOIPT.js');
+require('./chunk-BGNWI3KH.js');
+require('./chunk-YGGIZ3VT.js');
 require('./chunk-ALJJRZNJ.js');
 require('./chunk-XNYIZMNQ.js');
 require('./chunk-DIAWYWT5.js');
-require('./chunk-5FDKJQZE.js');
+require('./chunk-3BOIOCNX.js');
 require('./chunk-OG64RBAC.js');
 require('./chunk-COGTRVWW.js');
 
 // src/cli/commands/providers.ts
 async function listProviders(options = {}) {
-  const client = new (0, _chunkMDJPEGVNjs.DeeplineClient)();
+  const client = new (0, _chunkSKU6ECIYjs.DeeplineClient)();
   const changed = options.changed === true;
-  const emitJson = options.json === true || _chunk5MDIZX7Mjs.shouldEmitJson.call(void 0, );
+  const emitJson = options.json === true || _chunk5LHXOIPTjs.shouldEmitJson.call(void 0, );
   const providers = await client.listProviders({ changed });
   const render = {
     sections: [
@@ -40,7 +42,7 @@ async function listProviders(options = {}) {
       }
     ]
   };
-  _chunk5MDIZX7Mjs.printCommandEnvelope.call(void 0, 
+  _chunk5LHXOIPTjs.printCommandEnvelope.call(void 0, 
     {
       providers,
       count: providers.length,

package/dist/cli/{quickstart-HKUSFADF.js → quickstart-O4JSUORZ.js}

@@ -1,27 +1,28 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
 
-var _chunk5MDIZX7Mjs = require('./chunk-5MDIZX7M.js');
-require('./chunk-YQDUODZW.js');
+var _chunk5LHXOIPTjs = require('./chunk-5LHXOIPT.js');
+require('./chunk-BGNWI3KH.js');
+require('./chunk-YGGIZ3VT.js');
 require('./chunk-ALJJRZNJ.js');
 require('./chunk-XNYIZMNQ.js');
 require('./chunk-DIAWYWT5.js');
-require('./chunk-5FDKJQZE.js');
+require('./chunk-3BOIOCNX.js');
 require('./chunk-OG64RBAC.js');
 
 
 
-var _chunkEBU7LQ64js = require('./chunk-EBU7LQ64.js');
+var _chunk6V7KVRR5js = require('./chunk-6V7KVRR5.js');
 require('./chunk-COGTRVWW.js');
 
 // src/cli/commands/quickstart.ts
 async function handleQuickstart(options) {
-  const jsonOutput = _chunk5MDIZX7Mjs.shouldEmitJson.call(void 0, options.json === true);
+  const jsonOutput = _chunk5LHXOIPTjs.shouldEmitJson.call(void 0, options.json === true);
   const gettingStarted = {
-    skill: _chunkEBU7LQ64js.DEEPLINE_GTM_SKILL,
-    examples: _chunkEBU7LQ64js.DEEPLINE_GTM_STARTER_PROMPTS
+    skill: _chunk6V7KVRR5js.DEEPLINE_GTM_SKILL,
+    examples: _chunk6V7KVRR5js.DEEPLINE_GTM_STARTER_PROMPTS
   };
-  _chunk5MDIZX7Mjs.printCommandEnvelope.call(void 0, 
+  _chunk5LHXOIPTjs.printCommandEnvelope.call(void 0, 
     {
       ok: true,
       status: "deprecated",
@@ -29,16 +30,16 @@ async function handleQuickstart(options) {
       exitCode: 0,
       message: "`deepline quickstart` is deprecated. Start with the installed /deepline-gtm skill in your agent.",
       deprecatedCommand: "deepline quickstart",
-      replacement: _chunkEBU7LQ64js.DEEPLINE_GTM_SKILL,
+      replacement: _chunk6V7KVRR5js.DEEPLINE_GTM_SKILL,
       gettingStarted,
-      next: _chunkEBU7LQ64js.DEEPLINE_GTM_SKILL,
+      next: _chunk6V7KVRR5js.DEEPLINE_GTM_SKILL,
       render: {
         sections: [
           {
             title: "quickstart deprecated",
             lines: [
-              `Use ${_chunkEBU7LQ64js.DEEPLINE_GTM_SKILL} in your agent instead.`,
-              ..._chunkEBU7LQ64js.DEEPLINE_GTM_STARTER_PROMPTS.map(
+              `Use ${_chunk6V7KVRR5js.DEEPLINE_GTM_SKILL} in your agent instead.`,
+              ..._chunk6V7KVRR5js.DEEPLINE_GTM_STARTER_PROMPTS.map(
                 (example, index) => `${index + 1}. ${example.title}: ${example.prompt}`
               )
             ]

package/dist/cli/{quickstart-RQ76RIUE.mjs → quickstart-ZUULI635.mjs}

@@ -1,17 +1,18 @@
 import {
   printCommandEnvelope,
   shouldEmitJson
-} from "./chunk-QAJAJPKK.mjs";
-import "./chunk-RY4IVOU3.mjs";
+} from "./chunk-WUMIYOXQ.mjs";
+import "./chunk-F2RHUPVH.mjs";
+import "./chunk-I624J4H5.mjs";
 import "./chunk-4QF2K7TM.mjs";
 import "./chunk-DLIRSHV6.mjs";
 import "./chunk-HBL4PM5Q.mjs";
-import "./chunk-T3MVIPHG.mjs";
+import "./chunk-XDWS2JJT.mjs";
 import "./chunk-WZYKRD7T.mjs";
 import {
   DEEPLINE_GTM_SKILL,
   DEEPLINE_GTM_STARTER_PROMPTS
-} from "./chunk-WIYWSYDS.mjs";
+} from "./chunk-Q2EIZKVX.mjs";
 import "./chunk-KRD6H754.mjs";
 
 // src/cli/commands/quickstart.ts

package/dist/cli/run-ISDJYJMU.js

@@ -0,0 +1,443 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } 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 _chunkPVY4DPPFjs = require('./chunk-PVY4DPPF.js');
+require('./chunk-JVDKZJUH.js');
+
+
+
+var _chunkVY2GBNTXjs = require('./chunk-VY2GBNTX.js');
+
+
+
+
+var _chunkRGOUCIIZjs = require('./chunk-RGOUCIIZ.js');
+require('./chunk-ALZBANZI.js');
+
+
+var _chunkXQCTG5OOjs = require('./chunk-XQCTG5OO.js');
+require('./chunk-5LEAXRHV.js');
+require('./chunk-IAYSWZDJ.js');
+require('./chunk-AID3OYVJ.js');
+require('./chunk-ZM2YPJQJ.js');
+require('./chunk-VLEVVDWG.js');
+require('./chunk-J33TSWO5.js');
+require('./chunk-HGFFYVXN.js');
+require('./chunk-SKU6ECIY.js');
+require('./chunk-NA4T3B62.js');
+require('./chunk-UC4SFYNU.js');
+require('./chunk-E4CABWXL.js');
+require('./chunk-JKVRBCZL.js');
+require('./chunk-NMU3VR5U.js');
+require('./chunk-XDVT3GOM.js');
+require('./chunk-CBZP6J3V.js');
+require('./chunk-TIRBDQ3W.js');
+require('./chunk-7FCYPAPP.js');
+require('./chunk-NDHJR2WZ.js');
+require('./chunk-FK2HNDCN.js');
+require('./chunk-WUZS2HK6.js');
+
+
+var _chunkUROQDCVWjs = require('./chunk-UROQDCVW.js');
+require('./chunk-5LHXOIPT.js');
+require('./chunk-BGNWI3KH.js');
+require('./chunk-YGGIZ3VT.js');
+require('./chunk-ALJJRZNJ.js');
+require('./chunk-XNYIZMNQ.js');
+require('./chunk-DIAWYWT5.js');
+require('./chunk-3BOIOCNX.js');
+require('./chunk-OG64RBAC.js');
+require('./chunk-COGTRVWW.js');
+
+// src/cli/commands/run.ts
+var _fs = require('fs');
+function csvTarget(value) {
+  const named = /^([A-Za-z_][\w.-]*)=(.+)$/.exec(value);
+  return named ? { list: named[1], path: named[2] } : { path: value };
+}
+function splitRevision(name) {
+  const at = name.lastIndexOf("@");
+  return at > 0 && at < name.length - 1 ? { base: name.slice(0, at), revision: name.slice(at + 1) } : { base: name };
+}
+function readInput(options) {
+  if (options.input !== void 0 && options.inputFile !== void 0) {
+    throw new Error("Use --input or --input-file, not both.");
+  }
+  const path = _nullishCoalesce(options.inputFile, () => ( (_optionalChain([options, 'access', _ => _.input, 'optionalAccess', _2 => _2.startsWith, 'call', _3 => _3("@")]) ? options.input.slice(1) : void 0)));
+  const flag = options.inputFile !== void 0 ? "--input-file" : "--input";
+  const text = path === void 0 ? _nullishCoalesce(options.input, () => ( "{}")) : _fs.readFileSync.call(void 0, path === "-" ? 0 : path, "utf8");
+  let input;
+  try {
+    input = JSON.parse(text);
+  } catch (error) {
+    throw new Error(
+      `${flag} must be a JSON object: ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+  if (!input || typeof input !== "object" || Array.isArray(input)) {
+    throw new Error(`${flag} must be a JSON object.`);
+  }
+  return input;
+}
+function refuse(message, output) {
+  _chunkRGOUCIIZjs.writeExecutionOutput.call(void 0, 
+    { id: null, status: "failed", error: { message }, ran: false },
+    output
+  );
+  return 2;
+}
+async function runAnything(name, options) {
+  const output = {
+    jsonOut: options.jsonOut,
+    csvOut: _optionalChain([options, 'access', _4 => _4.csvOut, 'optionalAccess', _5 => _5.map, 'call', _6 => _6(csvTarget)]),
+    receiptJson: options.json === true,
+    receiptOut: options.receiptOut,
+    full: options.full === true,
+    logsOut: options.logsOut,
+    fields: _optionalChain([options, 'access', _7 => _7.fields, 'optionalAccess', _8 => _8.split, 'call', _9 => _9(","), 'access', _10 => _10.map, 'call', _11 => _11((path) => path.trim()), 'access', _12 => _12.filter, 'call', _13 => _13(Boolean)])
+  };
+  if (!_chunkRGOUCIIZjs.preflightExecutionOutput.call(void 0, output)) return 2;
+  let input;
+  let timeoutMs;
+  try {
+    input = readInput(options);
+    if (output.full && output.fields) {
+      throw new Error("Use --full or --fields, not both.");
+    }
+    if (options.lines !== void 0) {
+      if (!/^[1-9]\d*$/.test(options.lines)) {
+        throw new Error("--lines takes a whole number of lines, such as 60.");
+      }
+      output.lines = Number(options.lines);
+    }
+    if (options.maxCredits !== void 0 && !(Number(options.maxCredits) > 0 && isFinite(Number(options.maxCredits)))) {
+      throw new Error("--max-credits takes a number of credits above 0.");
+    }
+    if (options.timeout !== void 0 && options.timeout !== "0") {
+      const { parseToolExecuteTimeout } = await Promise.resolve().then(() => _interopRequireWildcard(require("./tools-XEC4OD3R.js")));
+      timeoutMs = parseToolExecuteTimeout(options.timeout);
+    }
+  } catch (error) {
+    return refuse(
+      error instanceof Error ? error.message : String(error),
+      output
+    );
+  }
+  const noWait = options.timeout === "0";
+  if (noWait && (output.jsonOut || _optionalChain([output, 'access', _14 => _14.csvOut, 'optionalAccess', _15 => _15.length]))) {
+    return refuse(
+      "--timeout 0 returns before there is data to write. Drop --json-out and --csv-out, and export the rows later with deepline runs export <run-id>.",
+      output
+    );
+  }
+  const play = { input, noWait, timeoutMs, output, options };
+  if (options.eval !== void 0) {
+    if (name !== void 0) {
+      return refuse("Use a name or -e, not both.", output);
+    }
+    const { writeInlinePlay } = await Promise.resolve().then(() => _interopRequireWildcard(require("./play-USJBQADG.js")));
+    let file;
+    try {
+      file = writeInlinePlay(options.eval);
+    } catch (error) {
+      return refuse(
+        error instanceof Error ? error.message : String(error),
+        output
+      );
+    }
+    output.label = "inline play (-e)";
+    try {
+      return await runPlay(file, play);
+    } finally {
+      _fs.rmSync.call(void 0, file, { force: true });
+    }
+  }
+  if (name === void 0) {
+    return refuse(
+      "Name what to run (a tool, a play, or a .play.ts file), or pass -e '<code>'.",
+      output
+    );
+  }
+  if (_chunkVY2GBNTXjs.looksLikeFilePath.call(void 0, name)) {
+    output.label = `${name} (play file)`;
+    return runPlay(name, play);
+  }
+  let { base, revision } = splitRevision(name);
+  let found = await _chunkPVY4DPPFjs.findNamed.call(void 0, base, {});
+  if (!found.chosen && revision) {
+    found = await _chunkPVY4DPPFjs.findNamed.call(void 0, name, {});
+    if (found.chosen)
+      ({ base, revision } = { base: name, revision: void 0 });
+  }
+  const { chosen, shadowed } = found;
+  if (!chosen) return refuse(_chunkPVY4DPPFjs.nothingNamed.call(void 0, base), output);
+  const { described } = chosen;
+  if (described.kind === "custom_play" && shadowed) {
+    console.error(
+      `Running your workspace play "${base}". It has the same name as a Deepline ${shadowed.described.kind.replace("_", " ")}; run that one with: deepline run ${_chunkXQCTG5OOjs.DEEPLINE_NAMESPACE}${base}`
+    );
+  }
+  const { runner } = described;
+  if (runner.via === "monitor") {
+    return refuse(
+      `"${base}" is a monitor type. A monitor is deployed, not run: ${runner.deploy}`,
+      output
+    );
+  }
+  if (runner.via === "tool" && (noWait || revision || options.maxCredits !== void 0)) {
+    return refuse(
+      noWait ? "A tool call returns its result when it finishes; --timeout 0 applies to plays." : revision ? `${runner.toolId} is a tool, which has no revisions.` : `--max-credits caps a play run. A tool call has one price: deepline run ${runner.toolId} --dry-run shows it.`,
+      output
+    );
+  }
+  output.label = runner.via === "play" ? `${runner.reference}${revision ? `@${revision}` : ""} (play)` : `${runner.toolId} (tool)`;
+  if (options.dryRun) return dryRun(described, input, output);
+  if (runner.via === "play") {
+    return runPlay(runner.reference, { ...play, revision });
+  }
+  const { executeToolForReceipt } = await Promise.resolve().then(() => _interopRequireWildcard(require("./tools-XEC4OD3R.js")));
+  return executeToolForReceipt({
+    toolId: runner.toolId,
+    params: input,
+    metadata: chosen.tool,
+    timeoutMs,
+    fresh: options.fresh === true,
+    output
+  });
+}
+function dryRun(described, input, output) {
+  const missing = described.inputs.filter((field) => field.required && !(field.name in input)).map((field) => field.name);
+  const known = new Set(described.inputs.map((field) => field.name));
+  const unknown = known.size ? Object.keys(input).filter((key) => !known.has(key)) : [];
+  _chunkRGOUCIIZjs.writeExecutionOutput.call(void 0, 
+    {
+      id: null,
+      status: "dry_run",
+      ran: false,
+      ...described.cost ? { price: described.cost } : {},
+      ...missing.length ? { error: { message: `The input is missing: ${missing.join(", ")}.` } } : {},
+      warnings: unknown.length ? [`The contract has no input named: ${unknown.join(", ")}.`] : [],
+      next: {
+        describe: `deepline describe ${described.id}`
+      }
+    },
+    output
+  );
+  return missing.length ? 2 : 0;
+}
+async function runPlay(reference, play) {
+  const { handlePlayRun, writePlayRunReceipt } = await Promise.resolve().then(() => _interopRequireWildcard(require("./play-USJBQADG.js")));
+  const { output, options, revision } = play;
+  if (options.dryRun) {
+    return handlePlayRun(
+      _chunkVY2GBNTXjs.resolvePlayRunCliOptions.call(void 0, reference, {
+        input: JSON.stringify(play.input),
+        dryRun: true,
+        json: output.receiptJson === true
+      })
+    );
+  }
+  let id = null;
+  let written = false;
+  const progress = _chunkUROQDCVWjs.createCliProgress.call(void 0, true);
+  if (!play.noWait) progress.setLogWriter(_chunkRGOUCIIZjs.openLogDestination.call(void 0, output));
+  try {
+    const code = await handlePlayRun(
+      _chunkVY2GBNTXjs.resolvePlayRunCliOptions.call(void 0, reference, {
+        input: JSON.stringify(play.input),
+        // The receipt is the only thing on stdout.
+        json: true,
+        // Every level goes to the logs; they are a file, not the screen.
+        logLevel: "debug",
+        ...revision === "latest" ? { latest: true } : revision === "live" ? { live: true } : revision ? { revisionId: revision } : {},
+        ...options.fresh ? { forceToolRefresh: true } : {},
+        ...options.maxCredits !== void 0 ? { maxCredits: options.maxCredits } : {},
+        ...play.noWait ? { wait: false } : {},
+        ...play.timeoutMs !== void 0 ? { tailTimeoutMs: String(play.timeoutMs) } : {}
+      }),
+      {
+        onRunStarted: (runId) => {
+          id = runId;
+        },
+        writeResult: async (client, status) => {
+          id = status.runId;
+          written = true;
+          const full = status.result === void 0 && ["completed", "failed", "cancelled"].includes(status.status) ? await client.getPlayStatus(status.runId, {
+            full: true,
+            billing: false
+          }) : status;
+          const final = full.status === status.status ? full : status;
+          await writePlayRunReceipt(
+            client,
+            // The full read skips billing; keep the cost the run reported.
+            { ...final, billing: _nullishCoalesce(final.billing, () => ( status.billing)) },
+            output
+          );
+        },
+        writeStarted: (runId, status) => {
+          written = true;
+          _chunkRGOUCIIZjs.writeExecutionOutput.call(void 0, 
+            {
+              id: runId,
+              status,
+              next: {
+                status: `deepline runs get ${runId}`,
+                export: `deepline runs export ${runId}`
+              }
+            },
+            output
+          );
+        }
+      }
+    );
+    if (!written) {
+      _chunkRGOUCIIZjs.writeExecutionOutput.call(void 0, 
+        {
+          id,
+          status: "failed",
+          error: { message: "The play did not start. See stderr." }
+        },
+        output
+      );
+    }
+    return code;
+  } catch (error) {
+    if (written) throw error;
+    _chunkRGOUCIIZjs.writeExecutionOutput.call(void 0, 
+      {
+        id,
+        status: "failed",
+        error: {
+          message: error instanceof Error ? error.message : String(error)
+        },
+        ...id ? { next: { status: `deepline runs get ${id}` } } : {}
+      },
+      output
+    );
+    return 1;
+  }
+}
+function registerRunCommand(program) {
+  program.command("run [name]").description(
+    "Run anything search returns: a tool, a play, or a local play file."
+  ).option(
+    "-e, --eval <code>",
+    "Run code as the body of a play function, in place of a name"
+  ).option("--input <json>", "Input as a JSON object").option(
+    "--input-file <path>",
+    "Input as a JSON object read from a file; - reads stdin"
+  ).option(
+    "--json-out <path>",
+    "Save the whole result as JSON to this new file; - writes it to stdout"
+  ).option(
+    "--csv-out <[list=]path>",
+    "Save a row list as CSV to this new file; [list=] picks which; repeatable",
+    (value, previous = []) => [...previous, value]
+  ).option(
+    "--fields <paths>",
+    "Only these comma-separated dotted paths, in the receipt and the CSV"
+  ).option("--full", "Show every field's type and first value").option("--lines <n>", "Show up to this many lines of values (default 32)").option("--json", "Print the receipt as JSON instead of text").option(
+    "--receipt-out <path>",
+    "Also save the JSON receipt to this new file"
+  ).option(
+    "--dry-run",
+    "Check the input against the contract and show the price; nothing is sent"
+  ).option(
+    "--fresh",
+    "Call providers again instead of reusing results saved by earlier runs"
+  ).option(
+    "--max-credits <credits>",
+    "Stop a play run that would spend more Deepline credits than this"
+  ).option(
+    "--timeout <duration>",
+    "Stop waiting after this long (90s, 10m, 1h); 0 returns a play at once"
+  ).option(
+    "--logs-out <path>",
+    "Write a play's live logs to this new file; - writes them to stdout"
+  ).addHelpText(
+    "after",
+    `
+Name:
+  Any id deepline search returns: a tool id, a play name or reference, or a
+  local play file. It resolves as deepline describe resolves it.
+  deepline/<name>   the Deepline tool or play, when a play your workspace
+                    created has the same name (that one runs by default)
+  <play>@latest     the newest saved revision; <play>@<revision-id> one
+                    revision. The live revision runs by default.
+  -e '<code>'       in place of a name: the code is the body of a play
+                    function, input holds --input, and deepline is the
+                    runtime, as in a .play.ts file in this directory.
+
+Input:
+  One JSON object whose fields are the inputs deepline describe lists.
+  A play that reads a CSV takes the path as a field: '{"csv":"leads.csv"}'.
+
+Output:
+  The data is always saved to a file: a new temporary one unless --json-out
+  or --csv-out names one. Output paths must not exist yet. A tool's data is
+  the provider's response; a play's is its result, each dataset handle
+  replaced by that dataset's rows.
+  The receipt says what ran, how it ended and what it cost, where the data
+  is, and what came back, within 32 lines (--lines changes it):
+    default    the tool's declared outputs, else the data itself, read
+               breadth-first: every top-level field before nested ones
+    --fields   only the paths you name; a path through a list applies to
+               each item, so people.email is every person's email
+    --full     every field's type and first value
+  --csv-out writes the row list it names, else the one --fields reaches
+  into, else the tool's declared row list, else the largest:
+  --csv-out people=people.csv. Repeat it for more lists. --fields under a
+  list's path choose its columns; company.domain becomes its own column.
+  The full JSON Schema goes to a file the receipt names. --json prints the
+  receipt as JSON; --receipt-out also saves it to a file.
+
+Where things are printed:
+  stdout   the receipt; or the data, under --json-out - or --csv-out -
+  stderr   progress, the live logs' path, and the receipt when the data
+           is on stdout
+  Only one of --json-out, --csv-out and --logs-out may use -.
+
+Waiting:
+  run waits for the result. --timeout stops waiting, not the work: a play
+  keeps running and the receipt says how to check on it. --timeout 0
+  returns a play's run id at once. A play's live logs go to a temporary
+  file named on stderr when it starts; --logs-out chooses the file.
+
+Reuse:
+  A tool call is saved under a retry key before it is sent. Running the same
+  call again within the hour, after an interruption, replays it instead of
+  paying twice. Plays reuse the results of calls they made before.
+  --fresh calls the providers again.
+
+Cost:
+  --dry-run shows the price first. --max-credits caps one play run, in
+  place of the play's own billing.maxCreditsPerRun: a run that reaches it
+  stops, and its receipt says so. A tool call has one price, so the cap
+  applies to plays.
+
+Follow-up:
+  deepline runs get <id> reads a run, or a tool call for 24 hours, again
+  by the id its receipt gave.
+
+Exit codes:
+  0  completed
+  1  the tool or play failed, or is still running after --timeout
+  2  nothing ran: bad input or flags, an existing output file, an unknown
+     name, a monitor type, or a --dry-run that found missing input
+
+Examples:
+  deepline run hunter_email_verifier --input '{"email":"a@b.com"}'
+  deepline run person-linkedin-to-email --input-file input.json --dry-run
+  deepline run my.play.ts --input '{"csv":"leads.csv"}' --csv-out out.csv
+  deepline run company-search --input-file - --json-out - < input.json
+  deepline run my-play@latest --timeout 0
+  deepline run -e 'return { doubled: input.n * 2 };' --input '{"n":21}'
+`
+  ).action(async (name, options) => {
+    process.exitCode = await runAnything(name, options);
+  });
+}
+
+
+
+exports.registerRunCommand = registerRunCommand; exports.runAnything = runAnything;