deepline 0.1.57 → 0.1.58

package/dist/helpers.d.mts

@@ -0,0 +1,30 @@
+/**
+ * GTM normalization primitives used by generated plays and user-authored
+ * prospecting notebooks.
+ *
+ * Keep these helpers small, deterministic, and schema-shaped. They are not an
+ * agent or a provider policy layer; they are the shared vocabulary for turning
+ * messy GTM rows into contact/account fields that Deepline plays understand.
+ * As provider enums and row conventions get sharper, improve them here so
+ * bootstrapped plays get better without carrying more generated glue.
+ *
+ * Do not add helpers that extract values from tool/play results. Result values
+ * should come from declared getters (`extractedValues.email.get()`) or declared
+ * play output fields (`result.email`). Helpers in this file normalize input
+ * rows and candidate entities, not opaque execution envelopes.
+ */
+type GtmRow = Record<string, unknown>;
+type GtmContact = GtmRow & {
+    first_name: string;
+    last_name: string;
+    domain: string;
+    company_name: string;
+    linkedin_url: string;
+    title: string;
+    email: string;
+    phone: string;
+};
+declare function normalizeGtmRows(value: unknown): GtmRow[];
+declare function normalizeGtmContact(row: GtmRow): GtmContact;
+
+export { type GtmContact, type GtmRow, normalizeGtmContact, normalizeGtmRows };

package/dist/helpers.d.ts

@@ -0,0 +1,30 @@
+/**
+ * GTM normalization primitives used by generated plays and user-authored
+ * prospecting notebooks.
+ *
+ * Keep these helpers small, deterministic, and schema-shaped. They are not an
+ * agent or a provider policy layer; they are the shared vocabulary for turning
+ * messy GTM rows into contact/account fields that Deepline plays understand.
+ * As provider enums and row conventions get sharper, improve them here so
+ * bootstrapped plays get better without carrying more generated glue.
+ *
+ * Do not add helpers that extract values from tool/play results. Result values
+ * should come from declared getters (`extractedValues.email.get()`) or declared
+ * play output fields (`result.email`). Helpers in this file normalize input
+ * rows and candidate entities, not opaque execution envelopes.
+ */
+type GtmRow = Record<string, unknown>;
+type GtmContact = GtmRow & {
+    first_name: string;
+    last_name: string;
+    domain: string;
+    company_name: string;
+    linkedin_url: string;
+    title: string;
+    email: string;
+    phone: string;
+};
+declare function normalizeGtmRows(value: unknown): GtmRow[];
+declare function normalizeGtmContact(row: GtmRow): GtmContact;
+
+export { type GtmContact, type GtmRow, normalizeGtmContact, normalizeGtmRows };

package/dist/helpers.js

