deepline 0.1.41 → 0.1.45

package/dist/index.js

@@ -215,8 +215,8 @@ function resolveConfig(options) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.1.41";
-var SDK_API_CONTRACT = "2026-05-cloud-play-search";
+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;
@@ -1883,9 +1938,8 @@ function buildTargets(result, resultIdentityGetters) {
   }
   return targets;
 }
-function buildLists(result, metadata) {
+function buildLists(resolved, metadata) {
   const lists = {};
-  const resolved = resolveListRows(result, metadata.listExtractorPaths);
   for (const [name, list] of Object.entries(resolved)) {
     lists[name] = {
       path: list.path,
@@ -1893,7 +1947,7 @@ function buildLists(result, metadata) {
       keys: deriveListKeys({
         listPath: list.path,
         rows: list.rows,
-        resultIdentityGetters: metadata.resultIdentityGetters,
+        targetGetters: metadata.targetGetters,
         listIdentityGetters: metadata.listIdentityGetters
       })
     };
@@ -1920,9 +1974,10 @@ function buildExtractedAccessors(targets) {
     })
   );
 }
-function buildListAccessors(result, lists) {
+function buildListAccessors(resolved, lists) {
   return Object.fromEntries(
     Object.entries(lists).map(([name, metadata]) => {
+      const rows = resolved[name]?.rows ?? [];
       const accessor = {
         path: metadata.path,
         count: metadata.count,
@@ -1930,7 +1985,7 @@ function buildListAccessors(result, lists) {
       };
       Object.defineProperty(accessor, "get", {
         value() {
-          return normalizeRows(getAtPath(result, metadata.path)) ?? [];
+          return rows;
         },
         enumerable: false
       });
@@ -1948,13 +2003,19 @@ function createToolExecuteResult(input) {
   };
   const targets = buildTargets(
     resultRoot,
-    input.metadata.resultIdentityGetters
+    input.metadata.extractors,
+    input.metadata.targetGetters
   );
-  const lists = buildLists(resultRoot, input.metadata);
+  const resolvedLists = resolveListRows(
+    resultRoot,
+    input.metadata.listExtractorPaths
+  );
+  const lists = buildLists(resolvedLists, input.metadata);
   const metadata = {
     toolId: input.metadata.toolId,
     execution: input.execution,
     targets,
+    ...input.metadata.extractors ? { extractors: input.metadata.extractors } : {},
     lists
   };
   const toolResponse = {
@@ -1962,7 +2023,7 @@ function createToolExecuteResult(input) {
     ...result.meta ? { meta: result.meta } : {}
   };
   const extractedValues = buildExtractedAccessors(targets);
-  const extractedLists = buildListAccessors(resultRoot, lists);
+  const extractedLists = buildListAccessors(resolvedLists, lists);
   const wrapper = {
     status: input.status,
     ...input.jobId ? { job_id: input.jobId } : {},
@@ -2250,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;
@@ -2264,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.41";
-var SDK_API_CONTRACT = "2026-05-cloud-play-search";
+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;
@@ -1837,9 +1892,8 @@ function buildTargets(result, resultIdentityGetters) {
   }
   return targets;
 }
-function buildLists(result, metadata) {
+function buildLists(resolved, metadata) {
   const lists = {};
-  const resolved = resolveListRows(result, metadata.listExtractorPaths);
   for (const [name, list] of Object.entries(resolved)) {
     lists[name] = {
       path: list.path,
@@ -1847,7 +1901,7 @@ function buildLists(result, metadata) {
       keys: deriveListKeys({
         listPath: list.path,
         rows: list.rows,
-        resultIdentityGetters: metadata.resultIdentityGetters,
+        targetGetters: metadata.targetGetters,
         listIdentityGetters: metadata.listIdentityGetters
       })
     };
@@ -1874,9 +1928,10 @@ function buildExtractedAccessors(targets) {
     })
   );
 }
-function buildListAccessors(result, lists) {
+function buildListAccessors(resolved, lists) {
   return Object.fromEntries(
     Object.entries(lists).map(([name, metadata]) => {
+      const rows = resolved[name]?.rows ?? [];
       const accessor = {
         path: metadata.path,
         count: metadata.count,
@@ -1884,7 +1939,7 @@ function buildListAccessors(result, lists) {
       };
       Object.defineProperty(accessor, "get", {
         value() {
-          return normalizeRows(getAtPath(result, metadata.path)) ?? [];
+          return rows;
         },
         enumerable: false
       });
@@ -1902,13 +1957,19 @@ function createToolExecuteResult(input) {
   };
   const targets = buildTargets(
     resultRoot,
-    input.metadata.resultIdentityGetters
+    input.metadata.extractors,
+    input.metadata.targetGetters
   );
-  const lists = buildLists(resultRoot, input.metadata);
+  const resolvedLists = resolveListRows(
+    resultRoot,
+    input.metadata.listExtractorPaths
+  );
+  const lists = buildLists(resolvedLists, input.metadata);
   const metadata = {
     toolId: input.metadata.toolId,
     execution: input.execution,
     targets,
+    ...input.metadata.extractors ? { extractors: input.metadata.extractors } : {},
     lists
   };
   const toolResponse = {
@@ -1916,7 +1977,7 @@ function createToolExecuteResult(input) {
     ...result.meta ? { meta: result.meta } : {}
   };
   const extractedValues = buildExtractedAccessors(targets);
-  const extractedLists = buildListAccessors(resultRoot, lists);
+  const extractedLists = buildListAccessors(resolvedLists, lists);
   const wrapper = {
     status: input.status,
     ...input.jobId ? { job_id: input.jobId } : {},
@@ -2204,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;
@@ -2218,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)