deepline 0.1.119 → 0.1.121

package/dist/compiler-manifest-BjoRENv9.d.mts

@@ -0,0 +1,227 @@
+/**
+ * The runtime shape of a built play artifact. Different runner backends need
+ * different bundle outputs:
+ *   - cjs_node20: Daytona + local-process (full Node.js sandbox).
+ *   - esm_workers: Cloudflare Workers (V8 isolate, no `fs`/`child_process`).
+ *
+ * The CLI selects which kind to build based on the target backend; the worker
+ * validates the kind matches the backend it's about to dispatch to.
+ */
+declare const PLAY_ARTIFACT_KINDS: {
+    readonly cjsNode20: "cjs_node20";
+    readonly esmWorkers: "esm_workers";
+};
+type PlayArtifactKind = (typeof PLAY_ARTIFACT_KINDS)[keyof typeof PLAY_ARTIFACT_KINDS];
+
+/**
+ * A top-level key the play's function literally `return`s. Derived from the
+ * `return { ... }` object literal — NOT from dataset `.withColumn(...)` names —
+ * so the "Returns" graph node mirrors the function's real output shape.
+ * `isDataset` is true when the key's value is a `PlayDataset` handle (a table).
+ */
+interface PlayStaticReturnField {
+    name: string;
+    isDataset: boolean;
+}
+interface PlayStaticPipeline {
+    tableNamespace?: string;
+    inputFields?: string[];
+    rowKeyFields?: string[];
+    csvArg?: string;
+    hasInlineData?: boolean;
+    csvDescription?: string;
+    datasetDescription?: string;
+    fields: string[];
+    /**
+     * Top-level keys of the play's `return { ... }` object literal, in source
+     * order. Undefined when the terminal return isn't a statically-known object
+     * literal (bare value, dataset handle, conditional returns, etc.).
+     */
+    returnFields?: PlayStaticReturnField[];
+    stages?: PlayStaticSubstep[];
+    substeps: PlayStaticSubstep[];
+    sheetContract?: PlaySheetContract | null;
+    sheetContractErrors?: string[];
+}
+type PlaySheetColumnSource = 'input' | 'datasetColumn' | 'waterfallStep' | 'childPlayColumn';
+interface PlaySheetColumnContract {
+    id: string;
+    sqlName: string;
+    source: PlaySheetColumnSource;
+    field?: string;
+    parentField?: string;
+    playId?: string;
+    waterfallId?: string;
+    outputField?: string;
+    outputSqlName?: string;
+    stepId?: string;
+    toolId?: string;
+    isRowKey?: boolean;
+}
+interface PlaySheetContract {
+    tableNamespace: string;
+    columns: PlaySheetColumnContract[];
+}
+type PlayStaticColumnProducerKind = 'tool' | 'waterfall' | 'stepProgram' | 'playCall' | 'controlFlow' | 'transform';
+interface PlayStaticColumnProducer {
+    id: string;
+    kind: PlayStaticColumnProducerKind;
+    field: string;
+    toolId?: string;
+    playId?: string;
+    dependsOnFields?: string[];
+    recompute?: boolean;
+    recomputeOnError?: boolean;
+    staleAfterSeconds?: number;
+    conditional?: boolean;
+    sourceRange?: PlayStaticSourceRange;
+    steps?: PlayStaticColumnProducer[];
+    substep: PlayStaticSubstep;
+}
+interface PlayStaticDatasetColumn {
+    id: string;
+    source: PlaySheetColumnSource;
+    sqlName?: string;
+    recompute?: boolean;
+    recomputeOnError?: boolean;
+    staleAfterSeconds?: number;
+    producers: PlayStaticColumnProducer[];
+}
+interface PlayStaticSourceRange {
+    sourcePath?: string;
+    startLine: number;
+    endLine: number;
+    startColumn: number;
+    endColumn: number;
+}
+type PlayStaticSubstepMetadata = {
+    conditional?: boolean;
+    dependsOnFields?: string[];
+    recompute?: boolean;
+    recomputeOnError?: boolean;
+    staleAfterSeconds?: number;
+};
+type PlayStaticSubstep = PlayStaticSubstepMetadata & ({
+    type: 'csv';
+    field: string;
+    path?: string;
+    description?: string;
+    sourceRange?: PlayStaticSourceRange;
+    callDepth?: number;
+    callPath?: string[];
+} | {
+    type: 'dataset';
+    field: string;
+    name?: string;
+    tableNamespace?: string;
+    inputFields?: string[];
+    rowKeyFields?: string[];
+    outputFields?: string[];
+    columns?: PlayStaticDatasetColumn[];
+    waterfallIds?: string[];
+    steps?: PlayStaticSubstep[];
+    sheetContract?: PlaySheetContract | null;
+    description?: string;
+    sourceRange?: PlayStaticSourceRange;
+    callDepth?: number;
+    callPath?: string[];
+} | {
+    type: 'tool';
+    toolId: string;
+    field: string;
+    paramsSource?: string;
+    sourceText?: string;
+    description?: string;
+    inLoop?: boolean;
+    isEventWait?: boolean;
+    sourceRange?: PlayStaticSourceRange;
+    callDepth?: number;
+    callPath?: string[];
+} | {
+    type: 'waterfall';
+    tool?: string;
+    field: string;
+    inLoop?: boolean;
+    id?: string;
+    output?: string;
+    minResults?: number;
+    sourceText?: string;
+    steps?: Array<{
+        id: string;
+        kind?: 'tool' | 'code';
+        toolId?: string;
+        paramsSource?: string;
+    }>;
+    description?: string;
+    sourceRange?: PlayStaticSourceRange;
+    callDepth?: number;
+    callPath?: string[];
+} | {
+    type: 'step_suite';
+    field: string;
+    steps: PlayStaticSubstep[];
+    returnSource?: string;
+    description?: string;
+    sourceRange?: PlayStaticSourceRange;
+    callDepth?: number;
+    callPath?: string[];
+} | {
+    type: 'play_call';
+    playId: string;
+    field: string;
+    inLoop?: boolean;
+    pipeline?: PlayStaticPipeline | null;
+    cycleDetected?: boolean;
+    resolutionError?: string;
+    description?: string;
+    sourceRange?: PlayStaticSourceRange;
+    callDepth?: number;
+    callPath?: string[];
+} | {
+    type: 'control_flow';
+    kind: 'conditional' | 'loop';
+    field: string;
+    steps: PlayStaticSubstep[];
+    description?: string;
+    sourceRange?: PlayStaticSourceRange;
+    callDepth?: number;
+    callPath?: string[];
+} | {
+    type: 'run_javascript';
+    alias: string;
+    sourceText?: string;
+    description?: string;
+    sourceRange?: PlayStaticSourceRange;
+    callDepth?: number;
+    callPath?: string[];
+} | {
+    type: 'code';
+    field: string;
+    sourceText?: string;
+    description?: string;
+    sourceRange?: PlayStaticSourceRange;
+    callDepth?: number;
+    callPath?: string[];
+});
+
+type PlayCompilerDependencyManifest = {
+    playName: string;
+    /** Original source path for direct imported definePlay dependencies. */
+    filePath?: string;
+    sourceHash: string;
+    graphHash: string;
+    artifactHash: string;
+    staticPipeline: PlayStaticPipeline;
+};
+type PlayCompilerManifest = {
+    compilerVersion: number;
+    playName: string;
+    sourceHash: string;
+    graphHash: string;
+    artifactHash: string;
+    artifactKind?: PlayArtifactKind;
+    staticPipeline: PlayStaticPipeline;
+    importedPlayDependencies: PlayCompilerDependencyManifest[];
+};
+
+export { type PlayArtifactKind as P, type PlayCompilerManifest as a, PLAY_ARTIFACT_KINDS as b };

