@sellable/mcp 0.1.555 → 0.1.557

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 (63) hide show
  1. package/README.md +13 -2
  2. package/agents/registry.json +2 -2
  3. package/dist/api.js +3 -6
  4. package/dist/auth.d.ts +0 -6
  5. package/dist/auth.js +2 -44
  6. package/dist/refill-run-client.d.ts +0 -5
  7. package/dist/refill-run-client.js +0 -15
  8. package/dist/refill-run-loop.d.ts +1 -12
  9. package/dist/refill-run-loop.js +13 -158
  10. package/dist/server.js +23 -0
  11. package/dist/tools/auth.d.ts +0 -5
  12. package/dist/tools/auth.js +12 -49
  13. package/dist/tools/campaign-message-preparation.d.ts +0 -62
  14. package/dist/tools/campaign-message-preparation.js +0 -41
  15. package/dist/tools/campaigns.js +2 -2
  16. package/dist/tools/csv-dnc.js +2 -2
  17. package/dist/tools/evergreen-refill-plan.d.ts +0 -3
  18. package/dist/tools/evergreen-refill-plan.js +7 -29
  19. package/dist/tools/find-leads-runs.d.ts +151 -0
  20. package/dist/tools/find-leads-runs.js +98 -0
  21. package/dist/tools/leads.d.ts +317 -32
  22. package/dist/tools/leads.js +171 -10
  23. package/dist/tools/model-quality.js +4 -6
  24. package/dist/tools/prompts.d.ts +3 -3
  25. package/dist/tools/prompts.js +7 -15
  26. package/dist/tools/provider-preflight.d.ts +65 -2
  27. package/dist/tools/provider-preflight.js +97 -10
  28. package/dist/tools/readiness.d.ts +89 -5
  29. package/dist/tools/readiness.js +66 -0
  30. package/dist/tools/refill-executors.d.ts +0 -38
  31. package/dist/tools/refill-executors.js +3 -222
  32. package/dist/tools/refill-sends-v2.d.ts +1 -112
  33. package/dist/tools/refill-sends-v2.js +2 -302
  34. package/dist/tools/refill-sends.d.ts +32 -678
  35. package/dist/tools/refill-sends.js +13 -274
  36. package/dist/tools/refill-target-plan.js +14 -486
  37. package/dist/tools/registry.d.ts +330 -115
  38. package/dist/tools/registry.js +7 -1
  39. package/dist/tools/scheduler-fill-capacity.js +1 -1
  40. package/dist/tools/scheduler-run.d.ts +0 -71
  41. package/dist/tools/scheduler-run.js +1 -203
  42. package/dist/tools/setup-evergreen-campaigns.js +1 -1
  43. package/dist/tools/workspace-context.d.ts +1 -1
  44. package/dist/tools/workspace-context.js +3 -8
  45. package/dist/tools/workspace-export.js +2 -2
  46. package/dist/tools/workspaces.d.ts +2 -48
  47. package/dist/tools/workspaces.js +5 -48
  48. package/package.json +1 -1
  49. package/skills/create-campaign/SKILL.md +3 -3
  50. package/skills/create-campaign-v2/SKILL.md +1 -1
  51. package/skills/create-evergreen-campaigns/SKILL.md +16 -16
  52. package/skills/find-leads/SKILL.md +48 -630
  53. package/skills/find-leads-v2/SKILL.md +70 -0
  54. package/skills/find-leads-v2/core/flow.v1.json +31 -0
  55. package/skills/refill-sends/SKILL.md +353 -91
  56. package/skills/refill-sends-v2/SKILL.md +6 -6
  57. package/skills/refill-sends-v2-workflow/SKILL.md +5 -5
  58. package/skills/refill-sends-v2-workflow/core/flow.v1.json +8 -8
  59. package/skills/refill-sends-workflow/SKILL.md +743 -100
  60. package/skills/refill-sends-workflow/core/flow.v1.json +1 -185
  61. package/dist/refill-contract.d.ts +0 -157
  62. package/dist/refill-contract.js +0 -487
  63. package/skills/refill-sends-workflow/core/contract.v2.json +0 -543
