deepline 0.3.327 → 0.3.329

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

@@ -311,6 +311,7 @@ export {
   getDefinedPlayMetadata,
   isDeeplineExtractorTarget,
   runIf,
+  readList,
   steps,
 } from './play.js';
 

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

@@ -79,6 +79,7 @@ import { DeeplineError } from './errors.js';
 import {
   attachToolResultListDataset,
   createToolExecuteResult,
+  projectToolResultListGetters,
 } from '../../shared_libs/play-runtime/tool-result.js';
 export { readValue, readList } from '../../shared_libs/play-runtime/tool-result.js';
 import { createDeferredPlayDataset } from '../../shared_libs/plays/dataset.js';
@@ -94,7 +95,8 @@ import type {
   PlayDatasetRow,
 } from '../../shared_libs/plays/dataset.js';
 import type {
-  ToolExecuteResult,
+  ToolExecuteResult as CanonicalToolExecuteResult,
+  BasicToolExecuteResult,
   ToolResultMetadataInput,
 } from '../../shared_libs/plays/tool-result-types.js';
 import type { EmailStatusExtractorConfig } from '../../shared_libs/plays/email-status.js';
@@ -277,12 +279,16 @@ export type SecretAwareRequestInit = PlaySecretAwareRequestInit;
 export type LoosePlayObject = PlayLooseObject;
 
 export type {
-  ToolExecuteResult,
-  ToolExecuteResultAccessors,
-  ToolExecuteResultBase,
+  BasicToolExecuteResult,
+  BasicToolResultListAccessor,
+  BasicToolExecuteResult as ToolExecuteResult,
+  BasicToolExecuteResultAccessors as ToolExecuteResultAccessors,
+  BasicToolExecuteResultBase as ToolExecuteResultBase,
+  ToolExecuteResult as LegacyToolExecuteResult,
   ToolResultBilling,
   ToolResultEnvelope,
-  ToolResultListAccessor,
+  BasicToolResultListAccessor as ToolResultListAccessor,
+  ToolResultListAccessor as LegacyToolResultListAccessor,
   ToolResultTargetAccessor as ToolExtractedValue,
 } from '../../shared_libs/plays/tool-result-types.js';
 export {
@@ -481,7 +487,7 @@ export type CsvOptions = PlayAuthoringCsvOptions;
  * });
  * ```
  */
-export type DeeplinePlayRuntimeContext = PlayAuthoringRuntimeContext;
+export type DeeplinePlayRuntimeContext = PlayAuthoringRuntimeContext<'array'>;
 
 /**
  * Handle to a Play execution: inspect status, stream logs, await output, or cancel.
@@ -680,7 +686,7 @@ export type DeeplineToolsNamespace = {
   ): Promise<DeeplineToolExecuteResult>;
 };
 
-export type DeeplineToolExecuteResult = ToolExecuteResult & {
+export type DeeplineToolExecuteResult = BasicToolExecuteResult & {
   /** Stable key used to recover this direct tool execution, when enabled. */
   idempotencyKey?: string;
   executionRecovery?: ExecutionRecovery;
@@ -1413,12 +1419,12 @@ function stableHash(value: string): string {
 
 function attachSdkQueryResultDatasetResult(
   toolId: string,
-  result: ToolExecuteResult,
+  result: CanonicalToolExecuteResult,
   options?: {
     client: DeeplineClient;
     input: Record<string, unknown>;
   },
-): ToolExecuteResult {
+): CanonicalToolExecuteResult {
   if (!options || !isQueryResultDatasetTool(toolId)) return result;
   const raw = isRecord(result.toolResponse.raw)
     ? result.toolResponse.raw
@@ -1559,42 +1565,46 @@ function toolExecutionEnvelopeToResult(
     : null;
   const toolMetadata = isRecord(metadata) ? metadata : {};
 
-  const result: DeeplineToolExecuteResult = attachSdkQueryResultDatasetResult(
-    fallbackToolId,
-    createToolExecuteResult({
-      status:
-        typeof response.status === 'string' ? response.status : 'completed',
-      jobId: typeof response.job_id === 'string' ? response.job_id : undefined,
-      result: {
-        data: raw,
-        ...(isRecord(meta) ? { meta } : {}),
-      },
-      response: {
-        ...(rawV2 !== undefined ? { rawV2 } : {}),
-        ...(view === 'data' || view === 'rawV2' ? { view } : {}),
-        ...(isRecord(meta) ? { meta } : {}),
-      },
-      metadata: {
-        toolId:
-          typeof toolMetadata.toolId === 'string'
-            ? toolMetadata.toolId
-            : fallbackToolId,
-        extractors: extractorDescriptorRecord(toolMetadata.extractors),
-        targetGetters: stringArrayRecord(toolMetadata.targetGetters),
-        listExtractorPaths: stringArray(toolMetadata.listExtractorPaths),
-        listIdentityGetters: stringArrayRecord(
-          toolMetadata.listIdentityGetters,
-        ),
-      },
-      execution: {
-        idempotent: true,
-        cached: false,
-        source: 'live',
-      },
-      meta: isRecord(response.meta) ? response.meta : undefined,
-      billing: response.billing,
-    }),
-    options,
+  const result: DeeplineToolExecuteResult = projectToolResultListGetters(
+    attachSdkQueryResultDatasetResult(
+      fallbackToolId,
+      createToolExecuteResult({
+        status:
+          typeof response.status === 'string' ? response.status : 'completed',
+        jobId:
+          typeof response.job_id === 'string' ? response.job_id : undefined,
+        result: {
+          data: raw,
+          ...(isRecord(meta) ? { meta } : {}),
+        },
+        response: {
+          ...(rawV2 !== undefined ? { rawV2 } : {}),
+          ...(view === 'data' || view === 'rawV2' ? { view } : {}),
+          ...(isRecord(meta) ? { meta } : {}),
+        },
+        metadata: {
+          toolId:
+            typeof toolMetadata.toolId === 'string'
+              ? toolMetadata.toolId
+              : fallbackToolId,
+          extractors: extractorDescriptorRecord(toolMetadata.extractors),
+          targetGetters: stringArrayRecord(toolMetadata.targetGetters),
+          listExtractorPaths: stringArray(toolMetadata.listExtractorPaths),
+          listIdentityGetters: stringArrayRecord(
+            toolMetadata.listIdentityGetters,
+          ),
+        },
+        execution: {
+          idempotent: true,
+          cached: false,
+          source: 'live',
+        },
+        meta: isRecord(response.meta) ? response.meta : undefined,
+        billing: response.billing,
+      }),
+      options,
+    ),
+    'array',
   );
   const executionRecovery = isRecord(response.executionRecovery)
     ? (response.executionRecovery as unknown as ExecutionRecovery)

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

@@ -200,7 +200,7 @@ export const SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: '0.3.327',
+  version: '0.3.329',
   updateSummary:
     'Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.',
   packageCapabilities: {

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

@@ -161,6 +161,22 @@ export interface ToolPricingSummary {
   summary: string | null;
   /** Additional user-facing pricing notes. */
   details: string[];
+  /** Estimated prices for listed single-unit configurations, not a charge ceiling. */
+  estimatedRange?: {
+    minCreditsPerUnit: number;
+    maxCreditsPerUnit: number;
+    scope: string;
+    configurations: { name: string; creditsPerUnit: number }[];
+  };
+  /** Historical customer charge, not a guaranteed rate or provider tariff. */
+  observedReference?: {
+    creditsPerCall: number;
+    usdPerCall: number | null;
+    source: 'observed';
+    observedAt: string;
+    sampleSize: number;
+    inputMode: string;
+  };
 }
 
 /** A discoverable provider, returned by {@link DeeplineClient.listProviders}. */

package/dist/bundling-sources/shared_libs/observability/queue-health.ts

@@ -307,6 +307,15 @@ export const OPERATIONS_QUEUE_CATALOG = [
     120_000,
     300_000,
   ),
+  queue(
+    'inbound-demo-form-submissions',
+    'Inbound demo form submissions',
+    'leased_workset',
+    'inbound-demo',
+    'Capture accepted demo requests as HubSpot form submissions',
+    60_000,
+    300_000,
+  ),
   queue(
     'usage-rollup-fold',
     'Usage rollup fold',

package/dist/bundling-sources/shared_libs/observability/queue-item-connectors.ts

@@ -287,6 +287,7 @@ export const QUEUE_CONNECTOR_BACKENDS: Readonly<
   'stripe-financial-inbox': 'provider',
   'async-usage-recovery': 'postgres-outbox',
   'notification-deliveries': 'workpool',
+  'inbound-demo-form-submissions': 'convex',
   'usage-rollup-fold': 'postgres-outbox',
   'play-deployment-jobs': 'workpool',
   'github-runner-wait': 'provider',

package/dist/bundling-sources/shared_libs/play-runtime/context.ts

@@ -164,7 +164,9 @@ import {
   attachRelayPublishedToolResultReference,
   attachToolResultListDataset,
   createToolExecuteResult,
+  readList,
   projectNativeBatchToolResponse,
+  projectToolResultListGetters,
   parseToolExecuteResponse,
   isToolExecuteResult,
   isSerializedToolExecuteResult,
@@ -3248,7 +3250,9 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
           'query_customer_db returned an invalid Customer DB rows result.',
         );
       }
-      const dataset = result.extractedLists.rows?.get();
+      // SQL results can be paged even when public list getters expose arrays.
+      // The explicit reader retains the backing dataset and its memory guard.
+      const dataset = readList(result);
       if (isPlayDataset(dataset)) {
         const count = await dataset.count();
         const materialized = await dataset.materialize(options?.maxRows);
@@ -7515,23 +7519,32 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
       !this.hasPinnedToolResponseContract ||
       !Object.prototype.hasOwnProperty.call(result.toolResponse, 'rawV2')
     ) {
-      return result;
+      return projectToolResultListGetters(
+        result,
+        this.currentRuntimeContract.semantics.tools.listGetters,
+      );
     }
     const serialized = serializeToolExecuteResult(result);
     if (serialized.__kind !== 'deepline.tool_execute_result.v2') {
-      return result;
+      return projectToolResultListGetters(
+        result,
+        this.currentRuntimeContract.semantics.tools.listGetters,
+      );
     }
-    return deserializeToolExecuteResult({
-      ...serialized,
-      __kind: 'deepline.tool_execute_result.v1',
-      toolResponse: {
-        raw: legacyRawFromToolResponseRawV2(
-          serialized.toolResponse.rawV2,
-          serialized.toolResponse.view,
-          serialized.toolResponse.responseMeta,
-        ),
-      },
-    });
+    return projectToolResultListGetters(
+      deserializeToolExecuteResult({
+        ...serialized,
+        __kind: 'deepline.tool_execute_result.v1',
+        toolResponse: {
+          raw: legacyRawFromToolResponseRawV2(
+            serialized.toolResponse.rawV2,
+            serialized.toolResponse.view,
+            serialized.toolResponse.responseMeta,
+          ),
+        },
+      }),
+      this.currentRuntimeContract.semantics.tools.listGetters,
+    );
   }
 
   private attachCustomerDbDatasetResult(
@@ -12804,13 +12817,16 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
 
     const executeTool = async (): Promise<unknown> => {
       if (eventWaitHandler) {
-        return this.executeIntegrationEventWaitTool(
+        const result = await this.executeIntegrationEventWaitTool(
           toolId,
           input,
           eventWaitHandler,
           explicitForce,
           logicalCallId,
         );
+        return isToolExecuteResult(result)
+          ? this.materializeToolExecutionResult(result)
+          : result;
       }
       if (toolId === 'run_javascript') {
         throw new Error(DISALLOWED_RUN_JAVASCRIPT_TOOL_MESSAGE);

package/dist/bundling-sources/shared_libs/play-runtime/play-runtime-semantics.ts

@@ -1,5 +1,6 @@
 import {
   normalizePlayAuthoringContractEdition,
+  playToolListGetterMode,
   type PlayAuthoringContractEdition,
 } from '../plays/authoring-contract';
 
@@ -44,6 +45,7 @@ export type PlayRuntimeSemantics = Readonly<{
   }>;
   tools: Readonly<{
     nativeBatchResponse: 'legacy_envelope' | 'logical_response';
+    listGetters: 'dataset' | 'array';
   }>;
   slackHitl: Readonly<{
     defaultTimeoutMs: number;
@@ -52,18 +54,23 @@ export type PlayRuntimeSemantics = Readonly<{
 
 type PlayRuntimeSemanticsTemplate = Omit<
   PlayRuntimeSemantics,
-  'authoringContractEdition'
->;
+  'authoringContractEdition' | 'tools'
+> & { tools: Omit<PlayRuntimeSemantics['tools'], 'listGetters'> };
 
 function definePlayRuntimeSemantics(
-  semantics: PlayRuntimeSemantics,
+  semantics: PlayRuntimeSemanticsTemplate & {
+    authoringContractEdition: PlayAuthoringContractEdition;
+  },
 ): PlayRuntimeSemantics {
   return Object.freeze({
     ...semantics,
     secrets: Object.freeze({ ...semantics.secrets }),
     fetch: Object.freeze({ ...semantics.fetch }),
     inlineChild: Object.freeze({ ...semantics.inlineChild }),
-    tools: Object.freeze({ ...semantics.tools }),
+    tools: Object.freeze({
+      ...semantics.tools,
+      listGetters: playToolListGetterMode(semantics.authoringContractEdition),
+    }),
     slackHitl: Object.freeze({ ...semantics.slackHitl }),
   });
 }
@@ -180,6 +187,17 @@ const PLAY_RUNTIME_SEMANTICS_BY_AUTHORING = {
     tools: { nativeBatchResponse: 'logical_response' },
     slackHitl: WEEK_LONG_SLACK_HITL_SEMANTICS,
   },
+  10: {
+    ...PLAINTEXT_SECRET_SEMANTICS,
+    fetch: {
+      httpFailure: 'throw_typed_error',
+      persistHttpFailure: false,
+      receiptIdentityEdition: FETCH_RECEIPT_IDENTITIES.typedHttpFailure,
+    },
+    inlineChild: { runtimeOnly: true },
+    tools: { nativeBatchResponse: 'logical_response' },
+    slackHitl: WEEK_LONG_SLACK_HITL_SEMANTICS,
+  },
 } satisfies Record<PlayAuthoringContractEdition, PlayRuntimeSemanticsTemplate>;
 
 const PLAY_RUNTIME_SEMANTICS = Object.fromEntries(

package/dist/bundling-sources/shared_libs/play-runtime/runner-app/index.ts

@@ -49,6 +49,7 @@ import {
 import { createPlayContext } from '../context';
 import {
   isHtmlErrorBody,
+  normalizeToolHttpErrorMessage,
   summarizeHtmlErrorBody,
 } from '../tool-http-errors';
 import { augmentSheetContractWithDatasetFields } from '../../play-data-plane/sheet-contract';
@@ -132,6 +133,7 @@ import { installPgRuntimePoolDriver } from '../runtime-pg-driver-pg';
 import { createRuntimeToolAuthScopeDigestResolver } from '../auth-scope-resolver';
 import { createRunScopedChildPlayResolver } from './child-play-resolver';
 import { normalizePlayContractCompatibility } from '../../plays/contracts';
+import { ToolExecutionError } from '../../plays/tool-execution-error';
 import {
   SLACK_HITL_TIMEOUT_ERROR_CODE,
   SlackHitlTimeoutError,
@@ -1004,22 +1006,38 @@ function runtimeControlStatusLabel(status: number): string {
  * A failed runtime-control call as an Error that says WHICH call, HOW it
  * failed (`status`) and for WHICH tool — never the raw response body.
  */
-async function runtimeControlHttpError(input: {
+export async function runtimeControlHttpError(input: {
   description: string;
   toolId: string;
   response: Response;
 }): Promise<Error> {
   const bodyText = await input.response.text().catch(() => '');
-  return Object.assign(
-    new Error(
-      formatRuntimeControlFailure({
-        description: input.description,
-        status: input.response.status,
-        bodyText,
-      }),
-    ),
-    { status: input.response.status, toolId: input.toolId },
-  );
+  const message = formatRuntimeControlFailure({
+    description: input.description,
+    status: input.response.status,
+    bodyText,
+  });
+  const toolError = normalizeToolHttpErrorMessage({
+    toolId: input.toolId,
+    status: input.response.status,
+    attempt: 1,
+    maxAttempts: 1,
+    bodyText,
+  });
+  // Only the serving route can attribute a control failure to a provider
+  // connection. Older and unclassified responses retain their fatal error.
+  if (
+    toolError instanceof ToolExecutionError &&
+    toolError.origin !== 'unknown' &&
+    toolError.category !== 'unknown'
+  ) {
+    toolError.message = message;
+    return toolError;
+  }
+  return Object.assign(new Error(message), {
+    status: input.response.status,
+    toolId: input.toolId,
+  });
 }
 
 function runtimeControlSlackHitlTimeoutError(input: {