outbound-sdk 0.2.1 → 0.5.0

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.
Files changed (175) hide show
  1. package/README.md +2 -2
  2. package/dist/alerts/check-evaluate.d.ts +53 -0
  3. package/dist/alerts/check-measure.d.ts +100 -0
  4. package/dist/alerts/check-schema.d.ts +184 -0
  5. package/dist/alerts/check-validate.d.ts +18 -0
  6. package/dist/alerts/index.d.ts +7 -0
  7. package/dist/alerts/index.js +684 -20
  8. package/dist/alerts/plugin.d.ts +20 -3
  9. package/dist/audit/index.js +2 -2
  10. package/dist/benchmarks/index.js +5 -5
  11. package/dist/budget/index.d.ts +5 -2
  12. package/dist/budget/index.js +12 -10
  13. package/dist/cards/content.d.ts +6 -1
  14. package/dist/cards/format.d.ts +17 -2
  15. package/dist/cards/index.d.ts +1 -1
  16. package/dist/cards/index.js +298 -132
  17. package/dist/cards/parts.d.ts +9 -2
  18. package/dist/cards/render.d.ts +20 -3
  19. package/dist/chunks/{chunk-U2D34ARZ.js → chunk-2D42TQFU.js} +3 -3
  20. package/dist/chunks/{chunk-6CVZOUHB.js → chunk-3S32R2MH.js} +53 -63
  21. package/dist/chunks/chunk-4PA526S7.js +17 -0
  22. package/dist/chunks/{chunk-RCZ7ZZFU.js → chunk-5J7GGV62.js} +12 -5
  23. package/dist/chunks/chunk-6TKFISG4.js +676 -0
  24. package/dist/chunks/{chunk-AFU5E5QB.js → chunk-BK5SLY32.js} +104 -84
  25. package/dist/chunks/{chunk-VQSCHOBV.js → chunk-BLCJHP5H.js} +11 -4
  26. package/dist/chunks/{chunk-SBIZDCRY.js → chunk-BN6WCAWX.js} +7 -7
  27. package/dist/chunks/{chunk-4PSO6JEK.js → chunk-BOWXGMN3.js} +6 -21
  28. package/dist/chunks/{chunk-PURHK3JU.js → chunk-EHSJGQ5K.js} +8 -8
  29. package/dist/chunks/{chunk-IPUYZD4O.js → chunk-GFDNRWR3.js} +1 -1
  30. package/dist/chunks/chunk-HPNGSG5E.js +51 -0
  31. package/dist/chunks/chunk-HWHI4LFY.js +102 -0
  32. package/dist/chunks/{chunk-E7JHLNLG.js → chunk-J7DDZ4C2.js} +15 -2
  33. package/dist/chunks/{chunk-DJ2IUQEU.js → chunk-JWGSB7PT.js} +6 -6
  34. package/dist/chunks/{chunk-R3Y56YVF.js → chunk-OLPMBRXM.js} +4 -3
  35. package/dist/chunks/{chunk-YOTW5ESM.js → chunk-PQSTQKRD.js} +2 -2
  36. package/dist/chunks/chunk-PTZO4QXR.js +15 -0
  37. package/dist/chunks/{chunk-LVYG7XZJ.js → chunk-QAKJ76HB.js} +1 -1
  38. package/dist/chunks/chunk-QGRZDTX4.js +26 -0
  39. package/dist/chunks/chunk-WGW3ROLY.js +18 -0
  40. package/dist/chunks/{chunk-XC6CZP73.js → chunk-WH6V3YNN.js} +32 -1
  41. package/dist/chunks/{chunk-P3IJBJUI.js → chunk-X4RDBD4J.js} +296 -62
  42. package/dist/chunks/chunk-XL6LJVHJ.js +71 -0
  43. package/dist/chunks/{chunk-XNFESPZH.js → chunk-YYCT3NGV.js} +200 -39
  44. package/dist/chunks/{chunk-UAT3JSJZ.js → chunk-ZOAG2C6V.js} +2 -2
  45. package/dist/cli/bin.js +19 -30
  46. package/dist/cli/commands.d.ts +11 -0
  47. package/dist/cli/index.d.ts +3 -0
  48. package/dist/cli/index.js +18 -13
  49. package/dist/cli/mcp.d.ts +5 -0
  50. package/dist/cli/update.d.ts +15 -0
  51. package/dist/clients/index.d.ts +1 -1
  52. package/dist/clients/index.js +35 -10
  53. package/dist/clients/plugin.d.ts +9 -2
  54. package/dist/combine/index.js +7 -6
  55. package/dist/emailbison/account.d.ts +7 -0
  56. package/dist/emailbison/adapter.d.ts +5 -0
  57. package/dist/emailbison/capabilities.d.ts +78 -0
  58. package/dist/emailbison/client.d.ts +29 -0
  59. package/dist/emailbison/index.d.ts +30 -0
  60. package/dist/emailbison/index.js +1017 -0
  61. package/dist/emailbison/mail.d.ts +5 -0
  62. package/dist/emailbison/map-mail.d.ts +13 -0
  63. package/dist/emailbison/map-sequence.d.ts +12 -0
  64. package/dist/emailbison/map-stats.d.ts +47 -0
  65. package/dist/emailbison/map.d.ts +24 -0
  66. package/dist/emailbison/native-params.d.ts +5 -0
  67. package/dist/emailbison/native-workspace.d.ts +167 -0
  68. package/dist/emailbison/native.d.ts +327 -0
  69. package/dist/emailbison/stats.d.ts +4 -0
  70. package/dist/emailbison/webhooks.d.ts +2 -0
  71. package/dist/exporter/index.d.ts +5 -2
  72. package/dist/exporter/index.js +2 -2
  73. package/dist/failover/index.js +3 -3
  74. package/dist/fixtures/index.js +10 -9
  75. package/dist/heyreach/capabilities.d.ts +3 -0
  76. package/dist/heyreach/client.d.ts +2 -0
  77. package/dist/heyreach/index.js +83 -51
  78. package/dist/heyreach/map.d.ts +5 -2
  79. package/dist/identity/index.js +33 -17
  80. package/dist/identity/plugin.d.ts +2 -0
  81. package/dist/index.d.ts +2 -2
  82. package/dist/index.js +29 -25
  83. package/dist/insights/campaign.d.ts +3 -0
  84. package/dist/insights/capped.d.ts +29 -0
  85. package/dist/insights/copy/copy-audit.d.ts +2 -0
  86. package/dist/insights/copy/copy-reuse.d.ts +27 -3
  87. package/dist/insights/copy/index.d.ts +8 -8
  88. package/dist/insights/copy/reply-timing.d.ts +8 -0
  89. package/dist/insights/copy/reuse-base.d.ts +32 -0
  90. package/dist/insights/copy/shared.d.ts +39 -15
  91. package/dist/insights/copy/step-funnel.d.ts +16 -5
  92. package/dist/insights/copy/variant-test.d.ts +19 -8
  93. package/dist/insights/cost.d.ts +91 -0
  94. package/dist/insights/define.d.ts +78 -3
  95. package/dist/insights/fields.d.ts +16 -0
  96. package/dist/insights/index.d.ts +6 -4
  97. package/dist/insights/index.js +1816 -748
  98. package/dist/insights/inputs.generated.d.ts +951 -0
  99. package/dist/insights/ops/campaign-diagnosis.d.ts +3 -1
  100. package/dist/insights/ops/campaign-ranking.d.ts +15 -7
  101. package/dist/insights/ops/channel-mix.d.ts +2 -1
  102. package/dist/insights/ops/client-report.d.ts +18 -5
  103. package/dist/insights/ops/index.d.ts +8 -4
  104. package/dist/insights/ops/period-comparison.d.ts +14 -3
  105. package/dist/insights/ops/pipeline-forecast.d.ts +14 -4
  106. package/dist/insights/ops/shared.d.ts +39 -24
  107. package/dist/insights/ops/tag-rollup.d.ts +2 -1
  108. package/dist/insights/people/account-summary.d.ts +13 -0
  109. package/dist/insights/people/dropped-replies.d.ts +8 -0
  110. package/dist/insights/people/find.d.ts +7 -1
  111. package/dist/insights/people/hot-leads.d.ts +16 -1
  112. package/dist/insights/people/person-summary.d.ts +6 -0
  113. package/dist/insights/people/read.d.ts +26 -10
  114. package/dist/insights/people/suppression-check.d.ts +11 -2
  115. package/dist/insights/plugin.d.ts +26 -5
  116. package/dist/insights/ref.d.ts +6 -0
  117. package/dist/insights/registry.d.ts +30 -18
  118. package/dist/insights/run-cap.d.ts +35 -0
  119. package/dist/insights/senders/bounce-watch.d.ts +25 -8
  120. package/dist/insights/senders/capacity-sends.d.ts +22 -0
  121. package/dist/insights/senders/domain-health.d.ts +10 -4
  122. package/dist/insights/senders/index.d.ts +14 -6
  123. package/dist/insights/senders/read.d.ts +15 -14
  124. package/dist/insights/senders/sender-capacity.d.ts +5 -13
  125. package/dist/insights/senders/sender-load.d.ts +2 -0
  126. package/dist/insights/stats.d.ts +8 -0
  127. package/dist/insights/tools.d.ts +13 -2
  128. package/dist/instantly/capabilities.d.ts +13 -0
  129. package/dist/instantly/client.d.ts +2 -0
  130. package/dist/instantly/index.js +77 -49
  131. package/dist/instantly/map.d.ts +6 -2
  132. package/dist/internal/adapter.d.ts +12 -0
  133. package/dist/internal/engine/request.d.ts +5 -0
  134. package/dist/internal/entities.d.ts +3 -20
  135. package/dist/internal/errors.d.ts +44 -0
  136. package/dist/internal/fields.d.ts +1 -1
  137. package/dist/internal/json.d.ts +9 -2
  138. package/dist/internal/lists.d.ts +24 -0
  139. package/dist/internal/numbers.d.ts +8 -0
  140. package/dist/internal/outbound/collections.d.ts +4 -0
  141. package/dist/internal/outbound/create.d.ts +24 -3
  142. package/dist/internal/outbound/outbound.d.ts +18 -2
  143. package/dist/internal/outbound/validate.d.ts +4 -0
  144. package/dist/internal/outbound/walker.d.ts +3 -2
  145. package/dist/internal/plural.d.ts +12 -0
  146. package/dist/internal/renamed.d.ts +28 -0
  147. package/dist/internal/request-cap.d.ts +35 -0
  148. package/dist/internal/vocabulary.d.ts +20 -0
  149. package/dist/loader/index.js +5 -5
  150. package/dist/memory/adapter.d.ts +7 -0
  151. package/dist/memory/demo-stats.d.ts +3 -0
  152. package/dist/memory/demo.d.ts +14 -3
  153. package/dist/memory/index.d.ts +1 -0
  154. package/dist/memory/index.js +209 -104
  155. package/dist/providers/index.d.ts +92 -0
  156. package/dist/providers/index.js +3 -1
  157. package/dist/reconcile/index.js +5 -4
  158. package/dist/redact/index.js +13 -7
  159. package/dist/redact/plugin.d.ts +7 -0
  160. package/dist/smartlead/capabilities.d.ts +5 -0
  161. package/dist/smartlead/index.js +119 -66
  162. package/dist/smartlead/shared.d.ts +13 -0
  163. package/dist/sync/index.js +2 -2
  164. package/dist/tools/ai-sdk.js +10 -6
  165. package/dist/tools/campaign-tools.d.ts +1 -1
  166. package/dist/tools/claude-agent.js +10 -6
  167. package/dist/tools/index.d.ts +2 -2
  168. package/dist/tools/index.js +16 -9
  169. package/dist/tools/input-problem.d.ts +8 -0
  170. package/dist/tools/registry.d.ts +26 -2
  171. package/dist/tools/shared.d.ts +27 -1
  172. package/dist/tracing/index.js +2 -2
  173. package/dist/webhooks/index.js +22 -12
  174. package/package.json +8 -2
  175. package/dist/chunks/chunk-FKH5N47I.js +0 -40