@@ -1,543 +0,0 @@
1
- {
2
- "contractVersion": "2.0.0",
3
- "cacheVersion": "refill-contract-v1",
4
- "supportedMajor": 2,
5
- "semantics": {
6
- "scope": [
7
- {
8
- "id": "workspace_id"
9
- },
10
- {
11
- "id": "target_date"
12
- },
13
- {
14
- "id": "sender_selectors"
15
- },
16
- {
17
- "id": "campaign_selectors"
18
- },
19
- {
20
- "id": "approval_mode"
21
- },
22
- {
23
- "id": "contract_identity"
24
- },
25
- {
26
- "id": "installed_identity"
27
- }
28
- ],
29
- "gates": [
30
- {
31
- "id": "workspace_access"
32
- },
33
- {
34
- "id": "approval_packet"
35
- },
36
- {
37
- "id": "source_family"
38
- },
39
- {
40
- "id": "threshold"
41
- },
42
- {
43
- "id": "scheduler"
44
- },
45
- {
46
- "id": "campaign_lifecycle"
47
- },
48
- {
49
- "id": "send_time"
50
- },
51
- {
52
- "id": "no_direct_send"
53
- },
54
- {
55
- "id": "one_primitive"
56
- },
57
- {
58
- "id": "fresh_reread"
59
- },
60
- {
61
- "id": "normalized_accounting"
62
- },
63
- {
64
- "id": "prep_circuit"
65
- },
66
- {
67
- "id": "terminal_truth"
68
- }
69
- ],
70
- "states": [
71
- {
72
- "id": "planning"
73
- },
74
- {
75
- "id": "awaiting_approval"
76
- },
77
- {
78
- "id": "executing"
79
- },
80
- {
81
- "id": "settling"
82
- },
83
- {
84
- "id": "replanning"
85
- },
86
- {
87
- "id": "terminal"
88
- }
89
- ],
90
- "actions": [
91
- {
92
- "id": "prepare_messages",
93
- "sideEffectClass": "message_preparation"
94
- },
95
- {
96
- "id": "approve_messages",
97
- "sideEffectClass": "message_approval"
98
- },
99
- {
100
- "id": "rerun_errored_cells",
101
- "sideEffectClass": "message_preparation"
102
- },
103
- {
104
- "id": "start_paused_campaign",
105
- "sideEffectClass": "campaign_start"
106
- },
107
- {
108
- "id": "run_scheduler_sweep",
109
- "sideEffectClass": "scheduler_placement"
110
- },
111
- {
112
- "id": "scheduler_first_settle",
113
- "sideEffectClass": "read_only"
114
- },
115
- {
116
- "id": "wait_for_scheduler",
117
- "sideEffectClass": "read_only"
118
- },
119
- {
120
- "id": "wait_for_active_work",
121
- "sideEffectClass": "read_only"
122
- },
123
- {
124
- "id": "wait_for_source_import",
125
- "sideEffectClass": "read_only"
126
- },
127
- {
128
- "id": "copy_selected_source_rows",
129
- "sideEffectClass": "source_replenishment"
130
- },
131
- {
132
- "id": "continue_signal_discovery_source",
133
- "sideEffectClass": "source_replenishment"
134
- },
135
- {
136
- "id": "continue_sales_nav_source",
137
- "sideEffectClass": "source_replenishment"
138
- },
139
- {
140
- "id": "continue_prospeo_source",
141
- "sideEffectClass": "source_replenishment"
142
- },
143
- {
144
- "id": "manual_source_replenishment",
145
- "sideEffectClass": "source_replenishment"
146
- },
147
- {
148
- "id": "refresh_paid_inmail_credits",
149
- "sideEffectClass": "credit_refresh"
150
- },
151
- {
152
- "id": "lower_paid_inmail_threshold",
153
- "sideEffectClass": "read_only"
154
- },
155
- {
156
- "id": "switch_to_connection_lane",
157
- "sideEffectClass": "read_only"
158
- },
159
- {
160
- "id": "create_connection_campaign",
161
- "sideEffectClass": "read_only"
162
- },
163
- {
164
- "id": "next_campaign",
165
- "sideEffectClass": "read_only"
166
- },
167
- {
168
- "id": "done",
169
- "sideEffectClass": "read_only"
170
- }
171
- ],
172
- "receipts": [
173
- {
174
- "id": "target_plan_receipt",
175
- "requiredFields": [
176
- "refillLaneKey",
177
- "branchMetrics",
178
- "ledger",
179
- "targetDate",
180
- "actionKey",
181
- "targetShapeRevision",
182
- "stateRevision"
183
- ]
184
- },
185
- {
186
- "id": "preparation_receipt",
187
- "requiredFields": [
188
- "dependency",
189
- "circuit",
190
- "batchCalibration",
191
- "cooperativeStop"
192
- ]
193
- },
194
- {
195
- "id": "scheduler_receipt",
196
- "requiredFields": [
197
- "receiptVersion",
198
- "diagnosticsVersion",
199
- "status",
200
- "trigger",
201
- "workspaceId",
202
- "runId",
203
- "leaseFence",
204
- "expectedTargetsHash",
205
- "maxPlacements",
206
- "readyCellsFound",
207
- "cellsConsidered",
208
- "cellsScheduled",
209
- "cellsSkipped",
210
- "cellsDeferred",
211
- "campaignScopeSummary",
212
- "expectedTargetSummary",
213
- "changedCounts",
214
- "summary",
215
- "nextAction",
216
- "errorCount",
217
- "error"
218
- ]
219
- },
220
- {
221
- "id": "run_receipt",
222
- "requiredFields": [
223
- "runId",
224
- "fence",
225
- "gate",
226
- "gateSeq",
227
- "events",
228
- "doneReason"
229
- ]
230
- }
231
- ],
232
- "sideEffectClasses": [
233
- {
234
- "id": "read_only"
235
- },
236
- {
237
- "id": "message_preparation"
238
- },
239
- {
240
- "id": "message_approval"
241
- },
242
- {
243
- "id": "source_replenishment"
244
- },
245
- {
246
- "id": "credit_refresh"
247
- },
248
- {
249
- "id": "campaign_start"
250
- },
251
- {
252
- "id": "scheduler_placement"
253
- }
254
- ],
255
- "forbiddenActions": [
256
- {
257
- "id": "direct_send"
258
- },
259
- {
260
- "id": "raw_scheduler_write"
261
- },
262
- {
263
- "id": "campaign_create"
264
- },
265
- {
266
- "id": "campaign_archive_delete"
267
- },
268
- {
269
- "id": "threshold_lowering"
270
- },
271
- {
272
- "id": "unselected_source_mutation"
273
- },
274
- {
275
- "id": "unapproved_campaign_start"
276
- },
277
- {
278
- "id": "sender_config_write"
279
- }
280
- ],
281
- "terminalReasons": [
282
- {
283
- "id": "projected_full",
284
- "terminalKind": "complete"
285
- },
286
- {
287
- "id": "concrete_blocker",
288
- "terminalKind": "stopped"
289
- },
290
- {
291
- "id": "deadline_reached",
292
- "terminalKind": "stopped"
293
- },
294
- {
295
- "id": "iteration_limit",
296
- "terminalKind": "stopped"
297
- },
298
- {
299
- "id": "operator_stopped",
300
- "terminalKind": "stopped"
301
- },
302
- {
303
- "id": "capped_by_scheduler",
304
- "terminalKind": "stopped"
305
- },
306
- {
307
- "id": "loaded_awaiting_scheduler",
308
- "terminalKind": "stopped"
309
- },
310
- {
311
- "id": "lanes_exhausted",
312
- "terminalKind": "stopped"
313
- },
314
- {
315
- "id": "not_an_evergreen_workspace",
316
- "terminalKind": "stopped"
317
- },
318
- {
319
- "id": "no_refillable_campaigns",
320
- "terminalKind": "stopped"
321
- }
322
- ],
323
- "transitions": [
324
- {
325
- "from": "planning",
326
- "to": "awaiting_approval"
327
- },
328
- {
329
- "from": "awaiting_approval",
330
- "to": "executing"
331
- },
332
- {
333
- "from": "executing",
334
- "to": "settling"
335
- },
336
- {
337
- "from": "settling",
338
- "to": "replanning"
339
- },
340
- {
341
- "from": "replanning",
342
- "to": "executing"
343
- },
344
- {
345
- "from": "replanning",
346
- "to": "terminal"
347
- }
348
- ]
349
- },
350
- "backendBindings": {
351
- "planner": {
352
- "actions": [
353
- "prepare_messages",
354
- "approve_messages",
355
- "rerun_errored_cells",
356
- "start_paused_campaign",
357
- "run_scheduler_sweep",
358
- "scheduler_first_settle",
359
- "wait_for_scheduler",
360
- "wait_for_active_work",
361
- "wait_for_source_import",
362
- "copy_selected_source_rows",
363
- "continue_signal_discovery_source",
364
- "continue_sales_nav_source",
365
- "continue_prospeo_source",
366
- "manual_source_replenishment",
367
- "refresh_paid_inmail_credits",
368
- "lower_paid_inmail_threshold",
369
- "switch_to_connection_lane",
370
- "create_connection_campaign",
371
- "next_campaign",
372
- "done"
373
- ],
374
- "receiptFields": [
375
- "refillLaneKey",
376
- "branchMetrics",
377
- "ledger",
378
- "targetDate",
379
- "actionKey",
380
- "targetShapeRevision",
381
- "stateRevision"
382
- ]
383
- },
384
- "preparation": {
385
- "dependencyClasses": [
386
- "active",
387
- "transient",
388
- "permanent",
389
- "changed",
390
- "exhausted"
391
- ],
392
- "dependencyReasons": [
393
- "active_cells",
394
- "dependency_timeout",
395
- "rate_limited",
396
- "provider_unavailable",
397
- "authentication_failed",
398
- "validation_failed",
399
- "schema_invalid",
400
- "config_epoch_changed",
401
- "source_epoch_changed",
402
- "frontier_exhausted",
403
- "unknown_dependency"
404
- ],
405
- "circuitStates": [
406
- "closed",
407
- "open",
408
- "half_open",
409
- "reset"
410
- ],
411
- "cooperativeStopReasons": [
412
- "target_satisfied_during_prep"
413
- ],
414
- "receiptFields": [
415
- "dependency",
416
- "circuit",
417
- "batchCalibration",
418
- "cooperativeStop"
419
- ]
420
- },
421
- "scheduler": {
422
- "targetOutcomes": [
423
- "included",
424
- "omitted"
425
- ],
426
- "omissionReasons": [
427
- "no_ready_cells",
428
- "not_scheduler_eligible",
429
- "sender_mismatch",
430
- "capacity_prefiltered",
431
- "outside_target_date",
432
- "receipt_error"
433
- ],
434
- "runStatuses": [
435
- "ran",
436
- "window_closed_noop",
437
- "failed"
438
- ],
439
- "nextActions": [
440
- "refresh_paid_inmail_credits_then_rerun",
441
- "wait_for_capacity_or_window",
442
- "inspect_sender_mismatch",
443
- "no_ready_cells_continue_refill_prep",
444
- "scheduled_cells",
445
- "investigate_deferred_reasons",
446
- "investigate_scheduler_failure"
447
- ],
448
- "receiptFields": [
449
- "receiptVersion",
450
- "diagnosticsVersion",
451
- "status",
452
- "trigger",
453
- "workspaceId",
454
- "runId",
455
- "leaseFence",
456
- "expectedTargetsHash",
457
- "maxPlacements",
458
- "readyCellsFound",
459
- "cellsConsidered",
460
- "cellsScheduled",
461
- "cellsSkipped",
462
- "cellsDeferred",
463
- "campaignScopeSummary",
464
- "expectedTargetSummary",
465
- "changedCounts",
466
- "summary",
467
- "nextAction",
468
- "errorCount",
469
- "error"
470
- ]
471
- },
472
- "run": {
473
- "gates": [
474
- "g0_bootstrap",
475
- "g1_plan",
476
- "g2_execute",
477
- "g3_verify",
478
- "g4_terminal"
479
- ],
480
- "states": [
481
- "planning",
482
- "awaiting_approval",
483
- "executing",
484
- "settling",
485
- "replanning",
486
- "terminal"
487
- ],
488
- "resultKinds": [
489
- "started",
490
- "awaiting_approval",
491
- "active_run_in_progress",
492
- "resumed",
493
- "lease_lost",
494
- "scope_drift",
495
- "approval_expired",
496
- "approval_fingerprint_mismatch"
497
- ],
498
- "terminalReasons": [
499
- "complete",
500
- "capped_by_scheduler",
501
- "loaded_awaiting_scheduler",
502
- "lanes_exhausted",
503
- "blocked",
504
- "not_an_evergreen_workspace",
505
- "no_refillable_campaigns"
506
- ],
507
- "refusals": [
508
- "scope_drift",
509
- "approval_expired",
510
- "approval_fingerprint_mismatch",
511
- "legacy_read_only",
512
- "expected_target_overflow",
513
- "scheduler_receipt_incomplete"
514
- ],
515
- "scopeFields": [
516
- "workspaceId",
517
- "intent",
518
- "senderIds",
519
- "campaignIds",
520
- "tableIds",
521
- "actionIds",
522
- "approvalMode",
523
- "dateSelector",
524
- "senderTimezones",
525
- "expectedTargetsHash",
526
- "maxPlacements",
527
- "contract",
528
- "installed"
529
- ],
530
- "approvalFields": [
531
- "scopeHash",
532
- "targetShapeRevision",
533
- "actionFingerprint",
534
- "expectedTargetsHash",
535
- "sideEffectEnvelope",
536
- "maxPlacements",
537
- "approvalExpiresAt",
538
- "approvalFingerprint"
539
- ]
540
- }
541
- },
542
- "contractHash": "e54ba0f80bc534fd70fd8c10c1caab109fe9a91c205cfc423f5f6735cd53fdc1"
543
- }