deepline 0.3.421 → 0.3.423

package/dist/cli/{play-3LFM2SV2.mjs → play-VCYQKCKF.mjs}

@@ -1,29 +1,31 @@
 import {
   addDescribeOptions,
   recordPlayTermination
-} from "./chunk-4PG4ARL2.mjs";
+} from "./chunk-KPKU53YO.mjs";
 import {
   registerDeprecatedSearchCommand
-} from "./chunk-ZOL3CIKN.mjs";
+} from "./chunk-YNT7PJND.mjs";
 import {
   handleDeploymentGet,
   handleDeploymentsList
-} from "./chunk-7TSF7E3B.mjs";
+} from "./chunk-S6KG7JCR.mjs";
 import {
   buildPlayDashboardUrl
-} from "./chunk-IHG7UAHD.mjs";
+} from "./chunk-MLJBCS3E.mjs";
 import {
   shellQuote
 } from "./chunk-OVDNJAJN.mjs";
 import "./chunk-LJ5747UC.mjs";
 import {
+  INLINE_PLAY_FILE,
   PLAY_DEFAULT_EXPORT,
   extractDefinedPlayName,
+  inlinePlaySource,
   isAstNode,
   listPlayFileExports,
   parsePlaySourceForAnalysis,
   resolveEnabledExecutionProfile
-} from "./chunk-AARWVK4C.mjs";
+} from "./chunk-2BQUML3X.mjs";
 import "./chunk-H7HIDGZ7.mjs";
 import "./chunk-FR2ILQ4G.mjs";
 import {
@@ -32,7 +34,7 @@ import {
 import {
   pinLocalPlayImports,
   planLocalPlayExecution
-} from "./chunk-ERFN2QY4.mjs";
+} from "./chunk-3DNKFH2G.mjs";
 import "./chunk-ZCALLYF6.mjs";
 import {
   DeeplineClient,
@@ -47,7 +49,7 @@ import {
   normalizePlayStatus,
   normalizeRunEventOperationRequest,
   parseLogLevel
-} from "./chunk-UCI4QROZ.mjs";
+} from "./chunk-6FFORGD2.mjs";
 import "./chunk-L2VKAASU.mjs";
 import {
   CSV_DATA_INPUT_KEY,
@@ -68,17 +70,17 @@ import "./chunk-UBKA33KY.mjs";
 import {
   checkPlayRunCompatibility,
   usesInlinePlayAdmission
-} from "./chunk-ZLPT2RZ5.mjs";
+} from "./chunk-PH4BP6KM.mjs";
 import {
   isCliTraceEnabled,
   recordCliTrace,
   resolveCliMaintenancePolicy,
   traceCliSpan
-} from "./chunk-EKQH4IUU.mjs";
+} from "./chunk-OPI7UCQG.mjs";
 import {
   createCliProgress,
   getActiveCliProgress
-} from "./chunk-RJLFCJ23.mjs";
+} from "./chunk-IW5QK3K6.mjs";
 import {
   argsWantJson,
   csvSafeJsonString,
@@ -93,16 +95,16 @@ import {
   printJsonError,
   renderCommandEnvelopeText,
   shouldEmitJson
-} from "./chunk-VC3E5HFO.mjs";
+} from "./chunk-QWJJMQNE.mjs";
 import {
   fetchWithDeploymentProtection
-} from "./chunk-VYLZS7X4.mjs";
+} from "./chunk-XSERB7H2.mjs";
 import "./chunk-MAMVGOSC.mjs";
 import "./chunk-DLIRSHV6.mjs";
 import {
   DeeplineError
 } from "./chunk-E4IXDAZI.mjs";
