deepline 0.3.422 → 0.3.424

package/dist/cli/{chunk-V4RAH5D6.js → chunk-CJD5QKYK.js}

@@ -2,10 +2,10 @@
 
 
 
-var _chunkAYM2KZN3js = require('./chunk-AYM2KZN3.js');
+var _chunkDD6MM6WXjs = require('./chunk-DD6MM6WX.js');
 
 
-var _chunkHCYNAIHZjs = require('./chunk-HCYNAIHZ.js');
+var _chunkQP5ATTMCjs = require('./chunk-QP5ATTMC.js');
 
 // src/cli/commands/git.ts
 function shellQuote(value) {
@@ -32,11 +32,11 @@ function renderDeployment(deployment) {
   return `${deployment.id}  ${source} (${kind}) - ${deployment.status}${suffix}`;
 }
 async function handleList(options) {
-  const { http } = _chunkAYM2KZN3js.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkDD6MM6WXjs.getAuthedHttpClient.call(void 0, );
   const payload = await http.get(
     `/api/v2/play-projects${options.all ? "?includeDisabled=1" : ""}`
   );
-  _chunkAYM2KZN3js.printCommandEnvelope.call(void 0, 
+  _chunkDD6MM6WXjs.printCommandEnvelope.call(void 0, 
     {
       projects: payload.projects,
       count: payload.projects.length,
@@ -73,7 +73,7 @@ function describeInstallationStatus(installation) {
   }
 }
 async function handleStatus(options) {
-  const { http } = _chunkAYM2KZN3js.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkDD6MM6WXjs.getAuthedHttpClient.call(void 0, );
   const payload = await http.get("/api/v2/github/installation");
   const installation = payload.installation;
   const others = (_nullishCoalesce(payload.installations, () => ( []))).filter(
@@ -136,7 +136,7 @@ async function handleStatus(options) {
       )
     );
   }
-  _chunkAYM2KZN3js.printCommandEnvelope.call(void 0, 
+  _chunkDD6MM6WXjs.printCommandEnvelope.call(void 0, 
     {
       installation,
       installations: _nullishCoalesce(payload.installations, () => ( [])),
@@ -147,10 +147,10 @@ async function handleStatus(options) {
   );
 }
 async function handleRepos(options) {
-  const { http } = _chunkAYM2KZN3js.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkDD6MM6WXjs.getAuthedHttpClient.call(void 0, );
   const query = options.installation ? `?installationId=${encodeURIComponent(options.installation)}` : "";
   const payload = await http.get(`/api/v2/github/repos${query}`);
-  _chunkAYM2KZN3js.printCommandEnvelope.call(void 0, 
+  _chunkDD6MM6WXjs.printCommandEnvelope.call(void 0, 
     {
       installation: payload.installation,
       repositories: payload.repositories,
@@ -171,7 +171,7 @@ async function handleRepos(options) {
 }
 async function resolveRepoId(repo, installation) {
   if (/^\d+$/.test(repo)) return Number(repo);
-  const { http } = _chunkAYM2KZN3js.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkDD6MM6WXjs.getAuthedHttpClient.call(void 0, );
   const query = installation ? `?installationId=${encodeURIComponent(installation)}` : "";
   const payload = await http.get(
     `/api/v2/github/repos${query}`
@@ -188,7 +188,7 @@ async function resolveRepoId(repo, installation) {
 }
 async function handleLink(repo, options) {
   const repoId = await resolveRepoId(repo, options.installation);
-  const { http } = _chunkAYM2KZN3js.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkDD6MM6WXjs.getAuthedHttpClient.call(void 0, );
   const payload = await http.post("/api/v2/play-projects", {
     repoId,
     ...options.installation !== void 0 ? { installationId: options.installation } : {},
@@ -197,7 +197,7 @@ async function handleLink(repo, options) {
     ...options.branch !== void 0 ? { productionBranch: options.branch } : {},
     ...options.prChecks !== void 0 ? { checkOnPullRequest: options.prChecks } : {}
   });
-  _chunkAYM2KZN3js.printCommandEnvelope.call(void 0, 
+  _chunkDD6MM6WXjs.printCommandEnvelope.call(void 0, 
     {
       project: payload.project,
       render: {
@@ -220,11 +220,11 @@ async function handleLink(repo, options) {
   );
 }
 async function handleGet(id, options) {
-  const { http } = _chunkAYM2KZN3js.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkDD6MM6WXjs.getAuthedHttpClient.call(void 0, );
   const payload = await http.get(
     `/api/v2/play-projects/${encodeURIComponent(id)}`
   );
-  _chunkAYM2KZN3js.printCommandEnvelope.call(void 0, 
+  _chunkDD6MM6WXjs.printCommandEnvelope.call(void 0, 
     {
       project: payload.project,
       render: {
@@ -240,7 +240,7 @@ async function handleGet(id, options) {
   );
 }
 async function handleSet(id, options) {
-  const { http } = _chunkAYM2KZN3js.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkDD6MM6WXjs.getAuthedHttpClient.call(void 0, );
   const payload = await http.patch(
     `/api/v2/play-projects/${encodeURIComponent(id)}`,
     {
@@ -251,7 +251,7 @@ async function handleSet(id, options) {
       ...options.disabled !== void 0 ? { disabled: options.disabled } : {}
     }
   );
-  _chunkAYM2KZN3js.printCommandEnvelope.call(void 0, 
+  _chunkDD6MM6WXjs.printCommandEnvelope.call(void 0, 
     {
       project: payload.project,
       render: {
@@ -264,9 +264,9 @@ async function handleSet(id, options) {
   );
 }
 async function handleUnlink(id, options) {
-  const { http } = _chunkAYM2KZN3js.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkDD6MM6WXjs.getAuthedHttpClient.call(void 0, );
   await http.delete(`/api/v2/play-projects/${encodeURIComponent(id)}`);
-  _chunkAYM2KZN3js.printCommandEnvelope.call(void 0, 
+  _chunkDD6MM6WXjs.printCommandEnvelope.call(void 0, 
     {
       ok: true,
       id,
@@ -286,10 +286,10 @@ async function handleUnlink(id, options) {
   );
 }
 async function handleConnect(options) {
-  const baseUrl = _chunkHCYNAIHZjs.resolveBaseUrlOnly.call(void 0, );
+  const baseUrl = _chunkQP5ATTMCjs.resolveBaseUrlOnly.call(void 0, );
   const connectUrl = `${baseUrl.replace(/\/$/, "")}/api/v2/github/connect`;
-  const opened = _chunkAYM2KZN3js.openInBrowser.call(void 0, connectUrl);
-  _chunkAYM2KZN3js.printCommandEnvelope.call(void 0, 
+  const opened = _chunkDD6MM6WXjs.openInBrowser.call(void 0, connectUrl);
+  _chunkDD6MM6WXjs.printCommandEnvelope.call(void 0, 
     {
       connectUrl,
       browser: opened,
@@ -311,7 +311,7 @@ async function handleConnect(options) {
   );
 }
 async function handleDeploymentsList(options) {
-  const { http } = _chunkAYM2KZN3js.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkDD6MM6WXjs.getAuthedHttpClient.call(void 0, );
   const query = new URLSearchParams();
   if (options.repo) query.set("projectId", options.repo);
   if (options.limit) query.set("limit", options.limit);
@@ -319,7 +319,7 @@ async function handleDeploymentsList(options) {
   const payload = await http.get(
     `/api/v2/deployments${suffix}`
   );
-  _chunkAYM2KZN3js.printCommandEnvelope.call(void 0, 
+  _chunkDD6MM6WXjs.printCommandEnvelope.call(void 0, 
     {
       deployments: payload.deployments,
       count: payload.deployments.length,
@@ -363,12 +363,12 @@ function renderDeploymentMonitorLines(results) {
   ]);
 }
 async function handleDeploymentGet(id, options) {
-  const { http } = _chunkAYM2KZN3js.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkDD6MM6WXjs.getAuthedHttpClient.call(void 0, );
   const payload = await http.get(`/api/v2/deployments/${encodeURIComponent(id)}`);
   const playLines = renderDeploymentPlayLines(payload.deployment.results);
   const monitorLines = renderDeploymentMonitorLines(payload.deployment.results);
   const repository = _nullishCoalesce(_optionalChain([payload, 'access', _10 => _10.project, 'optionalAccess', _11 => _11.repoFullName]), () => ( payload.deployment.repoFullName));
-  _chunkAYM2KZN3js.printCommandEnvelope.call(void 0, 
+  _chunkDD6MM6WXjs.printCommandEnvelope.call(void 0, 
     {
       deployment: payload.deployment,
       project: payload.project,
@@ -387,9 +387,9 @@ async function handleDeploymentGet(id, options) {
   );
 }
 async function handleDeploymentCancel(id, options) {
-  const { http } = _chunkAYM2KZN3js.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkDD6MM6WXjs.getAuthedHttpClient.call(void 0, );
   const payload = await http.post(`/api/v2/deployments/${encodeURIComponent(id)}/cancel`, {});
-  _chunkAYM2KZN3js.printCommandEnvelope.call(void 0, 
+  _chunkDD6MM6WXjs.printCommandEnvelope.call(void 0, 
     {
       cancelled: payload.cancelled,
       deployment: payload.deployment,

package/dist/cli/{chunk-AYM2KZN3.js → chunk-DD6MM6WX.js}

@@ -3,7 +3,7 @@
 
 
 
-var _chunkHCYNAIHZjs = require('./chunk-HCYNAIHZ.js');
+var _chunkQP5ATTMCjs = require('./chunk-QP5ATTMC.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 = _chunkHCYNAIHZjs.resolveConfig.call(void 0, );
-  return { config, http: new (0, _chunkHCYNAIHZjs.HttpClient)(config) };
+  const config = _chunkQP5ATTMCjs.resolveConfig.call(void 0, );
+  return { config, http: new (0, _chunkQP5ATTMCjs.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: _chunkHCYNAIHZjs.detectAgentRuntime.call(void 0, )
+    agent_runtime: _chunkQP5ATTMCjs.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 _chunkHCYNAIHZjs.detectAgentRuntime.call(void 0, ) !== "unknown" && valueRecord && !Object.prototype.hasOwnProperty.call(valueRecord, "command_context") ? {
+  return _chunkQP5ATTMCjs.detectAgentRuntime.call(void 0, ) !== "unknown" && valueRecord && !Object.prototype.hasOwnProperty.call(valueRecord, "command_context") ? {
     ...valueRecord,
-    command_context: _chunkHCYNAIHZjs.resolveCliCommandContext.call(void 0, )
+    command_context: _chunkQP5ATTMCjs.resolveCliCommandContext.call(void 0, )
   } : value;
 }
 function printJson(value, fields) {

package/dist/cli/{chunk-63ILLN5H.mjs → chunk-DS7Y7X26.mjs}

@@ -3,7 +3,7 @@ import {
   formatModelDescription,
   publicToolSchemas,
   toolMetadataJsonForDescribe
-} from "./chunk-IMZ56EOH.mjs";
+} from "./chunk-LXTSVUZN.mjs";
 import {
   buildPlayDashboardUrl,
   byokLines,
@@ -13,7 +13,7 @@ import {
   examples,
   schemaLines,
   topLevelField
-} from "./chunk-IHG7UAHD.mjs";
+} from "./chunk-MLJBCS3E.mjs";
 import {
   DeeplineError
 } from "./chunk-E4IXDAZI.mjs";

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.
 `