package/dist/compiler-manifest-BjoRENv9.d.ts

@@ -0,0 +1,227 @@
+/**
+ * The runtime shape of a built play artifact. Different runner backends need
+ * different bundle outputs:
+ *   - cjs_node20: Daytona + local-process (full Node.js sandbox).
+ *   - esm_workers: Cloudflare Workers (V8 isolate, no `fs`/`child_process`).
+ *
+ * The CLI selects which kind to build based on the target backend; the worker
+ * validates the kind matches the backend it's about to dispatch to.
+ */
+declare const PLAY_ARTIFACT_KINDS: {
+    readonly cjsNode20: "cjs_node20";
+    readonly esmWorkers: "esm_workers";
+};
+type PlayArtifactKind = (typeof PLAY_ARTIFACT_KINDS)[keyof typeof PLAY_ARTIFACT_KINDS];
+
+/**
+ * A top-level key the play's function literally `return`s. Derived from the
+ * `return { ... }` object literal — NOT from dataset `.withColumn(...)` names —
+ * so the "Returns" graph node mirrors the function's real output shape.
+ * `isDataset` is true when the key's value is a `PlayDataset` handle (a table).
+ */
+interface PlayStaticReturnField {
+    name: string;
+    isDataset: boolean;
+}
+interface PlayStaticPipeline {
+    tableNamespace?: string;
+    inputFields?: string[];
+    rowKeyFields?: string[];
+    csvArg?: string;
+    hasInlineData?: boolean;
+    csvDescription?: string;
+    datasetDescription?: string;
+    fields: string[];
+    /**
+     * Top-level keys of the play's `return { ... }` object literal, in source
+     * order. Undefined when the terminal return isn't a statically-known object
+     * literal (bare value, dataset handle, conditional returns, etc.).
+     */
+    returnFields?: PlayStaticReturnField[];
+    stages?: PlayStaticSubstep[];
+    substeps: PlayStaticSubstep[];
+    sheetContract?: PlaySheetContract | null;
+    sheetContractErrors?: string[];
+}
+type PlaySheetColumnSource = 'input' | 'datasetColumn' | 'waterfallStep' | 'childPlayColumn';
+interface PlaySheetColumnContract {
+    id: string;
+    sqlName: string;
+    source: PlaySheetColumnSource;
+    field?: string;
+    parentField?: string;
+    playId?: string;
+    waterfallId?: string;
+    outputField?: string;
+    outputSqlName?: string;
+    stepId?: string;
+    toolId?: string;
+    isRowKey?: boolean;
+}
+interface PlaySheetContract {
+    tableNamespace: string;
+    columns: PlaySheetColumnContract[];
+}
+type PlayStaticColumnProducerKind = 'tool' | 'waterfall' | 'stepProgram' | 'playCall' | 'controlFlow' | 'transform';
+interface PlayStaticColumnProducer {
+    id: string;
+    kind: PlayStaticColumnProducerKind;
+    field: string;
+    toolId?: string;
+    playId?: string;
+    dependsOnFields?: string[];
+    recompute?: boolean;
+    recomputeOnError?: boolean;
+    staleAfterSeconds?: number;
+    conditional?: boolean;
+    sourceRange?: PlayStaticSourceRange;
+    steps?: PlayStaticColumnProducer[];
+    substep: PlayStaticSubstep;
+}
+interface PlayStaticDatasetColumn {
+    id: string;
+    source: PlaySheetColumnSource;
+    sqlName?: string;
+    recompute?: boolean;
+    recomputeOnError?: boolean;
+    staleAfterSeconds?: number;
+    producers: PlayStaticColumnProducer[];
+}
+interface PlayStaticSourceRange {
+    sourcePath?: string;
+    startLine: number;
+    endLine: number;
+    startColumn: number;
+    endColumn: number;
+}
+type PlayStaticSubstepMetadata = {
+    conditional?: boolean;
+    dependsOnFields?: string[];
+    recompute?: boolean;
+    recomputeOnError?: boolean;
+    staleAfterSeconds?: number;
+};
+type PlayStaticSubstep = PlayStaticSubstepMetadata & ({
+    type: 'csv';
+    field: string;
+    path?: string;
+    description?: string;
+    sourceRange?: PlayStaticSourceRange;
+    callDepth?: number;
+    callPath?: string[];
+} | {
+    type: 'dataset';
+    field: string;
+    name?: string;
+    tableNamespace?: string;
+    inputFields?: string[];
+    rowKeyFields?: string[];
+    outputFields?: string[];
+    columns?: PlayStaticDatasetColumn[];
+    waterfallIds?: string[];
+    steps?: PlayStaticSubstep[];
+    sheetContract?: PlaySheetContract | null;
+    description?: string;
+    sourceRange?: PlayStaticSourceRange;
+    callDepth?: number;
+    callPath?: string[];
+} | {
+    type: 'tool';
+    toolId: string;
+    field: string;
+    paramsSource?: string;
+    sourceText?: string;
+    description?: string;
+    inLoop?: boolean;
+    isEventWait?: boolean;
+    sourceRange?: PlayStaticSourceRange;
+    callDepth?: number;
+    callPath?: string[];
+} | {
+    type: 'waterfall';
+    tool?: string;
+    field: string;
+    inLoop?: boolean;
+    id?: string;
+    output?: string;
+    minResults?: number;
+    sourceText?: string;
+    steps?: Array<{
+        id: string;
+        kind?: 'tool' | 'code';
+        toolId?: string;
+        paramsSource?: string;
+    }>;
+    description?: string;
+    sourceRange?: PlayStaticSourceRange;
+    callDepth?: number;
+    callPath?: string[];
+} | {
+    type: 'step_suite';
+    field: string;
+    steps: PlayStaticSubstep[];
+    returnSource?: string;
+    description?: string;
+    sourceRange?: PlayStaticSourceRange;
+    callDepth?: number;
+    callPath?: string[];
+} | {
+    type: 'play_call';
+    playId: string;
+    field: string;
+    inLoop?: boolean;
+    pipeline?: PlayStaticPipeline | null;
+    cycleDetected?: boolean;
+    resolutionError?: string;
+    description?: string;
+    sourceRange?: PlayStaticSourceRange;
+    callDepth?: number;
+    callPath?: string[];
+} | {
+    type: 'control_flow';
+    kind: 'conditional' | 'loop';
+    field: string;
+    steps: PlayStaticSubstep[];
+    description?: string;
+    sourceRange?: PlayStaticSourceRange;
+    callDepth?: number;
+    callPath?: string[];
+} | {
+    type: 'run_javascript';
+    alias: string;
+    sourceText?: string;
+    description?: string;
+    sourceRange?: PlayStaticSourceRange;
+    callDepth?: number;
+    callPath?: string[];
+} | {
+    type: 'code';
+    field: string;
+    sourceText?: string;
+    description?: string;
+    sourceRange?: PlayStaticSourceRange;
+    callDepth?: number;
+    callPath?: string[];
+});
+
+type PlayCompilerDependencyManifest = {
+    playName: string;
+    /** Original source path for direct imported definePlay dependencies. */
+    filePath?: string;
+    sourceHash: string;
+    graphHash: string;
+    artifactHash: string;
+    staticPipeline: PlayStaticPipeline;
+};
+type PlayCompilerManifest = {
+    compilerVersion: number;
+    playName: string;
+    sourceHash: string;
+    graphHash: string;
+    artifactHash: string;
+    artifactKind?: PlayArtifactKind;
+    staticPipeline: PlayStaticPipeline;
+    importedPlayDependencies: PlayCompilerDependencyManifest[];
+};
+
+export { type PlayArtifactKind as P, type PlayCompilerManifest as a, PLAY_ARTIFACT_KINDS as b };

