deepline 0.1.188 → 0.1.189

package/dist/bundling-sources/sdk/src/play.ts

@@ -612,7 +612,7 @@ export type CsvOptions = {
  *
  * @example
  * ```typescript
- * definePlay('example', async (ctx, input: { domain: string }) => {
+ * definePlay('example', async (ctx, input: { domain: string; csv: string }) => {
  *   // Call a tool
  *   const company = await ctx.tools.execute({
  *     id: 'company_search',
@@ -633,8 +633,8 @@ export type CsvOptions = {
  *       }))
  *     .run({ description: 'Look up company details.' });
  *
- *   // Load CSV data
- *   const leads = await ctx.csv('leads.csv');
+ *   // Load CSV data from a submitted play input field.
+ *   const leads = await ctx.csv(input.csv);
  *
  *   // Emit a log line (visible in `play tail`)
  *   ctx.log(`Loaded ${await leads.count()} leads`);
@@ -642,8 +642,8 @@ export type CsvOptions = {
  *   // Pause execution
  *   await ctx.sleep(1000);
  *
- *   // Access the raw input object
- *   console.log(ctx.input);
+ *   // Access submitted input through the handler's second argument.
+ *   ctx.log(`Running for ${input.domain}`);
  *
  *   return { company, enriched };
  * });
@@ -656,7 +656,12 @@ export interface DeeplinePlayRuntimeContext {
    * Use this when a play receives a CSV path from the CLI or API and row work
    * should continue through {@link DeeplinePlayRuntimeContext.dataset}. The path is
    * normally an input field such as `input.csv`, populated by
-   * `deepline plays run my.play.ts --csv rows.csv`.
+   * `deepline plays run my.play.ts --csv rows.csv`. Prefer `input.csv` for row
+   * data so the CLI can run strict CSV preflight before starting a run.
+   * Pass-through flags can also target non-reserved field names. If a play
+   * intentionally calls `ctx.csv(input.file)`, use `--input
+   * '{"file":"rows.csv"}'` because `--file` is reserved for the play source
+   * path.
    *
    * Each CSV row becomes an object keyed by canonical column names. Use
    * `options.columns` / `options.rename` to map user headers such as
@@ -903,7 +908,11 @@ export interface DeeplinePlayRuntimeContext {
    */
   sleep(ms: number): Promise<void>;
 
-  /** The raw input object passed when the play was started. */
+  /**
+   * @deprecated Read submitted play input from the handler's second argument:
+   * `definePlay('example', async (ctx, input) => ...)`. This legacy field is
+   * not the supported V2 play input API.
+   */
   readonly input: Record<string, unknown>;
 }
 

package/dist/bundling-sources/sdk/src/release.ts

@@ -105,10 +105,10 @@ export const SDK_RELEASE = {
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
-  version: '0.1.188',
+  version: '0.1.189',
   apiContract: '2026-06-dataset-handle-results-hard-cutover',
   supportPolicy: {
-    latest: '0.1.188',
+    latest: '0.1.189',
     minimumSupported: '0.1.53',
     deprecatedBelow: '0.1.53',
     commandMinimumSupported: [

package/dist/bundling-sources/shared_libs/plays/static-pipeline.ts

@@ -510,6 +510,7 @@ export type PlayStaticControlFlowBranch = {
   label: string;
   /** The arm's condition source text, when it has one (omitted for `else`). */
   condition?: string;
+  /** Static work in this arm. Empty for log/throw/return-only arms. */
   steps: PlayStaticSubstep[];
 };
 

package/dist/cli/index.js

@@ -623,10 +623,10 @@ var SDK_RELEASE = {
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
-  version: "0.1.188",
+  version: "0.1.189",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.188",
+    latest: "0.1.189",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [

package/dist/cli/index.mjs

@@ -608,10 +608,10 @@ var SDK_RELEASE = {
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
-  version: "0.1.188",
+  version: "0.1.189",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.188",
+    latest: "0.1.189",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [

package/dist/{compiler-manifest-OwORQ07f.d.mts → compiler-manifest-j6z8qzpd.d.mts}

@@ -111,6 +111,7 @@ type PlayStaticControlFlowBranch = {
     label: string;
     /** The arm's condition source text, when it has one (omitted for `else`). */
     condition?: string;
+    /** Static work in this arm. Empty for log/throw/return-only arms. */
     steps: PlayStaticSubstep[];
 };
 type PlayStaticSubstep = PlayStaticSubstepMetadata & ({

package/dist/{compiler-manifest-OwORQ07f.d.ts → compiler-manifest-j6z8qzpd.d.ts}

@@ -111,6 +111,7 @@ type PlayStaticControlFlowBranch = {
     label: string;
     /** The arm's condition source text, when it has one (omitted for `else`). */
     condition?: string;
+    /** Static work in this arm. Empty for log/throw/return-only arms. */
     steps: PlayStaticSubstep[];
 };
 type PlayStaticSubstep = PlayStaticSubstepMetadata & ({

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { a as PlayCompilerManifest } from './compiler-manifest-OwORQ07f.mjs';
+import { a as PlayCompilerManifest } from './compiler-manifest-j6z8qzpd.mjs';
 
 declare const DEEPLINE_TOOL_CATEGORIES: readonly ["company_search", "people_search", "people_enrich", "email_finder", "email_verify", "phone_finder", "phone_verify", "identity_resolution", "reverse_lookup", "enrichment", "batch", "premium", "free"];
 type DeeplineToolCategory = (typeof DEEPLINE_TOOL_CATEGORIES)[number] | (string & {});
@@ -3313,7 +3313,7 @@ type CsvOptions = {
  *
  * @example
  * ```typescript
- * definePlay('example', async (ctx, input: { domain: string }) => {
+ * definePlay('example', async (ctx, input: { domain: string; csv: string }) => {
  *   // Call a tool
  *   const company = await ctx.tools.execute({
  *     id: 'company_search',
@@ -3334,8 +3334,8 @@ type CsvOptions = {
  *       }))
  *     .run({ description: 'Look up company details.' });
  *
- *   // Load CSV data
- *   const leads = await ctx.csv('leads.csv');
+ *   // Load CSV data from a submitted play input field.
+ *   const leads = await ctx.csv(input.csv);
  *
  *   // Emit a log line (visible in `play tail`)
  *   ctx.log(`Loaded ${await leads.count()} leads`);
@@ -3343,8 +3343,8 @@ type CsvOptions = {
  *   // Pause execution
  *   await ctx.sleep(1000);
  *
- *   // Access the raw input object
- *   console.log(ctx.input);
+ *   // Access submitted input through the handler's second argument.
+ *   ctx.log(`Running for ${input.domain}`);
  *
  *   return { company, enriched };
  * });
@@ -3357,7 +3357,12 @@ interface DeeplinePlayRuntimeContext {
      * Use this when a play receives a CSV path from the CLI or API and row work
      * should continue through {@link DeeplinePlayRuntimeContext.dataset}. The path is
      * normally an input field such as `input.csv`, populated by
-     * `deepline plays run my.play.ts --csv rows.csv`.
+     * `deepline plays run my.play.ts --csv rows.csv`. Prefer `input.csv` for row
+     * data so the CLI can run strict CSV preflight before starting a run.
+     * Pass-through flags can also target non-reserved field names. If a play
+     * intentionally calls `ctx.csv(input.file)`, use `--input
+     * '{"file":"rows.csv"}'` because `--file` is reserved for the play source
+     * path.
      *
      * Each CSV row becomes an object keyed by canonical column names. Use
      * `options.columns` / `options.rename` to map user headers such as
@@ -3570,7 +3575,11 @@ interface DeeplinePlayRuntimeContext {
      * @param ms - Duration in milliseconds
      */
     sleep(ms: number): Promise<void>;
-    /** The raw input object passed when the play was started. */
+    /**
+     * @deprecated Read submitted play input from the handler's second argument:
+     * `definePlay('example', async (ctx, input) => ...)`. This legacy field is
+     * not the supported V2 play input API.
+     */
     readonly input: Record<string, unknown>;
 }
 /**

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { a as PlayCompilerManifest } from './compiler-manifest-OwORQ07f.js';
+import { a as PlayCompilerManifest } from './compiler-manifest-j6z8qzpd.js';
 
 declare const DEEPLINE_TOOL_CATEGORIES: readonly ["company_search", "people_search", "people_enrich", "email_finder", "email_verify", "phone_finder", "phone_verify", "identity_resolution", "reverse_lookup", "enrichment", "batch", "premium", "free"];
 type DeeplineToolCategory = (typeof DEEPLINE_TOOL_CATEGORIES)[number] | (string & {});
@@ -3313,7 +3313,7 @@ type CsvOptions = {
  *
  * @example
  * ```typescript
- * definePlay('example', async (ctx, input: { domain: string }) => {
+ * definePlay('example', async (ctx, input: { domain: string; csv: string }) => {
  *   // Call a tool
  *   const company = await ctx.tools.execute({
  *     id: 'company_search',
@@ -3334,8 +3334,8 @@ type CsvOptions = {
  *       }))
  *     .run({ description: 'Look up company details.' });
  *
- *   // Load CSV data
- *   const leads = await ctx.csv('leads.csv');
+ *   // Load CSV data from a submitted play input field.
+ *   const leads = await ctx.csv(input.csv);
  *
  *   // Emit a log line (visible in `play tail`)
  *   ctx.log(`Loaded ${await leads.count()} leads`);
@@ -3343,8 +3343,8 @@ type CsvOptions = {
  *   // Pause execution
  *   await ctx.sleep(1000);
  *
- *   // Access the raw input object
- *   console.log(ctx.input);
+ *   // Access submitted input through the handler's second argument.
+ *   ctx.log(`Running for ${input.domain}`);
  *
  *   return { company, enriched };
  * });
@@ -3357,7 +3357,12 @@ interface DeeplinePlayRuntimeContext {
      * Use this when a play receives a CSV path from the CLI or API and row work
      * should continue through {@link DeeplinePlayRuntimeContext.dataset}. The path is
      * normally an input field such as `input.csv`, populated by
-     * `deepline plays run my.play.ts --csv rows.csv`.
+     * `deepline plays run my.play.ts --csv rows.csv`. Prefer `input.csv` for row
+     * data so the CLI can run strict CSV preflight before starting a run.
+     * Pass-through flags can also target non-reserved field names. If a play
+     * intentionally calls `ctx.csv(input.file)`, use `--input
+     * '{"file":"rows.csv"}'` because `--file` is reserved for the play source
+     * path.
      *
      * Each CSV row becomes an object keyed by canonical column names. Use
      * `options.columns` / `options.rename` to map user headers such as
@@ -3570,7 +3575,11 @@ interface DeeplinePlayRuntimeContext {
      * @param ms - Duration in milliseconds
      */
     sleep(ms: number): Promise<void>;
-    /** The raw input object passed when the play was started. */
+    /**
+     * @deprecated Read submitted play input from the handler's second argument:
+     * `definePlay('example', async (ctx, input) => ...)`. This legacy field is
+     * not the supported V2 play input API.
+     */
     readonly input: Record<string, unknown>;
 }
 /**

package/dist/index.js

@@ -422,10 +422,10 @@ var SDK_RELEASE = {
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
-  version: "0.1.188",
+  version: "0.1.189",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.188",
+    latest: "0.1.189",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [

package/dist/index.mjs

@@ -352,10 +352,10 @@ var SDK_RELEASE = {
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
-  version: "0.1.188",
+  version: "0.1.189",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.188",
+    latest: "0.1.189",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [

package/dist/plays/bundle-play-file.d.mts

@@ -1,5 +1,5 @@
-import { P as PlayArtifactKind$1, a as PlayCompilerManifest } from '../compiler-manifest-OwORQ07f.mjs';
-export { b as PLAY_ARTIFACT_KINDS } from '../compiler-manifest-OwORQ07f.mjs';
+import { P as PlayArtifactKind$1, a as PlayCompilerManifest } from '../compiler-manifest-j6z8qzpd.mjs';
+export { b as PLAY_ARTIFACT_KINDS } from '../compiler-manifest-j6z8qzpd.mjs';
 
 type PlayPackageImport = {
     name: string;

package/dist/plays/bundle-play-file.d.ts

@@ -1,5 +1,5 @@
-import { P as PlayArtifactKind$1, a as PlayCompilerManifest } from '../compiler-manifest-OwORQ07f.js';
-export { b as PLAY_ARTIFACT_KINDS } from '../compiler-manifest-OwORQ07f.js';
+import { P as PlayArtifactKind$1, a as PlayCompilerManifest } from '../compiler-manifest-j6z8qzpd.js';
+export { b as PLAY_ARTIFACT_KINDS } from '../compiler-manifest-j6z8qzpd.js';
 
 type PlayPackageImport = {
     name: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.1.188",
+  "version": "0.1.189",
   "description": "Deepline SDK + CLI — B2B data enrichment powered by durable cloud execution",
   "license": "MIT",
   "repository": {