deepline 0.1.42 → 0.1.45

package/dist/cli/index.js

@@ -216,8 +216,8 @@ function resolveConfig(options) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.1.42";
-var SDK_API_CONTRACT = "2026-05-play-tool-result-errors";
+var SDK_VERSION = "0.1.45";
+var SDK_API_CONTRACT = "2026-05-promo-redemption-policy";
 
 // ../shared_libs/play-runtime/coordinator-headers.ts
 var COORDINATOR_INTERNAL_TOKEN_HEADER = "x-deepline-internal-token";
@@ -764,7 +764,7 @@ var DeeplineClient = class {
       params.set("search_terms", options.searchTerms.trim());
     }
     return this.http.get(
-      `/api/v2/integrations/list?${params.toString()}`
+      `/api/v2/tools/search?${params.toString()}`
     );
   }
   /**
@@ -9280,33 +9280,9 @@ async function searchTools(queryInput, options = {}) {
     searchMode: options.searchMode,
     includeSearchDebug: options.includeSearchDebug
   });
-  const items = result.tools.filter((tool) => !isPlayLikeTool(tool)).map(toListedTool);
-  const envelope = {
-    ...result,
-    tools: items,
-    count: items.length,
-    omitted_plays_hint: "Use `deepline plays search <query> --json` for prebuilt and org-owned plays.",
-    render: {
-      sections: [
-        {
-          title: `${items.length} tools found:`,
-          lines: items.flatMap((item) => {
-            const cats = item.categories.length ? ` [${item.categories.join(", ")}]` : "";
-            return [
-              `${item.toolId}${cats}`,
-              `  ${item.description}`,
-              ...item.inputSchema ? ["  inputSchema: yes"] : []
-            ];
-          })
-        },
-        {
-          title: "plays",
-          lines: ["For prebuilt or org-owned workflows, run: deepline plays search <query>"]
-        }
-      ]
-    }
-  };
-  printCommandEnvelope(envelope, { json: options.json || shouldEmitJson() });
+  printCommandEnvelope(result, {
+    json: options.json || shouldEmitJson()
+  });
   return 0;
 }
 function playIdentifiers(play) {

package/dist/cli/index.mjs

@@ -193,8 +193,8 @@ function resolveConfig(options) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.1.42";
-var SDK_API_CONTRACT = "2026-05-play-tool-result-errors";
+var SDK_VERSION = "0.1.45";
+var SDK_API_CONTRACT = "2026-05-promo-redemption-policy";
 
 // ../shared_libs/play-runtime/coordinator-headers.ts
 var COORDINATOR_INTERNAL_TOKEN_HEADER = "x-deepline-internal-token";
@@ -741,7 +741,7 @@ var DeeplineClient = class {
       params.set("search_terms", options.searchTerms.trim());
     }
     return this.http.get(
-      `/api/v2/integrations/list?${params.toString()}`
+      `/api/v2/tools/search?${params.toString()}`
     );
   }
   /**
@@ -9267,33 +9267,9 @@ async function searchTools(queryInput, options = {}) {
     searchMode: options.searchMode,
     includeSearchDebug: options.includeSearchDebug
   });
-  const items = result.tools.filter((tool) => !isPlayLikeTool(tool)).map(toListedTool);
-  const envelope = {
-    ...result,
-    tools: items,
-    count: items.length,
-    omitted_plays_hint: "Use `deepline plays search <query> --json` for prebuilt and org-owned plays.",
-    render: {
-      sections: [
-        {
-          title: `${items.length} tools found:`,
-          lines: items.flatMap((item) => {
-            const cats = item.categories.length ? ` [${item.categories.join(", ")}]` : "";
-            return [
-              `${item.toolId}${cats}`,
-              `  ${item.description}`,
-              ...item.inputSchema ? ["  inputSchema: yes"] : []
-            ];
-          })
-        },
-        {
-          title: "plays",
-          lines: ["For prebuilt or org-owned workflows, run: deepline plays search <query>"]
-        }
-      ]
-    }
-  };
-  printCommandEnvelope(envelope, { json: options.json || shouldEmitJson() });
+  printCommandEnvelope(result, {
+    json: options.json || shouldEmitJson()
+  });
   return 0;
 }
 function playIdentifiers(play) {

package/dist/index.d.mts

@@ -318,7 +318,25 @@ interface ToolSearchOptions {
 }
 interface ToolSearchResult {
     tools: ToolDefinition[];
+    count?: number;
+    total?: number;
+    truncated?: boolean;
+    query?: string;
+    categories?: string[];
+    search_terms?: string[];
+    search_mode?: 'v1' | 'v2';
     search_fallback_to_category?: boolean;
+    omitted_plays_hint?: string;
+    render?: {
+        sections?: Array<{
+            title: string;
+            lines: string[];
+        }>;
+        actions?: Array<{
+            label: string;
+            command: string;
+        }>;
+    };
 }
 /**
  * Extended tool metadata including pricing, samples, and failure modes.
@@ -1493,8 +1511,8 @@ declare class DeeplineClient {
     }>;
 }
 
-declare const SDK_VERSION = "0.1.42";
-declare const SDK_API_CONTRACT = "2026-05-play-tool-result-errors";
+declare const SDK_VERSION = "0.1.45";
+declare const SDK_API_CONTRACT = "2026-05-promo-redemption-policy";
 
 /**
  * Base error class for all Deepline SDK errors.
@@ -1700,6 +1718,11 @@ type ToolResultListMetadata = {
     count: number | null;
     keys: Record<string, string>;
 };
+type ToolResultExtractorDescriptor = {
+    paths: readonly string[];
+    transforms?: readonly string[];
+    enum?: readonly string[];
+};
 type ToolResultTargetAccessor<T = unknown> = ToolResultTargetMetadata & {
     get(): T | null;
 };
@@ -1727,6 +1750,7 @@ type ToolExecuteResultBase<TResult = unknown, TMeta = Record<string, unknown>> =
             value: unknown;
             path: string;
         }>;
+        extractors?: Record<string, ToolResultExtractorDescriptor>;
         lists: Record<string, {
             path: string;
             count: number | null;

package/dist/index.d.ts

@@ -318,7 +318,25 @@ interface ToolSearchOptions {
 }
 interface ToolSearchResult {
     tools: ToolDefinition[];
+    count?: number;
+    total?: number;
+    truncated?: boolean;
+    query?: string;
+    categories?: string[];
+    search_terms?: string[];
+    search_mode?: 'v1' | 'v2';
     search_fallback_to_category?: boolean;
+    omitted_plays_hint?: string;
+    render?: {
+        sections?: Array<{
+            title: string;
+            lines: string[];
+        }>;
+        actions?: Array<{
+            label: string;
+            command: string;
+        }>;
+    };
 }
 /**
  * Extended tool metadata including pricing, samples, and failure modes.
@@ -1493,8 +1511,8 @@ declare class DeeplineClient {
     }>;
 }
 
-declare const SDK_VERSION = "0.1.42";
-declare const SDK_API_CONTRACT = "2026-05-play-tool-result-errors";
+declare const SDK_VERSION = "0.1.45";
+declare const SDK_API_CONTRACT = "2026-05-promo-redemption-policy";
 
 /**
  * Base error class for all Deepline SDK errors.
@@ -1700,6 +1718,11 @@ type ToolResultListMetadata = {
     count: number | null;
     keys: Record<string, string>;
 };
+type ToolResultExtractorDescriptor = {
+    paths: readonly string[];
+    transforms?: readonly string[];
+    enum?: readonly string[];
+};
 type ToolResultTargetAccessor<T = unknown> = ToolResultTargetMetadata & {
     get(): T | null;
 };
@@ -1727,6 +1750,7 @@ type ToolExecuteResultBase<TResult = unknown, TMeta = Record<string, unknown>> =
             value: unknown;
             path: string;
         }>;
+        extractors?: Record<string, ToolResultExtractorDescriptor>;
         lists: Record<string, {
             path: string;
             count: number | null;

package/dist/index.js

@@ -215,8 +215,8 @@ function resolveConfig(options) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.1.42";
-var SDK_API_CONTRACT = "2026-05-play-tool-result-errors";
+var SDK_VERSION = "0.1.45";
+var SDK_API_CONTRACT = "2026-05-promo-redemption-policy";
 
 // ../shared_libs/play-runtime/coordinator-headers.ts
 var COORDINATOR_INTERNAL_TOKEN_HEADER = "x-deepline-internal-token";
@@ -763,7 +763,7 @@ var DeeplineClient = class {
       params.set("search_terms", options.searchTerms.trim());
     }
     return this.http.get(
-      `/api/v2/integrations/list?${params.toString()}`
+      `/api/v2/tools/search?${params.toString()}`
     );
   }
   /**
@@ -1736,6 +1736,16 @@ function getAtPath(root, path) {
   }
   return current;
 }
+function normalizeString(value) {
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    return trimmed ? trimmed : null;
+  }
+  if (typeof value === "number" && Number.isFinite(value)) {
+    return String(value);
+  }
+  return null;
+}
 function normalizeRows(value) {
   if (!Array.isArray(value)) return null;
   return value.map((entry) => isRecord2(entry) ? entry : { value: entry });
@@ -1779,14 +1789,49 @@ function findFirstTargetByKey(result, target, depth = 0, path = []) {
   }
   return null;
 }
+function normalizeEmailStatus(value) {
+  const normalized = normalizeString(value)?.toLowerCase().replace(/[\s-]+/g, "_");
+  if (!normalized) return "unknown";
+  if (["deliverable", "verified", "ok", "true"].includes(normalized))
+    return "valid";
+  if (["undeliverable", "bad", "false", "failed"].includes(normalized))
+    return "invalid";
+  if (["accept_all", "acceptall", "catchall", "valid_catch_all"].includes(
+    normalized
+  )) {
+    return "catch_all";
+  }
+  return normalized;
+}
+function normalizePhoneStatus(value) {
+  if (typeof value === "boolean") return value ? "valid" : "invalid";
+  const normalized = normalizeString(value)?.toLowerCase().replace(/[\s-]+/g, "_");
+  if (!normalized) return "unknown";
+  if (["verified", "ok", "true", "active"].includes(normalized)) return "valid";
+  if (["bad", "false", "failed", "inactive", "disconnected"].includes(normalized)) {
+    return "invalid";
+  }
+  return normalized;
+}
+function applyExtractorTransforms(value, descriptor) {
+  return (descriptor.transforms ?? []).reduce((current, transform) => {
+    if (transform.endsWith("emailStatus")) return normalizeEmailStatus(current);
+    if (transform.endsWith("phoneStatus")) return normalizePhoneStatus(current);
+    return current;
+  }, value);
+}
+function coerceToEnum(value, descriptor) {
+  if (!descriptor.enum?.length) return value;
+  const normalized = normalizeString(value);
+  if (!normalized) return value;
+  return descriptor.enum.includes(normalized) ? normalized : value;
+}
 function resolveListRows(result, listExtractorPaths) {
   const lists = {};
   for (const rawPath of listExtractorPaths ?? []) {
     const path = normalizeResultPath(rawPath);
     if (!path) continue;
-    const candidates = [
-      ...candidateResultPaths(rawPath)
-    ].filter(
+    const candidates = [...candidateResultPaths(rawPath)].filter(
       (candidate, index, all) => candidate && all.indexOf(candidate) === index
     );
     let resolvedPath = null;
@@ -1810,9 +1855,7 @@ function deriveListKeys(input) {
   for (const [target, paths] of Object.entries(
     input.listIdentityGetters ?? {}
   )) {
-    const firstPath = paths.map(
-      (rawPath) => normalizeRelativePath(rawPath)
-    ).find(Boolean);
+    const firstPath = paths.map((rawPath) => normalizeRelativePath(rawPath)).find(Boolean);
     if (firstPath) {
       keys[target] = firstPath;
     }
@@ -1822,7 +1865,7 @@ function deriveListKeys(input) {
   }
   const listPrefix = input.listPath.replace(/\[\d+\]$/, "");
   for (const [target, paths] of Object.entries(
-    input.resultIdentityGetters ?? {}
+    input.targetGetters ?? {}
   )) {
     for (const rawPath of paths) {
       const path = String(rawPath || "").trim().replace(/^\./, "");
@@ -1859,13 +1902,25 @@ function deriveListKeys(input) {
   }
   return keys;
 }
-function buildTargets(result, resultIdentityGetters) {
+function buildTargets(result, extractors, targetGetters) {
   const targets = {};
-  const metadataTargets = new Set(Object.keys(resultIdentityGetters ?? {}));
+  for (const [target, descriptor] of Object.entries(extractors ?? {})) {
+    const fromExtractor = findFirstTargetByPath(result, descriptor.paths);
+    if (!fromExtractor) continue;
+    targets[target] = {
+      path: fromExtractor.path,
+      value: coerceToEnum(
+        applyExtractorTransforms(fromExtractor.value, descriptor),
+        descriptor
+      )
+    };
+  }
+  const metadataTargets = new Set(Object.keys(targetGetters ?? {}));
   for (const target of metadataTargets) {
+    if (targets[target]) continue;
     const fromMetadata = findFirstTargetByPath(
       result,
-      resultIdentityGetters?.[target]
+      targetGetters?.[target]
     );
     if (fromMetadata) {
       targets[target] = fromMetadata;
@@ -1892,7 +1947,7 @@ function buildLists(resolved, metadata) {
       keys: deriveListKeys({
         listPath: list.path,
         rows: list.rows,
-        resultIdentityGetters: metadata.resultIdentityGetters,
+        targetGetters: metadata.targetGetters,
         listIdentityGetters: metadata.listIdentityGetters
       })
     };
@@ -1948,7 +2003,8 @@ function createToolExecuteResult(input) {
   };
   const targets = buildTargets(
     resultRoot,
-    input.metadata.resultIdentityGetters
+    input.metadata.extractors,
+    input.metadata.targetGetters
   );
   const resolvedLists = resolveListRows(
     resultRoot,
@@ -1959,6 +2015,7 @@ function createToolExecuteResult(input) {
     toolId: input.metadata.toolId,
     execution: input.execution,
     targets,
+    ...input.metadata.extractors ? { extractors: input.metadata.extractors } : {},
     lists
   };
   const toolResponse = {
@@ -2254,6 +2311,28 @@ function stringArrayRecord(value) {
 function stringArray(value) {
   return Array.isArray(value) ? value.map(String) : [];
 }
+function extractorDescriptorRecord(value) {
+  if (!isRecord3(value)) return {};
+  return Object.fromEntries(
+    Object.entries(value).flatMap(([key, descriptor]) => {
+      if (!isRecord3(descriptor)) return [];
+      const paths = stringArray(descriptor.paths).map((path) => path.trim()).filter(Boolean);
+      if (paths.length === 0) return [];
+      const transforms = stringArray(descriptor.transforms).map((transform) => transform.trim()).filter(Boolean);
+      const enumValues = stringArray(descriptor.enum).map((entry) => entry.trim()).filter(Boolean);
+      return [
+        [
+          key,
+          {
+            paths,
+            ...transforms.length > 0 ? { transforms } : {},
+            ...enumValues.length > 0 ? { enum: enumValues } : {}
+          }
+        ]
+      ];
+    })
+  );
+}
 function toolExecutionEnvelopeToResult(fallbackToolId, response) {
   const raw = response.toolResponse?.raw ?? null;
   const meta = response.toolResponse?.meta;
@@ -2268,8 +2347,9 @@ function toolExecutionEnvelopeToResult(fallbackToolId, response) {
     },
     metadata: {
       toolId: typeof toolMetadata.toolId === "string" ? toolMetadata.toolId : fallbackToolId,
-      resultIdentityGetters: stringArrayRecord(
-        toolMetadata.resultIdentityGetters
+      extractors: extractorDescriptorRecord(toolMetadata.extractors),
+      targetGetters: stringArrayRecord(
+        toolMetadata.targetGetters
       ),
       listExtractorPaths: stringArray(toolMetadata.listExtractorPaths),
       listIdentityGetters: stringArrayRecord(toolMetadata.listIdentityGetters)

package/dist/index.mjs

@@ -169,8 +169,8 @@ function resolveConfig(options) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.1.42";
-var SDK_API_CONTRACT = "2026-05-play-tool-result-errors";
+var SDK_VERSION = "0.1.45";
+var SDK_API_CONTRACT = "2026-05-promo-redemption-policy";
 
 // ../shared_libs/play-runtime/coordinator-headers.ts
 var COORDINATOR_INTERNAL_TOKEN_HEADER = "x-deepline-internal-token";
@@ -717,7 +717,7 @@ var DeeplineClient = class {
       params.set("search_terms", options.searchTerms.trim());
     }
     return this.http.get(
-      `/api/v2/integrations/list?${params.toString()}`
+      `/api/v2/tools/search?${params.toString()}`
     );
   }
   /**
@@ -1690,6 +1690,16 @@ function getAtPath(root, path) {
   }
   return current;
 }
+function normalizeString(value) {
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    return trimmed ? trimmed : null;
+  }
+  if (typeof value === "number" && Number.isFinite(value)) {
+    return String(value);
+  }
+  return null;
+}
 function normalizeRows(value) {
   if (!Array.isArray(value)) return null;
   return value.map((entry) => isRecord2(entry) ? entry : { value: entry });
@@ -1733,14 +1743,49 @@ function findFirstTargetByKey(result, target, depth = 0, path = []) {
   }
   return null;
 }
+function normalizeEmailStatus(value) {
+  const normalized = normalizeString(value)?.toLowerCase().replace(/[\s-]+/g, "_");
+  if (!normalized) return "unknown";
+  if (["deliverable", "verified", "ok", "true"].includes(normalized))
+    return "valid";
+  if (["undeliverable", "bad", "false", "failed"].includes(normalized))
+    return "invalid";
+  if (["accept_all", "acceptall", "catchall", "valid_catch_all"].includes(
+    normalized
+  )) {
+    return "catch_all";
+  }
+  return normalized;
+}
+function normalizePhoneStatus(value) {
+  if (typeof value === "boolean") return value ? "valid" : "invalid";
+  const normalized = normalizeString(value)?.toLowerCase().replace(/[\s-]+/g, "_");
+  if (!normalized) return "unknown";
+  if (["verified", "ok", "true", "active"].includes(normalized)) return "valid";
+  if (["bad", "false", "failed", "inactive", "disconnected"].includes(normalized)) {
+    return "invalid";
+  }
+  return normalized;
+}
+function applyExtractorTransforms(value, descriptor) {
+  return (descriptor.transforms ?? []).reduce((current, transform) => {
+    if (transform.endsWith("emailStatus")) return normalizeEmailStatus(current);
+    if (transform.endsWith("phoneStatus")) return normalizePhoneStatus(current);
+    return current;
+  }, value);
+}
+function coerceToEnum(value, descriptor) {
+  if (!descriptor.enum?.length) return value;
+  const normalized = normalizeString(value);
+  if (!normalized) return value;
+  return descriptor.enum.includes(normalized) ? normalized : value;
+}
 function resolveListRows(result, listExtractorPaths) {
   const lists = {};
   for (const rawPath of listExtractorPaths ?? []) {
     const path = normalizeResultPath(rawPath);
     if (!path) continue;
-    const candidates = [
-      ...candidateResultPaths(rawPath)
-    ].filter(
+    const candidates = [...candidateResultPaths(rawPath)].filter(
       (candidate, index, all) => candidate && all.indexOf(candidate) === index
     );
     let resolvedPath = null;
@@ -1764,9 +1809,7 @@ function deriveListKeys(input) {
   for (const [target, paths] of Object.entries(
     input.listIdentityGetters ?? {}
   )) {
-    const firstPath = paths.map(
-      (rawPath) => normalizeRelativePath(rawPath)
-    ).find(Boolean);
+    const firstPath = paths.map((rawPath) => normalizeRelativePath(rawPath)).find(Boolean);
     if (firstPath) {
       keys[target] = firstPath;
     }
@@ -1776,7 +1819,7 @@ function deriveListKeys(input) {
   }
   const listPrefix = input.listPath.replace(/\[\d+\]$/, "");
   for (const [target, paths] of Object.entries(
-    input.resultIdentityGetters ?? {}
+    input.targetGetters ?? {}
   )) {
     for (const rawPath of paths) {
       const path = String(rawPath || "").trim().replace(/^\./, "");
@@ -1813,13 +1856,25 @@ function deriveListKeys(input) {
   }
   return keys;
 }
-function buildTargets(result, resultIdentityGetters) {
+function buildTargets(result, extractors, targetGetters) {
   const targets = {};
-  const metadataTargets = new Set(Object.keys(resultIdentityGetters ?? {}));
+  for (const [target, descriptor] of Object.entries(extractors ?? {})) {
+    const fromExtractor = findFirstTargetByPath(result, descriptor.paths);
+    if (!fromExtractor) continue;
+    targets[target] = {
+      path: fromExtractor.path,
+      value: coerceToEnum(
+        applyExtractorTransforms(fromExtractor.value, descriptor),
+        descriptor
+      )
+    };
+  }
+  const metadataTargets = new Set(Object.keys(targetGetters ?? {}));
   for (const target of metadataTargets) {
+    if (targets[target]) continue;
     const fromMetadata = findFirstTargetByPath(
       result,
-      resultIdentityGetters?.[target]
+      targetGetters?.[target]
     );
     if (fromMetadata) {
       targets[target] = fromMetadata;
@@ -1846,7 +1901,7 @@ function buildLists(resolved, metadata) {
       keys: deriveListKeys({
         listPath: list.path,
         rows: list.rows,
-        resultIdentityGetters: metadata.resultIdentityGetters,
+        targetGetters: metadata.targetGetters,
         listIdentityGetters: metadata.listIdentityGetters
       })
     };
@@ -1902,7 +1957,8 @@ function createToolExecuteResult(input) {
   };
   const targets = buildTargets(
     resultRoot,
-    input.metadata.resultIdentityGetters
+    input.metadata.extractors,
+    input.metadata.targetGetters
   );
   const resolvedLists = resolveListRows(
     resultRoot,
@@ -1913,6 +1969,7 @@ function createToolExecuteResult(input) {
     toolId: input.metadata.toolId,
     execution: input.execution,
     targets,
+    ...input.metadata.extractors ? { extractors: input.metadata.extractors } : {},
     lists
   };
   const toolResponse = {
@@ -2208,6 +2265,28 @@ function stringArrayRecord(value) {
 function stringArray(value) {
   return Array.isArray(value) ? value.map(String) : [];
 }
+function extractorDescriptorRecord(value) {
+  if (!isRecord3(value)) return {};
+  return Object.fromEntries(
+    Object.entries(value).flatMap(([key, descriptor]) => {
+      if (!isRecord3(descriptor)) return [];
+      const paths = stringArray(descriptor.paths).map((path) => path.trim()).filter(Boolean);
+      if (paths.length === 0) return [];
+      const transforms = stringArray(descriptor.transforms).map((transform) => transform.trim()).filter(Boolean);
+      const enumValues = stringArray(descriptor.enum).map((entry) => entry.trim()).filter(Boolean);
+      return [
+        [
+          key,
+          {
+            paths,
+            ...transforms.length > 0 ? { transforms } : {},
+            ...enumValues.length > 0 ? { enum: enumValues } : {}
+          }
+        ]
+      ];
+    })
+  );
+}
 function toolExecutionEnvelopeToResult(fallbackToolId, response) {
   const raw = response.toolResponse?.raw ?? null;
   const meta = response.toolResponse?.meta;
@@ -2222,8 +2301,9 @@ function toolExecutionEnvelopeToResult(fallbackToolId, response) {
     },
     metadata: {
       toolId: typeof toolMetadata.toolId === "string" ? toolMetadata.toolId : fallbackToolId,
-      resultIdentityGetters: stringArrayRecord(
-        toolMetadata.resultIdentityGetters
+      extractors: extractorDescriptorRecord(toolMetadata.extractors),
+      targetGetters: stringArrayRecord(
+        toolMetadata.targetGetters
       ),
       listExtractorPaths: stringArray(toolMetadata.listExtractorPaths),
       listIdentityGetters: stringArrayRecord(toolMetadata.listIdentityGetters)

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

@@ -1314,12 +1314,44 @@ function parseExecuteToolMetadata(
       : toolId;
   return {
     toolId: metadataToolId,
-    resultIdentityGetters: parseGetterMetadata(record.resultIdentityGetters),
+    extractors: parseExtractorMetadata(record.extractors),
+    targetGetters: parseGetterMetadata(record.targetGetters),
     listExtractorPaths: parseStringArray(record.listExtractorPaths),
     listIdentityGetters: parseGetterMetadata(record.listIdentityGetters),
   };
 }
 
+function parseExtractorMetadata(
+  value: unknown,
+): ToolResultMetadataInput['extractors'] {
+  if (!value || typeof value !== 'object' || Array.isArray(value)) {
+    return undefined;
+  }
+  const entries = Object.entries(value as Record<string, unknown>).flatMap(
+    ([key, descriptor]) => {
+      if (!descriptor || typeof descriptor !== 'object' || Array.isArray(descriptor)) {
+        return [];
+      }
+      const record = descriptor as Record<string, unknown>;
+      const paths = parseStringArray(record.paths);
+      if (paths.length === 0) return [];
+      const transforms = parseStringArray(record.transforms);
+      const enumValues = parseStringArray(record.enum);
+      return [
+        [
+          key,
+          {
+            paths,
+            ...(transforms.length > 0 ? { transforms } : {}),
+            ...(enumValues.length > 0 ? { enum: enumValues } : {}),
+          },
+        ],
+      ] as const;
+    },
+  );
+  return entries.length > 0 ? Object.fromEntries(entries) : undefined;
+}
+
 function parseGetterMetadata(
   value: unknown,
 ): Record<string, readonly string[]> | undefined {
@@ -1345,7 +1377,7 @@ function syntheticToolMetadata(toolId: string): ToolResultMetadataInput {
   if (toolId === 'test_rate_limit') {
     return {
       toolId,
-      resultIdentityGetters: {
+      targetGetters: {
         email: ['email', 'value'],
       },
     };

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

@@ -522,7 +522,7 @@ export class DeeplineClient {
       params.set('search_terms', options.searchTerms.trim());
     }
     return this.http.get<ToolSearchResult>(
-      `/api/v2/integrations/list?${params.toString()}`,
+      `/api/v2/tools/search?${params.toString()}`,
     );
   }
 

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

@@ -77,7 +77,10 @@ import type {
   PlayDataset,
   PlayDatasetInput,
 } from '../../shared_libs/plays/dataset.js';
-import type { ToolExecuteResult } from '../../shared_libs/play-runtime/tool-result-types.js';
+import type {
+  ToolExecuteResult,
+  ToolResultMetadataInput,
+} from '../../shared_libs/play-runtime/tool-result-types.js';
 import type {
   DeeplineClientOptions,
   PlayDetail,
@@ -1092,6 +1095,37 @@ function stringArray(value: unknown): string[] {
   return Array.isArray(value) ? value.map(String) : [];
 }
 
+function extractorDescriptorRecord(
+  value: unknown,
+): ToolResultMetadataInput['extractors'] {
+  if (!isRecord(value)) return {};
+  return Object.fromEntries(
+    Object.entries(value).flatMap(([key, descriptor]) => {
+      if (!isRecord(descriptor)) return [];
+      const paths = stringArray(descriptor.paths)
+        .map((path) => path.trim())
+        .filter(Boolean);
+      if (paths.length === 0) return [];
+      const transforms = stringArray(descriptor.transforms)
+        .map((transform) => transform.trim())
+        .filter(Boolean);
+      const enumValues = stringArray(descriptor.enum)
+        .map((entry) => entry.trim())
+        .filter(Boolean);
+      return [
+        [
+          key,
+          {
+            paths,
+            ...(transforms.length > 0 ? { transforms } : {}),
+            ...(enumValues.length > 0 ? { enum: enumValues } : {}),
+          },
+        ],
+      ];
+    }),
+  );
+}
+
 function toolExecutionEnvelopeToResult(
   fallbackToolId: string,
   response: ToolExecution,
@@ -1115,8 +1149,9 @@ function toolExecutionEnvelopeToResult(
         typeof toolMetadata.toolId === 'string'
           ? toolMetadata.toolId
           : fallbackToolId,
-      resultIdentityGetters: stringArrayRecord(
-        toolMetadata.resultIdentityGetters,
+      extractors: extractorDescriptorRecord(toolMetadata.extractors),
+      targetGetters: stringArrayRecord(
+        toolMetadata.targetGetters,
       ),
       listExtractorPaths: stringArray(toolMetadata.listExtractorPaths),
       listIdentityGetters: stringArrayRecord(toolMetadata.listIdentityGetters),

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

@@ -168,7 +168,25 @@ export interface ToolSearchOptions {
 
 export interface ToolSearchResult {
   tools: ToolDefinition[];
+  count?: number;
+  total?: number;
+  truncated?: boolean;
+  query?: string;
+  categories?: string[];
+  search_terms?: string[];
+  search_mode?: 'v1' | 'v2';
   search_fallback_to_category?: boolean;
+  omitted_plays_hint?: string;
+  render?: {
+    sections?: Array<{
+      title: string;
+      lines: string[];
+    }>;
+    actions?: Array<{
+      label: string;
+      command: string;
+    }>;
+  };
 }
 
 /**

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

@@ -1,2 +1,2 @@
-export const SDK_VERSION = "0.1.42";
-export const SDK_API_CONTRACT = "2026-05-play-tool-result-errors";
+export const SDK_VERSION = "0.1.45";
+export const SDK_API_CONTRACT = "2026-05-promo-redemption-policy";

package/dist/repo/shared_libs/play-runtime/tool-result.ts

@@ -14,6 +14,7 @@ import type {
   SerializedToolExecuteResult,
   ToolExecuteResult,
   ToolResultExecutionMetadata,
+  ToolResultExtractorDescriptor,
   ToolResultListAccessor,
   ToolResultListMetadata,
   ToolResultEnvelope,
@@ -95,9 +96,7 @@ export function toV2RawToolOutputPath(path: string): string {
     .replace(/^result\.?/, '')
     .replace(/^data\.?/, '')
     .replace(/^\./, '');
-  return rawPath
-    ? `toolResponse.raw.${rawPath}`
-    : 'toolResponse.raw';
+  return rawPath ? `toolResponse.raw.${rawPath}` : 'toolResponse.raw';
 }
 
 function isMeaningfulValue(value: unknown): boolean {
@@ -199,12 +198,8 @@ function toV2RawToolOutputPathPreservingProviderData(path: string): string {
   ) {
     return normalized;
   }
-  const rawPath = normalized
-    .replace(/^result\.?/, '')
-    .replace(/^\./, '');
-  return rawPath
-    ? `toolResponse.raw.${rawPath}`
-    : 'toolResponse.raw';
+  const rawPath = normalized.replace(/^result\.?/, '').replace(/^\./, '');
+  return rawPath ? `toolResponse.raw.${rawPath}` : 'toolResponse.raw';
 }
 
 function candidateResultPaths(path: string): string[] {
@@ -324,6 +319,61 @@ function findFirstTargetByKey(
   return null;
 }
 
+function normalizeEmailStatus(value: unknown): unknown {
+  const normalized = normalizeString(value)
+    ?.toLowerCase()
+    .replace(/[\s-]+/g, '_');
+  if (!normalized) return 'unknown';
+  if (['deliverable', 'verified', 'ok', 'true'].includes(normalized))
+    return 'valid';
+  if (['undeliverable', 'bad', 'false', 'failed'].includes(normalized))
+    return 'invalid';
+  if (
+    ['accept_all', 'acceptall', 'catchall', 'valid_catch_all'].includes(
+      normalized,
+    )
+  ) {
+    return 'catch_all';
+  }
+  return normalized;
+}
+
+function normalizePhoneStatus(value: unknown): unknown {
+  if (typeof value === 'boolean') return value ? 'valid' : 'invalid';
+  const normalized = normalizeString(value)
+    ?.toLowerCase()
+    .replace(/[\s-]+/g, '_');
+  if (!normalized) return 'unknown';
+  if (['verified', 'ok', 'true', 'active'].includes(normalized)) return 'valid';
+  if (
+    ['bad', 'false', 'failed', 'inactive', 'disconnected'].includes(normalized)
+  ) {
+    return 'invalid';
+  }
+  return normalized;
+}
+
+function applyExtractorTransforms(
+  value: unknown,
+  descriptor: ToolResultExtractorDescriptor,
+): unknown {
+  return (descriptor.transforms ?? []).reduce((current, transform) => {
+    if (transform.endsWith('emailStatus')) return normalizeEmailStatus(current);
+    if (transform.endsWith('phoneStatus')) return normalizePhoneStatus(current);
+    return current;
+  }, value);
+}
+
+function coerceToEnum(
+  value: unknown,
+  descriptor: ToolResultExtractorDescriptor,
+): unknown {
+  if (!descriptor.enum?.length) return value;
+  const normalized = normalizeString(value);
+  if (!normalized) return value;
+  return descriptor.enum.includes(normalized) ? normalized : value;
+}
+
 function resolveListRows(
   result: unknown,
   listExtractorPaths: readonly string[] | undefined,
@@ -335,11 +385,8 @@ function resolveListRows(
   for (const rawPath of listExtractorPaths ?? []) {
     const path = normalizeResultPath(rawPath);
     if (!path) continue;
-    const candidates = [
-      ...candidateResultPaths(rawPath),
-    ].filter(
-      (candidate, index, all) =>
-        candidate && all.indexOf(candidate) === index,
+    const candidates = [...candidateResultPaths(rawPath)].filter(
+      (candidate, index, all) => candidate && all.indexOf(candidate) === index,
     );
     let resolvedPath: string | null = null;
     let rows: Record<string, unknown>[] | null = null;
@@ -365,7 +412,7 @@ function resolveListRows(
 function deriveListKeys(input: {
   listPath: string;
   rows: readonly Record<string, unknown>[];
-  resultIdentityGetters?: Record<string, readonly string[]>;
+  targetGetters?: Record<string, readonly string[]>;
   listIdentityGetters?: Record<string, readonly string[]>;
 }): Record<string, string> {
   const keys: Record<string, string> = {};
@@ -373,9 +420,7 @@ function deriveListKeys(input: {
     input.listIdentityGetters ?? {},
   )) {
     const firstPath = paths
-      .map((rawPath) =>
-        normalizeRelativePath(rawPath),
-      )
+      .map((rawPath) => normalizeRelativePath(rawPath))
       .find(Boolean);
     if (firstPath) {
       keys[target] = firstPath;
@@ -387,7 +432,7 @@ function deriveListKeys(input: {
 
   const listPrefix = input.listPath.replace(/\[\d+\]$/, '');
   for (const [target, paths] of Object.entries(
-    input.resultIdentityGetters ?? {},
+    input.targetGetters ?? {},
   )) {
     for (const rawPath of paths) {
       const path = String(rawPath || '')
@@ -431,14 +476,27 @@ function deriveListKeys(input: {
 
 function buildTargets(
   result: unknown,
-  resultIdentityGetters?: Record<string, readonly string[]>,
+  extractors?: Record<string, ToolResultExtractorDescriptor>,
+  targetGetters?: Record<string, readonly string[]>,
 ): Record<string, ToolResultTargetMetadata> {
   const targets: Record<string, ToolResultTargetMetadata> = {};
-  const metadataTargets = new Set(Object.keys(resultIdentityGetters ?? {}));
+  for (const [target, descriptor] of Object.entries(extractors ?? {})) {
+    const fromExtractor = findFirstTargetByPath(result, descriptor.paths);
+    if (!fromExtractor) continue;
+    targets[target] = {
+      path: fromExtractor.path,
+      value: coerceToEnum(
+        applyExtractorTransforms(fromExtractor.value, descriptor),
+        descriptor,
+      ),
+    };
+  }
+  const metadataTargets = new Set(Object.keys(targetGetters ?? {}));
   for (const target of metadataTargets) {
+    if (targets[target]) continue;
     const fromMetadata = findFirstTargetByPath(
       result,
-      resultIdentityGetters?.[target],
+      targetGetters?.[target],
     );
     if (fromMetadata) {
       targets[target] = fromMetadata;
@@ -470,7 +528,7 @@ function buildLists(
       keys: deriveListKeys({
         listPath: list.path,
         rows: list.rows,
-        resultIdentityGetters: metadata.resultIdentityGetters,
+        targetGetters: metadata.targetGetters,
         listIdentityGetters: metadata.listIdentityGetters,
       }),
     };
@@ -541,7 +599,8 @@ export function createToolExecuteResult<TResult = unknown>(input: {
   };
   const targets = buildTargets(
     resultRoot,
-    input.metadata.resultIdentityGetters,
+    input.metadata.extractors,
+    input.metadata.targetGetters,
   );
   const resolvedLists = resolveListRows(
     resultRoot,
@@ -552,6 +611,9 @@ export function createToolExecuteResult<TResult = unknown>(input: {
     toolId: input.metadata.toolId,
     execution: input.execution,
     targets,
+    ...(input.metadata.extractors
+      ? { extractors: input.metadata.extractors }
+      : {}),
     lists,
   };
   const toolResponse = {
@@ -599,7 +661,10 @@ function metadataInputFromToolExecuteResult(
 ): ToolResultMetadataInput {
   return {
     toolId: value._metadata.toolId,
-    resultIdentityGetters: Object.fromEntries(
+    ...(value._metadata.extractors
+      ? { extractors: value._metadata.extractors }
+      : {}),
+    targetGetters: Object.fromEntries(
       Object.entries(value._metadata.targets).map(([target, info]) => [
         target,
         [info.path],

package/package.json

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