deepline 0.1.56 → 0.1.58

package/dist/index.js

@@ -22,10 +22,21 @@ var src_exports = {};
 __export(src_exports, {
   AuthError: () => AuthError,
   ConfigError: () => ConfigError,
+  DEEPLINE_TOOL_CATEGORIES: () => DEEPLINE_TOOL_CATEGORIES,
   Deepline: () => Deepline,
   DeeplineClient: () => DeeplineClient,
   DeeplineContext: () => DeeplineContext,
   DeeplineError: () => DeeplineError,
+  PLAY_BOOTSTRAP_COMPANY_FIELDS: () => PLAY_BOOTSTRAP_COMPANY_FIELDS,
+  PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY: () => PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY,
+  PLAY_BOOTSTRAP_CONTACT_FIELDS: () => PLAY_BOOTSTRAP_CONTACT_FIELDS,
+  PLAY_BOOTSTRAP_FINDER_KINDS: () => PLAY_BOOTSTRAP_FINDER_KINDS,
+  PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER: () => PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER,
+  PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY: () => PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY,
+  PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER: () => PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER,
+  PLAY_BOOTSTRAP_SOURCE_KINDS: () => PLAY_BOOTSTRAP_SOURCE_KINDS,
+  PLAY_BOOTSTRAP_STAGE_KINDS: () => PLAY_BOOTSTRAP_STAGE_KINDS,
+  PLAY_BOOTSTRAP_TEMPLATES: () => PLAY_BOOTSTRAP_TEMPLATES,
   PROD_URL: () => PROD_URL,
   RateLimitError: () => RateLimitError,
   SDK_API_CONTRACT: () => SDK_API_CONTRACT,
@@ -34,7 +45,12 @@ __export(src_exports, {
   definePlay: () => definePlay,
   defineWorkflow: () => defineWorkflow,
   extractSummaryFields: () => extractSummaryFields,
+  formatPlayBootstrapFinderKinds: () => formatPlayBootstrapFinderKinds,
+  formatPlayBootstrapFinderKindsForSentence: () => formatPlayBootstrapFinderKindsForSentence,
+  formatPlayBootstrapTemplates: () => formatPlayBootstrapTemplates,
   getDefinedPlayMetadata: () => getDefinedPlayMetadata,
+  isPlayBootstrapFinderKind: () => isPlayBootstrapFinderKind,
+  isPlayBootstrapTemplate: () => isPlayBootstrapTemplate,
   resolveConfig: () => resolveConfig,
   steps: () => steps,
   tryConvertToList: () => tryConvertToList,
@@ -216,10 +232,10 @@ function resolveConfig(options) {
 
 // src/release.ts
 var SDK_RELEASE = {
-  version: "0.1.56",
+  version: "0.1.58",
   apiContract: "2026-05-play-tool-describe-starters",
   supportPolicy: {
-    latest: "0.1.56",
+    latest: "0.1.58",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53"
   }
@@ -1684,6 +1700,91 @@ var DeeplineClient = class {
   }
 };
 
+// ../shared_libs/plays/bootstrap-routes.ts
+var DEEPLINE_TOOL_CATEGORIES = [
+  "company_search",
+  "people_search",
+  "people_enrich",
+  "email_finder",
+  "email_verify",
+  "phone_finder",
+  "phone_verify",
+  "identity_resolution",
+  "reverse_lookup",
+  "enrichment",
+  "batch",
+  "premium",
+  "free"
+];
+var PLAY_BOOTSTRAP_TEMPLATES = [
+  "people-list",
+  "company-list",
+  "people-email",
+  "people-phone",
+  "company-people",
+  "company-people-email",
+  "company-people-phone"
+];
+var PLAY_BOOTSTRAP_SOURCE_KINDS = [
+  "csv",
+  "play",
+  "provider",
+  "providers"
+];
+var PLAY_BOOTSTRAP_STAGE_KINDS = [
+  "play",
+  "provider",
+  "providers"
+];
+var PLAY_BOOTSTRAP_FINDER_KINDS = [
+  "email_finder",
+  "phone_finder"
+];
+var PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY = "company_search";
+var PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY = "people_search";
+var PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER = {
+  email_finder: "email_finder",
+  phone_finder: "phone_finder"
+};
+var PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER = {
+  email_finder: "email",
+  phone_finder: "phone"
+};
+var PLAY_BOOTSTRAP_CONTACT_FIELDS = [
+  "first_name",
+  "last_name",
+  "domain",
+  "company_name",
+  "linkedin_url",
+  "title",
+  "email",
+  "phone"
+];
+var PLAY_BOOTSTRAP_COMPANY_FIELDS = [
+  "domain",
+  "company_domain",
+  "company_name",
+  "linkedin_url",
+  "website"
+];
+function isPlayBootstrapFinderKind(value) {
+  return PLAY_BOOTSTRAP_FINDER_KINDS.includes(value);
+}
+function isPlayBootstrapTemplate(value) {
+  return PLAY_BOOTSTRAP_TEMPLATES.includes(value);
+}
+function formatPlayBootstrapFinderKinds() {
+  return PLAY_BOOTSTRAP_FINDER_KINDS.join("|");
+}
+function formatPlayBootstrapTemplates() {
+  return PLAY_BOOTSTRAP_TEMPLATES.join("|");
+}
+function formatPlayBootstrapFinderKindsForSentence() {
+  const allButLast = PLAY_BOOTSTRAP_FINDER_KINDS.slice(0, -1);
+  const last = PLAY_BOOTSTRAP_FINDER_KINDS.at(-1);
+  return `${allButLast.join(", ")} or ${last}`;
+}
+
 // ../shared_libs/play-runtime/tool-result.ts
 var TARGET_FALLBACK_KEYS = {
   email: [/^email$/i, /^address$/i, /email/i],
@@ -2742,10 +2843,21 @@ function extractSummaryFields(payload) {
 0 && (module.exports = {
   AuthError,
   ConfigError,
+  DEEPLINE_TOOL_CATEGORIES,
   Deepline,
   DeeplineClient,
   DeeplineContext,
   DeeplineError,
+  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,
   RateLimitError,
   SDK_API_CONTRACT,
@@ -2754,7 +2866,12 @@ function extractSummaryFields(payload) {
   definePlay,
   defineWorkflow,
   extractSummaryFields,
+  formatPlayBootstrapFinderKinds,
+  formatPlayBootstrapFinderKindsForSentence,
+  formatPlayBootstrapTemplates,
   getDefinedPlayMetadata,
+  isPlayBootstrapFinderKind,
+  isPlayBootstrapTemplate,
   resolveConfig,
   steps,
   tryConvertToList,

package/dist/index.mjs

@@ -170,10 +170,10 @@ function resolveConfig(options) {
 
 // src/release.ts
 var SDK_RELEASE = {
-  version: "0.1.56",
+  version: "0.1.58",
   apiContract: "2026-05-play-tool-describe-starters",
   supportPolicy: {
-    latest: "0.1.56",
+    latest: "0.1.58",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53"
   }
@@ -1638,6 +1638,91 @@ var DeeplineClient = class {
   }
 };
 
+// ../shared_libs/plays/bootstrap-routes.ts
+var DEEPLINE_TOOL_CATEGORIES = [
+  "company_search",
+  "people_search",
+  "people_enrich",
+  "email_finder",
+  "email_verify",
+  "phone_finder",
+  "phone_verify",
+  "identity_resolution",
+  "reverse_lookup",
+  "enrichment",
+  "batch",
+  "premium",
+  "free"
+];
+var PLAY_BOOTSTRAP_TEMPLATES = [
+  "people-list",
+  "company-list",
+  "people-email",
+  "people-phone",
+  "company-people",
+  "company-people-email",
+  "company-people-phone"
+];
+var PLAY_BOOTSTRAP_SOURCE_KINDS = [
+  "csv",
+  "play",
+  "provider",
+  "providers"
+];
+var PLAY_BOOTSTRAP_STAGE_KINDS = [
+  "play",
+  "provider",
+  "providers"
+];
+var PLAY_BOOTSTRAP_FINDER_KINDS = [
+  "email_finder",
+  "phone_finder"
+];
+var PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY = "company_search";
+var PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY = "people_search";
+var PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER = {
+  email_finder: "email_finder",
+  phone_finder: "phone_finder"
+};
+var PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER = {
+  email_finder: "email",
+  phone_finder: "phone"
+};
+var PLAY_BOOTSTRAP_CONTACT_FIELDS = [
+  "first_name",
+  "last_name",
+  "domain",
+  "company_name",
+  "linkedin_url",
+  "title",
+  "email",
+  "phone"
+];
+var PLAY_BOOTSTRAP_COMPANY_FIELDS = [
+  "domain",
+  "company_domain",
+  "company_name",
+  "linkedin_url",
+  "website"
+];
+function isPlayBootstrapFinderKind(value) {
+  return PLAY_BOOTSTRAP_FINDER_KINDS.includes(value);
+}
+function isPlayBootstrapTemplate(value) {
+  return PLAY_BOOTSTRAP_TEMPLATES.includes(value);
+}
+function formatPlayBootstrapFinderKinds() {
+  return PLAY_BOOTSTRAP_FINDER_KINDS.join("|");
+}
+function formatPlayBootstrapTemplates() {
+  return PLAY_BOOTSTRAP_TEMPLATES.join("|");
+}
+function formatPlayBootstrapFinderKindsForSentence() {
+  const allButLast = PLAY_BOOTSTRAP_FINDER_KINDS.slice(0, -1);
+  const last = PLAY_BOOTSTRAP_FINDER_KINDS.at(-1);
+  return `${allButLast.join(", ")} or ${last}`;
+}
+
 // ../shared_libs/play-runtime/tool-result.ts
 var TARGET_FALLBACK_KEYS = {
   email: [/^email$/i, /^address$/i, /email/i],
@@ -2695,10 +2780,21 @@ function extractSummaryFields(payload) {
 export {
   AuthError,
   ConfigError,
+  DEEPLINE_TOOL_CATEGORIES,
   Deepline,
   DeeplineClient,
   DeeplineContext,
   DeeplineError,
+  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,
   RateLimitError,
   SDK_API_CONTRACT,
@@ -2707,7 +2803,12 @@ export {
   definePlay,
   defineWorkflow,
   extractSummaryFields,
+  formatPlayBootstrapFinderKinds,
+  formatPlayBootstrapFinderKindsForSentence,
+  formatPlayBootstrapTemplates,
   getDefinedPlayMetadata,
+  isPlayBootstrapFinderKind,
+  isPlayBootstrapTemplate,
   resolveConfig,
   steps,
   tryConvertToList,

package/dist/repo/apps/play-runner-workers/src/entry.ts

@@ -130,6 +130,12 @@ import type {
   LiveNodeProgressMap,
   LiveNodeProgressSnapshot,
 } from './runtime/live-progress';
+import {
+  ToolHttpError,
+  extractErrorBilling,
+  isHardBillingToolHttpError,
+  normalizeToolHttpErrorMessage,
+} from './runtime/tool-http-errors';
 
 // The play's default export. The bundler injects this — see bundle-play-file.ts.
 // eslint-disable-next-line @typescript-eslint/ban-ts-comment
@@ -195,23 +201,6 @@ const EXECUTE_TOOL_METADATA_HEADER = 'x-deepline-include-tool-metadata';
 const EXECUTE_RESPONSE_CONTRACT_HEADER = 'x-deepline-execute-response-contract';
 const V2_EXECUTE_RESPONSE_CONTRACT = 'v2-tool-execution-result';
 
-class ToolHttpError extends Error {
-  readonly billing: Record<string, unknown> | null;
-
-  constructor(message: string, billing: Record<string, unknown> | null) {
-    super(message);
-    this.name = 'ToolHttpError';
-    this.billing = billing;
-  }
-}
-
-function formatCreditAmount(value: unknown): string {
-  if (typeof value !== 'number' || !Number.isFinite(value)) {
-    return String(value ?? '-');
-  }
-  return Number(value.toFixed(8)).toString();
-}
-
 function getStringField(value: unknown, key: string): string | null {
   if (!isRecord(value)) return null;
   const field = value[key];
@@ -227,71 +216,6 @@ function getObjectField(
   return isRecord(field) ? field : null;
 }
 
-function isInsufficientCreditsBilling(
-  billing: Record<string, unknown> | null,
-): billing is Record<string, unknown> {
-  return billing?.kind === 'insufficient_credits';
-}
-
-function formatInsufficientCreditsMessage(input: {
-  billing: Record<string, unknown>;
-  toolId: string;
-}): string {
-  const operation =
-    getStringField(input.billing, 'operation_id') ??
-    getStringField(input.billing, 'operation') ??
-    input.toolId;
-  const balance = formatCreditAmount(input.billing.balance_credits);
-  const required = formatCreditAmount(input.billing.required_credits);
-  const recommended = formatCreditAmount(
-    input.billing.recommended_add_credits ?? input.billing.needed_credits,
-  );
-  const billingUrl = getStringField(input.billing, 'billing_url');
-  const addSuffix =
-    billingUrl && recommended !== '-'
-      ? ` Add >=${recommended} at ${billingUrl}.`
-      : billingUrl
-        ? ` Add credits at ${billingUrl}.`
-        : '';
-  return `Workspace balance ${balance} < required ${required} for ${operation}.${addSuffix}`;
-}
-
-function normalizeToolHttpErrorMessage(input: {
-  toolId: string;
-  status: number;
-  attempt: number;
-  maxAttempts: number;
-  bodyText: string;
-}): ToolHttpError {
-  let parsed: Record<string, unknown> | null = null;
-  try {
-    const candidate = JSON.parse(input.bodyText);
-    parsed = isRecord(candidate) ? candidate : null;
-  } catch {
-    parsed = null;
-  }
-  const billing = getObjectField(parsed, 'billing');
-  if (isInsufficientCreditsBilling(billing)) {
-    return new ToolHttpError(
-      `tool ${input.toolId} ${input.status} attempt ${input.attempt}/${input.maxAttempts}: ${formatInsufficientCreditsMessage(
-        {
-          billing,
-          toolId: input.toolId,
-        },
-      )}`,
-      billing,
-    );
-  }
-  return new ToolHttpError(
-    `tool ${input.toolId} ${input.status} attempt ${input.attempt}/${input.maxAttempts}: ${input.bodyText.slice(0, 500)}`,
-    billing,
-  );
-}
-
-function extractErrorBilling(error: unknown): Record<string, unknown> | null {
-  return error instanceof ToolHttpError ? error.billing : null;
-}
-
 /** R2 binding injected by the Worker runtime (when present in deploy metadata). */
 type WorkerEnv = {
   PLAYS_BUCKET?: R2Bucket;
@@ -1348,7 +1272,7 @@ async function callToolDirect(
       bodyText: text,
     });
     const retryable =
-      res.status === 429 ||
+      (res.status === 429 && !isHardBillingToolHttpError(lastError)) ||
       (res.status >= 500 && WORKER_RETRY_SAFE_5XX_TOOLS.has(toolId));
     if (!retryable || attempt >= maxAttempts) {
       throw lastError;

package/dist/repo/apps/play-runner-workers/src/runtime/tool-http-errors.ts

@@ -0,0 +1,198 @@
+export class ToolHttpError extends Error {
+  readonly billing: Record<string, unknown> | null;
+
+  constructor(message: string, billing: Record<string, unknown> | null) {
+    super(message);
+    this.name = 'ToolHttpError';
+    this.billing = billing;
+  }
+}
+
+function formatCreditAmount(value: unknown): string {
+  if (typeof value !== 'number' || !Number.isFinite(value)) {
+    return String(value ?? '-');
+  }
+  return Number(value.toFixed(8)).toString();
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+
+function getStringField(value: unknown, key: string): string | null {
+  if (!isRecord(value)) return null;
+  const field = value[key];
+  return typeof field === 'string' && field.trim() ? field : null;
+}
+
+function getObjectField(
+  value: unknown,
+  key: string,
+): Record<string, unknown> | null {
+  if (!isRecord(value)) return null;
+  const field = value[key];
+  return isRecord(field) ? field : null;
+}
+
+function isInsufficientCreditsBilling(
+  billing: Record<string, unknown> | null,
+): billing is Record<string, unknown> {
+  return billing?.kind === 'insufficient_credits';
+}
+
+function isHardBillingFailurePayload(
+  payload: Record<string, unknown> | null,
+): payload is Record<string, unknown> {
+  if (!payload) return false;
+  const category = String(
+    payload.error_category ?? payload.errorCategory ?? '',
+  ).toLowerCase();
+  const code = String(payload.code ?? payload.error_code ?? '').toUpperCase();
+  const message = String(
+    payload.error ?? payload.message ?? payload.failure_description ?? '',
+  ).toLowerCase();
+  if (category === 'billing') return true;
+  if (
+    code === 'INSUFFICIENT_CREDITS' ||
+    code === 'BILLING_CAP_EXCEEDED' ||
+    code === 'MONTHLY_BILLING_LIMIT_EXCEEDED'
+  ) {
+    return true;
+  }
+  return (
+    (message.includes('billing cap') ||
+      message.includes('monthly billing limit') ||
+      message.includes('rolling 30-day organization billing cap') ||
+      message.includes('insufficient credits')) &&
+    !message.includes('rate limit')
+  );
+}
+
+function normalizeHardBillingPayload(
+  payload: Record<string, unknown>,
+): Record<string, unknown> {
+  return {
+    kind: 'billing_cap_exceeded',
+    code:
+      typeof payload.code === 'string' && payload.code.trim()
+        ? payload.code
+        : 'MONTHLY_BILLING_LIMIT_EXCEEDED',
+    error_category: 'billing',
+    failure_origin:
+      typeof payload.failure_origin === 'string' && payload.failure_origin.trim()
+        ? payload.failure_origin
+        : 'deepline_billing',
+    message:
+      typeof payload.error === 'string' && payload.error.trim()
+        ? payload.error
+        : typeof payload.message === 'string' && payload.message.trim()
+          ? payload.message
+          : 'Deepline billing cap exceeded.',
+    ...payload,
+  };
+}
+
+function formatHardBillingFailureMessage(input: {
+  billing: Record<string, unknown>;
+  toolId: string;
+  status: number;
+  attempt: number;
+  maxAttempts: number;
+}): string {
+  const code = getStringField(input.billing, 'code');
+  const message =
+    getStringField(input.billing, 'message') ??
+    getStringField(input.billing, 'error') ??
+    'Deepline billing cap exceeded.';
+  return [
+    `tool ${input.toolId} ${input.status} attempt ${input.attempt}/${input.maxAttempts}:`,
+    'Deepline billing cap exceeded.',
+    'Run halted before marking remaining rows processed.',
+    code ? `code=${code}.` : '',
+    message,
+  ]
+    .filter(Boolean)
+    .join(' ');
+}
+
+function formatInsufficientCreditsMessage(input: {
+  billing: Record<string, unknown>;
+  toolId: string;
+}): string {
+  const operation =
+    getStringField(input.billing, 'operation_id') ??
+    getStringField(input.billing, 'operation') ??
+    input.toolId;
+  const balance = formatCreditAmount(input.billing.balance_credits);
+  const required = formatCreditAmount(input.billing.required_credits);
+  const recommended = formatCreditAmount(
+    input.billing.recommended_add_credits ?? input.billing.needed_credits,
+  );
+  const billingUrl = getStringField(input.billing, 'billing_url');
+  const addSuffix =
+    billingUrl && recommended !== '-'
+      ? ` Add >=${recommended} at ${billingUrl}.`
+      : billingUrl
+        ? ` Add credits at ${billingUrl}.`
+        : '';
+  return `Workspace balance ${balance} < required ${required} for ${operation}.${addSuffix}`;
+}
+
+export function normalizeToolHttpErrorMessage(input: {
+  toolId: string;
+  status: number;
+  attempt: number;
+  maxAttempts: number;
+  bodyText: string;
+}): ToolHttpError {
+  let parsed: Record<string, unknown> | null = null;
+  try {
+    const candidate = JSON.parse(input.bodyText);
+    parsed = isRecord(candidate) ? candidate : null;
+  } catch {
+    parsed = null;
+  }
+  const billing = getObjectField(parsed, 'billing');
+  if (isInsufficientCreditsBilling(billing)) {
+    return new ToolHttpError(
+      `tool ${input.toolId} ${input.status} attempt ${input.attempt}/${input.maxAttempts}: ${formatInsufficientCreditsMessage(
+        {
+          billing,
+          toolId: input.toolId,
+        },
+      )}`,
+      billing,
+    );
+  }
+  const hardBillingPayload = isHardBillingFailurePayload(billing)
+    ? normalizeHardBillingPayload(billing)
+    : isHardBillingFailurePayload(parsed)
+      ? normalizeHardBillingPayload(parsed)
+      : null;
+  if (hardBillingPayload) {
+    return new ToolHttpError(
+      formatHardBillingFailureMessage({
+        billing: hardBillingPayload,
+        toolId: input.toolId,
+        status: input.status,
+        attempt: input.attempt,
+        maxAttempts: input.maxAttempts,
+      }),
+      hardBillingPayload,
+    );
+  }
+  return new ToolHttpError(
+    `tool ${input.toolId} ${input.status} attempt ${input.attempt}/${input.maxAttempts}: ${input.bodyText.slice(0, 500)}`,
+    billing,
+  );
+}
+
+export function extractErrorBilling(
+  error: unknown,
+): Record<string, unknown> | null {
+  return error instanceof ToolHttpError ? error.billing : null;
+}
+
+export function isHardBillingToolHttpError(error: unknown): boolean {
+  return error instanceof ToolHttpError && isHardBillingFailurePayload(error.billing);
+}

package/dist/repo/sdk/src/index.ts

@@ -57,6 +57,24 @@
 export { DeeplineClient } from './client.js';
 export type { PlayStatus, ToolExecution } from './client.js';
 export { SDK_API_CONTRACT, SDK_VERSION } from './version.js';
+export {
+  DEEPLINE_TOOL_CATEGORIES,
+  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_STAGE_KINDS,
+  PLAY_BOOTSTRAP_SOURCE_KINDS,
+  PLAY_BOOTSTRAP_TEMPLATES,
+  formatPlayBootstrapFinderKinds,
+  formatPlayBootstrapFinderKindsForSentence,
+  formatPlayBootstrapTemplates,
+  isPlayBootstrapFinderKind,
+  isPlayBootstrapTemplate,
+} from '../../shared_libs/plays/bootstrap-routes.js';
 
 // ——— Errors ———
 export {
@@ -106,6 +124,9 @@ export type {
   PublishPlayVersionResult,
   StartPlayRunRequest,
   PlayListItem,
+  DeeplineToolCategory,
+  PlayBootstrapFinderKind,
+  PlayBootstrapEntityKind,
 } from './types.js';
 
 export type {

package/dist/repo/sdk/src/play.ts

@@ -534,28 +534,12 @@ export interface DeeplinePlayRuntimeContext {
     bodyText: string;
     json: unknown | null;
   }>;
-  /**
-   * Invoke another registered or file-backed play as a child workflow.
-   *
-   * Use this for real composition boundaries, especially when a fitting
-   * scalar prebuilt play already encodes provider order, fallbacks,
-   * normalization, and no-result behavior. Do not invoke plays through
-   * `ctx.tools.execute`; tools and plays are separate namespaces.
-   *
-   * `key` is the stable child-call identity for idempotency and traceability.
-   *
-   * @param key - Child call id.
-   * @param playRef - Play name or handle.
-   * @param input - Child input.
-   * @param options - Run options.
-   * @returns Child play output.
-   */
-  runPlay(
+  runPlay<TOutput = unknown>(
     key: string,
     playRef: string | PlayReferenceLike,
     input: Record<string, unknown>,
     options: { description?: string; staleAfterSeconds?: number },
-  ): Promise<Record<string, unknown>>;
+  ): Promise<TOutput>;
 
   /**
    * Emit a log line visible in `play tail` and the play's progress logs.

package/dist/repo/sdk/src/release.ts

@@ -50,10 +50,10 @@ export type SdkRelease = {
 };
 
 export const SDK_RELEASE = {
-  version: '0.1.56',
+  version: '0.1.58',
   apiContract: '2026-05-play-tool-describe-starters',
   supportPolicy: {
-    latest: '0.1.56',
+    latest: '0.1.58',
     minimumSupported: '0.1.53',
     deprecatedBelow: '0.1.53',
   },