package/dist/index.d.mts

@@ -1,228 +1,4 @@
-/**
- * The runtime shape of a built play artifact. Different runner backends need
- * different bundle outputs:
- *   - cjs_node20: Daytona + local-process (full Node.js sandbox).
- *   - esm_workers: Cloudflare Workers (V8 isolate, no `fs`/`child_process`).
- *
- * The CLI selects which kind to build based on the target backend; the worker
- * validates the kind matches the backend it's about to dispatch to.
- */
-declare const PLAY_ARTIFACT_KINDS: {
-    readonly cjsNode20: "cjs_node20";
-    readonly esmWorkers: "esm_workers";
-};
-type PlayArtifactKind = (typeof PLAY_ARTIFACT_KINDS)[keyof typeof PLAY_ARTIFACT_KINDS];
-
-/**
- * A top-level key the play's function literally `return`s. Derived from the
- * `return { ... }` object literal — NOT from dataset `.withColumn(...)` names —
- * so the "Returns" graph node mirrors the function's real output shape.
- * `isDataset` is true when the key's value is a `PlayDataset` handle (a table).
- */
-interface PlayStaticReturnField {
-    name: string;
-    isDataset: boolean;
-}
-interface PlayStaticPipeline {
-    tableNamespace?: string;
-    inputFields?: string[];
-    rowKeyFields?: string[];
-    csvArg?: string;
-    hasInlineData?: boolean;
-    csvDescription?: string;
-    datasetDescription?: string;
-    fields: string[];
-    /**
-     * Top-level keys of the play's `return { ... }` object literal, in source
-     * order. Undefined when the terminal return isn't a statically-known object
-     * literal (bare value, dataset handle, conditional returns, etc.).
-     */
-    returnFields?: PlayStaticReturnField[];
-    stages?: PlayStaticSubstep[];
-    substeps: PlayStaticSubstep[];
-    sheetContract?: PlaySheetContract | null;
-    sheetContractErrors?: string[];
-}
-type PlaySheetColumnSource = 'input' | 'datasetColumn' | 'waterfallStep' | 'childPlayColumn';
-interface PlaySheetColumnContract {
-    id: string;
-    sqlName: string;
-    source: PlaySheetColumnSource;
-    field?: string;
-    parentField?: string;
-    playId?: string;
-    waterfallId?: string;
-    outputField?: string;
-    outputSqlName?: string;
-    stepId?: string;
-    toolId?: string;
-    isRowKey?: boolean;
-}
-interface PlaySheetContract {
-    tableNamespace: string;
-    columns: PlaySheetColumnContract[];
-}
-type PlayStaticColumnProducerKind = 'tool' | 'waterfall' | 'stepProgram' | 'playCall' | 'controlFlow' | 'transform';
-interface PlayStaticColumnProducer {
-    id: string;
-    kind: PlayStaticColumnProducerKind;
-    field: string;
-    toolId?: string;
-    playId?: string;
-    dependsOnFields?: string[];
-    recompute?: boolean;
-    recomputeOnError?: boolean;
-    staleAfterSeconds?: number;
-    conditional?: boolean;
-    sourceRange?: PlayStaticSourceRange;
-    steps?: PlayStaticColumnProducer[];
-    substep: PlayStaticSubstep;
-}
-interface PlayStaticDatasetColumn {
-    id: string;
-    source: PlaySheetColumnSource;
-    sqlName?: string;
-    recompute?: boolean;
-    recomputeOnError?: boolean;
-    staleAfterSeconds?: number;
-    producers: PlayStaticColumnProducer[];
-}
-interface PlayStaticSourceRange {
-    sourcePath?: string;
-    startLine: number;
-    endLine: number;
-    startColumn: number;
-    endColumn: number;
-}
-type PlayStaticSubstepMetadata = {
-    conditional?: boolean;
-    dependsOnFields?: string[];
-    recompute?: boolean;
-    recomputeOnError?: boolean;
-    staleAfterSeconds?: number;
-};
-type PlayStaticSubstep = PlayStaticSubstepMetadata & ({
-    type: 'csv';
-    field: string;
-    path?: string;
-    description?: string;
-    sourceRange?: PlayStaticSourceRange;
-    callDepth?: number;
-    callPath?: string[];
-} | {
-    type: 'dataset';
-    field: string;
-    name?: string;
-    tableNamespace?: string;
-    inputFields?: string[];
-    rowKeyFields?: string[];
-    outputFields?: string[];
-    columns?: PlayStaticDatasetColumn[];
-    waterfallIds?: string[];
-    steps?: PlayStaticSubstep[];
-    sheetContract?: PlaySheetContract | null;
-    description?: string;
-    sourceRange?: PlayStaticSourceRange;
-    callDepth?: number;
-    callPath?: string[];
-} | {
-    type: 'tool';
-    toolId: string;
-    field: string;
-    paramsSource?: string;
-    sourceText?: string;
-    description?: string;
-    inLoop?: boolean;
-    isEventWait?: boolean;
-    sourceRange?: PlayStaticSourceRange;
-    callDepth?: number;
-    callPath?: string[];
-} | {
-    type: 'waterfall';
-    tool?: string;
-    field: string;
-    inLoop?: boolean;
-    id?: string;
-    output?: string;
-    minResults?: number;
-    sourceText?: string;
-    steps?: Array<{
-        id: string;
-        kind?: 'tool' | 'code';
-        toolId?: string;
-        paramsSource?: string;
-    }>;
-    description?: string;
-    sourceRange?: PlayStaticSourceRange;
-    callDepth?: number;
-    callPath?: string[];
-} | {
-    type: 'step_suite';
-    field: string;
-    steps: PlayStaticSubstep[];
-    returnSource?: string;
-    description?: string;
-    sourceRange?: PlayStaticSourceRange;
-    callDepth?: number;
-    callPath?: string[];
-} | {
-    type: 'play_call';
-    playId: string;
-    field: string;
-    inLoop?: boolean;
-    pipeline?: PlayStaticPipeline | null;
-    cycleDetected?: boolean;
-    resolutionError?: string;
-    description?: string;
-    sourceRange?: PlayStaticSourceRange;
-    callDepth?: number;
-    callPath?: string[];
-} | {
-    type: 'control_flow';
-    kind: 'conditional' | 'loop';
-    field: string;
-    steps: PlayStaticSubstep[];
-    description?: string;
-    sourceRange?: PlayStaticSourceRange;
-    callDepth?: number;
-    callPath?: string[];
-} | {
-    type: 'run_javascript';
-    alias: string;
-    sourceText?: string;
-    description?: string;
-    sourceRange?: PlayStaticSourceRange;
-    callDepth?: number;
-    callPath?: string[];
-} | {
-    type: 'code';
-    field: string;
-    sourceText?: string;
-    description?: string;
-    sourceRange?: PlayStaticSourceRange;
-    callDepth?: number;
-    callPath?: string[];
-});
-
-type PlayCompilerDependencyManifest = {
-    playName: string;
-    /** Original source path for direct imported definePlay dependencies. */
-    filePath?: string;
-    sourceHash: string;
-    graphHash: string;
-    artifactHash: string;
-    staticPipeline: PlayStaticPipeline;
-};
-type PlayCompilerManifest = {
-    compilerVersion: number;
-    playName: string;
-    sourceHash: string;
-    graphHash: string;
-    artifactHash: string;
-    artifactKind?: PlayArtifactKind;
-    staticPipeline: PlayStaticPipeline;
-    importedPlayDependencies: PlayCompilerDependencyManifest[];
-};
+import { a as PlayCompilerManifest } from './compiler-manifest-BjoRENv9.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 & {});
@@ -2047,17 +1823,18 @@ declare class DeeplineClient {
      */
     listRuns(options: RunsListOptions): Promise<PlayRunListItem[]>;
     /**
-     * Observe one run's live events through the Convex Run Snapshot
-     * subscription transport (ADR-0008). Yields the same `play.*` event
-     * envelopes as {@link streamPlayRunEvents} and ends after the terminal
-     * snapshot. Throws {@link RunObserveTransportUnavailableError} when this
-     * server cannot serve the transport (older server, unconfigured grants, or
-     * unreachable Convex) — callers fall back to the SSE stream with a notice.
+     * Observe one run's live events. Uses the Convex Run Snapshot subscription
+     * transport first (ADR-0008), then falls back to the canonical SSE stream
+     * when the subscription transport or its optional client modules are not
+     * available. Pass `fallback: 'none'` to receive
+     * {@link RunObserveTransportUnavailableError} instead.
      */
     observeRunEvents(runId: string, options?: {
         signal?: AbortSignal;
         onNotice?: (message: string) => void;
+        fallback?: 'sse' | 'none';
     }): AsyncGenerator<PlayLiveEvent>;
+    private streamPlayRunEventsUntilTerminal;
     /**
      * Tail one run through the subscription transport until terminal, then
      * return one durable REST status read (the final Run Response Package).