deepline 0.3.421 → 0.3.423

package/dist/cli/{chunk-CTNA5QY2.mjs → chunk-EER67G2B.mjs}

@@ -647,7 +647,19 @@ Writing a play:
   plays check my.play.ts        validate after every edit; free
   plays run my.play.ts --input '{...}'           run the local file
   plays publish my.play.ts      make it live for plays run <name> and triggers
-  The file is: export default definePlay('name', async (ctx, input) => {...}).
+  plays run -e "<code>"         run code inline as a play function's body
+                                (input holds --input), like python -c
+  A play is a default-exported async function of its input; the file name
+  is its default name:
+    import deepline from 'deepline';
+    export default async function (input: { domain: string }) {
+      const company = await deepline.tools.execute({ id, tool, input, description });
+      return { company };
+    }
+  The parameter's type is the input contract; the returned object is the
+  result.
+  An optional export const config = { name, description, cron, webhook,
+  runtime }; at the top of the file sets the name, triggers and runtime.
   --help --verbose lists the authoring rules.
 Auditing plays:
   plays list                    every saved play
@@ -672,7 +684,8 @@ Writing a play:
   deepline_run_inline_play      run it without publishing; CSV data files go
                                 in files, named by input_file_path
   deepline_publish_play         make it live for deepline_run_play and triggers
-  The file is: export default definePlay('name', async (ctx, input) => {...}).
+  A play default-exports an async function of its input; it calls
+    deepline.tools.execute and returns { ... }.
   deepline_help with command "plays" and detail "verbose" lists the
   authoring rules.
 Auditing plays:
@@ -686,58 +699,60 @@ Cost:
 `,
     verbose: `
 Authoring rules:
-  Reach the outside world only through ctx: ctx.csv, ctx.dataset,
-    ctx.tools.execute, ctx.runPlay, ctx.step, ctx.fetch, ctx.secrets,
-    ctx.customerDb, and ctx.log. No fs, raw fetch, or shell commands, also not
-    inside ctx.step. Local nondeterministic work such as Date.now or
-    Math.random goes inside ctx.step.
+  Reach the outside world only through deepline: deepline.csv,
+    deepline.dataset, deepline.tools.execute, deepline.runPlay, deepline.step,
+    deepline.fetch, deepline.secrets, deepline.customerDb, and deepline.log.
+    No fs, raw fetch, or shell commands, also not inside deepline.step. Local
+    nondeterministic work such as Date.now or Math.random goes inside
+    deepline.step. Call deepline.* only in the play file; pass it to helpers.
   A run can be interrupted and replayed from the top; every finished step
     and tool call then returns its saved result. So the play name, each
-    ctx.dataset key, ctx.step id, ctx.fetch key, and ctx.tools.execute id is
-    a fixed string literal, and renaming one pays for that work again.
-  Rows: ctx.dataset('key', rows).withColumn('name', (row, rowCtx) => ...)
-    .run({ key: 'domain' }). Use a business identifier as the row key. Put
+    dataset key, step id, fetch key, and tools.execute id is a fixed string
+    literal, and renaming one pays for that work again.
+  Rows: deepline.dataset('key', rows).withColumn('name', (row) => ...)
+    .run({ key: 'domain' }); call deepline.* inside the column too. Use a business identifier as the row key. Put
     one paid call in a column, and shaping, status, and miss_reason in
     separate plain columns after it. Return the dataset for anything that
     should export as CSV.
   Dataset handles are async: await rows.count(), rows.first(),
     rows.peek(n), rows.materialize(n), or for await. Array methods on a
     handle fail [[cli:plays check]][[mcp:deepline_check_play]].
