deepline 0.1.91 → 0.1.94

package/dist/index.d.mts

@@ -717,12 +717,19 @@ type PlayLiveEvent = LiveEventEnvelope<unknown> & {
  * Result returned by {@link DeeplineClient.stopPlay}.
  */
 interface StopPlayRunResult {
-    /** Public play-run identifier that was stopped. */
+    /** Public play-run identifier the stop request targeted. */
     runId: string;
-    /** Stop request acknowledgement. */
-    stopped: true;
+    /** Whether the server confirmed the run was stopped. */
+    stopped: boolean;
     /** Number of open HITL interactions marked cancelled. */
     hitlCancelledCount: number;
+    /**
+     * True when the scheduler state for the run was stale and the stop could
+     * not be confirmed. Absent on older servers (treated as confirmed).
+     */
+    staleSchedulerState?: boolean;
+    /** Server-side error detail when the stop was not confirmed. */
+    error?: string;
 }
 /**
  * Summary of a single play run, returned by {@link DeeplineClient.listPlayRuns}.
@@ -1187,6 +1194,10 @@ type EnrichStepCommand = {
     alias: string;
     tool: string;
     operation?: string;
+    play?: {
+        ref: string;
+        mode?: 'scalar';
+    };
     payload: Record<string, unknown>;
     extract_js?: string;
     run_if_js?: string;
@@ -1251,10 +1262,28 @@ type RunsListOptions = {
 /** Streaming options for `client.runs.tail(...)`. */
 type RunsTailOptions = {
     signal?: AbortSignal;
+    /**
+     * Called before each stream reconnect. Server stream windows are finite, so
+     * long runs reconnect with backoff until a terminal status is observed.
+     */
+    onReconnect?: (info: {
+        attempt: number;
+        delayMs: number;
+        reason: string;
+    }) => void;
+    /**
+     * Display-only transport notices: subscription-transport reconnects,
+     * staleness warnings, and the one-time fallback notice when the server
+     * cannot serve the Convex subscription transport (ADR-0008).
+     */
+    onNotice?: (message: string) => void;
 };
 /** Log fetch options for `client.runs.logs(...)`. */
 type RunsLogsOptions = {
+    /** Return the LAST `limit` stored log lines (default 200). */
     limit?: number;
+    /** Fetch every stored log line, paginating to the full totalCount. */
+    all?: boolean;
 };
 /** Persisted log response for one play run. */
 type RunsLogsResult = {
@@ -1266,6 +1295,11 @@ type RunsLogsResult = {
     truncated: boolean;
     hasMore: boolean;
     entries: string[];
+    /**
+     * True when the run crossed the Run Log Stream retention cap: `totalCount`
+     * keeps counting, but stored line bodies end at a loud truncation marker.
+     */
+    logsTruncated?: boolean;
 };
 /** One persisted runtime-sheet row returned by `client.runs.exportDatasetRows(...)`. */
 type PlaySheetRow = {
@@ -1608,6 +1642,7 @@ declare class DeeplineClient {
     compileEnrichPlan(input: {
         plan_args?: string[];
         config?: unknown;
+        native_play_materialization?: 'macro' | 'inline_prebuilt';
     }): Promise<{
         config: EnrichCompiledConfig;
     }>;
@@ -1782,6 +1817,56 @@ declare class DeeplineClient {
      * ```
      */
     listPlayRuns(playName: string): Promise<PlayRunListItem[]>;
+    /** List the org's workflows. `GET /api/v2/workflows`. */
+    listWorkflows(options?: {
+        limit?: number;
+    }): Promise<{
+        workflows: Array<{
+            id: string;
+            name: string;
+            status: string;
+            current_published_version: number | null;
+        }>;
+    }>;
+    /**
+     * Fetch a single workflow (including its published-revision config — the
+     * input to `compileWorkflowConfigToPlay`). `GET /api/v2/workflows/:id`.
+     */
+    getWorkflow(id: string): Promise<{
+        workflow: {
+            id: string;
+            name: string;
+            status: string;
+            current_published_version: number | null;
+            current_published_revision: {
+                version: number;
+                config: unknown;
+            } | null;
+        } | null;
+        validation?: unknown;
+    }>;
+    /** Delete a workflow. `DELETE /api/v2/workflows/:id`. */
+    deleteWorkflow(id: string): Promise<unknown>;
+    /** Turn a workflow off. `POST /api/v2/workflows/:id/disable`. */
+    disableWorkflow(id: string): Promise<unknown>;
+    /** Turn a workflow back on. `POST /api/v2/workflows/:id/enable`. */
+    enableWorkflow(id: string): Promise<unknown>;
+    /** Create/update a workflow from config. `POST /api/v2/workflows/apply`. */
+    applyWorkflow(body: Record<string, unknown>): Promise<unknown>;
+    /** Validate a workflow config without saving. `POST /api/v2/workflows/lint`. */
+    lintWorkflow(body: Record<string, unknown>): Promise<unknown>;
+    /** Fetch live workflow request schemas. `GET /api/v2/workflows/schema`. */
+    getWorkflowSchema(subject?: string): Promise<unknown>;
+    /** Queue a workflow run. `POST /api/v2/workflows/call`. */
+    callWorkflow(body: Record<string, unknown>): Promise<unknown>;
+    /** List a workflow's runs. `GET /api/v2/workflows/:id/runs`. */
+    listWorkflowRuns(id: string, options?: {
+        limit?: number;
+    }): Promise<unknown>;
+    /** Fetch one workflow run. `GET /api/v2/workflows/:id/runs/:runId`. */
+    getWorkflowRun(id: string, runId: string): Promise<unknown>;
+    /** Cancel a workflow run. `POST /api/v2/workflows/:id/runs/:runId/cancel`. */
+    cancelWorkflowRun(id: string, runId: string): Promise<unknown>;
     /**
      * Get a run by id using the public runs resource model.
      *
@@ -1804,7 +1889,37 @@ declare class DeeplineClient {
      * ```
      */
     listRuns(options: RunsListOptions): Promise<PlayRunListItem[]>;
-    /** Read the canonical run stream and return the latest run snapshot. */
+    /**
+     * 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.
+     */
+    observeRunEvents(runId: string, options?: {
+        signal?: AbortSignal;
+        onNotice?: (message: string) => void;
+    }): AsyncGenerator<PlayLiveEvent>;
+    /**
+     * Tail one run through the subscription transport until terminal, then
+     * return one durable REST status read (the final Run Response Package).
+     */
+    private tailRunViaObserveTransport;
+    /**
+     * Read the canonical run stream until a terminal run status is observed.
+     *
+     * Tries the Convex Run Snapshot subscription transport first (ADR-0008);
+     * when the server cannot serve it (grant endpoint missing/unconfigured or
+     * Convex unreachable) it falls back — with one `onNotice` message — to the
+     * support-window SSE stream below.
+     *
+     * Server stream windows are finite: they end cleanly at the function
+     * ceiling even while the run keeps executing. A window that ends (cleanly
+     * or via transient network error) without a terminal event triggers one
+     * durable-status re-check followed by a backed-off reconnect, so long runs
+     * tail to completion. Abort via `options.signal` to stop waiting.
+     */
     tailRun(runId: string, options?: RunsTailOptions): Promise<PlayStatus>;
     /**
      * Fetch persisted logs for a run using the public runs resource model.
@@ -2034,6 +2149,15 @@ declare class DeeplineClient {
     }>;
 }
 
+/**
+ * Bootstrap failure: this server/deployment cannot serve the subscription
+ * transport. Callers fall back to the support-window SSE stream (ADR-0008).
+ */
+declare class RunObserveTransportUnavailableError extends Error {
+    readonly reason: string;
+    constructor(message: string, reason: string);
+}
+
 declare const SDK_VERSION: string;
 declare const SDK_API_CONTRACT: string;
 
@@ -2157,107 +2281,6 @@ declare const PROD_URL = "https://code.deepline.com";
  */
 declare function resolveConfig(options?: DeeplineClientOptions): ResolvedConfig;
 
-interface PlayR2FileRef {
-    storageKind: 'r2';
-    storageKey: string;
-    logicalPath: string;
-    fileName: string;
-    contentHash: string;
-    contentType: string;
-    bytes: number;
-}
-type PlayExecutionFileRef = PlayR2FileRef;
-
-declare const PLAY_DATASET_BRAND: unique symbol;
-type PlayDatasetKind = 'csv' | 'map';
-type PlayDatasetBacking = {
-    storage: 'neon_sheet';
-    sheet: {
-        playName: string;
-        tableNamespace: string;
-    };
-} | {
-    storage: 'r2_file';
-    file: PlayExecutionFileRef;
-};
-type PlayDatasetWorkProgressSummary = {
-    total: number;
-    executed: number;
-    reused: number;
-    skipped: number;
-    pending: number;
-    failed: number;
-    degraded?: boolean;
-    duplicates?: {
-        exact?: number;
-        semantic?: number;
-        rejected?: number;
-    };
-};
-type PlayDatasetInput<T> = ReadonlyArray<T> | Iterable<T> | AsyncIterable<T> | PlayDataset<T>;
-type PlayDatasetTransformOptions = {
-    key?: string;
-    sourceLabel?: string | null;
-};
-/**
- * Durable handle for rows produced by `ctx.csv(...)` or `ctx.dataset(...).run()`.
- *
- * A `PlayDataset` is not a normal in-memory array. It points at runtime-managed
- * rows, usually backed by persisted sheet storage, and carries metadata such as
- * dataset kind, dataset id, table namespace, count, and preview rows.
- *
- * Pass dataset handles directly into later `ctx.dataset(...)` stages by default so
- * Deepline keeps row progress, retries, memory use, and table output under
- * runtime control. Use `count()` and `peek()` for bounded inspection. Use
- * `materialize(limit)` or async iteration only when the dataset is intentionally
- * small and bounded. `PlayDataset` intentionally does not expose `.rows`,
- * `.toArray()`, or other array aliases; those hide the runtime cost of loading
- * persisted rows into memory.
- *
- * @sdkReference runtime 190
- */
-interface PlayDataset<T> extends AsyncIterable<T> {
-    readonly [PLAY_DATASET_BRAND]: true;
-    /** Dataset kind. */
-    readonly datasetKind: PlayDatasetKind;
-    /** Dataset id. */
-    readonly datasetId: string;
-    /** Backing store info. */
-    readonly backing?: PlayDatasetBacking;
-    /** Display label. */
-    readonly sourceLabel?: string | null;
-    /** Runtime table name. */
-    readonly tableNamespace?: string | null;
-    /** Row count. */
-    count(): Promise<number>;
-    /** Preview rows. */
-    peek(limit?: number): Promise<T[]>;
-    map<U>(mapper: (row: T, index: number) => U | Promise<U>, options?: PlayDatasetTransformOptions): PlayDataset<U>;
-    filter(predicate: (row: T, index: number) => boolean | Promise<boolean>, options?: PlayDatasetTransformOptions): PlayDataset<T>;
-    slice(start?: number, end?: number, options?: PlayDatasetTransformOptions): PlayDataset<T>;
-    take(limit: number, options?: PlayDatasetTransformOptions): PlayDataset<T>;
-    /**
-     * Explicit escape hatch for bounded result sets.
-     * Large datasets should flow by handle through Neon-backed storage, not
-     * through worker memory as giant arrays.
-     */
-    materialize(limit?: number): Promise<T[]>;
-    toJSON(): {
-        kind: 'dataset';
-        datasetKind: PlayDatasetKind;
-        datasetId: string;
-        count: number;
-        backing?: PlayDatasetBacking;
-        sourceLabel?: string | null;
-        tableNamespace?: string | null;
-        columns?: string[];
-        _metadata?: {
-            workProgress?: PlayDatasetWorkProgressSummary;
-        };
-        preview: T[];
-    };
-}
-
 type EmailStatusVerdict = 'send' | 'send_with_caution' | 'verify_next' | 'hold' | 'drop';
 type EmailStatusValue = 'valid' | 'invalid' | 'catch_all' | 'valid_catch_all' | 'unknown' | 'do_not_mail' | 'spamtrap' | 'abuse' | 'disposable';
 type EmailDeliverability = 'high' | 'medium' | 'low' | 'unknown';
@@ -2434,7 +2457,7 @@ declare const DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS: {
 };
 type DeeplineExtractorTarget = keyof typeof DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS;
 declare const DEEPLINE_EXTRACTOR_TARGETS: DeeplineExtractorTarget[];
-type DeeplineEmailStatusGetterValue = EmailStatus | EmailStatusValue;
+type DeeplineEmailStatusGetterValue = EmailStatus;
 type DeeplineGetterValueMap = {
     id: string;
     name: string;
@@ -2459,7 +2482,7 @@ type DeeplineGetterValueMap = {
     status: string;
     job_change: JobChangeGetterValue;
     job_change_status: JobChangeStatus;
-    email_status: DeeplineEmailStatusGetterValue;
+    email_status: EmailStatus;
     phone_status: PhoneStatus;
 };
 type DeeplineGetterValue<TTarget extends DeeplineExtractorTarget = DeeplineExtractorTarget> = DeeplineGetterValueMap[TTarget];
@@ -2553,6 +2576,107 @@ type ToolExecuteResultAccessors<TExtracted extends Record<string, unknown> = Par
  */
 type ToolExecuteResult<TResult = unknown, TMeta = Record<string, unknown>, TExtracted extends Record<string, unknown> = Partial<DeeplineGetterValueMap>, TLists extends Record<string, Record<string, unknown>> = Record<string, Record<string, unknown>>> = ToolExecuteResultBase<TResult, TMeta> & ToolExecuteResultAccessors<TExtracted, TLists>;
 
+interface PlayR2FileRef {
+    storageKind: 'r2';
+    storageKey: string;
+    logicalPath: string;
+    fileName: string;
+    contentHash: string;
+    contentType: string;
+    bytes: number;
+}
+type PlayExecutionFileRef = PlayR2FileRef;
+
+declare const PLAY_DATASET_BRAND: unique symbol;
+type PlayDatasetKind = 'csv' | 'map';
+type PlayDatasetBacking = {
+    storage: 'neon_sheet';
+    sheet: {
+        playName: string;
+        tableNamespace: string;
+    };
+} | {
+    storage: 'r2_file';
+    file: PlayExecutionFileRef;
+};
+type PlayDatasetWorkProgressSummary = {
+    total: number;
+    executed: number;
+    reused: number;
+    skipped: number;
+    pending: number;
+    failed: number;
+    degraded?: boolean;
+    duplicates?: {
+        exact?: number;
+        semantic?: number;
+        rejected?: number;
+    };
+};
+type PlayDatasetInput<T> = ReadonlyArray<T> | Iterable<T> | AsyncIterable<T> | PlayDataset<T>;
+type PlayDatasetTransformOptions = {
+    key?: string;
+    sourceLabel?: string | null;
+};
+/**
+ * Durable handle for rows produced by `ctx.csv(...)` or `ctx.dataset(...).run()`.
+ *
+ * A `PlayDataset` is not a normal in-memory array. It points at runtime-managed
+ * rows, usually backed by persisted sheet storage, and carries metadata such as
+ * dataset kind, dataset id, table namespace, count, and preview rows.
+ *
+ * Pass dataset handles directly into later `ctx.dataset(...)` stages by default so
+ * Deepline keeps row progress, retries, memory use, and table output under
+ * runtime control. Use `count()` and `peek()` for bounded inspection. Use
+ * `materialize(limit)` or async iteration only when the dataset is intentionally
+ * small and bounded. `PlayDataset` intentionally does not expose `.rows`,
+ * `.toArray()`, or other array aliases; those hide the runtime cost of loading
+ * persisted rows into memory.
+ *
+ * @sdkReference runtime 190
+ */
+interface PlayDataset<T> extends AsyncIterable<T> {
+    readonly [PLAY_DATASET_BRAND]: true;
+    /** Dataset kind. */
+    readonly datasetKind: PlayDatasetKind;
+    /** Dataset id. */
+    readonly datasetId: string;
+    /** Backing store info. */
+    readonly backing?: PlayDatasetBacking;
+    /** Display label. */
+    readonly sourceLabel?: string | null;
+    /** Runtime table name. */
+    readonly tableNamespace?: string | null;
+    /** Row count. */
+    count(): Promise<number>;
+    /** Preview rows. */
+    peek(limit?: number): Promise<T[]>;
+    map<U>(mapper: (row: T, index: number) => U | Promise<U>, options?: PlayDatasetTransformOptions): PlayDataset<U>;
+    filter(predicate: (row: T, index: number) => boolean | Promise<boolean>, options?: PlayDatasetTransformOptions): PlayDataset<T>;
+    slice(start?: number, end?: number, options?: PlayDatasetTransformOptions): PlayDataset<T>;
+    take(limit: number, options?: PlayDatasetTransformOptions): PlayDataset<T>;
+    /**
+     * Explicit escape hatch for bounded result sets.
+     * Large datasets should flow by handle through Neon-backed storage, not
+     * through worker memory as giant arrays.
+     */
+    materialize(limit?: number): Promise<T[]>;
+    toJSON(): {
+        kind: 'dataset';
+        datasetKind: PlayDatasetKind;
+        datasetId: string;
+        count: number;
+        backing?: PlayDatasetBacking;
+        sourceLabel?: string | null;
+        tableNamespace?: string | null;
+        columns?: string[];
+        _metadata?: {
+            workProgress?: PlayDatasetWorkProgressSummary;
+        };
+        preview: T[];
+    };
+}
+
 /**
  * Previous durable cell value passed to object-column resolvers.
  *
@@ -3791,4 +3915,4 @@ declare function writeCsvOutputFile(rows: Array<Record<string, unknown>>, stem:
  */
 declare function extractSummaryFields(payload: unknown): Record<string, Scalar>;
 
-export { AuthError, type ClearPlayHistoryRequest, type ClearPlayHistoryResult, type ColumnMap, type ColumnResolver, type ConditionalStepResolver, ConfigError, type CsvInput, type CsvOptions, type CustomerDbQueryResult, DEEPLINE_EXTRACTOR_TARGETS, DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, DEEPLINE_TOOL_CATEGORIES, type DatasetBuilder, type DatasetColumnDefinition, type DatasetColumnRunInput, Deepline, DeeplineClient, type DeeplineClientOptions, DeeplineContext, type DeeplineEmailStatusGetterValue, DeeplineError, type DeeplineExtractorTarget, type DeeplineGetterValue, type DeeplineGetterValueMap, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCategory, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, type FileInput, JOB_CHANGE_STATUS_VALUES, type JobChangeStatus, type LiveEventEnvelope, PHONE_STATUS_VALUES, PLAY_BOOTSTRAP_COMPANY_FIELDS, PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_CONTACT_FIELDS, PLAY_BOOTSTRAP_FINDER_KINDS, PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER, PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER, PLAY_BOOTSTRAP_SOURCE_KINDS, PLAY_BOOTSTRAP_STAGE_KINDS, PLAY_BOOTSTRAP_TEMPLATES, PROD_URL, type PhoneStatus, type PlayBindings, type PlayBootstrapEntityKind, type PlayBootstrapFinderKind, type PlayDataset, type PlayDatasetInput, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayRevisionSummary, type PlayRunResult, type PlayRunStart, type PlaySheetRow, type PlaySheetRowsResult, type PlayStatus, type PlayStepProgramStep, type PrebuiltPlayRef, type PreviousCell, type PublishPlayVersionRequest, type PublishPlayVersionResult, RateLimitError, type ResolvedConfig, type RunsListOptions, type RunsLogsOptions, type RunsLogsResult, type RunsNamespace, type RunsTailOptions, SDK_API_CONTRACT, SDK_VERSION, type StaleAfterSeconds, type StartPlayRunRequest, type StepOptions, type StepProgram, type StepProgramResolver, type StepResolver, type StopPlayRunResult, type ToolDefinition, type ToolExecuteResult, type ToolExecution, type ToolExecutionRequest, type ToolMetadata, type ToolSearchOptions, type ToolSearchResult, defineInput, definePlay, defineWorkflow, extractSummaryFields, formatPlayBootstrapFinderKinds, formatPlayBootstrapFinderKindsForSentence, formatPlayBootstrapTemplates, getDefinedPlayMetadata, isDeeplineExtractorTarget, isPlayBootstrapFinderKind, isPlayBootstrapTemplate, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };
+export { AuthError, type ClearPlayHistoryRequest, type ClearPlayHistoryResult, type ColumnMap, type ColumnResolver, type ConditionalStepResolver, ConfigError, type CsvInput, type CsvOptions, type CustomerDbQueryResult, DEEPLINE_EXTRACTOR_TARGETS, DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, DEEPLINE_TOOL_CATEGORIES, type DatasetBuilder, type DatasetColumnDefinition, type DatasetColumnRunInput, Deepline, DeeplineClient, type DeeplineClientOptions, DeeplineContext, type DeeplineEmailStatusGetterValue, DeeplineError, type DeeplineExtractorTarget, type DeeplineGetterValue, type DeeplineGetterValueMap, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCategory, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, type FileInput, JOB_CHANGE_STATUS_VALUES, type JobChangeStatus, type LiveEventEnvelope, PHONE_STATUS_VALUES, PLAY_BOOTSTRAP_COMPANY_FIELDS, PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_CONTACT_FIELDS, PLAY_BOOTSTRAP_FINDER_KINDS, PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER, PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER, PLAY_BOOTSTRAP_SOURCE_KINDS, PLAY_BOOTSTRAP_STAGE_KINDS, PLAY_BOOTSTRAP_TEMPLATES, PROD_URL, type PhoneStatus, type PlayBindings, type PlayBootstrapEntityKind, type PlayBootstrapFinderKind, type PlayDataset, type PlayDatasetInput, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayRevisionSummary, type PlayRunResult, type PlayRunStart, type PlaySheetRow, type PlaySheetRowsResult, type PlayStatus, type PlayStepProgramStep, type PrebuiltPlayRef, type PreviousCell, type PublishPlayVersionRequest, type PublishPlayVersionResult, RateLimitError, type ResolvedConfig, RunObserveTransportUnavailableError, type RunsListOptions, type RunsLogsOptions, type RunsLogsResult, type RunsNamespace, type RunsTailOptions, SDK_API_CONTRACT, SDK_VERSION, type StaleAfterSeconds, type StartPlayRunRequest, type StepOptions, type StepProgram, type StepProgramResolver, type StepResolver, type StopPlayRunResult, type ToolDefinition, type ToolExecuteResult, type ToolExecution, type ToolExecutionRequest, type ToolMetadata, type ToolSearchOptions, type ToolSearchResult, defineInput, definePlay, defineWorkflow, extractSummaryFields, formatPlayBootstrapFinderKinds, formatPlayBootstrapFinderKindsForSentence, formatPlayBootstrapTemplates, getDefinedPlayMetadata, isDeeplineExtractorTarget, isPlayBootstrapFinderKind, isPlayBootstrapTemplate, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };