deepline 0.3.422 → 0.3.423

package/dist/{compiler-manifest-lzWpbV3w.d.ts → compiler-manifest-DaFuA1ki.d.ts}

@@ -582,13 +582,13 @@ type PlayDatasetTransformOptions = {
     sourceLabel?: string | null;
 };
 /**
- * Durable handle for rows produced by `ctx.csv(...)` or `ctx.dataset(...).run()`.
+ * Durable handle for rows produced by `deepline.csv(...)` or `deepline.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
+ * Pass dataset handles directly into later `deepline.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
@@ -730,7 +730,7 @@ type ToolResultListAccessor<T = Record<string, unknown>, TKey extends string = s
     /**
      * Editions 1–9: dataset handle, not a JavaScript array. Edition 10 uses
      * BasicToolResultListAccessor instead; its .get() returns an ordinary array.
-     * Pass it to ctx.dataset, use first() or async iteration, or await
+     * Pass it to deepline.dataset, use first() or async iteration, or await
      * get().materialize() for the complete current list within the memory cap.
      * materialize(n) and peek(n) return a prefix; none fetch provider pages.
      */
@@ -757,8 +757,11 @@ type BasicToolExecuteResult<TResult = unknown, TMeta = Record<string, unknown>,
 type ToolResponseEnvelope<TData = unknown, TMeta = Record<string, unknown>> = {
     /** @deprecated Use declared getters or toolResponse.rawV2. */
     raw: TData;
-    /** Complete parsed and scrubbed provider response, materialized from raw-v2. */
-    rawV2?: unknown;
+    /**
+     * Complete parsed and scrubbed provider response, materialized from raw-v2.
+     * Unschematized, so typed `any` for direct reads; prefer declared getters.
+     */
+    rawV2?: any;
     /** Durable descriptor for deriving the legacy raw view from `rawV2`. */
     view?: 'data' | 'rawV2';
     meta?: TMeta;
@@ -808,7 +811,7 @@ type ToolExecuteResultAccessors<TExtracted extends Record<string, unknown> = Par
  * Single-value getters: `extractedValues.<name>.get()`; lists: `extractedLists.<name>.get()`.
  *
  * Prefer declared getters. Edition 10 and later Plays receive ordinary arrays from
- * list `.get()` synchronously; persist explicitly with ctx.dataset. Lazy or
+ * list `.get()` synchronously; persist explicitly with deepline.dataset. Lazy or
  * incomplete lists throw: use readList(result, path) for explicit dataset access.
  * Provider pagination requires a separate request; getters never fetch it.
  * Historical editions 1–9 retain PlayDataset getters and async materialize/peek;
@@ -958,7 +961,7 @@ type PlayAuthoringBindings<TInput = Record<string, unknown>> = {
     /**
      * Play-level sandbox settings. The default deadline is 30 minutes; set a
      * static `timeout` such as `"90m"` or `"2h"` for a bounded batch, up to 4h.
-     * This is distinct from `ctx.tools.execute({ timeoutMs })`, which limits one
+     * This is distinct from `deepline.tools.execute({ timeoutMs })`, which limits one
      * provider-call transport rather than the whole Play.
      */
     runtime?: {
@@ -994,7 +997,7 @@ type PlayToolExecutionRequest = {
     timeoutMs?: PlayRuntimeTimeoutMs;
     receiptWaitMs?: PlayReceiptWaitMs;
 };
-/** @deprecated Pass a SQL string directly to ctx.customerDb.query. */
+/** @deprecated Pass a SQL string directly to deepline.customerDb.query. */
 type PlaySqlQuery = {
     readonly kind: 'sql.query';
     readonly text: string;
@@ -1004,7 +1007,7 @@ declare const PLAY_SECRET_HANDLE_BRAND: unique symbol;
 declare const PLAY_SECRET_PROMISE_BRAND: unique symbol;
 /**
  * An opaque reference to a workspace secret used by legacy authoring-contract
- * editions. New Plays receive plaintext strings from `ctx.secrets.get`.
+ * editions. New Plays receive plaintext strings from `deepline.secrets.get`.
  *
  * @sdkReference runtime 176 SecretHandle
  */
@@ -1017,14 +1020,14 @@ type PlaySecretHandle = {
     /** Always throws. A secret handle is deliberately not serializable. */
     toJSON(): never;
 };
-/** A secret-reading promise returned only by `ctx.secrets.get`. */
+/** A secret-reading promise returned only by `deepline.secrets.get`. */
 type PlaySecretPromise = Promise<string> & {
     readonly [PLAY_SECRET_PROMISE_BRAND]: never;
 };
 /** An opaque legacy secret handle retained for earlier Play artifacts. */
 type PlaySecretValue = PlaySecretHandle;
 /**
- * One resolved authentication scheme, built by `ctx.secrets.bearer` or `ctx.secrets.header` and attached to a request through `init.auth`.
+ * One resolved authentication scheme, built by `deepline.secrets.bearer` or `deepline.secrets.header` and attached to a request through `init.auth`.
  *
  * @sdkReference runtime 177 SecretAuth
  */
@@ -1039,7 +1042,7 @@ type PlaySecretAuth = {
 /** One or more resolved authentication schemes for an outbound request. */
 type PlaySecretAuthInput = PlaySecretAuth | readonly PlaySecretAuth[];
 /**
- * The `init` accepted by `ctx.fetch`. Same shape as `RequestInit` plus `auth`.
+ * The `init` accepted by `deepline.fetch`. Same shape as `RequestInit` plus `auth`.
  *
  * @sdkReference runtime 174 SecretAwareRequestInit
  */
@@ -1047,7 +1050,7 @@ type PlaySecretAwareRequestInit = Omit<RequestInit, 'headers'> & {
     /** Ordinary request headers, recorded in the durable receipt with any resolved Play secret value redacted. Prefer `auth` for credentials: it enforces HTTPS and keeps the auth header out of the receipt. */
     headers?: HeadersInit;
     /**
-     * One or more credentialed headers for this request. Pass a single `ctx.secrets` auth for the common case, or an array when an API requires multiple credentialed headers. Auth-helper requests require HTTPS and omit the credential from the durable receipt. Each auth entry must target a distinct header.
+     * One or more credentialed headers for this request. Pass a single `deepline.secrets` auth for the common case, or an array when an API requires multiple credentialed headers. Auth-helper requests require HTTPS and omit the credential from the durable receipt. Each auth entry must target a distinct header.
      */
     auth?: PlaySecretAuthInput;
 };
@@ -1089,7 +1092,7 @@ type PlayAuthoringStepResolver<Row, Value, TContext> = (row: Row, ctx: TContext,
 type PlayAuthoringDatasetColumnRunInput<Row, Value, TContext> = {
     /** Current row, including previously computed columns. */
     readonly row: Row;
-    /** Runtime context for tool, Play, fetch, and log calls. */
+    /** The play runtime, the same object as `deepline`. */
     readonly ctx: TContext;
     /** Zero-based row index for this dataset run. */
     readonly index: number;
@@ -1197,7 +1200,7 @@ type PlayAuthoringReferenceLike<TInput extends Record<string, unknown> = Record<
     readonly name: string;
     readonly playName?: string;
 }) & {
-    /** Type-only input carrier used by ctx.runPlayAsync. */
+    /** Type-only input carrier used by deepline.runPlayAsync. */
     readonly __inputType?: TInput;
 };
 declare const PLAY_RUN_ID_BRAND: unique symbol;
@@ -1245,7 +1248,7 @@ type PlayAuthoringRuntimeStepOptions = {
     staleAfterSeconds?: DurableCallStaleAfterSeconds;
 };
 /**
- * Durable freshness for one `ctx.fetch` call. The key identifies the request;
+ * Durable freshness for one `deepline.fetch` call. The key identifies the request;
  * `staleAfterSeconds` controls when that completed request may be reused across
  * Play runs. Edition 11 requires an explicit choice: `null` reuses indefinitely,
  * `0` executes on every new run, and a positive whole number sets the maximum
@@ -1317,21 +1320,21 @@ interface PlayAuthoringRuntimeContext<TListGetter extends 'dataset' | 'array' =
         /**
          * Read current workspace plan benefits. Execution rechecks admission;
          * this read is fresh and is not a durable receipt.
-         * @sdkReference runtime 179 ctx.billing.entitlements()
+         * @sdkReference runtime 179 deepline.billing.entitlements()
          */
         entitlements(): Promise<BillingEntitlements>;
     };
     /**
      * Load a staged CSV file as a durable dataset handle.
-     * @sdkReference runtime 040 ctx.csv(path, options)
+     * @sdkReference runtime 040 deepline.csv(path, options)
      */
     csv<T = Record<string, unknown>>(path: string | PlayAuthoringCsvInput<T & object>, options?: PlayAuthoringCsvOptions): Promise<PlayDataset<T>>;
     /**
      * Create a persisted row dataset and define durable output columns.
-     * @sdkReference runtime 060 ctx.dataset(key, items)
+     * @sdkReference runtime 060 deepline.dataset(key, items)
      */
     dataset<TSource extends PlayDatasetInput<object>>(key: string, items: TSource): PlayAuthoringDatasetBuilder<PlayDatasetRow<TSource> & object, PlayDatasetRow<TSource> & object, PlayAuthoringRuntimeContext<TListGetter>>;
-    /** @deprecated `ctx.map(...)` was replaced by `ctx.dataset(...)`. */
+    /** @deprecated `map(...)` was replaced by `dataset(...)`. */
     map<TSource extends PlayDatasetInput<object>>(key: string, items: TSource, options?: PlayAuthoringDatasetDefinitionOptions<PlayDatasetRow<TSource> & object>): never;
     /**
      * Identity for this durable run. Use this to build a replay-stable external
@@ -1341,7 +1344,7 @@ interface PlayAuthoringRuntimeContext<TListGetter extends 'dataset' | 'array' =
     tools: {
         /**
          * Execute a provider tool through the terminal-result cache contract.
-         * @sdkReference runtime 150 ctx.tools.execute(request)
+         * @sdkReference runtime 150 deepline.tools.execute(request)
          */
         execute<TOutput = PlayLooseObject>(request: PlayToolExecutionRequest): Promise<TListGetter extends 'array' ? BasicToolExecuteResult<TOutput> : ToolExecuteResult<TOutput>>;
     };
@@ -1355,27 +1358,27 @@ interface PlayAuthoringRuntimeContext<TListGetter extends 'dataset' | 'array' =
     }): Promise<TListGetter extends 'array' ? BasicToolExecuteResult<TOutput> : ToolExecuteResult<TOutput>>;
     /**
      * Execute one reusable step program against a scalar input.
-     * @sdkReference runtime 180 ctx.runSteps(program, input, options)
+     * @sdkReference runtime 180 deepline.runSteps(program, input, options)
      */
     runSteps<TInput extends Record<string, unknown>, TOutput>(program: PlayAuthoringRunnableStepProgram<TOutput, PlayAuthoringRuntimeContext<TListGetter>> & {
         readonly __inputType?: (input: TInput) => void;
     }, input: TInput, options?: PlayAuthoringRunStepsOptions): Promise<TOutput>;
     /**
      * Create one scalar durable checkpoint.
-     * @sdkReference runtime 130 ctx.step(id, fn)
+     * @sdkReference runtime 130 deepline.step(id, fn)
      */
     step<T>(id: string, run: () => T | Promise<T>, options?: PlayAuthoringRuntimeStepOptions): Promise<T>;
     /**
      * Execute a guarded HTTP request. Edition 11 requires an explicit freshness choice; only GET, HEAD, and OPTIONS can retain completed responses. Mutating methods must use `staleAfterSeconds: 0`; the choice governs only the completed call receipt, never dataset/request identity. Failed requests do not publish completed cache entries. A headers timeout leaves an upstream write's outcome unknown and does not establish whether its body was sent. The transport does not automatically retry that timed-out write, but a later invocation can execute it again. Mutating requests require provider-supported idempotency with the same key retained across retries and replay. Deadlines are platform-controlled; callers may cancel through `init.signal`. Pass `{ transient: true }` only on GET, HEAD, and OPTIONS when the response must not be retained in a receipt or checkpoint; edition 11 rejects transient writes. Edition 5+ throws `CtxFetchHttpError` for non-2xx; catch it only when the Play intentionally recovers, otherwise let it fail the Play. Editions 1–4 retain their previous response projections.
      *
-     * @sdkReference runtime 170 ctx.fetch(key, url, init)
+     * @sdkReference runtime 170 deepline.fetch(key, url, init)
      */
     fetch(key: string, url: string | URL, init?: PlaySecretAwareRequestInit, options?: PlayAuthoringFetchOptions): Promise<PlayAuthoringFetchResponse>;
     secrets: {
         /**
          * Read an allowed workspace secret inside the running Play; do not log or return it. Declare uppercase names in top-level `secrets`.
          *
-         * @sdkReference runtime 171 ctx.secrets.get(name)
+         * @sdkReference runtime 171 deepline.secrets.get(name)
          */
         get(name: string): PlaySecretPromise;
         /**
@@ -1383,32 +1386,32 @@ interface PlayAuthoringRuntimeContext<TListGetter extends 'dataset' | 'array' =
          * its direct promise remains accepted for source compatibility, while other
          * promises are rejected.
          *
-         * @sdkReference runtime 172 ctx.secrets.bearer(secret)
+         * @sdkReference runtime 172 deepline.secrets.bearer(secret)
          */
         bearer(secret: string | PlaySecretPromise | PlaySecretHandle): PlaySecretAuth;
         /**
          * Send a credential as a named header, for APIs that do not use bearer
          * tokens — `x-api-key`, `apikey`, `private-token`, and similar.
          *
-         * @sdkReference runtime 173 ctx.secrets.header(header, secret)
+         * @sdkReference runtime 173 deepline.secrets.header(header, secret)
          */
         header(header: string, secret: string | PlaySecretPromise | PlaySecretHandle): PlaySecretAuth;
     };
     /**
      * Compose another Play inline under a stable call key.
-     * @sdkReference runtime 140 ctx.runPlay(key, playRef, input, options)
+     * @sdkReference runtime 140 deepline.runPlay(key, playRef, input, options)
      */
     runPlay<TOutput = unknown>(key: string, playRef: string | PlayAuthoringReferenceLike, input: Record<string, unknown>, options: PlayAuthoringCallOptions): Promise<TOutput>;
     /**
      * Admit an independent scalar Play Run and return its durable identity after scheduler admission, before child completion.
-     * @sdkReference runtime 141 ctx.runPlayAsync(key, playRef, input, options)
+     * @sdkReference runtime 141 deepline.runPlayAsync(key, playRef, input, options)
      */
     runPlayAsync<TInput extends Record<string, unknown>>(
     /** Replay-stable identity for this launch site and row scope. */
     key: string, 
-    /** Independently published Play name or definePlay handle carrying its input type. */
+    /** Independently published Play name, or an imported play carrying its input type. */
     playRef: PlayAuthoringReferenceLike<TInput>, 
-    /** Input checked against the referenced definePlay handle when available. */
+    /** Input checked against the imported play when available. */
     input: NoInfer<TInput>, 
     /** Human-readable launch purpose recorded in the parent's step history. */
     options: PlayAuthoringAsyncCallOptions): Promise<AsyncPlayRunRef>;
@@ -2473,7 +2476,7 @@ declare const PLAY_AUTHORING_FIELD_REGISTRY: {
         readonly issueCode: "play_authoring_durable_policy_invalid";
         readonly description: "Stable durable identity for one external HTTP request.";
         readonly errorMessage: "ctx.fetch key must be a non-empty static string.";
-        readonly unresolvedHint: "Push the aggregation server-side and call it once: a SQL function, a view, or a provider endpoint that returns the whole result. Keep unrolled literal keys only for a handful of genuinely distinct calls. To fan out over rows, use ctx.dataset with a static key — the per-row receipt identity comes from the row, not from the key. Do not compute the key.";
+        readonly unresolvedHint: "Push the aggregation server-side and call it once: a SQL function, a view, or a provider endpoint that returns the whole result. Keep unrolled literal keys only for a handful of genuinely distinct calls. To fan out over rows, use deepline.dataset with a static key — the per-row receipt identity comes from the row, not from the key. Do not compute the key.";
     };
     readonly 'ctx.fetch.staleAfterSeconds': {
         readonly schema: _sinclair_typebox.TUnion<[_sinclair_typebox.TNull, _sinclair_typebox.TInteger]>;

package/dist/{index-CtNK-0nI.d.mts → index-0yS9ihly.d.mts}

@@ -1,5 +1,5 @@
 /// <reference path="./text-imports.d.ts" />
-import { b as PlayBundleArtifact, f as PlaySandboxRuntimeDeclaration, g as PlayCompilerManifest, h as PlayArtifactKind, a as PlayArtifactCompatibility } from './compiler-manifest-lzWpbV3w.mjs';
+import { b as PlayBundleArtifact, f as PlaySandboxRuntimeDeclaration, g as PlayCompilerManifest, h as PlayArtifactKind, a as PlayArtifactCompatibility } from './compiler-manifest-DaFuA1ki.mjs';
 
 type ImportedPlayDependency = {
     filePath: string;
@@ -37,11 +37,14 @@ type PlayBundlingAdapter = {
     sdkPackageJson: string;
     sdkEntryFile: string;
     sdkTypesEntryFile?: string;
-    discoverPackagedLocalFiles(filePath: string): Promise<PlayLocalFileDiscoveryResult>;
+    /** Reads through the sources the build analyzed. */
+    discoverPackagedLocalFiles(filePath: string, analyzedSources: Readonly<Record<string, string>>): Promise<PlayLocalFileDiscoveryResult>;
     typecheckPlaySource?(input: {
         sourceCode: string;
         sourcePath: string;
         importedFilePaths: string[];
+        /** File contents to use instead of the disk; an imported script play is its declaration. */
+        sourceFiles: Record<string, string>;
     }): Promise<string[]> | string[];
     warnAboutNonDevelopmentBundling?(filePath: string): void;
 };
@@ -65,7 +68,11 @@ type BundledPlayFileFailure = {
     filePath: string;
 };
 type BundledPlayFileResult = BundledPlayFileSuccess | BundledPlayFileFailure;
-declare function extractDefinedPlayName(sourceCode: string): string | null;
+/**
+ * The play name a file defines. For a script play this is `config.name`, else
+ * the file name when `filePath` is given (`lookup.play.ts` → `lookup`).
+ */
+declare function extractDefinedPlayName(sourceCode: string, filePath?: string): string | null;
 type BundlePlayFileOptions = {
     /** Must be `cjs_node20`; retained as an explicit compile-contract assertion. */
     target?: PlayArtifactKind;

package/dist/{index-C8Cy-YTm.d.ts → index-CRAScKPg.d.ts}

@@ -1,5 +1,5 @@
 /// <reference path="./text-imports.d.ts" />
-import { b as PlayBundleArtifact, f as PlaySandboxRuntimeDeclaration, g as PlayCompilerManifest, h as PlayArtifactKind, a as PlayArtifactCompatibility } from './compiler-manifest-lzWpbV3w.js';
+import { b as PlayBundleArtifact, f as PlaySandboxRuntimeDeclaration, g as PlayCompilerManifest, h as PlayArtifactKind, a as PlayArtifactCompatibility } from './compiler-manifest-DaFuA1ki.js';
 
 type ImportedPlayDependency = {
     filePath: string;
@@ -37,11 +37,14 @@ type PlayBundlingAdapter = {
     sdkPackageJson: string;
     sdkEntryFile: string;
     sdkTypesEntryFile?: string;
-    discoverPackagedLocalFiles(filePath: string): Promise<PlayLocalFileDiscoveryResult>;
+    /** Reads through the sources the build analyzed. */
+    discoverPackagedLocalFiles(filePath: string, analyzedSources: Readonly<Record<string, string>>): Promise<PlayLocalFileDiscoveryResult>;
     typecheckPlaySource?(input: {
         sourceCode: string;
         sourcePath: string;
         importedFilePaths: string[];
+        /** File contents to use instead of the disk; an imported script play is its declaration. */
+        sourceFiles: Record<string, string>;
     }): Promise<string[]> | string[];
     warnAboutNonDevelopmentBundling?(filePath: string): void;
 };
@@ -65,7 +68,11 @@ type BundledPlayFileFailure = {
     filePath: string;
 };
 type BundledPlayFileResult = BundledPlayFileSuccess | BundledPlayFileFailure;
-declare function extractDefinedPlayName(sourceCode: string): string | null;
+/**
+ * The play name a file defines. For a script play this is `config.name`, else
+ * the file name when `filePath` is given (`lookup.play.ts` → `lookup`).
+ */
+declare function extractDefinedPlayName(sourceCode: string, filePath?: string): string | null;
 type BundlePlayFileOptions = {
     /** Must be `cjs_node20`; retained as an explicit compile-contract assertion. */
     target?: PlayArtifactKind;