deepline 0.1.57 → 0.1.59
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cli/index.js +2112 -324
- package/dist/cli/index.mjs +2068 -280
- package/dist/helpers.d.mts +30 -0
- package/dist/helpers.d.ts +30 -0
- package/dist/helpers.js +143 -0
- package/dist/helpers.mjs +115 -0
- package/dist/index.d.mts +37 -34
- package/dist/index.d.ts +37 -34
- package/dist/index.js +120 -3
- package/dist/index.mjs +104 -3
- package/dist/repo/sdk/src/index.ts +21 -0
- package/dist/repo/sdk/src/play.ts +2 -18
- package/dist/repo/sdk/src/release.ts +3 -3
- package/dist/repo/sdk/src/types.ts +61 -33
- package/dist/repo/shared_libs/plays/bootstrap-routes.ts +127 -0
- package/dist/repo/shared_libs/plays/bundling/index.ts +3 -0
- package/package.json +1 -1
package/dist/index.js
CHANGED
|
@@ -22,10 +22,21 @@ var src_exports = {};
|
|
|
22
22
|
__export(src_exports, {
|
|
23
23
|
AuthError: () => AuthError,
|
|
24
24
|
ConfigError: () => ConfigError,
|
|
25
|
+
DEEPLINE_TOOL_CATEGORIES: () => DEEPLINE_TOOL_CATEGORIES,
|
|
25
26
|
Deepline: () => Deepline,
|
|
26
27
|
DeeplineClient: () => DeeplineClient,
|
|
27
28
|
DeeplineContext: () => DeeplineContext,
|
|
28
29
|
DeeplineError: () => DeeplineError,
|
|
30
|
+
PLAY_BOOTSTRAP_COMPANY_FIELDS: () => PLAY_BOOTSTRAP_COMPANY_FIELDS,
|
|
31
|
+
PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY: () => PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY,
|
|
32
|
+
PLAY_BOOTSTRAP_CONTACT_FIELDS: () => PLAY_BOOTSTRAP_CONTACT_FIELDS,
|
|
33
|
+
PLAY_BOOTSTRAP_FINDER_KINDS: () => PLAY_BOOTSTRAP_FINDER_KINDS,
|
|
34
|
+
PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER: () => PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER,
|
|
35
|
+
PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY: () => PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY,
|
|
36
|
+
PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER: () => PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER,
|
|
37
|
+
PLAY_BOOTSTRAP_SOURCE_KINDS: () => PLAY_BOOTSTRAP_SOURCE_KINDS,
|
|
38
|
+
PLAY_BOOTSTRAP_STAGE_KINDS: () => PLAY_BOOTSTRAP_STAGE_KINDS,
|
|
39
|
+
PLAY_BOOTSTRAP_TEMPLATES: () => PLAY_BOOTSTRAP_TEMPLATES,
|
|
29
40
|
PROD_URL: () => PROD_URL,
|
|
30
41
|
RateLimitError: () => RateLimitError,
|
|
31
42
|
SDK_API_CONTRACT: () => SDK_API_CONTRACT,
|
|
@@ -34,7 +45,12 @@ __export(src_exports, {
|
|
|
34
45
|
definePlay: () => definePlay,
|
|
35
46
|
defineWorkflow: () => defineWorkflow,
|
|
36
47
|
extractSummaryFields: () => extractSummaryFields,
|
|
48
|
+
formatPlayBootstrapFinderKinds: () => formatPlayBootstrapFinderKinds,
|
|
49
|
+
formatPlayBootstrapFinderKindsForSentence: () => formatPlayBootstrapFinderKindsForSentence,
|
|
50
|
+
formatPlayBootstrapTemplates: () => formatPlayBootstrapTemplates,
|
|
37
51
|
getDefinedPlayMetadata: () => getDefinedPlayMetadata,
|
|
52
|
+
isPlayBootstrapFinderKind: () => isPlayBootstrapFinderKind,
|
|
53
|
+
isPlayBootstrapTemplate: () => isPlayBootstrapTemplate,
|
|
38
54
|
resolveConfig: () => resolveConfig,
|
|
39
55
|
steps: () => steps,
|
|
40
56
|
tryConvertToList: () => tryConvertToList,
|
|
@@ -216,10 +232,10 @@ function resolveConfig(options) {
|
|
|
216
232
|
|
|
217
233
|
// src/release.ts
|
|
218
234
|
var SDK_RELEASE = {
|
|
219
|
-
version: "0.1.
|
|
220
|
-
apiContract: "2026-05-play-
|
|
235
|
+
version: "0.1.59",
|
|
236
|
+
apiContract: "2026-05-play-bootstrap-dataset-summary",
|
|
221
237
|
supportPolicy: {
|
|
222
|
-
latest: "0.1.
|
|
238
|
+
latest: "0.1.59",
|
|
223
239
|
minimumSupported: "0.1.53",
|
|
224
240
|
deprecatedBelow: "0.1.53"
|
|
225
241
|
}
|
|
@@ -1684,6 +1700,91 @@ var DeeplineClient = class {
|
|
|
1684
1700
|
}
|
|
1685
1701
|
};
|
|
1686
1702
|
|
|
1703
|
+
// ../shared_libs/plays/bootstrap-routes.ts
|
|
1704
|
+
var DEEPLINE_TOOL_CATEGORIES = [
|
|
1705
|
+
"company_search",
|
|
1706
|
+
"people_search",
|
|
1707
|
+
"people_enrich",
|
|
1708
|
+
"email_finder",
|
|
1709
|
+
"email_verify",
|
|
1710
|
+
"phone_finder",
|
|
1711
|
+
"phone_verify",
|
|
1712
|
+
"identity_resolution",
|
|
1713
|
+
"reverse_lookup",
|
|
1714
|
+
"enrichment",
|
|
1715
|
+
"batch",
|
|
1716
|
+
"premium",
|
|
1717
|
+
"free"
|
|
1718
|
+
];
|
|
1719
|
+
var PLAY_BOOTSTRAP_TEMPLATES = [
|
|
1720
|
+
"people-list",
|
|
1721
|
+
"company-list",
|
|
1722
|
+
"people-email",
|
|
1723
|
+
"people-phone",
|
|
1724
|
+
"company-people",
|
|
1725
|
+
"company-people-email",
|
|
1726
|
+
"company-people-phone"
|
|
1727
|
+
];
|
|
1728
|
+
var PLAY_BOOTSTRAP_SOURCE_KINDS = [
|
|
1729
|
+
"csv",
|
|
1730
|
+
"play",
|
|
1731
|
+
"provider",
|
|
1732
|
+
"providers"
|
|
1733
|
+
];
|
|
1734
|
+
var PLAY_BOOTSTRAP_STAGE_KINDS = [
|
|
1735
|
+
"play",
|
|
1736
|
+
"provider",
|
|
1737
|
+
"providers"
|
|
1738
|
+
];
|
|
1739
|
+
var PLAY_BOOTSTRAP_FINDER_KINDS = [
|
|
1740
|
+
"email_finder",
|
|
1741
|
+
"phone_finder"
|
|
1742
|
+
];
|
|
1743
|
+
var PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY = "company_search";
|
|
1744
|
+
var PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY = "people_search";
|
|
1745
|
+
var PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER = {
|
|
1746
|
+
email_finder: "email_finder",
|
|
1747
|
+
phone_finder: "phone_finder"
|
|
1748
|
+
};
|
|
1749
|
+
var PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER = {
|
|
1750
|
+
email_finder: "email",
|
|
1751
|
+
phone_finder: "phone"
|
|
1752
|
+
};
|
|
1753
|
+
var PLAY_BOOTSTRAP_CONTACT_FIELDS = [
|
|
1754
|
+
"first_name",
|
|
1755
|
+
"last_name",
|
|
1756
|
+
"domain",
|
|
1757
|
+
"company_name",
|
|
1758
|
+
"linkedin_url",
|
|
1759
|
+
"title",
|
|
1760
|
+
"email",
|
|
1761
|
+
"phone"
|
|
1762
|
+
];
|
|
1763
|
+
var PLAY_BOOTSTRAP_COMPANY_FIELDS = [
|
|
1764
|
+
"domain",
|
|
1765
|
+
"company_domain",
|
|
1766
|
+
"company_name",
|
|
1767
|
+
"linkedin_url",
|
|
1768
|
+
"website"
|
|
1769
|
+
];
|
|
1770
|
+
function isPlayBootstrapFinderKind(value) {
|
|
1771
|
+
return PLAY_BOOTSTRAP_FINDER_KINDS.includes(value);
|
|
1772
|
+
}
|
|
1773
|
+
function isPlayBootstrapTemplate(value) {
|
|
1774
|
+
return PLAY_BOOTSTRAP_TEMPLATES.includes(value);
|
|
1775
|
+
}
|
|
1776
|
+
function formatPlayBootstrapFinderKinds() {
|
|
1777
|
+
return PLAY_BOOTSTRAP_FINDER_KINDS.join("|");
|
|
1778
|
+
}
|
|
1779
|
+
function formatPlayBootstrapTemplates() {
|
|
1780
|
+
return PLAY_BOOTSTRAP_TEMPLATES.join("|");
|
|
1781
|
+
}
|
|
1782
|
+
function formatPlayBootstrapFinderKindsForSentence() {
|
|
1783
|
+
const allButLast = PLAY_BOOTSTRAP_FINDER_KINDS.slice(0, -1);
|
|
1784
|
+
const last = PLAY_BOOTSTRAP_FINDER_KINDS.at(-1);
|
|
1785
|
+
return `${allButLast.join(", ")} or ${last}`;
|
|
1786
|
+
}
|
|
1787
|
+
|
|
1687
1788
|
// ../shared_libs/play-runtime/tool-result.ts
|
|
1688
1789
|
var TARGET_FALLBACK_KEYS = {
|
|
1689
1790
|
email: [/^email$/i, /^address$/i, /email/i],
|
|
@@ -2742,10 +2843,21 @@ function extractSummaryFields(payload) {
|
|
|
2742
2843
|
0 && (module.exports = {
|
|
2743
2844
|
AuthError,
|
|
2744
2845
|
ConfigError,
|
|
2846
|
+
DEEPLINE_TOOL_CATEGORIES,
|
|
2745
2847
|
Deepline,
|
|
2746
2848
|
DeeplineClient,
|
|
2747
2849
|
DeeplineContext,
|
|
2748
2850
|
DeeplineError,
|
|
2851
|
+
PLAY_BOOTSTRAP_COMPANY_FIELDS,
|
|
2852
|
+
PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY,
|
|
2853
|
+
PLAY_BOOTSTRAP_CONTACT_FIELDS,
|
|
2854
|
+
PLAY_BOOTSTRAP_FINDER_KINDS,
|
|
2855
|
+
PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER,
|
|
2856
|
+
PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY,
|
|
2857
|
+
PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER,
|
|
2858
|
+
PLAY_BOOTSTRAP_SOURCE_KINDS,
|
|
2859
|
+
PLAY_BOOTSTRAP_STAGE_KINDS,
|
|
2860
|
+
PLAY_BOOTSTRAP_TEMPLATES,
|
|
2749
2861
|
PROD_URL,
|
|
2750
2862
|
RateLimitError,
|
|
2751
2863
|
SDK_API_CONTRACT,
|
|
@@ -2754,7 +2866,12 @@ function extractSummaryFields(payload) {
|
|
|
2754
2866
|
definePlay,
|
|
2755
2867
|
defineWorkflow,
|
|
2756
2868
|
extractSummaryFields,
|
|
2869
|
+
formatPlayBootstrapFinderKinds,
|
|
2870
|
+
formatPlayBootstrapFinderKindsForSentence,
|
|
2871
|
+
formatPlayBootstrapTemplates,
|
|
2757
2872
|
getDefinedPlayMetadata,
|
|
2873
|
+
isPlayBootstrapFinderKind,
|
|
2874
|
+
isPlayBootstrapTemplate,
|
|
2758
2875
|
resolveConfig,
|
|
2759
2876
|
steps,
|
|
2760
2877
|
tryConvertToList,
|
package/dist/index.mjs
CHANGED
|
@@ -170,10 +170,10 @@ function resolveConfig(options) {
|
|
|
170
170
|
|
|
171
171
|
// src/release.ts
|
|
172
172
|
var SDK_RELEASE = {
|
|
173
|
-
version: "0.1.
|
|
174
|
-
apiContract: "2026-05-play-
|
|
173
|
+
version: "0.1.59",
|
|
174
|
+
apiContract: "2026-05-play-bootstrap-dataset-summary",
|
|
175
175
|
supportPolicy: {
|
|
176
|
-
latest: "0.1.
|
|
176
|
+
latest: "0.1.59",
|
|
177
177
|
minimumSupported: "0.1.53",
|
|
178
178
|
deprecatedBelow: "0.1.53"
|
|
179
179
|
}
|
|
@@ -1638,6 +1638,91 @@ var DeeplineClient = class {
|
|
|
1638
1638
|
}
|
|
1639
1639
|
};
|
|
1640
1640
|
|
|
1641
|
+
// ../shared_libs/plays/bootstrap-routes.ts
|
|
1642
|
+
var DEEPLINE_TOOL_CATEGORIES = [
|
|
1643
|
+
"company_search",
|
|
1644
|
+
"people_search",
|
|
1645
|
+
"people_enrich",
|
|
1646
|
+
"email_finder",
|
|
1647
|
+
"email_verify",
|
|
1648
|
+
"phone_finder",
|
|
1649
|
+
"phone_verify",
|
|
1650
|
+
"identity_resolution",
|
|
1651
|
+
"reverse_lookup",
|
|
1652
|
+
"enrichment",
|
|
1653
|
+
"batch",
|
|
1654
|
+
"premium",
|
|
1655
|
+
"free"
|
|
1656
|
+
];
|
|
1657
|
+
var PLAY_BOOTSTRAP_TEMPLATES = [
|
|
1658
|
+
"people-list",
|
|
1659
|
+
"company-list",
|
|
1660
|
+
"people-email",
|
|
1661
|
+
"people-phone",
|
|
1662
|
+
"company-people",
|
|
1663
|
+
"company-people-email",
|
|
1664
|
+
"company-people-phone"
|
|
1665
|
+
];
|
|
1666
|
+
var PLAY_BOOTSTRAP_SOURCE_KINDS = [
|
|
1667
|
+
"csv",
|
|
1668
|
+
"play",
|
|
1669
|
+
"provider",
|
|
1670
|
+
"providers"
|
|
1671
|
+
];
|
|
1672
|
+
var PLAY_BOOTSTRAP_STAGE_KINDS = [
|
|
1673
|
+
"play",
|
|
1674
|
+
"provider",
|
|
1675
|
+
"providers"
|
|
1676
|
+
];
|
|
1677
|
+
var PLAY_BOOTSTRAP_FINDER_KINDS = [
|
|
1678
|
+
"email_finder",
|
|
1679
|
+
"phone_finder"
|
|
1680
|
+
];
|
|
1681
|
+
var PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY = "company_search";
|
|
1682
|
+
var PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY = "people_search";
|
|
1683
|
+
var PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER = {
|
|
1684
|
+
email_finder: "email_finder",
|
|
1685
|
+
phone_finder: "phone_finder"
|
|
1686
|
+
};
|
|
1687
|
+
var PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER = {
|
|
1688
|
+
email_finder: "email",
|
|
1689
|
+
phone_finder: "phone"
|
|
1690
|
+
};
|
|
1691
|
+
var PLAY_BOOTSTRAP_CONTACT_FIELDS = [
|
|
1692
|
+
"first_name",
|
|
1693
|
+
"last_name",
|
|
1694
|
+
"domain",
|
|
1695
|
+
"company_name",
|
|
1696
|
+
"linkedin_url",
|
|
1697
|
+
"title",
|
|
1698
|
+
"email",
|
|
1699
|
+
"phone"
|
|
1700
|
+
];
|
|
1701
|
+
var PLAY_BOOTSTRAP_COMPANY_FIELDS = [
|
|
1702
|
+
"domain",
|
|
1703
|
+
"company_domain",
|
|
1704
|
+
"company_name",
|
|
1705
|
+
"linkedin_url",
|
|
1706
|
+
"website"
|
|
1707
|
+
];
|
|
1708
|
+
function isPlayBootstrapFinderKind(value) {
|
|
1709
|
+
return PLAY_BOOTSTRAP_FINDER_KINDS.includes(value);
|
|
1710
|
+
}
|
|
1711
|
+
function isPlayBootstrapTemplate(value) {
|
|
1712
|
+
return PLAY_BOOTSTRAP_TEMPLATES.includes(value);
|
|
1713
|
+
}
|
|
1714
|
+
function formatPlayBootstrapFinderKinds() {
|
|
1715
|
+
return PLAY_BOOTSTRAP_FINDER_KINDS.join("|");
|
|
1716
|
+
}
|
|
1717
|
+
function formatPlayBootstrapTemplates() {
|
|
1718
|
+
return PLAY_BOOTSTRAP_TEMPLATES.join("|");
|
|
1719
|
+
}
|
|
1720
|
+
function formatPlayBootstrapFinderKindsForSentence() {
|
|
1721
|
+
const allButLast = PLAY_BOOTSTRAP_FINDER_KINDS.slice(0, -1);
|
|
1722
|
+
const last = PLAY_BOOTSTRAP_FINDER_KINDS.at(-1);
|
|
1723
|
+
return `${allButLast.join(", ")} or ${last}`;
|
|
1724
|
+
}
|
|
1725
|
+
|
|
1641
1726
|
// ../shared_libs/play-runtime/tool-result.ts
|
|
1642
1727
|
var TARGET_FALLBACK_KEYS = {
|
|
1643
1728
|
email: [/^email$/i, /^address$/i, /email/i],
|
|
@@ -2695,10 +2780,21 @@ function extractSummaryFields(payload) {
|
|
|
2695
2780
|
export {
|
|
2696
2781
|
AuthError,
|
|
2697
2782
|
ConfigError,
|
|
2783
|
+
DEEPLINE_TOOL_CATEGORIES,
|
|
2698
2784
|
Deepline,
|
|
2699
2785
|
DeeplineClient,
|
|
2700
2786
|
DeeplineContext,
|
|
2701
2787
|
DeeplineError,
|
|
2788
|
+
PLAY_BOOTSTRAP_COMPANY_FIELDS,
|
|
2789
|
+
PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY,
|
|
2790
|
+
PLAY_BOOTSTRAP_CONTACT_FIELDS,
|
|
2791
|
+
PLAY_BOOTSTRAP_FINDER_KINDS,
|
|
2792
|
+
PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER,
|
|
2793
|
+
PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY,
|
|
2794
|
+
PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER,
|
|
2795
|
+
PLAY_BOOTSTRAP_SOURCE_KINDS,
|
|
2796
|
+
PLAY_BOOTSTRAP_STAGE_KINDS,
|
|
2797
|
+
PLAY_BOOTSTRAP_TEMPLATES,
|
|
2702
2798
|
PROD_URL,
|
|
2703
2799
|
RateLimitError,
|
|
2704
2800
|
SDK_API_CONTRACT,
|
|
@@ -2707,7 +2803,12 @@ export {
|
|
|
2707
2803
|
definePlay,
|
|
2708
2804
|
defineWorkflow,
|
|
2709
2805
|
extractSummaryFields,
|
|
2806
|
+
formatPlayBootstrapFinderKinds,
|
|
2807
|
+
formatPlayBootstrapFinderKindsForSentence,
|
|
2808
|
+
formatPlayBootstrapTemplates,
|
|
2710
2809
|
getDefinedPlayMetadata,
|
|
2810
|
+
isPlayBootstrapFinderKind,
|
|
2811
|
+
isPlayBootstrapTemplate,
|
|
2711
2812
|
resolveConfig,
|
|
2712
2813
|
steps,
|
|
2713
2814
|
tryConvertToList,
|
|
@@ -57,6 +57,24 @@
|
|
|
57
57
|
export { DeeplineClient } from './client.js';
|
|
58
58
|
export type { PlayStatus, ToolExecution } from './client.js';
|
|
59
59
|
export { SDK_API_CONTRACT, SDK_VERSION } from './version.js';
|
|
60
|
+
export {
|
|
61
|
+
DEEPLINE_TOOL_CATEGORIES,
|
|
62
|
+
PLAY_BOOTSTRAP_COMPANY_FIELDS,
|
|
63
|
+
PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY,
|
|
64
|
+
PLAY_BOOTSTRAP_CONTACT_FIELDS,
|
|
65
|
+
PLAY_BOOTSTRAP_FINDER_KINDS,
|
|
66
|
+
PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER,
|
|
67
|
+
PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY,
|
|
68
|
+
PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER,
|
|
69
|
+
PLAY_BOOTSTRAP_STAGE_KINDS,
|
|
70
|
+
PLAY_BOOTSTRAP_SOURCE_KINDS,
|
|
71
|
+
PLAY_BOOTSTRAP_TEMPLATES,
|
|
72
|
+
formatPlayBootstrapFinderKinds,
|
|
73
|
+
formatPlayBootstrapFinderKindsForSentence,
|
|
74
|
+
formatPlayBootstrapTemplates,
|
|
75
|
+
isPlayBootstrapFinderKind,
|
|
76
|
+
isPlayBootstrapTemplate,
|
|
77
|
+
} from '../../shared_libs/plays/bootstrap-routes.js';
|
|
60
78
|
|
|
61
79
|
// ——— Errors ———
|
|
62
80
|
export {
|
|
@@ -106,6 +124,9 @@ export type {
|
|
|
106
124
|
PublishPlayVersionResult,
|
|
107
125
|
StartPlayRunRequest,
|
|
108
126
|
PlayListItem,
|
|
127
|
+
DeeplineToolCategory,
|
|
128
|
+
PlayBootstrapFinderKind,
|
|
129
|
+
PlayBootstrapEntityKind,
|
|
109
130
|
} from './types.js';
|
|
110
131
|
|
|
111
132
|
export type {
|
|
@@ -534,28 +534,12 @@ export interface DeeplinePlayRuntimeContext {
|
|
|
534
534
|
bodyText: string;
|
|
535
535
|
json: unknown | null;
|
|
536
536
|
}>;
|
|
537
|
-
|
|
538
|
-
* Invoke another registered or file-backed play as a child workflow.
|
|
539
|
-
*
|
|
540
|
-
* Use this for real composition boundaries, especially when a fitting
|
|
541
|
-
* scalar prebuilt play already encodes provider order, fallbacks,
|
|
542
|
-
* normalization, and no-result behavior. Do not invoke plays through
|
|
543
|
-
* `ctx.tools.execute`; tools and plays are separate namespaces.
|
|
544
|
-
*
|
|
545
|
-
* `key` is the stable child-call identity for idempotency and traceability.
|
|
546
|
-
*
|
|
547
|
-
* @param key - Child call id.
|
|
548
|
-
* @param playRef - Play name or handle.
|
|
549
|
-
* @param input - Child input.
|
|
550
|
-
* @param options - Run options.
|
|
551
|
-
* @returns Child play output.
|
|
552
|
-
*/
|
|
553
|
-
runPlay(
|
|
537
|
+
runPlay<TOutput = unknown>(
|
|
554
538
|
key: string,
|
|
555
539
|
playRef: string | PlayReferenceLike,
|
|
556
540
|
input: Record<string, unknown>,
|
|
557
541
|
options: { description?: string; staleAfterSeconds?: number },
|
|
558
|
-
): Promise<
|
|
542
|
+
): Promise<TOutput>;
|
|
559
543
|
|
|
560
544
|
/**
|
|
561
545
|
* Emit a log line visible in `play tail` and the play's progress logs.
|
|
@@ -50,10 +50,10 @@ export type SdkRelease = {
|
|
|
50
50
|
};
|
|
51
51
|
|
|
52
52
|
export const SDK_RELEASE = {
|
|
53
|
-
version: '0.1.
|
|
54
|
-
apiContract: '2026-05-play-
|
|
53
|
+
version: '0.1.59',
|
|
54
|
+
apiContract: '2026-05-play-bootstrap-dataset-summary',
|
|
55
55
|
supportPolicy: {
|
|
56
|
-
latest: '0.1.
|
|
56
|
+
latest: '0.1.59',
|
|
57
57
|
minimumSupported: '0.1.53',
|
|
58
58
|
deprecatedBelow: '0.1.53',
|
|
59
59
|
},
|
|
@@ -1,4 +1,11 @@
|
|
|
1
1
|
import type { PlayCompilerManifest } from '../../shared_libs/plays/compiler-manifest';
|
|
2
|
+
import type {
|
|
3
|
+
DeeplineToolCategory,
|
|
4
|
+
PlayBootstrapFinderKind,
|
|
5
|
+
PlayBootstrapEntityKind,
|
|
6
|
+
PlayBootstrapStageKind,
|
|
7
|
+
PlayBootstrapTemplate,
|
|
8
|
+
} from '../../shared_libs/plays/bootstrap-routes';
|
|
2
9
|
|
|
3
10
|
// ——————————————————————————————————————————————————————————
|
|
4
11
|
// Config
|
|
@@ -99,6 +106,14 @@ export interface ToolPricingSummary {
|
|
|
99
106
|
* }
|
|
100
107
|
* ```
|
|
101
108
|
*/
|
|
109
|
+
export type {
|
|
110
|
+
DeeplineToolCategory,
|
|
111
|
+
PlayBootstrapFinderKind,
|
|
112
|
+
PlayBootstrapEntityKind,
|
|
113
|
+
PlayBootstrapStageKind,
|
|
114
|
+
PlayBootstrapTemplate,
|
|
115
|
+
};
|
|
116
|
+
|
|
102
117
|
export interface ToolDefinition {
|
|
103
118
|
/** Unique tool identifier used in API calls (e.g. `"apollo_people_search"`). */
|
|
104
119
|
toolId: string;
|
|
@@ -109,7 +124,7 @@ export interface ToolDefinition {
|
|
|
109
124
|
/** What this tool does — suitable for LLM tool descriptions. */
|
|
110
125
|
description: string;
|
|
111
126
|
/** Categorization tags (e.g. `["people", "enrichment"]`). */
|
|
112
|
-
categories:
|
|
127
|
+
categories: DeeplineToolCategory[];
|
|
113
128
|
/** Operation slug within the provider. */
|
|
114
129
|
operation?: string;
|
|
115
130
|
/** Normalized operation identifier. */
|
|
@@ -148,38 +163,48 @@ export interface ToolDefinition {
|
|
|
148
163
|
meta?: string;
|
|
149
164
|
};
|
|
150
165
|
meta?: string;
|
|
151
|
-
extractedLists?:
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
166
|
+
extractedLists?:
|
|
167
|
+
| Array<{
|
|
168
|
+
name: string;
|
|
169
|
+
expression: string;
|
|
170
|
+
details?: {
|
|
171
|
+
strategy?: string;
|
|
172
|
+
rawToolOutputPaths?: string[];
|
|
173
|
+
candidatePaths?: string[];
|
|
174
|
+
};
|
|
175
|
+
}>
|
|
176
|
+
| Record<
|
|
177
|
+
string,
|
|
178
|
+
{
|
|
179
|
+
expression: string;
|
|
180
|
+
details?: {
|
|
181
|
+
strategy?: string;
|
|
182
|
+
rawToolOutputPaths?: string[];
|
|
183
|
+
candidatePaths?: string[];
|
|
184
|
+
};
|
|
185
|
+
}
|
|
186
|
+
>;
|
|
187
|
+
extractedValues?:
|
|
188
|
+
| Array<{
|
|
189
|
+
name: string;
|
|
190
|
+
expression: string;
|
|
191
|
+
details?: {
|
|
192
|
+
strategy?: string;
|
|
193
|
+
rawToolOutputPaths?: string[];
|
|
194
|
+
candidatePaths?: string[];
|
|
195
|
+
};
|
|
196
|
+
}>
|
|
197
|
+
| Record<
|
|
198
|
+
string,
|
|
199
|
+
{
|
|
200
|
+
expression: string;
|
|
201
|
+
details?: {
|
|
202
|
+
strategy?: string;
|
|
203
|
+
rawToolOutputPaths?: string[];
|
|
204
|
+
candidatePaths?: string[];
|
|
205
|
+
};
|
|
206
|
+
}
|
|
207
|
+
>;
|
|
183
208
|
[key: string]: unknown;
|
|
184
209
|
};
|
|
185
210
|
};
|
|
@@ -528,6 +553,7 @@ export interface PlaySheetStats {
|
|
|
528
553
|
running: number;
|
|
529
554
|
completed: number;
|
|
530
555
|
failed: number;
|
|
556
|
+
stale: number;
|
|
531
557
|
}
|
|
532
558
|
|
|
533
559
|
/**
|
|
@@ -539,6 +565,8 @@ export interface PlaySheetColumnStats {
|
|
|
539
565
|
completed: number;
|
|
540
566
|
failed: number;
|
|
541
567
|
cached: number;
|
|
568
|
+
missed: number;
|
|
569
|
+
skipped: number;
|
|
542
570
|
}
|
|
543
571
|
|
|
544
572
|
/**
|
|
@@ -0,0 +1,127 @@
|
|
|
1
|
+
export const DEEPLINE_TOOL_CATEGORIES = [
|
|
2
|
+
'company_search',
|
|
3
|
+
'people_search',
|
|
4
|
+
'people_enrich',
|
|
5
|
+
'email_finder',
|
|
6
|
+
'email_verify',
|
|
7
|
+
'phone_finder',
|
|
8
|
+
'phone_verify',
|
|
9
|
+
'identity_resolution',
|
|
10
|
+
'reverse_lookup',
|
|
11
|
+
'enrichment',
|
|
12
|
+
'batch',
|
|
13
|
+
'premium',
|
|
14
|
+
'free',
|
|
15
|
+
] as const;
|
|
16
|
+
|
|
17
|
+
export type DeeplineToolCategory =
|
|
18
|
+
| (typeof DEEPLINE_TOOL_CATEGORIES)[number]
|
|
19
|
+
| (string & {});
|
|
20
|
+
|
|
21
|
+
export const PLAY_BOOTSTRAP_TEMPLATES = [
|
|
22
|
+
'people-list',
|
|
23
|
+
'company-list',
|
|
24
|
+
'people-email',
|
|
25
|
+
'people-phone',
|
|
26
|
+
'company-people',
|
|
27
|
+
'company-people-email',
|
|
28
|
+
'company-people-phone',
|
|
29
|
+
] as const;
|
|
30
|
+
|
|
31
|
+
export type PlayBootstrapTemplate = (typeof PLAY_BOOTSTRAP_TEMPLATES)[number];
|
|
32
|
+
|
|
33
|
+
export const PLAY_BOOTSTRAP_SOURCE_KINDS = [
|
|
34
|
+
'csv',
|
|
35
|
+
'play',
|
|
36
|
+
'provider',
|
|
37
|
+
'providers',
|
|
38
|
+
] as const;
|
|
39
|
+
|
|
40
|
+
export type PlayBootstrapSourceKind =
|
|
41
|
+
(typeof PLAY_BOOTSTRAP_SOURCE_KINDS)[number];
|
|
42
|
+
|
|
43
|
+
export const PLAY_BOOTSTRAP_STAGE_KINDS = [
|
|
44
|
+
'play',
|
|
45
|
+
'provider',
|
|
46
|
+
'providers',
|
|
47
|
+
] as const;
|
|
48
|
+
|
|
49
|
+
export type PlayBootstrapStageKind =
|
|
50
|
+
(typeof PLAY_BOOTSTRAP_STAGE_KINDS)[number];
|
|
51
|
+
|
|
52
|
+
export const PLAY_BOOTSTRAP_FINDER_KINDS = [
|
|
53
|
+
'email_finder',
|
|
54
|
+
'phone_finder',
|
|
55
|
+
] as const;
|
|
56
|
+
|
|
57
|
+
export type PlayBootstrapFinderKind =
|
|
58
|
+
(typeof PLAY_BOOTSTRAP_FINDER_KINDS)[number];
|
|
59
|
+
|
|
60
|
+
export type PlayBootstrapGetterKind = 'list' | 'value';
|
|
61
|
+
|
|
62
|
+
export type PlayBootstrapEntityKind =
|
|
63
|
+
| 'company'
|
|
64
|
+
| 'contact'
|
|
65
|
+
| 'email'
|
|
66
|
+
| 'phone'
|
|
67
|
+
| 'unknown';
|
|
68
|
+
|
|
69
|
+
export const PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY =
|
|
70
|
+
'company_search' as const;
|
|
71
|
+
|
|
72
|
+
export const PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY = 'people_search' as const;
|
|
73
|
+
|
|
74
|
+
export const PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER = {
|
|
75
|
+
email_finder: 'email_finder',
|
|
76
|
+
phone_finder: 'phone_finder',
|
|
77
|
+
} as const satisfies Record<PlayBootstrapFinderKind, DeeplineToolCategory>;
|
|
78
|
+
|
|
79
|
+
export const PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER = {
|
|
80
|
+
email_finder: 'email',
|
|
81
|
+
phone_finder: 'phone',
|
|
82
|
+
} as const satisfies Record<PlayBootstrapFinderKind, string>;
|
|
83
|
+
|
|
84
|
+
export const PLAY_BOOTSTRAP_CONTACT_FIELDS = [
|
|
85
|
+
'first_name',
|
|
86
|
+
'last_name',
|
|
87
|
+
'domain',
|
|
88
|
+
'company_name',
|
|
89
|
+
'linkedin_url',
|
|
90
|
+
'title',
|
|
91
|
+
'email',
|
|
92
|
+
'phone',
|
|
93
|
+
] as const;
|
|
94
|
+
|
|
95
|
+
export const PLAY_BOOTSTRAP_COMPANY_FIELDS = [
|
|
96
|
+
'domain',
|
|
97
|
+
'company_domain',
|
|
98
|
+
'company_name',
|
|
99
|
+
'linkedin_url',
|
|
100
|
+
'website',
|
|
101
|
+
] as const;
|
|
102
|
+
|
|
103
|
+
export function isPlayBootstrapFinderKind(
|
|
104
|
+
value: string,
|
|
105
|
+
): value is PlayBootstrapFinderKind {
|
|
106
|
+
return PLAY_BOOTSTRAP_FINDER_KINDS.includes(value as PlayBootstrapFinderKind);
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
export function isPlayBootstrapTemplate(
|
|
110
|
+
value: string,
|
|
111
|
+
): value is PlayBootstrapTemplate {
|
|
112
|
+
return PLAY_BOOTSTRAP_TEMPLATES.includes(value as PlayBootstrapTemplate);
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
export function formatPlayBootstrapFinderKinds(): string {
|
|
116
|
+
return PLAY_BOOTSTRAP_FINDER_KINDS.join('|');
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
export function formatPlayBootstrapTemplates(): string {
|
|
120
|
+
return PLAY_BOOTSTRAP_TEMPLATES.join('|');
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
export function formatPlayBootstrapFinderKindsForSentence(): string {
|
|
124
|
+
const allButLast = PLAY_BOOTSTRAP_FINDER_KINDS.slice(0, -1);
|
|
125
|
+
const last = PLAY_BOOTSTRAP_FINDER_KINDS.at(-1);
|
|
126
|
+
return `${allButLast.join(', ')} or ${last}`;
|
|
127
|
+
}
|
|
@@ -517,6 +517,9 @@ function localSdkAliasPlugin(
|
|
|
517
517
|
buildContext.onResolve({ filter: /^deepline$/ }, () => ({
|
|
518
518
|
path: entryFile,
|
|
519
519
|
}));
|
|
520
|
+
buildContext.onResolve({ filter: /^deepline\/helpers$/ }, () => ({
|
|
521
|
+
path: join(adapter.sdkSourceRoot, 'helpers.ts'),
|
|
522
|
+
}));
|
|
520
523
|
},
|
|
521
524
|
};
|
|
522
525
|
}
|