deepline 0.3.463 → 0.3.464

package/dist/cli/{workflow-RM7H7555.js → workflow-TF6YDWTM.js}

@@ -6,8 +6,8 @@ var _chunk3XX5TEA4js = require('./chunk-3XX5TEA4.js');
 var _chunk3KC45UVFjs = require('./chunk-3KC45UVF.js');
 
 
-var _chunkSKU6ECIYjs = require('./chunk-SKU6ECIY.js');
-require('./chunk-UC4SFYNU.js');
+var _chunkZIMCLWEWjs = require('./chunk-ZIMCLWEW.js');
+require('./chunk-BMUDQMYE.js');
 require('./chunk-E4CABWXL.js');
 require('./chunk-JKVRBCZL.js');
 require('./chunk-NMU3VR5U.js');
@@ -17,13 +17,13 @@ require('./chunk-XDVT3GOM.js');
 
 
 
-var _chunk5LHXOIPTjs = require('./chunk-5LHXOIPT.js');
-require('./chunk-BGNWI3KH.js');
-require('./chunk-YGGIZ3VT.js');
+var _chunkO4ZMADW4js = require('./chunk-O4ZMADW4.js');
+require('./chunk-GVJVBBGV.js');
+require('./chunk-NI3QFUK7.js');
 require('./chunk-ALJJRZNJ.js');
 require('./chunk-XNYIZMNQ.js');
 require('./chunk-DIAWYWT5.js');
-require('./chunk-3BOIOCNX.js');
+require('./chunk-4XNXFHG6.js');
 require('./chunk-OG64RBAC.js');
 require('./chunk-COGTRVWW.js');
 