-  Tool calls: rowCtx.tools.execute({ id, tool, input, description,
+  Tool calls: deepline.tools.execute({ id, tool, input, description,
     staleAfterSeconds }). 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 still recover that operation after resume.
-    Read
-    results through the getters [[cli:describe]][[mcp:deepline_describe_tool]] lists:
+    Read results through the getters [[cli:describe]][[mcp:deepline_describe_tool]] lists:
     result.extractedValues.<name>.get() and
     result.extractedLists.<name>.get(). A field with no getter is under
     result.toolResponse.rawV2 with the provider's nesting kept.
-    staleAfterSeconds on the call sets how fresh a saved result must be.
-  Reuse before rebuilding: ctx.runPlay('prebuilt/<name>', input) runs a
+  Reuse before rebuilding: deepline.runPlay(key, 'prebuilt/<name>', input,
+    { description }) runs a
     prebuilt as one stage. Independent calls run together with Promise.all;
     a call that needs another's result waits for it.
   Failures: catch only ProviderTransientError, and only when another
     provider can answer the same question. Keep the last provider outside
     the catch so an exhausted waterfall fails loudly. Never branch on an
     error message.
-  External APIs: ctx.fetch with a fixed key, and credentials through
-    ctx.secrets.bearer(...) or ctx.secrets.header(...)[[cli:, stored with deepline
-    secrets set]]. res.json is a property, not a method; check res.ok. A play
-    cannot loop ctx.fetch over pages: fan out over rows with ctx.dataset, or
+  External APIs: deepline.fetch with a fixed key, and credentials through
+    deepline.secrets.bearer(...) or deepline.secrets.header(...)[[cli:, stored
+    with deepline secrets set]]. res.json is a property, not a method; check
+    res.ok. A play cannot loop deepline.fetch over pages: fan out over rows
+    with deepline.dataset, or
     call one endpoint that returns the whole result.
-  Triggers: a cron trigger receives {} unless its binding declares an input
-    object, written inline and pinned with the published revision.
+  Triggers: export const config = { cron: { schedule, timezone, input } };
+    or { webhook: {} }. A cron run receives {} unless cron.input is written
+    inline; it is pinned with the published revision.
   Runtime: The default Play runtime is 30 minutes. For a bounded long batch
-    set the play option runtime: { timeout: '90m', size: 'standard' }, up to
-    4h. That is not the CLI wait timeout.
+    set export const config = { runtime: { timeout: '90m', size: 'standard' } };
+    up to 4h. That is not the CLI wait timeout.
   Recurring sourcing: .run({ key: 'domain', mode: 'net_new' }) returns only
     rows the table has not seen before.
   Results: project each answer into flat columns (the value, its source,
     whether it was validated, the outcome, the reason) and keep evidence
     under _dl_meta, including result._metadata.execution.receiptKey. Unknown
     stays null, not false.
-  Diagram: a /** @mermaid <name> */ block above the play draws it in the
+  Diagram: a /** @mermaid */ block at the top of the play draws it in the
     dashboard, with // @mermaid-node <id> out:"<identifier>" above the
     statement each box stands for. [[cli:plays check]][[mcp:deepline_check_play]] validates it.
 `
@@ -1087,7 +1102,7 @@ Cost:
     core: `
 Purpose:
   Make one version of a play live, so [[plays run <name>]], triggers, and
-  ctx.runPlay callers use it.[[cli: A local .play.ts file is bundled, validated,
+  deepline.runPlay callers use it.[[cli: A local .play.ts file is bundled, validated,
   saved as a revision, and promoted in one step; a saved play promotes one
   of its existing revisions.]][[mcp: It promotes one of a saved play's existing
   revisions; deepline_publish_play saves and promotes a new file graph.]]
@@ -1118,7 +1133,7 @@ Avoid:
     core: `
 Purpose:
   Publish [[cli:a local .play.ts file]][[mcp:an inline .play.ts file graph]] or promote a saved revision, so [[plays run
-  <name>]], triggers, and ctx.runPlay callers use it. The same operation as
+  <name>]], triggers, and deepline.runPlay callers use it. The same operation as
   [[plays set-live]].
 When:
   Once a play [[cli:run by file path]][[mcp:run inline]] gives the right result. Running [[cli:a local file]][[mcp:a play inline]]
@@ -1255,7 +1270,7 @@ Debugging a run:
   last event, then [[runs logs <run-id>]][[cli: --failed]] for the failure window, then
   [[cli:runs watch <run-id>]][[mcp:deepline_get_run again]] to follow it if it is still active. A run can go quiet
   for minutes while it waits on a slow provider (Apify actors, large company
-  searches), an intentional ctx.sleep, or a rate-limit backoff; that is
+  searches), an intentional deepline.sleep, or a rate-limit backoff; that is
   healthy. Stop it only after about ten minutes without progress on a fast
   tool.
 `

package/dist/cli/{chunk-GIJ47TAV.js → chunk-EWWWOKX2.js}

@@ -3,7 +3,7 @@
 
 
 
-var _chunkC25ZYL6Ujs = require('./chunk-C25ZYL6U.js');
+var _chunkW42SSVM7js = require('./chunk-W42SSVM7.js');
 
 
 
@@ -288,8 +288,8 @@ var BROWSER_OPEN_COOLDOWN_MS = 3e4;
 var SAME_URL_BROWSER_OPEN_COOLDOWN_MS = 5 * 6e4;
 var defaultBrowserCommandRunner = childProcess;
 function getAuthedHttpClient() {
-  const config = _chunkC25ZYL6Ujs.resolveConfig.call(void 0, );
-  return { config, http: new (0, _chunkC25ZYL6Ujs.HttpClient)(config) };
+  const config = _chunkW42SSVM7js.resolveConfig.call(void 0, );
+  return { config, http: new (0, _chunkW42SSVM7js.HttpClient)(config) };
 }
 function stableOsUserId() {
   try {
@@ -629,7 +629,7 @@ function collectLocalEnvInfo() {
     os: `${process.platform} ${process.arch}`,
     node_version: process.version,
     home_dir: homeDir,
-    agent_runtime: _chunkC25ZYL6Ujs.detectAgentRuntime.call(void 0, )
+    agent_runtime: _chunkW42SSVM7js.detectAgentRuntime.call(void 0, )
   };
   const env = process.env;
   const optional = {
@@ -876,9 +876,9 @@ function markdownTableFromRows(rows, preferredColumns = []) {
 }
 function withAgentCommandContext(value) {
   const valueRecord = value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
-  return _chunkC25ZYL6Ujs.detectAgentRuntime.call(void 0, ) !== "unknown" && valueRecord && !Object.prototype.hasOwnProperty.call(valueRecord, "command_context") ? {
+  return _chunkW42SSVM7js.detectAgentRuntime.call(void 0, ) !== "unknown" && valueRecord && !Object.prototype.hasOwnProperty.call(valueRecord, "command_context") ? {
     ...valueRecord,
-    command_context: _chunkC25ZYL6Ujs.resolveCliCommandContext.call(void 0, )
+    command_context: _chunkW42SSVM7js.resolveCliCommandContext.call(void 0, )
   } : value;
 }
 function printJson(value, fields) {

package/dist/cli/{chunk-5E55HHW3.mjs → chunk-FJRFSBWO.mjs}

@@ -4,18 +4,18 @@ import {
   resolveUpdatePlan,
   runAutomaticUpdatePlan,
   shouldRunCliAutoUpdate
-} from "./chunk-5F6W5NWV.mjs";
+} from "./chunk-44US3EL2.mjs";
 import {
   isCiEnvironment
-} from "./chunk-RJLFCJ23.mjs";
+} from "./chunk-IW5QK3K6.mjs";
 import {
   addJsonNotice,
   isJsonOutputMode
-} from "./chunk-VC3E5HFO.mjs";
+} from "./chunk-QWJJMQNE.mjs";
 import {
   SDK_VERSION,
   resolveApiKeyForBaseUrl
-} from "./chunk-VYLZS7X4.mjs";
+} from "./chunk-XSERB7H2.mjs";
 
 // src/cli/compatibility-catalog.ts
 var readers = /* @__PURE__ */ new WeakMap();

package/dist/cli/{chunk-27GJKC5Q.js → chunk-GXOQRZXG.js}

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkBQR6UN3Cjs = require('./chunk-BQR6UN3C.js');
+var _chunkVUYUI35Qjs = require('./chunk-VUYUI35Q.js');
 
 // src/cli/describe-options.ts
 function addDescribeOptions(command, options = {}) {
@@ -18,7 +18,7 @@ function addDescribeOptions(command, options = {}) {
     "Show only the in-play example, and explain how it takes inputs and returns outputs"
   ).option("--no-example", "Hide the run examples").option(
     "--full-schema",
-    `Print every field: a long schema unfolded (over ${_chunkBQR6UN3Cjs.SCHEMA_LINE_LIMIT} lines), list rows, and a tool's raw response`
+    `Print every field: a long schema unfolded (over ${_chunkVUYUI35Qjs.SCHEMA_LINE_LIMIT} lines), list rows, and a tool's raw response`
   ).option(
     "--fields <names>",
     "Show only these fields, comma-separated, plus every required input"

package/dist/cli/{chunk-RURYN2BE.mjs → chunk-H662SHPT.mjs}

@@ -1,11 +1,11 @@
 import {
   addDescribeOptions,
   recordApiResponse
-} from "./chunk-4PG4ARL2.mjs";
+} from "./chunk-KPKU53YO.mjs";
 import {
   recentSearchRef,
   registerDeprecatedSearchCommand
-} from "./chunk-ZOL3CIKN.mjs";
+} from "./chunk-YNT7PJND.mjs";
 import {
   arrayField,
   formatModelDescription,
@@ -24,7 +24,7 @@ import {
   toolInputFieldsForDisplay,
   toolMetadataJsonForDescribe,
   toolOutputFieldsForDisplay
-} from "./chunk-IMZ56EOH.mjs";
+} from "./chunk-LXTSVUZN.mjs";
 import {
   shellQuote
 } from "./chunk-OVDNJAJN.mjs";
@@ -45,7 +45,7 @@ import {
 import {
   DeeplineClient,
   validateExecutionIdempotencyKey
-} from "./chunk-UCI4QROZ.mjs";
+} from "./chunk-6FFORGD2.mjs";
 import {
   stableStringify
 } from "./chunk-UBKA33KY.mjs";
@@ -55,18 +55,18 @@ import {
   maybeAutoUpdateAndRelaunch,
   registerCompatibilityCatalog,
   runToolExecuteStage
-} from "./chunk-5E55HHW3.mjs";
+} from "./chunk-FJRFSBWO.mjs";
 import {
   isCliTraceEnabled,
   recordCliTrace,
   resolveCliMaintenancePolicy
-} from "./chunk-EKQH4IUU.mjs";
+} from "./chunk-OPI7UCQG.mjs";
 import {
   checkSdkCompatibility,
   enforceSdkCompatibilityResponse,
   flushDeferredSkillsSyncNotices,
   syncSdkSkillsIfNeeded
-} from "./chunk-RJLFCJ23.mjs";
+} from "./chunk-IW5QK3K6.mjs";
 import {
   printCommandEnvelope,
   printCompactJson,
@@ -74,12 +74,12 @@ import {
   printJsonError,
   renderCommandEnvelopeText,
   shouldEmitJson
-} from "./chunk-VC3E5HFO.mjs";
+} from "./chunk-QWJJMQNE.mjs";
 import {
   readSdkSkillsLocalVersion,
   resolveConfig,
   sdkCliStateDirPath
-} from "./chunk-VYLZS7X4.mjs";
+} from "./chunk-XSERB7H2.mjs";
 import {
   DeeplineError
 } from "./chunk-E4IXDAZI.mjs";
@@ -878,7 +878,7 @@ Examples:
 Notes:
   Shows the compact agent contract by default: what the tool does, cost,
   required inputs, play getters, input and full Deepline response examples,
-  and a ctx.tools.execute snippet. Tool responses live at toolResponse.rawV2;
+  and a deepline.tools.execute snippet. Tool responses live at toolResponse.rawV2;
   preserve the nesting shown in the tool's example. Schemas and examples are
   separate describe fields.
   get is accepted as a compatibility alias for describe.
@@ -936,7 +936,7 @@ Examples:
         process.exitCode = await narrowView();
         return;
       }