@@ -0,0 +1,143 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/helpers.ts
+var helpers_exports = {};
+__export(helpers_exports, {
+  normalizeGtmContact: () => normalizeGtmContact,
+  normalizeGtmRows: () => normalizeGtmRows
+});
+module.exports = __toCommonJS(helpers_exports);
+
+// src/gtm.ts
+function normalizeGtmRows(value) {
+  if (!value) return [];
+  if (Array.isArray(value)) return value.filter(isRecord);
+  if (isRecord(value)) {
+    for (const key of ["rows", "people", "contacts", "companies", "data"]) {
+      const nested = value[key];
+      if (Array.isArray(nested)) return nested.filter(isRecord);
+    }
+  }
+  return [];
+}
+function normalizeGtmContact(row) {
+  const first = pickString(row, [
+    "first_name",
+    "FIRST_NAME",
+    "firstName",
+    "first",
+    "firstname",
+    "First Name",
+    "given_name",
+    "givenName"
+  ]);
+  const last = pickString(row, [
+    "last_name",
+    "LAST_NAME",
+    "lastName",
+    "last",
+    "lastname",
+    "Last Name",
+    "family_name",
+    "familyName"
+  ]);
+  const full = pickString(row, [
+    "full_name",
+    "FULL_NAME",
+    "name",
+    "person_name"
+  ]);
+  const split = splitName(full);
+  return {
+    ...row,
+    first_name: first || split.first,
+    last_name: last || split.last,
+    domain: pickString(row, [
+      "domain",
+      "DOMAIN",
+      "company_domain",
+      "COMPANY_DOMAIN",
+      "companyDomain",
+      "website_domain",
+      "company website",
+      "Company Domain",
+      "Website",
+      "website"
+    ]),
+    company_name: pickString(row, [
+      "company_name",
+      "COMPANY_NAME",
+      "company",
+      "organization_name",
+      "account_name",
+      "Company",
+      "Account"
+    ]),
+    linkedin_url: pickString(row, [
+      "linkedin_url",
+      "LINKEDIN_URL",
+      "linkedin",
+      "person_linkedin_url",
+      "linkedin_profile",
+      "LinkedIn"
+    ]),
+    title: pickString(row, [
+      "title",
+      "TITLE",
+      "job_title",
+      "headline",
+      "Job Title"
+    ]),
+    email: pickString(row, [
+      "email",
+      "EMAIL",
+      "work_email",
+      "workEmail",
+      "Work Email"
+    ]),
+    phone: pickString(row, [
+      "phone",
+      "PHONE",
+      "phone_number",
+      "phoneNumber",
+      "mobile",
+      "Mobile Phone"
+    ])
+  };
+}
+function isRecord(value) {
+  return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+function pickString(row, names) {
+  for (const name of names) {
+    const value = row[name];
+    if (typeof value === "string" && value.trim()) return value.trim();
+  }
+  return "";
+}
+function splitName(value) {
+  const parts = String(value || "").trim().split(/\s+/).filter(Boolean);
+  return { first: parts[0] ?? "", last: parts.slice(1).join(" ") };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  normalizeGtmContact,
+  normalizeGtmRows
+});

package/dist/helpers.mjs