@@ -1,22 +1,22 @@
1
1
  import {
2
2
  createTools
3
- } from "./chunk-AFU5E5QB.js";
3
+ } from "./chunk-BK5SLY32.js";
4
4
  import {
5
- createOutbound
6
- } from "./chunk-XNFESPZH.js";
7
- import {
8
- fromEnv
9
- } from "./chunk-RCZ7ZZFU.js";
5
+ plural
6
+ } from "./chunk-4PA526S7.js";
10
7
  import {
11
- providers
12
- } from "./chunk-XC6CZP73.js";
8
+ createOutbound
9
+ } from "./chunk-YYCT3NGV.js";
13
10
  import {
14
11
  campaignStatusSchema,
15
12
  replyCategorySchema
16
- } from "./chunk-4PSO6JEK.js";
13
+ } from "./chunk-QGRZDTX4.js";
14
+ import {
15
+ fromEnv
16
+ } from "./chunk-5J7GGV62.js";
17
17
  import {
18
18
  OutboundError
19
- } from "./chunk-E7JHLNLG.js";
19
+ } from "./chunk-J7DDZ4C2.js";
20
20
  import {
21
21
  field,
22
22
  isJsonObject,
@@ -24,7 +24,10 @@ import {
24
24
  isString,
25
25
  parseJson,
26
26
  toJson
27
- } from "./chunk-VQSCHOBV.js";
27
+ } from "./chunk-BLCJHP5H.js";
28
+ import {
29
+ providers
30
+ } from "./chunk-WH6V3YNN.js";
28
31
 