-      const { describeAnything } = await import("./describe-DMRK4UNO.mjs");
+      const { describeAnything } = await import("./describe-RX6VROHQ.mjs");
       process.exitCode = await describeAnything(
         toolId,
         {
@@ -1576,7 +1576,7 @@ function printToolExamplesOnly(tool, requestedToolId) {
   console.log(JSON.stringify(sampleInput, null, 2));
   console.log(`Use in a play:`);
   console.log("```ts");
-  console.log("const result = await ctx.tools.execute({");
+  console.log("const result = await deepline.tools.execute({");
   console.log("  staleAfterSeconds: 0,");
   console.log(`  id: '${stableStepIdForTool(toolId)}',`);
   console.log(`  tool: '${toolId}',`);
@@ -1690,12 +1690,12 @@ function printToolGettersOnly(tool, requestedToolId) {
 function printListGetterConsumption() {
   if (playToolListGetterMode() === "array") {
     console.log(
-      "Use the ordinary array directly, or pass it to ctx.dataset to persist row work. No provider pagination is fetched. Lazy or incomplete lists throw; use readList for an explicit dataset read. A missing getter is not an empty list."
+      "Use the ordinary array directly, or pass it to deepline.dataset to persist row work. No provider pagination is fetched. Lazy or incomplete lists throw; use readList for an explicit dataset read. A missing getter is not an empty list."
     );
     return;
   }
   console.log(
-    "Pass the handle to ctx.dataset, use first() for one row, or for await...of to stream rows. materialize() loads the complete current list within the memory cap; materialize(n) and peek(n) return only a prefix. None fetch additional provider pagination. A missing getter is not an empty list."
+    "Pass the handle to deepline.dataset, use first() for one row, or for await...of to stream rows. materialize() loads the complete current list within the memory cap; materialize(n) and peek(n) return only a prefix. None fetch additional provider pagination. A missing getter is not an empty list."
   );
 }
 function listGetterHeading() {
@@ -2094,19 +2094,22 @@ function powerShellQuote(value) {
 }
 function seedToolListScript(input) {
   const stem = safeFileStem(input.toolId);
-  const fileName = `${stem}-workflow-seed-${Date.now()}.play.ts`;
+  const fileName = `${stem}-workflow.play.ts`;
   const scriptDir = mkdtempSync(join2(tmpdir(), "deepline-workflow-seed-"));
   chmodSync(scriptDir, 448);
   const scriptPath = join2(scriptDir, fileName);
   const projectDir = `deepline/projects/${stem}-workflow`;
-  const playName = `${stem}-workflow`;
   const sampleRows = input.rows.length > 0 ? `${JSON.stringify(input.rows.slice(0, 2)).replace(/\]$/, "")}, ...]` : "[]";
   const columns = Object.keys(input.rows[0] ?? {}).join(", ");
   const rowKey = Object.prototype.hasOwnProperty.call(input.rows[0] ?? {}, "id") ? '"id"' : "(row) => JSON.stringify(row)";
-  const script = `import { definePlay } from 'deepline';
+  const script = `import deepline from 'deepline';
 
-export default definePlay(${JSON.stringify(playName)}, async (ctx) => {
-  const result = await ctx.tools.execute({
+export const config = {
+  description: ${JSON.stringify(`Seed ${input.toolId} rows into a Deepline workflow-ready dataset.`)},
+};
+
+export default async function () {
+  const result = await deepline.tools.execute({
     staleAfterSeconds: 0,
     id: ${JSON.stringify(input.toolId)},
     tool: ${JSON.stringify(input.toolId)},
@@ -2122,11 +2125,11 @@ export default definePlay(${JSON.stringify(playName)}, async (ctx) => {
   // ${sampleRows}
   // columns: ${columns}
   // ${playToolListGetterMode() === "array" ? "extractedLists.<name>.get() returns an ordinary array from this response." : "extractedLists.<name>.get() returns a dataset handle for row-shaped list outputs."}
-  // ${playToolListGetterMode() === "array" ? "Use array methods directly; pass rows to ctx.dataset to persist row work." : "Pass it to ctx.dataset; use rows.peek/count/materialize only for deliberate bounded inspection."}
-  // .withColumn('email_waterfall', (row, rowCtx) => rowCtx.runPlay('name_domain_email', 'name-and-domain-to-email', { first_name: String(row.first_name ?? ''), last_name: String(row.last_name ?? ''), domain: String(row.domain ?? '') }, { description: 'Resolve email.' }))
-  // .withColumn('phone_waterfall', (row, rowCtx) => rowCtx.runPlay('contact_phone', 'contact-to-phone', { first_name: String(row.first_name ?? ''), last_name: String(row.last_name ?? ''), email: String(row.email ?? '') }, { description: 'Resolve phone.' }))
-  // ctx.dataset is idempotent for completed rows during same-run recovery. New runs follow each call's freshness.
-  const enrichedData = await ctx
+  // ${playToolListGetterMode() === "array" ? "Use array methods directly; pass rows to deepline.dataset to persist row work." : "Pass it to deepline.dataset; use rows.peek/count/materialize only for deliberate bounded inspection."}
+  // .withColumn('email_waterfall', (row) => deepline.runPlay('name_domain_email', 'name-and-domain-to-email', { first_name: String(row.first_name ?? ''), last_name: String(row.last_name ?? ''), domain: String(row.domain ?? '') }, { description: 'Resolve email.' }))
+  // .withColumn('phone_waterfall', (row) => deepline.runPlay('contact_phone', 'contact-to-phone', { first_name: String(row.first_name ?? ''), last_name: String(row.last_name ?? ''), email: String(row.email ?? '') }, { description: 'Resolve phone.' }))
+  // deepline.dataset is idempotent for completed rows during same-run recovery. New runs follow each call's freshness.
+  const enrichedData = await deepline
     .dataset('enriched_data', rows)
     .run({
       key: ${rowKey},
@@ -2137,9 +2140,7 @@ export default definePlay(${JSON.stringify(playName)}, async (ctx) => {
     rows: enrichedData,
     count: await enrichedData.count(),
   };
-}, {
-  description: ${JSON.stringify(`Seed ${input.toolId} rows into a Deepline workflow-ready dataset.`)},
-});
+}
 `;
   writeFileSync2(scriptPath, script, { encoding: "utf-8", mode: 384 });
   return {

package/dist/cli/{chunk-PKBPSMOT.js → chunk-INFLI36H.js}

@@ -647,7 +647,19 @@ Writing a play:
   plays check my.play.ts        validate after every edit; free
   plays run my.play.ts --input '{...}'           run the local file
   plays publish my.play.ts      make it live for plays run <name> and triggers
-  The file is: export default definePlay('name', async (ctx, input) => {...}).
+  plays run -e "<code>"         run code inline as a play function's body
+                                (input holds --input), like python -c
+  A play is a default-exported async function of its input; the file name
+  is its default name:
+    import deepline from 'deepline';
+    export default async function (input: { domain: string }) {
+      const company = await deepline.tools.execute({ id, tool, input, description });
+      return { company };
+    }
+  The parameter's type is the input contract; the returned object is the
+  result.
+  An optional export const config = { name, description, cron, webhook,
+  runtime }; at the top of the file sets the name, triggers and runtime.
   --help --verbose lists the authoring rules.
 Auditing plays:
   plays list                    every saved play
@@ -672,7 +684,8 @@ Writing a play:
   deepline_run_inline_play      run it without publishing; CSV data files go
                                 in files, named by input_file_path
   deepline_publish_play         make it live for deepline_run_play and triggers
-  The file is: export default definePlay('name', async (ctx, input) => {...}).
+  A play default-exports an async function of its input; it calls
+    deepline.tools.execute and returns { ... }.
   deepline_help with command "plays" and detail "verbose" lists the
   authoring rules.
 Auditing plays:
@@ -686,58 +699,60 @@ Cost:
 `,
     verbose: `
 Authoring rules:
-  Reach the outside world only through ctx: ctx.csv, ctx.dataset,
-    ctx.tools.execute, ctx.runPlay, ctx.step, ctx.fetch, ctx.secrets,
-    ctx.customerDb, and ctx.log. No fs, raw fetch, or shell commands, also not
-    inside ctx.step. Local nondeterministic work such as Date.now or
-    Math.random goes inside ctx.step.
+  Reach the outside world only through deepline: deepline.csv,
+    deepline.dataset, deepline.tools.execute, deepline.runPlay, deepline.step,
+    deepline.fetch, deepline.secrets, deepline.customerDb, and deepline.log.
+    No fs, raw fetch, or shell commands, also not inside deepline.step. Local
+    nondeterministic work such as Date.now or Math.random goes inside
+    deepline.step. Call deepline.* only in the play file; pass it to helpers.
   A run can be interrupted and replayed from the top; every finished step
     and tool call then returns its saved result. So the play name, each
-    ctx.dataset key, ctx.step id, ctx.fetch key, and ctx.tools.execute id is
-    a fixed string literal, and renaming one pays for that work again.
-  Rows: ctx.dataset('key', rows).withColumn('name', (row, rowCtx) => ...)
-    .run({ key: 'domain' }). Use a business identifier as the row key. Put
+    dataset key, step id, fetch key, and tools.execute id is a fixed string
+    literal, and renaming one pays for that work again.
+  Rows: deepline.dataset('key', rows).withColumn('name', (row) => ...)
+    .run({ key: 'domain' }); call deepline.* inside the column too. Use a business identifier as the row key. Put
     one paid call in a column, and shaping, status, and miss_reason in
     separate plain columns after it. Return the dataset for anything that
     should export as CSV.
   Dataset handles are async: await rows.count(), rows.first(),
     rows.peek(n), rows.materialize(n), or for await. Array methods on a
     handle fail [[cli:plays check]][[mcp:deepline_check_play]].
-  Tool calls: rowCtx.tools.execute({ id, tool, input, description,
+  Tool calls: deepline.tools.execute({ id, tool, input, description,
     staleAfterSeconds }). 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 still recover that operation after resume.
-    Read
-    results through the getters [[cli:describe]][[mcp:deepline_describe_tool]] lists:
+    Read results through the getters [[cli:describe]][[mcp:deepline_describe_tool]] lists:
     result.extractedValues.<name>.get() and
     result.extractedLists.<name>.get(). A field with no getter is under
     result.toolResponse.rawV2 with the provider's nesting kept.
-    staleAfterSeconds on the call sets how fresh a saved result must be.
-  Reuse before rebuilding: ctx.runPlay('prebuilt/<name>', input) runs a
+  Reuse before rebuilding: deepline.runPlay(key, 'prebuilt/<name>', input,
+    { description }) runs a
     prebuilt as one stage. Independent calls run together with Promise.all;
     a call that needs another's result waits for it.
   Failures: catch only ProviderTransientError, and only when another
     provider can answer the same question. Keep the last provider outside
     the catch so an exhausted waterfall fails loudly. Never branch on an
     error message.
-  External APIs: ctx.fetch with a fixed key, and credentials through
-    ctx.secrets.bearer(...) or ctx.secrets.header(...)[[cli:, stored with deepline
-    secrets set]]. res.json is a property, not a method; check res.ok. A play
-    cannot loop ctx.fetch over pages: fan out over rows with ctx.dataset, or
+  External APIs: deepline.fetch with a fixed key, and credentials through
+    deepline.secrets.bearer(...) or deepline.secrets.header(...)[[cli:, stored
+    with deepline secrets set]]. res.json is a property, not a method; check
+    res.ok. A play cannot loop deepline.fetch over pages: fan out over rows
+    with deepline.dataset, or
     call one endpoint that returns the whole result.
-  Triggers: a cron trigger receives {} unless its binding declares an input
-    object, written inline and pinned with the published revision.
+  Triggers: export const config = { cron: { schedule, timezone, input } };
+    or { webhook: {} }. A cron run receives {} unless cron.input is written
+    inline; it is pinned with the published revision.
   Runtime: The default Play runtime is 30 minutes. For a bounded long batch
-    set the play option runtime: { timeout: '90m', size: 'standard' }, up to
-    4h. That is not the CLI wait timeout.
+    set export const config = { runtime: { timeout: '90m', size: 'standard' } };
+    up to 4h. That is not the CLI wait timeout.
   Recurring sourcing: .run({ key: 'domain', mode: 'net_new' }) returns only
     rows the table has not seen before.
   Results: project each answer into flat columns (the value, its source,
     whether it was validated, the outcome, the reason) and keep evidence
     under _dl_meta, including result._metadata.execution.receiptKey. Unknown
     stays null, not false.
-  Diagram: a /** @mermaid <name> */ block above the play draws it in the
+  Diagram: a /** @mermaid */ block at the top of the play draws it in the
     dashboard, with // @mermaid-node <id> out:"<identifier>" above the
     statement each box stands for. [[cli:plays check]][[mcp:deepline_check_play]] validates it.
 `
@@ -1087,7 +1102,7 @@ Cost:
     core: `
 Purpose:
   Make one version of a play live, so [[plays run <name>]], triggers, and
-  ctx.runPlay callers use it.[[cli: A local .play.ts file is bundled, validated,
+  deepline.runPlay callers use it.[[cli: A local .play.ts file is bundled, validated,
   saved as a revision, and promoted in one step; a saved play promotes one
   of its existing revisions.]][[mcp: It promotes one of a saved play's existing
   revisions; deepline_publish_play saves and promotes a new file graph.]]
@@ -1118,7 +1133,7 @@ Avoid:
     core: `
 Purpose:
   Publish [[cli:a local .play.ts file]][[mcp:an inline .play.ts file graph]] or promote a saved revision, so [[plays run
-  <name>]], triggers, and ctx.runPlay callers use it. The same operation as
+  <name>]], triggers, and deepline.runPlay callers use it. The same operation as
   [[plays set-live]].
 When:
   Once a play [[cli:run by file path]][[mcp:run inline]] gives the right result. Running [[cli:a local file]][[mcp:a play inline]]
@@ -1255,7 +1270,7 @@ Debugging a run:
   last event, then [[runs logs <run-id>]][[cli: --failed]] for the failure window, then
   [[cli:runs watch <run-id>]][[mcp:deepline_get_run again]] to follow it if it is still active. A run can go quiet
   for minutes while it waits on a slow provider (Apify actors, large company
-  searches), an intentional ctx.sleep, or a rate-limit backoff; that is
+  searches), an intentional deepline.sleep, or a rate-limit backoff; that is
   healthy. Stop it only after about ten minutes without progress on a fast
   tool.
 `

package/dist/cli/{chunk-RJLFCJ23.mjs → chunk-IW5QK3K6.mjs}

@@ -1,6 +1,6 @@
 import {
   isJsonOutputMode
-} from "./chunk-VC3E5HFO.mjs";
+} from "./chunk-QWJJMQNE.mjs";
 import {
   DEFAULT_SKILL_AGENTS,
   KNOWN_SKILL_AGENTS,
@@ -17,13 +17,13 @@ import {
   sdkCliStateDirPath,
   skillsAgentPathSegment,
   writeSdkSkillsLocalVersion
-} from "./chunk-VYLZS7X4.mjs";
+} from "./chunk-XSERB7H2.mjs";
 import {
   DeeplineError
 } from "./chunk-E4IXDAZI.mjs";
 import {
   SDK_RELEASE
-} from "./chunk-SPLOMS4N.mjs";
+} from "./chunk-JDAXVQV7.mjs";
 
 // src/compat.ts
 import { randomUUID } from "crypto";

package/dist/cli/{chunk-SPLOMS4N.mjs → chunk-JDAXVQV7.mjs}

@@ -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.421",
+  version: "0.3.423",
   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-4PG4ARL2.mjs → chunk-KPKU53YO.mjs}

@@ -1,6 +1,6 @@
 import {
   SCHEMA_LINE_LIMIT
-} from "./chunk-IHG7UAHD.mjs";
+} from "./chunk-MLJBCS3E.mjs";
 
 // src/cli/describe-options.ts
 function addDescribeOptions(command, options = {}) {

package/dist/cli/{chunk-IMZ56EOH.mjs → chunk-LXTSVUZN.mjs}

@@ -2,7 +2,7 @@ import {
   rateLimitSummary,
   schemaField,
   schemaFields
-} from "./chunk-IHG7UAHD.mjs";
+} from "./chunk-MLJBCS3E.mjs";
 import {
   Capability,
   observedMaxText
@@ -618,7 +618,7 @@ function usageGuidanceWithAccessDefaults(usageGuidance) {
       extractedLists: {
         ...recordField(existingAccess, "extractedLists"),
         expression: "toolExecutionResult.extractedLists.<name>.get()",
-        meaning: playToolListGetterMode() === "array" ? "Returns an ordinary array from this response. Use array methods directly or pass it to ctx.dataset to persist row work. Lazy or incomplete lists throw; use readList for an explicit dataset read. It does not fetch provider pages." : "Returns a PlayDataset, not a JavaScript array. Pass the handle to ctx.dataset, use first(), async iteration, or await handle.materialize() for the complete current list within the memory cap. materialize(n) and peek(n) return a prefix; none fetch additional provider pages. A missing getter is not an empty list."
+        meaning: playToolListGetterMode() === "array" ? "Returns an ordinary array from this response. Use array methods directly or pass it to deepline.dataset to persist row work. Lazy or incomplete lists throw; use readList for an explicit dataset read. It does not fetch provider pages." : "Returns a PlayDataset, not a JavaScript array. Pass the handle to deepline.dataset, use first(), async iteration, or await handle.materialize() for the complete current list within the memory cap. materialize(n) and peek(n) return a prefix; none fetch additional provider pages. A missing getter is not an empty list."
       },
       rawToolResponse: {
         expression: "toolExecutionResult.toolResponse.rawV2",

package/dist/cli/{chunk-F4V4JJED.mjs → chunk-MHG3NND4.mjs}

@@ -11,10 +11,10 @@ import {
   skillsInstallLeasePath,
   skillsSourceUrl,
   syncSdkSkillsIfNeeded
-} from "./chunk-RJLFCJ23.mjs";
+} from "./chunk-IW5QK3K6.mjs";
 import {
   printCommandEnvelope
-} from "./chunk-VC3E5HFO.mjs";
+} from "./chunk-QWJJMQNE.mjs";
 import {
   SDK_VERSION,
   autoDetectBaseUrl,
@@ -22,7 +22,7 @@ import {
   ensureProjectPrivatePathsIgnored,
   resolveProjectPinTarget,
   sdkCliStateDirPath
-} from "./chunk-VYLZS7X4.mjs";
+} from "./chunk-XSERB7H2.mjs";
 
 // src/cli/commands/skills.ts
 import { spawn } from "child_process";