@@ -0,0 +1,115 @@
+// src/gtm.ts
+function normalizeGtmRows(value) {
+  if (!value) return [];
+  if (Array.isArray(value)) return value.filter(isRecord);
+  if (isRecord(value)) {
+    for (const key of ["rows", "people", "contacts", "companies", "data"]) {
+      const nested = value[key];
+      if (Array.isArray(nested)) return nested.filter(isRecord);
+    }
+  }
+  return [];
+}
+function normalizeGtmContact(row) {
+  const first = pickString(row, [
+    "first_name",
+    "FIRST_NAME",
+    "firstName",
+    "first",
+    "firstname",
+    "First Name",
+    "given_name",
+    "givenName"
+  ]);
+  const last = pickString(row, [
+    "last_name",
+    "LAST_NAME",
+    "lastName",
+    "last",
+    "lastname",
+    "Last Name",
+    "family_name",
+    "familyName"
+  ]);
+  const full = pickString(row, [
+    "full_name",
+    "FULL_NAME",
+    "name",
+    "person_name"
+  ]);
+  const split = splitName(full);
+  return {
+    ...row,
+    first_name: first || split.first,
+    last_name: last || split.last,
+    domain: pickString(row, [
+      "domain",
+      "DOMAIN",
+      "company_domain",
+      "COMPANY_DOMAIN",
+      "companyDomain",
+      "website_domain",
+      "company website",
+      "Company Domain",
+      "Website",
+      "website"
+    ]),
+    company_name: pickString(row, [
+      "company_name",
+      "COMPANY_NAME",
+      "company",
+      "organization_name",
+      "account_name",
+      "Company",
+      "Account"
+    ]),
+    linkedin_url: pickString(row, [
+      "linkedin_url",
+      "LINKEDIN_URL",
+      "linkedin",
+      "person_linkedin_url",
+      "linkedin_profile",
+      "LinkedIn"
+    ]),
+    title: pickString(row, [
+      "title",
+      "TITLE",
+      "job_title",
+      "headline",
+      "Job Title"
+    ]),
+    email: pickString(row, [
+      "email",
+      "EMAIL",
+      "work_email",
+      "workEmail",
+      "Work Email"
+    ]),
+    phone: pickString(row, [
+      "phone",
+      "PHONE",
+      "phone_number",
+      "phoneNumber",
+      "mobile",
+      "Mobile Phone"
+    ])
+  };
+}
+function isRecord(value) {
+  return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+function pickString(row, names) {
+  for (const name of names) {
+    const value = row[name];
+    if (typeof value === "string" && value.trim()) return value.trim();
+  }
+  return "";
+}
+function splitName(value) {
+  const parts = String(value || "").trim().split(/\s+/).filter(Boolean);
+  return { first: parts[0] ?? "", last: parts.slice(1).join(" ") };
+}
+export {
+  normalizeGtmContact,
+  normalizeGtmRows
+};

package/dist/index.d.mts

@@ -160,6 +160,33 @@ type PlayCompilerManifest = {
     importedPlayDependencies: PlayCompilerDependencyManifest[];
 };
 
+declare const DEEPLINE_TOOL_CATEGORIES: readonly ["company_search", "people_search", "people_enrich", "email_finder", "email_verify", "phone_finder", "phone_verify", "identity_resolution", "reverse_lookup", "enrichment", "batch", "premium", "free"];
+type DeeplineToolCategory = (typeof DEEPLINE_TOOL_CATEGORIES)[number] | (string & {});
+declare const PLAY_BOOTSTRAP_TEMPLATES: readonly ["people-list", "company-list", "people-email", "people-phone", "company-people", "company-people-email", "company-people-phone"];
+type PlayBootstrapTemplate = (typeof PLAY_BOOTSTRAP_TEMPLATES)[number];
+declare const PLAY_BOOTSTRAP_SOURCE_KINDS: readonly ["csv", "play", "provider", "providers"];
+declare const PLAY_BOOTSTRAP_STAGE_KINDS: readonly ["play", "provider", "providers"];
+declare const PLAY_BOOTSTRAP_FINDER_KINDS: readonly ["email_finder", "phone_finder"];
+type PlayBootstrapFinderKind = (typeof PLAY_BOOTSTRAP_FINDER_KINDS)[number];
+type PlayBootstrapEntityKind = 'company' | 'contact' | 'email' | 'phone' | 'unknown';
+declare const PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY: "company_search";
+declare const PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY: "people_search";
+declare const PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER: {
+    readonly email_finder: "email_finder";
+    readonly phone_finder: "phone_finder";
+};
+declare const PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER: {
+    readonly email_finder: "email";
+    readonly phone_finder: "phone";
+};
+declare const PLAY_BOOTSTRAP_CONTACT_FIELDS: readonly ["first_name", "last_name", "domain", "company_name", "linkedin_url", "title", "email", "phone"];
+declare const PLAY_BOOTSTRAP_COMPANY_FIELDS: readonly ["domain", "company_domain", "company_name", "linkedin_url", "website"];
+declare function isPlayBootstrapFinderKind(value: string): value is PlayBootstrapFinderKind;
+declare function isPlayBootstrapTemplate(value: string): value is PlayBootstrapTemplate;
+declare function formatPlayBootstrapFinderKinds(): string;
+declare function formatPlayBootstrapTemplates(): string;
+declare function formatPlayBootstrapFinderKindsForSentence(): string;
+
 /**
  * Options for constructing a {@link DeeplineClient} or connecting via {@link Deepline.connect}.
  *
@@ -237,19 +264,7 @@ interface ToolPricingSummary {
     /** Additional user-facing pricing notes. */
     details: string[];
 }
