deepline 0.3.463 → 0.3.464

package/dist/cli/{chunk-5LEAXRHV.js → chunk-6P4OYABU.js}

@@ -15,180 +15,8 @@ var _chunkJ33TSWO5js = require('./chunk-J33TSWO5.js');
 
 
 
-var _chunkNA4T3B62js = require('./chunk-NA4T3B62.js');
 
-// ../plays/field-catalog.ts
-var value = (description) => ({ type: "string", description });
-var SOURCE = {
-  type: "string",
-  description: "The provider or step that found it."
-};
-var FIELD_CATALOG = {
-  person: {
-    name: {
-      description: "The person's name.",
-      leaves: {
-        value: value("Full name."),
-        first: value("First (given) name."),
-        last: value("Last (family) name.")
-      }
-    },
-    email: {
-      description: "An email address for the person.",
-      leaves: {
-        value: value("The address."),
-        validated: {
-          type: "boolean",
-          description: "Whether the address passed validation."
-        },
-        status: {
-          type: "EmailStatus",
-          description: "The validation verdict and its signals."
-        },
-        source: SOURCE
-      },
-      kinds: {
-        work: "At their employer.",
-        personal: "Their own, not tied to an employer."
-      }
-    },
-    phone: {
-      description: "A phone number for the person.",
-      leaves: {
-        value: value("The number."),
-        validated: {
-          type: "boolean",
-          description: "Whether the number passed validation."
-        },
-        status: {
-          type: '"valid" | "invalid" | "unknown"',
-          description: "The validation verdict."
-        },
-        line_type: value("Mobile, landline, VoIP and so on."),
-        carrier: value("The carrier serving the number."),
-        source: SOURCE
-      },
-      kinds: {
-        mobile: "Their mobile.",
-        work: "A direct line at their employer."
-      }
-    },
-    linkedin: {
-      description: "The person's LinkedIn profile.",
-      leaves: { url: value("The profile URL.") }
-    },
-    job: {
-      description: "The person's current role.",
-      leaves: {
-        title: value("Job title."),
-        change: {
-          type: "JobChange",
-          description: "Whether they changed jobs, and to what."
-        },
-        change_status: {
-          type: "JobChangeStatus",
-          description: "The job-change verdict alone."
-        }
-      }
-    },
-    record: {
-      description: "A provider's own record of the person.",
-      leaves: { id: value("The provider's id for the person.") }
-    }
-  },
-  company: {
-    name: {
-      description: "The company's name.",
-      leaves: { value: value("The name.") },
-      kinds: { legal: "As registered with a government." }
-    },
-    domain: {
-      description: "The company's web domain.",
-      leaves: { value: value("The bare domain, such as example.com.") }
-    },
-    website: {
-      description: "The company's website.",
-      leaves: { url: value("The site URL.") }
-    },
-    linkedin: {
-      description: "The company's LinkedIn page.",
-      leaves: { url: value("The page URL.") }
-    },
-    phone: {
-      description: "A phone number for the company.",
-      leaves: { value: value("The number.") }
-    },
-    industry: {
-      description: "The industry the company is in.",
-      leaves: { value: value("The industry.") }
-    },
-    record: {
-      description: "A provider's own record of the company.",
-      leaves: { id: value("The provider's id for the company.") }
-    }
-  }
-};
-function catalogFields() {
-  return Object.entries(FIELD_CATALOG).flatMap(
-    ([entity, groups]) => Object.entries(groups).flatMap(
-      ([group, definition]) => [void 0, ...Object.keys(_nullishCoalesce(definition.kinds, () => ( {})))].flatMap(
-        (kind) => Object.entries(definition.leaves).map(([leaf, described]) => ({
-          ...described,
-          id: [entity, group, kind, leaf].filter(Boolean).join("."),
-          entity,
-          group,
-          ...kind ? { kind } : {},
-          leaf
-        }))
-      )
-    )
-  );
-}
-var FIELDS_BY_ID = new Map(catalogFields().map((field) => [field.id, field]));
-function generalField(id) {
-  const field = FIELDS_BY_ID.get(id);
-  return _optionalChain([field, 'optionalAccess', _ => _.kind]) ? [field.entity, field.group, field.leaf].join(".") : null;
-}
-function fieldSatisfies(offered, wanted) {
-  return offered === wanted || generalField(offered) === wanted;
-}
-var EXTRACTOR_TARGET_FIELDS = {
-  email: ["person.email.value"],
-  personal_email: ["person.email.personal.value"],
-  email_status: ["person.email.status"],
-  phone: ["person.phone.value", "company.phone.value"],
-  phone_status: ["person.phone.status"],
-  first_name: ["person.name.first"],
-  last_name: ["person.name.last"],
-  full_name: ["person.name.value"],
-  // Also used for a list name, a channel title and a search suggestion.
-  name: ["person.name.value", "company.name.value"],
-  linkedin: ["person.linkedin.url", "company.linkedin.url"],
-  linkedin_url: ["person.linkedin.url"],
-  title: ["person.job.title"],
-  job_change: ["person.job.change"],
-  job_change_status: ["person.job.change_status"],
-  company: ["company.name.value"],
-  company_name: ["company.name.value"],
-  organization_name: ["company.name.value"],
-  company_domain: ["company.domain.value"],
-  domain: ["company.domain.value"],
-  company_website: ["company.website.url"],
-  // Also used for a podcast URL.
-  website: ["company.website.url"],
-  company_linkedin_url: ["company.linkedin.url"],
-  industry: ["company.industry.value"],
-  id: ["person.record.id", "company.record.id"],
-  // Used for unrelated provider statuses; none is a catalog field.
-  status: []
-};
-function fieldOfName(name, declared) {
-  const meanings = _nullishCoalesce(EXTRACTOR_TARGET_FIELDS[name], () => ( []));
-  if (declared === void 0) {
-    return meanings.length === 1 ? meanings[0] : void 0;
-  }
-  return meanings.some((meaning) => fieldSatisfies(declared, meaning)) ? declared : void 0;
-}
+var _chunkJLZKF7EYjs = require('./chunk-JLZKF7EY.js');
 
 // src/cli/described-tool.ts
 function isPlayLikeTool(tool) {
@@ -333,15 +161,15 @@ function schemaNodeAt(schema, path) {
   return node;
 }
 var NAMED_VALUE_SHAPES = {
-  email_status: { shape: "EmailStatus", schema: _chunkNA4T3B62js.EMAIL_STATUS_JSON_SCHEMA },
-  job_change: { shape: "JobChange", schema: _chunkNA4T3B62js.JOB_CHANGE_JSON_SCHEMA }
+  email_status: { shape: "EmailStatus", schema: _chunkJLZKF7EYjs.EMAIL_STATUS_JSON_SCHEMA },
+  job_change: { shape: "JobChange", schema: _chunkJLZKF7EYjs.JOB_CHANGE_JSON_SCHEMA }
 };
 function extractorValueType(name) {
-  if (!_chunkNA4T3B62js.isDeeplineExtractorTarget.call(void 0, name)) return void 0;
-  const definition = _chunkNA4T3B62js.DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS[name];
+  if (!_chunkJLZKF7EYjs.isDeeplineExtractorTarget.call(void 0, name)) return void 0;
+  const definition = _chunkJLZKF7EYjs.DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS[name];
   if (definition.enum) {
     return {
-      type: definition.enum.map((value2) => JSON.stringify(value2)).join(" | ")
+      type: definition.enum.map((value) => JSON.stringify(value)).join(" | ")
     };
   }
   const named = NAMED_VALUE_SHAPES[definition.valueKind];
@@ -424,7 +252,7 @@ function describedTool(tool, requestedToolId) {
       const valueType = stringField(_nullishCoalesce(details.get(name), () => ( {})), "valueType");
       const deepline = kind === "extractedValues" ? extractorValueType(name) : void 0;
       const known = typed.type !== "unknown" ? void 0 : kind === "extractedLists" ? { type: "object[]" } : deepline;
-      const means = kind === "extractedValues" ? fieldOfName(
+      const means = kind === "extractedValues" ? _chunkJLZKF7EYjs.fieldOfName.call(void 0, 
         name,
         stringField(_nullishCoalesce(declared[name], () => ( {})), "means") || void 0
       ) : void 0;
@@ -433,7 +261,7 @@ function describedTool(tool, requestedToolId) {
         ...means ? { means } : {},
         // A normalized value has a named type instead of the response's
         // shape; a normalized object is spelled out once under Types.
-        ..._optionalChain([deepline, 'optionalAccess', _2 => _2.shape]) ? deepline : valueType ? { type: valueType } : known ? known : fields ? { fields } : {},
+        ..._optionalChain([deepline, 'optionalAccess', _ => _.shape]) ? deepline : valueType ? { type: valueType } : known ? known : fields ? { fields } : {},
         // A list's row columns that matter are value getters of their own.
         ...kind === "extractedLists" && fields ? { summarized: true } : {},
         read: playResultExpression(entry),
@@ -446,18 +274,18 @@ function describedTool(tool, requestedToolId) {
   const lists = declaredLists.some(({ node }) => node) ? declaredLists.filter(({ node }) => node) : declaredLists;
   const values = getterOutputs("extractedValues", [
     outputSchema,
-    ...lists.map(({ node }) => _optionalChain([node, 'optionalAccess', _3 => _3.items]))
-  ]).map((value2) => {
-    if (!lists.length || !value2.field.paths) return value2;
-    const within = value2.field.paths.map(
+    ...lists.map(({ node }) => _optionalChain([node, 'optionalAccess', _2 => _2.items]))
+  ]).map((value) => {
+    if (!lists.length || !value.field.paths) return value;
+    const within = value.field.paths.map(
       (path) => path.replace(/^toolResponse\.raw\./, "")
     );
     const list = _nullishCoalesce(lists.find(
-      ({ node }) => within.some((path) => isRecord(schemaNodeAt(_optionalChain([node, 'optionalAccess', _4 => _4.items]), path)))
+      ({ node }) => within.some((path) => isRecord(schemaNodeAt(_optionalChain([node, 'optionalAccess', _3 => _3.items]), path)))
     ), () => ( lists[0]));
     return {
-      ...value2,
-      field: { ...value2.field, in: list.field.name, paths: within }
+      ...value,
+      field: { ...value.field, in: list.field.name, paths: within }
     };
   });
   const playReference = isPlayLikeTool(tool) ? playReferenceForTool(tool) : null;
@@ -593,7 +421,7 @@ function usageGuidanceWithAccessDefaults(usageGuidance) {
   return {
     ...usageGuidance,
     prefer: [
-      "Use only the declared extractedLists and extractedValues getters listed below.",
+      "Read each declared output with the expression listed below: toolExecutionResult.fields.<name>.value for a list or a value whose meaning is known, otherwise extractedValues.<name>.get().",
       "Use toolExecutionResult.toolResponse.rawV2 for the complete tool response, preserving the nesting shown in the response example.",
       "Schemas declare field shapes; examples illustrate input values and full Deepline execution responses."
     ],
@@ -646,9 +474,9 @@ function toolInputFieldsForDisplay(inputSchema) {
     );
     return fields.map((field) => {
       const jsonSchemaField = typeof field.name === "string" ? jsonSchemaFields.get(field.name) : void 0;
-      const minItems = typeof field.minItems === "number" ? field.minItems : _optionalChain([jsonSchemaField, 'optionalAccess', _5 => _5.minItems]);
-      const maxItems = typeof field.maxItems === "number" ? field.maxItems : _optionalChain([jsonSchemaField, 'optionalAccess', _6 => _6.maxItems]);
-      const items = isRecord(field.items) ? field.items : _optionalChain([jsonSchemaField, 'optionalAccess', _7 => _7.items]);
+      const minItems = typeof field.minItems === "number" ? field.minItems : _optionalChain([jsonSchemaField, 'optionalAccess', _4 => _4.minItems]);
+      const maxItems = typeof field.maxItems === "number" ? field.maxItems : _optionalChain([jsonSchemaField, 'optionalAccess', _5 => _5.maxItems]);
+      const items = isRecord(field.items) ? field.items : _optionalChain([jsonSchemaField, 'optionalAccess', _6 => _6.items]);
       return {
         ...field,
         ...isRecord(items) ? { items } : {},
@@ -660,8 +488,8 @@ function toolInputFieldsForDisplay(inputSchema) {
   const jsonSchema = isRecord(inputSchema.jsonSchema) ? inputSchema.jsonSchema : inputSchema;
   const properties = isRecord(jsonSchema.properties) ? jsonSchema.properties : {};
   const required = Array.isArray(jsonSchema.required) ? new Set(jsonSchema.required.map(String)) : /* @__PURE__ */ new Set();
-  return Object.entries(properties).map(([name, value2]) => {
-    const property = isRecord(value2) ? value2 : {};
+  return Object.entries(properties).map(([name, value]) => {
+    const property = isRecord(value) ? value : {};
     return {
       name,
       type: typeof property.type === "string" ? property.type : "unknown",
@@ -703,11 +531,11 @@ function publicToolInputSchemaForDescribe(inputSchema) {
       withoutDeeplineCredits
     ) || /\b(?:additional|extra)\s+charges?\b/i.test(withoutDeeplineCredits) || /\bcharg(?:e|ed)\s+(?:double|per)\b/i.test(withoutDeeplineCredits) || /\bpricing page\b/i.test(withoutDeeplineCredits);
   };
-  const stripDescriptions = (value2) => {
-    if (Array.isArray(value2)) return value2.map(stripDescriptions);
-    if (!isRecord(value2)) return value2;
+  const stripDescriptions = (value) => {
+    if (Array.isArray(value)) return value.map(stripDescriptions);
+    if (!isRecord(value)) return value;
     return Object.fromEntries(
-      Object.entries(value2).flatMap(([key, nested]) => {
+      Object.entries(value).flatMap(([key, nested]) => {
         if (key === "description" && typeof nested === "string" && exposesProviderSpend(nested)) {
           return [];
         }
@@ -721,16 +549,16 @@ function recursiveToolInputFieldsForDisplay(inputSchema) {
   const root = canonicalToolJsonSchema(inputSchema);
   const fields = /* @__PURE__ */ new Map();
   const schemasById = /* @__PURE__ */ new Map();
-  const collectSchemaIds = (value2) => {
-    if (Array.isArray(value2)) {
-      for (const item of value2) collectSchemaIds(item);
+  const collectSchemaIds = (value) => {
+    if (Array.isArray(value)) {
+      for (const item of value) collectSchemaIds(item);
       return;
     }
-    if (!isRecord(value2)) return;
-    if (typeof value2.$id === "string" && value2.$id.trim()) {
-      schemasById.set(value2.$id.trim(), value2);
+    if (!isRecord(value)) return;
+    if (typeof value.$id === "string" && value.$id.trim()) {
+      schemasById.set(value.$id.trim(), value);
     }
-    for (const nested of Object.values(value2)) collectSchemaIds(nested);
+    for (const nested of Object.values(value)) collectSchemaIds(nested);
   };
   collectSchemaIds(root);
   const resolveRef = (schema) => {
@@ -775,10 +603,10 @@ function recursiveToolInputFieldsForDisplay(inputSchema) {
     const requiredNames = new Set(
       Array.isArray(schema.required) ? schema.required.map(String) : []
     );
-    for (const [name, value2] of Object.entries(properties)) {
-      if (!isRecord(value2)) continue;
+    for (const [name, value] of Object.entries(properties)) {
+      if (!isRecord(value)) continue;
       visit(
-        value2,
+        value,
         path ? `${path}.${name}` : name,
         requiredNames.has(name),
         nextActiveRefs
@@ -812,27 +640,27 @@ function inputFieldJsonForDescribe(field) {
     ...Object.prototype.hasOwnProperty.call(field, "default") ? { default: field.default } : {}
   };
 }
-function isRecord(value2) {
-  return Boolean(value2 && typeof value2 === "object" && !Array.isArray(value2));
+function isRecord(value) {
+  return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
 function stringField(source, ...keys) {
   for (const key of keys) {
-    const value2 = source[key];
-    if (typeof value2 === "string" && value2.trim()) return value2.trim();
+    const value = source[key];
+    if (typeof value === "string" && value.trim()) return value.trim();
   }
   return "";
 }
 function arrayField(source, ...keys) {
   for (const key of keys) {
-    const value2 = source[key];
-    if (Array.isArray(value2)) return value2;
+    const value = source[key];
+    if (Array.isArray(value)) return value;
   }
   return [];
 }
 function recordField(source, ...keys) {
   for (const key of keys) {
-    const value2 = source[key];
-    if (isRecord(value2)) return value2;
+    const value = source[key];
+    if (isRecord(value)) return value;
   }
   return {};
 }
@@ -861,7 +689,7 @@ function formatModelDescription(description) {
   );
   if (contextWindow !== null) lines.push(`Context: ${contextWindow}`);
   const tags = arrayField2(description.modelMetadata, "tags").filter(
-    (value2) => typeof value2 === "string"
+    (value) => typeof value === "string"
   );
   if (tags.length) lines.push(`Tags: ${tags.join(", ")}`);
   lines.push("");
@@ -886,25 +714,25 @@ function formatModelDescription(description) {
 function appendNamespace(lines, namespace) {
   lines.push(`- ${namespace.provider} (${namespace.sourceSymbol})`);
   for (const field of namespace.fields) {
-    const values = _optionalChain([field, 'access', _8 => _8.enumValues, 'optionalAccess', _9 => _9.length]) ? ` (${field.enumValues.map((value2) => JSON.stringify(value2)).join(" | ")})` : "";
+    const values = _optionalChain([field, 'access', _7 => _7.enumValues, 'optionalAccess', _8 => _8.length]) ? ` (${field.enumValues.map((value) => JSON.stringify(value)).join(" | ")})` : "";
     lines.push(
       `  - ${field.name}: ${field.type}${values} - ${field.description}`
     );
   }
 }
-function stringField2(value2, key) {
-  if (!value2 || typeof value2 !== "object" || Array.isArray(value2)) return null;
-  const candidate = value2[key];
+function stringField2(value, key) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+  const candidate = value[key];
   return typeof candidate === "string" && candidate.trim() ? candidate.trim() : null;
 }
-function numberField(value2, key) {
-  if (!value2 || typeof value2 !== "object" || Array.isArray(value2)) return null;
-  const candidate = value2[key];
+function numberField(value, key) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+  const candidate = value[key];
   return typeof candidate === "number" ? candidate : null;
 }
-function arrayField2(value2, key) {
-  if (!value2 || typeof value2 !== "object" || Array.isArray(value2)) return [];
-  const candidate = value2[key];
+function arrayField2(value, key) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return [];
+  const candidate = value[key];
   return Array.isArray(candidate) ? candidate : [];
 }