deepline 0.1.269 → 0.1.271

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

@@ -99,6 +99,59 @@ const REGISTER_PLAY_ARTIFACTS_MAX_BATCH_COUNT = 3;
 const REGISTER_PLAY_ARTIFACTS_MAX_BATCH_BYTES = 2_500_000;
 const DEEPLINEAGENT_EXECUTE_TIMEOUT_MS = 15 * 60 * 1000;
 
+export type IngestionStorageRepairResult = {
+  status?: 'repaired';
+  connection_grants: {
+    runtime_role: string;
+    customer_db_role: string;
+  };
+  repaired: unknown[];
+  count: number;
+  repair?: {
+    location: { changed: boolean };
+    storage_contract: { applied: boolean; current: boolean };
+    runtime_migration: { current: boolean };
+    runtime_capabilities: {
+      before: {
+        reachable: boolean;
+        status: string;
+        storage_contract_current: boolean;
+        runtime_migration_current: boolean;
+        runtime_capabilities_ready: boolean;
+        capability_failures: string[];
+      };
+      after: {
+        reachable: boolean;
+        status: string;
+        storage_contract_current: boolean;
+        runtime_migration_current: boolean;
+        runtime_capabilities_ready: boolean;
+        capability_failures: string[];
+      };
+      runtime_role: {
+        currentRole: string | null;
+        dlMetaSchemaUsage: boolean;
+        uuidFunctionExecute: boolean;
+        enrichmentsSchemaUsage: boolean;
+        enrichmentsWriteReady: boolean;
+        storageSchemaUsage: boolean;
+        storageSchemaCreate: boolean;
+      };
+      customer_db_role: {
+        currentRole: string | null;
+        dlMetaSchemaUsage: boolean;
+        uuidFunctionExecute: boolean;
+        enrichmentsSchemaUsage: boolean;
+        enrichmentsWriteReady: boolean;
+        storageSchemaUsage: boolean;
+        storageSchemaCreate: boolean;
+      };
+    };
+    internal_relations: { reconciled: boolean };
+    materialized_tables: { repaired_count: number };
+  };
+};
+
 function normalizePlayRunIntegrationMode(
   value: unknown,
 ): 'live' | 'eval_stub' | 'fixture' | undefined {
@@ -1592,20 +1645,14 @@ export class DeeplineClient {
    * grants plus materialized table grants. Org-admin only. Use when a run fails
    * with WORKSPACE_STORAGE_NOT_READY.
    */
-  async repairIngestionStorage(input?: { provider?: string }): Promise<{
-    connection_grants: { runtime_role: string; customer_db_role: string };
-    repaired: unknown[];
-    count: number;
-  }> {
+  async repairIngestionStorage(input?: {
+    provider?: string;
+  }): Promise<IngestionStorageRepairResult> {
     // forbiddenAsApiError: the repair route returns a meaningful 403 for
     // non-org-admin callers. Without it, http.ts collapses 403 into a generic
     // AuthError (statusCode 401) and the CLI's "requires org admin" branch
     // could never fire.
-    return this.http.post<{
-      connection_grants: { runtime_role: string; customer_db_role: string };
-      repaired: unknown[];
-      count: number;
-    }>(
+    return this.http.post<IngestionStorageRepairResult>(
       '/api/v2/ingestion/repair',
       {
         ...(input?.provider ? { provider: input.provider } : {}),

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

@@ -67,6 +67,7 @@ export type {
   BillingSubscriptionCancelResult,
   BillingSubscriptionStatus,
   BillingTopUpResult,
+  IngestionStorageRepairResult,
   PlayStatus,
   PlaySheetRow,
   PlaySheetRowsResult,

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

@@ -155,7 +155,7 @@ export const SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: '0.1.269',
+  version: '0.1.271',
   contracts: {
     api: {
       name: 'sdk-http-api',

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

@@ -250,6 +250,22 @@ export interface ToolDefinition {
     value: string;
     term?: string;
   }>;
+  /**
+   * Whether this tool is callable in the current workspace. `false` for a
+   * bring-your-own-credential provider (e.g. Apollo) that has not been
+   * connected — the agent should offer to connect it rather than call it.
+   */
+  connected?: boolean;
+  /**
+   * Connection status for discovery: `managed` (Deepline-run credentials),
+   * `connected` (your own credential is connected), or `requires_connection`
+   * (BYO provider not yet connected in this workspace).
+   */
+  credentialStatus?: 'managed' | 'connected' | 'requires_connection';
+  /** True when the tool requires a customer-provided credential to run. */
+  requiresOwnCredential?: boolean;
+  /** Actionable message shown when a connection is required. */
+  connectionMessage?: string;
 }
 
 export interface ModelProviderOptionField {

package/dist/bundling-sources/shared_libs/play-runtime/run-failure.ts

@@ -35,8 +35,10 @@ export const WORKSPACE_STORAGE_NOT_READY_CODE = 'WORKSPACE_STORAGE_NOT_READY';
 // postgres-URI passwords). The raw pg error goes in the Error `cause` for server
 // logs only, never into this message or the normalized public failure.
 export const WORKSPACE_STORAGE_NOT_READY_MESSAGE =
-  'Workspace storage for this organization is not ready, so the run was stopped before any provider calls were made (nothing was billed). ' +
-  'Ask an organization admin to run `deepline db repair` (POST /api/v2/ingestion/repair), then re-run. ' +
+  'Workspace storage for this organization is unavailable, so this operation could not start. ' +
+  'This blocked operation did not use Deepline credits. ' +
+  'Earlier completed operations in the same run may already have used credits. ' +
+  'Re-run the command. If it fails again, ask an organization admin to run `deepline db repair` (POST /api/v2/ingestion/repair), then re-run. ' +
   'If this keeps happening, contact Deepline support with the run ID.';
 
 export class WorkspaceStorageNotReadyError extends Error {

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

@@ -569,7 +569,8 @@ async function postRuntimeApi<TResponse>(
   );
   const maxAttempts = runtimeApiMaxAttempts(body.action);
   for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
-    let response: Response;
+    let response: Response | null = null;
+    let parsed: Record<string, unknown> | null = null;
     const abortController = new AbortController();
     const timeout = setTimeout(
       () => abortController.abort(),
@@ -582,25 +583,55 @@ async function postRuntimeApi<TResponse>(
         body: JSON.stringify(body),
         signal: abortController.signal,
       });
+      let parsedValue: unknown;
+      try {
+        parsedValue = await response.json();
+      } catch (error) {
+        if (abortController.signal.aborted) throw error;
+        parsedValue = null;
+      }
+      parsed =
+        parsedValue !== null &&
+        typeof parsedValue === 'object' &&
+        !Array.isArray(parsedValue)
+          ? (parsedValue as Record<string, unknown>)
+          : null;
     } catch (error) {
+      clearTimeout(timeout);
       if (attempt < maxAttempts) {
         await sleepRuntimeApiRetry(body.action, attempt);
         continue;
       }
       const message = error instanceof Error ? error.message : String(error);
       throw new Error(
-        `Runtime API request to ${url} failed before receiving a response: ${message}`,
+        `Runtime API request to ${url} failed ${
+          response
+            ? 'while reading the response body'
+            : 'before receiving a response'
+        }: ${message}`,
       );
     } finally {
       clearTimeout(timeout);
     }
 
-    const parsed = (await response.json().catch(() => null)) as Record<
-      string,
-      unknown
-    > | null;
     if (response.ok) {
-      return parsed as TResponse;
+      if (parsed !== null) {
+        return parsed as TResponse;
+      }
+      // A proxy can deliver the successful status line and then truncate the
+      // response body. Treat that as a transport failure, not a typed success:
+      // every runtime action returns a JSON object and runtime writes are
+      // already retry-safe across the equivalent fetch-failed boundary.
+      if (attempt < maxAttempts) {
+        await sleepRuntimeApiRetry(body.action, attempt);
+        continue;
+      }
+      const requestId = response.headers.get('x-deepline-request-id');
+      throw new Error(
+        `Runtime API request to ${url} returned status ${response.status} ` +
+          `without a valid JSON response body (action=${body.action}` +
+          `${requestId ? `, request_id=${requestId}` : ''}).`,
+      );
     }
 
     const retryAfterMs =

package/dist/cli/index.js

@@ -718,7 +718,7 @@ var SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: "0.1.269",
+  version: "0.1.271",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -8834,6 +8834,28 @@ function formatDbQueryError(sql, error) {
   }
   return errorMessage(error);
 }
+function dbRepairHumanLines(result) {
+  const repair = result.repair;
+  return [
+    "Workspace storage repair completed.",
+    ...repair ? [
+      `Location changed: ${repair.location.changed ? "yes" : "no"}`,
+      `Storage contract: ${repair.storage_contract.current ? "current" : "not ready"}`,
+      `Runtime migration: ${repair.runtime_migration.current ? "current" : "not ready"}`,
+      `Runtime capability probe: ${repair.runtime_capabilities.after.runtime_capabilities_ready ? "passed" : "failed"}`,
+      `Materialized table grants reconciled: ${repair.materialized_tables.repaired_count}`
+    ] : [
+      "Runtime capability probe: unavailable from this server version",
+      `Materialized table grants reconciled: ${result.count}`
+    ],
+    `Runtime role: ${result.connection_grants.runtime_role}`,
+    `Customer DB role: ${result.connection_grants.customer_db_role}`
+  ];
+}
+function dbRepairPlainText(result) {
+  return result.repair ? "Workspace storage repair completed. Runtime capability probe passed.\n" : `Workspace storage repair completed. ${result.count} materialized table grant(s) reconciled; runtime capability probe unavailable.
+`;
+}
 function writeCustomerDbCsv(result, outPath) {
   const resolved = (0, import_node_path9.resolve)(outPath);
   (0, import_node_fs8.writeFileSync)(
@@ -9015,26 +9037,23 @@ async function handleDbRepair(args) {
   printCommandEnvelope(
     {
       command: "db repair",
+      status: result.status,
       repaired: result.repaired,
       count: result.count,
       connection_grants: result.connection_grants,
+      repair: result.repair,
       render: {
         sections: [
           {
             title: "storage contract repair",
-            lines: [
-              `Repaired ${result.count} table(s).`,
-              `Runtime role: ${result.connection_grants.runtime_role}`,
-              `Customer DB role: ${result.connection_grants.customer_db_role}`
-            ]
+            lines: dbRepairHumanLines(result)
           }
         ]
       }
     },
     {
       json: jsonOutput,
-      text: `Repaired ${result.count} table(s). Storage grants re-established.
-`
+      text: dbRepairPlainText(result)
     }
   );
   return 0;
@@ -26603,6 +26622,15 @@ function requiredInputIds(tool) {
   );
   return toolInputFieldsForDisplay(inputSchema).filter((field) => field.required === true).map((field) => String(field.name ?? "")).filter(Boolean);
 }
+function notConnectedSuffix(tool) {
+  const record = tool;
+  const status = stringField2(record, "credentialStatus", "credential_status");
+  const connected = record.connected;
+  if (status === "requires_connection" || connected === false) {
+    return " - \u26A0 requires your credentials \u2014 not connected (connect to use)";
+  }
+  return "";
+}
 function shortPricingHint(tool) {
   const pricing = recordField2(
     tool,
@@ -26718,7 +26746,8 @@ async function listToolsInCategory(category, emitJson) {
     provider: tool.provider,
     required: requiredInputIds(tool),
     pricing: shortPricingHint(tool),
-    description: firstSentence(tool.description)
+    description: firstSentence(tool.description),
+    notConnected: notConnectedSuffix(tool)
   })).sort((a, b) => a.id.localeCompare(b.id));
   const idWidth = rows.reduce((max, row) => Math.max(max, row.id.length), 0);
   const render = {
@@ -26730,7 +26759,7 @@ async function listToolsInCategory(category, emitJson) {
           const required = row.required.length ? `(${row.required.join(", ")})` : "(no required inputs)";
           const pricing = row.pricing ? ` [${row.pricing}]` : "";
           const description = row.description ? ` - ${row.description}` : "";
-          return `${id}  ${required}${pricing}${description}`;
+          return `${id}  ${required}${pricing}${description}${row.notConnected}`;
         })
       },
       {
@@ -26771,7 +26800,7 @@ async function listToolsForCategoryFilter(requestedCategories, emitJson, compact
         lines: items.map((item) => {
           const cats = item.categories.length ? ` [${item.categories.join(", ")}]` : "";
           const pricing = formatListedToolCost(item);
-          return `${item.toolId}${cats} - ${item.description}${pricing ? ` - ${pricing}` : ""}`;
+          return `${item.toolId}${cats} - ${item.description}${pricing ? ` - ${pricing}` : ""}${notConnectedSuffix(item)}`;
         })
       },
       {

package/dist/cli/index.mjs

@@ -703,7 +703,7 @@ var SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: "0.1.269",
+  version: "0.1.271",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -8839,6 +8839,28 @@ function formatDbQueryError(sql, error) {
   }
   return errorMessage(error);
 }
+function dbRepairHumanLines(result) {
+  const repair = result.repair;
+  return [
+    "Workspace storage repair completed.",
+    ...repair ? [
+      `Location changed: ${repair.location.changed ? "yes" : "no"}`,
+      `Storage contract: ${repair.storage_contract.current ? "current" : "not ready"}`,
+      `Runtime migration: ${repair.runtime_migration.current ? "current" : "not ready"}`,
+      `Runtime capability probe: ${repair.runtime_capabilities.after.runtime_capabilities_ready ? "passed" : "failed"}`,
+      `Materialized table grants reconciled: ${repair.materialized_tables.repaired_count}`
+    ] : [
+      "Runtime capability probe: unavailable from this server version",
+      `Materialized table grants reconciled: ${result.count}`
+    ],
+    `Runtime role: ${result.connection_grants.runtime_role}`,
+    `Customer DB role: ${result.connection_grants.customer_db_role}`
+  ];
+}
+function dbRepairPlainText(result) {
+  return result.repair ? "Workspace storage repair completed. Runtime capability probe passed.\n" : `Workspace storage repair completed. ${result.count} materialized table grant(s) reconciled; runtime capability probe unavailable.
+`;
+}
 function writeCustomerDbCsv(result, outPath) {
   const resolved = resolve6(outPath);
   writeFileSync7(
@@ -9020,26 +9042,23 @@ async function handleDbRepair(args) {
   printCommandEnvelope(
     {
       command: "db repair",
+      status: result.status,
       repaired: result.repaired,
       count: result.count,
       connection_grants: result.connection_grants,
+      repair: result.repair,
       render: {
         sections: [
           {
             title: "storage contract repair",
-            lines: [
-              `Repaired ${result.count} table(s).`,
-              `Runtime role: ${result.connection_grants.runtime_role}`,
-              `Customer DB role: ${result.connection_grants.customer_db_role}`
-            ]
+            lines: dbRepairHumanLines(result)
           }
         ]
       }
     },
     {
       json: jsonOutput,
-      text: `Repaired ${result.count} table(s). Storage grants re-established.
-`
+      text: dbRepairPlainText(result)
     }
   );
   return 0;
@@ -26651,6 +26670,15 @@ function requiredInputIds(tool) {
   );
   return toolInputFieldsForDisplay(inputSchema).filter((field) => field.required === true).map((field) => String(field.name ?? "")).filter(Boolean);
 }
+function notConnectedSuffix(tool) {
+  const record = tool;
+  const status = stringField2(record, "credentialStatus", "credential_status");
+  const connected = record.connected;
+  if (status === "requires_connection" || connected === false) {
+    return " - \u26A0 requires your credentials \u2014 not connected (connect to use)";
+  }
+  return "";
+}
 function shortPricingHint(tool) {
   const pricing = recordField2(
     tool,
@@ -26766,7 +26794,8 @@ async function listToolsInCategory(category, emitJson) {
     provider: tool.provider,
     required: requiredInputIds(tool),
     pricing: shortPricingHint(tool),
-    description: firstSentence(tool.description)
+    description: firstSentence(tool.description),
+    notConnected: notConnectedSuffix(tool)
   })).sort((a, b) => a.id.localeCompare(b.id));
   const idWidth = rows.reduce((max, row) => Math.max(max, row.id.length), 0);
   const render = {
@@ -26778,7 +26807,7 @@ async function listToolsInCategory(category, emitJson) {
           const required = row.required.length ? `(${row.required.join(", ")})` : "(no required inputs)";
           const pricing = row.pricing ? ` [${row.pricing}]` : "";
           const description = row.description ? ` - ${row.description}` : "";
-          return `${id}  ${required}${pricing}${description}`;
+          return `${id}  ${required}${pricing}${description}${row.notConnected}`;
         })
       },
       {
@@ -26819,7 +26848,7 @@ async function listToolsForCategoryFilter(requestedCategories, emitJson, compact
         lines: items.map((item) => {
           const cats = item.categories.length ? ` [${item.categories.join(", ")}]` : "";
           const pricing = formatListedToolCost(item);
-          return `${item.toolId}${cats} - ${item.description}${pricing ? ` - ${pricing}` : ""}`;
+          return `${item.toolId}${cats} - ${item.description}${pricing ? ` - ${pricing}` : ""}${notConnectedSuffix(item)}`;
         })
       },
       {

package/dist/index.d.mts

@@ -239,6 +239,22 @@ interface ToolDefinition {
         value: string;
         term?: string;
     }>;
+    /**
+     * Whether this tool is callable in the current workspace. `false` for a
+     * bring-your-own-credential provider (e.g. Apollo) that has not been
+     * connected — the agent should offer to connect it rather than call it.
+     */
+    connected?: boolean;
+    /**
+     * Connection status for discovery: `managed` (Deepline-run credentials),
+     * `connected` (your own credential is connected), or `requires_connection`
+     * (BYO provider not yet connected in this workspace).
+     */
+    credentialStatus?: 'managed' | 'connected' | 'requires_connection';
+    /** True when the tool requires a customer-provided credential to run. */
+    requiresOwnCredential?: boolean;
+    /** Actionable message shown when a connection is required. */
+    connectionMessage?: string;
 }
 interface ModelProviderOptionField {
     name: string;
@@ -1405,6 +1421,69 @@ type EnrichCompiledConfig = {
     };
 };
 
+type IngestionStorageRepairResult = {
+    status?: 'repaired';
+    connection_grants: {
+        runtime_role: string;
+        customer_db_role: string;
+    };
+    repaired: unknown[];
+    count: number;
+    repair?: {
+        location: {
+            changed: boolean;
+        };
+        storage_contract: {
+            applied: boolean;
+            current: boolean;
+        };
+        runtime_migration: {
+            current: boolean;
+        };
+        runtime_capabilities: {
+            before: {
+                reachable: boolean;
+                status: string;
+                storage_contract_current: boolean;
+                runtime_migration_current: boolean;
+                runtime_capabilities_ready: boolean;
+                capability_failures: string[];
+            };
+            after: {
+                reachable: boolean;
+                status: string;
+                storage_contract_current: boolean;
+                runtime_migration_current: boolean;
+                runtime_capabilities_ready: boolean;
+                capability_failures: string[];
+            };
+            runtime_role: {
+                currentRole: string | null;
+                dlMetaSchemaUsage: boolean;
+                uuidFunctionExecute: boolean;
+                enrichmentsSchemaUsage: boolean;
+                enrichmentsWriteReady: boolean;
+                storageSchemaUsage: boolean;
+                storageSchemaCreate: boolean;
+            };
+            customer_db_role: {
+                currentRole: string | null;
+                dlMetaSchemaUsage: boolean;
+                uuidFunctionExecute: boolean;
+                enrichmentsSchemaUsage: boolean;
+                enrichmentsWriteReady: boolean;
+                storageSchemaUsage: boolean;
+                storageSchemaCreate: boolean;
+            };
+        };
+        internal_relations: {
+            reconciled: boolean;
+        };
+        materialized_tables: {
+            repaired_count: number;
+        };
+    };
+};
 type ExecuteToolRawOptions = {
     includeToolMetadata?: boolean;
     responseIntent?: 'dataset' | 'raw' | 'row_artifact';
@@ -1933,14 +2012,7 @@ declare class DeeplineClient {
      */
     repairIngestionStorage(input?: {
         provider?: string;
-    }): Promise<{
-        connection_grants: {
-            runtime_role: string;
-            customer_db_role: string;
-        };
-        repaired: unknown[];
-        count: number;
-    }>;
+    }): Promise<IngestionStorageRepairResult>;
     /**
      * Start a play run.
      *
@@ -4583,4 +4655,4 @@ declare function writeCsvOutputFile(rows: Array<Record<string, unknown>>, stem:
  */
 declare function extractSummaryFields(payload: unknown): Record<string, Scalar>;
 
-export { AuthError, type BillingCreditPool, type BillingInvoiceEntry, type BillingInvoicesResult, type BillingNamespace, type BillingPaymentMethodSummary, type BillingSubscriptionCancelResult, type BillingSubscriptionStatus, type BillingTopUpResult, 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, type DbNamespace, 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 PlayCallExecution, type PlayCallOptions, type PlayDataset, type PlayDatasetInput, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayRevisionSummary, type PlayRunActionPackage, type PlayRunDatasetActions, type PlayRunPackage, 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 SqlListenerDeclaration, type SqlListenerEvent, type SqlListenerOperation, type SqlQuery, 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 BillingCreditPool, type BillingInvoiceEntry, type BillingInvoicesResult, type BillingNamespace, type BillingPaymentMethodSummary, type BillingSubscriptionCancelResult, type BillingSubscriptionStatus, type BillingTopUpResult, 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, type DbNamespace, 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, type IngestionStorageRepairResult, 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 PlayCallExecution, type PlayCallOptions, type PlayDataset, type PlayDatasetInput, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayRevisionSummary, type PlayRunActionPackage, type PlayRunDatasetActions, type PlayRunPackage, 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 SqlListenerDeclaration, type SqlListenerEvent, type SqlListenerOperation, type SqlQuery, 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 };

package/dist/index.d.ts

@@ -239,6 +239,22 @@ interface ToolDefinition {
         value: string;
         term?: string;
     }>;
+    /**
+     * Whether this tool is callable in the current workspace. `false` for a
+     * bring-your-own-credential provider (e.g. Apollo) that has not been
+     * connected — the agent should offer to connect it rather than call it.
+     */
+    connected?: boolean;
+    /**
+     * Connection status for discovery: `managed` (Deepline-run credentials),
+     * `connected` (your own credential is connected), or `requires_connection`
+     * (BYO provider not yet connected in this workspace).
+     */
+    credentialStatus?: 'managed' | 'connected' | 'requires_connection';
+    /** True when the tool requires a customer-provided credential to run. */
+    requiresOwnCredential?: boolean;
+    /** Actionable message shown when a connection is required. */
+    connectionMessage?: string;
 }
 interface ModelProviderOptionField {
     name: string;
@@ -1405,6 +1421,69 @@ type EnrichCompiledConfig = {
     };
 };
 
+type IngestionStorageRepairResult = {
+    status?: 'repaired';
+    connection_grants: {
+        runtime_role: string;
+        customer_db_role: string;
+    };
+    repaired: unknown[];
+    count: number;
+    repair?: {
+        location: {
+            changed: boolean;
+        };
+        storage_contract: {
+            applied: boolean;
+            current: boolean;
+        };
+        runtime_migration: {
+            current: boolean;
+        };
+        runtime_capabilities: {
+            before: {
+                reachable: boolean;
+                status: string;
+                storage_contract_current: boolean;
+                runtime_migration_current: boolean;
+                runtime_capabilities_ready: boolean;
+                capability_failures: string[];
+            };
+            after: {
+                reachable: boolean;
+                status: string;
+                storage_contract_current: boolean;
+                runtime_migration_current: boolean;
+                runtime_capabilities_ready: boolean;
+                capability_failures: string[];
+            };
+            runtime_role: {
+                currentRole: string | null;
+                dlMetaSchemaUsage: boolean;
+                uuidFunctionExecute: boolean;
+                enrichmentsSchemaUsage: boolean;
+                enrichmentsWriteReady: boolean;
+                storageSchemaUsage: boolean;
+                storageSchemaCreate: boolean;
+            };
+            customer_db_role: {
+                currentRole: string | null;
+                dlMetaSchemaUsage: boolean;
+                uuidFunctionExecute: boolean;
+                enrichmentsSchemaUsage: boolean;
+                enrichmentsWriteReady: boolean;
+                storageSchemaUsage: boolean;
+                storageSchemaCreate: boolean;
+            };
+        };
+        internal_relations: {
+            reconciled: boolean;
+        };
+        materialized_tables: {
+            repaired_count: number;
+        };
+    };
+};
 type ExecuteToolRawOptions = {
     includeToolMetadata?: boolean;
     responseIntent?: 'dataset' | 'raw' | 'row_artifact';
@@ -1933,14 +2012,7 @@ declare class DeeplineClient {
      */
     repairIngestionStorage(input?: {
         provider?: string;
-    }): Promise<{
-        connection_grants: {
-            runtime_role: string;
-            customer_db_role: string;
-        };
-        repaired: unknown[];
-        count: number;
-    }>;
+    }): Promise<IngestionStorageRepairResult>;
     /**
      * Start a play run.
      *
@@ -4583,4 +4655,4 @@ declare function writeCsvOutputFile(rows: Array<Record<string, unknown>>, stem:
  */
 declare function extractSummaryFields(payload: unknown): Record<string, Scalar>;
 
-export { AuthError, type BillingCreditPool, type BillingInvoiceEntry, type BillingInvoicesResult, type BillingNamespace, type BillingPaymentMethodSummary, type BillingSubscriptionCancelResult, type BillingSubscriptionStatus, type BillingTopUpResult, 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, type DbNamespace, 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 PlayCallExecution, type PlayCallOptions, type PlayDataset, type PlayDatasetInput, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayRevisionSummary, type PlayRunActionPackage, type PlayRunDatasetActions, type PlayRunPackage, 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 SqlListenerDeclaration, type SqlListenerEvent, type SqlListenerOperation, type SqlQuery, 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 BillingCreditPool, type BillingInvoiceEntry, type BillingInvoicesResult, type BillingNamespace, type BillingPaymentMethodSummary, type BillingSubscriptionCancelResult, type BillingSubscriptionStatus, type BillingTopUpResult, 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, type DbNamespace, 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, type IngestionStorageRepairResult, 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 PlayCallExecution, type PlayCallOptions, type PlayDataset, type PlayDatasetInput, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayRevisionSummary, type PlayRunActionPackage, type PlayRunDatasetActions, type PlayRunPackage, 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 SqlListenerDeclaration, type SqlListenerEvent, type SqlListenerOperation, type SqlQuery, 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 };

package/dist/index.js

@@ -437,7 +437,7 @@ var SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: "0.1.269",
+  version: "0.1.271",
   contracts: {
     api: {
       name: "sdk-http-api",

package/dist/index.mjs

@@ -367,7 +367,7 @@ var SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: "0.1.269",
+  version: "0.1.271",
   contracts: {
     api: {
       name: "sdk-http-api",

package/package.json

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