-/**
- * Summary definition of a tool, returned by {@link DeeplineClient.listTools}.
- *
- * Contains everything needed to discover, describe, and call a tool.
- *
- * @example
- * ```typescript
- * const tools = await client.listTools();
- * for (const tool of tools) {
- *   console.log(`${tool.toolId} (${tool.provider}): ${tool.description}`);
- * }
- * ```
- */
+
 interface ToolDefinition {
     /** Unique tool identifier used in API calls (e.g. `"apollo_people_search"`). */
     toolId: string;
@@ -260,7 +275,7 @@ interface ToolDefinition {
     /** What this tool does — suitable for LLM tool descriptions. */
     description: string;
     /** Categorization tags (e.g. `["people", "enrichment"]`). */
-    categories: string[];
+    categories: DeeplineToolCategory[];
     /** Operation slug within the provider. */
     operation?: string;
     /** Normalized operation identifier. */
@@ -1859,7 +1874,8 @@ type ToolResultExtractorDescriptor = {
 type ToolResultTargetAccessor<T = unknown> = ToolResultTargetMetadata & {
     get(): T | null;
 };
-type ToolResultListAccessor<T = Record<string, unknown>> = ToolResultListMetadata & {
+type ToolResultListAccessor<T = Record<string, unknown>, TKey extends string = string> = Omit<ToolResultListMetadata, 'keys'> & {
+    keys: Partial<Record<TKey, string>> & Record<string, string>;
     get(): T[];
 };
 type ToolResponseEnvelope<TData = unknown, TMeta = Record<string, unknown>> = {
@@ -2277,26 +2293,10 @@ 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(key: string, playRef: string | PlayReferenceLike, input: Record<string, unknown>, options: {
+    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.
      *
@@ -2910,4 +2910,4 @@ declare function writeCsvOutputFile(rows: Array<Record<string, unknown>>, stem:
  */
 declare function extractSummaryFields(payload: unknown): Record<string, Scalar>;
 
-export { AuthError, type ClearPlayHistoryRequest, type ClearPlayHistoryResult, type ColumnMap, type ConditionalStepResolver, ConfigError, type CsvInput, Deepline, DeeplineClient, type DeeplineClientOptions, DeeplineContext, DeeplineError, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DefinePlayConfig, type DefinedPlay, type FileInput, type LiveEventEnvelope, type MapStepBuilder, type MapStepResolver, PROD_URL, type PlayBindings, type PlayDataset, type PlayDatasetInput, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayRevisionSummary, type PlayRunResult, type PlayRunStart, type PlayStatus, type PlayStepProgramStep, type PrebuiltPlayRef, type PublishPlayVersionRequest, type PublishPlayVersionResult, RateLimitError, type ResolvedConfig, SDK_API_CONTRACT, SDK_VERSION, type StartPlayRunRequest, type StepProgram, type StepProgramResolver, type StepResolver, type ToolDefinition, type ToolExecuteResult, type ToolExecution, type ToolMetadata, defineInput, definePlay, defineWorkflow, extractSummaryFields, getDefinedPlayMetadata, resolveConfig, steps, tryConvertToList, when, writeCsvOutputFile, writeJsonOutputFile };
+export { AuthError, type ClearPlayHistoryRequest, type ClearPlayHistoryResult, type ColumnMap, type ConditionalStepResolver, ConfigError, type CsvInput, DEEPLINE_TOOL_CATEGORIES, Deepline, DeeplineClient, type DeeplineClientOptions, DeeplineContext, DeeplineError, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplineToolCategory, type DefinePlayConfig, type DefinedPlay, type FileInput, type LiveEventEnvelope, type MapStepBuilder, type MapStepResolver, 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 PlayBindings, type PlayBootstrapEntityKind, type PlayBootstrapFinderKind, type PlayDataset, type PlayDatasetInput, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayRevisionSummary, type PlayRunResult, type PlayRunStart, type PlayStatus, type PlayStepProgramStep, type PrebuiltPlayRef, type PublishPlayVersionRequest, type PublishPlayVersionResult, RateLimitError, type ResolvedConfig, SDK_API_CONTRACT, SDK_VERSION, type StartPlayRunRequest, type StepProgram, type StepProgramResolver, type StepResolver, type ToolDefinition, type ToolExecuteResult, type ToolExecution, type ToolMetadata, defineInput, definePlay, defineWorkflow, extractSummaryFields, formatPlayBootstrapFinderKinds, formatPlayBootstrapFinderKindsForSentence, formatPlayBootstrapTemplates, getDefinedPlayMetadata, isPlayBootstrapFinderKind, isPlayBootstrapTemplate, resolveConfig, steps, tryConvertToList, when, writeCsvOutputFile, writeJsonOutputFile };

package/dist/index.d.ts

@@ -160,6 +160,33 @@ type PlayCompilerManifest = {
     importedPlayDependencies: PlayCompilerDependencyManifest[];
 };
 
+declare const DEEPLINE_TOOL_CATEGORIES: readonly ["company_search", "people_search", "people_enrich", "email_finder", "email_verify", "phone_finder", "phone_verify", "identity_resolution", "reverse_lookup", "enrichment", "batch", "premium", "free"];
+type DeeplineToolCategory = (typeof DEEPLINE_TOOL_CATEGORIES)[number] | (string & {});
+declare const PLAY_BOOTSTRAP_TEMPLATES: readonly ["people-list", "company-list", "people-email", "people-phone", "company-people", "company-people-email", "company-people-phone"];
+type PlayBootstrapTemplate = (typeof PLAY_BOOTSTRAP_TEMPLATES)[number];
+declare const PLAY_BOOTSTRAP_SOURCE_KINDS: readonly ["csv", "play", "provider", "providers"];
+declare const PLAY_BOOTSTRAP_STAGE_KINDS: readonly ["play", "provider", "providers"];
+declare const PLAY_BOOTSTRAP_FINDER_KINDS: readonly ["email_finder", "phone_finder"];
+type PlayBootstrapFinderKind = (typeof PLAY_BOOTSTRAP_FINDER_KINDS)[number];
+type PlayBootstrapEntityKind = 'company' | 'contact' | 'email' | 'phone' | 'unknown';
+declare const PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY: "company_search";
+declare const PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY: "people_search";
+declare const PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER: {
+    readonly email_finder: "email_finder";
+    readonly phone_finder: "phone_finder";
+};
+declare const PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER: {
+    readonly email_finder: "email";
+    readonly phone_finder: "phone";
+};
+declare const PLAY_BOOTSTRAP_CONTACT_FIELDS: readonly ["first_name", "last_name", "domain", "company_name", "linkedin_url", "title", "email", "phone"];
+declare const PLAY_BOOTSTRAP_COMPANY_FIELDS: readonly ["domain", "company_domain", "company_name", "linkedin_url", "website"];
+declare function isPlayBootstrapFinderKind(value: string): value is PlayBootstrapFinderKind;
+declare function isPlayBootstrapTemplate(value: string): value is PlayBootstrapTemplate;
+declare function formatPlayBootstrapFinderKinds(): string;
+declare function formatPlayBootstrapTemplates(): string;
+declare function formatPlayBootstrapFinderKindsForSentence(): string;
+
 /**
  * Options for constructing a {@link DeeplineClient} or connecting via {@link Deepline.connect}.
  *
@@ -237,19 +264,7 @@ interface ToolPricingSummary {
     /** Additional user-facing pricing notes. */
     details: string[];
 }
-/**
- * Summary definition of a tool, returned by {@link DeeplineClient.listTools}.
- *
- * Contains everything needed to discover, describe, and call a tool.
- *
- * @example
- * ```typescript
- * const tools = await client.listTools();
- * for (const tool of tools) {
- *   console.log(`${tool.toolId} (${tool.provider}): ${tool.description}`);
- * }
- * ```
- */
+
 interface ToolDefinition {
     /** Unique tool identifier used in API calls (e.g. `"apollo_people_search"`). */
     toolId: string;
@@ -260,7 +275,7 @@ interface ToolDefinition {
     /** What this tool does — suitable for LLM tool descriptions. */
     description: string;
     /** Categorization tags (e.g. `["people", "enrichment"]`). */
-    categories: string[];
+    categories: DeeplineToolCategory[];
     /** Operation slug within the provider. */
     operation?: string;
     /** Normalized operation identifier. */
@@ -1859,7 +1874,8 @@ type ToolResultExtractorDescriptor = {
 type ToolResultTargetAccessor<T = unknown> = ToolResultTargetMetadata & {
     get(): T | null;
 };
-type ToolResultListAccessor<T = Record<string, unknown>> = ToolResultListMetadata & {
+type ToolResultListAccessor<T = Record<string, unknown>, TKey extends string = string> = Omit<ToolResultListMetadata, 'keys'> & {
+    keys: Partial<Record<TKey, string>> & Record<string, string>;
     get(): T[];
 };
 type ToolResponseEnvelope<TData = unknown, TMeta = Record<string, unknown>> = {
@@ -2277,26 +2293,10 @@ 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(key: string, playRef: string | PlayReferenceLike, input: Record<string, unknown>, options: {
+    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.
      *
@@ -2910,4 +2910,4 @@ declare function writeCsvOutputFile(rows: Array<Record<string, unknown>>, stem:
  */
 declare function extractSummaryFields(payload: unknown): Record<string, Scalar>;
 
-export { AuthError, type ClearPlayHistoryRequest, type ClearPlayHistoryResult, type ColumnMap, type ConditionalStepResolver, ConfigError, type CsvInput, Deepline, DeeplineClient, type DeeplineClientOptions, DeeplineContext, DeeplineError, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DefinePlayConfig, type DefinedPlay, type FileInput, type LiveEventEnvelope, type MapStepBuilder, type MapStepResolver, PROD_URL, type PlayBindings, type PlayDataset, type PlayDatasetInput, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayRevisionSummary, type PlayRunResult, type PlayRunStart, type PlayStatus, type PlayStepProgramStep, type PrebuiltPlayRef, type PublishPlayVersionRequest, type PublishPlayVersionResult, RateLimitError, type ResolvedConfig, SDK_API_CONTRACT, SDK_VERSION, type StartPlayRunRequest, type StepProgram, type StepProgramResolver, type StepResolver, type ToolDefinition, type ToolExecuteResult, type ToolExecution, type ToolMetadata, defineInput, definePlay, defineWorkflow, extractSummaryFields, getDefinedPlayMetadata, resolveConfig, steps, tryConvertToList, when, writeCsvOutputFile, writeJsonOutputFile };
+export { AuthError, type ClearPlayHistoryRequest, type ClearPlayHistoryResult, type ColumnMap, type ConditionalStepResolver, ConfigError, type CsvInput, DEEPLINE_TOOL_CATEGORIES, Deepline, DeeplineClient, type DeeplineClientOptions, DeeplineContext, DeeplineError, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplineToolCategory, type DefinePlayConfig, type DefinedPlay, type FileInput, type LiveEventEnvelope, type MapStepBuilder, type MapStepResolver, 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 PlayBindings, type PlayBootstrapEntityKind, type PlayBootstrapFinderKind, type PlayDataset, type PlayDatasetInput, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayRevisionSummary, type PlayRunResult, type PlayRunStart, type PlayStatus, type PlayStepProgramStep, type PrebuiltPlayRef, type PublishPlayVersionRequest, type PublishPlayVersionResult, RateLimitError, type ResolvedConfig, SDK_API_CONTRACT, SDK_VERSION, type StartPlayRunRequest, type StepProgram, type StepProgramResolver, type StepResolver, type ToolDefinition, type ToolExecuteResult, type ToolExecution, type ToolMetadata, defineInput, definePlay, defineWorkflow, extractSummaryFields, formatPlayBootstrapFinderKinds, formatPlayBootstrapFinderKindsForSentence, formatPlayBootstrapTemplates, getDefinedPlayMetadata, isPlayBootstrapFinderKind, isPlayBootstrapTemplate, resolveConfig, steps, tryConvertToList, when, writeCsvOutputFile, writeJsonOutputFile };