@@ -1629,18 +1629,18 @@ function noticeToStderr(command) {
   );
 }
 function emitPassThrough(command, payload, options) {
-  const json = _chunk5LHXOIPTjs.shouldEmitJson.call(void 0, options.json);
+  const json = _chunkO4ZMADW4js.shouldEmitJson.call(void 0, options.json);
   const deprecation = migrationDeprecation(command);
   if (json) {
     const enriched = payload && typeof payload === "object" && !Array.isArray(payload) ? { ...payload, deprecation } : { result: payload, deprecation };
-    _chunk5LHXOIPTjs.printJson.call(void 0, enriched);
+    _chunkO4ZMADW4js.printJson.call(void 0, enriched);
     return;
   }
-  _chunk5LHXOIPTjs.printJson.call(void 0, payload);
+  _chunkO4ZMADW4js.printJson.call(void 0, payload);
   noticeToStderr(command);
 }
 function client() {
-  return new (0, _chunkSKU6ECIYjs.DeeplineClient)();
+  return new (0, _chunkZIMCLWEWjs.DeeplineClient)();
 }
 function clientWithTimeout(timeoutSeconds) {
   if (!timeoutSeconds) return client();
@@ -1648,7 +1648,7 @@ function clientWithTimeout(timeoutSeconds) {
   if (!Number.isFinite(seconds) || seconds <= 0) {
     throw new Error("--timeout must be a positive number of seconds.");
   }
-  return new (0, _chunkSKU6ECIYjs.DeeplineClient)({ timeout: seconds * 1e3 });
+  return new (0, _chunkZIMCLWEWjs.DeeplineClient)({ timeout: seconds * 1e3 });
 }
 function readStatus(payload) {
   if (!payload || typeof payload !== "object") return null;
@@ -1702,7 +1702,7 @@ async function transformOne(api, workflowId, outDir, publish) {
     await _promises.writeFile.call(void 0, file, compiled.sourceCode, "utf8");
     let published = false;
     if (publish) {
-      const { handlePlayPublish } = await Promise.resolve().then(() => _interopRequireWildcard(require("./play-USJBQADG.js")));
+      const { handlePlayPublish } = await Promise.resolve().then(() => _interopRequireWildcard(require("./play-NMHUWBET.js")));
       const code = await handlePlayPublish([file]);
       if (code !== 0) {
         return {
@@ -1777,10 +1777,10 @@ async function handleTransform(id, options) {
   for (const workflowId of ids) {
     outcomes.push(await transformOne(api, workflowId, outDir, publish));
   }
-  _chunk5LHXOIPTjs.printCommandEnvelope.call(void 0, 
+  _chunkO4ZMADW4js.printCommandEnvelope.call(void 0, 
     { outcomes, deprecation: null },
     {
-      json: _chunk5LHXOIPTjs.shouldEmitJson.call(void 0, options.json),
+      json: _chunkO4ZMADW4js.shouldEmitJson.call(void 0, options.json),
       text: renderTransformReport(outcomes)
     }
   );
@@ -1801,11 +1801,11 @@ async function handleDelete(id, options) {
 }
 async function handleDisable(id, options) {
   const result = await client().disableWorkflow(id);
-  _chunk5LHXOIPTjs.printJson.call(void 0, result);
+  _chunkO4ZMADW4js.printJson.call(void 0, result);
 }
 async function handleEnable(id, options) {
   const result = await client().enableWorkflow(id);
-  _chunk5LHXOIPTjs.printJson.call(void 0, result);
+  _chunkO4ZMADW4js.printJson.call(void 0, result);
 }
 async function handleApply(options) {
   const body = await readJsonOption(options.payload, options.file);
@@ -1870,7 +1870,7 @@ async function handleTail(id, runId, options) {
     if (status && TERMINAL_RUN_STATUSES.has(status) || Date.now() > deadline) {
       return;
     }
-    await _chunk5LHXOIPTjs.sleep.call(void 0, intervalMs);
+    await _chunkO4ZMADW4js.sleep.call(void 0, intervalMs);
   }
 }
 function registerWorkflowCommands(program) {

package/dist/{client-DTwnz_AW.d.mts → client-ADFHNtFM.d.mts}

@@ -1,5 +1,5 @@
 /// <reference path="./text-imports.d.ts" />
-import { D as DeeplineClient$1, a as DeeplineClientOptions } from './client-core-DzBSlY1U.mjs';
+import { D as DeeplineClient$1, a as DeeplineClientOptions } from './client-core-DWLmmJWo.mjs';
 
 /** Deepline SDK client with environment and local credential discovery. */
 

package/dist/{client-DS2IWYZF.d.ts → client-BClp2yrq.d.ts}

@@ -1,5 +1,5 @@
 /// <reference path="./text-imports.d.ts" />
-import { D as DeeplineClient$1, a as DeeplineClientOptions } from './client-core-B_6HAIBy.js';
+import { D as DeeplineClient$1, a as DeeplineClientOptions } from './client-core-BFU73Ttw.js';
 
 /** Deepline SDK client with environment and local credential discovery. */
 

package/dist/{client-core-B_6HAIBy.d.ts → client-core-BFU73Ttw.d.ts}

@@ -1,5 +1,5 @@
 /// <reference path="./text-imports.d.ts" />
-import { u as PlayCompilerManifest, am as ToolResultBilling, D as DeeplineError, B as BillingEntitlements, ao as BillingBenefitValues } from './compiler-manifest-Dcyd3-Zd.js';
+import { u as PlayCompilerManifest, am as ToolResultBilling, D as DeeplineError, B as BillingEntitlements, ao as BillingBenefitValues } from './compiler-manifest-Cs17yO-H.js';
 import { z } from 'zod';
 import { MonitorFleetDefinition } from './monitor-fleet-contract.js';
 

package/dist/{client-core-DzBSlY1U.d.mts → client-core-DWLmmJWo.d.mts}

@@ -1,5 +1,5 @@
 /// <reference path="./text-imports.d.ts" />
-import { u as PlayCompilerManifest, am as ToolResultBilling, D as DeeplineError, B as BillingEntitlements, ao as BillingBenefitValues } from './compiler-manifest-Dcyd3-Zd.mjs';
+import { u as PlayCompilerManifest, am as ToolResultBilling, D as DeeplineError, B as BillingEntitlements, ao as BillingBenefitValues } from './compiler-manifest-Cs17yO-H.mjs';
 import { z } from 'zod';
 import { MonitorFleetDefinition } from './monitor-fleet-contract.mjs';
 

package/dist/{compiler-manifest-Dcyd3-Zd.d.ts → compiler-manifest-Cs17yO-H.d.mts}

@@ -698,6 +698,310 @@ type PlayDatasetMaterializeOptions = {
     limit?: number;
 };
 
+/**
+ * The catalog of things a tool or play can take or return about a person or
+ * a company, named by what they are instead of by what a provider calls them.
+ *
+ * An id is a dotted path that always ends in `.value`:
+ *
+ *   person.email.value            any email for the person
+ *   person.email.work.value       their work email
+ *   person.email.work.validated.value   whether it was validated
+ *
+ * It reads `<entity>.<group>[.<group>][.<kind>][.<leaf>].value`. A group is one thing
+ * about the entity (an email), and may hold groups of its own (a job's
+ * title). A leaf is one fact about that thing (its value, whether it was
+ * validated). A kind narrows which one is meant (work, personal). No id is
+ * both a field and a parent of fields, so `person.email` alone is never a
+ * field; the plain value is `person.email.value`.
+ *
+ * A narrower field answers for every more general one:
+ *
+ *   person.email.work.value   answers person.email.value (its kind dropped)
+ *   person.email.value        answers entity.email.value (a person or company)
+ *
+ * A tool that cannot tell which kind it has declares the id without one; a
+ * tool whose record may be a person or a company declares the `entity` id.
+ *
+ * `provider.<provider>.<...>.value` names a value that belongs to one
+ * provider and is not about a person or company (a HubSpot list's name). It
+ * is declared where the provider's tool is, and answers only for itself.
+ *
+ * This is an addition. Existing short names (`email`, `name`) keep working;
+ * `EXTRACTOR_TARGET_FIELDS` records what each can mean.
+ */
+type Leaf = {
+    type: string;
+    description: string;
+};
+declare const FIELD_CATALOG: {
+    readonly person: {
+        readonly name: {
+            readonly description: "The person's name. Without a kind, a name in some form.";
+            readonly leaves: {
+                readonly value: Leaf;
+            };
+            readonly kinds: {
+                readonly full: "Their full name.";
+                readonly first: "Their first (given) name.";
+                readonly last: "Their last (family) name.";
+            };
+        };
+        readonly email: {
+            readonly description: "An email address for the person.";
+            readonly leaves: {
+                readonly value: Leaf;
+                readonly validated: {
+                    readonly type: "boolean";
+                    readonly description: "Whether the address passed validation.";
+                };
+                readonly status: {
+                    readonly type: "EmailStatus";
+                    readonly description: "The validation verdict and its signals.";
+                };
+                readonly source: Leaf;
+            };
+            readonly kinds: {
+                readonly work: "At their employer.";
+                readonly personal: "Their own, not tied to an employer.";
+            };
+        };
+        readonly phone: {
+            readonly description: "A phone number for the person.";
+            readonly leaves: {
+                readonly value: Leaf;
+                readonly validated: {
+                    readonly type: "boolean";
+                    readonly description: "Whether the number passed validation.";
+                };
+                readonly status: {
+                    readonly type: "\"valid\" | \"invalid\" | \"unknown\"";
+                    readonly description: "The validation verdict.";
+                };
+                readonly line_type: Leaf;
+                readonly carrier: Leaf;
+                readonly source: Leaf;
+            };
+            readonly kinds: {
+                readonly mobile: "Their mobile.";
+                readonly work: "A direct line at their employer.";
+            };
+        };
+        readonly linkedin: {
+            readonly description: "The person's LinkedIn profile.";
+            readonly leaves: {
+                readonly url: Leaf;
+                readonly id: Leaf;
+            };
+        };
+        readonly job: {
+            readonly description: "The person's current role.";
+            readonly groups: {
+                readonly title: {
+                    readonly description: "What their role is called. Without a kind, a job title or, failing one, their profile headline.";
+                    readonly leaves: {
+                        readonly value: Leaf;
+                    };
+                    readonly kinds: {
+                        readonly exact: "Their job title, never a headline.";
+                        readonly headline: "Their profile headline, used as a title.";
+                    };
+                };
+            };
+            readonly leaves: {
+                readonly change: {
+                    readonly type: "JobChange";
+                    readonly description: "Whether they changed jobs, and to what.";
+                };
+                readonly change_status: {
+                    readonly type: "JobChangeStatus";
+                    readonly description: "The job-change verdict alone.";
+                };
+            };
+        };
+        readonly record: {
+            readonly description: "A provider's own record of the person.";
+            readonly leaves: {
+                readonly id: Leaf;
+            };
+        };
+    };
+    readonly company: {
+        readonly name: {
+            readonly description: "The company's name.";
+            readonly leaves: {
+                readonly value: Leaf;
+            };
+            readonly kinds: {
+                readonly legal: "As registered with a government.";
+            };
+        };
+        readonly domain: {
+            readonly description: "The company's web domain.";
+            readonly leaves: {
+                readonly value: Leaf;
+            };
+        };
+        readonly website: {
+            readonly description: "The company's website.";
+            readonly leaves: {
+                readonly url: Leaf;
+            };
+        };
+        readonly linkedin: {
+            readonly description: "The company's LinkedIn page.";
+            readonly leaves: {
+                readonly url: Leaf;
+            };
+        };
+        readonly phone: {
+            readonly description: "A phone number for the company.";
+            readonly leaves: {
+                readonly value: Leaf;
+            };
+        };
+        readonly industry: {
+            readonly description: "The industry the company is in.";
+            readonly leaves: {
+                readonly value: Leaf;
+            };
+        };
+        readonly record: {
+            readonly description: "A provider's own record of the company.";
+            readonly leaves: {
+                readonly id: Leaf;
+            };
+        };
+    };
+    readonly job: {
+        readonly posting: {
+            readonly description: "A job posting.";
+            readonly groups: {
+                readonly title: {
+                    readonly description: "The posting's title. Not a person's job title.";
+                    readonly leaves: {
+                        readonly value: Leaf;
+                    };
+                };
+            };
+        };
+    };
+    readonly podcast: {
+        readonly name: {
+            readonly description: "A podcast's name.";
+            readonly leaves: {
+                readonly value: Leaf;
+            };
+        };
+        readonly website: {
+            readonly description: "A podcast's own page.";
+            readonly leaves: {
+                readonly url: Leaf;
+            };
+        };
+    };
+    readonly post: {
+        readonly title: {
+            readonly description: "A social or business post's title.";
+            readonly leaves: {
+                readonly value: Leaf;
+            };
+        };
+        readonly author: {
+            readonly description: "A post's author, who may be a person or a company.";
+            readonly groups: {
+                readonly name: {
+                    readonly description: "The author's name.";
+                    readonly leaves: {
+                        readonly value: Leaf;
+                    };
+                };
+            };
+        };
+    };
+    readonly page: {
+        readonly title: {
+            readonly description: "A web page's title.";
+            readonly leaves: {
+                readonly value: Leaf;
+            };
+        };
+    };
+    readonly entity: {
+        readonly name: {
+            readonly description: "A person's or company's name.";
+            readonly leaves: {
+                readonly value: Leaf;
+            };
+        };
+        readonly email: {
+            readonly description: "An email address for a person or company.";
+            readonly leaves: {
+                readonly value: Leaf;
+            };
+        };
+        readonly phone: {
+            readonly description: "A phone number for a person or company.";
+            readonly leaves: {
+                readonly value: Leaf;
+            };
+        };
+        readonly linkedin: {
+            readonly description: "A person's or company's LinkedIn page.";
+            readonly leaves: {
+                readonly url: Leaf;
+            };
+        };
+        readonly record: {
+            readonly description: "A provider's own record of a person or company.";
+            readonly leaves: {
+                readonly id: Leaf;
+            };
+        };
+    };
+};
+
+type Catalog = typeof FIELD_CATALOG;
+type GroupLeaves<TGroup> = TGroup extends {
+    leaves: infer TLeaves;
+} ? {
+    readonly [Leaf in keyof TLeaves]?: unknown;
+} : unknown;
+type CatalogGroupFields<TGroup> = GroupLeaves<TGroup> & (TGroup extends {
+    kinds: infer TKinds;
+} ? {
+    readonly [Kind in keyof TKinds]?: GroupLeaves<TGroup>;
+} : unknown) & (TGroup extends {
+    groups: infer TGroups;
+} ? {
+    readonly [Child in keyof TGroups]?: CatalogGroupFields<TGroups[Child]>;
+} : unknown);
+/** Every field the catalog defines, as `result.fields` lays them out. */
+type CatalogFields = {
+    readonly [Entity in keyof Catalog]?: {
+        readonly [Group in keyof Catalog[Entity]]?: CatalogGroupFields<Catalog[Entity][Group]>;
+    };
+} & {
+    /** Provider-specific fields, `provider.<provider>.<...>.<leaf>`. */
+    readonly provider?: Readonly<Record<string, unknown>>;
+};
+/**
+ * The values a result is known to have, by field catalog id and short name,
+ * each ending in a leaf: `fields.person.email.value`,
+ * `fields.person.email.work.value`, `fields.email.value`. Declared lists are
+ * at `fields.<list>.value`, as their getter returns them. A value whose
+ * meaning is not known is absent; read it from `response`. Reading a field
+ * two outputs could be throws, naming both.
+ */
+type ToolResultFields<TExtracted extends Record<string, unknown>, TListValues extends Record<string, unknown>> = CatalogFields & {
+    readonly [K in keyof TExtracted]?: {
+        readonly value: TExtracted[K] | null;
+    };
+} & {
+    readonly [K in keyof TListValues]?: {
+        readonly value: TListValues[K];
+    };
+};
 /**
  * Customer pricing reported by the execution API, never provider spend.
  * `credits_charged` and `cost_usd` describe the price of the original call;
@@ -792,6 +1096,9 @@ type BasicToolExecuteResultAccessors<TExtracted extends Record<string, unknown>
     extractedLists: {
         [K in keyof TLists]: BasicToolResultListAccessor<TLists[K]>;
     };
+    readonly fields: ToolResultFields<TExtracted, {
+        [K in keyof TLists]: TLists[K][];
+    }>;
 };
 /** Public source-SDK result for new Plays; receipts retain the canonical form. */
 type BasicToolExecuteResult<TResult = unknown, TMeta = Record<string, unknown>, TExtracted extends Record<string, unknown> = Partial<DeeplineGetterValueMap>, TLists extends Record<string, Record<string, unknown>> = Record<string, Record<string, unknown>>> = BasicToolExecuteResultBase<TResult, TMeta> & BasicToolExecuteResultAccessors<TExtracted, TLists>;
@@ -816,6 +1123,10 @@ type ToolExecuteResultBase<TResult = unknown, TMeta = Record<string, unknown>> =
     toolResponse: ToolResponseEnvelope<TResult, TMeta>;
     extractedValues: Record<string, ToolResultTargetAccessor>;
     extractedLists: Record<string, ToolResultListAccessor>;
+    /** One field by id or short name, as `fields` resolves it. */
+    field(name: string): unknown;
+    /** The complete parsed provider response (`toolResponse.rawV2`). */
+    readonly response: unknown;
     /** Convenience alias for play code. Serialized output uses toolResponse. */
     toolOutput: ToolResponseEnvelope<TResult, TMeta>;
     _metadata: {
@@ -844,14 +1155,21 @@ type ToolExecuteResultAccessors<TExtracted extends Record<string, unknown> = Par
     extractedLists: {
         [K in keyof TLists]: ToolResultListAccessor<TLists[K]>;
     };
+    readonly fields: ToolResultFields<TExtracted, {
+        [K in keyof TLists]: PlayDataset<TLists[K]>;
+    }>;
 };
 /**
  * Canonical result returned by Deepline tool execution.
  *
- * Provider data: `toolResponse.rawV2`; metadata: `toolResponse.meta`.
- * Single-value getters: `extractedValues.<name>.get()`; lists: `extractedLists.<name>.get()`.
+ * Known values: `fields.person.email.value`, `fields.email.value`, and a
+ * declared list at `fields.<list>.value`; or `field('person.email.value')`.
+ * A value whose meaning is not known is absent: read it from `response`, the
+ * complete provider response. Metadata: `toolResponse.meta`. The older
+ * getters `extractedValues.<name>.get()` and `extractedLists.<name>.get()`
+ * return the same values and keep working.
  *
- * Prefer declared getters. Edition 10 and later Plays receive ordinary arrays from
+ * Edition 10 and later Plays receive ordinary arrays from
  * list `.get()` synchronously; persist explicitly with deepline.dataset. Lazy or
  * incomplete lists throw: use readList(result, path) for explicit dataset access.
  * Provider pagination requires a separate request; getters never fetch it.