-import "./chunk-SPLOMS4N.mjs";
+import "./chunk-JDAXVQV7.mjs";
 import "./chunk-WZYKRD7T.mjs";
 import {
   __commonJS,
@@ -3986,6 +3988,7 @@ import {
   readFileSync as readFileSync2,
   readdirSync,
   realpathSync,
+  rmSync,
   statSync,
   writeFileSync as writeFileSync3
 } from "fs";
@@ -4085,7 +4088,7 @@ function registerRunChildrenCommand(runs) {
     "List async child Runs for one launch key, one page at a time."
   ).requiredOption(
     "--launch-key <key>",
-    "Authored ctx.runPlayAsync launch key"
+    "Authored deepline.runPlayAsync launch key"
   ).option("--cursor <cursor>", "Opaque cursor from the previous page").option("--limit <number>", "Rows to request (1\u201350; default 50)", "50").option("--json", "Emit JSON output").addHelpText(
     "after",
     `
@@ -5374,8 +5377,8 @@ function stringValue(value) {
 var EXTRACTED_GETTER_ERROR_HINT = "Deepline hint: extractedValues/extractedLists .get() only works for declared Deepline getters listed by `deepline describe <tool>`. Read tool-specific fields from `toolExecutionResult.toolResponse.rawV2` using the nesting shown in the response example, and use `toolExecutionResult.extractedLists.<name>.get()` for declared row/list outputs.";
 var DATASET_API_HINT = "Deepline hint: PlayDataset is lazy, durable, and async-only. Use `.count()`, `.first()`, `.at(index)`, `.peek(n)`, `.materialize(limit)`, or async iteration; do not use `.length`, numeric indexing, spread, synchronous iteration, `.rows`, or `.toArray()`.";
 var ROW_PROPERTY_HINT = "Deepline hint: this row type only contains fields produced by the CSV/schema and previous map steps. Check source column casing and the exact output field names from earlier steps before scaling.";
-var TOOLS_EXECUTE_SIGNATURE_HINT = "Deepline hint: ctx.tools.execute requires a request object: `ctx.tools.execute({ id, tool, input, description })`. The stable `id` is required for logs, metadata, and result-cache identity; terminal cache reuse is based on play, tool, semantic input, auth scope, provider action version, and cache policy. In authoring edition 11, also choose `staleAfterSeconds`: `0` for fresh logical work, a positive integer for the maximum reusable result age in seconds, or `null` for indefinite result reuse.";
-var RUN_PLAY_SIGNATURE_HINT = "Deepline hint: ctx.runPlay uses a stable key plus a composable child play reference. Direct-run-only or dataset-backed batch plays must be run directly, exported, then consumed by a separate play.";
+var TOOLS_EXECUTE_SIGNATURE_HINT = "Deepline hint: deepline.tools.execute requires a request object: `deepline.tools.execute({ id, tool, input, description })`. The stable `id` is required for logs, metadata, and result-cache identity; terminal cache reuse is based on play, tool, semantic input, auth scope, provider action version, and cache policy. In authoring edition 11, also choose `staleAfterSeconds`: `0` for fresh logical work, a positive integer for the maximum reusable result age in seconds, or `null` for indefinite result reuse.";
+var RUN_PLAY_SIGNATURE_HINT = "Deepline hint: deepline.runPlay uses a stable key plus a composable child play reference. Direct-run-only or dataset-backed batch plays must be run directly, exported, then consumed by a separate play.";
 var MAP_BACKED_CHILD_HINT = "Deepline hint: dataset-backed child plays own durable table state and cannot be called from another play. Run that play directly, export its dataset, then pass the CSV to the next play.";
 function sourceLineForError(sourceCode, error) {
   const match = error.match(/:(\d+):(\d+)\s/);
@@ -5400,7 +5403,7 @@ function looksLikeRowPropertyMismatch(error, sourceLine) {
   return /\brow\.[A-Za-z_][A-Za-z0-9_]*/.test(sourceLine);
 }
 function looksLikeToolsExecuteSignature(error, sourceLine) {
-  return /ctx\.tools\.execute requires a request object/i.test(error) || /Expected 1 arguments?, but got [2-9]/.test(error) && /\btools\.execute\(/.test(sourceLine);
+  return /\w+\.tools\.execute requires a request object/i.test(error) || /Expected 1 arguments?, but got [2-9]/.test(error) && /\btools\.execute\(/.test(sourceLine);
 }
 function looksLikeRunPlaySignature(error, sourceLine) {
   return /ctx\.runPlay/i.test(error) || /(?:Expected|Argument of type|No overload matches)/.test(error) && /\brunPlay\(/.test(sourceLine);
@@ -7590,7 +7593,7 @@ function parseInputFlagValue(raw) {
 function parsePlayRunOptions(args, initialInput = null) {
   const selection = parseJsonFields(args, "run");
   args = selection.args;
-  const usage2 = "Usage: deepline plays run <play-name> [--input '{...}'] [--run-id-file <path>] [--no-wait] [--tail-timeout-ms 30000] [--force] [--open] [--full] [--<input> value]\n       deepline plays run <play-file.ts> [--input '{...}'] [--run-id-file <path>] [--no-wait] [--tail-timeout-ms 30000] [--force] [--open] [--full] [--<input> value]\n       deepline plays run --file <play-file.ts> [--input '{...}'] [--profile <id>] [--run-id-file <path>] [--no-wait] [--tail-timeout-ms 30000] [--force] [--open] [--full] [--<input> value]\n       deepline plays run --name <name> [--input '{...}'] [--profile <id>] [--live|--latest|--revision-id <id>] [--run-id-file <path>] [--no-wait] [--tail-timeout-ms 30000] [--force] [--open] [--json] [--full] [--<input> value]\n       Runs use the Absurd CJS runtime.\n       --header '<name>: <value>' may repeat; each is sent on every request for this run.\n       Unknown --<input> value flags, such as --limit 5, are passed into play input.\nRun `deepline plays run --help` for idempotent call caching and ctx.dataset guidance.";
+  const usage2 = "Usage: deepline plays run <play-name> [--input '{...}'] [--run-id-file <path>] [--no-wait] [--tail-timeout-ms 30000] [--force] [--open] [--full] [--<input> value]\n       deepline plays run <play-file.ts> [--input '{...}'] [--run-id-file <path>] [--no-wait] [--tail-timeout-ms 30000] [--force] [--open] [--full] [--<input> value]\n       deepline plays run --file <play-file.ts> [--input '{...}'] [--profile <id>] [--run-id-file <path>] [--no-wait] [--tail-timeout-ms 30000] [--force] [--open] [--full] [--<input> value]\n       deepline plays run --name <name> [--input '{...}'] [--profile <id>] [--live|--latest|--revision-id <id>] [--run-id-file <path>] [--no-wait] [--tail-timeout-ms 30000] [--force] [--open] [--json] [--full] [--<input> value]\n       Runs use the Absurd CJS runtime.\n       --header '<name>: <value>' may repeat; each is sent on every request for this run.\n       Unknown --<input> value flags, such as --limit 5, are passed into play input.\nRun `deepline plays run --help` for idempotent call caching and deepline.dataset guidance.";
   let filePath = null;
   let playName = null;
   let input = initialInput === null ? null : structuredClone(initialInput);
@@ -8649,7 +8652,7 @@ function buildReadonlyPrebuiltPlayError(reference) {
     `Cannot edit or push ${reference} because Deepline prebuilt plays are read-only.
 To make your own version:
 1. Run: deepline plays get ${reference} --source --out ./${localName}.play.ts
-2. Change definePlay('${localName}', ...) to a new play name you own.
+2. Change its export const config = { name } to a new play name you own.
 3. Run: deepline plays check ./${localName}.play.ts
 4. Run: deepline plays publish ./${localName}.play.ts
 5. Your play will then live under your workspace namespace.`
@@ -8663,13 +8666,28 @@ async function ensureEditableRemotePlay(client, target) {
   }
   return detail;
 }
+function writeInlinePlay(code) {
+  const filePath = resolve5(INLINE_PLAY_FILE);
+  const source = inlinePlaySource(code);
+  try {
+    writeFileSync3(filePath, source, { flag: "wx" });
+  } catch (error) {
+    if (error.code === "EEXIST") {
+      throw new Error(
+        `${filePath} already exists. Remove it, or run it with: deepline plays run ${filePath}`
+      );
+    }
+    throw error;
+  }
+  return filePath;
+}
 function buildMissingDefinePlayError(filePath) {
   return new Error(
-    `Play file ${filePath} must export definePlay('play-name', async (...) => { ... }). Plain \`export default async function ...\` plays are no longer supported for SDK/CLI file-backed runs.`
+    `Play file ${filePath} is not a play. Write the play as \`import deepline from 'deepline'; export default async function (input: T) { ... return { ... }; }\`.`
   );
 }
 function extractPlayName(code, filePath) {
-  const definedPlayName = extractDefinedPlayName(code);
+  const definedPlayName = extractDefinedPlayName(code, filePath);
   if (definedPlayName) {
     return definedPlayName;
   }
@@ -8896,7 +8914,7 @@ var PlayBundleGraphError = class extends Error {
 };
 function unresolvedPackagedFilesMessage(node) {
   const details = node.unresolvedFileReferences.map((unresolved) => `${unresolved.sourceFragment}: ${unresolved.message}`).join("; ");
-  return `Failed to package local ctx.csv(...) files in ${node.filePath}: ${details}`;
+  return `Failed to package local deepline.csv(...) files in ${node.filePath}: ${details}`;
 }
 async function collectBundledPlayGraph(entryFile, profile = null, entryExportName = PLAY_DEFAULT_EXPORT, options = {}) {
   const playBundler = await loadPlayBundler();
@@ -8987,19 +9005,9 @@ function requireCompilerManifest(node) {
   }
   return node.compilerManifest;
 }
-function missingPlayDescriptionMessage(node) {
-  const playName = node.playName ?? extractPlayName(node.sourceCode, node.filePath);
-  return [
-    `Play description is required for ${playName} (${node.filePath}).`,
-    "Add a top-level description to definePlay so agents and future play surfaces can explain what this play does.",
-    `Example: definePlay("${playName}", async (ctx, input) => { ... }, { description: "Look up company details from a domain." })`,
-    `Object form: definePlay({ id: "${playName}", description: "Look up company details from a domain.", input, run })`
-  ].join(" ");
-}
 function collectPlayGraphAuthoringErrors(graph) {
   return [...graph.nodes.values()].flatMap((node) => [
-    ...node.unresolvedFileReferences.length > 0 ? [unresolvedPackagedFilesMessage(node)] : [],
-    ...node.playDescription?.trim() ? [] : [missingPlayDescriptionMessage(node)]
+    ...node.unresolvedFileReferences.length > 0 ? [unresolvedPackagedFilesMessage(node)] : []
   ]);
 }
 function assertPlayGraphAuthoring(graph) {
@@ -9024,7 +9032,7 @@ async function publishImportedPlayDependencies(client, graph) {
     }
     if (!node.playName) {
       throw new Error(
-        `Imported play ${absolutePath} must export definePlay(...) so it can be published for runtime composition.`
+        `Imported play ${absolutePath} must be a script play (import deepline from 'deepline') or default-export a play function so it can be published for runtime composition.`
       );
     }
     await client.registerPlayArtifact({
@@ -9236,7 +9244,7 @@ function getRunLifecycleHint(input) {
     const resumeAt = projectedWake ?? (typeof recordedWake === "number" && Number.isFinite(recordedWake) ? recordedWake : null);
     return {
       signature: [runId, status, "sleep", resumeAt ?? ""].join(":"),
-      line: `[play waiting] ${runId} is ${describeSleepUntil(resumeAt)} (ctx.sleep). The command will continue watching; inspect it with ${inspect}.`
+      line: `[play waiting] ${runId} is ${describeSleepUntil(resumeAt)} (deepline.sleep). The command will continue watching; inspect it with ${inspect}.`
     };
   }
   const typedEventWaitKind = getLiveRunStringField(input.event, "waitKind");
@@ -9377,7 +9385,7 @@ function emitLiveDebugTableHints(input) {
   }
   input.state.emittedDebugKeys.add(tableKey);
   input.progress.writeLine(
-    `Possible dataset table ${tableNamespace}: created only after this ctx.dataset(...).run(...) executes. Inspect returned datasets with ${buildRunInspectCommand(input.runId)}`,
+    `Possible dataset table ${tableNamespace}: created only after this deepline.dataset(...).run(...) executes. Inspect returned datasets with ${buildRunInspectCommand(input.runId)}`,
     process.stdout
   );
 }
@@ -12639,7 +12647,7 @@ ${commands.join("\n")}`,
   if (rowsInfo.exportUnavailableReason === "returned_dataset_not_persisted") {
     const datasetLabel = options.datasetPath ?? rowsInfo.source ?? rowsInfo.datasetId ?? "result.rows";
     throw new DeeplineError(
-      rowsInfo.exportUnavailableMessage ?? `Run ${status.runId} returned rows for '${datasetLabel}' without a run-scoped durable dataset. Persist the rows with ctx.dataset("rows", rows).run() before returning them.`,
+      rowsInfo.exportUnavailableMessage ?? `Run ${status.runId} returned rows for '${datasetLabel}' without a run-scoped durable dataset. Persist the rows with deepline.dataset("rows", rows).run() before returning them.`,
       void 0,
       "RUN_EXPORT_NOT_AVAILABLE",
       {
@@ -12649,7 +12657,7 @@ ${commands.join("\n")}`,
         guidance: {
           do_not_rerun: false,
           reason: "The returned rows exist only in the in-memory tool result.",
-          persist_rows: 'ctx.dataset("rows", rows).run()'
+          persist_rows: 'deepline.dataset("rows", rows).run()'
         }
       }
     );
@@ -16662,7 +16670,7 @@ function registerPlayCommands(program) {
     `
 Concepts:
   Plays are durable cloud workflows.
-  Stable ctx.tools.execute({ id, tool, input, staleAfterSeconds: 0 }) requests fresh work.
+  Stable deepline.tools.execute({ id, tool, input, staleAfterSeconds: 0 }) requests fresh work.
   In authoring edition 11, choose freshness explicitly: 0 for fresh logical
   work, a positive integer for the maximum reusable result age in seconds, or
   null for indefinite result reuse. A matching completed operation receipt can
@@ -16670,7 +16678,7 @@ Concepts:
   omitted-value behavior.
   Completed calls are replay-safe during recovery of the same run; unfinished calls may execute again.
   A stable id recovers a completed call; repeating plays run starts new work.
-  ctx.dataset adds row keys and row progress.
+  deepline.dataset adds row keys and row progress.
   Named play runs use the live revision unless --latest or --revision-id is set.
   Installed npm and repo-local CLIs can run saved/prebuilt plays by name or
   bundle local .play.ts files for development workflows.
@@ -16700,8 +16708,23 @@ More options:
   deepline runs export -h
 
 Authoring:
+  A play is a .play.ts file that default-exports an async function of its
+  input; the file name is the default play name.
+    import deepline from 'deepline';
+    export default async function (input: { domain: string }) {
+      const company = await deepline.tools.execute({
+        id: 'company', tool: 'company_lookup', input: { domain: input.domain },
+        description: 'Look up the company.',
+      });
+      return { company };
+    }
+  The parameter's type is the input contract and the returned object is the
+  result. An optional export const config = { ... }; at the top of the file
+  sets the name, triggers and runtime.
+  Run code inline as the body of a play function (input holds --input):
+    deepline plays run -e 'deepline.log("hello"); return { ok: true };'
   Use normal TypeScript interpolation for human-facing strings:
-    const readyMessage = \`Put \${input.title} through to send-ready.\`;
+    const readyMessage = \`Put \${title} through to send-ready.\`;
   An authored diagram is optional but highly recommended for every new or
   substantially changed Play. Docflow parses only an explicit
   /** @mermaid ... */ block and its // @mermaid-node annotations; ordinary
@@ -16837,7 +16860,7 @@ Notes:
   It does not cancel active sibling runs.
   --force-tool-refresh re-executes completed tool receipts and may repeat billed
   provider calls. It is independent from --force.
-  --max-concurrent-external-calls controls the per-run provider-tool/ctx.fetch
+  --max-concurrent-external-calls controls the per-run provider-tool/deepline.fetch
   resident-work ceiling. Default: ${DEFAULT_MAX_CONCURRENT_EXTERNAL_CALLS}; accepted range: 1-${MAX_CONFIGURABLE_CONCURRENT_EXTERNAL_CALLS}.
   Provider pacing and sandbox memory limits still apply.
   --max-concurrent-rows sets the run-wide default and ceiling for live map row
@@ -16857,16 +16880,16 @@ Idempotent execution:
   still recover that operation after resume. Older authored editions keep their
   existing omitted-value behavior.
 
-    await ctx.tools.execute({ id: 'company_lookup', tool, input, staleAfterSeconds: 86400 });
+    await deepline.tools.execute({ id: 'company_lookup', tool, input, staleAfterSeconds: 86400 });
 
   The authored id is still required for readable logs and metadata, but
   renaming it alone does not rebuy the same provider request.
 
-  For rows, use ctx.dataset plus a stable row key:
+  For rows, use deepline.dataset plus a stable row key:
 
-    const rows = await ctx
+    const rows = await deepline
       .dataset('companies_v1', companies)
-      .withColumn('cto', (row, ctx) => ctx.tools.execute({
+      .withColumn('cto', (row) => deepline.tools.execute({
         id: 'find_cto',
         tool: 'dropleads_search_people',
         staleAfterSeconds: 86400,
@@ -16876,7 +16899,7 @@ Idempotent execution:
 
   Dataset cells are storage; put freshness on the actual call:
 
-    await ctx.tools.execute({
+    await deepline.tools.execute({
       id: 'find_cto',
       tool: 'dropleads_search_people',
       input: { filters: { companyDomains: [row.domain], jobTitles: ['CTO'] }, pagination: { page: 1, limit: 1 } },
@@ -16888,6 +16911,7 @@ Examples:
   deepline plays run long-background-play --no-wait
   deepline plays run long-background-play --run-id-file ./run-id.json
   deepline plays run my.play.ts --input '{"domain":"stripe.com"}'
+  deepline plays run -e 'deepline.log("hello"); return { ok: true };'
   deepline plays run my.play.ts --input '{"domain":"stripe.com"}' --log-level debug
   deepline plays run my.play.ts --profile absurd
   deepline plays run my.play.ts --max-concurrent-external-calls 20
@@ -16898,6 +16922,9 @@ Examples:
   deepline runs get <run-id>
 `
   ).option("--file <path>", "Local play file to run").option(
+    "-e, --eval <code>",
+    "Run code as the body of a play function (input holds --input), like a .play.ts file in this directory"
+  ).option(
     "--dry-run",
     "Show the local execution and import pinning plan without mutation"
   ).option("--name <name>", "Saved play name to run").option("-i, --input <json>", "Input JSON object or @file path").option("--live", "Run the current live revision explicitly").option("--latest", "Run the newest saved revision, even if it is not live").option(
@@ -16951,7 +16978,7 @@ Examples:
     "Refresh completed tool receipts; may repeat billed provider calls"
   ).option(
     "--max-concurrent-external-calls <count>",
-    `Concurrent provider-tool and ctx.fetch executions (${DEFAULT_MAX_CONCURRENT_EXTERNAL_CALLS} default, max ${MAX_CONFIGURABLE_CONCURRENT_EXTERNAL_CALLS})`
+    `Concurrent provider-tool and deepline.fetch executions (${DEFAULT_MAX_CONCURRENT_EXTERNAL_CALLS} default, max ${MAX_CONFIGURABLE_CONCURRENT_EXTERNAL_CALLS})`
   ).option(
     "--max-concurrent-rows <count>",
     `Run-wide dataset map row resolver ceiling (max ${MAX_CONFIGURABLE_CONCURRENT_ROWS})`
@@ -16974,32 +17001,44 @@ JSON field selection:
   explicitly to retrieve diagnostics. Bare --json prints the whole response.
 `
   ).action(
-    async (target, options, command) => {
-      const passthroughArgs = [...command.args];
-      const explicitTarget = options.file || options.name;
-      const targetIsInputFlag = typeof target === "string" && target.startsWith("--");
-      const effectiveTarget = explicitTarget || targetIsInputFlag ? null : target;
-      if (explicitTarget && typeof target === "string" && !targetIsInputFlag && !passthroughArgs.includes(target)) {
-        passthroughArgs.push(target);
-      }
-      if (effectiveTarget && passthroughArgs[0] === effectiveTarget) {
-        passthroughArgs.shift();
-      }
-      const exitCode = await handlePlayRun(
-        resolvePlayRunCliOptions(
-          effectiveTarget ?? void 0,
-          options,
-          passthroughArgs,
-          resolveCliMaintenancePolicy(command.optsWithGlobals())
-        )
-      );
-      recordCliTrace({
-        phase: "cli.play_command_exit",
-        exitCode
-      });
-      process.exitCode = exitCode;
+    async (target, cliOptions, command) => {
+      const inlineFile = cliOptions.eval === void 0 ? null : writeInlinePlay(cliOptions.eval);
+      try {
+        process.exitCode = await runPlayCommand(
+          target,
+          inlineFile ? { ...cliOptions, file: inlineFile } : cliOptions,
+          command
+        );
+      } finally {
+        if (inlineFile) rmSync(inlineFile, { force: true });
+      }
     }
   );
+  async function runPlayCommand(target, options, command) {
+    const passthroughArgs = [...command.args];
+    const explicitTarget = options.file || options.name;
+    const targetIsInputFlag = typeof target === "string" && target.startsWith("--");
+    const effectiveTarget = explicitTarget || targetIsInputFlag ? null : target;
+    if (explicitTarget && typeof target === "string" && !targetIsInputFlag && !passthroughArgs.includes(target)) {
+      passthroughArgs.push(target);
+    }
+    if (effectiveTarget && passthroughArgs[0] === effectiveTarget) {
+      passthroughArgs.shift();
+    }
+    const exitCode = await handlePlayRun(
+      resolvePlayRunCliOptions(
+        effectiveTarget ?? void 0,
+        options,
+        passthroughArgs,
+        resolveCliMaintenancePolicy(command.optsWithGlobals())
+      )
+    );
+    recordCliTrace({
+      phase: "cli.play_command_exit",
+      exitCode
+    });
+    return exitCode;
+  }
   registerPlaySettingsCommands(play);
   registerPlayTriggerConfigCommands(play);
   play.command("get <target>").description(
@@ -17197,7 +17236,7 @@ Examples:
         process.exitCode = await ownView();
         return;
       }
-      const { describeAnything } = await import("./describe-DMRK4UNO.mjs");
+      const { describeAnything } = await import("./describe-RX6VROHQ.mjs");
       process.exitCode = await describeAnything(
         name,
         {
@@ -17605,7 +17644,7 @@ Examples:
     "after",
     `
 Notes:
-  Stops all active runs visible to this workspace, including child runs created by ctx.runPlay.
+  Stops all active runs visible to this workspace, including child runs created by deepline.runPlay.
   --dry-run lists the exact candidates (same scope, statuses, and order) and
   never cancels or mutates anything. A real stop-all exits nonzero when any
   cancellation failed or the candidate list was truncated; failed runs stay

package/dist/cli/{providers-CTIROUI3.js → providers-GIINJPWQ.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(); } }
 
-var _chunkFB5H5OOHjs = require('./chunk-FB5H5OOH.js');
+var _chunkAVOBDFQ5js = require('./chunk-AVOBDFQ5.js');
 require('./chunk-E4CABWXL.js');
 require('./chunk-2H4EY7KH.js');
 require('./chunk-KXMNM4AQ.js');
@@ -8,20 +8,20 @@ require('./chunk-XDVT3GOM.js');
 
 
 
-var _chunkGIJ47TAVjs = require('./chunk-GIJ47TAV.js');
-require('./chunk-C25ZYL6U.js');
+var _chunkEWWWOKX2js = require('./chunk-EWWWOKX2.js');
+require('./chunk-W42SSVM7.js');
 require('./chunk-NPBJI7RE.js');
 require('./chunk-XNYIZMNQ.js');
 require('./chunk-PPDBRJRW.js');
-require('./chunk-7SRVIWGT.js');
+require('./chunk-2F5ULM2F.js');
 require('./chunk-OG64RBAC.js');
 require('./chunk-COGTRVWW.js');
 
 // src/cli/commands/providers.ts
 async function listProviders(options = {}) {
-  const client = new (0, _chunkFB5H5OOHjs.DeeplineClient)();
+  const client = new (0, _chunkAVOBDFQ5js.DeeplineClient)();
   const changed = options.changed === true;
-  const emitJson = options.json === true || _chunkGIJ47TAVjs.shouldEmitJson.call(void 0, );
+  const emitJson = options.json === true || _chunkEWWWOKX2js.shouldEmitJson.call(void 0, );
   const providers = await client.listProviders({ changed });
   const render = {
     sections: [
@@ -40,7 +40,7 @@ async function listProviders(options = {}) {
       }
     ]
   };
-  _chunkGIJ47TAVjs.printCommandEnvelope.call(void 0, 
+  _chunkEWWWOKX2js.printCommandEnvelope.call(void 0, 
     {
       providers,
       count: providers.length,

package/dist/cli/{providers-IRICPDKU.mjs → providers-JLA6LST3.mjs}

@@ -1,6 +1,6 @@
 import {
   DeeplineClient
-} from "./chunk-UCI4QROZ.mjs";
+} from "./chunk-6FFORGD2.mjs";
 import "./chunk-L2VKAASU.mjs";
 import "./chunk-KCC3FKIW.mjs";
 import "./chunk-EIMG75BT.mjs";
@@ -8,12 +8,12 @@ import "./chunk-UBKA33KY.mjs";
 import {
   printCommandEnvelope,
   shouldEmitJson
-} from "./chunk-VC3E5HFO.mjs";
-import "./chunk-VYLZS7X4.mjs";
+} from "./chunk-QWJJMQNE.mjs";
+import "./chunk-XSERB7H2.mjs";
 import "./chunk-MAMVGOSC.mjs";
 import "./chunk-DLIRSHV6.mjs";
 import "./chunk-E4IXDAZI.mjs";
-import "./chunk-SPLOMS4N.mjs";
+import "./chunk-JDAXVQV7.mjs";
 import "./chunk-WZYKRD7T.mjs";
 import "./chunk-KRD6H754.mjs";
 

package/dist/cli/{quickstart-5FBQVZ5B.mjs → quickstart-AHCU75GG.mjs}

@@ -1,12 +1,12 @@
 import {
   printCommandEnvelope,
   shouldEmitJson
-} from "./chunk-VC3E5HFO.mjs";
-import "./chunk-VYLZS7X4.mjs";
+} from "./chunk-QWJJMQNE.mjs";
+import "./chunk-XSERB7H2.mjs";
 import "./chunk-MAMVGOSC.mjs";
 import "./chunk-DLIRSHV6.mjs";
 import "./chunk-E4IXDAZI.mjs";
-import "./chunk-SPLOMS4N.mjs";
+import "./chunk-JDAXVQV7.mjs";
 import "./chunk-WZYKRD7T.mjs";
 import {
   DEEPLINE_GTM_SKILL,

package/dist/cli/{quickstart-OZDVFNF2.js → quickstart-HHHLYCHT.js}

@@ -1,12 +1,12 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
 
-var _chunkGIJ47TAVjs = require('./chunk-GIJ47TAV.js');
-require('./chunk-C25ZYL6U.js');
+var _chunkEWWWOKX2js = require('./chunk-EWWWOKX2.js');
+require('./chunk-W42SSVM7.js');
 require('./chunk-NPBJI7RE.js');
 require('./chunk-XNYIZMNQ.js');
 require('./chunk-PPDBRJRW.js');
-require('./chunk-7SRVIWGT.js');
+require('./chunk-2F5ULM2F.js');
 require('./chunk-OG64RBAC.js');
 
 
@@ -16,12 +16,12 @@ require('./chunk-COGTRVWW.js');
 
 // src/cli/commands/quickstart.ts
 async function handleQuickstart(options) {
-  const jsonOutput = _chunkGIJ47TAVjs.shouldEmitJson.call(void 0, options.json === true);
+  const jsonOutput = _chunkEWWWOKX2js.shouldEmitJson.call(void 0, options.json === true);
   const gettingStarted = {
     skill: _chunkEBU7LQ64js.DEEPLINE_GTM_SKILL,
     examples: _chunkEBU7LQ64js.DEEPLINE_GTM_STARTER_PROMPTS
   };
-  _chunkGIJ47TAVjs.printCommandEnvelope.call(void 0, 
+  _chunkEWWWOKX2js.printCommandEnvelope.call(void 0, 
     {
       ok: true,
       status: "deprecated",

package/dist/cli/{search-FYM47QFU.mjs → search-5GACUIAX.mjs}

@@ -5,19 +5,19 @@ import {
   pointAtDescribe,
   registerDeprecatedSearchCommand,
   registerSearchCommand
-} from "./chunk-ZOL3CIKN.mjs";
+} from "./chunk-YNT7PJND.mjs";
 import "./chunk-LJ5747UC.mjs";
-import "./chunk-UCI4QROZ.mjs";
+import "./chunk-6FFORGD2.mjs";
 import "./chunk-L2VKAASU.mjs";
 import "./chunk-KCC3FKIW.mjs";
 import "./chunk-EIMG75BT.mjs";
 import "./chunk-UBKA33KY.mjs";
-import "./chunk-VC3E5HFO.mjs";
-import "./chunk-VYLZS7X4.mjs";
+import "./chunk-QWJJMQNE.mjs";
+import "./chunk-XSERB7H2.mjs";
 import "./chunk-MAMVGOSC.mjs";
 import "./chunk-DLIRSHV6.mjs";
 import "./chunk-E4IXDAZI.mjs";
-import "./chunk-SPLOMS4N.mjs";
+import "./chunk-JDAXVQV7.mjs";
 import "./chunk-WZYKRD7T.mjs";
 import "./chunk-KRD6H754.mjs";
 export {

package/dist/cli/search-W2PGBXQO.js

@@ -0,0 +1,30 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+
+
+var _chunk2U3AMRHFjs = require('./chunk-2U3AMRHF.js');
+require('./chunk-ZM2YPJQJ.js');
+require('./chunk-AVOBDFQ5.js');
+require('./chunk-E4CABWXL.js');
+require('./chunk-2H4EY7KH.js');
+require('./chunk-KXMNM4AQ.js');
+require('./chunk-XDVT3GOM.js');
+require('./chunk-EWWWOKX2.js');
+require('./chunk-W42SSVM7.js');
+require('./chunk-NPBJI7RE.js');
+require('./chunk-XNYIZMNQ.js');
+require('./chunk-PPDBRJRW.js');
+require('./chunk-2F5ULM2F.js');
+require('./chunk-OG64RBAC.js');
+require('./chunk-COGTRVWW.js');
+
+
+
+
+
+
+
+exports.SEARCH_TYPES = _chunk2U3AMRHFjs.SEARCH_TYPES; exports.appendCsv = _chunk2U3AMRHFjs.appendCsv; exports.parseTypes = _chunk2U3AMRHFjs.parseTypes; exports.pointAtDescribe = _chunk2U3AMRHFjs.pointAtDescribe; exports.registerDeprecatedSearchCommand = _chunk2U3AMRHFjs.registerDeprecatedSearchCommand; exports.registerSearchCommand = _chunk2U3AMRHFjs.registerSearchCommand;