29
32
  // src/cli/index.ts
30
33
  import { parseArgs } from "node:util";
@@ -80,7 +83,15 @@ var fieldExceptions = (outbound) => Object.fromEntries(
80
83
  return stated.length === 0 ? [] : [[record, Object.fromEntries(stated)]];
81
84
  })
82
85
  );
83
- var listing = async (walk) => asJson(await walk.toArray());
86
+ var listing = async (walk, input, one, many) => {
87
+ const items = await walk.toArray();
88
+ if (walk.truncated) {
89
+ input.note(
90
+ `Stopped at ${plural(items.length, one, many)}; more exist. Pass --limit to read more.`
91
+ );
92
+ }
93
+ return asJson(items);
94
+ };
84
95
  var wantsCard = (input) => input.flags.slack === true || input.flags.card === true;
85
96
  var drawn = async (name, result2, input) => {
86
97
  if (!wantsCard(input)) {
@@ -104,46 +115,91 @@ var runInsight = async (outbound, input) => {
104
115
  const [asTool] = wantsCard(input) ? insightTools(outbound, { only: [name] }) : [];
105
116
  return asTool === void 0 ? asJson(await runInsightByName(outbound, name, insightInput)) : drawn(name, await asTool.call(insightInput), input);
106
117
  };
118
+ var GLOBAL_FLAGS = [
119
+ "cache",
120
+ "compact",
121
+ "config",
122
+ "help",
123
+ "max-requests",
124
+ "no-redact",
125
+ "provider",
126
+ "redact"
127
+ ];
128
+ var checkFlags = (name, flags, given) => {
129
+ const stray = given.find(
130
+ (flag) => !GLOBAL_FLAGS.includes(flag) && !flags.includes(flag)
131
+ );
132
+ if (stray !== void 0) {
133
+ throw new OutboundError(
134
+ "Invalid",
135
+ `--${stray} is not an option of ${name}`
136
+ );
137
+ }
138
+ };
139
+ var SECTIONS = ["sequence", "settings", "stats", "subsequences"];
107
140
  var COMMAND_TABLE = {
108
141
  blocklist: {
142
+ flags: ["limit"],
109
143
  help: "blocklist [--limit N]",
110
- run: (outbound, input) => listing(outbound.blocklist.listAll({ max: count(input, "limit", 50) }))
144
+ run: (outbound, input) => listing(
145
+ outbound.blocklist.listAll({ max: count(input, "limit", 50) }),
146
+ input,
147
+ "entry",
148
+ "entries"
149
+ )
111
150
  },
112
151
  campaign: {
152
+ flags: [
153
+ "by",
154
+ "from",
155
+ "sequence",
156
+ "settings",
157
+ "stats",
158
+ "subsequences",
159
+ "to"
160
+ ],
113
161
  help: "campaign <id> [--stats] [--sequence] [--subsequences] [--settings] [--from YYYY-MM-DD] [--to YYYY-MM-DD] [--by day|total]",
114
162
  run: async (outbound, input) => {
115
163
  const campaign = outbound.campaign(required(input, 0, "a campaign id"));
116
- if (input.flags.sequence === true) {
117
- return asJson(await campaign.sequence());
118
- }
119
- if (input.flags.subsequences === true) {
120
- return await listing(campaign.subsequences.listAll());
121
- }
122
- if (input.flags.settings === true) {
123
- return asJson(await campaign.settings());
124
- }
125
- if (input.flags.stats === true) {
126
- return asJson(
164
+ const by = choice(input, "by", BY);
165
+ const read = {
166
+ sequence: async () => asJson(await campaign.sequence()),
167
+ settings: async () => asJson(await campaign.settings()),
168
+ stats: async () => asJson(
127
169
  await campaign.stats({
128
- by: choice(input, "by", BY),
170
+ by,
129
171
  from: text(input, "from"),
130
172
  to: text(input, "to")
131
173
  })
132
- );
174
+ ),
175
+ subsequences: () => listing(campaign.subsequences.listAll(), input, "subsequence")
176
+ };
177
+ const wanted = SECTIONS.filter(
178
+ (section) => input.flags[section] === true
179
+ );
180
+ if (wanted.length === 0) {
181
+ return asJson(await campaign.get());
133
182
  }
134
- return asJson(await campaign.get());
183
+ const answers = await Promise.all(
184
+ wanted.map(async (section) => [section, await read[section]()])
185
+ );
186
+ return answers.length === 1 ? answers[0]?.[1] ?? null : Object.fromEntries(answers);
135
187
  }
136
188
  },
137
189
  campaigns: {
190
+ flags: ["limit", "status"],
138
191
  help: "campaigns [--status active|paused|draft|completed|archived] [--limit N]",
139
192
  run: (outbound, input) => listing(
140
193
  outbound.campaigns.listAll({
141
194
  max: count(input, "limit", 50),
142
195
  status: choice(input, "status", campaignStatusSchema.options)
143
- })
196
+ }),
197
+ input,
198
+ "campaign"
144
199
  )
145
200
  },
146
201
  capabilities: {
202
+ flags: [],
147
203
  help: "capabilities",
148
204
  run: (outbound) => Promise.resolve({
149
205
  capabilities: { ...outbound.capabilities },
@@ -155,32 +211,44 @@ var COMMAND_TABLE = {
155
211
  })
156
212
  },
157
213
  health: {
214
+ flags: [],
158
215
  help: "health <sender id>",
159
216
  run: async (outbound, input) => asJson(await outbound.sender(required(input, 0, "a sender id")).health())
160
217
  },
161
218
  insight: {
219
+ flags: ["card", "input", "slack"],
162
220
  help: "insight [name] [--input JSON] [--card | --slack] computed answers; no name lists them",
163
221
  run: runInsight
164
222
  },
165
223
  leads: {
224
+ flags: ["campaign", "limit", "list"],
166
225
  help: "leads [--campaign ID | --list ID] [--limit N]",
167
226
  run: (outbound, input) => listing(
168
227
  outbound.leads.listAll({
169
228
  campaignId: text(input, "campaign"),
170
229
  listId: text(input, "list"),
171
230
  max: count(input, "limit", 50)
172
- })
231
+ }),
232
+ input,
233
+ "lead"
173
234
  )
174
235
  },
175
236
  lists: {
237
+ flags: ["limit"],
176
238
  help: "lists [--limit N]",
177
- run: (outbound, input) => listing(outbound.lists.listAll({ max: count(input, "limit", 50) }))
239
+ run: (outbound, input) => listing(
240
+ outbound.lists.listAll({ max: count(input, "limit", 50) }),
241
+ input,
242
+ "list"
243
+ )
178
244
  },
179
245
  limits: {
246
+ flags: [],
180
247
  help: "limits",
181
248
  run: async (outbound) => asJson(await outbound.limits())
182
249
  },
183
250
  native: {
251
+ flags: ["input"],
184
252
  help: "native [name] [--input JSON] the vendor's own reads; no name lists them",
185
253
  run: async (outbound, input) => {
186
254
  const [name] = input.positionals;
@@ -195,9 +263,11 @@ var COMMAND_TABLE = {
195
263
  }
196
264
  },
197
265
  person: {
266
+ flags: ["card", "limit", "slack"],
198
267
  help: "person <email or LinkedIn URL> [--limit N] [--card | --slack] one person's campaigns across every tool",
199
268
  // The person_summary insight, with its input taken from the arguments.
200
269
  run: (outbound, input) => runInsight(outbound, {
270
+ ...input,
201
271
  flags: {
202
272
  ...input.flags,
203
273
  input: JSON.stringify({
@@ -209,6 +279,7 @@ var COMMAND_TABLE = {
209
279
  })
210
280
  },
211
281
  replies: {
282
+ flags: ["bodies", "campaign", "category", "limit", "since"],
212
283
  help: "replies [--campaign ID] [--category positive|negative|neutral|ooo|...] [--since ISO] [--limit N] [--bodies]",
213
284
  run: (outbound, input) => listing(
214
285
  outbound.replies.listAll({
@@ -217,14 +288,23 @@ var COMMAND_TABLE = {
217
288
  include: input.flags.bodies === true ? ["body"] : void 0,
218
289
  max: count(input, "limit", 50),
219
290
  since: text(input, "since")
220
- })
291
+ }),
292
+ input,
293
+ "reply",
294
+ "replies"
221
295
  )
222
296
  },
223
297
  senders: {
298
+ flags: ["limit"],
224
299
  help: "senders [--limit N]",
225
- run: (outbound, input) => listing(outbound.senders.listAll({ max: count(input, "limit", 50) }))
300
+ run: (outbound, input) => listing(
301
+ outbound.senders.listAll({ max: count(input, "limit", 50) }),
302
+ input,
303
+ "sender"
304
+ )
226
305
  },
227
306
  stats: {
307
+ flags: ["by", "from", "to"],
228
308
  help: "stats [--from YYYY-MM-DD] [--to YYYY-MM-DD] [--by day|total]",
229
309
  run: async (outbound, input) => asJson(
230
310
  await outbound.stats({
@@ -235,10 +315,16 @@ var COMMAND_TABLE = {
235
315
  )
236
316
  },
237
317
  tags: {
318
+ flags: ["limit"],
238
319
  help: "tags [--limit N]",
239
- run: (outbound, input) => listing(outbound.tags.listAll({ max: count(input, "limit", 50) }))
320
+ run: (outbound, input) => listing(
321
+ outbound.tags.listAll({ max: count(input, "limit", 50) }),
322
+ input,
323
+ "tag"
324
+ )
240
325
  },
241
326
  thread: {
327
+ flags: ["bodies"],
242
328
  help: "thread <id> [--bodies]",
243
329
  run: async (outbound, input) => asJson(
244
330
  await outbound.thread(required(input, 0, "a thread id")).messages({
@@ -247,6 +333,7 @@ var COMMAND_TABLE = {
247
333
  )
248
334
  },
249
335
  tool: {
336
+ flags: ["card", "input", "slack"],
250
337
  help: "tool <name> [--input JSON] [--card | --slack]",
251
338
  run: async (outbound, input) => {
252
339
  const name = required(input, 0, "a tool name");
@@ -266,6 +353,7 @@ var COMMAND_TABLE = {
266
353
  }
267
354
  },
268
355
  tools: {
356
+ flags: [],
269
357
  help: "tools",
270
358
  run: async (outbound) => {
271
359
  const offered = await offeredTools(outbound);
@@ -276,12 +364,15 @@ var COMMAND_TABLE = {
276
364
  }
277
365
  },
278
366
  webhooks: {
367
+ flags: ["campaign", "limit"],
279
368
  help: "webhooks [--campaign ID] [--limit N]",
280
369
  run: (outbound, input) => listing(
281
370
  outbound.webhooks.listAll({
282
371
  campaignId: text(input, "campaign"),
283
372
  max: count(input, "limit", 50)
284
- })
373
+ }),
374
+ input,
375
+ "webhook"
285
376
  )
286
377
  }
287
378
  };
@@ -299,15 +390,7 @@ var listProviders = () => providers.map((provider) => ({
299
390
  name: provider.name,
300
391
  note: provider.note
301
392
  }));
302
- var helpText = () => [
303
- "outbound: read-only access to outbound sending tools",
304
- "",
305
- "Usage: outbound <command> [options]",
306
- "",
307
- " providers",
308
- ...[...COMMANDS.values()].map((command) => ` ${command.help}`),
309
- " mcp start a local MCP server on stdio (redact is on)",
310
- "",
393
+ var GLOBAL_HELP = [
311
394
  "Options:",
312
395
  " --provider <id> the adapter to use, or all for every provider whose key is set (default: OUTBOUND_SDK_PROVIDER)",
313
396
  " --compact print JSON on one line",
@@ -318,7 +401,21 @@ var helpText = () => [
318
401
  " --max-requests <n> the most vendor requests one command, or one MCP tool call, may make",
319
402
  "",
320
403
  "Each adapter reads its own key from the environment, for example INSTANTLY_API_KEY."
404
+ ];
405
+ var helpText = () => [
406
+ "outbound: read-only access to outbound sending tools",
407
+ "",
408
+ "Usage: outbound <command> [options]",
409
+ "",
410
+ " providers",
411
+ ...[...COMMANDS.values()].map((command) => ` ${command.help}`),
412
+ " mcp start a local MCP server on stdio (redact is on)",
413
+ " version print the installed version (also --version, -v)",
414
+ " update check npm for a newer version and say how to get it",
415
+ "",
416
+ ...GLOBAL_HELP
321
417
  ].join("\n");
418
+ var commandHelp = (command) => [`Usage: outbound ${command.help}`, "", ...GLOBAL_HELP].join("\n");
322
419
 
323
420
  // src/cli/config.ts
324
421
  import path from "node:path";
@@ -463,10 +560,11 @@ var createMcpServer = (outbound, options = {}) => {
463
560
  const name = field(params, "name");
464
561
  const tool = isString(name) ? byName.get(name) : void 0;
465
562
  if (tool === void 0) {
563
+ const why = isString(name) ? options.leftOut?.[name] : void 0;
466
564
  return failure(
467
565
  id,
468
566
  INVALID_PARAMS,
469
- `Unknown tool: ${isString(name) ? name : "(none)"}`
567
+ why ?? `Unknown tool: ${isString(name) ? name : "(none)"}`
470
568
  );
471
569
  }
472
570
  budget?.reset();
@@ -545,6 +643,13 @@ var serveStdio = async (server, options = {}) => {
545
643
  }
546
644
  };
547
645
 
646
+ // src/cli/update.ts
647
+ import { execFile } from "node:child_process";
648
+ import path2 from "node:path";
649
+ import process2 from "node:process";
650
+ import { fileURLToPath } from "node:url";
651
+ import { promisify } from "node:util";
652
+
548
653
  // src/cli/version.ts
549
654
  import { readFileSync } from "node:fs";
550
655
  import { z } from "zod";
@@ -558,6 +663,84 @@ var packageVersion = () => Manifest.parse(
558
663
  )
559
664
  ).version;
560
665
 
666
+ // src/cli/update.ts
667
+ var PACKAGE = "outbound-sdk";
668
+ var STANDALONE = /* @__PURE__ */ new Map([
669
+ ["mcp", []],
670
+ ["providers", []],
671
+ ["update", []],
672
+ ["version", ["version"]]
673
+ ]);
674
+ var execFileAsync = promisify(execFile);
675
+ var runNpm = async (args) => {
676
+ try {
677
+ const { stdout } = await execFileAsync("npm", [...args], {
678
+ shell: process2.platform === "win32"
679
+ });
680
+ return stdout;
681
+ } catch (error) {
682
+ const stderr = error instanceof Error && "stderr" in error ? String(error.stderr) : "";
683
+ const said = stderr.trim().split("\n").at(-1) ?? "";
684
+ throw new Error(
685
+ `npm ${args.join(" ")} failed${said === "" ? "" : `: ${said}`}`,
686
+ { cause: error }
687
+ );
688
+ }
689
+ };
690
+ var packageDir = () => path2.dirname(fileURLToPath(new URL("../../package.json", import.meta.url)));
691
+ var parts = (version) => version.split("-")[0]?.split(".").map((part) => Math.trunc(Number(part)) || 0) ?? [];
692
+ var older = (a, b) => {
693
+ const [left, right] = [parts(a), parts(b)];
694
+ for (let index = 0; index < 3; index += 1) {
695
+ const difference = (left[index] ?? 0) - (right[index] ?? 0);
696
+ if (difference !== 0) {
697
+ return difference < 0;
698
+ }
699
+ }
700
+ return false;
701
+ };
702
+ var installKind = async (npm, dir) => {
703
+ if (dir.split(path2.sep).includes("_npx")) {
704
+ return "npx";
705
+ }
706
+ const printed = await npm(["root", "--global"]).catch(() => "");
707
+ const globalRoot = printed.trim();
708
+ return globalRoot !== "" && path2.dirname(dir) === path2.resolve(globalRoot) ? "global" : "project";
709
+ };
710
+ var update = async (npm, say) => {
711
+ const installed = packageVersion();
712
+ const viewed = await npm(["view", PACKAGE, "version"]);
713
+ const latest = viewed.trim();
714
+ if (!older(installed, latest)) {
715
+ say(`${PACKAGE} ${installed} is the latest version.`);
716
+ return;
717
+ }
718
+ say(`${PACKAGE} ${installed} is installed; ${latest} is the latest.`);
719
+ const kind = await installKind(npm, packageDir());
720
+ if (kind === "npx") {
721
+ say(`Run "npx ${PACKAGE}@latest <command>" to use ${latest}.`);
722
+ return;
723
+ }
724
+ if (kind === "project") {
725
+ say(`Run "npm install ${PACKAGE}@latest" in this project to update it.`);
726
+ return;
727
+ }
728
+ say(`Running "npm install --global ${PACKAGE}@latest"...`);
729
+ await npm(["install", "--global", `${PACKAGE}@latest`]);
730
+ say(`Updated ${PACKAGE} to ${latest}.`);
731
+ };
732
+ var runSelf = async (name, flags, npm, say) => {
733
+ if (name === "version" || name === void 0 && flags.version === true) {
734
+ say(packageVersion());
735
+ return true;
736
+ }
737
+ if (name === "update" && flags.help !== true) {
738
+ await update(npm, say);
739
+ return true;
740
+ }
741
+ return false;
742
+ };
743
+
561
744
  // src/cli/index.ts
562
745
  var OPTIONS = {
563
746
  bodies: { type: "boolean" },
@@ -584,12 +767,24 @@ var OPTIONS = {
584
767
  stats: { type: "boolean" },
585
768
  status: { type: "string" },
586
769
  subsequences: { type: "boolean" },
587
- to: { type: "string" }
770
+ to: { type: "string" },
771
+ version: { short: "v", type: "boolean" }
588
772
  };
589
- var serve = async (outbound, io) => {
773
+ var serve = async (outbound, io, unmasked) => {
590
774
  const { insightTools } = await import("../insights/index.js");
775
+ const offered = (instance) => createTools(instance, { extra: insightTools(instance) }).map(
776
+ (tool) => tool.name
777
+ );
778
+ const here = new Set(offered(outbound));
779
+ const leftOut = Object.fromEntries(
780
+ (unmasked === void 0 ? [] : offered(unmasked)).filter((name) => !here.has(name)).map((name) => [
781
+ name,
782
+ `${name} is left out while the redact plugin is on: it needs what redact masks. Start the server with --no-redact to offer it; personal fields are then not masked.`
783
+ ])
784
+ );
591
785
  const server = createMcpServer(outbound, {
592
786
  extra: insightTools(outbound),
787
+ leftOut,
593
788
  version: packageVersion()
594
789
  });
595
790
  await serveStdio(server, { input: io.stdin?.() ?? [], write: io.stdout });
@@ -597,39 +792,78 @@ var serve = async (outbound, io) => {
597
792
  var print = (io, value, compact) => {
598
793
  io.stdout(compact ? JSON.stringify(value) : JSON.stringify(value, null, 2));
599
794
  };
795
+ var parseStrict = (argv) => parseArgs({ allowPositionals: true, args: [...argv], options: OPTIONS });
796
+ var helpFor = (name, asked) => {
797
+ const command = name === void 0 ? void 0 : COMMANDS.get(name);
798
+ if (name === void 0 || name === "help" || asked && !command) {
799
+ return helpText();
800
+ }
801
+ return asked && command ? commandHelp(command) : void 0;
802
+ };
803
+ var parse = (argv) => {
804
+ const loose = parseArgs({
805
+ allowPositionals: true,
806
+ args: [...argv],
807
+ options: OPTIONS,
808
+ strict: false,
809
+ tokens: true
810
+ });
811
+ const [name] = loose.positionals;
812
+ const command = name === void 0 ? void 0 : COMMANDS.get(name);
813
+ const named = name !== void 0 && name !== "help";
814
+ if (named && !command && !STANDALONE.has(name)) {
815
+ throw new OutboundError(
816
+ "Invalid",
817
+ `Unknown command "${name}". Run "outbound help"`
818
+ );
819
+ }
820
+ if (named) {
821
+ checkFlags(
822
+ name,
823
+ command?.flags ?? STANDALONE.get(name) ?? [],
824
+ loose.tokens.flatMap(
825
+ (token) => token.kind === "option" ? [token.name] : []
826
+ )
827
+ );
828
+ }
829
+ const { positionals, values } = parseStrict(argv);
830
+ return {
831
+ help: helpFor(name, values.help === true),
832
+ name,
833
+ rest: positionals.slice(1),
834
+ values
835
+ };
836
+ };
600
837
  var run = async (argv, io) => {
601
838
  try {
602
- const { positionals, values } = parseArgs({
603
- allowPositionals: true,
604
- args: [...argv],
605
- options: OPTIONS
606
- });
607
- const [name, ...rest] = positionals;
839
+ const { help, name, rest, values } = parse(argv);
608
840
  const compact = values.compact === true;
609
- if (name === void 0 || name === "help" || values.help === true) {
610
- io.stdout(helpText());
841
+ if (await runSelf(name, values, io.npm ?? runNpm, io.stdout)) {
842
+ return 0;
843
+ }
844
+ if (help !== void 0) {
845
+ io.stdout(help);
611
846
  return 0;
612
847
  }
613
848
  if (name === "providers") {
614
849
  print(io, listProviders(), compact);
615
850
  return 0;
616
851
  }
617
- const command = name === "mcp" ? void 0 : COMMANDS.get(name);
618
- if (name !== "mcp" && command === void 0) {
619
- throw new OutboundError(
620
- "Invalid",
621
- `Unknown command "${name}". Run "outbound help"`
622
- );
623
- }
852
+ const command = name === void 0 ? void 0 : COMMANDS.get(name);
624
853
  const adapter = io.adapter ?? await fromEnv({ provider: values.provider });
625
854
  const plugins = await pluginsFor(values, command === void 0);
626
855
  const outbound = createOutbound({ adapter, plugins });
627
856
  if (command === void 0) {
628
- await serve(outbound, io);
857
+ const unmasked = plugins.some((plugin) => plugin.name === "redact") ? createOutbound({
858
+ adapter,
859
+ plugins: plugins.filter((plugin) => plugin.name !== "redact")
860
+ }) : void 0;
861
+ await serve(outbound, io, unmasked);
629
862
  return 0;
630
863
  }
631
864
  const answer = await command.run(outbound, {
632
865
  flags: values,
866
+ note: io.stderr,
633
867
  positionals: rest
634
868
  });
635
869
  print(io, answer, compact);
@@ -0,0 +1,71 @@
1
+ // src/internal/lead-fields.ts
2
+ var MAPPABLE = [
3
+ "company",
4
+ "companyLinkedinUrl",
5
+ "linkedinUrl",
6
+ "location",
7
+ "phone",
8
+ "title",
9
+ "website"
10
+ ];
11
+ var fillFromCustom = (lead, map) => {
12
+ const filled = {};
13
+ for (const field of MAPPABLE) {
14
+ const name = map[field];
15
+ const value = name === void 0 ? void 0 : lead.custom[name]?.trim();
16
+ if (lead[field] === null && value !== void 0 && value !== "") {
17
+ filled[field] = value;
18
+ }
19
+ }
20
+ return { ...lead, ...filled };
21
+ };
22
+ var withLeadFields = (readers, map) => {
23
+ if (map === void 0 || Object.keys(map).length === 0) {
24
+ return readers;
25
+ }
26
+ const { getLead, listLeads } = readers;
27
+ const wrapped = {
28
+ ...getLead && {
29
+ getLead: async (id, ctx) => fillFromCustom(await getLead(id, ctx), map)
30
+ },
31
+ ...listLeads && {
32
+ listLeads: async (query, ctx) => {
33
+ const page = await listLeads(query, ctx);
34
+ return {
35
+ items: page.items.map((lead) => fillFromCustom(lead, map)),
36
+ next: page.next
37
+ };
38
+ }
39
+ }
40
+ };
41
+ return { ...readers, ...wrapped };
42
+ };
43
+ var withMappedFields = (declared, map) => {
44
+ const lead = declared.lead === false ? void 0 : declared.lead;
45
+ if (map === void 0 || lead === void 0) {
46
+ return declared;
47
+ }
48
+ const derived = Object.fromEntries(
49
+ MAPPABLE.flatMap(
50
+ (field) => map[field] !== void 0 && lead[field] === false ? [[field, "derived"]] : []
51
+ )
52
+ );
53
+ return { ...declared, lead: { ...lead, ...derived } };
54
+ };
55
+
56
+ // src/internal/page.ts
57
+ var mapPage = (page, toItem) => ({
58
+ items: page.items.map((raw) => toItem(raw)),
59
+ next: page.next
60
+ });
61
+ var flatMapPage = (page, toItems) => ({
62
+ items: page.items.flatMap((raw) => toItems(raw)),
63
+ next: page.next
64
+ });
65
+
66
+ export {
67
+ withLeadFields,
68
+ withMappedFields,
69
+ mapPage,
70
+ flatMapPage
71
+ };