@signaliz/sdk 1.0.20 → 1.0.22
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/README.md +39 -706
- package/dist/chunk-UBQDPJGW.mjs +593 -0
- package/dist/index.d.mts +81 -4754
- package/dist/index.d.ts +81 -4754
- package/dist/index.js +188 -9744
- package/dist/index.mjs +3 -59
- package/dist/mcp-config.js +191 -9684
- package/dist/mcp-config.mjs +6 -6
- package/package.json +5 -6
- package/dist/chunk-PBJFIO72.mjs +0 -10121
- package/dist/cli.d.mts +0 -1
- package/dist/cli.d.ts +0 -1
- package/dist/cli.js +0 -11954
- package/dist/cli.mjs +0 -1694
package/dist/index.d.mts
CHANGED
|
@@ -1,17 +1,28 @@
|
|
|
1
1
|
interface SignalizConfig {
|
|
2
|
-
/** API key (sk_...) — simplest auth method */
|
|
3
2
|
apiKey?: string;
|
|
4
|
-
/** OAuth2 client ID for M2M auth */
|
|
5
3
|
clientId?: string;
|
|
6
|
-
/** OAuth2 client secret for M2M auth */
|
|
7
4
|
clientSecret?: string;
|
|
8
|
-
/** Base URL override (defaults to https://api.signaliz.com/functions/v1) */
|
|
9
5
|
baseUrl?: string;
|
|
10
|
-
/** Request timeout in ms (default: 120_000) */
|
|
11
6
|
timeout?: number;
|
|
12
|
-
/** Max retries on 429/5xx (default: 3) */
|
|
13
7
|
maxRetries?: number;
|
|
14
8
|
}
|
|
9
|
+
interface BatchOptions {
|
|
10
|
+
/** Maximum simultaneous API requests. Defaults to 10; allowed range is 1-50. */
|
|
11
|
+
concurrency?: number;
|
|
12
|
+
}
|
|
13
|
+
interface BatchItemResult<T> {
|
|
14
|
+
index: number;
|
|
15
|
+
success: boolean;
|
|
16
|
+
data?: T;
|
|
17
|
+
error?: string;
|
|
18
|
+
}
|
|
19
|
+
interface BatchResult<T> {
|
|
20
|
+
total: number;
|
|
21
|
+
succeeded: number;
|
|
22
|
+
failed: number;
|
|
23
|
+
durationMs: number;
|
|
24
|
+
results: BatchItemResult<T>[];
|
|
25
|
+
}
|
|
15
26
|
type ErrorType = 'validation' | 'not_found' | 'rate_limited' | 'provider_error' | 'timeout' | 'auth_expired' | 'insufficient_credits' | 'unknown';
|
|
16
27
|
interface SignalizErrorData {
|
|
17
28
|
code: string;
|
|
@@ -21,174 +32,90 @@ interface SignalizErrorData {
|
|
|
21
32
|
details?: Record<string, unknown>;
|
|
22
33
|
}
|
|
23
34
|
interface FindEmailParams {
|
|
35
|
+
companyDomain: string;
|
|
24
36
|
fullName?: string;
|
|
25
37
|
firstName?: string;
|
|
26
38
|
lastName?: string;
|
|
27
|
-
companyDomain: string;
|
|
28
39
|
linkedinUrl?: string;
|
|
29
40
|
companyName?: string;
|
|
30
41
|
}
|
|
31
42
|
interface FindEmailResult {
|
|
32
|
-
|
|
43
|
+
success: boolean;
|
|
44
|
+
found: boolean;
|
|
45
|
+
email: string | null;
|
|
33
46
|
firstName?: string;
|
|
34
47
|
lastName?: string;
|
|
35
48
|
confidence: number;
|
|
36
|
-
verificationStatus:
|
|
49
|
+
verificationStatus: string;
|
|
37
50
|
providerUsed: string;
|
|
51
|
+
error?: string;
|
|
52
|
+
errorCode?: string;
|
|
53
|
+
raw: Record<string, unknown>;
|
|
38
54
|
}
|
|
39
55
|
interface VerifyEmailResult {
|
|
40
56
|
email: string;
|
|
41
57
|
isValid: boolean;
|
|
42
58
|
isDeliverable: boolean;
|
|
43
59
|
isCatchAll: boolean;
|
|
44
|
-
provider?: string;
|
|
45
60
|
confidenceScore: number;
|
|
61
|
+
provider?: string;
|
|
46
62
|
verificationSource?: string;
|
|
63
|
+
raw: Record<string, unknown>;
|
|
47
64
|
}
|
|
48
|
-
interface
|
|
49
|
-
}
|
|
50
|
-
interface EmailBatchJobResult {
|
|
51
|
-
jobId: string;
|
|
52
|
-
status: string;
|
|
53
|
-
capability: string;
|
|
54
|
-
itemsTotal: number;
|
|
55
|
-
message: string;
|
|
56
|
-
estimatedTimeSeconds?: number;
|
|
57
|
-
skippedCount?: number;
|
|
58
|
-
queuePosition?: number;
|
|
59
|
-
estimatedStartTime?: string;
|
|
60
|
-
}
|
|
61
|
-
interface EnrichSignalsParams {
|
|
62
|
-
companyName: string;
|
|
63
|
-
domain?: string;
|
|
64
|
-
researchPrompt?: string;
|
|
65
|
-
signalTypes?: string[];
|
|
66
|
-
/** Desired signals per company. Accepted range: 1-15. */
|
|
67
|
-
targetSignalCount?: number;
|
|
68
|
-
lookbackDays?: number;
|
|
69
|
-
enableDeepSearch?: boolean;
|
|
70
|
-
}
|
|
71
|
-
interface Signal {
|
|
72
|
-
title: string;
|
|
73
|
-
signalType: string;
|
|
74
|
-
/** Event-derived open-vocabulary label (the user-facing source type). */
|
|
75
|
-
sourceType: string;
|
|
76
|
-
/** Original provider/provenance (for example news or company_website). */
|
|
77
|
-
sourceProvenance: string | null;
|
|
78
|
-
signalFamily?: string | null;
|
|
79
|
-
signalEventType?: string | null;
|
|
80
|
-
signalEventLabel?: string | null;
|
|
81
|
-
signalClassification?: {
|
|
82
|
-
label: string;
|
|
83
|
-
slug: string;
|
|
84
|
-
rationale?: string;
|
|
85
|
-
} | null;
|
|
86
|
-
confidenceScore: number;
|
|
87
|
-
detectedAt: string;
|
|
88
|
-
url?: string;
|
|
89
|
-
content: string;
|
|
90
|
-
}
|
|
91
|
-
interface EnrichSignalsResult {
|
|
92
|
-
companyName: string;
|
|
93
|
-
signals: Signal[];
|
|
94
|
-
totalSignals: number;
|
|
95
|
-
fromCache: boolean;
|
|
96
|
-
}
|
|
97
|
-
interface EnrichSignalsV2Params {
|
|
98
|
-
companyName?: string;
|
|
99
|
-
domain?: string;
|
|
65
|
+
interface CompanySignalEnrichmentParams {
|
|
100
66
|
companyDomain?: string;
|
|
67
|
+
companyName?: string;
|
|
101
68
|
researchPrompt?: string;
|
|
102
69
|
signalTypes?: string[];
|
|
103
|
-
online?: boolean;
|
|
104
|
-
/** Desired signals per company. Accepted range: 1-15. */
|
|
105
70
|
targetSignalCount?: number;
|
|
106
71
|
lookbackDays?: number;
|
|
72
|
+
online?: boolean;
|
|
107
73
|
enableDeepSearch?: boolean;
|
|
108
74
|
enableOutreachIntelligence?: boolean;
|
|
109
75
|
enablePredictiveIntelligence?: boolean;
|
|
110
|
-
icpId?: string;
|
|
111
|
-
cacheTtlHours?: number;
|
|
112
76
|
skipCache?: boolean;
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
77
|
+
/** Wait for a queued Trigger.dev enrichment to finish. Defaults to true. */
|
|
78
|
+
waitForResult?: boolean;
|
|
79
|
+
/** Maximum time to wait for a queued enrichment. Defaults to 20 minutes. */
|
|
80
|
+
maxWaitMs?: number;
|
|
81
|
+
/** Delay between queued-enrichment status checks. Defaults to 2 seconds. */
|
|
82
|
+
pollIntervalMs?: number;
|
|
83
|
+
}
|
|
84
|
+
interface CompanySignal {
|
|
85
|
+
id?: string;
|
|
116
86
|
title: string;
|
|
117
87
|
type: string;
|
|
118
88
|
content: string;
|
|
119
|
-
date
|
|
120
|
-
sourceUrl
|
|
121
|
-
sourceType
|
|
122
|
-
|
|
123
|
-
signalFamily?: string | null;
|
|
124
|
-
signalEventType?: string | null;
|
|
125
|
-
signalEventLabel?: string | null;
|
|
126
|
-
confidence: number | null;
|
|
127
|
-
/** Event-derived open-vocabulary classification; never limited to a fixed taxonomy. */
|
|
128
|
-
signalClassification?: {
|
|
129
|
-
label: string;
|
|
130
|
-
slug: string;
|
|
131
|
-
rationale?: string;
|
|
132
|
-
} | null;
|
|
133
|
-
}
|
|
134
|
-
interface OutreachIntelligence {
|
|
135
|
-
urgencyScore: number | null;
|
|
136
|
-
bestTiming: string | null;
|
|
137
|
-
primaryAngle: string | null;
|
|
138
|
-
ctas: {
|
|
139
|
-
soft?: string;
|
|
140
|
-
direct?: string;
|
|
141
|
-
valueFirst?: string;
|
|
142
|
-
} | null;
|
|
143
|
-
conversationStarters: string[];
|
|
89
|
+
date?: string | null;
|
|
90
|
+
sourceUrl?: string | null;
|
|
91
|
+
sourceType?: string;
|
|
92
|
+
confidence?: number | null;
|
|
144
93
|
}
|
|
145
|
-
interface
|
|
146
|
-
prediction: string;
|
|
147
|
-
confidence: number;
|
|
148
|
-
targetPersona: string | null;
|
|
149
|
-
recommendedAction: string | null;
|
|
150
|
-
}
|
|
151
|
-
interface IntelligenceV2 {
|
|
152
|
-
executiveSummary: string | null;
|
|
153
|
-
keyThemes: string[];
|
|
154
|
-
relevanceScore: number | null;
|
|
155
|
-
outreach: OutreachIntelligence | null;
|
|
156
|
-
predictions: Prediction[];
|
|
157
|
-
}
|
|
158
|
-
interface EnrichSignalsV2Result {
|
|
94
|
+
interface CompanySignalEnrichmentResult {
|
|
159
95
|
success: boolean;
|
|
160
96
|
company: {
|
|
161
97
|
name: string | null;
|
|
162
98
|
domain: string | null;
|
|
163
99
|
};
|
|
164
|
-
signals:
|
|
100
|
+
signals: CompanySignal[];
|
|
165
101
|
signalCount: number;
|
|
166
|
-
intelligence
|
|
167
|
-
credits
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
breakdown: {
|
|
171
|
-
signalCredits: number;
|
|
172
|
-
modelCostUsd: number;
|
|
173
|
-
modelCredits: number;
|
|
174
|
-
explanation: string;
|
|
175
|
-
};
|
|
176
|
-
};
|
|
177
|
-
metadata: {
|
|
178
|
-
version: string;
|
|
179
|
-
model: string;
|
|
180
|
-
online: boolean;
|
|
181
|
-
processingTimeMs: number;
|
|
182
|
-
};
|
|
102
|
+
intelligence?: Record<string, unknown> | null;
|
|
103
|
+
credits?: Record<string, unknown>;
|
|
104
|
+
metadata?: Record<string, unknown>;
|
|
105
|
+
raw: Record<string, unknown>;
|
|
183
106
|
}
|
|
184
|
-
interface
|
|
107
|
+
interface SignalToCopyParams {
|
|
185
108
|
companyDomain: string;
|
|
186
109
|
personName: string;
|
|
187
110
|
title: string;
|
|
188
111
|
campaignOffer: string;
|
|
189
112
|
researchPrompt?: string;
|
|
113
|
+
signalRunId?: string;
|
|
114
|
+
waitForResult?: boolean;
|
|
115
|
+
maxWaitMs?: number;
|
|
116
|
+
pollIntervalMs?: number;
|
|
190
117
|
}
|
|
191
|
-
interface
|
|
118
|
+
interface SignalToCopyVariation {
|
|
192
119
|
style: 'signal_led' | 'business_case' | 'predictive';
|
|
193
120
|
subjectLine: string;
|
|
194
121
|
openingLine: string;
|
|
@@ -196,8 +123,10 @@ interface PersonalizeSignalVariation {
|
|
|
196
123
|
prediction?: string;
|
|
197
124
|
email?: string;
|
|
198
125
|
}
|
|
199
|
-
interface
|
|
126
|
+
interface SignalToCopyResult {
|
|
200
127
|
success: boolean;
|
|
128
|
+
status?: string;
|
|
129
|
+
runId?: string;
|
|
201
130
|
strongestSignal: string;
|
|
202
131
|
whyNow: string;
|
|
203
132
|
subjectLine: string;
|
|
@@ -205,4645 +134,43 @@ interface PersonalizeSignalResult {
|
|
|
205
134
|
confidence: number;
|
|
206
135
|
evidenceUrl: string;
|
|
207
136
|
researchPrompt?: string;
|
|
208
|
-
variations:
|
|
209
|
-
}
|
|
210
|
-
type FusionPreset = 'general-budget' | 'general-high';
|
|
211
|
-
interface FusionCostSummary {
|
|
212
|
-
total_cost_usd?: number;
|
|
213
|
-
average_cost_usd_per_record?: number;
|
|
214
|
-
average_cost_usd_per_company?: number;
|
|
215
|
-
tokens_used?: number;
|
|
216
|
-
cost_sources?: string[];
|
|
217
|
-
pricing_note?: string;
|
|
218
|
-
}
|
|
219
|
-
interface SignalFusionParams {
|
|
220
|
-
companyName?: string;
|
|
221
|
-
domain?: string;
|
|
222
|
-
companyDomain?: string;
|
|
223
|
-
linkedinUrl?: string;
|
|
224
|
-
companies?: Record<string, unknown>[];
|
|
225
|
-
preset?: FusionPreset;
|
|
226
|
-
researchPrompt?: string;
|
|
227
|
-
signalTypes?: string[];
|
|
228
|
-
lookbackDays?: number;
|
|
229
|
-
targetSignalCount?: number;
|
|
230
|
-
maxToolCalls?: number;
|
|
231
|
-
maxTokens?: number;
|
|
232
|
-
timeoutMs?: number;
|
|
233
|
-
dryRun?: boolean;
|
|
234
|
-
dry_run?: boolean;
|
|
235
|
-
confirmSpend?: boolean;
|
|
236
|
-
confirm_spend?: boolean;
|
|
237
|
-
maxCredits?: number;
|
|
238
|
-
max_credits?: number;
|
|
239
|
-
maxCostUsd?: number;
|
|
240
|
-
max_cost_usd?: number;
|
|
241
|
-
}
|
|
242
|
-
interface SignalFusionResult {
|
|
243
|
-
success: boolean;
|
|
244
|
-
capability: string;
|
|
245
|
-
displayName: string;
|
|
246
|
-
company?: {
|
|
247
|
-
name?: string | null;
|
|
248
|
-
domain?: string | null;
|
|
249
|
-
};
|
|
250
|
-
signals: SignalV2[];
|
|
251
|
-
signalCount: number;
|
|
252
|
-
results: Record<string, unknown>[];
|
|
253
|
-
model?: string;
|
|
254
|
-
fusion?: Record<string, unknown>;
|
|
255
|
-
costUsd: number;
|
|
256
|
-
tokensUsed: number;
|
|
257
|
-
costSummary?: FusionCostSummary;
|
|
258
|
-
creditsUsed: number;
|
|
259
|
-
billingMetadata?: Record<string, unknown>;
|
|
260
|
-
raw: Record<string, unknown>;
|
|
261
|
-
}
|
|
262
|
-
interface CompanyIntelligenceParams {
|
|
263
|
-
companyName: string;
|
|
264
|
-
domain?: string;
|
|
265
|
-
websiteUrl?: string;
|
|
266
|
-
researchPrompt: string;
|
|
267
|
-
}
|
|
268
|
-
interface CompanyIntelligenceResult {
|
|
269
|
-
companyName: string;
|
|
270
|
-
insights: Array<{
|
|
271
|
-
title: string;
|
|
272
|
-
content: string;
|
|
273
|
-
sourceUrl?: string;
|
|
274
|
-
}>;
|
|
275
|
-
totalInsights: number;
|
|
276
|
-
creditsUsed: number;
|
|
277
|
-
}
|
|
278
|
-
interface CreateSystemParams {
|
|
279
|
-
name: string;
|
|
280
|
-
description?: string;
|
|
281
|
-
capabilities: string[];
|
|
282
|
-
fieldMappings?: Record<string, Record<string, string>>;
|
|
283
|
-
}
|
|
284
|
-
interface SystemResult {
|
|
285
|
-
id: string;
|
|
286
|
-
name: string;
|
|
287
|
-
status: string;
|
|
288
|
-
nodeCount: number;
|
|
289
|
-
createdAt: string;
|
|
290
|
-
}
|
|
291
|
-
interface RunSystemParams {
|
|
292
|
-
data: Record<string, unknown>[];
|
|
293
|
-
async?: boolean;
|
|
294
|
-
}
|
|
295
|
-
interface RunResult {
|
|
296
|
-
runId: string;
|
|
297
|
-
status: string;
|
|
298
|
-
totalRows?: number;
|
|
299
|
-
completedRows?: number;
|
|
300
|
-
creditsUsed?: number;
|
|
301
|
-
completed?: boolean;
|
|
302
|
-
retryEligible?: boolean;
|
|
303
|
-
triggerStatus?: string;
|
|
304
|
-
output?: unknown;
|
|
305
|
-
error?: string;
|
|
306
|
-
message?: string;
|
|
307
|
-
recoveryGuidance?: string;
|
|
308
|
-
raw?: unknown;
|
|
309
|
-
}
|
|
310
|
-
interface HttpRequestParams {
|
|
311
|
-
url: string;
|
|
312
|
-
method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
|
|
313
|
-
headers?: Record<string, string>;
|
|
314
|
-
body?: unknown;
|
|
315
|
-
}
|
|
316
|
-
interface HttpRequestResult {
|
|
317
|
-
statusCode: number;
|
|
318
|
-
headers: Record<string, string>;
|
|
319
|
-
body: unknown;
|
|
320
|
-
}
|
|
321
|
-
interface CustomAiOutputField {
|
|
322
|
-
name: string;
|
|
323
|
-
type?: 'text' | 'string' | 'number' | 'boolean' | 'array' | 'json';
|
|
324
|
-
description?: string;
|
|
325
|
-
}
|
|
326
|
-
interface CustomAiAttachment {
|
|
327
|
-
type?: 'text' | 'image' | 'pdf' | 'file' | 'audio' | 'video';
|
|
328
|
-
url?: string;
|
|
329
|
-
data_url?: string;
|
|
330
|
-
base64?: string;
|
|
331
|
-
mime_type?: string;
|
|
332
|
-
filename?: string;
|
|
333
|
-
text?: string;
|
|
334
|
-
detail?: 'auto' | 'low' | 'high';
|
|
335
|
-
format?: string;
|
|
336
|
-
}
|
|
337
|
-
interface CustomAiFusionConfig {
|
|
338
|
-
required?: boolean;
|
|
339
|
-
include_raw_analysis?: boolean;
|
|
340
|
-
}
|
|
341
|
-
interface CustomAiMultiModelParams {
|
|
342
|
-
/** Simple prompt template. Equivalent to userTemplate. */
|
|
343
|
-
prompt?: string;
|
|
344
|
-
/** One record to enrich. */
|
|
345
|
-
input?: Record<string, unknown>;
|
|
346
|
-
/** Multiple records to enrich. Max 25 per request. */
|
|
347
|
-
inputs?: Record<string, unknown>[];
|
|
348
|
-
/** Alias for inputs. */
|
|
349
|
-
records?: Record<string, unknown>[];
|
|
350
|
-
systemPrompt?: string;
|
|
351
|
-
system_prompt?: string;
|
|
352
|
-
userTemplate?: string;
|
|
353
|
-
user_template?: string;
|
|
354
|
-
temperature?: number;
|
|
355
|
-
maxConcurrency?: number;
|
|
356
|
-
max_concurrency?: number;
|
|
357
|
-
maxTokens?: number;
|
|
358
|
-
max_tokens?: number;
|
|
359
|
-
timeoutMs?: number;
|
|
360
|
-
timeout_ms?: number;
|
|
361
|
-
outputFields?: CustomAiOutputField[];
|
|
362
|
-
output_fields?: CustomAiOutputField[];
|
|
363
|
-
attachments?: CustomAiAttachment[];
|
|
364
|
-
attachmentFields?: string[];
|
|
365
|
-
attachment_fields?: string[];
|
|
366
|
-
pdfEngine?: 'cloudflare-ai' | 'mistral-ocr' | 'native';
|
|
367
|
-
pdf_engine?: 'cloudflare-ai' | 'mistral-ocr' | 'native';
|
|
368
|
-
fusion?: CustomAiFusionConfig;
|
|
369
|
-
}
|
|
370
|
-
interface CustomAiMultiModelResult {
|
|
371
|
-
success: boolean;
|
|
372
|
-
capability: string;
|
|
373
|
-
displayName: string;
|
|
374
|
-
results: Record<string, unknown>[];
|
|
375
|
-
creditsUsed: number;
|
|
376
|
-
model?: string;
|
|
377
|
-
fusion?: Record<string, unknown>;
|
|
378
|
-
multimodalCount: number;
|
|
379
|
-
tokensUsed: number;
|
|
380
|
-
costUsd: number;
|
|
381
|
-
billingMetadata?: Record<string, unknown>;
|
|
382
|
-
raw: Record<string, unknown>;
|
|
383
|
-
}
|
|
384
|
-
interface AiEnrichmentFusionParams {
|
|
385
|
-
prompt?: string;
|
|
386
|
-
input?: Record<string, unknown>;
|
|
387
|
-
inputs?: Record<string, unknown>[];
|
|
388
|
-
records?: Record<string, unknown>[];
|
|
389
|
-
preset?: FusionPreset;
|
|
390
|
-
systemPrompt?: string;
|
|
391
|
-
system_prompt?: string;
|
|
392
|
-
userTemplate?: string;
|
|
393
|
-
user_template?: string;
|
|
394
|
-
temperature?: number;
|
|
395
|
-
maxToolCalls?: number;
|
|
396
|
-
max_tool_calls?: number;
|
|
397
|
-
maxTokens?: number;
|
|
398
|
-
max_tokens?: number;
|
|
399
|
-
timeoutMs?: number;
|
|
400
|
-
timeout_ms?: number;
|
|
401
|
-
dryRun?: boolean;
|
|
402
|
-
dry_run?: boolean;
|
|
403
|
-
confirmSpend?: boolean;
|
|
404
|
-
confirm_spend?: boolean;
|
|
405
|
-
maxCredits?: number;
|
|
406
|
-
max_credits?: number;
|
|
407
|
-
maxCostUsd?: number;
|
|
408
|
-
max_cost_usd?: number;
|
|
409
|
-
outputFields?: CustomAiOutputField[];
|
|
410
|
-
output_fields?: CustomAiOutputField[];
|
|
411
|
-
}
|
|
412
|
-
interface AiEnrichmentFusionResult {
|
|
413
|
-
success: boolean;
|
|
414
|
-
capability: string;
|
|
415
|
-
displayName: string;
|
|
416
|
-
results: Record<string, unknown>[];
|
|
417
|
-
creditsUsed: number;
|
|
418
|
-
model?: string;
|
|
419
|
-
fusion?: Record<string, unknown>;
|
|
420
|
-
tokensUsed: number;
|
|
421
|
-
costUsd: number;
|
|
422
|
-
costSummary?: FusionCostSummary;
|
|
423
|
-
billingMetadata?: Record<string, unknown>;
|
|
137
|
+
variations: SignalToCopyVariation[];
|
|
424
138
|
raw: Record<string, unknown>;
|
|
425
139
|
}
|
|
426
|
-
interface WorkspaceInfo {
|
|
427
|
-
id: string;
|
|
428
|
-
name: string;
|
|
429
|
-
creditsRemaining: number;
|
|
430
|
-
plan: string;
|
|
431
|
-
}
|
|
432
|
-
interface PlatformHealth {
|
|
433
|
-
status: string;
|
|
434
|
-
period?: string;
|
|
435
|
-
totalRequests: number;
|
|
436
|
-
errorRate: string;
|
|
437
|
-
latency: {
|
|
438
|
-
p50: number;
|
|
439
|
-
p95: number;
|
|
440
|
-
p99: number;
|
|
441
|
-
sampleCount?: number;
|
|
442
|
-
source?: string;
|
|
443
|
-
};
|
|
444
|
-
}
|
|
445
|
-
interface RunProgressEvent {
|
|
446
|
-
runId: string;
|
|
447
|
-
status: string;
|
|
448
|
-
completedRows: number;
|
|
449
|
-
totalRows: number;
|
|
450
|
-
creditsUsed: number;
|
|
451
|
-
errors?: string[];
|
|
452
|
-
}
|
|
453
140
|
interface MCPToolInfo {
|
|
454
141
|
name: string;
|
|
142
|
+
title?: string;
|
|
455
143
|
description: string;
|
|
456
|
-
|
|
457
|
-
costCredits?: number;
|
|
458
|
-
contractVersion?: string;
|
|
459
|
-
permissionLevel?: string;
|
|
460
|
-
authScopes?: string[];
|
|
461
|
-
idempotent?: boolean;
|
|
462
|
-
destructive?: boolean;
|
|
463
|
-
retryable?: boolean;
|
|
464
|
-
rateLimitKey?: string;
|
|
465
|
-
observability?: Record<string, unknown>;
|
|
466
|
-
inputSchema?: {
|
|
467
|
-
required?: string[];
|
|
468
|
-
properties?: Record<string, unknown>;
|
|
469
|
-
[key: string]: unknown;
|
|
470
|
-
};
|
|
471
|
-
outputSchema?: {
|
|
472
|
-
required?: string[];
|
|
473
|
-
properties?: Record<string, unknown>;
|
|
474
|
-
[key: string]: unknown;
|
|
475
|
-
};
|
|
144
|
+
inputSchema: Record<string, unknown>;
|
|
476
145
|
annotations?: Record<string, unknown>;
|
|
477
146
|
}
|
|
478
|
-
interface
|
|
479
|
-
prompt: string;
|
|
480
|
-
maxLeads?: number;
|
|
481
|
-
verifyEmails?: boolean;
|
|
482
|
-
fileName?: string;
|
|
483
|
-
model?: string;
|
|
484
|
-
companyDomains?: string[];
|
|
485
|
-
completenessMode?: 'fast' | 'complete';
|
|
486
|
-
/** Net-new expansion mode for lookalike prompts. Bypasses recent lead cache and suppresses existing workspace leads. */
|
|
487
|
-
lookalikeExpansion?: boolean;
|
|
488
|
-
/** Required for spendful lead generation. Omit to receive an approval-required error with retry arguments. */
|
|
489
|
-
confirmSpend?: boolean;
|
|
490
|
-
}
|
|
491
|
-
interface GenerateLocalLeadsParams {
|
|
492
|
-
prompt: string;
|
|
493
|
-
/** Number of verified leads to return (auto-continues until target met). */
|
|
494
|
-
targetVerified?: number;
|
|
495
|
-
/** @deprecated Use targetVerified. */
|
|
496
|
-
maxLeads?: number;
|
|
497
|
-
verifyEmails?: boolean;
|
|
498
|
-
fileName?: string;
|
|
499
|
-
/** Required for spendful local lead generation. Omit to receive an approval-required error with retry arguments. */
|
|
500
|
-
confirmSpend?: boolean;
|
|
501
|
-
}
|
|
502
|
-
interface NativeGtmCapabilityInfo {
|
|
503
|
-
id: string;
|
|
504
|
-
label: string;
|
|
505
|
-
category: string;
|
|
506
|
-
description: string;
|
|
507
|
-
best_for: string[];
|
|
508
|
-
required_input: string;
|
|
509
|
-
default_results: number;
|
|
510
|
-
max_results: number;
|
|
511
|
-
credits_per_result: number;
|
|
512
|
-
quality: Record<string, unknown>;
|
|
513
|
-
api_call: Record<string, unknown>;
|
|
514
|
-
profitability_guardrail: Record<string, unknown>;
|
|
515
|
-
}
|
|
516
|
-
interface RunNativeGtmCapabilityParams {
|
|
517
|
-
capability: string;
|
|
518
|
-
query?: string;
|
|
519
|
-
urls?: string[];
|
|
520
|
-
placeIds?: string[];
|
|
521
|
-
maxResults?: number;
|
|
522
|
-
mode?: string;
|
|
523
|
-
since?: string;
|
|
524
|
-
location?: string;
|
|
525
|
-
countryCode?: string;
|
|
526
|
-
/** Required for spendful native GTM runs. Omit to receive an approval-required result with retry arguments. */
|
|
527
|
-
confirmSpend?: boolean;
|
|
528
|
-
}
|
|
529
|
-
interface LeadGenJobResult {
|
|
530
|
-
jobId: string;
|
|
531
|
-
status: string;
|
|
532
|
-
capability: string;
|
|
533
|
-
prompt: string;
|
|
534
|
-
source: string;
|
|
535
|
-
targetVerified?: number;
|
|
536
|
-
/** @deprecated */
|
|
537
|
-
maxLeads?: number;
|
|
538
|
-
verifyEmails: boolean;
|
|
539
|
-
message: string;
|
|
540
|
-
estimatedTimeSeconds: number;
|
|
541
|
-
}
|
|
542
|
-
|
|
543
|
-
declare class HttpClient {
|
|
544
|
-
private baseUrl;
|
|
545
|
-
private timeout;
|
|
546
|
-
private maxRetries;
|
|
547
|
-
private apiKey?;
|
|
548
|
-
private accessToken?;
|
|
549
|
-
private accessTokenPromise?;
|
|
550
|
-
private clientId?;
|
|
551
|
-
private clientSecret?;
|
|
552
|
-
constructor(config: SignalizConfig);
|
|
553
|
-
request<T = unknown>(functionName: string, body: Record<string, unknown>, method?: 'POST' | 'GET'): Promise<T>;
|
|
554
|
-
/** Convenience wrapper for POST-based edge function calls */
|
|
555
|
-
post<T = unknown>(functionName: string, body: Record<string, unknown>): Promise<T>;
|
|
556
|
-
/** Convenience wrapper for GET-based edge function calls with query params */
|
|
557
|
-
get<T = unknown>(functionName: string, query?: Record<string, unknown>): Promise<T>;
|
|
558
|
-
/** JSON-RPC call to the MCP server */
|
|
559
|
-
mcp<T = unknown>(method: string, params?: Record<string, unknown>): Promise<T>;
|
|
560
|
-
private getToken;
|
|
561
|
-
}
|
|
562
|
-
|
|
563
|
-
declare class Emails {
|
|
564
|
-
private client;
|
|
565
|
-
constructor(client: HttpClient);
|
|
566
|
-
/** Find and verify an email address for a person at a company */
|
|
567
|
-
find(params: FindEmailParams): Promise<FindEmailResult>;
|
|
568
|
-
/** Verify a single email address */
|
|
569
|
-
verify(email: string): Promise<VerifyEmailResult>;
|
|
570
|
-
/** Submit up to 5,000 contacts for async find + verify processing. */
|
|
571
|
-
findBatch(contacts: FindAndVerifyEmailContact[]): Promise<EmailBatchJobResult>;
|
|
572
|
-
/** Submit up to 5,000 email addresses for async verification. */
|
|
573
|
-
verifyBatch(emails: Array<string | {
|
|
574
|
-
email: string;
|
|
575
|
-
}>): Promise<EmailBatchJobResult>;
|
|
576
|
-
/** Poll a batch email job returned by findBatch or verifyBatch. */
|
|
577
|
-
checkStatus(jobId: string, opts?: {
|
|
578
|
-
page?: number;
|
|
579
|
-
pageSize?: number;
|
|
580
|
-
includePartialResults?: boolean;
|
|
581
|
-
}): Promise<Record<string, unknown>>;
|
|
582
|
-
}
|
|
583
|
-
|
|
584
|
-
declare class Signals {
|
|
585
|
-
private client;
|
|
586
|
-
constructor(client: HttpClient);
|
|
587
|
-
/** Turn the strongest supported company signal into three complete, evidence-backed emails. */
|
|
588
|
-
signalToCopy(params: PersonalizeSignalParams): Promise<PersonalizeSignalResult>;
|
|
589
|
-
/** @deprecated Use signalToCopy. Retained for compatibility. */
|
|
590
|
-
personalize(params: PersonalizeSignalParams): Promise<PersonalizeSignalResult>;
|
|
591
|
-
/** Enrich a company with actionable signals (V1) */
|
|
592
|
-
enrich(params: EnrichSignalsParams): Promise<EnrichSignalsResult>;
|
|
593
|
-
/** Enrich a company with actionable signals (V2 — clean response + online mode) */
|
|
594
|
-
enrichV2(params: EnrichSignalsV2Params): Promise<EnrichSignalsV2Result>;
|
|
595
|
-
/** Plan or run experimental Signal Fusion with explicit spend controls. */
|
|
596
|
-
fusion(params: SignalFusionParams): Promise<SignalFusionResult>;
|
|
597
|
-
}
|
|
598
|
-
|
|
599
|
-
declare class Systems {
|
|
600
|
-
private client;
|
|
601
|
-
constructor(client: HttpClient);
|
|
602
|
-
/** Create a new pipeline/system */
|
|
603
|
-
create(params: CreateSystemParams): Promise<SystemResult>;
|
|
604
|
-
/** Run a system with input data */
|
|
605
|
-
run(systemId: string, params: RunSystemParams): Promise<RunResult>;
|
|
606
|
-
/** Get a system by ID */
|
|
607
|
-
get(systemId: string): Promise<SystemResult>;
|
|
608
|
-
/** List all systems */
|
|
609
|
-
list(): Promise<SystemResult[]>;
|
|
610
|
-
}
|
|
611
|
-
|
|
612
|
-
declare class Runs {
|
|
613
|
-
private client;
|
|
614
|
-
constructor(client: HttpClient);
|
|
615
|
-
/** Get run status across Trigger, batch, and dataplane runs. */
|
|
616
|
-
get(runId: string): Promise<RunResult>;
|
|
617
|
-
/** Poll until a run completes. Returns final result. */
|
|
618
|
-
waitForCompletion(runId: string, pollIntervalMs?: number): Promise<RunResult>;
|
|
619
|
-
/**
|
|
620
|
-
* Stream run progress as an async iterator.
|
|
621
|
-
* Usage: for await (const event of signaliz.runs.stream(runId)) { ... }
|
|
622
|
-
*/
|
|
623
|
-
stream(runId: string, pollIntervalMs?: number): AsyncGenerator<RunProgressEvent>;
|
|
624
|
-
}
|
|
625
|
-
|
|
626
|
-
declare class Http {
|
|
627
|
-
private client;
|
|
628
|
-
constructor(client: HttpClient);
|
|
629
|
-
/** Proxy an HTTP request through Signaliz */
|
|
630
|
-
request(params: HttpRequestParams): Promise<HttpRequestResult>;
|
|
631
|
-
}
|
|
632
|
-
|
|
633
|
-
/** Allowed delivery output modes. */
|
|
634
|
-
type CampaignDeliveryMode = 'json' | 'csv' | 'webhook';
|
|
635
|
-
type CampaignAcquisitionMode = 'cache_first' | 'fresh_only' | 'hybrid';
|
|
636
|
-
type CampaignLearningHoldoutPrimaryMetric = 'reply_rate' | 'positive_reply_rate' | 'meeting_rate' | 'meetings_per_1000';
|
|
637
|
-
interface CampaignLearningHoldoutPolicy {
|
|
638
|
-
enabled?: boolean;
|
|
639
|
-
controlPercentage?: number;
|
|
640
|
-
minControlSize?: number;
|
|
641
|
-
experimentKey?: string;
|
|
642
|
-
sourceCampaignId?: string;
|
|
643
|
-
primaryMetric?: CampaignLearningHoldoutPrimaryMetric;
|
|
644
|
-
}
|
|
645
|
-
interface CampaignBuildRequest$1 {
|
|
646
|
-
name: string;
|
|
647
|
-
prompt: string;
|
|
648
|
-
/** Existing GTM Kernel campaign object to link this build to. */
|
|
649
|
-
gtmCampaignId?: string;
|
|
650
|
-
description?: string;
|
|
651
|
-
icp?: {
|
|
652
|
-
personas?: string[];
|
|
653
|
-
industries?: string[];
|
|
654
|
-
companySizes?: string[];
|
|
655
|
-
geographies?: string[];
|
|
656
|
-
keywords?: string[];
|
|
657
|
-
exclusions?: string[];
|
|
658
|
-
requireVerifiedEmail?: boolean;
|
|
659
|
-
personaExpansionMode?: 'strict' | 'expanded';
|
|
660
|
-
};
|
|
661
|
-
targetCount?: number;
|
|
662
|
-
/** Return a validated plan without launching spendful work. */
|
|
663
|
-
dryRun?: boolean;
|
|
664
|
-
/** Allow Signaliz to clamp oversized target counts to the supported max. */
|
|
665
|
-
allowDownscale?: boolean;
|
|
666
|
-
/** Explicitly acknowledge spendful campaign generation when the API asks for approval. */
|
|
667
|
-
confirmSpend?: boolean;
|
|
668
|
-
dedupKeys?: ('email' | 'linkedin_url' | 'company_domain')[];
|
|
669
|
-
acquisitionMode?: CampaignAcquisitionMode;
|
|
670
|
-
cacheReusePolicy?: {
|
|
671
|
-
allowVerifiedCache?: boolean;
|
|
672
|
-
suppressPriorCampaignIds?: string[];
|
|
673
|
-
suppressPriorListIds?: string[];
|
|
674
|
-
uniqueness?: 'email' | 'domain' | 'email_and_domain';
|
|
675
|
-
requireUsageMetadata?: boolean;
|
|
676
|
-
verifiedCacheTtlDays?: number;
|
|
677
|
-
};
|
|
678
|
-
policy?: {
|
|
679
|
-
maxCredits?: number;
|
|
680
|
-
verifyEmails?: boolean;
|
|
681
|
-
model?: string;
|
|
682
|
-
};
|
|
683
|
-
signals?: {
|
|
684
|
-
enabled?: boolean;
|
|
685
|
-
types?: string[];
|
|
686
|
-
customPrompt?: string;
|
|
687
|
-
confidenceThreshold?: number;
|
|
688
|
-
lookbackDays?: number;
|
|
689
|
-
};
|
|
690
|
-
qualification?: {
|
|
691
|
-
enabled?: boolean;
|
|
692
|
-
model?: string;
|
|
693
|
-
};
|
|
694
|
-
copy?: {
|
|
695
|
-
enabled?: boolean;
|
|
696
|
-
tone?: string;
|
|
697
|
-
maxBodyWords?: number;
|
|
698
|
-
senderContext?: string;
|
|
699
|
-
offerContext?: string;
|
|
700
|
-
model?: string;
|
|
701
|
-
styleSource?: {
|
|
702
|
-
sampleText?: string;
|
|
703
|
-
campaignIds?: string[];
|
|
704
|
-
artifactIds?: string[];
|
|
705
|
-
};
|
|
706
|
-
sequenceSteps?: 1 | 2 | 3;
|
|
707
|
-
copySchema?: 'single_message' | 'three_step_email';
|
|
708
|
-
evidenceMode?: 'signal_led' | 'firmographic';
|
|
709
|
-
bannedPhrases?: string[];
|
|
710
|
-
approvalRequired?: boolean;
|
|
711
|
-
qualityTier?: 'quality';
|
|
712
|
-
};
|
|
713
|
-
delivery?: {
|
|
714
|
-
enabled?: boolean;
|
|
715
|
-
destinationType?: CampaignDeliveryMode;
|
|
716
|
-
approvalRequired?: boolean;
|
|
717
|
-
includeDisqualified?: boolean;
|
|
718
|
-
destinationConfig?: Record<string, unknown>;
|
|
719
|
-
};
|
|
720
|
-
enhancers?: {
|
|
721
|
-
clay?: {
|
|
722
|
-
enabled?: boolean;
|
|
723
|
-
mode?: 'if_available' | 'required';
|
|
724
|
-
tableId?: string;
|
|
725
|
-
enrichmentFields?: string[];
|
|
726
|
-
apiKeyEnv?: string;
|
|
727
|
-
};
|
|
728
|
-
octave?: {
|
|
729
|
-
enabled?: boolean;
|
|
730
|
-
mode?: 'if_available' | 'required';
|
|
731
|
-
copyAgentId?: string;
|
|
732
|
-
qualificationAgentId?: string;
|
|
733
|
-
apiKeyEnv?: string;
|
|
734
|
-
};
|
|
735
|
-
};
|
|
736
|
-
/** Brain preflight context returned by scope_campaign. */
|
|
737
|
-
brainPreflight?: Record<string, unknown>;
|
|
738
|
-
/** Optional output from gtm_brain_seed_defaults. */
|
|
739
|
-
brainDefaults?: Record<string, unknown>;
|
|
740
|
-
/** Explicit control-vs-learned policy for honest closed-loop lift measurement. */
|
|
741
|
-
learningHoldout?: CampaignLearningHoldoutPolicy;
|
|
742
|
-
/** Sanitized strategy context returned by gtm_campaign_build_plan. */
|
|
743
|
-
campaignStrategyContext?: Record<string, unknown>;
|
|
744
|
-
/** Optional output from gtm_brain_delivery_risk. */
|
|
745
|
-
deliveryRisk?: Record<string, unknown>;
|
|
746
|
-
}
|
|
747
|
-
type CampaignApproach = 'account_first_qualified_outbound' | 'lookalike_expansion' | 'local_services_verified_email' | 'named_account_signal_monitor' | 'list_enrichment_and_route';
|
|
748
|
-
interface CampaignScopeRequest {
|
|
749
|
-
prompt: string;
|
|
750
|
-
accountLabel?: string;
|
|
751
|
-
accountContext?: string;
|
|
752
|
-
campaignGoal?: string;
|
|
753
|
-
targetCount?: number;
|
|
754
|
-
destinations?: Array<{
|
|
755
|
-
type?: string;
|
|
756
|
-
config?: Record<string, unknown>;
|
|
757
|
-
[key: string]: unknown;
|
|
758
|
-
}>;
|
|
759
|
-
knownAccounts?: string[];
|
|
760
|
-
offers?: string[];
|
|
761
|
-
proofPoints?: string[];
|
|
762
|
-
sourceDocs?: string[];
|
|
763
|
-
approvalPolicy?: string;
|
|
764
|
-
}
|
|
765
|
-
interface CampaignScopeResult {
|
|
766
|
-
campaignScopeId: string;
|
|
767
|
-
accountLabel: string;
|
|
768
|
-
campaignName: string;
|
|
769
|
-
approach: CampaignApproach;
|
|
770
|
-
approachLabel: string;
|
|
771
|
-
goal: string;
|
|
772
|
-
targetCount: number;
|
|
773
|
-
icp: Record<string, unknown>;
|
|
774
|
-
personas: Array<Record<string, unknown>>;
|
|
775
|
-
sourceStrategy: Array<Record<string, unknown>>;
|
|
776
|
-
qualificationPlan: Array<Record<string, unknown>>;
|
|
777
|
-
signalPlan: Array<Record<string, unknown>>;
|
|
778
|
-
copyPlan: Record<string, unknown>;
|
|
779
|
-
deliveryPlan: Record<string, unknown>;
|
|
780
|
-
brainPreflight: Record<string, unknown>;
|
|
781
|
-
recommendedSignalizTools: string[];
|
|
782
|
-
buildCampaignArgs: Record<string, unknown>;
|
|
783
|
-
mcpFlow: Array<{
|
|
784
|
-
tool: string;
|
|
785
|
-
arguments: Record<string, unknown>;
|
|
786
|
-
}>;
|
|
787
|
-
missingInputs: string[];
|
|
788
|
-
estimatedCredits: number;
|
|
789
|
-
campaignMarkdown: string;
|
|
790
|
-
}
|
|
791
|
-
interface CampaignProviderRouteReadback$1 {
|
|
792
|
-
plan?: Record<string, unknown> | null;
|
|
793
|
-
summary?: Record<string, unknown> | null;
|
|
794
|
-
ready: boolean | null;
|
|
795
|
-
label: string;
|
|
796
|
-
blockers: string[];
|
|
797
|
-
warnings: string[];
|
|
798
|
-
}
|
|
799
|
-
interface CampaignBuildResult$1 {
|
|
800
|
-
campaignBuildId: string | null;
|
|
801
|
-
campaignId?: string | null;
|
|
802
|
-
campaignObject?: Record<string, unknown> | null;
|
|
803
|
-
status: string;
|
|
804
|
-
currentPhase: string | null;
|
|
805
|
-
nextPollAfterSeconds: number;
|
|
806
|
-
message: string;
|
|
807
|
-
dryRun?: boolean;
|
|
808
|
-
requestedTargetCount?: number;
|
|
809
|
-
plannedTargetCount?: number;
|
|
810
|
-
acquisitionMode?: CampaignAcquisitionMode;
|
|
811
|
-
acquisitionSource?: string;
|
|
812
|
-
cacheReusePolicy?: Record<string, unknown>;
|
|
813
|
-
estimatedCredits?: number;
|
|
814
|
-
estimatedDurationSeconds?: number;
|
|
815
|
-
targetLimitApplied?: boolean;
|
|
816
|
-
targetLimitReason?: string | null;
|
|
817
|
-
maxSupportedTargetCount?: number;
|
|
818
|
-
brainContext?: Record<string, unknown>;
|
|
819
|
-
learningHoldout?: Record<string, unknown>;
|
|
820
|
-
providerRoute?: CampaignProviderRouteReadback$1 | null;
|
|
821
|
-
effectiveSourceRouting?: Record<string, unknown> | null;
|
|
822
|
-
sourcePlan?: Record<string, unknown> | null;
|
|
823
|
-
sourceRoutes?: Array<Record<string, unknown>>;
|
|
824
|
-
sourceShards?: Array<Record<string, unknown>>;
|
|
825
|
-
}
|
|
826
|
-
interface CampaignBuildStatus {
|
|
827
|
-
campaignBuildId: string;
|
|
828
|
-
campaignId?: string | null;
|
|
829
|
-
campaignObject?: Record<string, unknown> | null;
|
|
830
|
-
name: string;
|
|
831
|
-
status: string;
|
|
832
|
-
currentPhase: string | null;
|
|
833
|
-
currentPhaseStatus: string | null;
|
|
834
|
-
phases: {
|
|
835
|
-
phase: string;
|
|
836
|
-
status: string;
|
|
837
|
-
}[];
|
|
838
|
-
recordsTotal: number;
|
|
839
|
-
recordsProcessed: number;
|
|
840
|
-
recordsSucceeded: number;
|
|
841
|
-
recordsFailed: number;
|
|
842
|
-
warnings: string[];
|
|
843
|
-
errors: string[];
|
|
844
|
-
artifactCount: number;
|
|
845
|
-
artifactDownloads?: CampaignArtifactDownload[];
|
|
846
|
-
customerRowCounts?: CampaignCustomerRowCounts;
|
|
847
|
-
phaseAttemptTotals?: Record<string, unknown>;
|
|
848
|
-
providerRoute?: CampaignProviderRouteReadback$1 | null;
|
|
849
|
-
triggerRunId?: string | null;
|
|
850
|
-
staleRunningPhase?: boolean;
|
|
851
|
-
phaseAgeSeconds?: number | null;
|
|
852
|
-
nextPollAfterSeconds?: number | null;
|
|
853
|
-
terminalReason?: string | null;
|
|
854
|
-
staleReason?: string | null;
|
|
855
|
-
safeNextAction?: string | null;
|
|
856
|
-
terminalState?: {
|
|
857
|
-
kind: 'terminal' | 'pending_approval' | 'running_healthy' | 'running_stale' | 'blocked' | 'unknown';
|
|
858
|
-
label: string;
|
|
859
|
-
reviewable: boolean;
|
|
860
|
-
terminal: boolean;
|
|
861
|
-
stale: boolean;
|
|
862
|
-
phase: string | null;
|
|
863
|
-
phaseStatus: string | null;
|
|
864
|
-
heartbeatAgeSeconds: number | null;
|
|
865
|
-
nextPollAfterSeconds: number | null;
|
|
866
|
-
terminalReason: string | null;
|
|
867
|
-
staleReason: string | null;
|
|
868
|
-
safeNextAction: string;
|
|
869
|
-
};
|
|
870
|
-
phaseHealth?: Array<{
|
|
871
|
-
phase: string;
|
|
872
|
-
status: string;
|
|
873
|
-
recordsProcessed: number | null;
|
|
874
|
-
recordsSucceeded: number | null;
|
|
875
|
-
recordsFailed: number | null;
|
|
876
|
-
heartbeatAgeSeconds: number | null;
|
|
877
|
-
}>;
|
|
878
|
-
diagnostics?: Record<string, unknown>;
|
|
879
|
-
nextAction: string;
|
|
880
|
-
approvalAction?: string;
|
|
881
|
-
createdAt: string;
|
|
882
|
-
updatedAt: string;
|
|
883
|
-
completedAt: string | null;
|
|
884
|
-
}
|
|
885
|
-
interface CampaignCustomerRowCounts {
|
|
886
|
-
requestedTarget?: number | null;
|
|
887
|
-
acquiredRows?: number;
|
|
888
|
-
acceptedRows?: number;
|
|
889
|
-
usableRows?: number;
|
|
890
|
-
copiedRows?: number;
|
|
891
|
-
copySkippedRows?: number;
|
|
892
|
-
approvalReadyRows?: number;
|
|
893
|
-
qaReadyRows?: number;
|
|
894
|
-
deliveredRows?: number;
|
|
895
|
-
disqualifiedRows?: number;
|
|
896
|
-
reviewableRows?: number;
|
|
897
|
-
rowFailures?: number;
|
|
898
|
-
acceptedShortfall?: number | null;
|
|
899
|
-
usableShortfall?: number | null;
|
|
900
|
-
qaReadyShortfall?: number | null;
|
|
901
|
-
deliveryShortfall?: number | null;
|
|
902
|
-
fillRatio?: number | null;
|
|
903
|
-
qaReadyFillRatio?: number | null;
|
|
904
|
-
deliveredFillRatio?: number | null;
|
|
905
|
-
terminalReason?: string | null;
|
|
906
|
-
acceptedShortfallReason?: string | null;
|
|
907
|
-
usableShortfallReason?: string | null;
|
|
908
|
-
qaReadyShortfallReason?: string | null;
|
|
909
|
-
deliveryShortfallReason?: string | null;
|
|
910
|
-
}
|
|
911
|
-
interface CampaignBuildRow {
|
|
912
|
-
/** Row index within the build */
|
|
913
|
-
index: number;
|
|
914
|
-
/** Row status: succeeded, failed, disqualified, etc. */
|
|
915
|
-
status: string;
|
|
916
|
-
/** Whether the row passed qualification */
|
|
917
|
-
qualified: boolean;
|
|
918
|
-
/** Row segment: signal, standard, disqualified */
|
|
919
|
-
segment: string | null;
|
|
920
|
-
/** Enriched row data */
|
|
921
|
-
data: Record<string, unknown>;
|
|
922
|
-
}
|
|
923
|
-
interface CampaignArtifact {
|
|
924
|
-
id: string;
|
|
925
|
-
campaignBuildId: string;
|
|
926
|
-
artifactType: string;
|
|
927
|
-
destination: string;
|
|
928
|
-
storagePath: string;
|
|
929
|
-
format?: string | null;
|
|
930
|
-
signedUrl: string | null;
|
|
931
|
-
downloadUrl?: string | null;
|
|
932
|
-
manifestUrl?: string | null;
|
|
933
|
-
expiresAt?: string | null;
|
|
934
|
-
rowCount: number;
|
|
935
|
-
checksum: string | null;
|
|
936
|
-
metadata: Record<string, unknown>;
|
|
937
|
-
createdAt: string;
|
|
938
|
-
}
|
|
939
|
-
interface CampaignArtifactDownload {
|
|
940
|
-
id: string;
|
|
941
|
-
artifactType: string | null;
|
|
942
|
-
format: string | null;
|
|
943
|
-
rowCount: number;
|
|
944
|
-
signedUrl: string | null;
|
|
945
|
-
downloadUrl: string | null;
|
|
946
|
-
manifestUrl: string | null;
|
|
947
|
-
expiresAt: string | null;
|
|
948
|
-
}
|
|
949
|
-
interface CampaignArtifactDownloadPart {
|
|
950
|
-
partIndex: number;
|
|
951
|
-
rowCount: number;
|
|
952
|
-
byteSize: number | null;
|
|
953
|
-
checksum: string | null;
|
|
954
|
-
signedUrl: string | null;
|
|
955
|
-
}
|
|
956
|
-
interface CampaignArtifactDownloadResult {
|
|
957
|
-
campaignBuildId: string;
|
|
958
|
-
artifactId: string;
|
|
959
|
-
format: string;
|
|
960
|
-
rowCount: number;
|
|
961
|
-
byteSize: number | null;
|
|
962
|
-
partCount: number;
|
|
963
|
-
checksum: string | null;
|
|
964
|
-
signedUrl: string | null;
|
|
965
|
-
downloadUrl: string | null;
|
|
966
|
-
manifestUrl: string | null;
|
|
967
|
-
expiresAt: string | null;
|
|
968
|
-
parts: CampaignArtifactDownloadPart[];
|
|
969
|
-
downloadCommands: Record<string, unknown>;
|
|
970
|
-
expiresInSeconds: number | null;
|
|
971
|
-
}
|
|
972
|
-
interface CampaignArtifactDownloadOptions {
|
|
973
|
-
/** Artifact format to sign for download (default: csv) */
|
|
974
|
-
format?: 'csv' | 'ndjson' | string;
|
|
975
|
-
}
|
|
976
|
-
interface CampaignRowsOptions {
|
|
977
|
-
/** Max rows per page (default: 50) */
|
|
978
|
-
limit?: number;
|
|
979
|
-
/** Pagination cursor from a previous response */
|
|
980
|
-
cursor?: string;
|
|
981
|
-
/** Filter by segment */
|
|
982
|
-
segment?: 'signal' | 'standard' | 'disqualified';
|
|
983
|
-
/** Filter by qualification status */
|
|
984
|
-
qualified?: boolean;
|
|
985
|
-
/** Filter by row processing status */
|
|
986
|
-
rowStatus?: string;
|
|
987
|
-
/** Filter cache-reused rows */
|
|
988
|
-
cached?: boolean;
|
|
989
|
-
/** Filter rows that passed QA and approval gates for export */
|
|
990
|
-
exportReady?: boolean;
|
|
991
|
-
/** Include rich row data such as generated copy fields */
|
|
992
|
-
includeData?: boolean;
|
|
993
|
-
/** Include raw provider/qualification payloads when the API exposes them */
|
|
994
|
-
includeRaw?: boolean;
|
|
995
|
-
}
|
|
996
|
-
interface CampaignRowsResult {
|
|
997
|
-
campaignBuildId: string;
|
|
998
|
-
rows: CampaignBuildRow[];
|
|
999
|
-
count: number;
|
|
1000
|
-
pageSize: number;
|
|
1001
|
-
nextCursor: string | null;
|
|
1002
|
-
hasMore: boolean;
|
|
1003
|
-
}
|
|
1004
|
-
interface ApproveDeliveryResult {
|
|
1005
|
-
campaignBuildId: string;
|
|
1006
|
-
destinationType: string;
|
|
1007
|
-
status: string;
|
|
1008
|
-
message: string;
|
|
1009
|
-
deliveryId?: string;
|
|
1010
|
-
deliveryIds?: string[];
|
|
1011
|
-
approvedCount?: number;
|
|
1012
|
-
partialDelivery?: boolean;
|
|
1013
|
-
effectiveTargetCount?: number | null;
|
|
1014
|
-
requestedTargetCount?: number | null;
|
|
1015
|
-
}
|
|
1016
|
-
interface CancelBuildResult {
|
|
1017
|
-
campaignBuildId: string;
|
|
1018
|
-
status: string;
|
|
1019
|
-
reason: string;
|
|
1020
|
-
message: string;
|
|
1021
|
-
}
|
|
1022
|
-
interface BuildOptions {
|
|
1023
|
-
/** Idempotency key to prevent duplicate builds */
|
|
1024
|
-
idempotencyKey?: string;
|
|
1025
|
-
}
|
|
1026
|
-
interface WaitOptions {
|
|
1027
|
-
/** Polling interval in ms (default: 5000) */
|
|
1028
|
-
intervalMs?: number;
|
|
1029
|
-
/** Max wait time in ms (default: 600000 = 10 min) */
|
|
1030
|
-
timeoutMs?: number;
|
|
1031
|
-
/** Called on each poll with the latest status */
|
|
1032
|
-
onProgress?: (status: CampaignBuildStatus) => void;
|
|
1033
|
-
}
|
|
1034
|
-
declare class Campaigns {
|
|
1035
|
-
private client;
|
|
1036
|
-
constructor(client: HttpClient);
|
|
1037
|
-
/**
|
|
1038
|
-
* Start an async Campaign Build.
|
|
1039
|
-
* Returns immediately with a pollable campaign_build_id.
|
|
1040
|
-
*
|
|
1041
|
-
* ```ts
|
|
1042
|
-
* const result = await signaliz.campaigns.build({ name: 'Q3 SaaS', prompt: '...' });
|
|
1043
|
-
* console.log(result.campaignBuildId);
|
|
1044
|
-
* ```
|
|
1045
|
-
*/
|
|
1046
|
-
build(request: CampaignBuildRequest$1, options?: BuildOptions): Promise<CampaignBuildResult$1>;
|
|
1047
|
-
/** Scope an agency/customer campaign into a markdown brief plus build_campaign dry-run args. */
|
|
1048
|
-
scope(request: CampaignScopeRequest): Promise<CampaignScopeResult>;
|
|
1049
|
-
/** Get a concise status snapshot — ideal for polling loops. */
|
|
1050
|
-
status(campaignBuildId: string): Promise<CampaignBuildStatus>;
|
|
1051
|
-
/** Get the full campaign build record including delivery details. */
|
|
1052
|
-
get(campaignBuildId: string): Promise<CampaignBuildStatus>;
|
|
1053
|
-
/** Retrieve paginated rows from a completed build. */
|
|
1054
|
-
rows(campaignBuildId: string, options?: CampaignRowsOptions): Promise<CampaignRowsResult>;
|
|
1055
|
-
/** List all artifacts (CSV exports, etc.) for a build. */
|
|
1056
|
-
artifacts(campaignBuildId: string): Promise<CampaignArtifact[]>;
|
|
1057
|
-
/** Generate fresh signed URLs for a downloadable campaign artifact. */
|
|
1058
|
-
downloadArtifact(campaignBuildId: string, options?: CampaignArtifactDownloadOptions): Promise<CampaignArtifactDownloadResult>;
|
|
1059
|
-
/** Cancel a queued or running build. */
|
|
1060
|
-
cancel(campaignBuildId: string, reason?: string): Promise<CancelBuildResult>;
|
|
1061
|
-
/**
|
|
1062
|
-
* Poll until a campaign build reaches a terminal status.
|
|
1063
|
-
*
|
|
1064
|
-
* ```ts
|
|
1065
|
-
* const final = await signaliz.campaigns.wait(buildId, {
|
|
1066
|
-
* onProgress: (s) => console.log(`${s.recordsProcessed}/${s.recordsTotal}`),
|
|
1067
|
-
* });
|
|
1068
|
-
* ```
|
|
1069
|
-
*/
|
|
1070
|
-
wait(campaignBuildId: string, options?: WaitOptions): Promise<CampaignBuildStatus>;
|
|
1071
|
-
scopeCampaign(request: CampaignScopeRequest): Promise<CampaignScopeResult>;
|
|
1072
|
-
buildCampaign(request: CampaignBuildRequest$1, options?: BuildOptions): Promise<CampaignBuildResult$1>;
|
|
1073
|
-
getCampaignBuildStatus(campaignBuildId: string): Promise<CampaignBuildStatus>;
|
|
1074
|
-
listCampaignBuildArtifacts(campaignBuildId: string): Promise<CampaignArtifact[]>;
|
|
1075
|
-
downloadCampaignArtifact(campaignBuildId: string, options?: CampaignArtifactDownloadOptions): Promise<CampaignArtifactDownloadResult>;
|
|
1076
|
-
getCampaignBuildRows(campaignBuildId: string, options?: CampaignRowsOptions): Promise<CampaignRowsResult>;
|
|
1077
|
-
approveCampaignDelivery(campaignBuildId: string, destinationType: CampaignDeliveryMode, options?: {
|
|
1078
|
-
destinationId?: string;
|
|
1079
|
-
destinationConfig?: Record<string, unknown>;
|
|
1080
|
-
allowPartialDelivery?: boolean;
|
|
1081
|
-
}): Promise<ApproveDeliveryResult>;
|
|
1082
|
-
cancelCampaignBuild(campaignBuildId: string, reason?: string): Promise<CancelBuildResult>;
|
|
1083
|
-
waitForCompletion(campaignBuildId: string, options?: {
|
|
1084
|
-
intervalMs?: number;
|
|
1085
|
-
timeoutMs?: number;
|
|
1086
|
-
onStatus?: (status: CampaignBuildStatus) => void;
|
|
1087
|
-
}): Promise<CampaignBuildStatus>;
|
|
1088
|
-
private callMcp;
|
|
1089
|
-
}
|
|
1090
|
-
|
|
1091
|
-
type UnknownRecord$1 = Record<string, unknown>;
|
|
1092
|
-
type CampaignBuildRequest = CampaignBuildRequest$1 & {
|
|
1093
|
-
gtmCampaignId?: string;
|
|
1094
|
-
brainPreflight?: UnknownRecord$1;
|
|
1095
|
-
brainDefaults?: UnknownRecord$1;
|
|
1096
|
-
campaignStrategyContext?: UnknownRecord$1;
|
|
1097
|
-
deliveryRisk?: UnknownRecord$1;
|
|
1098
|
-
sourceRouting?: CampaignBuilderSourceRouting;
|
|
1099
|
-
evidence?: CampaignBuilderEvidencePacket;
|
|
1100
|
-
};
|
|
1101
|
-
interface CampaignBuilderSourceRouting {
|
|
1102
|
-
mode?: 'auto' | 'local_leads' | 'company_first' | 'people_first' | 'verified_leads';
|
|
1103
|
-
fillPolicy?: 'aggressive';
|
|
1104
|
-
shardSize?: number;
|
|
1105
|
-
maxSourceShardSize?: number;
|
|
1106
|
-
maxLocalSourceShardSize?: number;
|
|
1107
|
-
}
|
|
1108
|
-
type CampaignBuildResult = CampaignBuildResult$1 & {
|
|
1109
|
-
campaignId?: string | null;
|
|
1110
|
-
campaignObject?: UnknownRecord$1 | null;
|
|
1111
|
-
brainContext?: UnknownRecord$1;
|
|
1112
|
-
providerRoute?: CampaignProviderRouteReadback | null;
|
|
1113
|
-
};
|
|
1114
|
-
interface CampaignProviderRouteReadback {
|
|
1115
|
-
plan?: UnknownRecord$1 | null;
|
|
1116
|
-
summary?: UnknownRecord$1 | null;
|
|
1117
|
-
ready: boolean | null;
|
|
1118
|
-
label: string;
|
|
1119
|
-
blockers: string[];
|
|
1120
|
-
warnings: string[];
|
|
1121
|
-
}
|
|
1122
|
-
type CampaignBuilderLayer = 'workspace_context' | 'memory' | 'source' | 'enrichment' | 'qualification' | 'copy' | 'delivery' | 'feedback' | 'approval';
|
|
1123
|
-
type CampaignBuilderGtmLayer = 'icp' | 'find_company' | 'find_people' | 'lead_generation' | 'local_leads' | 'email_finding' | 'email_verification' | 'company_enrichment' | 'copy_enrichment' | 'qualification' | 'sender' | 'feedback' | 'approval' | 'source_import' | 'destination_export' | 'customer_data' | 'custom';
|
|
1124
|
-
type CampaignBuilderProvider = 'signaliz' | 'octave' | 'apollo' | 'ai_ark' | 'clay_webhook' | 'airbyte' | 'nango' | 'instantly' | 'smartlead' | 'heyreach' | 'custom_mcp' | 'custom_api' | 'custom_webhook' | 'webhook' | 'csv' | (string & {});
|
|
1125
|
-
type CampaignBuilderAgentProvider = CampaignBuilderProvider;
|
|
1126
|
-
type CampaignBuilderBuiltInTool = 'lead_generation' | 'local_leads' | 'company_discovery' | 'people_discovery' | 'email_finding' | 'email_verification' | 'signals';
|
|
1127
|
-
type CampaignBuilderStrategyTemplateSlug = 'industrial-ot-resilience' | 'non-medical-home-care' | 'agency-founder-led' | 'cloud-infrastructure-displacement';
|
|
1128
|
-
type CampaignBuilderOperatingPlaybookSlug = 'cache-first-large-list' | 'net-new-suppressed-list' | 'proof-first-vertical-gate' | 'signal-led-copy-approval' | 'domain-first-recovery' | 'table-workflow-handoff' | 'icp-persona-segmentation' | 'buying-signal-prioritization' | 'multi-channel-sequence-fit' | 'revops-feedback-loop';
|
|
1129
|
-
type CampaignBuilderRouteMode = 'required' | 'if_available' | 'fallback' | 'disabled';
|
|
1130
|
-
type CampaignBuilderProviderRoutingMode = 'preferred' | 'fallback' | 'disabled';
|
|
1131
|
-
type CampaignBuilderProviderInvocationType = 'signaliz_native' | 'mcp' | 'mcp_tool' | 'webhook' | 'api' | 'airbyte' | 'manual' | 'managed_integration';
|
|
1132
|
-
type CampaignBuilderMemoryScope = 'workspace' | 'network_patterns' | 'customer_private' | 'operator_notes';
|
|
1133
|
-
type CampaignBuilderApprovalType = 'memory_retrieval' | 'spend' | 'customer_tool' | 'external_write' | 'delivery' | 'launch';
|
|
1134
|
-
interface CampaignBuilderWorkspaceContext {
|
|
1135
|
-
workspaceId?: string;
|
|
1136
|
-
workspaceName?: string;
|
|
1137
|
-
plan?: string;
|
|
1138
|
-
creditsRemaining?: number;
|
|
1139
|
-
connectedTools?: string[];
|
|
1140
|
-
defaultSender?: string;
|
|
1141
|
-
brandVoice?: string;
|
|
1142
|
-
suppressionRules?: string[];
|
|
1143
|
-
operatorNotes?: string[];
|
|
1144
|
-
[key: string]: unknown;
|
|
1145
|
-
}
|
|
1146
|
-
interface CampaignBuilderMemoryQuery {
|
|
1147
|
-
query: string;
|
|
1148
|
-
scopes?: CampaignBuilderMemoryScope[];
|
|
1149
|
-
topK?: number;
|
|
1150
|
-
required?: boolean;
|
|
1151
|
-
rationale?: string;
|
|
1152
|
-
}
|
|
1153
|
-
interface CampaignBuilderMemoryPlan {
|
|
1154
|
-
enabled?: boolean;
|
|
1155
|
-
queries?: CampaignBuilderMemoryQuery[];
|
|
1156
|
-
useWorkspaceHistory?: boolean;
|
|
1157
|
-
useNetworkPatterns?: boolean;
|
|
1158
|
-
privacyMode?: 'workspace_only' | 'anonymized_patterns' | 'opt_in_network';
|
|
1159
|
-
summary?: string;
|
|
1160
|
-
}
|
|
1161
|
-
interface CampaignBuilderIntegrationRoute {
|
|
1162
|
-
id?: string;
|
|
1163
|
-
layer: CampaignBuilderLayer;
|
|
1164
|
-
gtmLayer?: CampaignBuilderGtmLayer;
|
|
1165
|
-
gtmLayers?: CampaignBuilderGtmLayer[];
|
|
1166
|
-
provider: CampaignBuilderProvider;
|
|
1167
|
-
mode?: CampaignBuilderRouteMode;
|
|
1168
|
-
routingPolicy?: CampaignBuilderProviderRoutingPolicy;
|
|
1169
|
-
toolName?: string;
|
|
1170
|
-
mcpServerName?: string;
|
|
1171
|
-
label?: string;
|
|
1172
|
-
rationale?: string;
|
|
1173
|
-
approvalRequired?: boolean;
|
|
1174
|
-
config?: UnknownRecord$1;
|
|
1175
|
-
fallbackProvider?: CampaignBuilderProvider;
|
|
1176
|
-
providerCapability?: CampaignBuilderProviderCapabilityContract;
|
|
1177
|
-
}
|
|
1178
|
-
interface CampaignBuilderCustomerTool {
|
|
1179
|
-
provider: CampaignBuilderProvider;
|
|
1180
|
-
label?: string;
|
|
1181
|
-
mcpServerName?: string;
|
|
1182
|
-
availableTools?: string[];
|
|
1183
|
-
useForLayers: CampaignBuilderLayer[];
|
|
1184
|
-
gtmLayerCapabilities?: CampaignBuilderGtmLayer[];
|
|
1185
|
-
mode?: CampaignBuilderRouteMode;
|
|
1186
|
-
routingPolicy?: CampaignBuilderProviderRoutingPolicy;
|
|
1187
|
-
approvalRequired?: boolean;
|
|
1188
|
-
config?: UnknownRecord$1;
|
|
1189
|
-
providerCapability?: CampaignBuilderProviderCapabilityContract;
|
|
1190
|
-
}
|
|
1191
|
-
interface CampaignBuilderProviderRoutingPolicy {
|
|
1192
|
-
mode: CampaignBuilderProviderRoutingMode;
|
|
1193
|
-
useSignalizFallback?: boolean;
|
|
1194
|
-
workspaceScoped?: boolean;
|
|
1195
|
-
dryRunRequired?: boolean;
|
|
1196
|
-
confirmRequired?: boolean;
|
|
1197
|
-
}
|
|
1198
|
-
interface CampaignBuilderProviderCapabilityContract {
|
|
1199
|
-
providerId?: CampaignBuilderProvider | string;
|
|
1200
|
-
layerCapabilities: CampaignBuilderGtmLayer[];
|
|
1201
|
-
invocationType?: CampaignBuilderProviderInvocationType;
|
|
1202
|
-
setupRequirements?: Array<{
|
|
1203
|
-
kind: string;
|
|
1204
|
-
label: string;
|
|
1205
|
-
required?: boolean;
|
|
1206
|
-
guidance?: string;
|
|
1207
|
-
}>;
|
|
1208
|
-
exampleInputSchema?: UnknownRecord$1;
|
|
1209
|
-
exampleOutputSchema?: UnknownRecord$1;
|
|
1210
|
-
routingPolicy?: CampaignBuilderProviderRoutingPolicy;
|
|
1211
|
-
workspaceConfiguration?: {
|
|
1212
|
-
scope?: 'workspace';
|
|
1213
|
-
storesSecretsByReferenceOnly?: boolean;
|
|
1214
|
-
fields?: UnknownRecord$1[];
|
|
1215
|
-
};
|
|
1216
|
-
}
|
|
1217
|
-
interface SignalizCampaignBuilderDefaults {
|
|
1218
|
-
requireVerifiedEmail?: boolean;
|
|
1219
|
-
dedupKeys?: Array<'email' | 'linkedin_url' | 'company_domain'>;
|
|
1220
|
-
maxCredits?: number;
|
|
1221
|
-
allowDownscale?: boolean;
|
|
1222
|
-
signals?: {
|
|
1223
|
-
enabled?: boolean;
|
|
1224
|
-
types?: string[];
|
|
1225
|
-
confidenceThreshold?: number;
|
|
1226
|
-
lookbackDays?: number;
|
|
1227
|
-
};
|
|
1228
|
-
qualification?: {
|
|
1229
|
-
enabled?: boolean;
|
|
1230
|
-
model?: string;
|
|
1231
|
-
};
|
|
1232
|
-
copy?: {
|
|
1233
|
-
enabled?: boolean;
|
|
1234
|
-
tone?: string;
|
|
1235
|
-
maxBodyWords?: number;
|
|
1236
|
-
senderContext?: string;
|
|
1237
|
-
offerContext?: string;
|
|
1238
|
-
model?: string;
|
|
1239
|
-
evidenceMode?: 'signal_led' | 'firmographic';
|
|
1240
|
-
};
|
|
1241
|
-
delivery?: {
|
|
1242
|
-
enabled?: boolean;
|
|
1243
|
-
destinationType?: CampaignDeliveryMode;
|
|
1244
|
-
approvalRequired?: boolean;
|
|
1245
|
-
destinationConfig?: UnknownRecord$1;
|
|
1246
|
-
};
|
|
1247
|
-
}
|
|
1248
|
-
interface CampaignBuilderApprovalPolicy {
|
|
1249
|
-
requireHumanApproval?: boolean;
|
|
1250
|
-
maxCreditsWithoutApproval?: number;
|
|
1251
|
-
requireApprovalFor?: CampaignBuilderApprovalType[];
|
|
1252
|
-
approvedByDefault?: CampaignBuilderApprovalType[];
|
|
1253
|
-
}
|
|
1254
|
-
interface CampaignBuilderAttachmentEvidence {
|
|
1255
|
-
name: string;
|
|
1256
|
-
kind?: string;
|
|
1257
|
-
mediaType?: string;
|
|
1258
|
-
redacted?: boolean;
|
|
1259
|
-
columns?: string[];
|
|
1260
|
-
rowCount?: number;
|
|
1261
|
-
contentSummary?: string;
|
|
1262
|
-
evidenceFields?: string[];
|
|
1263
|
-
}
|
|
1264
|
-
interface CampaignBuilderUrlEvidence {
|
|
1265
|
-
url: string;
|
|
1266
|
-
type?: string;
|
|
1267
|
-
host?: string;
|
|
1268
|
-
label?: string;
|
|
1269
|
-
summary?: string;
|
|
1270
|
-
redacted?: boolean;
|
|
1271
|
-
}
|
|
1272
|
-
interface CampaignBuilderAgentEvidence {
|
|
1273
|
-
attachments?: CampaignBuilderAttachmentEvidence[];
|
|
1274
|
-
urls?: CampaignBuilderUrlEvidence[];
|
|
1275
|
-
notes?: string[];
|
|
1276
|
-
}
|
|
1277
|
-
interface CampaignBuilderEvidencePacket {
|
|
1278
|
-
packet_version: 'campaign-builder-evidence.v1';
|
|
1279
|
-
private_safe: true;
|
|
1280
|
-
attachment_summary: Array<{
|
|
1281
|
-
name: string;
|
|
1282
|
-
kind: string | null;
|
|
1283
|
-
media_type: string | null;
|
|
1284
|
-
redacted: boolean;
|
|
1285
|
-
columns: string[];
|
|
1286
|
-
row_count: number | null;
|
|
1287
|
-
content_summary: string | null;
|
|
1288
|
-
evidence_fields: string[];
|
|
1289
|
-
}>;
|
|
1290
|
-
url_summary: Array<{
|
|
1291
|
-
url: string;
|
|
1292
|
-
host: string | null;
|
|
1293
|
-
type: string | null;
|
|
1294
|
-
label: string | null;
|
|
1295
|
-
summary: string | null;
|
|
1296
|
-
redacted: boolean;
|
|
1297
|
-
}>;
|
|
1298
|
-
operator_notes: string[];
|
|
1299
|
-
privacy_boundary: string;
|
|
1300
|
-
raw_private_fields_withheld: string[];
|
|
1301
|
-
}
|
|
1302
|
-
interface CampaignBuilderAgentRequest {
|
|
1303
|
-
goal: string;
|
|
1304
|
-
/** Named private-safe strategy template to merge into the request. */
|
|
1305
|
-
strategyTemplate?: CampaignBuilderStrategyTemplateSlug | (string & {});
|
|
1306
|
-
/** Private-safe operating playbooks to apply in addition to strategy-template defaults. */
|
|
1307
|
-
operatingPlaybooks?: Array<CampaignBuilderOperatingPlaybookSlug | (string & {})>;
|
|
1308
|
-
/** Existing committed GTM campaign object to execute through gtm_campaign_build_execution_prepare. */
|
|
1309
|
-
gtmCampaignId?: string;
|
|
1310
|
-
campaignName?: string;
|
|
1311
|
-
accountLabel?: string;
|
|
1312
|
-
accountContext?: string;
|
|
1313
|
-
targetCount?: number;
|
|
1314
|
-
icp?: CampaignBuildRequest['icp'];
|
|
1315
|
-
/** Optional output from gtm_brain_seed_defaults to attach to build_campaign. */
|
|
1316
|
-
brainDefaults?: UnknownRecord$1;
|
|
1317
|
-
/** Optional control-vs-learned policy. Defaults to a Signaliz learning holdout for agent-built campaigns. */
|
|
1318
|
-
learningHoldout?: CampaignBuildRequest['learningHoldout'];
|
|
1319
|
-
/** Optional output from gtm_brain_delivery_risk. Required before committed-campaign launch handoff. */
|
|
1320
|
-
deliveryRisk?: UnknownRecord$1;
|
|
1321
|
-
workspaceContext?: CampaignBuilderWorkspaceContext;
|
|
1322
|
-
/** Private-safe attachment and URL summaries supplied by chat/runtime context. Never include raw attachment text or rows. */
|
|
1323
|
-
evidence?: CampaignBuilderAgentEvidence;
|
|
1324
|
-
memory?: CampaignBuilderMemoryPlan;
|
|
1325
|
-
integrations?: CampaignBuilderIntegrationRoute[];
|
|
1326
|
-
customerTools?: CampaignBuilderCustomerTool[];
|
|
1327
|
-
preferredProviders?: CampaignBuilderProvider[];
|
|
1328
|
-
sourceRouting?: CampaignBuilderSourceRouting;
|
|
1329
|
-
/** Signaliz-native lanes to include in the campaign plan. Defaults to source discovery, lead generation, email finding, verification, and signals. */
|
|
1330
|
-
builtIns?: CampaignBuilderBuiltInTool[];
|
|
1331
|
-
agencyContext?: {
|
|
1332
|
-
/** Public strategy model. Defaults to strategy_template. */
|
|
1333
|
-
strategyModel?: 'strategy_template' | 'custom';
|
|
1334
|
-
includeStrategyPatterns?: boolean;
|
|
1335
|
-
includeWorkflowPatterns?: boolean;
|
|
1336
|
-
/** @deprecated Use includeWorkflowPatterns. */
|
|
1337
|
-
includeClayPatterns?: boolean;
|
|
1338
|
-
includeNangoCatalog?: boolean;
|
|
1339
|
-
partnerEcosystem?: string[];
|
|
1340
|
-
revenueMotion?: string;
|
|
1341
|
-
};
|
|
1342
|
-
signalizDefaults?: SignalizCampaignBuilderDefaults;
|
|
1343
|
-
approvalPolicy?: CampaignBuilderApprovalPolicy;
|
|
1344
|
-
constraints?: {
|
|
1345
|
-
geographies?: string[];
|
|
1346
|
-
exclusions?: string[];
|
|
1347
|
-
maxDailySends?: number;
|
|
1348
|
-
deliverabilityNotes?: string[];
|
|
1349
|
-
};
|
|
1350
|
-
}
|
|
1351
|
-
interface CampaignBuilderAgentRequestTemplateOptions extends Partial<CampaignBuilderAgentRequest> {
|
|
1352
|
-
includeLocalLeads?: boolean;
|
|
1353
|
-
includeCustomToolPlaceholder?: boolean;
|
|
1354
|
-
includeNango?: boolean;
|
|
1355
|
-
}
|
|
1356
|
-
interface CampaignBuilderStrategyTemplate {
|
|
1357
|
-
slug: CampaignBuilderStrategyTemplateSlug;
|
|
1358
|
-
label: string;
|
|
1359
|
-
aliases: string[];
|
|
1360
|
-
defaultTargetCount: number;
|
|
1361
|
-
campaignName: string;
|
|
1362
|
-
accountContext: string;
|
|
1363
|
-
icp: NonNullable<CampaignBuilderAgentRequest['icp']>;
|
|
1364
|
-
builtIns: CampaignBuilderBuiltInTool[];
|
|
1365
|
-
preferredProviders: CampaignBuilderProvider[];
|
|
1366
|
-
memoryQueries: CampaignBuilderMemoryQuery[];
|
|
1367
|
-
constraints?: CampaignBuilderAgentRequest['constraints'];
|
|
1368
|
-
signalizDefaults?: SignalizCampaignBuilderDefaults;
|
|
1369
|
-
agencyContext?: CampaignBuilderAgentRequest['agencyContext'];
|
|
1370
|
-
operatingPlaybookSlugs: CampaignBuilderOperatingPlaybookSlug[];
|
|
1371
|
-
}
|
|
1372
|
-
interface CampaignBuilderOperatingPlaybook {
|
|
1373
|
-
slug: CampaignBuilderOperatingPlaybookSlug;
|
|
1374
|
-
label: string;
|
|
1375
|
-
whenToUse: string[];
|
|
1376
|
-
sequence: string[];
|
|
1377
|
-
requiredFields: Record<string, string[]>;
|
|
1378
|
-
qualityGates: string[];
|
|
1379
|
-
activationBoundary: string;
|
|
1380
|
-
memoryKeywords: string[];
|
|
1381
|
-
knowledgeSources: string[];
|
|
1382
|
-
}
|
|
1383
|
-
interface CampaignBuilderRequiredApproval {
|
|
1384
|
-
id: string;
|
|
1385
|
-
type: CampaignBuilderApprovalType;
|
|
1386
|
-
label: string;
|
|
1387
|
-
reason: string;
|
|
1388
|
-
blocking: boolean;
|
|
1389
|
-
routeId?: string;
|
|
1390
|
-
provider?: CampaignBuilderProvider;
|
|
1391
|
-
estimatedCredits?: number;
|
|
1392
|
-
}
|
|
1393
|
-
interface CampaignBuilderApproval {
|
|
1394
|
-
planId: string;
|
|
1395
|
-
approvedBy: string;
|
|
1396
|
-
approvedAt?: string;
|
|
1397
|
-
approvedTypes: CampaignBuilderApprovalType[];
|
|
1398
|
-
spendLimitCredits?: number;
|
|
1399
|
-
approvedRouteIds?: string[];
|
|
1400
|
-
notes?: string;
|
|
1401
|
-
}
|
|
1402
|
-
interface CampaignBuilderMcpStep {
|
|
1403
|
-
id: string;
|
|
1404
|
-
phase: CampaignBuilderLayer | 'plan' | 'launch';
|
|
1405
|
-
tool: string;
|
|
1406
|
-
arguments: UnknownRecord$1;
|
|
1407
|
-
readOnly: boolean;
|
|
1408
|
-
approvalRequired: boolean;
|
|
1409
|
-
}
|
|
1410
|
-
interface CampaignBuilderAgentPlan {
|
|
1411
|
-
planId: string;
|
|
1412
|
-
campaignName: string;
|
|
1413
|
-
goal: string;
|
|
1414
|
-
targetCount: number;
|
|
1415
|
-
workspaceContext: CampaignBuilderWorkspaceContext;
|
|
1416
|
-
memory: Required<Pick<CampaignBuilderMemoryPlan, 'enabled' | 'queries' | 'useWorkspaceHistory' | 'useNetworkPatterns' | 'privacyMode'>>;
|
|
1417
|
-
defaults: Required<Pick<SignalizCampaignBuilderDefaults, 'requireVerifiedEmail' | 'dedupKeys' | 'allowDownscale'>>;
|
|
1418
|
-
routes: CampaignBuilderIntegrationRoute[];
|
|
1419
|
-
approvals: CampaignBuilderRequiredApproval[];
|
|
1420
|
-
buildRequest: CampaignBuildRequest;
|
|
1421
|
-
brainPreflight: UnknownRecord$1;
|
|
1422
|
-
evidence: CampaignBuilderEvidencePacket | null;
|
|
1423
|
-
operatingPlaybooks: CampaignBuilderOperatingPlaybook[];
|
|
1424
|
-
strategyMemoryStatus?: UnknownRecord$1;
|
|
1425
|
-
kernelPlan?: UnknownRecord$1;
|
|
1426
|
-
mcpFlow: CampaignBuilderMcpStep[];
|
|
1427
|
-
estimatedCredits: number;
|
|
1428
|
-
warnings: string[];
|
|
1429
|
-
}
|
|
1430
|
-
interface CampaignBuilderPlanOptions {
|
|
1431
|
-
discoverCapabilities?: boolean;
|
|
1432
|
-
scopeCampaign?: boolean;
|
|
1433
|
-
includeStrategyMemoryStatus?: boolean;
|
|
1434
|
-
includeKernelPlan?: boolean;
|
|
1435
|
-
includeDeliveryRisk?: boolean;
|
|
1436
|
-
}
|
|
1437
|
-
interface CampaignBuilderPlanCommitOptions {
|
|
1438
|
-
confirm?: boolean;
|
|
1439
|
-
dryRun?: boolean;
|
|
1440
|
-
approvedBy?: string;
|
|
1441
|
-
idempotencyKey?: string;
|
|
1442
|
-
rationale?: string;
|
|
1443
|
-
}
|
|
1444
|
-
interface CampaignBuilderPlanCommitResult {
|
|
1445
|
-
dryRun: boolean;
|
|
1446
|
-
wroteState: boolean;
|
|
1447
|
-
campaignId?: string | null;
|
|
1448
|
-
campaignBuildId?: string | null;
|
|
1449
|
-
raw: UnknownRecord$1;
|
|
1450
|
-
}
|
|
1451
|
-
type CampaignBuilderBuildOptions = BuildOptions & {
|
|
1452
|
-
commitBeforeLaunch?: boolean;
|
|
1453
|
-
};
|
|
1454
|
-
type CampaignBuilderApprovedRunOptions = CampaignBuilderBuildOptions & {
|
|
1455
|
-
wait?: boolean;
|
|
1456
|
-
approveDelivery?: boolean;
|
|
1457
|
-
deliveryDestinationType?: CampaignDeliveryMode;
|
|
1458
|
-
deliveryDestinationId?: string;
|
|
1459
|
-
deliveryDestinationConfig?: UnknownRecord$1;
|
|
1460
|
-
allowPartialDelivery?: boolean;
|
|
1461
|
-
waitIntervalMs?: number;
|
|
1462
|
-
waitTimeoutMs?: number;
|
|
1463
|
-
onStatus?: (status: CampaignBuildStatus) => void;
|
|
1464
|
-
};
|
|
1465
|
-
interface CampaignBuilderApprovedRunResult {
|
|
1466
|
-
build: CampaignBuildResult;
|
|
1467
|
-
finalStatus?: CampaignBuildStatus;
|
|
1468
|
-
deliveryApproval?: ApproveDeliveryResult;
|
|
1469
|
-
}
|
|
1470
|
-
type CampaignBuilderProofOptions = CampaignBuilderPlanOptions & BuildOptions;
|
|
1471
|
-
interface CampaignBuilderProofReceipt {
|
|
1472
|
-
receipt_version: 'campaign-agent-proof.v1';
|
|
1473
|
-
source: string;
|
|
1474
|
-
success: boolean;
|
|
1475
|
-
safety: {
|
|
1476
|
-
spendful_tools_called: boolean;
|
|
1477
|
-
external_writes_called: boolean;
|
|
1478
|
-
sender_loads_called: boolean;
|
|
1479
|
-
email_sends_called: boolean;
|
|
1480
|
-
dry_run_only: boolean;
|
|
1481
|
-
};
|
|
1482
|
-
campaign: {
|
|
1483
|
-
plan_id: string;
|
|
1484
|
-
campaign_name: string;
|
|
1485
|
-
strategy_template: string | null;
|
|
1486
|
-
target_count: number;
|
|
1487
|
-
estimated_credits: number;
|
|
1488
|
-
operating_playbooks: string[];
|
|
1489
|
-
};
|
|
1490
|
-
evidence: CampaignBuilderEvidencePacket | null;
|
|
1491
|
-
gates: Array<UnknownRecord$1 & {
|
|
1492
|
-
id: string;
|
|
1493
|
-
passed: boolean;
|
|
1494
|
-
}>;
|
|
1495
|
-
strategy_memory_status: UnknownRecord$1;
|
|
1496
|
-
dry_run_result: UnknownRecord$1;
|
|
1497
|
-
learn_back_plan: UnknownRecord$1;
|
|
1498
|
-
recommended_next_actions: string[];
|
|
1499
|
-
}
|
|
1500
|
-
interface CampaignBuilderBuildKitOptions extends CampaignBuilderAgentRequestTemplateOptions {
|
|
1501
|
-
requestFile?: string;
|
|
1502
|
-
cliPackage?: string;
|
|
1503
|
-
sdkPackage?: string;
|
|
1504
|
-
}
|
|
1505
|
-
type CampaignBuilderMemoryKitSource = 'agency' | 'north-star' | 'workflow-patterns' | 'instantly-feedback' | 'all' | (string & {});
|
|
1506
|
-
interface CampaignBuilderMemoryKitOptions extends CampaignBuilderAgentRequestTemplateOptions {
|
|
1507
|
-
requestFile?: string;
|
|
1508
|
-
seedManifestFile?: string;
|
|
1509
|
-
source?: CampaignBuilderMemoryKitSource;
|
|
1510
|
-
workspaceId?: string;
|
|
1511
|
-
cliPackage?: string;
|
|
1512
|
-
sdkPackage?: string;
|
|
1513
|
-
}
|
|
1514
|
-
interface CampaignBuilderBuildKitCommand {
|
|
1515
|
-
id: string;
|
|
1516
|
-
label: string;
|
|
1517
|
-
command: string;
|
|
1518
|
-
safety: string;
|
|
1519
|
-
}
|
|
1520
|
-
interface CampaignBuilderBuildKitMcpCall {
|
|
1521
|
-
id: string;
|
|
1522
|
-
tool: string;
|
|
1523
|
-
arguments: UnknownRecord$1;
|
|
1524
|
-
safety: string;
|
|
1525
|
-
}
|
|
1526
|
-
interface CampaignBuilderBuildKit {
|
|
1527
|
-
kit_version: 'campaign-builder-kit.v1';
|
|
1528
|
-
source: string;
|
|
1529
|
-
request_file: string;
|
|
1530
|
-
request: CampaignBuilderAgentRequest;
|
|
1531
|
-
strategy_template: string | null;
|
|
1532
|
-
built_in_lanes: string[];
|
|
1533
|
-
operating_playbooks: string[];
|
|
1534
|
-
custom_routes: Array<{
|
|
1535
|
-
provider: string;
|
|
1536
|
-
layer: string;
|
|
1537
|
-
tool: string | null;
|
|
1538
|
-
mcp_server: string | null;
|
|
1539
|
-
mode: string;
|
|
1540
|
-
approval_required: boolean;
|
|
1541
|
-
}>;
|
|
1542
|
-
approval_boundaries: string[];
|
|
1543
|
-
byo_tool_pattern: {
|
|
1544
|
-
cli_flag: string;
|
|
1545
|
-
request_fragment: CampaignBuilderIntegrationRoute;
|
|
1546
|
-
};
|
|
1547
|
-
cli_commands: CampaignBuilderBuildKitCommand[];
|
|
1548
|
-
mcp_calls: CampaignBuilderBuildKitMcpCall[];
|
|
1549
|
-
sdk_example: {
|
|
1550
|
-
language: 'typescript';
|
|
1551
|
-
code: string;
|
|
1552
|
-
};
|
|
1553
|
-
verification: string[];
|
|
1554
|
-
privacy: {
|
|
1555
|
-
client_names_allowed: boolean;
|
|
1556
|
-
notes: string[];
|
|
1557
|
-
};
|
|
1558
|
-
next_actions: string[];
|
|
1559
|
-
}
|
|
1560
|
-
interface CampaignBuilderMemoryKit {
|
|
1561
|
-
kit_version: 'campaign-memory-kit.v1';
|
|
1562
|
-
source: string;
|
|
1563
|
-
read_only: boolean;
|
|
1564
|
-
no_spend: boolean;
|
|
1565
|
-
no_provider_writes: boolean;
|
|
1566
|
-
client_names_allowed: boolean;
|
|
1567
|
-
request_file: string;
|
|
1568
|
-
seed_manifest_file: string;
|
|
1569
|
-
request: CampaignBuilderAgentRequest;
|
|
1570
|
-
strategy_template: string | null;
|
|
1571
|
-
operating_playbooks: string[];
|
|
1572
|
-
memory_sources: Array<{
|
|
1573
|
-
id: string;
|
|
1574
|
-
label: string;
|
|
1575
|
-
seed_source: string;
|
|
1576
|
-
scope: string;
|
|
1577
|
-
privacy: string;
|
|
1578
|
-
}>;
|
|
1579
|
-
seed_runner: {
|
|
1580
|
-
local_script: string;
|
|
1581
|
-
dry_run_command: string;
|
|
1582
|
-
verify_manifest_command: string | null;
|
|
1583
|
-
write_command: string;
|
|
1584
|
-
write_requires: string[];
|
|
1585
|
-
};
|
|
1586
|
-
cli_commands: CampaignBuilderBuildKitCommand[];
|
|
1587
|
-
mcp_calls: CampaignBuilderBuildKitMcpCall[];
|
|
1588
|
-
sdk_example: {
|
|
1589
|
-
language: 'typescript';
|
|
1590
|
-
code: string;
|
|
1591
|
-
};
|
|
1592
|
-
privacy: {
|
|
1593
|
-
client_names_allowed: boolean;
|
|
1594
|
-
notes: string[];
|
|
1595
|
-
};
|
|
1596
|
-
next_actions: string[];
|
|
1597
|
-
}
|
|
1598
|
-
interface CampaignBuilderBuildReviewOptions extends CampaignRowsOptions {
|
|
1599
|
-
/** Number of rows to sample for review. Defaults to 100. */
|
|
1600
|
-
limit?: number;
|
|
1601
|
-
}
|
|
1602
|
-
interface CampaignBuilderBuildReviewGate {
|
|
1603
|
-
id: string;
|
|
1604
|
-
label: string;
|
|
1605
|
-
passed: boolean;
|
|
1606
|
-
status?: CampaignBuilderNorthStarMetricStatus;
|
|
1607
|
-
detail: string;
|
|
1608
|
-
}
|
|
1609
|
-
type CampaignBuilderNorthStarMetricStatus = 'pass' | 'pending' | 'review' | 'blocked';
|
|
1610
|
-
interface CampaignBuilderNorthStarMetric {
|
|
1611
|
-
id: string;
|
|
1612
|
-
label: string;
|
|
1613
|
-
status: CampaignBuilderNorthStarMetricStatus;
|
|
1614
|
-
detail: string;
|
|
1615
|
-
value?: number | string | boolean | null;
|
|
1616
|
-
target?: number | string | boolean | null;
|
|
1617
|
-
}
|
|
1618
|
-
interface CampaignBuilderNorthStarScorecard {
|
|
1619
|
-
version: 'campaign-builder-north-star.v1';
|
|
1620
|
-
status: CampaignBuilderNorthStarMetricStatus;
|
|
1621
|
-
score: number | null;
|
|
1622
|
-
moatState: 'scaffolding_ready' | 'moved_needs_lift_volume' | 'proved';
|
|
1623
|
-
metrics: CampaignBuilderNorthStarMetric[];
|
|
1624
|
-
blockers: string[];
|
|
1625
|
-
warnings: string[];
|
|
1626
|
-
nextAction: string;
|
|
1627
|
-
}
|
|
1628
|
-
interface CampaignBuilderBuildReviewSummary {
|
|
147
|
+
interface PlatformHealth {
|
|
1629
148
|
status: string;
|
|
1630
|
-
|
|
1631
|
-
terminalState: string;
|
|
1632
|
-
scorecardStatus: CampaignBuilderNorthStarMetricStatus;
|
|
1633
|
-
scorecardScore: number | null;
|
|
1634
|
-
sampledRows: number;
|
|
1635
|
-
availableRows: number;
|
|
1636
|
-
qualifiedRows: number;
|
|
1637
|
-
rowsWithEmail: number;
|
|
1638
|
-
copyReadyRows: number;
|
|
1639
|
-
artifactCount: number;
|
|
1640
|
-
readyForDeliveryApproval: boolean;
|
|
1641
|
-
blockedReasons: string[];
|
|
1642
|
-
warnings: string[];
|
|
1643
|
-
}
|
|
1644
|
-
interface CampaignBuilderBuildReview {
|
|
1645
|
-
campaignBuildId: string;
|
|
1646
|
-
status: CampaignBuildStatus;
|
|
1647
|
-
rows: CampaignRowsResult;
|
|
1648
|
-
artifacts: CampaignArtifact[];
|
|
1649
|
-
gates: CampaignBuilderBuildReviewGate[];
|
|
1650
|
-
northStarScorecard: CampaignBuilderNorthStarScorecard;
|
|
1651
|
-
summary: CampaignBuilderBuildReviewSummary;
|
|
1652
|
-
nextActions: string[];
|
|
1653
|
-
}
|
|
1654
|
-
interface CampaignBuilderReadinessLane {
|
|
1655
|
-
id: string;
|
|
1656
|
-
label: string;
|
|
1657
|
-
layer: CampaignBuilderLayer;
|
|
1658
|
-
gtmLayers: string[];
|
|
1659
|
-
provider: CampaignBuilderProvider;
|
|
1660
|
-
toolName?: string;
|
|
1661
|
-
mode: CampaignBuilderRouteMode;
|
|
1662
|
-
builtIn?: CampaignBuilderBuiltInTool;
|
|
1663
|
-
approvalRequired: boolean;
|
|
1664
|
-
customRoute: boolean;
|
|
1665
|
-
readOnlySetup: boolean;
|
|
1666
|
-
ready: boolean;
|
|
1667
|
-
blockers: string[];
|
|
1668
|
-
nextAction?: string;
|
|
1669
|
-
}
|
|
1670
|
-
interface CampaignBuilderReadinessGate {
|
|
1671
|
-
id: string;
|
|
1672
|
-
label: string;
|
|
1673
|
-
passed: boolean;
|
|
1674
|
-
detail: string;
|
|
1675
|
-
}
|
|
1676
|
-
interface CampaignBuilderReadinessSummary {
|
|
1677
|
-
ready: boolean;
|
|
1678
|
-
score: number;
|
|
1679
|
-
targetCount: number;
|
|
1680
|
-
estimatedCredits: number;
|
|
1681
|
-
builtInLanesReady: number;
|
|
1682
|
-
builtInLanesTotal: number;
|
|
1683
|
-
customRoutesReady: number;
|
|
1684
|
-
customRoutesTotal: number;
|
|
1685
|
-
approvalGateCount: number;
|
|
1686
|
-
blockers: string[];
|
|
1687
|
-
warnings: string[];
|
|
1688
|
-
}
|
|
1689
|
-
interface CampaignBuilderReadinessPacket {
|
|
1690
|
-
plan: CampaignBuilderAgentPlan;
|
|
1691
|
-
lanes: CampaignBuilderReadinessLane[];
|
|
1692
|
-
gates: CampaignBuilderReadinessGate[];
|
|
1693
|
-
summary: CampaignBuilderReadinessSummary;
|
|
1694
|
-
nextActions: string[];
|
|
1695
|
-
}
|
|
1696
|
-
type CampaignBuilderActiveWorkState = 'unknown' | 'planning' | 'blocked' | 'needs_approval' | 'ready_for_dry_run' | 'dry_run_complete' | 'queued_or_running' | 'completed';
|
|
1697
|
-
interface CampaignBuilderActiveWorkReference {
|
|
1698
|
-
kind: 'plan' | 'gtm_campaign' | 'campaign_build' | 'provider_campaign' | 'provider_route' | 'memory' | 'approval' | 'external_job' | (string & {});
|
|
1699
|
-
id: string;
|
|
1700
|
-
label?: string;
|
|
1701
|
-
status?: string;
|
|
1702
|
-
source?: string;
|
|
1703
|
-
}
|
|
1704
|
-
interface CampaignBuilderActiveWorkMcpAction {
|
|
1705
|
-
id: string;
|
|
1706
|
-
tool: string;
|
|
1707
|
-
arguments: UnknownRecord$1;
|
|
1708
|
-
read_only: boolean;
|
|
1709
|
-
approval_required: boolean;
|
|
1710
|
-
safety: string;
|
|
1711
|
-
}
|
|
1712
|
-
interface CampaignBuilderActiveWorkSummary {
|
|
1713
|
-
plan_id: string | null;
|
|
1714
|
-
campaign_name: string | null;
|
|
1715
|
-
target_count: number | null;
|
|
1716
|
-
gtm_campaign_id: string | null;
|
|
1717
|
-
campaign_build_id: string | null;
|
|
1718
|
-
provider_campaign_id: string | null;
|
|
1719
|
-
}
|
|
1720
|
-
interface CampaignBuilderActiveWorkApprovalPacket {
|
|
1721
|
-
packet_version: 'campaign-builder-approval-packet.v1';
|
|
1722
|
-
read_only: true;
|
|
1723
|
-
no_spend: true;
|
|
1724
|
-
no_provider_writes: true;
|
|
1725
|
-
private_safe: true;
|
|
1726
|
-
approval_state: 'unscoped' | 'requires_approval' | 'approved';
|
|
1727
|
-
plan_id: string | null;
|
|
1728
|
-
campaign_name: string | null;
|
|
1729
|
-
requested_approval_types: CampaignBuilderApprovalType[];
|
|
1730
|
-
missing_approval_types: CampaignBuilderApprovalType[];
|
|
1731
|
-
spend_limit_credits_required: number | null;
|
|
1732
|
-
route_ids_required: string[];
|
|
1733
|
-
required_approvals: Array<{
|
|
1734
|
-
id: string;
|
|
1735
|
-
type: CampaignBuilderApprovalType;
|
|
1736
|
-
label: string;
|
|
1737
|
-
reason: string;
|
|
1738
|
-
blocking: boolean;
|
|
1739
|
-
route_id?: string;
|
|
1740
|
-
provider?: CampaignBuilderProvider;
|
|
1741
|
-
estimated_credits?: number;
|
|
1742
|
-
status: 'missing' | 'approved';
|
|
1743
|
-
}>;
|
|
1744
|
-
approval_input: {
|
|
1745
|
-
approved_by: string | null;
|
|
1746
|
-
approved_at: string | null;
|
|
1747
|
-
approved_types: CampaignBuilderApprovalType[];
|
|
1748
|
-
approved_route_ids: string[];
|
|
1749
|
-
spend_limit_credits: number | null;
|
|
1750
|
-
notes?: string;
|
|
1751
|
-
};
|
|
1752
|
-
cli_handoff: {
|
|
1753
|
-
command: string;
|
|
1754
|
-
safety: string;
|
|
1755
|
-
} | null;
|
|
1756
|
-
sdk_handoff: {
|
|
1757
|
-
method: 'campaignBuilderAgent.buildApprovedPlan';
|
|
1758
|
-
approval: {
|
|
1759
|
-
approvedBy: string;
|
|
1760
|
-
approvedTypes: CampaignBuilderApprovalType[];
|
|
1761
|
-
approvedRouteIds: string[];
|
|
1762
|
-
spendLimitCredits?: number;
|
|
1763
|
-
notes?: string;
|
|
1764
|
-
};
|
|
1765
|
-
options: {
|
|
1766
|
-
idempotencyKey: string;
|
|
1767
|
-
};
|
|
1768
|
-
safety: string;
|
|
1769
|
-
} | null;
|
|
1770
|
-
mcp_handoffs: CampaignBuilderActiveWorkMcpAction[];
|
|
1771
|
-
safety_boundary: string;
|
|
1772
|
-
}
|
|
1773
|
-
interface CampaignBuilderOpenAiAgentHandoffTool {
|
|
1774
|
-
id: string;
|
|
1775
|
-
type: 'mcp';
|
|
1776
|
-
server_label: 'signaliz';
|
|
1777
|
-
name: string;
|
|
1778
|
-
arguments: UnknownRecord$1;
|
|
1779
|
-
read_only: boolean;
|
|
1780
|
-
approval_required: boolean;
|
|
1781
|
-
purpose: string;
|
|
1782
|
-
safety: string;
|
|
1783
|
-
}
|
|
1784
|
-
interface CampaignBuilderOpenAiAgentHandoff {
|
|
1785
|
-
packet_version: 'campaign-builder-openai-agent-handoff.v1';
|
|
1786
|
-
surface: 'openai_agents_sdk';
|
|
1787
|
-
agent: {
|
|
1788
|
-
name: 'Signaliz GTM Campaign Agent';
|
|
1789
|
-
handoff_description: string;
|
|
1790
|
-
instructions: string[];
|
|
1791
|
-
output_contract: string[];
|
|
1792
|
-
};
|
|
1793
|
-
context: {
|
|
1794
|
-
state: CampaignBuilderActiveWorkState;
|
|
1795
|
-
summary: CampaignBuilderActiveWorkSummary;
|
|
1796
|
-
refs: CampaignBuilderActiveWorkReference[];
|
|
1797
|
-
blockers: string[];
|
|
1798
|
-
warnings: string[];
|
|
1799
|
-
evidence_context: CampaignBuilderEvidencePacket | null;
|
|
1800
|
-
approval_packet: CampaignBuilderActiveWorkApprovalPacket;
|
|
1801
|
-
approval_boundary: string;
|
|
1802
|
-
next_safe_action: string;
|
|
1803
|
-
conversation_starters: string[];
|
|
1804
|
-
};
|
|
1805
|
-
tools: {
|
|
1806
|
-
mcp_server_label: 'signaliz';
|
|
1807
|
-
remote_mcp_compatible: true;
|
|
1808
|
-
next_safe_mcp_action: CampaignBuilderActiveWorkMcpAction | null;
|
|
1809
|
-
safe_read_tools: CampaignBuilderOpenAiAgentHandoffTool[];
|
|
1810
|
-
approval_gated_tools: CampaignBuilderOpenAiAgentHandoffTool[];
|
|
1811
|
-
};
|
|
1812
|
-
guardrails: {
|
|
1813
|
-
input: string[];
|
|
1814
|
-
tool: string[];
|
|
1815
|
-
human_review_required_for: CampaignBuilderApprovalType[];
|
|
1816
|
-
privacy: string;
|
|
1817
|
-
};
|
|
1818
|
-
}
|
|
1819
|
-
interface CampaignBuilderRememberedWork {
|
|
1820
|
-
planId?: string;
|
|
1821
|
-
gtmCampaignId?: string;
|
|
1822
|
-
campaignBuildId?: string;
|
|
1823
|
-
providerCampaignId?: string;
|
|
1824
|
-
provider?: string;
|
|
1825
|
-
status?: string;
|
|
1826
|
-
refs?: CampaignBuilderActiveWorkReference[];
|
|
1827
|
-
}
|
|
1828
|
-
interface CampaignBuilderActiveWorkContextInput {
|
|
1829
|
-
plan?: CampaignBuilderAgentPlan;
|
|
1830
|
-
readiness?: CampaignBuilderReadinessPacket;
|
|
1831
|
-
remembered?: CampaignBuilderRememberedWork;
|
|
1832
|
-
refs?: CampaignBuilderActiveWorkReference[];
|
|
1833
|
-
approval?: CampaignBuilderApproval;
|
|
1834
|
-
blockers?: string[];
|
|
1835
|
-
warnings?: string[];
|
|
1836
|
-
lastResult?: UnknownRecord$1;
|
|
1837
|
-
}
|
|
1838
|
-
interface CampaignBuilderActiveWorkContextPacket {
|
|
1839
|
-
packet_version: 'campaign-builder-active-work-context.v1';
|
|
1840
|
-
read_only: true;
|
|
1841
|
-
no_spend: true;
|
|
1842
|
-
no_provider_writes: true;
|
|
1843
|
-
private_safe: true;
|
|
1844
|
-
state: CampaignBuilderActiveWorkState;
|
|
1845
|
-
summary: CampaignBuilderActiveWorkSummary;
|
|
1846
|
-
refs: CampaignBuilderActiveWorkReference[];
|
|
1847
|
-
blockers: string[];
|
|
1848
|
-
warnings: string[];
|
|
1849
|
-
missing_approval_types: CampaignBuilderApprovalType[];
|
|
1850
|
-
approval_packet: CampaignBuilderActiveWorkApprovalPacket;
|
|
1851
|
-
approval_boundary: string;
|
|
1852
|
-
next_safe_action: string;
|
|
1853
|
-
next_safe_mcp_action: CampaignBuilderActiveWorkMcpAction | null;
|
|
1854
|
-
conversation_starters: string[];
|
|
1855
|
-
openai_agent_handoff: CampaignBuilderOpenAiAgentHandoff;
|
|
1856
|
-
}
|
|
1857
|
-
declare const DEFAULT_SIGNALIZ_CAMPAIGN_BUILDER_DEFAULTS: Required<Pick<SignalizCampaignBuilderDefaults, 'requireVerifiedEmail' | 'dedupKeys' | 'allowDownscale'>> & SignalizCampaignBuilderDefaults;
|
|
1858
|
-
declare const DEFAULT_CAMPAIGN_BUILDER_BUILT_INS: CampaignBuilderBuiltInTool[];
|
|
1859
|
-
declare const DEFAULT_CAMPAIGN_BUILDER_APPROVAL_TYPES: CampaignBuilderApprovalType[];
|
|
1860
|
-
declare const CAMPAIGN_BUILDER_OPERATING_PLAYBOOKS: CampaignBuilderOperatingPlaybook[];
|
|
1861
|
-
declare const CAMPAIGN_BUILDER_STRATEGY_TEMPLATES: CampaignBuilderStrategyTemplate[];
|
|
1862
|
-
declare class CampaignBuilderAgent {
|
|
1863
|
-
private client;
|
|
1864
|
-
constructor(client: HttpClient);
|
|
1865
|
-
createPlan(request: CampaignBuilderAgentRequest, options?: CampaignBuilderPlanOptions): Promise<CampaignBuilderAgentPlan>;
|
|
1866
|
-
readiness(request: CampaignBuilderAgentRequest, options?: CampaignBuilderPlanOptions): Promise<CampaignBuilderReadinessPacket>;
|
|
1867
|
-
activeWorkContext(input: CampaignBuilderActiveWorkContextInput): CampaignBuilderActiveWorkContextPacket;
|
|
1868
|
-
proof(request: CampaignBuilderAgentRequest, options?: CampaignBuilderProofOptions): Promise<CampaignBuilderProofReceipt>;
|
|
1869
|
-
buildKit(options?: CampaignBuilderBuildKitOptions): CampaignBuilderBuildKit;
|
|
1870
|
-
memoryKit(options?: CampaignBuilderMemoryKitOptions): CampaignBuilderMemoryKit;
|
|
1871
|
-
commitPlan(plan: CampaignBuilderAgentPlan, options?: CampaignBuilderPlanCommitOptions): Promise<CampaignBuilderPlanCommitResult>;
|
|
1872
|
-
dryRunPlan(plan: CampaignBuilderAgentPlan, options?: BuildOptions): Promise<CampaignBuildResult>;
|
|
1873
|
-
buildApprovedPlan(plan: CampaignBuilderAgentPlan, approval: CampaignBuilderApproval, options?: CampaignBuilderBuildOptions): Promise<CampaignBuildResult>;
|
|
1874
|
-
runApprovedPlan(plan: CampaignBuilderAgentPlan, approval: CampaignBuilderApproval, options?: CampaignBuilderApprovedRunOptions): Promise<CampaignBuilderApprovedRunResult>;
|
|
1875
|
-
getBuildStatus(campaignBuildId: string): Promise<CampaignBuildStatus>;
|
|
1876
|
-
getBuildRows(campaignBuildId: string, options?: CampaignRowsOptions): Promise<CampaignRowsResult>;
|
|
1877
|
-
listBuildArtifacts(campaignBuildId: string): Promise<CampaignArtifact[]>;
|
|
1878
|
-
approveDelivery(campaignBuildId: string, destinationType: CampaignDeliveryMode, options?: {
|
|
1879
|
-
destinationId?: string;
|
|
1880
|
-
destinationConfig?: UnknownRecord$1;
|
|
1881
|
-
allowPartialDelivery?: boolean;
|
|
1882
|
-
}): Promise<ApproveDeliveryResult>;
|
|
1883
|
-
reviewBuild(campaignBuildId: string, options?: CampaignBuilderBuildReviewOptions): Promise<CampaignBuilderBuildReview>;
|
|
1884
|
-
private getCampaignBuildStatus;
|
|
1885
|
-
private waitForCampaignBuildStatus;
|
|
1886
|
-
private approveCampaignDelivery;
|
|
1887
|
-
private getWorkspaceContext;
|
|
1888
|
-
private scopeCampaign;
|
|
1889
|
-
private discoverPlannedRoutes;
|
|
1890
|
-
private attachStrategyMemoryStatus;
|
|
1891
|
-
private attachKernelCampaignBuildPlan;
|
|
1892
|
-
private attachDeliveryRiskPreflight;
|
|
1893
|
-
private callMcp;
|
|
1894
|
-
}
|
|
1895
|
-
declare function createCampaignBuilderAgentPlan(request: CampaignBuilderAgentRequest, context?: {
|
|
1896
|
-
workspaceContext?: CampaignBuilderWorkspaceContext;
|
|
1897
|
-
scopeBuildArgs?: UnknownRecord$1;
|
|
1898
|
-
scopeBrainPreflight?: UnknownRecord$1;
|
|
1899
|
-
warnings?: string[];
|
|
1900
|
-
}): CampaignBuilderAgentPlan;
|
|
1901
|
-
declare function createCampaignBuilderReadiness(plan: CampaignBuilderAgentPlan): CampaignBuilderReadinessPacket;
|
|
1902
|
-
declare function createCampaignBuilderActiveWorkContext(input: CampaignBuilderActiveWorkContextInput): CampaignBuilderActiveWorkContextPacket;
|
|
1903
|
-
declare function createCampaignBuilderProofReceipt(plan: CampaignBuilderAgentPlan, result: unknown): CampaignBuilderProofReceipt;
|
|
1904
|
-
declare function getMissingCampaignBuilderApprovals(plan: CampaignBuilderAgentPlan, approval: CampaignBuilderApproval): CampaignBuilderRequiredApproval[];
|
|
1905
|
-
declare function createCampaignBuilderApproval(plan: CampaignBuilderAgentPlan, input: Omit<CampaignBuilderApproval, 'planId' | 'approvedAt'>): CampaignBuilderApproval;
|
|
1906
|
-
declare function getCampaignBuilderStrategyTemplate(value: unknown): CampaignBuilderStrategyTemplate | undefined;
|
|
1907
|
-
declare function getCampaignBuilderOperatingPlaybook(value: unknown): CampaignBuilderOperatingPlaybook | undefined;
|
|
1908
|
-
declare function getCampaignBuilderOperatingPlaybooksForRequest(request: CampaignBuilderAgentRequest): CampaignBuilderOperatingPlaybook[];
|
|
1909
|
-
declare function applyCampaignBuilderStrategyTemplate(request: CampaignBuilderAgentRequest): CampaignBuilderAgentRequest;
|
|
1910
|
-
declare function createCampaignBuilderAgentRequestTemplate(input?: CampaignBuilderAgentRequestTemplateOptions): CampaignBuilderAgentRequest;
|
|
1911
|
-
declare function createCampaignBuilderBuildKit(input?: CampaignBuilderBuildKitOptions): CampaignBuilderBuildKit;
|
|
1912
|
-
declare function createCampaignBuilderMemoryKit(input?: CampaignBuilderMemoryKitOptions): CampaignBuilderMemoryKit;
|
|
1913
|
-
declare function createCampaignBuilderToolRoute(input: {
|
|
1914
|
-
provider?: CampaignBuilderProvider;
|
|
1915
|
-
layer: CampaignBuilderLayer;
|
|
1916
|
-
toolName?: string;
|
|
1917
|
-
mcpServerName?: string;
|
|
1918
|
-
label?: string;
|
|
1919
|
-
mode?: CampaignBuilderRouteMode;
|
|
1920
|
-
gtmLayer?: CampaignBuilderGtmLayer;
|
|
1921
|
-
gtmLayers?: CampaignBuilderGtmLayer[];
|
|
1922
|
-
approvalRequired?: boolean;
|
|
1923
|
-
config?: UnknownRecord$1;
|
|
1924
|
-
}): CampaignBuilderIntegrationRoute;
|
|
1925
|
-
|
|
1926
|
-
interface IcpSummary {
|
|
1927
|
-
id: string;
|
|
1928
|
-
name: string;
|
|
1929
|
-
description?: string;
|
|
1930
|
-
industry_focus?: string[];
|
|
1931
|
-
target_job_titles?: string[];
|
|
1932
|
-
target_departments?: string[];
|
|
1933
|
-
geography?: string[];
|
|
1934
|
-
has_source_playbook_data: boolean;
|
|
1935
|
-
/** @deprecated Use has_source_playbook_data. */
|
|
1936
|
-
has_octave_data?: boolean;
|
|
1937
|
-
created_at: string;
|
|
1938
|
-
}
|
|
1939
|
-
interface IcpDetail extends IcpSummary {
|
|
1940
|
-
pain_points?: string[];
|
|
1941
|
-
buying_triggers?: string[];
|
|
1942
|
-
tech_stack?: string[];
|
|
1943
|
-
revenue_range?: string;
|
|
1944
|
-
employee_count_range?: string[];
|
|
1945
|
-
deep_analysis?: Record<string, unknown>;
|
|
1946
|
-
source_playbook_data?: Record<string, unknown>;
|
|
1947
|
-
/** @deprecated Use source_playbook_data. */
|
|
1948
|
-
octave_playbook_data?: Record<string, unknown>;
|
|
1949
|
-
updated_at: string;
|
|
1950
|
-
}
|
|
1951
|
-
interface ImportPlaybooksResult {
|
|
1952
|
-
imported: number;
|
|
1953
|
-
skipped: number;
|
|
1954
|
-
icps: Array<{
|
|
1955
|
-
id: string;
|
|
1956
|
-
name: string;
|
|
1957
|
-
}>;
|
|
1958
|
-
}
|
|
1959
|
-
/** @deprecated Use ImportPlaybooksResult. */
|
|
1960
|
-
type ImportOctaveResult = ImportPlaybooksResult;
|
|
1961
|
-
declare class Icps {
|
|
1962
|
-
private client;
|
|
1963
|
-
constructor(client: HttpClient);
|
|
1964
|
-
/** List all ICPs in the workspace */
|
|
1965
|
-
list(opts?: {
|
|
1966
|
-
includeSourcePlaybookData?: boolean;
|
|
1967
|
-
includeOctaveData?: boolean;
|
|
1968
|
-
}): Promise<IcpSummary[]>;
|
|
1969
|
-
/** Get full ICP details by ID */
|
|
1970
|
-
get(icpId: string): Promise<IcpDetail>;
|
|
1971
|
-
/** Import connected source playbooks as ICPs */
|
|
1972
|
-
importFromPlaybooks(playbookIds?: string[]): Promise<ImportPlaybooksResult>;
|
|
1973
|
-
/** @deprecated Use importFromPlaybooks. */
|
|
1974
|
-
importFromOctave(playbookIds?: string[]): Promise<ImportPlaybooksResult>;
|
|
149
|
+
products: string[];
|
|
1975
150
|
}
|
|
1976
151
|
|
|
1977
|
-
declare class
|
|
1978
|
-
|
|
1979
|
-
|
|
1980
|
-
|
|
1981
|
-
|
|
1982
|
-
|
|
1983
|
-
|
|
1984
|
-
generate(params: GenerateLeadsParams): Promise<LeadGenJobResult>;
|
|
1985
|
-
/**
|
|
1986
|
-
* Generate local business leads via Google Maps + email scraping.
|
|
1987
|
-
* Returns a job_id — poll with `runs.get(jobId)` or `check_job_status`.
|
|
1988
|
-
*/
|
|
1989
|
-
generateLocal(params: GenerateLocalLeadsParams): Promise<LeadGenJobResult>;
|
|
1990
|
-
/**
|
|
1991
|
-
* List curated native GTM data sources with data-cost guardrails.
|
|
1992
|
-
*/
|
|
1993
|
-
listNativeGtmCapabilities(category?: string): Promise<NativeGtmCapabilityInfo[]>;
|
|
1994
|
-
/**
|
|
1995
|
-
* Run a curated native GTM capability. Returns a job_id; poll with `runs.get(jobId)`
|
|
1996
|
-
* or `checkStatus(jobId)`.
|
|
1997
|
-
*/
|
|
1998
|
-
runNativeGtmCapability(params: RunNativeGtmCapabilityParams): Promise<LeadGenJobResult>;
|
|
1999
|
-
/**
|
|
2000
|
-
* Free-text router: pass an intent like "pull youtube subscribers of @joshwhitfieldai"
|
|
2001
|
-
* and get back the top GTM capability matches with suggested args ready to run.
|
|
2002
|
-
*/
|
|
2003
|
-
findGtmCapability(intent: string): Promise<{
|
|
2004
|
-
matches: Array<{
|
|
2005
|
-
capability_id: string;
|
|
2006
|
-
label: string;
|
|
2007
|
-
category: string;
|
|
2008
|
-
score: number;
|
|
2009
|
-
why_it_matched: string[];
|
|
2010
|
-
required_input: string;
|
|
2011
|
-
suggested_args: Record<string, unknown>;
|
|
2012
|
-
}>;
|
|
2013
|
-
intent: string;
|
|
2014
|
-
}>;
|
|
2015
|
-
/**
|
|
2016
|
-
* Check the status of a lead generation job.
|
|
2017
|
-
*/
|
|
2018
|
-
checkStatus(jobId: string): Promise<Record<string, unknown>>;
|
|
2019
|
-
}
|
|
2020
|
-
|
|
2021
|
-
type UnknownRecord = Record<string, unknown>;
|
|
2022
|
-
type GtmCampaignStatus = 'draft' | 'building' | 'ready' | 'active' | 'paused' | 'completed' | 'archived' | 'failed';
|
|
2023
|
-
type GtmCampaignSource = 'mcp' | 'campaign_builder' | 'routine' | 'manual' | 'import' | 'api' | 'webhook';
|
|
2024
|
-
type GtmActorType = 'human' | 'agent' | 'system' | 'provider';
|
|
2025
|
-
type GtmPatternType = 'angle' | 'subject_line' | 'opener' | 'sequence_structure' | 'icp' | 'lead_source' | 'provider_chain' | 'verification' | 'failure' | 'default' | 'calibration' | 'other';
|
|
2026
|
-
type GtmMemoryType = 'subject_line' | 'opener' | 'sequence_step' | 'icp' | 'lead_source' | 'provider_chain' | 'verification' | 'reply' | 'objection' | 'meeting' | 'failure' | 'campaign_summary' | 'agent_note' | 'other';
|
|
2027
|
-
type GtmLayer = 'icp' | 'find_company' | 'find_people' | 'lead_generation' | 'local_leads' | 'email_finding' | 'email_verification' | 'company_enrichment' | 'copy_enrichment' | 'qualification' | 'sender' | 'feedback' | 'approval' | 'source_import' | 'destination_export' | 'customer_data' | 'custom';
|
|
2028
|
-
type GtmInvocationType = 'signaliz_native' | 'webhook' | 'mcp_tool' | 'airbyte' | 'api' | 'managed_integration' | 'manual';
|
|
2029
|
-
type GtmAuthStrategy = 'none' | 'integration_key' | 'mcp_auth' | 'webhook_secret' | 'session_vault' | 'byo_runtime';
|
|
2030
|
-
interface GtmWorkspaceContextOptions {
|
|
2031
|
-
includeCampaigns?: boolean;
|
|
2032
|
-
includeMemory?: boolean;
|
|
2033
|
-
includeBrain?: boolean;
|
|
2034
|
-
includeConnections?: boolean;
|
|
2035
|
-
limit?: number;
|
|
2036
|
-
}
|
|
2037
|
-
interface GtmWorkspaceBootstrapStatusOptions {
|
|
2038
|
-
campaignId?: string;
|
|
2039
|
-
days?: number;
|
|
2040
|
-
minSampleSize?: number;
|
|
2041
|
-
includeConnections?: boolean;
|
|
2042
|
-
includeSamples?: boolean;
|
|
2043
|
-
limit?: number;
|
|
2044
|
-
}
|
|
2045
|
-
interface GtmExistingCampaignDiscoverOptions {
|
|
2046
|
-
provider?: string;
|
|
2047
|
-
integrationId?: string;
|
|
2048
|
-
search?: string;
|
|
2049
|
-
limit?: number;
|
|
2050
|
-
includeKernelLinked?: boolean;
|
|
2051
|
-
includeProviderLive?: boolean;
|
|
2052
|
-
}
|
|
2053
|
-
interface GtmExistingCampaignAuditOptions {
|
|
2054
|
-
campaignId?: string;
|
|
2055
|
-
provider?: string;
|
|
2056
|
-
providerCampaignId?: string;
|
|
2057
|
-
campaignName?: string;
|
|
2058
|
-
days?: number;
|
|
2059
|
-
includeRoutePreview?: boolean;
|
|
2060
|
-
includeMemory?: boolean;
|
|
2061
|
-
includeBrain?: boolean;
|
|
2062
|
-
}
|
|
2063
|
-
interface GtmExistingCampaignAuditBySearchOptions extends Omit<GtmExistingCampaignAuditOptions, 'campaignId' | 'providerCampaignId' | 'campaignName'> {
|
|
2064
|
-
search: string;
|
|
2065
|
-
integrationId?: string;
|
|
2066
|
-
includeKernelLinked?: boolean;
|
|
2067
|
-
includeProviderLive?: boolean;
|
|
2068
|
-
}
|
|
2069
|
-
type GtmExistingCampaignAuditBoundary = 'read_only' | 'dry_run' | 'write_import' | 'route_write' | 'sender_load' | 'export' | 'delivery' | 'approval_decision' | string;
|
|
2070
|
-
interface GtmExistingCampaignMcpRequest {
|
|
2071
|
-
tool: string;
|
|
2072
|
-
arguments: UnknownRecord;
|
|
2073
|
-
}
|
|
2074
|
-
interface GtmExistingCampaignOption {
|
|
2075
|
-
source?: 'kernel_linked' | 'provider_live' | string;
|
|
2076
|
-
provider?: string;
|
|
2077
|
-
provider_link_id?: string | null;
|
|
2078
|
-
provider_campaign_id?: string | null;
|
|
2079
|
-
name?: string | null;
|
|
2080
|
-
status?: string | number | null;
|
|
2081
|
-
integration_id?: string | null;
|
|
2082
|
-
integration_label?: string | null;
|
|
2083
|
-
linked_kernel_campaign_id?: string | null;
|
|
2084
|
-
linked_kernel_campaign_name?: string | null;
|
|
2085
|
-
linked_kernel_campaign_status?: string | null;
|
|
2086
|
-
audit_request?: GtmExistingCampaignMcpRequest;
|
|
2087
|
-
[key: string]: unknown;
|
|
2088
|
-
}
|
|
2089
|
-
interface GtmExistingCampaignDiscoveryResult {
|
|
2090
|
-
provider?: string;
|
|
2091
|
-
campaigns?: GtmExistingCampaignOption[];
|
|
2092
|
-
counts?: {
|
|
2093
|
-
total_returned?: number;
|
|
2094
|
-
kernel_linked?: number;
|
|
2095
|
-
provider_live?: number;
|
|
2096
|
-
[key: string]: unknown;
|
|
2097
|
-
};
|
|
2098
|
-
integration_summaries?: UnknownRecord[];
|
|
2099
|
-
blockers?: string[];
|
|
2100
|
-
warnings?: string[];
|
|
2101
|
-
next_safe_action?: GtmExistingCampaignMcpRequest | UnknownRecord;
|
|
2102
|
-
}
|
|
2103
|
-
interface GtmExistingCampaignCompletenessStep {
|
|
2104
|
-
id: 'provider_history' | 'feedback_events' | 'kernel_memory' | 'brain_evidence' | 'provider_routes' | string;
|
|
2105
|
-
label: string;
|
|
2106
|
-
ready: boolean;
|
|
2107
|
-
count: number;
|
|
2108
|
-
approval_boundary: GtmExistingCampaignAuditBoundary;
|
|
2109
|
-
detail?: string;
|
|
2110
|
-
next_safe_request?: GtmExistingCampaignMcpRequest;
|
|
2111
|
-
post_action_verification?: GtmExistingCampaignMcpRequest;
|
|
2112
|
-
}
|
|
2113
|
-
interface GtmExistingCampaignAuditRecommendation {
|
|
2114
|
-
id?: string;
|
|
2115
|
-
category?: string;
|
|
2116
|
-
title?: string;
|
|
2117
|
-
summary?: string;
|
|
2118
|
-
confidence?: string;
|
|
2119
|
-
approval_boundary?: GtmExistingCampaignAuditBoundary;
|
|
2120
|
-
evidence?: string[];
|
|
2121
|
-
suggested_tool?: string;
|
|
2122
|
-
suggested_action?: string;
|
|
2123
|
-
next_safe_request?: GtmExistingCampaignMcpRequest;
|
|
2124
|
-
post_action_verification?: GtmExistingCampaignMcpRequest;
|
|
2125
|
-
}
|
|
2126
|
-
interface GtmExistingCampaignAuditResult {
|
|
2127
|
-
workspace_id?: string;
|
|
2128
|
-
provider?: string;
|
|
2129
|
-
provider_campaign_id?: string | null;
|
|
2130
|
-
campaign?: UnknownRecord | null;
|
|
2131
|
-
audit_score?: number;
|
|
2132
|
-
evidence_counts?: UnknownRecord;
|
|
2133
|
-
completeness?: GtmExistingCampaignCompletenessStep[];
|
|
2134
|
-
aggregate_metrics?: UnknownRecord;
|
|
2135
|
-
provider_links?: UnknownRecord[];
|
|
2136
|
-
memory_samples?: UnknownRecord[];
|
|
2137
|
-
brain_samples?: UnknownRecord;
|
|
2138
|
-
route_summary?: UnknownRecord;
|
|
2139
|
-
blockers?: string[];
|
|
2140
|
-
warnings?: string[];
|
|
2141
|
-
recommendations?: GtmExistingCampaignAuditRecommendation[];
|
|
2142
|
-
next_safe_actions?: GtmExistingCampaignMcpRequest[];
|
|
2143
|
-
execution_policy?: string;
|
|
2144
|
-
privacy_policy?: string;
|
|
2145
|
-
}
|
|
2146
|
-
interface GtmProviderLinkInput {
|
|
2147
|
-
provider: string;
|
|
2148
|
-
providerCampaignId: string;
|
|
2149
|
-
integrationId?: string;
|
|
2150
|
-
providerWorkspaceId?: string;
|
|
2151
|
-
providerAccountId?: string;
|
|
2152
|
-
status?: string;
|
|
2153
|
-
metadata?: UnknownRecord;
|
|
2154
|
-
}
|
|
2155
|
-
interface GtmCampaignCreateInput {
|
|
2156
|
-
name: string;
|
|
2157
|
-
description?: string;
|
|
2158
|
-
source?: GtmCampaignSource;
|
|
2159
|
-
status?: GtmCampaignStatus;
|
|
2160
|
-
campaignBuildId?: string;
|
|
2161
|
-
campaignBuilderJobId?: string;
|
|
2162
|
-
routineId?: string;
|
|
2163
|
-
targetIcp?: UnknownRecord;
|
|
2164
|
-
sequences?: UnknownRecord[];
|
|
2165
|
-
leadListRefs?: UnknownRecord[];
|
|
2166
|
-
sendConfig?: UnknownRecord;
|
|
2167
|
-
providerLinks?: GtmProviderLinkInput[];
|
|
2168
|
-
brainConfig?: UnknownRecord;
|
|
2169
|
-
metadata?: UnknownRecord;
|
|
2170
|
-
log?: GtmCampaignLogInput;
|
|
2171
|
-
}
|
|
2172
|
-
interface GtmCampaignHistoryMemoryInput {
|
|
2173
|
-
idempotencyKey?: string;
|
|
2174
|
-
memoryType?: GtmMemoryType;
|
|
2175
|
-
title: string;
|
|
2176
|
-
content: string;
|
|
2177
|
-
keywords?: string[];
|
|
2178
|
-
dimensions?: UnknownRecord;
|
|
2179
|
-
outcomeType?: string;
|
|
2180
|
-
outcomeValue?: number;
|
|
2181
|
-
sampleSize?: number;
|
|
2182
|
-
confidence?: number;
|
|
2183
|
-
shareable?: boolean;
|
|
2184
|
-
redactionState?: 'raw' | 'redacted' | 'abstracted';
|
|
2185
|
-
metadata?: UnknownRecord;
|
|
2186
|
-
recencyAt?: string;
|
|
2187
|
-
}
|
|
2188
|
-
interface GtmCampaignHistoryCampaignInput {
|
|
2189
|
-
campaignId?: string;
|
|
2190
|
-
idempotencyKey?: string;
|
|
2191
|
-
name?: string;
|
|
2192
|
-
description?: string;
|
|
2193
|
-
source?: GtmCampaignSource;
|
|
2194
|
-
status?: GtmCampaignStatus;
|
|
2195
|
-
campaignBuildId?: string;
|
|
2196
|
-
campaignBuilderJobId?: string;
|
|
2197
|
-
routineId?: string;
|
|
2198
|
-
targetIcp?: UnknownRecord;
|
|
2199
|
-
sequences?: UnknownRecord[];
|
|
2200
|
-
leadListRefs?: UnknownRecord[];
|
|
2201
|
-
sendConfig?: UnknownRecord;
|
|
2202
|
-
performanceMetrics?: UnknownRecord;
|
|
2203
|
-
brainConfig?: UnknownRecord;
|
|
2204
|
-
memorySummary?: UnknownRecord;
|
|
2205
|
-
metadata?: UnknownRecord;
|
|
2206
|
-
providerLinks?: GtmProviderLinkInput[];
|
|
2207
|
-
feedbackEvents?: UnknownRecord[];
|
|
2208
|
-
memoryItems?: GtmCampaignHistoryMemoryInput[];
|
|
2209
|
-
startedAt?: string;
|
|
2210
|
-
completedAt?: string;
|
|
2211
|
-
summary?: string;
|
|
2212
|
-
memorySummaryText?: string;
|
|
2213
|
-
}
|
|
2214
|
-
interface GtmCampaignHistoryImportInput {
|
|
2215
|
-
source?: GtmCampaignSource;
|
|
2216
|
-
dryRun?: boolean;
|
|
2217
|
-
createMemory?: boolean;
|
|
2218
|
-
campaigns: GtmCampaignHistoryCampaignInput[];
|
|
2219
|
-
}
|
|
2220
|
-
interface GtmCampaignHistoryImportBatchInput {
|
|
2221
|
-
batchId?: string;
|
|
2222
|
-
campaigns: GtmCampaignHistoryCampaignInput[];
|
|
2223
|
-
}
|
|
2224
|
-
interface GtmCampaignHistoryImportRunInput {
|
|
2225
|
-
source?: GtmCampaignSource;
|
|
2226
|
-
dryRun?: boolean;
|
|
2227
|
-
createMemory?: boolean;
|
|
2228
|
-
campaigns?: GtmCampaignHistoryCampaignInput[];
|
|
2229
|
-
batches?: GtmCampaignHistoryImportBatchInput[];
|
|
2230
|
-
batchSize?: number;
|
|
2231
|
-
continueOnError?: boolean;
|
|
2232
|
-
runBrainCycle?: boolean;
|
|
2233
|
-
brainCycleWriteMode?: 'dry_run' | 'write';
|
|
2234
|
-
brainCyclePhases?: GtmBrainLearningCyclePhase[];
|
|
2235
|
-
brainCycleDays?: number;
|
|
2236
|
-
brainCycleNetworkDays?: number;
|
|
2237
|
-
brainCycleMinSampleSize?: number;
|
|
2238
|
-
brainCycleLimit?: number;
|
|
2239
|
-
}
|
|
2240
|
-
interface GtmCampaignBuildBackfillPreviewOptions {
|
|
2241
|
-
campaignBuildId: string;
|
|
2242
|
-
includeSampleRows?: boolean;
|
|
2243
|
-
includeCopySamples?: boolean;
|
|
2244
|
-
sampleRowLimit?: number;
|
|
2245
|
-
createMemory?: boolean;
|
|
2246
|
-
includePayload?: boolean;
|
|
2247
|
-
}
|
|
2248
|
-
interface GtmCampaignBuildBackfillRunInput {
|
|
2249
|
-
campaignBuildIds: string[];
|
|
2250
|
-
source?: GtmCampaignSource;
|
|
2251
|
-
dryRun?: boolean;
|
|
2252
|
-
createMemory?: boolean;
|
|
2253
|
-
includeSampleRows?: boolean;
|
|
2254
|
-
includeCopySamples?: boolean;
|
|
2255
|
-
includePayload?: boolean;
|
|
2256
|
-
sampleRowLimit?: number;
|
|
2257
|
-
batchSize?: number;
|
|
2258
|
-
continueOnError?: boolean;
|
|
2259
|
-
runBrainCycle?: boolean;
|
|
2260
|
-
brainCycleWriteMode?: 'dry_run' | 'write';
|
|
2261
|
-
brainCyclePhases?: GtmBrainLearningCyclePhase[];
|
|
2262
|
-
brainCycleDays?: number;
|
|
2263
|
-
brainCycleNetworkDays?: number;
|
|
2264
|
-
brainCycleMinSampleSize?: number;
|
|
2265
|
-
brainCycleLimit?: number;
|
|
2266
|
-
}
|
|
2267
|
-
interface GtmCampaignBuildBackfillStatusOptions {
|
|
2268
|
-
campaignBuildId: string;
|
|
2269
|
-
includePhases?: boolean;
|
|
2270
|
-
includeLinkedCampaign?: boolean;
|
|
2271
|
-
}
|
|
2272
|
-
interface GtmCampaignListOptions {
|
|
2273
|
-
status?: GtmCampaignStatus;
|
|
2274
|
-
provider?: string;
|
|
2275
|
-
search?: string;
|
|
2276
|
-
limit?: number;
|
|
2277
|
-
includeArchived?: boolean;
|
|
2278
|
-
}
|
|
2279
|
-
interface GtmCampaignGetOptions {
|
|
2280
|
-
logLimit?: number;
|
|
2281
|
-
memoryLimit?: number;
|
|
2282
|
-
}
|
|
2283
|
-
interface GtmCampaignExecutionStatusOptions {
|
|
2284
|
-
campaignId?: string;
|
|
2285
|
-
campaignBuildId?: string;
|
|
2286
|
-
includeProviderReadiness?: boolean;
|
|
2287
|
-
includeFeedback?: boolean;
|
|
2288
|
-
includeMemory?: boolean;
|
|
2289
|
-
includeRecentLog?: boolean;
|
|
2290
|
-
logLimit?: number;
|
|
2291
|
-
memoryLimit?: number;
|
|
2292
|
-
}
|
|
2293
|
-
interface GtmCampaignLearningStatusOptions {
|
|
2294
|
-
campaignId?: string;
|
|
2295
|
-
campaignBuildId?: string;
|
|
2296
|
-
days?: number;
|
|
2297
|
-
networkDays?: number;
|
|
2298
|
-
minSampleSize?: number;
|
|
2299
|
-
holdoutMinSampleSize?: number;
|
|
2300
|
-
predictiveMinLabeledOutcomes?: number;
|
|
2301
|
-
predictiveMinPositiveOutcomes?: number;
|
|
2302
|
-
predictiveMinMemorySampleSize?: number;
|
|
2303
|
-
minWorkspaceCount?: number;
|
|
2304
|
-
minPrivacyK?: number;
|
|
2305
|
-
includeMemory?: boolean;
|
|
2306
|
-
includeNetwork?: boolean;
|
|
2307
|
-
writeMode?: 'dry_run' | 'write';
|
|
2308
|
-
limit?: number;
|
|
2309
|
-
}
|
|
2310
|
-
interface GtmCampaignUpdateInput {
|
|
2311
|
-
campaignId: string;
|
|
2312
|
-
name?: string;
|
|
2313
|
-
description?: string;
|
|
2314
|
-
status?: GtmCampaignStatus;
|
|
2315
|
-
targetIcp?: UnknownRecord;
|
|
2316
|
-
sequences?: UnknownRecord[];
|
|
2317
|
-
leadListRefs?: UnknownRecord[];
|
|
2318
|
-
sendConfig?: UnknownRecord;
|
|
2319
|
-
performanceMetrics?: UnknownRecord;
|
|
2320
|
-
brainConfig?: UnknownRecord;
|
|
2321
|
-
memorySummary?: UnknownRecord;
|
|
2322
|
-
metadata?: UnknownRecord;
|
|
2323
|
-
providerLinks?: GtmProviderLinkInput[];
|
|
2324
|
-
log?: GtmCampaignLogInput;
|
|
2325
|
-
}
|
|
2326
|
-
interface GtmCampaignLogInput {
|
|
2327
|
-
campaignId?: string;
|
|
2328
|
-
actorType?: GtmActorType;
|
|
2329
|
-
actorId?: string;
|
|
2330
|
-
action?: string;
|
|
2331
|
-
rationale?: string;
|
|
2332
|
-
payload?: UnknownRecord;
|
|
2333
|
-
idempotencyKey?: string;
|
|
2334
|
-
}
|
|
2335
|
-
interface GtmFeedbackIngestInput {
|
|
2336
|
-
source: string;
|
|
2337
|
-
campaignId?: string;
|
|
2338
|
-
campaignBuildId?: string;
|
|
2339
|
-
providerCampaignId?: string;
|
|
2340
|
-
events?: UnknownRecord[];
|
|
2341
|
-
providerPayload?: UnknownRecord;
|
|
2342
|
-
createMemory?: boolean;
|
|
2343
|
-
writeRoutineOutcomes?: boolean;
|
|
2344
|
-
}
|
|
2345
|
-
interface GtmCampaignAuditRunInput {
|
|
2346
|
-
provider: 'instantly' | 'heyreach' | 'smartlead' | 'custom';
|
|
2347
|
-
providerCampaignId?: string;
|
|
2348
|
-
campaignId?: string;
|
|
2349
|
-
campaignName?: string;
|
|
2350
|
-
lookbackDays?: number;
|
|
2351
|
-
limitFindings?: number;
|
|
2352
|
-
}
|
|
2353
|
-
interface GtmCampaignAuditGetOptions {
|
|
2354
|
-
auditId?: string;
|
|
2355
|
-
campaignId?: string;
|
|
2356
|
-
limitFindings?: number;
|
|
2357
|
-
}
|
|
2358
|
-
interface GtmInstantlyFeedbackSyncInput {
|
|
2359
|
-
campaignId?: string;
|
|
2360
|
-
campaignBuildId?: string;
|
|
2361
|
-
providerCampaignId?: string;
|
|
2362
|
-
instantlyCampaignId?: string;
|
|
2363
|
-
syncMode?: 'webhook' | 'pull' | 'manual';
|
|
2364
|
-
events?: UnknownRecord[];
|
|
2365
|
-
providerPayload?: UnknownRecord;
|
|
2366
|
-
cursor?: string;
|
|
2367
|
-
since?: string;
|
|
2368
|
-
until?: string;
|
|
2369
|
-
aggregateSnapshot?: UnknownRecord;
|
|
2370
|
-
createMemory?: boolean;
|
|
2371
|
-
writeRoutineOutcomes?: boolean;
|
|
2372
|
-
}
|
|
2373
|
-
interface GtmInstantlyFeedbackPullInput {
|
|
2374
|
-
source?: 'webhook_events' | 'emails';
|
|
2375
|
-
instantlyProfile?: string;
|
|
2376
|
-
campaignId?: string;
|
|
2377
|
-
campaignBuildId?: string;
|
|
2378
|
-
providerLinkId?: string;
|
|
2379
|
-
providerCampaignId?: string;
|
|
2380
|
-
instantlyCampaignId?: string;
|
|
2381
|
-
integrationId?: string;
|
|
2382
|
-
cursor?: string;
|
|
2383
|
-
from?: string;
|
|
2384
|
-
to?: string;
|
|
2385
|
-
limit?: number;
|
|
2386
|
-
maxPages?: number;
|
|
2387
|
-
emailType?: 'received' | 'sent' | 'manual';
|
|
2388
|
-
mode?: 'emode_focused' | 'emode_others' | 'emode_all';
|
|
2389
|
-
sortOrder?: 'asc' | 'desc';
|
|
2390
|
-
createMemory?: boolean;
|
|
2391
|
-
writeRoutineOutcomes?: boolean;
|
|
2392
|
-
dryRun?: boolean;
|
|
2393
|
-
runBrainCycle?: boolean;
|
|
2394
|
-
brainCycleWriteMode?: 'dry_run' | 'write';
|
|
2395
|
-
brainCyclePhases?: GtmBrainLearningCyclePhase[];
|
|
2396
|
-
brainCycleMinIngested?: number;
|
|
2397
|
-
brainCycleMinIntervalMinutes?: number;
|
|
2398
|
-
}
|
|
2399
|
-
interface GtmInstantlyFeedbackWebhookPrepareInput {
|
|
2400
|
-
campaignId?: string;
|
|
2401
|
-
campaignBuildId?: string;
|
|
2402
|
-
providerLinkId?: string;
|
|
2403
|
-
providerCampaignId?: string;
|
|
2404
|
-
instantlyCampaignId?: string;
|
|
2405
|
-
integrationId?: string;
|
|
2406
|
-
providerWorkspaceId?: string;
|
|
2407
|
-
providerAccountId?: string;
|
|
2408
|
-
rotateSecret?: boolean;
|
|
2409
|
-
runBrainCycle?: boolean;
|
|
2410
|
-
brainCycleWriteMode?: 'dry_run' | 'write';
|
|
2411
|
-
brainCyclePhases?: GtmBrainLearningCyclePhase[];
|
|
2412
|
-
brainCycleMinIngested?: number;
|
|
2413
|
-
brainCycleMinIntervalMinutes?: number;
|
|
2414
|
-
}
|
|
2415
|
-
interface GtmKernelImportPreviewInput {
|
|
2416
|
-
sourceIds?: string[];
|
|
2417
|
-
includeLeads?: boolean;
|
|
2418
|
-
includeReplies?: boolean;
|
|
2419
|
-
includePrivateCopy?: boolean;
|
|
2420
|
-
maxPages?: number;
|
|
2421
|
-
limit?: number;
|
|
2422
|
-
}
|
|
2423
|
-
interface GtmKernelImportRunInput extends GtmKernelImportPreviewInput {
|
|
2424
|
-
dryRun?: boolean;
|
|
2425
|
-
writeApproved?: boolean;
|
|
2426
|
-
privateCopyApproved?: boolean;
|
|
2427
|
-
promoteGlobalPatterns?: boolean;
|
|
2428
|
-
minGlobalPrivacyK?: number;
|
|
2429
|
-
}
|
|
2430
|
-
interface GtmBrainDistillRunInput {
|
|
2431
|
-
sourceIds?: string[];
|
|
2432
|
-
writeMode?: 'dry_run' | 'write';
|
|
2433
|
-
writeApproved?: boolean;
|
|
2434
|
-
brainCyclePhases?: GtmBrainLearningCyclePhase[];
|
|
2435
|
-
days?: number;
|
|
2436
|
-
networkDays?: number;
|
|
2437
|
-
minSampleSize?: number;
|
|
2438
|
-
minWorkspaceCount?: number;
|
|
2439
|
-
minPrivacyK?: number;
|
|
2440
|
-
}
|
|
2441
|
-
interface GtmHistoricalCampaignBuildBridgeRunInput {
|
|
2442
|
-
dryRun?: boolean;
|
|
2443
|
-
writeApproved?: boolean;
|
|
2444
|
-
maxEvents?: number;
|
|
2445
|
-
maxCampaigns?: number;
|
|
2446
|
-
minFeedbackEvents?: number;
|
|
2447
|
-
}
|
|
2448
|
-
interface GtmFeedbackWebhookPrepareInput {
|
|
2449
|
-
provider: string;
|
|
2450
|
-
campaignId?: string;
|
|
2451
|
-
campaignBuildId?: string;
|
|
2452
|
-
providerLinkId?: string;
|
|
2453
|
-
providerCampaignId?: string;
|
|
2454
|
-
integrationId?: string;
|
|
2455
|
-
providerWorkspaceId?: string;
|
|
2456
|
-
providerAccountId?: string;
|
|
2457
|
-
rotateSecret?: boolean;
|
|
2458
|
-
runBrainCycle?: boolean;
|
|
2459
|
-
brainCycleWriteMode?: 'dry_run' | 'write';
|
|
2460
|
-
brainCyclePhases?: GtmBrainLearningCyclePhase[];
|
|
2461
|
-
brainCycleMinIngested?: number;
|
|
2462
|
-
brainCycleMinIntervalMinutes?: number;
|
|
2463
|
-
}
|
|
2464
|
-
interface GtmMemorySearchOptions {
|
|
2465
|
-
query?: string;
|
|
2466
|
-
campaignId?: string;
|
|
2467
|
-
memoryType?: GtmMemoryType;
|
|
2468
|
-
keywords?: string[];
|
|
2469
|
-
outcomeType?: string;
|
|
2470
|
-
targetIcp?: UnknownRecord;
|
|
2471
|
-
layers?: GtmLayer[];
|
|
2472
|
-
providerChain?: string[];
|
|
2473
|
-
dimensionFilters?: UnknownRecord;
|
|
2474
|
-
requireDimensionMatch?: boolean;
|
|
2475
|
-
days?: number;
|
|
2476
|
-
limit?: number;
|
|
2477
|
-
}
|
|
2478
|
-
interface GtmBrainPatternsOptions {
|
|
2479
|
-
campaignId?: string;
|
|
2480
|
-
patternType?: GtmPatternType;
|
|
2481
|
-
segmentKey?: string;
|
|
2482
|
-
includeGlobal?: boolean;
|
|
2483
|
-
minConfidence?: number;
|
|
2484
|
-
limit?: number;
|
|
2485
|
-
}
|
|
2486
|
-
interface GtmBrainSeedDefaultsInput {
|
|
2487
|
-
campaignId?: string;
|
|
2488
|
-
campaignBrief?: string;
|
|
2489
|
-
targetIcp?: UnknownRecord;
|
|
2490
|
-
layers?: GtmLayer[];
|
|
2491
|
-
includeGlobal?: boolean;
|
|
2492
|
-
includeMemory?: boolean;
|
|
2493
|
-
minConfidence?: number;
|
|
2494
|
-
writeCampaign?: boolean;
|
|
2495
|
-
limit?: number;
|
|
2496
|
-
}
|
|
2497
|
-
interface GtmBrainLearningCyclePlanInput {
|
|
2498
|
-
campaignId?: string;
|
|
2499
|
-
campaignBrief?: string;
|
|
2500
|
-
targetIcp?: UnknownRecord;
|
|
2501
|
-
layers?: GtmLayer[];
|
|
2502
|
-
providerChain?: string[];
|
|
2503
|
-
leadSource?: string;
|
|
2504
|
-
days?: number;
|
|
2505
|
-
networkDays?: number;
|
|
2506
|
-
minSampleSize?: number;
|
|
2507
|
-
holdoutMinSampleSize?: number;
|
|
2508
|
-
minWorkspaceCount?: number;
|
|
2509
|
-
minPrivacyK?: number;
|
|
2510
|
-
includeMemory?: boolean;
|
|
2511
|
-
includeNetwork?: boolean;
|
|
2512
|
-
writeMode?: 'dry_run' | 'write';
|
|
2513
|
-
limit?: number;
|
|
2514
|
-
}
|
|
2515
|
-
type GtmBrainLearningCyclePhase = 'workspace_pattern_extraction' | 'deliverability_calibration' | 'failure_pattern_detection' | 'aggregate_patterns' | 'aggregate_calibrations' | 'defaults_seed' | 'delivery_risk';
|
|
2516
|
-
type GtmBrainLearningLaneId = 'workspace_patterns' | 'network_patterns' | 'defaults_learning' | 'failure_detection' | 'deliverability_calibration' | 'holdout_lift_proof';
|
|
2517
|
-
type GtmBrainLearningLaneState = 'ready' | 'attention' | 'blocked' | 'unknown';
|
|
2518
|
-
interface GtmBrainLearningLane {
|
|
2519
|
-
id: GtmBrainLearningLaneId;
|
|
2520
|
-
label: string;
|
|
2521
|
-
state: GtmBrainLearningLaneState;
|
|
2522
|
-
metric: string;
|
|
2523
|
-
detail: string;
|
|
2524
|
-
blockers: string[];
|
|
2525
|
-
warnings: string[];
|
|
2526
|
-
next_mcp_action: string;
|
|
2527
|
-
raw_data_policy?: string;
|
|
2528
|
-
}
|
|
2529
|
-
interface GtmBrainLearningLaneSummary {
|
|
2530
|
-
total_lanes: number;
|
|
2531
|
-
ready_lanes: number;
|
|
2532
|
-
blocked_lanes: number;
|
|
2533
|
-
attention_lanes: number;
|
|
2534
|
-
unknown_lanes: number;
|
|
2535
|
-
}
|
|
2536
|
-
interface GtmBrainLearningEvidenceCounts {
|
|
2537
|
-
feedback_events?: number;
|
|
2538
|
-
deliverability_events?: number;
|
|
2539
|
-
failure_events?: number;
|
|
2540
|
-
positive_events?: number;
|
|
2541
|
-
holdout_control_sample_size?: number;
|
|
2542
|
-
holdout_learned_sample_size?: number;
|
|
2543
|
-
event_type_counts?: UnknownRecord;
|
|
2544
|
-
classification_counts?: UnknownRecord;
|
|
2545
|
-
memory_items?: number;
|
|
2546
|
-
memory_sample_size?: number;
|
|
2547
|
-
workspace_patterns?: number;
|
|
2548
|
-
workspace_calibrations?: number;
|
|
2549
|
-
global_patterns?: number;
|
|
2550
|
-
global_calibrations?: number;
|
|
2551
|
-
opted_in_workspaces?: number;
|
|
2552
|
-
}
|
|
2553
|
-
interface GtmBrainLearningPhaseStatus {
|
|
2554
|
-
phase: GtmBrainLearningCyclePhase | string;
|
|
2555
|
-
ready: boolean;
|
|
2556
|
-
blocked_by?: string[];
|
|
2557
|
-
}
|
|
2558
|
-
interface GtmBrainLearningPhaseReadiness {
|
|
2559
|
-
ready: boolean;
|
|
2560
|
-
blocked_by: string[];
|
|
2561
|
-
}
|
|
2562
|
-
interface GtmBrainLearningAction {
|
|
2563
|
-
tool: string;
|
|
2564
|
-
arguments?: UnknownRecord;
|
|
2565
|
-
reason?: string;
|
|
2566
|
-
}
|
|
2567
|
-
interface GtmHoldoutLiftProof {
|
|
2568
|
-
status?: string;
|
|
2569
|
-
honest_measurement?: boolean;
|
|
2570
|
-
positive_lift?: boolean;
|
|
2571
|
-
primary_metric?: string;
|
|
2572
|
-
min_cohort_sample_size?: number;
|
|
2573
|
-
volume?: {
|
|
2574
|
-
control_sample_size?: number;
|
|
2575
|
-
learned_sample_size?: number;
|
|
2576
|
-
total_sample_size?: number;
|
|
2577
|
-
};
|
|
2578
|
-
cohorts?: {
|
|
2579
|
-
control?: UnknownRecord | null;
|
|
2580
|
-
learned?: UnknownRecord | null;
|
|
2581
|
-
};
|
|
2582
|
-
lift?: UnknownRecord;
|
|
2583
|
-
blockers?: string[];
|
|
2584
|
-
warnings?: string[];
|
|
2585
|
-
measurement_policy?: string;
|
|
2586
|
-
next_action?: string;
|
|
2587
|
-
}
|
|
2588
|
-
type GtmPredictiveModelingStatus = 'blocked' | 'advisory_only' | 'canary_ready' | 'production_ready';
|
|
2589
|
-
type GtmPredictiveModelingMode = 'disabled' | 'operator_advisory' | 'holdout_canary' | 'production_candidate';
|
|
2590
|
-
type GtmPredictiveModelingDomainState = 'blocked' | 'advisory' | 'canary_ready' | 'ready';
|
|
2591
|
-
interface GtmPredictiveModelingDomain {
|
|
2592
|
-
id?: 'lead_scoring' | 'copy_strategy' | 'deliverability_risk' | 'audience_precision' | string;
|
|
2593
|
-
label?: string;
|
|
2594
|
-
state?: GtmPredictiveModelingDomainState;
|
|
2595
|
-
confidence_tier?: 'none' | 'low' | 'medium' | 'high';
|
|
2596
|
-
evidence?: UnknownRecord;
|
|
2597
|
-
blockers?: string[];
|
|
2598
|
-
warnings?: string[];
|
|
2599
|
-
allowed_use?: string;
|
|
2600
|
-
recommended_method?: string;
|
|
2601
|
-
next_action?: string;
|
|
2602
|
-
}
|
|
2603
|
-
interface GtmPredictiveModelingReadiness {
|
|
2604
|
-
status?: GtmPredictiveModelingStatus;
|
|
2605
|
-
prediction_mode?: GtmPredictiveModelingMode;
|
|
2606
|
-
confidence_tier?: 'none' | 'low' | 'medium' | 'high';
|
|
2607
|
-
score?: number;
|
|
2608
|
-
evidence_counts?: UnknownRecord;
|
|
2609
|
-
thresholds?: UnknownRecord;
|
|
2610
|
-
domains?: GtmPredictiveModelingDomain[];
|
|
2611
|
-
blockers?: string[];
|
|
2612
|
-
warnings?: string[];
|
|
2613
|
-
next_action?: string;
|
|
2614
|
-
guardrails?: UnknownRecord;
|
|
2615
|
-
modeling_policy?: string;
|
|
2616
|
-
privacy_policy?: string;
|
|
2617
|
-
}
|
|
2618
|
-
interface GtmBrainLearningRecommendedToolCall extends GtmBrainLearningAction {
|
|
2619
|
-
step?: number;
|
|
2620
|
-
phase?: GtmBrainLearningCyclePhase | string;
|
|
2621
|
-
ready?: boolean;
|
|
2622
|
-
blocked_by?: string[];
|
|
2623
|
-
}
|
|
2624
|
-
interface GtmCampaignLearningStatusResult {
|
|
2625
|
-
workspace_id?: string;
|
|
2626
|
-
learning_stage?: string;
|
|
2627
|
-
ready?: boolean;
|
|
2628
|
-
outcome_learning_ready?: boolean;
|
|
2629
|
-
campaign?: {
|
|
2630
|
-
id?: string;
|
|
2631
|
-
name?: string;
|
|
2632
|
-
status?: string;
|
|
2633
|
-
source?: string;
|
|
2634
|
-
campaign_build_id?: string | null;
|
|
2635
|
-
updated_at?: string;
|
|
2636
|
-
} | null;
|
|
2637
|
-
campaign_build?: {
|
|
2638
|
-
id?: string;
|
|
2639
|
-
name?: string;
|
|
2640
|
-
status?: string;
|
|
2641
|
-
requested_target_count?: number;
|
|
2642
|
-
planned_target_count?: number;
|
|
2643
|
-
completed_at?: string | null;
|
|
2644
|
-
updated_at?: string | null;
|
|
2645
|
-
} | null;
|
|
2646
|
-
evidence_counts?: GtmBrainLearningEvidenceCounts;
|
|
2647
|
-
holdout_lift?: GtmHoldoutLiftProof;
|
|
2648
|
-
predictive_modeling_readiness?: GtmPredictiveModelingReadiness;
|
|
2649
|
-
closed_loop_proof_ready?: boolean;
|
|
2650
|
-
learning_lanes?: GtmBrainLearningLane[];
|
|
2651
|
-
lane_summary?: GtmBrainLearningLaneSummary;
|
|
2652
|
-
feedback_brain_cycle?: UnknownRecord;
|
|
2653
|
-
thresholds?: UnknownRecord;
|
|
2654
|
-
phases?: GtmBrainLearningPhaseStatus[];
|
|
2655
|
-
ready_phases?: Array<GtmBrainLearningCyclePhase | string>;
|
|
2656
|
-
learning_cycle_plan_args?: UnknownRecord;
|
|
2657
|
-
learning_cycle_run_args?: UnknownRecord | null;
|
|
2658
|
-
last_learning_cycle_receipt?: UnknownRecord | null;
|
|
2659
|
-
recent_brain_log?: UnknownRecord[];
|
|
2660
|
-
blockers?: string[];
|
|
2661
|
-
warnings?: string[];
|
|
2662
|
-
next_actions?: GtmBrainLearningAction[];
|
|
2663
|
-
execution_policy?: string;
|
|
2664
|
-
privacy_policy?: string;
|
|
2665
|
-
}
|
|
2666
|
-
interface GtmBrainLearningCyclePlanResult {
|
|
2667
|
-
cycle?: UnknownRecord;
|
|
2668
|
-
evidence_counts?: GtmBrainLearningEvidenceCounts;
|
|
2669
|
-
holdout_lift?: GtmHoldoutLiftProof;
|
|
2670
|
-
closed_loop_proof_ready?: boolean;
|
|
2671
|
-
readiness?: Record<string, GtmBrainLearningPhaseReadiness>;
|
|
2672
|
-
learning_lanes?: GtmBrainLearningLane[];
|
|
2673
|
-
lane_summary?: GtmBrainLearningLaneSummary;
|
|
2674
|
-
recommended_tool_calls?: GtmBrainLearningRecommendedToolCall[];
|
|
2675
|
-
next_ready_tools?: string[];
|
|
2676
|
-
queued_runner_tool?: string;
|
|
2677
|
-
execution_policy?: string;
|
|
2678
|
-
privacy_policy?: string;
|
|
2679
|
-
}
|
|
2680
|
-
interface GtmBrainLearningCycleRunInput extends GtmBrainLearningCyclePlanInput {
|
|
2681
|
-
phases?: GtmBrainLearningCyclePhase[];
|
|
2682
|
-
continueOnError?: boolean;
|
|
2683
|
-
}
|
|
2684
|
-
interface GtmBrainExtractPatternsInput {
|
|
2685
|
-
campaignId?: string;
|
|
2686
|
-
days?: number;
|
|
2687
|
-
patternTypes?: GtmPatternType[];
|
|
2688
|
-
minSampleSize?: number;
|
|
2689
|
-
includeMemory?: boolean;
|
|
2690
|
-
writePatterns?: boolean;
|
|
2691
|
-
dryRun?: boolean;
|
|
2692
|
-
replaceExisting?: boolean;
|
|
2693
|
-
limit?: number;
|
|
2694
|
-
}
|
|
2695
|
-
interface GtmBrainAggregatePatternsInput {
|
|
2696
|
-
days?: number;
|
|
2697
|
-
patternTypes?: GtmPatternType[];
|
|
2698
|
-
minWorkspaceCount?: number;
|
|
2699
|
-
minPrivacyK?: number;
|
|
2700
|
-
minConfidence?: number;
|
|
2701
|
-
includeLowConfidence?: boolean;
|
|
2702
|
-
writePatterns?: boolean;
|
|
2703
|
-
dryRun?: boolean;
|
|
2704
|
-
replaceExisting?: boolean;
|
|
2705
|
-
limit?: number;
|
|
2706
|
-
}
|
|
2707
|
-
interface GtmBrainAggregateCalibrationsInput {
|
|
2708
|
-
days?: number;
|
|
2709
|
-
dimensionTypes?: GtmCalibrationDimensionType[];
|
|
2710
|
-
minWorkspaceCount?: number;
|
|
2711
|
-
minPrivacyK?: number;
|
|
2712
|
-
minConfidence?: number;
|
|
2713
|
-
includeLowConfidence?: boolean;
|
|
2714
|
-
writeCalibrations?: boolean;
|
|
2715
|
-
dryRun?: boolean;
|
|
2716
|
-
replaceExisting?: boolean;
|
|
2717
|
-
limit?: number;
|
|
2718
|
-
}
|
|
2719
|
-
interface GtmBrainCalibrateDeliverabilityInput {
|
|
2720
|
-
campaignId?: string;
|
|
2721
|
-
days?: number;
|
|
2722
|
-
dimensionTypes?: GtmCalibrationDimensionType[];
|
|
2723
|
-
minSampleSize?: number;
|
|
2724
|
-
dryRun?: boolean;
|
|
2725
|
-
writeCalibrations?: boolean;
|
|
2726
|
-
writePatterns?: boolean;
|
|
2727
|
-
replaceExisting?: boolean;
|
|
2728
|
-
limit?: number;
|
|
2729
|
-
}
|
|
2730
|
-
interface GtmBrainDeliveryRiskInput {
|
|
2731
|
-
campaignId?: string;
|
|
2732
|
-
providerChain?: string[];
|
|
2733
|
-
leadSource?: string;
|
|
2734
|
-
targetIcp?: UnknownRecord;
|
|
2735
|
-
leadSamples?: UnknownRecord[];
|
|
2736
|
-
includeGlobal?: boolean;
|
|
2737
|
-
minConfidence?: number;
|
|
2738
|
-
limit?: number;
|
|
2739
|
-
}
|
|
2740
|
-
interface GtmMeetingLikelihoodInput {
|
|
2741
|
-
leadRows: UnknownRecord[];
|
|
2742
|
-
inputSource?: string;
|
|
2743
|
-
campaignId?: string;
|
|
2744
|
-
campaignBuildId?: string;
|
|
2745
|
-
days?: number;
|
|
2746
|
-
feedbackLimit?: number;
|
|
2747
|
-
includeFeatures?: boolean;
|
|
2748
|
-
includeGlobal?: boolean;
|
|
2749
|
-
minFeedbackEvents?: number;
|
|
2750
|
-
minHistoricalFeatureSampleSize?: number;
|
|
2751
|
-
minWorkspaceCount?: number;
|
|
2752
|
-
minPrivacyK?: number;
|
|
2753
|
-
limit?: number;
|
|
2754
|
-
}
|
|
2755
|
-
type GtmCalibrationDimensionType = 'email_domain' | 'email_provider' | 'verification_source' | 'lead_source' | 'provider_chain' | 'icp_shape' | 'copy_pattern' | 'other';
|
|
2756
|
-
type GtmFailurePatternDimension = 'provider_chain' | 'provider' | 'icp_shape' | 'lead_source' | 'copy_pattern' | 'sequence_step' | 'email_domain';
|
|
2757
|
-
interface GtmBrainFailurePatternsOptions {
|
|
2758
|
-
campaignId?: string;
|
|
2759
|
-
days?: number;
|
|
2760
|
-
minSampleSize?: number;
|
|
2761
|
-
dimensions?: GtmFailurePatternDimension[];
|
|
2762
|
-
includeExistingPatterns?: boolean;
|
|
2763
|
-
includeGlobal?: boolean;
|
|
2764
|
-
limit?: number;
|
|
2765
|
-
}
|
|
2766
|
-
interface GtmConnectionsListOptions {
|
|
2767
|
-
kind?: 'all' | 'integrations' | 'mcp_servers' | 'app_connections' | 'nango_connections' | 'integration_recipes' | 'layer_routes';
|
|
2768
|
-
includeDisconnected?: boolean;
|
|
2769
|
-
}
|
|
2770
|
-
interface GtmProviderCatalogOptions {
|
|
2771
|
-
providerId?: string;
|
|
2772
|
-
layer?: GtmLayer;
|
|
2773
|
-
includePlanned?: boolean;
|
|
2774
|
-
includeLayerCatalog?: boolean;
|
|
2775
|
-
}
|
|
2776
|
-
type GtmAgencyAutopilotCapabilityFamily = 'lead_list' | 'clay_table' | 'gtm_motion' | 'proof_governance';
|
|
2777
|
-
type GtmAgencyAutopilotCapabilityPhase = 'brief' | 'cache_inventory' | 'source_gap' | 'proof_gates' | 'qualification' | 'signals' | 'copy' | 'approval_export' | 'cache_writeback' | 'clay_orchestration' | 'motion_library' | 'learning';
|
|
2778
|
-
interface GtmAgencyAutopilotCapabilityCatalogOptions {
|
|
2779
|
-
query?: string;
|
|
2780
|
-
family?: GtmAgencyAutopilotCapabilityFamily;
|
|
2781
|
-
phase?: GtmAgencyAutopilotCapabilityPhase;
|
|
2782
|
-
accountLabel?: string;
|
|
2783
|
-
workspaceLabel?: string;
|
|
2784
|
-
targetCount?: number;
|
|
2785
|
-
limit?: number;
|
|
2786
|
-
includeAgentPrompts?: boolean;
|
|
2787
|
-
}
|
|
2788
|
-
type GtmAgencyAutopilotPlaybookOutcomeType = 'lead_list' | 'clay_table' | 'gtm_motion' | 'proof_governance';
|
|
2789
|
-
type GtmAgencyAutopilotPlaybookSlug = 'cache-first-large-list' | 'net-new-suppressed-list' | 'proof-first-vertical-gate' | 'signal-led-copy-approval' | 'domain-first-recovery' | 'table-workflow-handoff' | 'icp-persona-segmentation' | 'buying-signal-prioritization' | 'multi-channel-sequence-fit' | 'revops-feedback-loop';
|
|
2790
|
-
interface GtmAgencyAutopilotPlaybookCatalogOptions {
|
|
2791
|
-
query?: string;
|
|
2792
|
-
playbookSlug?: GtmAgencyAutopilotPlaybookSlug;
|
|
2793
|
-
outcomeType?: GtmAgencyAutopilotPlaybookOutcomeType;
|
|
2794
|
-
limit?: number;
|
|
2795
|
-
includeRequiredFields?: boolean;
|
|
2796
|
-
}
|
|
2797
|
-
interface GtmCampaignStrategyTemplatesOptions {
|
|
2798
|
-
strategyTemplate?: GtmCampaignStrategyTemplateSlug | (string & {});
|
|
2799
|
-
query?: string;
|
|
2800
|
-
includeDetails?: boolean;
|
|
2801
|
-
}
|
|
2802
|
-
type GtmCampaignStrategyTemplateSlug = 'industrial-ot-resilience' | 'non-medical-home-care' | 'agency-founder-led' | 'cloud-infrastructure-displacement';
|
|
2803
|
-
interface GtmCampaignStartContextInput {
|
|
2804
|
-
campaignId?: string;
|
|
2805
|
-
campaignBuildId?: string;
|
|
2806
|
-
campaignBrief?: string;
|
|
2807
|
-
strategyTemplate?: GtmCampaignStrategyTemplateSlug | (string & {});
|
|
2808
|
-
targetIcp?: UnknownRecord;
|
|
2809
|
-
leadCount?: number;
|
|
2810
|
-
layers?: GtmLayer[];
|
|
2811
|
-
preferredProviders?: string[];
|
|
2812
|
-
memoryDimensionFilters?: UnknownRecord;
|
|
2813
|
-
requireMemoryDimensionMatch?: boolean;
|
|
2814
|
-
includeMemory?: boolean;
|
|
2815
|
-
includeBrain?: boolean;
|
|
2816
|
-
includeProviderRoutes?: boolean;
|
|
2817
|
-
includeFailurePatterns?: boolean;
|
|
2818
|
-
includeDeliveryRisk?: boolean;
|
|
2819
|
-
includeGlobalBrain?: boolean;
|
|
2820
|
-
includePlannedProviders?: boolean;
|
|
2821
|
-
days?: number;
|
|
2822
|
-
minConfidence?: number;
|
|
2823
|
-
minSampleSize?: number;
|
|
2824
|
-
limit?: number;
|
|
2825
|
-
}
|
|
2826
|
-
interface GtmIntegrationsActivationStatusOptions {
|
|
2827
|
-
campaignId?: string;
|
|
2828
|
-
layer?: GtmLayer;
|
|
2829
|
-
includePlanned?: boolean;
|
|
2830
|
-
includeConnections?: boolean;
|
|
2831
|
-
}
|
|
2832
|
-
interface GtmCampaignBuildPlanInput {
|
|
2833
|
-
campaignId?: string;
|
|
2834
|
-
campaignBuildId?: string;
|
|
2835
|
-
campaignBrief?: string;
|
|
2836
|
-
strategyTemplate?: GtmCampaignStrategyTemplateSlug | (string & {});
|
|
2837
|
-
targetIcp?: UnknownRecord;
|
|
2838
|
-
leadCount?: number;
|
|
2839
|
-
layers?: GtmLayer[];
|
|
2840
|
-
preferredProviders?: string[];
|
|
2841
|
-
strategyModel?: 'strategy_template' | 'custom';
|
|
2842
|
-
includeStrategyPatterns?: boolean;
|
|
2843
|
-
includeWorkflowPatterns?: boolean;
|
|
2844
|
-
/** @deprecated Use includeWorkflowPatterns. */
|
|
2845
|
-
includeClayPatterns?: boolean;
|
|
2846
|
-
includeNangoCatalog?: boolean;
|
|
2847
|
-
partnerEcosystem?: string[];
|
|
2848
|
-
memoryDimensionFilters?: UnknownRecord;
|
|
2849
|
-
requireMemoryDimensionMatch?: boolean;
|
|
2850
|
-
includeMemory?: boolean;
|
|
2851
|
-
includeBrain?: boolean;
|
|
2852
|
-
includeProviderRoutes?: boolean;
|
|
2853
|
-
includeFailurePatterns?: boolean;
|
|
2854
|
-
includePlannedProviders?: boolean;
|
|
2855
|
-
days?: number;
|
|
2856
|
-
limit?: number;
|
|
2857
|
-
}
|
|
2858
|
-
interface GtmCampaignAgentPlanInput {
|
|
2859
|
-
goal?: string;
|
|
2860
|
-
campaignBrief?: string;
|
|
2861
|
-
campaignName?: string;
|
|
2862
|
-
campaignId?: string;
|
|
2863
|
-
campaignBuildId?: string;
|
|
2864
|
-
strategyTemplate?: GtmCampaignStrategyTemplateSlug | (string & {});
|
|
2865
|
-
operatingPlaybooks?: string[];
|
|
2866
|
-
accountContext?: string;
|
|
2867
|
-
targetIcp?: UnknownRecord;
|
|
2868
|
-
targetCount?: number;
|
|
2869
|
-
leadCount?: number;
|
|
2870
|
-
builtIns?: Array<'lead_generation' | 'local_leads' | 'email_finding' | 'email_verification' | 'signals' | (string & {})>;
|
|
2871
|
-
useLocalLeads?: boolean;
|
|
2872
|
-
layers?: GtmLayer[];
|
|
2873
|
-
preferredProviders?: string[];
|
|
2874
|
-
customTools?: UnknownRecord[];
|
|
2875
|
-
integrations?: UnknownRecord[];
|
|
2876
|
-
strategyModel?: 'strategy_template' | 'custom';
|
|
2877
|
-
includeStrategyPatterns?: boolean;
|
|
2878
|
-
includeWorkflowPatterns?: boolean;
|
|
2879
|
-
includeNangoCatalog?: boolean;
|
|
2880
|
-
partnerEcosystem?: string[];
|
|
2881
|
-
memoryDimensionFilters?: UnknownRecord;
|
|
2882
|
-
requireMemoryDimensionMatch?: boolean;
|
|
2883
|
-
includeMemory?: boolean;
|
|
2884
|
-
includeBrain?: boolean;
|
|
2885
|
-
includeProviderRoutes?: boolean;
|
|
2886
|
-
includeFailurePatterns?: boolean;
|
|
2887
|
-
includeDeliveryRisk?: boolean;
|
|
2888
|
-
includePlannedProviders?: boolean;
|
|
2889
|
-
days?: number;
|
|
2890
|
-
limit?: number;
|
|
2891
|
-
}
|
|
2892
|
-
interface GtmCampaignAgentRequestTemplateInput {
|
|
2893
|
-
goal?: string;
|
|
2894
|
-
campaignBrief?: string;
|
|
2895
|
-
campaignName?: string;
|
|
2896
|
-
accountLabel?: string;
|
|
2897
|
-
accountContext?: string;
|
|
2898
|
-
strategyTemplate?: GtmCampaignStrategyTemplateSlug | (string & {});
|
|
2899
|
-
operatingPlaybooks?: string[];
|
|
2900
|
-
targetIcp?: UnknownRecord;
|
|
2901
|
-
targetCount?: number;
|
|
2902
|
-
builtIns?: Array<'lead_generation' | 'local_leads' | 'email_finding' | 'email_verification' | 'signals' | (string & {})>;
|
|
2903
|
-
includeLocalLeads?: boolean;
|
|
2904
|
-
includeByoPlaceholder?: boolean;
|
|
2905
|
-
includeNangoCatalog?: boolean;
|
|
2906
|
-
preferredProviders?: string[];
|
|
2907
|
-
privacyMode?: 'workspace_only' | 'anonymized_patterns' | 'opt_in_network' | (string & {});
|
|
2908
|
-
destinationType?: 'json' | 'csv' | 'webhook' | (string & {});
|
|
2909
|
-
}
|
|
2910
|
-
interface GtmCampaignStrategyMemoryStatusInput {
|
|
2911
|
-
strategyTemplate?: GtmCampaignStrategyTemplateSlug | (string & {});
|
|
2912
|
-
query?: string;
|
|
2913
|
-
campaignBrief?: string;
|
|
2914
|
-
targetIcp?: UnknownRecord;
|
|
2915
|
-
memoryDimensionFilters?: UnknownRecord;
|
|
2916
|
-
requireMemoryDimensionMatch?: boolean;
|
|
2917
|
-
includeSamples?: boolean;
|
|
2918
|
-
includeSources?: boolean;
|
|
2919
|
-
days?: number;
|
|
2920
|
-
limit?: number;
|
|
2921
|
-
}
|
|
2922
|
-
interface GtmCampaignBuildPlanCommitInput {
|
|
2923
|
-
campaignId?: string;
|
|
2924
|
-
campaignBuildId?: string;
|
|
2925
|
-
name?: string;
|
|
2926
|
-
campaignBrief?: string;
|
|
2927
|
-
targetIcp?: UnknownRecord;
|
|
2928
|
-
leadCount?: number;
|
|
2929
|
-
layers?: GtmLayer[];
|
|
2930
|
-
preferredProviders?: string[];
|
|
2931
|
-
planSnapshot?: UnknownRecord;
|
|
2932
|
-
sequences?: UnknownRecord[];
|
|
2933
|
-
leadListRefs?: UnknownRecord[];
|
|
2934
|
-
sendConfig?: UnknownRecord;
|
|
2935
|
-
brainConfig?: UnknownRecord;
|
|
2936
|
-
metadata?: UnknownRecord;
|
|
2937
|
-
status?: Extract<GtmCampaignStatus, 'draft' | 'building' | 'ready'>;
|
|
2938
|
-
approvalRequired?: boolean;
|
|
2939
|
-
actorType?: GtmActorType;
|
|
2940
|
-
actorId?: string;
|
|
2941
|
-
rationale?: string;
|
|
2942
|
-
idempotencyKey?: string;
|
|
2943
|
-
dryRun?: boolean;
|
|
2944
|
-
confirm?: boolean;
|
|
2945
|
-
}
|
|
2946
|
-
interface GtmCampaignBuildExecutionPrepareInput {
|
|
2947
|
-
campaignId: string;
|
|
2948
|
-
targetCount?: number;
|
|
2949
|
-
allowDownscale?: boolean;
|
|
2950
|
-
dryRun?: boolean;
|
|
2951
|
-
confirmSpend?: boolean;
|
|
2952
|
-
includeBrainContext?: boolean;
|
|
2953
|
-
requireDeliveryRiskClearance?: boolean;
|
|
2954
|
-
/** Output from gtm_brain_delivery_risk. When omitted, the MCP tool returns exact risk-check next-action args unless a stored campaign snapshot is available. */
|
|
2955
|
-
deliveryRisk?: UnknownRecord;
|
|
2956
|
-
dedupKeys?: ('email' | 'linkedin_url' | 'company_domain')[];
|
|
2957
|
-
policy?: UnknownRecord;
|
|
2958
|
-
signals?: UnknownRecord;
|
|
2959
|
-
qualification?: UnknownRecord;
|
|
2960
|
-
copy?: UnknownRecord;
|
|
2961
|
-
delivery?: UnknownRecord;
|
|
2962
|
-
enhancers?: UnknownRecord;
|
|
2963
|
-
}
|
|
2964
|
-
interface GtmProviderRecipePrepareInput {
|
|
2965
|
-
providerId: string;
|
|
2966
|
-
providerName?: string;
|
|
2967
|
-
description?: string;
|
|
2968
|
-
layerCapabilities?: GtmLayer[];
|
|
2969
|
-
invocationType?: GtmInvocationType;
|
|
2970
|
-
authStrategy?: GtmAuthStrategy;
|
|
2971
|
-
endpointUrl?: string;
|
|
2972
|
-
httpMethod?: string;
|
|
2973
|
-
secretRef?: string;
|
|
2974
|
-
workspaceIntegrationId?: string;
|
|
2975
|
-
workspaceMcpServerId?: string;
|
|
2976
|
-
workspaceConnectionId?: string;
|
|
2977
|
-
requestTemplate?: UnknownRecord;
|
|
2978
|
-
responseMapping?: UnknownRecord;
|
|
2979
|
-
inputSchema?: UnknownRecord;
|
|
2980
|
-
outputSchema?: UnknownRecord;
|
|
2981
|
-
readiness?: UnknownRecord;
|
|
2982
|
-
metadata?: UnknownRecord;
|
|
2983
|
-
layer?: GtmLayer;
|
|
2984
|
-
campaignId?: string;
|
|
2985
|
-
useSignalizFallback?: boolean;
|
|
2986
|
-
priority?: number;
|
|
2987
|
-
status?: 'draft' | 'active' | 'needs_setup';
|
|
2988
|
-
sampleRecords?: UnknownRecord[];
|
|
2989
|
-
context?: UnknownRecord;
|
|
2990
|
-
}
|
|
2991
|
-
interface GtmClayWebhookPrepareInput {
|
|
2992
|
-
endpointUrl?: string;
|
|
2993
|
-
secretRef?: string;
|
|
2994
|
-
layer?: Extract<GtmLayer, 'find_company' | 'find_people' | 'lead_generation' | 'company_enrichment' | 'copy_enrichment' | 'approval' | 'destination_export' | 'custom'>;
|
|
2995
|
-
campaignId?: string;
|
|
2996
|
-
useSignalizFallback?: boolean;
|
|
2997
|
-
priority?: number;
|
|
2998
|
-
status?: 'draft' | 'active' | 'needs_setup';
|
|
2999
|
-
sampleRecords?: UnknownRecord[];
|
|
3000
|
-
context?: UnknownRecord;
|
|
3001
|
-
}
|
|
3002
|
-
interface GtmProviderRouteActivateInput {
|
|
3003
|
-
providerId: string;
|
|
3004
|
-
providerName?: string;
|
|
3005
|
-
description?: string;
|
|
3006
|
-
layer?: GtmLayer;
|
|
3007
|
-
layers?: GtmLayer[];
|
|
3008
|
-
campaignId?: string;
|
|
3009
|
-
invocationType?: GtmInvocationType;
|
|
3010
|
-
authStrategy?: GtmAuthStrategy;
|
|
3011
|
-
endpointUrl?: string;
|
|
3012
|
-
httpMethod?: string;
|
|
3013
|
-
secretRef?: string;
|
|
3014
|
-
workspaceIntegrationId?: string;
|
|
3015
|
-
workspaceMcpServerId?: string;
|
|
3016
|
-
workspaceConnectionId?: string;
|
|
3017
|
-
useSignalizFallback?: boolean;
|
|
3018
|
-
priority?: number;
|
|
3019
|
-
routeConfig?: UnknownRecord;
|
|
3020
|
-
requestTemplate?: UnknownRecord;
|
|
3021
|
-
responseMapping?: UnknownRecord;
|
|
3022
|
-
inputSchema?: UnknownRecord;
|
|
3023
|
-
outputSchema?: UnknownRecord;
|
|
3024
|
-
readiness?: UnknownRecord;
|
|
3025
|
-
metadata?: UnknownRecord;
|
|
3026
|
-
status?: 'draft' | 'active' | 'needs_setup' | 'paused' | 'archived' | 'failed';
|
|
3027
|
-
routeStatus?: 'active' | 'paused' | 'archived' | 'failed';
|
|
3028
|
-
replaceExistingRoutes?: boolean;
|
|
3029
|
-
dryRun?: boolean;
|
|
3030
|
-
confirm?: boolean;
|
|
3031
|
-
sampleRecords?: UnknownRecord[];
|
|
3032
|
-
context?: UnknownRecord;
|
|
3033
|
-
}
|
|
3034
|
-
interface GtmConnectionRegisterInput {
|
|
3035
|
-
connectionKind: 'mcp_server' | 'integration';
|
|
3036
|
-
name: string;
|
|
3037
|
-
serverUrl?: string;
|
|
3038
|
-
authType?: 'none' | 'api_key' | 'bearer' | 'oauth';
|
|
3039
|
-
authConfig?: UnknownRecord;
|
|
3040
|
-
enabledTools?: string[];
|
|
3041
|
-
presetId?: string;
|
|
3042
|
-
vendorId?: string;
|
|
3043
|
-
serviceCategory?: string;
|
|
3044
|
-
connectionType?: string;
|
|
3045
|
-
integrationId?: string;
|
|
3046
|
-
providerConfigKey?: string;
|
|
3047
|
-
allowedIntegrations?: string[];
|
|
3048
|
-
surface?: 'settings_connections' | 'ops_destinations' | 'gtm_kernel';
|
|
3049
|
-
source?: string;
|
|
3050
|
-
userEmail?: string;
|
|
3051
|
-
userDisplayName?: string;
|
|
3052
|
-
status?: string;
|
|
3053
|
-
metadata?: UnknownRecord;
|
|
3054
|
-
}
|
|
3055
|
-
interface GtmIntegrationRecipeCreateInput {
|
|
3056
|
-
providerId: string;
|
|
3057
|
-
providerName: string;
|
|
3058
|
-
description?: string;
|
|
3059
|
-
layerCapabilities?: GtmLayer[];
|
|
3060
|
-
invocationType: GtmInvocationType;
|
|
3061
|
-
authStrategy?: GtmAuthStrategy;
|
|
3062
|
-
workspaceIntegrationId?: string;
|
|
3063
|
-
workspaceMcpServerId?: string;
|
|
3064
|
-
workspaceConnectionId?: string;
|
|
3065
|
-
endpointUrl?: string;
|
|
3066
|
-
httpMethod?: string;
|
|
3067
|
-
requestTemplate?: UnknownRecord;
|
|
3068
|
-
responseMapping?: UnknownRecord;
|
|
3069
|
-
inputSchema?: UnknownRecord;
|
|
3070
|
-
outputSchema?: UnknownRecord;
|
|
3071
|
-
readiness?: UnknownRecord;
|
|
3072
|
-
metadata?: UnknownRecord;
|
|
3073
|
-
status?: 'draft' | 'active' | 'needs_setup' | 'paused' | 'archived' | 'failed';
|
|
3074
|
-
}
|
|
3075
|
-
interface GtmLayerRouteSetInput {
|
|
3076
|
-
layer: GtmLayer;
|
|
3077
|
-
providerId: string;
|
|
3078
|
-
campaignId?: string;
|
|
3079
|
-
recipeId?: string;
|
|
3080
|
-
priority?: number;
|
|
3081
|
-
useSignalizFallback?: boolean;
|
|
3082
|
-
routeConfig?: UnknownRecord;
|
|
3083
|
-
status?: 'active' | 'paused' | 'archived' | 'failed';
|
|
3084
|
-
}
|
|
3085
|
-
interface GtmLayerRoutesGetOptions {
|
|
3086
|
-
campaignId?: string;
|
|
3087
|
-
layer?: GtmLayer;
|
|
3088
|
-
}
|
|
3089
|
-
interface GtmLayerRoutePreviewInput {
|
|
3090
|
-
layer: GtmLayer;
|
|
3091
|
-
campaignId?: string;
|
|
3092
|
-
sampleRecords?: UnknownRecord[];
|
|
3093
|
-
context?: UnknownRecord;
|
|
3094
|
-
}
|
|
3095
|
-
interface GtmNangoBaseOptions {
|
|
3096
|
-
workspaceConnectionId?: string;
|
|
3097
|
-
connectionId?: string;
|
|
3098
|
-
providerConfigKey?: string;
|
|
3099
|
-
integrationId?: string;
|
|
3100
|
-
nangoConnectionId?: string;
|
|
3101
|
-
}
|
|
3102
|
-
interface GtmNangoConnectSessionCreateInput {
|
|
3103
|
-
providerId?: string;
|
|
3104
|
-
integrationId?: string;
|
|
3105
|
-
providerDisplayName?: string;
|
|
3106
|
-
integrationDisplayName?: string;
|
|
3107
|
-
allowedIntegrations?: string[];
|
|
3108
|
-
surface?: 'settings_connections' | 'ops_destinations' | 'gtm_kernel';
|
|
3109
|
-
source?: string;
|
|
3110
|
-
userEmail?: string;
|
|
3111
|
-
userDisplayName?: string;
|
|
3112
|
-
}
|
|
3113
|
-
interface GtmNangoToolsListOptions extends GtmNangoBaseOptions {
|
|
3114
|
-
format?: 'openai' | 'nango';
|
|
3115
|
-
includeRaw?: boolean;
|
|
3116
|
-
}
|
|
3117
|
-
interface GtmNangoIntegrationFlowPrepareInput extends GtmNangoBaseOptions {
|
|
3118
|
-
query?: string;
|
|
3119
|
-
search?: string;
|
|
3120
|
-
providerId?: string;
|
|
3121
|
-
provider?: string;
|
|
3122
|
-
intent?: 'auto' | 'search' | 'connect' | 'pull' | 'import' | 'export' | 'send' | 'ops' | 'campaign' | 'route';
|
|
3123
|
-
actionName?: string;
|
|
3124
|
-
toolName?: string;
|
|
3125
|
-
proxyPath?: string;
|
|
3126
|
-
method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
|
|
3127
|
-
input?: UnknownRecord;
|
|
3128
|
-
cadence?: 'hourly' | 'daily' | 'weekly' | string;
|
|
3129
|
-
fieldMap?: UnknownRecord;
|
|
3130
|
-
requiredFields?: string[];
|
|
3131
|
-
confirmSpend?: boolean;
|
|
3132
|
-
writeConfirmed?: boolean;
|
|
3133
|
-
layer?: GtmLayer | string;
|
|
3134
|
-
campaignId?: string;
|
|
3135
|
-
limit?: number;
|
|
3136
|
-
includeProviderCatalog?: boolean;
|
|
3137
|
-
}
|
|
3138
|
-
interface GtmNangoToolCallInput extends GtmNangoBaseOptions {
|
|
3139
|
-
actionName?: string;
|
|
3140
|
-
toolName?: string;
|
|
3141
|
-
deliveryMode?: 'action' | 'proxy' | string;
|
|
3142
|
-
proxyPath?: string;
|
|
3143
|
-
nangoProxyPath?: string;
|
|
3144
|
-
method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | string;
|
|
3145
|
-
httpMethod?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | string;
|
|
3146
|
-
proxyHeaders?: UnknownRecord;
|
|
3147
|
-
input?: UnknownRecord;
|
|
3148
|
-
async?: boolean;
|
|
3149
|
-
maxRetries?: number;
|
|
3150
|
-
dryRun?: boolean;
|
|
3151
|
-
confirm?: boolean;
|
|
3152
|
-
confirmWrite?: boolean;
|
|
3153
|
-
}
|
|
3154
|
-
interface GtmNangoActionResultGetInput {
|
|
3155
|
-
actionId?: string;
|
|
3156
|
-
statusUrl?: string;
|
|
3157
|
-
}
|
|
3158
|
-
interface GtmWebhookDeliverInput {
|
|
3159
|
-
recipeId: string;
|
|
3160
|
-
campaignId?: string;
|
|
3161
|
-
layer?: GtmLayer;
|
|
3162
|
-
records: UnknownRecord[];
|
|
3163
|
-
context?: UnknownRecord;
|
|
3164
|
-
idempotencyKey?: string;
|
|
3165
|
-
}
|
|
3166
|
-
declare class GtmKernel {
|
|
3167
|
-
private client;
|
|
3168
|
-
constructor(client: HttpClient);
|
|
3169
|
-
/** Load workspace context for an agent session: campaigns, memory, Brain, connections, and Signaliz primitives. */
|
|
3170
|
-
context(options?: GtmWorkspaceContextOptions): Promise<any>;
|
|
3171
|
-
/** Inspect whether the workspace has the Kernel + Brain substrate pieces needed to build, run, and improve campaigns. */
|
|
3172
|
-
bootstrapStatus(options?: GtmWorkspaceBootstrapStatusOptions): Promise<any>;
|
|
3173
|
-
/** Discover existing provider campaigns, starting with live/Kernel-linked Instantly campaigns, before audit or import preview. */
|
|
3174
|
-
discoverExistingCampaigns(options?: GtmExistingCampaignDiscoverOptions): Promise<GtmExistingCampaignDiscoveryResult>;
|
|
3175
|
-
/** Run a read-only existing campaign audit with completeness, recommendations, safe next MCP JSON, and approval boundaries. */
|
|
3176
|
-
auditExistingCampaign(options: GtmExistingCampaignAuditOptions): Promise<GtmExistingCampaignAuditResult>;
|
|
3177
|
-
/** Discover the first matching existing provider campaign, then run the same read-only audit against that match. */
|
|
3178
|
-
auditExistingCampaignBySearch(options: GtmExistingCampaignAuditBySearchOptions): Promise<GtmExistingCampaignAuditResult>;
|
|
3179
|
-
/** Create a first-class GTM campaign object in the current workspace. */
|
|
3180
|
-
createCampaign(input: GtmCampaignCreateInput): Promise<any>;
|
|
3181
|
-
/** Backfill historical campaigns, provider links, feedback, and memory into the GTM Kernel substrate. */
|
|
3182
|
-
importCampaignHistory(input: GtmCampaignHistoryImportInput): Promise<any>;
|
|
3183
|
-
/** Queue a Trigger-backed campaign history import for larger private campaign backfills. */
|
|
3184
|
-
importCampaignHistoryRun(input: GtmCampaignHistoryImportRunInput): Promise<any>;
|
|
3185
|
-
/** Preview a provider-neutral history import payload derived from an existing campaign build. */
|
|
3186
|
-
previewCampaignBuildBackfill(options: GtmCampaignBuildBackfillPreviewOptions): Promise<any>;
|
|
3187
|
-
/** Queue campaign-build history backfills through the Trigger-backed history import runner. */
|
|
3188
|
-
runCampaignBuildBackfill(input: GtmCampaignBuildBackfillRunInput): Promise<any>;
|
|
3189
|
-
/** Inspect Campaign Builder to Kernel backfill status for one build. */
|
|
3190
|
-
campaignBuildBackfillStatus(options: GtmCampaignBuildBackfillStatusOptions): Promise<any>;
|
|
3191
|
-
/** List first-class GTM campaign objects in the current workspace. */
|
|
3192
|
-
listCampaigns(options?: GtmCampaignListOptions): Promise<any>;
|
|
3193
|
-
/** Get one campaign with provider links, logs, feedback summary, memory, and Brain patterns. */
|
|
3194
|
-
getCampaign(campaignId: string, options?: GtmCampaignGetOptions): Promise<any>;
|
|
3195
|
-
/** Inspect campaign execution state, linked build progress, provider readiness, feedback, memory, and next actions. */
|
|
3196
|
-
campaignExecutionStatus(options: GtmCampaignExecutionStatusOptions): Promise<any>;
|
|
3197
|
-
/** Inspect whether a campaign/build is ready for Brain learning and return exact learning-cycle args. */
|
|
3198
|
-
campaignLearningStatus(options: GtmCampaignLearningStatusOptions): Promise<GtmCampaignLearningStatusResult>;
|
|
3199
|
-
/** Update a first-class GTM campaign and append the associated campaign log entry. */
|
|
3200
|
-
updateCampaign(input: GtmCampaignUpdateInput): Promise<any>;
|
|
3201
|
-
/** Append an auditable campaign action with actor, rationale, payload, and optional idempotency key. */
|
|
3202
|
-
logCampaign(campaignId: string, input: Omit<GtmCampaignLogInput, 'campaignId'>): Promise<any>;
|
|
3203
|
-
/** Ingest provider-neutral feedback from Instantly, Smartlead, HeyReach, webhook, or a custom MCP. */
|
|
3204
|
-
ingestFeedback(input: GtmFeedbackIngestInput): Promise<any>;
|
|
3205
|
-
/** Run a read-only Campaign Audit and persist workspace-scoped failure findings. */
|
|
3206
|
-
runCampaignAudit(input: GtmCampaignAuditRunInput): Promise<any>;
|
|
3207
|
-
/** Read a persisted Campaign Audit by audit id or campaign id. */
|
|
3208
|
-
getCampaignAudit(options: GtmCampaignAuditGetOptions): Promise<any>;
|
|
3209
|
-
/** Normalize Instantly webhook/pull payloads and ingest row-level feedback through the GTM Kernel. */
|
|
3210
|
-
syncInstantlyFeedback(input: GtmInstantlyFeedbackSyncInput): Promise<any>;
|
|
3211
|
-
/** Start a background Instantly webhook-events or email-history pull and route results into the GTM feedback loop. */
|
|
3212
|
-
pullInstantlyFeedback(input: GtmInstantlyFeedbackPullInput): Promise<any>;
|
|
3213
|
-
/** Prepare a secure Instantly feedback webhook URL for a campaign provider link. */
|
|
3214
|
-
prepareInstantlyFeedbackWebhook(input: GtmInstantlyFeedbackWebhookPrepareInput): Promise<any>;
|
|
3215
|
-
/** Preview anonymized Instantly workspace sources registered for Kernel import. */
|
|
3216
|
-
previewKernelImport(input?: GtmKernelImportPreviewInput): Promise<any>;
|
|
3217
|
-
/** Queue the read-only Instantly-to-GTM Kernel import. Live writes require writeApproved. */
|
|
3218
|
-
runKernelImport(input?: GtmKernelImportRunInput): Promise<any>;
|
|
3219
|
-
/** Queue Brain distillation over imported Instantly memory with abstracted-only outputs. */
|
|
3220
|
-
runBrainDistillation(input?: GtmBrainDistillRunInput): Promise<any>;
|
|
3221
|
-
/** Queue a dry-run-first bridge from imported historical feedback to attribution-only Campaign Build surrogates. */
|
|
3222
|
-
runHistoricalCampaignBuildBridge(input?: GtmHistoricalCampaignBuildBridgeRunInput): Promise<any>;
|
|
3223
|
-
/** Prepare a provider-agnostic feedback webhook URL for Smartlead, HeyReach, Airbyte, or custom sender events. */
|
|
3224
|
-
prepareFeedbackWebhook(input: GtmFeedbackWebhookPrepareInput): Promise<any>;
|
|
3225
|
-
/** Search ranked workspace campaign memory instead of dumping raw history. */
|
|
3226
|
-
searchMemory(options?: GtmMemorySearchOptions): Promise<any>;
|
|
3227
|
-
/** Retrieve evidence-backed workspace and privacy-safe aggregate Brain patterns. */
|
|
3228
|
-
brainPatterns(options?: GtmBrainPatternsOptions): Promise<any>;
|
|
3229
|
-
/** Plan the closed-loop Brain learning sequence without recursively executing Edge Functions. */
|
|
3230
|
-
learningCyclePlan(input?: GtmBrainLearningCyclePlanInput): Promise<GtmBrainLearningCyclePlanResult>;
|
|
3231
|
-
/** Queue the closed-loop Brain learning sequence in Trigger. */
|
|
3232
|
-
learningCycleRun(input?: GtmBrainLearningCycleRunInput): Promise<any>;
|
|
3233
|
-
/** Seed campaign defaults from active Brain patterns and ranked workspace memory. */
|
|
3234
|
-
seedBrainDefaults(input?: GtmBrainSeedDefaultsInput): Promise<any>;
|
|
3235
|
-
/** Extract within-workspace Brain V1 patterns from feedback, provider links, campaigns, and memory. */
|
|
3236
|
-
extractBrainPatterns(input?: GtmBrainExtractPatternsInput): Promise<any>;
|
|
3237
|
-
/** Aggregate opted-in workspace Brain patterns into privacy-safe global defaults. */
|
|
3238
|
-
aggregateBrainPatterns(input?: GtmBrainAggregatePatternsInput): Promise<any>;
|
|
3239
|
-
/** Aggregate opted-in workspace deliverability calibrations into privacy-safe global calibration rows. */
|
|
3240
|
-
aggregateBrainCalibrations(input?: GtmBrainAggregateCalibrationsInput): Promise<any>;
|
|
3241
|
-
/** Calibrate workspace deliverability predictions against actual bounce feedback. */
|
|
3242
|
-
calibrateDeliverability(input?: GtmBrainCalibrateDeliverabilityInput): Promise<any>;
|
|
3243
|
-
/** Estimate pre-send delivery risk from campaign context, lead samples, and Brain calibrations. */
|
|
3244
|
-
deliveryRisk(input?: GtmBrainDeliveryRiskInput): Promise<any>;
|
|
3245
|
-
/** Predict booked-meeting likelihood for uploaded, inline, or MCP-sourced lead rows without persisting raw rows. */
|
|
3246
|
-
predictMeetingLikelihood(input: GtmMeetingLikelihoodInput): Promise<any>;
|
|
3247
|
-
/** Rank provider-chain, ICP, source, copy, and sequence failure patterns without writing raw lead data. */
|
|
3248
|
-
failurePatterns(options?: GtmBrainFailurePatternsOptions): Promise<any>;
|
|
3249
|
-
/** List provider presets agents can wire into GTM campaign layers, including BYO and Signaliz fallback options. */
|
|
3250
|
-
providerCatalog(options?: GtmProviderCatalogOptions): Promise<any>;
|
|
3251
|
-
/** List private-safe campaign strategy templates agents can merge into campaign build plans. */
|
|
3252
|
-
campaignStrategyTemplates(options?: GtmCampaignStrategyTemplatesOptions): Promise<any>;
|
|
3253
|
-
/** Search the Agency Autopilot safe-action catalog for agency-style lead lists, Clay tables, and GTM motions. */
|
|
3254
|
-
agencyAutopilotCapabilityCatalog(options?: GtmAgencyAutopilotCapabilityCatalogOptions): Promise<unknown>;
|
|
3255
|
-
/** Search agency operating playbooks Agency Autopilot can use for lead lists, Clay tables, GTM motions, and proof gates. */
|
|
3256
|
-
agencyAutopilotPlaybookCatalog(options?: GtmAgencyAutopilotPlaybookCatalogOptions): Promise<unknown>;
|
|
3257
|
-
/** Build the read-only Memory, Brain, risk, and provider-route runbook needed before planning a campaign. */
|
|
3258
|
-
campaignStartContext(input?: GtmCampaignStartContextInput): Promise<any>;
|
|
3259
|
-
/** Inspect GTM integration activation cards for UI and agent routing without writing state. */
|
|
3260
|
-
integrationsActivationStatus(options?: GtmIntegrationsActivationStatusOptions): Promise<any>;
|
|
3261
|
-
/** Compose Memory, Brain defaults, failure intelligence, and provider routes into a read-only campaign build plan. */
|
|
3262
|
-
campaignBuildPlan(input?: GtmCampaignBuildPlanInput): Promise<any>;
|
|
3263
|
-
/** Emit reusable CampaignBuilderAgentRequest JSON from hosted MCP strategy-template defaults without spending credits. */
|
|
3264
|
-
campaignAgentRequestTemplate(input?: GtmCampaignAgentRequestTemplateInput): Promise<any>;
|
|
3265
|
-
/** Compose a one-call read-only strategy-template campaign-agent runbook across built-ins, Memory, Brain, Nango, and BYO routes. */
|
|
3266
|
-
campaignAgentPlan(input?: GtmCampaignAgentPlanInput): Promise<any>;
|
|
3267
|
-
/** Inspect private-safe strategy-template/workflow memory readiness before campaign planning. */
|
|
3268
|
-
campaignStrategyMemoryStatus(input?: GtmCampaignStrategyMemoryStatusInput): Promise<any>;
|
|
3269
|
-
/** Persist a reviewed campaign build plan into a campaign object and audit log. Dry-run first by default. */
|
|
3270
|
-
commitCampaignBuildPlan(input?: GtmCampaignBuildPlanCommitInput): Promise<any>;
|
|
3271
|
-
/** Derive exact build_campaign arguments from a committed campaign object without creating a build. */
|
|
3272
|
-
prepareCampaignBuildExecution(input: GtmCampaignBuildExecutionPrepareInput): Promise<any>;
|
|
3273
|
-
/** Prepare exact recipe, route, preview, and delivery arguments for a provider without writing state. */
|
|
3274
|
-
prepareProviderRecipe(input: GtmProviderRecipePrepareInput): Promise<any>;
|
|
3275
|
-
/** Prepare exact Clay webhook recipe, route, preview, and delivery arguments without writing state. */
|
|
3276
|
-
prepareClayWebhook(input?: GtmClayWebhookPrepareInput): Promise<any>;
|
|
3277
|
-
/** Dry-run or confirm a one-call provider route activation across one or more GTM layers. */
|
|
3278
|
-
activateProviderRoute(input: GtmProviderRouteActivateInput): Promise<any>;
|
|
3279
|
-
/** List Signaliz-managed integrations, external MCP servers, app connections, recipes, and layer routes. */
|
|
3280
|
-
listConnections(options?: GtmConnectionsListOptions): Promise<any>;
|
|
3281
|
-
/** Register a workspace connection for the Kernel connection layer. */
|
|
3282
|
-
registerConnection(input: GtmConnectionRegisterInput): Promise<any>;
|
|
3283
|
-
/** Create a reusable integration recipe for BYO providers such as Clay webhooks, Apollo, AI Ark, Octave, or Airbyte. */
|
|
3284
|
-
createIntegrationRecipe(input: GtmIntegrationRecipeCreateInput): Promise<any>;
|
|
3285
|
-
/** Set a workspace or campaign provider route for one GTM layer. */
|
|
3286
|
-
setLayerRoute(input: GtmLayerRouteSetInput): Promise<any>;
|
|
3287
|
-
/** Get effective layer routes, including Signaliz fallback availability. */
|
|
3288
|
-
getLayerRoutes(options?: GtmLayerRoutesGetOptions): Promise<any>;
|
|
3289
|
-
/** Preview one effective layer route before external delivery or provider execution. */
|
|
3290
|
-
previewLayerRoute(input: GtmLayerRoutePreviewInput): Promise<any>;
|
|
3291
|
-
/** Create a short-lived Nango Connect session so a user can authorize a vendor API. */
|
|
3292
|
-
createNangoConnectSession(input: GtmNangoConnectSessionCreateInput): Promise<any>;
|
|
3293
|
-
/** Prepare the full Nango provider search, connect, pull/export, Ops, and campaign-route flow. */
|
|
3294
|
-
prepareNangoIntegrationFlow(input?: GtmNangoIntegrationFlowPrepareInput): Promise<any>;
|
|
3295
|
-
/** List Nango-backed action tools for a workspace connection without executing them. */
|
|
3296
|
-
listNangoTools(options?: GtmNangoToolsListOptions): Promise<any>;
|
|
3297
|
-
/** Dry-run or execute a Nango-backed action tool through the approval-aware MCP bridge. */
|
|
3298
|
-
callNangoTool(input: GtmNangoToolCallInput): Promise<any>;
|
|
3299
|
-
/** Poll an async Nango action result by action id or status URL. */
|
|
3300
|
-
getNangoActionResult(input: GtmNangoActionResultGetInput): Promise<any>;
|
|
3301
|
-
/** Deliver approved campaign-layer records to a webhook recipe, starting with Clay-style webhooks. */
|
|
3302
|
-
deliverWebhook(input: GtmWebhookDeliverInput): Promise<any>;
|
|
3303
|
-
private callMcp;
|
|
3304
|
-
}
|
|
3305
|
-
|
|
3306
|
-
type ExecutionReferenceKind = 'op' | 'routine' | 'routine_tick' | 'trigger_run' | 'dataplane_run' | 'queue_job' | 'execution_event' | 'replay_run' | 'unknown';
|
|
3307
|
-
interface ExecutionReference {
|
|
3308
|
-
kind: ExecutionReferenceKind;
|
|
3309
|
-
id: string;
|
|
3310
|
-
original: string;
|
|
3311
|
-
label: string;
|
|
3312
|
-
query_field: string;
|
|
3313
|
-
status_command?: string;
|
|
3314
|
-
replay_command?: string;
|
|
3315
|
-
}
|
|
3316
|
-
interface ExecutionReferenceInput {
|
|
3317
|
-
id: string;
|
|
3318
|
-
kind?: ExecutionReferenceKind;
|
|
3319
|
-
source_field?: string;
|
|
3320
|
-
}
|
|
3321
|
-
declare function normalizeExecutionReference(input: string | ExecutionReferenceInput): ExecutionReference;
|
|
3322
|
-
declare function collectExecutionReferences(payload: Record<string, unknown>): ExecutionReference[];
|
|
3323
|
-
|
|
3324
|
-
type OpsCadence = 'hourly' | 'daily' | 'weekly' | 'manual';
|
|
3325
|
-
type OpsRoutineStatus = 'draft' | 'active' | 'paused' | 'archived' | 'failed';
|
|
3326
|
-
type OpsSinkType = 'csv' | 'webhook' | 'airbyte' | 'nango' | 'slack' | 'google_sheets' | 'notion' | 'instantly' | 'routine';
|
|
3327
|
-
type OpsBlueprint = 'monitor_companies' | 'build_leads' | 'enrich_list' | 'route_signals' | 'launch_campaign';
|
|
3328
|
-
type SimpleOpStatus = 'draft' | 'ready' | 'running' | 'blocked' | 'needs_approval' | 'completed' | 'failed';
|
|
3329
|
-
type OpsPrimitivePermissionLevel = 'read' | 'write' | 'spend' | 'admin';
|
|
3330
|
-
type OpsPrimitiveWorkspaceScope = 'required';
|
|
3331
|
-
interface OpsPrimitiveRetryPolicy {
|
|
3332
|
-
max_retries: number;
|
|
3333
|
-
maxRetries?: number;
|
|
3334
|
-
initial_delay_ms: number;
|
|
3335
|
-
initialDelayMs?: number;
|
|
3336
|
-
max_delay_ms: number;
|
|
3337
|
-
maxDelayMs?: number;
|
|
3338
|
-
backoff_multiplier: number;
|
|
3339
|
-
backoffMultiplier?: number;
|
|
3340
|
-
jitter: boolean;
|
|
3341
|
-
retryable_errors: string[];
|
|
3342
|
-
retryableErrors?: string[];
|
|
3343
|
-
respect_retry_after: boolean;
|
|
3344
|
-
respectRetryAfter?: boolean;
|
|
3345
|
-
}
|
|
3346
|
-
interface OpsPrimitiveConcurrencyPolicy {
|
|
3347
|
-
workspace_key: string;
|
|
3348
|
-
workspaceKey?: string;
|
|
3349
|
-
provider_key?: string;
|
|
3350
|
-
providerKey?: string;
|
|
3351
|
-
max_concurrency: number;
|
|
3352
|
-
maxConcurrency?: number;
|
|
3353
|
-
}
|
|
3354
|
-
interface OpsPrimitiveDeadLetterPolicy {
|
|
3355
|
-
enabled: boolean;
|
|
3356
|
-
queue: string;
|
|
3357
|
-
include_input_hash: boolean;
|
|
3358
|
-
includeInputHash?: boolean;
|
|
3359
|
-
include_execution_refs: boolean;
|
|
3360
|
-
includeExecutionRefs?: boolean;
|
|
3361
|
-
}
|
|
3362
|
-
interface OpsPrimitiveObservabilityPolicy {
|
|
3363
|
-
emits_execution_refs: boolean;
|
|
3364
|
-
emitsExecutionRefs?: boolean;
|
|
3365
|
-
emits_progress_events: boolean;
|
|
3366
|
-
emitsProgressEvents?: boolean;
|
|
3367
|
-
event_fields: string[];
|
|
3368
|
-
eventFields?: string[];
|
|
3369
|
-
}
|
|
3370
|
-
interface OpsPrimitive {
|
|
3371
|
-
id: string;
|
|
3372
|
-
version: string;
|
|
3373
|
-
capability: string;
|
|
3374
|
-
permission_level: OpsPrimitivePermissionLevel;
|
|
3375
|
-
permissionLevel?: OpsPrimitivePermissionLevel;
|
|
3376
|
-
workspace_scope: OpsPrimitiveWorkspaceScope;
|
|
3377
|
-
workspaceScope?: OpsPrimitiveWorkspaceScope;
|
|
3378
|
-
input_schema: Record<string, unknown>;
|
|
3379
|
-
inputSchema?: Record<string, unknown>;
|
|
3380
|
-
output_schema: Record<string, unknown>;
|
|
3381
|
-
outputSchema?: Record<string, unknown>;
|
|
3382
|
-
retry_policy: OpsPrimitiveRetryPolicy;
|
|
3383
|
-
retryPolicy?: OpsPrimitiveRetryPolicy;
|
|
3384
|
-
concurrency_policy: OpsPrimitiveConcurrencyPolicy;
|
|
3385
|
-
concurrencyPolicy?: OpsPrimitiveConcurrencyPolicy;
|
|
3386
|
-
rate_limit_key?: string;
|
|
3387
|
-
rateLimitKey?: string;
|
|
3388
|
-
idempotency_key_fields: string[];
|
|
3389
|
-
idempotencyKeyFields?: string[];
|
|
3390
|
-
dead_letter_policy: OpsPrimitiveDeadLetterPolicy;
|
|
3391
|
-
deadLetterPolicy?: OpsPrimitiveDeadLetterPolicy;
|
|
3392
|
-
observability: OpsPrimitiveObservabilityPolicy;
|
|
3393
|
-
}
|
|
3394
|
-
interface OpsSink {
|
|
3395
|
-
id?: string;
|
|
3396
|
-
sinkId?: string;
|
|
3397
|
-
sink_id?: string;
|
|
3398
|
-
connectionId?: string;
|
|
3399
|
-
connection_id?: string;
|
|
3400
|
-
type: OpsSinkType;
|
|
3401
|
-
name?: string;
|
|
3402
|
-
connectorId?: string;
|
|
3403
|
-
connector_id?: string;
|
|
3404
|
-
connectorName?: string;
|
|
3405
|
-
connector_name?: string;
|
|
3406
|
-
category?: string;
|
|
3407
|
-
status?: string;
|
|
3408
|
-
syncStatus?: string | null;
|
|
3409
|
-
sync_status?: string | null;
|
|
3410
|
-
lastSyncedAt?: string | null;
|
|
3411
|
-
last_synced_at?: string | null;
|
|
3412
|
-
config?: Record<string, unknown>;
|
|
3413
|
-
deliveryMode?: string;
|
|
3414
|
-
delivery_mode?: string;
|
|
3415
|
-
providerConfigKey?: string;
|
|
3416
|
-
provider_config_key?: string;
|
|
3417
|
-
integrationId?: string;
|
|
3418
|
-
integration_id?: string;
|
|
3419
|
-
nangoConnectionId?: string;
|
|
3420
|
-
nango_connection_id?: string;
|
|
3421
|
-
actionName?: string;
|
|
3422
|
-
action_name?: string;
|
|
3423
|
-
nangoAction?: string;
|
|
3424
|
-
nango_action?: string;
|
|
3425
|
-
proxyPath?: string;
|
|
3426
|
-
proxy_path?: string;
|
|
3427
|
-
nangoProxyPath?: string;
|
|
3428
|
-
nango_proxy_path?: string;
|
|
3429
|
-
method?: string;
|
|
3430
|
-
httpMethod?: string;
|
|
3431
|
-
http_method?: string;
|
|
3432
|
-
fieldMap?: Record<string, unknown>;
|
|
3433
|
-
field_map?: Record<string, unknown>;
|
|
3434
|
-
requiredFields?: string[];
|
|
3435
|
-
required_fields?: string[];
|
|
3436
|
-
writeConfirmed?: boolean;
|
|
3437
|
-
write_confirmed?: boolean;
|
|
3438
|
-
agentWriteConfirmed?: boolean;
|
|
3439
|
-
agent_write_confirmed?: boolean;
|
|
3440
|
-
enabled?: boolean;
|
|
3441
|
-
}
|
|
3442
|
-
interface OpsRoutine {
|
|
3443
|
-
id?: string;
|
|
3444
|
-
routine_id?: string;
|
|
3445
|
-
routineId?: string;
|
|
3446
|
-
name?: string;
|
|
3447
|
-
goal?: string;
|
|
3448
|
-
cadence?: OpsCadence | string;
|
|
3449
|
-
status?: OpsRoutineStatus | string;
|
|
3450
|
-
lastTickAt?: string | null;
|
|
3451
|
-
last_tick_at?: string | null;
|
|
3452
|
-
nextTickAt?: string | null;
|
|
3453
|
-
next_tick_at?: string | null;
|
|
3454
|
-
outputSinks?: OpsSink[];
|
|
3455
|
-
output_sinks?: OpsSink[];
|
|
3456
|
-
execution_refs?: ExecutionReference[];
|
|
3457
|
-
[key: string]: unknown;
|
|
3458
|
-
}
|
|
3459
|
-
interface OpsRoutinesResult {
|
|
3460
|
-
routines: OpsRoutine[];
|
|
3461
|
-
total?: number;
|
|
3462
|
-
next_cursor?: string | null;
|
|
3463
|
-
nextCursor?: string | null;
|
|
3464
|
-
has_more?: boolean;
|
|
3465
|
-
hasMore?: boolean;
|
|
3466
|
-
}
|
|
3467
|
-
interface OpsRoutineTick {
|
|
3468
|
-
id?: string;
|
|
3469
|
-
tick_id?: string;
|
|
3470
|
-
tickId?: string;
|
|
3471
|
-
routine_id?: string;
|
|
3472
|
-
routineId?: string;
|
|
3473
|
-
status?: string;
|
|
3474
|
-
state?: string;
|
|
3475
|
-
started_at?: string | null;
|
|
3476
|
-
startedAt?: string | null;
|
|
3477
|
-
completed_at?: string | null;
|
|
3478
|
-
completedAt?: string | null;
|
|
3479
|
-
error_message?: string | null;
|
|
3480
|
-
errorMessage?: string | null;
|
|
3481
|
-
execution_refs?: ExecutionReference[];
|
|
3482
|
-
[key: string]: unknown;
|
|
3483
|
-
}
|
|
3484
|
-
interface OpsRoutineTicksResult {
|
|
3485
|
-
ticks: OpsRoutineTick[];
|
|
3486
|
-
items?: OpsRoutineTick[];
|
|
3487
|
-
next_cursor?: string | null;
|
|
3488
|
-
nextCursor?: string | null;
|
|
3489
|
-
has_more?: boolean;
|
|
3490
|
-
hasMore?: boolean;
|
|
3491
|
-
[key: string]: unknown;
|
|
3492
|
-
}
|
|
3493
|
-
interface OpsRoutineTickItem {
|
|
3494
|
-
id?: string;
|
|
3495
|
-
item_id?: string;
|
|
3496
|
-
itemId?: string;
|
|
3497
|
-
tick_id?: string;
|
|
3498
|
-
tickId?: string;
|
|
3499
|
-
routine_id?: string;
|
|
3500
|
-
routineId?: string;
|
|
3501
|
-
state?: string;
|
|
3502
|
-
status?: string;
|
|
3503
|
-
error_message?: string | null;
|
|
3504
|
-
errorMessage?: string | null;
|
|
3505
|
-
payload?: Record<string, unknown>;
|
|
3506
|
-
row?: Record<string, unknown>;
|
|
3507
|
-
execution_refs?: ExecutionReference[];
|
|
3508
|
-
[key: string]: unknown;
|
|
3509
|
-
}
|
|
3510
|
-
interface OpsRoutineTickItemsResult {
|
|
3511
|
-
items: OpsRoutineTickItem[];
|
|
3512
|
-
rows?: OpsRoutineTickItem[];
|
|
3513
|
-
next_cursor?: string | null;
|
|
3514
|
-
nextCursor?: string | null;
|
|
3515
|
-
has_more?: boolean;
|
|
3516
|
-
hasMore?: boolean;
|
|
3517
|
-
[key: string]: unknown;
|
|
3518
|
-
}
|
|
3519
|
-
interface OpsReadinessOptions {
|
|
3520
|
-
windowHours?: number;
|
|
3521
|
-
includeDetails?: boolean;
|
|
3522
|
-
runAcquisitionProbe?: boolean;
|
|
3523
|
-
}
|
|
3524
|
-
interface OpsReadinessCheck {
|
|
3525
|
-
id: string;
|
|
3526
|
-
label: string;
|
|
3527
|
-
status: 'pass' | 'warn' | 'fail';
|
|
3528
|
-
detail: string;
|
|
3529
|
-
next_action?: string;
|
|
3530
|
-
nextAction?: string;
|
|
3531
|
-
}
|
|
3532
|
-
interface OpsReadinessResult {
|
|
3533
|
-
status: 'ready' | 'degraded' | 'blocked';
|
|
3534
|
-
checked_at?: string;
|
|
3535
|
-
checkedAt: string;
|
|
3536
|
-
credits_used?: 0;
|
|
3537
|
-
creditsUsed: 0;
|
|
3538
|
-
credits_charged?: 0;
|
|
3539
|
-
creditsCharged: 0;
|
|
3540
|
-
summary: {
|
|
3541
|
-
active_connections?: number;
|
|
3542
|
-
activeConnections: number;
|
|
3543
|
-
failing_connections?: number;
|
|
3544
|
-
failingConnections: number;
|
|
3545
|
-
active_routines?: number;
|
|
3546
|
-
activeRoutines: number;
|
|
3547
|
-
recent_failed_ticks?: number;
|
|
3548
|
-
recentFailedTicks: number;
|
|
3549
|
-
queued_deliveries?: number;
|
|
3550
|
-
queuedDeliveries: number;
|
|
3551
|
-
pending_approvals?: number;
|
|
3552
|
-
pendingApprovals: number;
|
|
3553
|
-
lead_records?: number;
|
|
3554
|
-
leadRecords: number;
|
|
3555
|
-
recent_acquisition_failures?: number;
|
|
3556
|
-
recentAcquisitionFailures: number;
|
|
3557
|
-
acquisition_probe_status?: string;
|
|
3558
|
-
acquisitionProbeStatus?: string;
|
|
3559
|
-
};
|
|
3560
|
-
checks: OpsReadinessCheck[];
|
|
3561
|
-
next_actions?: string[];
|
|
3562
|
-
nextActions: string[];
|
|
3563
|
-
raw?: Record<string, unknown>;
|
|
3564
|
-
}
|
|
3565
|
-
interface OpsProofOptions {
|
|
3566
|
-
windowHours?: number;
|
|
3567
|
-
}
|
|
3568
|
-
interface OpsProofDestination {
|
|
3569
|
-
type: string;
|
|
3570
|
-
label: string;
|
|
3571
|
-
connected: boolean;
|
|
3572
|
-
healthy: boolean;
|
|
3573
|
-
delivered: number;
|
|
3574
|
-
failed: number;
|
|
3575
|
-
proof: 'verified' | 'connected' | 'needs_attention' | 'not_connected' | string;
|
|
3576
|
-
}
|
|
3577
|
-
interface OpsProofResult {
|
|
3578
|
-
success?: boolean;
|
|
3579
|
-
status: 'ready' | 'partial' | 'unproven' | 'blocked' | string;
|
|
3580
|
-
proof_state?: string;
|
|
3581
|
-
proofState?: string;
|
|
3582
|
-
phase?: string;
|
|
3583
|
-
checked_at?: string;
|
|
3584
|
-
checkedAt?: string;
|
|
3585
|
-
window_hours?: number;
|
|
3586
|
-
windowHours?: number;
|
|
3587
|
-
label: string;
|
|
3588
|
-
ui_summary?: string;
|
|
3589
|
-
uiSummary?: string;
|
|
3590
|
-
founder_verdict?: string;
|
|
3591
|
-
founderVerdict?: string;
|
|
3592
|
-
description?: string;
|
|
3593
|
-
summary: {
|
|
3594
|
-
connected_destinations?: number;
|
|
3595
|
-
connectedDestinations: number;
|
|
3596
|
-
healthy_destinations?: number;
|
|
3597
|
-
healthyDestinations: number;
|
|
3598
|
-
failing_destinations?: number;
|
|
3599
|
-
failingDestinations: number;
|
|
3600
|
-
deliveries_30d?: number;
|
|
3601
|
-
deliveries30d: number;
|
|
3602
|
-
delivered_30d?: number;
|
|
3603
|
-
delivered30d: number;
|
|
3604
|
-
failed_30d?: number;
|
|
3605
|
-
failed30d: number;
|
|
3606
|
-
external_delivered_30d?: number;
|
|
3607
|
-
externalDelivered30d: number;
|
|
3608
|
-
nango_proofs_30d?: number;
|
|
3609
|
-
nangoProofs30d: number;
|
|
3610
|
-
nango_failures_30d?: number;
|
|
3611
|
-
nangoFailures30d: number;
|
|
3612
|
-
airbyte_configured?: number;
|
|
3613
|
-
airbyteConfigured: number;
|
|
3614
|
-
airbyte_proofs_30d?: number;
|
|
3615
|
-
airbyteProofs30d: number;
|
|
3616
|
-
airbyte_failures_30d?: number;
|
|
3617
|
-
airbyteFailures30d: number;
|
|
3618
|
-
};
|
|
3619
|
-
destinations: OpsProofDestination[];
|
|
3620
|
-
blockers?: string[];
|
|
3621
|
-
next_action?: string;
|
|
3622
|
-
nextAction?: string;
|
|
3623
|
-
next_actions?: string[];
|
|
3624
|
-
nextActions?: string[];
|
|
3625
|
-
estimated_credits?: number;
|
|
3626
|
-
estimatedCredits?: number;
|
|
3627
|
-
approval_required?: boolean;
|
|
3628
|
-
approvalRequired?: boolean;
|
|
3629
|
-
credits_charged?: 0;
|
|
3630
|
-
creditsCharged?: 0;
|
|
3631
|
-
proof_mode?: boolean;
|
|
3632
|
-
proofMode?: boolean;
|
|
3633
|
-
query_errors?: string[];
|
|
3634
|
-
queryErrors?: string[];
|
|
3635
|
-
raw?: Record<string, unknown>;
|
|
3636
|
-
}
|
|
3637
|
-
interface OpsAutopilotOptions {
|
|
3638
|
-
windowHours?: number;
|
|
3639
|
-
}
|
|
3640
|
-
interface OpsAutopilotStep {
|
|
3641
|
-
tool: string;
|
|
3642
|
-
purpose?: string;
|
|
3643
|
-
arguments?: Record<string, unknown>;
|
|
3644
|
-
}
|
|
3645
|
-
interface OpsAutopilotSchedulePacket {
|
|
3646
|
-
cadence: OpsCadence | string;
|
|
3647
|
-
recurrence: string;
|
|
3648
|
-
activate_with: string;
|
|
3649
|
-
activateWith?: string;
|
|
3650
|
-
run_now_with: string;
|
|
3651
|
-
runNowWith?: string;
|
|
3652
|
-
monitor_with: string;
|
|
3653
|
-
monitorWith?: string;
|
|
3654
|
-
retrieve_with: string;
|
|
3655
|
-
retrieveWith?: string;
|
|
3656
|
-
}
|
|
3657
|
-
interface OpsAutopilotNangoRoutePacket {
|
|
3658
|
-
enabled: boolean;
|
|
3659
|
-
route_label: string;
|
|
3660
|
-
routeLabel?: string;
|
|
3661
|
-
connect_tool: string;
|
|
3662
|
-
connectTool?: string;
|
|
3663
|
-
discover_tool: string;
|
|
3664
|
-
discoverTool?: string;
|
|
3665
|
-
dry_run_tool: string;
|
|
3666
|
-
dryRunTool?: string;
|
|
3667
|
-
execute_tool: string;
|
|
3668
|
-
executeTool?: string;
|
|
3669
|
-
execute_and_wait_tool?: string;
|
|
3670
|
-
executeAndWaitTool?: string;
|
|
3671
|
-
schedule_tool?: string;
|
|
3672
|
-
scheduleTool?: string;
|
|
3673
|
-
schedule_and_wait_tool?: string;
|
|
3674
|
-
scheduleAndWaitTool?: string;
|
|
3675
|
-
result_tool: string;
|
|
3676
|
-
resultTool?: string;
|
|
3677
|
-
write_gate: string;
|
|
3678
|
-
writeGate?: string;
|
|
3679
|
-
required_fields: string[];
|
|
3680
|
-
requiredFields?: string[];
|
|
3681
|
-
placeholders: Record<string, string>;
|
|
3682
|
-
dry_run_arguments: Record<string, unknown>;
|
|
3683
|
-
dryRunArguments?: Record<string, unknown>;
|
|
3684
|
-
execute_arguments: Record<string, unknown>;
|
|
3685
|
-
executeArguments?: Record<string, unknown>;
|
|
3686
|
-
execute_and_wait_arguments?: Record<string, unknown>;
|
|
3687
|
-
executeAndWaitArguments?: Record<string, unknown>;
|
|
3688
|
-
schedule_arguments?: Record<string, unknown>;
|
|
3689
|
-
scheduleArguments?: Record<string, unknown>;
|
|
3690
|
-
schedule_and_wait_arguments?: Record<string, unknown>;
|
|
3691
|
-
scheduleAndWaitArguments?: Record<string, unknown>;
|
|
3692
|
-
result_arguments: Record<string, unknown>;
|
|
3693
|
-
resultArguments?: Record<string, unknown>;
|
|
3694
|
-
}
|
|
3695
|
-
interface OpsAutopilotResultPacket {
|
|
3696
|
-
retrieve_tool: string;
|
|
3697
|
-
retrieveTool?: string;
|
|
3698
|
-
result_shape: string[];
|
|
3699
|
-
resultShape?: string[];
|
|
3700
|
-
delivery_receipts: string[];
|
|
3701
|
-
deliveryReceipts?: string[];
|
|
3702
|
-
empty_result_recovery: string;
|
|
3703
|
-
emptyResultRecovery?: string;
|
|
3704
|
-
}
|
|
3705
|
-
interface OpsAutopilotOperatingPacket {
|
|
3706
|
-
north_star: string;
|
|
3707
|
-
northStar?: string;
|
|
3708
|
-
schedule: OpsAutopilotSchedulePacket;
|
|
3709
|
-
nango_route?: OpsAutopilotNangoRoutePacket;
|
|
3710
|
-
nangoRoute?: OpsAutopilotNangoRoutePacket;
|
|
3711
|
-
result_contract: OpsAutopilotResultPacket;
|
|
3712
|
-
resultContract?: OpsAutopilotResultPacket;
|
|
3713
|
-
approval_boundaries: string[];
|
|
3714
|
-
approvalBoundaries?: string[];
|
|
3715
|
-
saved_command_hint: string;
|
|
3716
|
-
savedCommandHint?: string;
|
|
3717
|
-
}
|
|
3718
|
-
interface OpsAutopilotMotion {
|
|
3719
|
-
id: string;
|
|
3720
|
-
blueprint: OpsBlueprint;
|
|
3721
|
-
title: string;
|
|
3722
|
-
outcome: string;
|
|
3723
|
-
prompt: string;
|
|
3724
|
-
target_count: number;
|
|
3725
|
-
targetCount?: number;
|
|
3726
|
-
cadence: OpsCadence | string;
|
|
3727
|
-
destinations: OpsSinkType[];
|
|
3728
|
-
estimated_credits: number;
|
|
3729
|
-
estimatedCredits?: number;
|
|
3730
|
-
proof_gate?: string;
|
|
3731
|
-
proofGate?: string;
|
|
3732
|
-
why_now?: string;
|
|
3733
|
-
whyNow?: string;
|
|
3734
|
-
agent_prompt?: string;
|
|
3735
|
-
agentPrompt?: string;
|
|
3736
|
-
cli_command?: string;
|
|
3737
|
-
cliCommand?: string;
|
|
3738
|
-
mcp_sequence?: OpsAutopilotStep[];
|
|
3739
|
-
mcpSequence?: OpsAutopilotStep[];
|
|
3740
|
-
operating_packet?: OpsAutopilotOperatingPacket;
|
|
3741
|
-
operatingPacket?: OpsAutopilotOperatingPacket;
|
|
3742
|
-
}
|
|
3743
|
-
interface OpsAutopilotResult {
|
|
3744
|
-
success?: boolean;
|
|
3745
|
-
status?: string;
|
|
3746
|
-
phase?: string;
|
|
3747
|
-
stage: string;
|
|
3748
|
-
headline: string;
|
|
3749
|
-
verdict: string;
|
|
3750
|
-
next_action: string;
|
|
3751
|
-
nextAction?: string;
|
|
3752
|
-
primary_motion: OpsAutopilotMotion;
|
|
3753
|
-
primaryMotion?: OpsAutopilotMotion;
|
|
3754
|
-
motions: OpsAutopilotMotion[];
|
|
3755
|
-
scale_rule?: string;
|
|
3756
|
-
scaleRule?: string;
|
|
3757
|
-
agent_handoff?: string;
|
|
3758
|
-
agentHandoff?: string;
|
|
3759
|
-
operating_packet?: OpsAutopilotOperatingPacket;
|
|
3760
|
-
operatingPacket?: OpsAutopilotOperatingPacket;
|
|
3761
|
-
proof_state?: string;
|
|
3762
|
-
proofState?: string;
|
|
3763
|
-
proof_summary?: Record<string, unknown>;
|
|
3764
|
-
proofSummary?: Record<string, unknown>;
|
|
3765
|
-
next_step?: Record<string, unknown>;
|
|
3766
|
-
nextStep?: Record<string, unknown>;
|
|
3767
|
-
query_errors?: string[];
|
|
3768
|
-
queryErrors?: string[];
|
|
3769
|
-
credits_charged?: 0;
|
|
3770
|
-
creditsCharged?: 0;
|
|
3771
|
-
}
|
|
3772
|
-
interface CreateRoutineRequest {
|
|
3773
|
-
name: string;
|
|
3774
|
-
goal: string;
|
|
3775
|
-
description?: string;
|
|
3776
|
-
cadence?: OpsCadence;
|
|
3777
|
-
timezone?: string;
|
|
3778
|
-
status?: Extract<OpsRoutineStatus, 'draft' | 'active' | 'paused'>;
|
|
3779
|
-
policy?: Record<string, unknown>;
|
|
3780
|
-
output_sinks?: OpsSink[];
|
|
3781
|
-
outputSinks?: OpsSink[];
|
|
3782
|
-
wake_on_events?: string[];
|
|
3783
|
-
wakeOnEvents?: string[];
|
|
3784
|
-
}
|
|
3785
|
-
interface UpdateRoutineRequest extends Partial<CreateRoutineRequest> {
|
|
3786
|
-
routine_id?: string;
|
|
3787
|
-
routineId?: string;
|
|
3788
|
-
}
|
|
3789
|
-
interface RunRoutineRequest {
|
|
3790
|
-
routine_id?: string;
|
|
3791
|
-
routineId?: string;
|
|
3792
|
-
instruction?: string;
|
|
3793
|
-
force?: boolean;
|
|
3794
|
-
}
|
|
3795
|
-
interface OpsRoutineRunResult {
|
|
3796
|
-
success?: boolean;
|
|
3797
|
-
routine_id?: string;
|
|
3798
|
-
routineId?: string;
|
|
3799
|
-
tick_id?: string;
|
|
3800
|
-
tickId?: string;
|
|
3801
|
-
run_id?: string | null;
|
|
3802
|
-
runId?: string | null;
|
|
3803
|
-
status?: string;
|
|
3804
|
-
state?: string;
|
|
3805
|
-
next_action?: string;
|
|
3806
|
-
nextAction?: string;
|
|
3807
|
-
execution_refs?: ExecutionReference[];
|
|
3808
|
-
[key: string]: unknown;
|
|
3809
|
-
}
|
|
3810
|
-
interface OpsRoutineDeleteResult {
|
|
3811
|
-
success?: boolean;
|
|
3812
|
-
routine_id?: string;
|
|
3813
|
-
routineId?: string;
|
|
3814
|
-
deleted?: boolean;
|
|
3815
|
-
permanent?: boolean;
|
|
3816
|
-
status?: string;
|
|
3817
|
-
next_action?: string;
|
|
3818
|
-
nextAction?: string;
|
|
3819
|
-
execution_refs?: ExecutionReference[];
|
|
3820
|
-
[key: string]: unknown;
|
|
3821
|
-
}
|
|
3822
|
-
interface OpsRoutineSinkResult {
|
|
3823
|
-
success?: boolean;
|
|
3824
|
-
routine_id?: string;
|
|
3825
|
-
routineId?: string;
|
|
3826
|
-
sink_id?: string;
|
|
3827
|
-
sinkId?: string;
|
|
3828
|
-
status?: string;
|
|
3829
|
-
next_action?: string;
|
|
3830
|
-
nextAction?: string;
|
|
3831
|
-
routine?: OpsRoutine;
|
|
3832
|
-
sink?: OpsSink;
|
|
3833
|
-
execution_refs?: ExecutionReference[];
|
|
3834
|
-
[key: string]: unknown;
|
|
3835
|
-
}
|
|
3836
|
-
interface ListOutputSinksOptions {
|
|
3837
|
-
status?: string;
|
|
3838
|
-
category?: string;
|
|
3839
|
-
include_inactive?: boolean;
|
|
3840
|
-
includeInactive?: boolean;
|
|
3841
|
-
}
|
|
3842
|
-
interface CreateOutputSinkRequest {
|
|
3843
|
-
type: Exclude<OpsSinkType, 'routine'>;
|
|
3844
|
-
name?: string;
|
|
3845
|
-
connection_id?: string;
|
|
3846
|
-
connectionId?: string;
|
|
3847
|
-
config?: Record<string, unknown>;
|
|
3848
|
-
webhook_url?: string;
|
|
3849
|
-
webhookUrl?: string;
|
|
3850
|
-
}
|
|
3851
|
-
interface OpsApproveRequest {
|
|
3852
|
-
token_id?: string;
|
|
3853
|
-
tokenId?: string;
|
|
3854
|
-
token_ids?: string[];
|
|
3855
|
-
tokenIds?: string[];
|
|
3856
|
-
decision?: 'approved' | 'rejected';
|
|
3857
|
-
reviewer_notes?: string;
|
|
3858
|
-
reviewerNotes?: string;
|
|
3859
|
-
}
|
|
3860
|
-
interface OpsApproveResult {
|
|
3861
|
-
success: boolean;
|
|
3862
|
-
decision?: 'approved' | 'rejected' | string;
|
|
3863
|
-
token_id?: string;
|
|
3864
|
-
tokenId?: string;
|
|
3865
|
-
token_ids?: string[];
|
|
3866
|
-
tokenIds?: string[];
|
|
3867
|
-
reviewer_notes?: string;
|
|
3868
|
-
reviewerNotes?: string;
|
|
3869
|
-
[key: string]: unknown;
|
|
3870
|
-
}
|
|
3871
|
-
interface OpsExecutionToolCall {
|
|
3872
|
-
tool: string;
|
|
3873
|
-
arguments: Record<string, unknown>;
|
|
3874
|
-
purpose: string;
|
|
3875
|
-
}
|
|
3876
|
-
interface OpsExecutionScheduleContract {
|
|
3877
|
-
create_tool: string;
|
|
3878
|
-
createTool?: string;
|
|
3879
|
-
activate_tool: string;
|
|
3880
|
-
activateTool?: string;
|
|
3881
|
-
cadence: OpsCadence | string;
|
|
3882
|
-
recurrence: string;
|
|
3883
|
-
wake_on_events: string[];
|
|
3884
|
-
wakeOnEvents?: string[];
|
|
3885
|
-
}
|
|
3886
|
-
interface OpsExecutionApprovalContract {
|
|
3887
|
-
required: boolean;
|
|
3888
|
-
tool: string;
|
|
3889
|
-
reason: string;
|
|
3890
|
-
}
|
|
3891
|
-
interface OpsExecutionMonitorContract {
|
|
3892
|
-
status_tool: string;
|
|
3893
|
-
statusTool?: string;
|
|
3894
|
-
wait_tool?: string;
|
|
3895
|
-
waitTool?: string;
|
|
3896
|
-
results_tool: string;
|
|
3897
|
-
resultsTool?: string;
|
|
3898
|
-
poll_after_ms: number;
|
|
3899
|
-
pollAfterMs?: number;
|
|
3900
|
-
}
|
|
3901
|
-
interface OpsExecutionResultContract {
|
|
3902
|
-
tool: string;
|
|
3903
|
-
wait_tool?: string;
|
|
3904
|
-
waitTool?: string;
|
|
3905
|
-
shape: string[];
|
|
3906
|
-
empty_result_recovery: string;
|
|
3907
|
-
emptyResultRecovery?: string;
|
|
3908
|
-
}
|
|
3909
|
-
interface OpsExecutionNangoRouteContract {
|
|
3910
|
-
enabled: boolean;
|
|
3911
|
-
connect_tool: string;
|
|
3912
|
-
connectTool?: string;
|
|
3913
|
-
discover_tool: string;
|
|
3914
|
-
discoverTool?: string;
|
|
3915
|
-
dry_run_tool: string;
|
|
3916
|
-
dryRunTool?: string;
|
|
3917
|
-
execute_tool: string;
|
|
3918
|
-
executeTool?: string;
|
|
3919
|
-
execute_and_wait_tool?: string;
|
|
3920
|
-
executeAndWaitTool?: string;
|
|
3921
|
-
schedule_tool?: string;
|
|
3922
|
-
scheduleTool?: string;
|
|
3923
|
-
schedule_and_wait_tool?: string;
|
|
3924
|
-
scheduleAndWaitTool?: string;
|
|
3925
|
-
result_tool: string;
|
|
3926
|
-
resultTool?: string;
|
|
3927
|
-
write_gate: string;
|
|
3928
|
-
writeGate?: string;
|
|
3929
|
-
required_fields: string[];
|
|
3930
|
-
requiredFields?: string[];
|
|
3931
|
-
schedule_arguments?: Record<string, unknown>;
|
|
3932
|
-
scheduleArguments?: Record<string, unknown>;
|
|
3933
|
-
schedule_and_wait_arguments?: Record<string, unknown>;
|
|
3934
|
-
scheduleAndWaitArguments?: Record<string, unknown>;
|
|
3935
|
-
}
|
|
3936
|
-
interface OpsExecutionContract {
|
|
3937
|
-
mode: 'run_once' | 'recurring' | 'event_driven' | string;
|
|
3938
|
-
run_now: OpsExecutionToolCall;
|
|
3939
|
-
runNow?: OpsExecutionToolCall;
|
|
3940
|
-
schedule: OpsExecutionScheduleContract;
|
|
3941
|
-
approval: OpsExecutionApprovalContract;
|
|
3942
|
-
monitor: OpsExecutionMonitorContract;
|
|
3943
|
-
result_contract: OpsExecutionResultContract;
|
|
3944
|
-
resultContract?: OpsExecutionResultContract;
|
|
3945
|
-
nango_route?: OpsExecutionNangoRouteContract;
|
|
3946
|
-
nangoRoute?: OpsExecutionNangoRouteContract;
|
|
3947
|
-
sequence: OpsExecutionToolCall[];
|
|
3948
|
-
}
|
|
3949
|
-
interface OpsPlanRequest {
|
|
3950
|
-
prompt: string;
|
|
3951
|
-
blueprint?: OpsBlueprint;
|
|
3952
|
-
target_count?: number;
|
|
3953
|
-
targetCount?: number;
|
|
3954
|
-
cadence?: OpsCadence;
|
|
3955
|
-
wake_on_events?: string[];
|
|
3956
|
-
wakeOnEvents?: string[];
|
|
3957
|
-
destinations?: Array<Record<string, unknown>>;
|
|
3958
|
-
company_domains?: string[];
|
|
3959
|
-
companyDomains?: string[];
|
|
3960
|
-
custom_ai_prompt?: string;
|
|
3961
|
-
customAiPrompt?: string;
|
|
3962
|
-
signal_prompt?: string;
|
|
3963
|
-
signalPrompt?: string;
|
|
3964
|
-
output_prompt?: string;
|
|
3965
|
-
outputPrompt?: string;
|
|
3966
|
-
}
|
|
3967
|
-
interface OpsPlanResult {
|
|
3968
|
-
plan_id: string;
|
|
3969
|
-
planId?: string;
|
|
3970
|
-
blueprint: OpsBlueprint;
|
|
3971
|
-
title: string;
|
|
3972
|
-
goal: string;
|
|
3973
|
-
target_count: number;
|
|
3974
|
-
targetCount?: number;
|
|
3975
|
-
cadence: OpsCadence;
|
|
3976
|
-
status: SimpleOpStatus | string;
|
|
3977
|
-
estimated_credits: number;
|
|
3978
|
-
estimatedCredits?: number;
|
|
3979
|
-
approval_required: boolean;
|
|
3980
|
-
approvalRequired?: boolean;
|
|
3981
|
-
destinations: Array<Record<string, unknown>>;
|
|
3982
|
-
blockers: string[];
|
|
3983
|
-
expected_output?: string;
|
|
3984
|
-
expectedOutput?: string;
|
|
3985
|
-
next_action: string;
|
|
3986
|
-
nextAction?: string;
|
|
3987
|
-
ui_summary?: string;
|
|
3988
|
-
uiSummary?: string;
|
|
3989
|
-
review_steps?: Array<{
|
|
3990
|
-
label: string;
|
|
3991
|
-
value: string;
|
|
3992
|
-
status?: string;
|
|
3993
|
-
}>;
|
|
3994
|
-
reviewSteps?: Array<{
|
|
3995
|
-
label: string;
|
|
3996
|
-
value: string;
|
|
3997
|
-
status?: string;
|
|
3998
|
-
}>;
|
|
3999
|
-
fix_actions?: string[];
|
|
4000
|
-
fixActions?: string[];
|
|
4001
|
-
destination_status?: string;
|
|
4002
|
-
destinationStatus?: string;
|
|
4003
|
-
customization?: {
|
|
4004
|
-
custom_ai_prompt?: string;
|
|
4005
|
-
signal_prompt?: string;
|
|
4006
|
-
output_prompt?: string;
|
|
4007
|
-
[key: string]: unknown;
|
|
4008
|
-
};
|
|
4009
|
-
primitive_graph?: OpsPrimitive[];
|
|
4010
|
-
primitiveGraph?: OpsPrimitive[];
|
|
4011
|
-
execution_contract?: OpsExecutionContract;
|
|
4012
|
-
executionContract?: OpsExecutionContract;
|
|
4013
|
-
advanced?: Record<string, unknown>;
|
|
4014
|
-
}
|
|
4015
|
-
interface OpsCreateRequest extends OpsPlanRequest {
|
|
4016
|
-
name?: string;
|
|
4017
|
-
description?: string;
|
|
4018
|
-
policy?: Record<string, unknown>;
|
|
4019
|
-
timezone?: string;
|
|
4020
|
-
activate?: boolean;
|
|
4021
|
-
confirm_spend?: boolean;
|
|
4022
|
-
confirmSpend?: boolean;
|
|
4023
|
-
}
|
|
4024
|
-
interface OpsExecuteRequest extends OpsCreateRequest {
|
|
4025
|
-
auto_run?: boolean;
|
|
4026
|
-
autoRun?: boolean;
|
|
4027
|
-
dry_run?: boolean;
|
|
4028
|
-
dryRun?: boolean;
|
|
4029
|
-
output_format?: 'markdown' | 'json';
|
|
4030
|
-
outputFormat?: 'markdown' | 'json';
|
|
4031
|
-
}
|
|
4032
|
-
interface OpsCreateResult {
|
|
4033
|
-
success: boolean;
|
|
4034
|
-
op_id: string;
|
|
4035
|
-
opId?: string;
|
|
4036
|
-
routine_id?: string;
|
|
4037
|
-
routineId?: string;
|
|
4038
|
-
run_id?: string | null;
|
|
4039
|
-
runId?: string | null;
|
|
4040
|
-
status: SimpleOpStatus | string;
|
|
4041
|
-
phase: string;
|
|
4042
|
-
next_action: string;
|
|
4043
|
-
nextAction?: string;
|
|
4044
|
-
results_count: number;
|
|
4045
|
-
resultsCount?: number;
|
|
4046
|
-
results_url?: string;
|
|
4047
|
-
resultsUrl?: string;
|
|
4048
|
-
delivery_status?: string;
|
|
4049
|
-
deliveryStatus?: string;
|
|
4050
|
-
estimated_credits?: number;
|
|
4051
|
-
estimatedCredits?: number;
|
|
4052
|
-
error_code?: string;
|
|
4053
|
-
errorCode?: string;
|
|
4054
|
-
approval?: Record<string, unknown>;
|
|
4055
|
-
approval_required?: boolean;
|
|
4056
|
-
approvalRequired?: boolean;
|
|
4057
|
-
retry_arguments?: Record<string, unknown>;
|
|
4058
|
-
retryArguments?: Record<string, unknown>;
|
|
4059
|
-
blockers?: string[];
|
|
4060
|
-
plan?: OpsPlanResult;
|
|
4061
|
-
next_step?: Record<string, unknown>;
|
|
4062
|
-
nextStep?: Record<string, unknown>;
|
|
4063
|
-
next_steps?: Array<Record<string, unknown>>;
|
|
4064
|
-
nextSteps?: Array<Record<string, unknown>>;
|
|
4065
|
-
execution_refs?: ExecutionReference[];
|
|
4066
|
-
}
|
|
4067
|
-
interface OpsExecuteResult extends OpsCreateResult {
|
|
4068
|
-
error_code?: string;
|
|
4069
|
-
errorCode?: string;
|
|
4070
|
-
approval?: Record<string, unknown>;
|
|
4071
|
-
approval_required?: boolean;
|
|
4072
|
-
approvalRequired?: boolean;
|
|
4073
|
-
retry_arguments?: Record<string, unknown>;
|
|
4074
|
-
retryArguments?: Record<string, unknown>;
|
|
4075
|
-
next_step?: Record<string, unknown>;
|
|
4076
|
-
nextStep?: Record<string, unknown>;
|
|
4077
|
-
next_steps?: Array<Record<string, unknown>>;
|
|
4078
|
-
nextSteps?: Array<Record<string, unknown>>;
|
|
4079
|
-
blockers?: string[];
|
|
4080
|
-
}
|
|
4081
|
-
interface OpsRunOptions {
|
|
4082
|
-
op_id?: string;
|
|
4083
|
-
opId?: string;
|
|
4084
|
-
instruction?: string;
|
|
4085
|
-
force?: boolean;
|
|
4086
|
-
}
|
|
4087
|
-
interface OpsRunResult {
|
|
4088
|
-
success: boolean;
|
|
4089
|
-
op_id: string;
|
|
4090
|
-
opId?: string;
|
|
4091
|
-
routine_id?: string;
|
|
4092
|
-
routineId?: string;
|
|
4093
|
-
run_id?: string | null;
|
|
4094
|
-
runId?: string | null;
|
|
4095
|
-
status: SimpleOpStatus | string;
|
|
4096
|
-
phase: string;
|
|
4097
|
-
next_action: string;
|
|
4098
|
-
nextAction?: string;
|
|
4099
|
-
results_count?: number;
|
|
4100
|
-
resultsCount?: number;
|
|
4101
|
-
results_url?: string;
|
|
4102
|
-
resultsUrl?: string;
|
|
4103
|
-
delivery_status?: string;
|
|
4104
|
-
deliveryStatus?: string;
|
|
4105
|
-
execution_refs?: ExecutionReference[];
|
|
4106
|
-
}
|
|
4107
|
-
interface OpsStatusOptions {
|
|
4108
|
-
op_id?: string;
|
|
4109
|
-
opId?: string;
|
|
4110
|
-
}
|
|
4111
|
-
interface OpsStatusResult extends OpsRunResult {
|
|
4112
|
-
estimated_credits?: number | null;
|
|
4113
|
-
estimatedCredits?: number | null;
|
|
4114
|
-
latest_run?: Record<string, unknown> | null;
|
|
4115
|
-
latestRun?: Record<string, unknown> | null;
|
|
4116
|
-
diagnosis?: OpsDebugDiagnosis;
|
|
4117
|
-
}
|
|
4118
|
-
interface OpsResultsOptions {
|
|
4119
|
-
op_id?: string;
|
|
4120
|
-
opId?: string;
|
|
4121
|
-
limit?: number;
|
|
4122
|
-
cursor?: string;
|
|
4123
|
-
nextCursor?: string;
|
|
4124
|
-
state?: string;
|
|
4125
|
-
include_failed_runs?: boolean;
|
|
4126
|
-
includeFailedRuns?: boolean;
|
|
4127
|
-
}
|
|
4128
|
-
interface OpsResultsSummary {
|
|
4129
|
-
label?: string;
|
|
4130
|
-
status?: string;
|
|
4131
|
-
phase?: string;
|
|
4132
|
-
results_count?: number;
|
|
4133
|
-
resultsCount?: number;
|
|
4134
|
-
results_total?: number | null;
|
|
4135
|
-
resultsTotal?: number | null;
|
|
4136
|
-
delivery_status?: string;
|
|
4137
|
-
deliveryStatus?: string;
|
|
4138
|
-
has_more?: boolean;
|
|
4139
|
-
hasMore?: boolean;
|
|
4140
|
-
next_cursor?: string | null;
|
|
4141
|
-
nextCursor?: string | null;
|
|
4142
|
-
results_url?: string;
|
|
4143
|
-
resultsUrl?: string;
|
|
4144
|
-
next_action?: string;
|
|
4145
|
-
nextAction?: string;
|
|
4146
|
-
run_id?: string | null;
|
|
4147
|
-
runId?: string | null;
|
|
4148
|
-
credits_used?: number;
|
|
4149
|
-
creditsUsed?: number;
|
|
4150
|
-
[key: string]: unknown;
|
|
4151
|
-
}
|
|
4152
|
-
interface OpsResultsResult {
|
|
4153
|
-
success: boolean;
|
|
4154
|
-
op_id: string;
|
|
4155
|
-
opId?: string;
|
|
4156
|
-
routine_id?: string;
|
|
4157
|
-
routineId?: string;
|
|
4158
|
-
run_id?: string | null;
|
|
4159
|
-
runId?: string | null;
|
|
4160
|
-
status: SimpleOpStatus | string;
|
|
4161
|
-
phase: string;
|
|
4162
|
-
results_count: number;
|
|
4163
|
-
resultsCount?: number;
|
|
4164
|
-
results_total?: number | null;
|
|
4165
|
-
resultsTotal?: number | null;
|
|
4166
|
-
results: Array<Record<string, unknown>>;
|
|
4167
|
-
next_cursor?: string | null;
|
|
4168
|
-
nextCursor?: string | null;
|
|
4169
|
-
has_more: boolean;
|
|
4170
|
-
hasMore?: boolean;
|
|
4171
|
-
next_action: string;
|
|
4172
|
-
nextAction?: string;
|
|
4173
|
-
results_url?: string;
|
|
4174
|
-
resultsUrl?: string;
|
|
4175
|
-
delivery_status?: string;
|
|
4176
|
-
deliveryStatus?: string;
|
|
4177
|
-
summary?: OpsResultsSummary;
|
|
4178
|
-
execution_refs?: ExecutionReference[];
|
|
4179
|
-
}
|
|
4180
|
-
interface OpsWaitForResultsOptions extends OpsResultsOptions {
|
|
4181
|
-
interval_ms?: number;
|
|
4182
|
-
intervalMs?: number;
|
|
4183
|
-
max_polls?: number;
|
|
4184
|
-
maxPolls?: number;
|
|
4185
|
-
timeout_ms?: number;
|
|
4186
|
-
timeoutMs?: number;
|
|
4187
|
-
include_results?: boolean;
|
|
4188
|
-
includeResults?: boolean;
|
|
4189
|
-
}
|
|
4190
|
-
interface OpsWaitForResultsPoll {
|
|
4191
|
-
poll: number;
|
|
4192
|
-
checked_at: string;
|
|
4193
|
-
checkedAt?: string;
|
|
4194
|
-
status: string;
|
|
4195
|
-
phase?: string;
|
|
4196
|
-
results_count?: number;
|
|
4197
|
-
resultsCount?: number;
|
|
4198
|
-
run_id?: string | null;
|
|
4199
|
-
runId?: string | null;
|
|
4200
|
-
next_action?: string;
|
|
4201
|
-
nextAction?: string;
|
|
4202
|
-
}
|
|
4203
|
-
interface OpsWaitForResultsResult {
|
|
4204
|
-
success: boolean;
|
|
4205
|
-
op_id: string;
|
|
4206
|
-
opId?: string;
|
|
4207
|
-
routine_id?: string;
|
|
4208
|
-
routineId?: string;
|
|
4209
|
-
run_id?: string | null;
|
|
4210
|
-
runId?: string | null;
|
|
4211
|
-
status: OpsStatusResult;
|
|
4212
|
-
results?: OpsResultsResult;
|
|
4213
|
-
timed_out: boolean;
|
|
4214
|
-
timedOut?: boolean;
|
|
4215
|
-
polls: number;
|
|
4216
|
-
max_polls?: number;
|
|
4217
|
-
maxPolls?: number;
|
|
4218
|
-
interval_ms?: number;
|
|
4219
|
-
intervalMs?: number;
|
|
4220
|
-
timeout_ms?: number;
|
|
4221
|
-
timeoutMs?: number;
|
|
4222
|
-
stop_reason?: string;
|
|
4223
|
-
stopReason?: string;
|
|
4224
|
-
history: OpsWaitForResultsPoll[];
|
|
4225
|
-
next_action?: string;
|
|
4226
|
-
nextAction?: string;
|
|
4227
|
-
execution_refs?: ExecutionReference[];
|
|
4228
|
-
[key: string]: unknown;
|
|
4229
|
-
}
|
|
4230
|
-
interface OpsRunAndWaitOptions extends OpsRunOptions, Omit<OpsWaitForResultsOptions, 'op_id' | 'opId'> {
|
|
4231
|
-
}
|
|
4232
|
-
interface OpsRunAndWaitResult extends OpsWaitForResultsResult {
|
|
4233
|
-
run: OpsRunResult;
|
|
4234
|
-
execution_refs: ExecutionReference[];
|
|
4235
|
-
}
|
|
4236
|
-
interface OpsExecuteAndWaitOptions extends OpsExecuteRequest, Omit<OpsWaitForResultsOptions, 'op_id' | 'opId'> {
|
|
4237
|
-
}
|
|
4238
|
-
interface OpsExecuteAndWaitResult extends OpsWaitForResultsResult {
|
|
4239
|
-
execute: OpsExecuteResult;
|
|
4240
|
-
run_id?: string | null;
|
|
4241
|
-
runId?: string | null;
|
|
4242
|
-
execution_refs: ExecutionReference[];
|
|
4243
|
-
}
|
|
4244
|
-
interface OpsScheduleAndWaitOptions extends OpsCreateRequest, Omit<OpsRunAndWaitOptions, 'op_id' | 'opId'> {
|
|
4245
|
-
}
|
|
4246
|
-
interface OpsScheduleAndWaitResult extends OpsRunAndWaitResult {
|
|
4247
|
-
schedule: OpsCreateResult;
|
|
4248
|
-
run_id?: string | null;
|
|
4249
|
-
runId?: string | null;
|
|
4250
|
-
execution_refs: ExecutionReference[];
|
|
4251
|
-
}
|
|
4252
|
-
interface OpsTriggerRunStatus {
|
|
4253
|
-
success: boolean;
|
|
4254
|
-
run_id: string;
|
|
4255
|
-
runId?: string;
|
|
4256
|
-
status: string;
|
|
4257
|
-
output?: unknown;
|
|
4258
|
-
error?: unknown;
|
|
4259
|
-
costInCents?: number;
|
|
4260
|
-
baseCostInCents?: number;
|
|
4261
|
-
durationMs?: number;
|
|
4262
|
-
_note?: string;
|
|
4263
|
-
diagnosis?: OpsDebugDiagnosis;
|
|
4264
|
-
execution_refs?: ExecutionReference[];
|
|
4265
|
-
}
|
|
4266
|
-
interface OpsTriggerBatchRunStatus {
|
|
4267
|
-
success: boolean;
|
|
4268
|
-
runs: OpsTriggerRunStatus[];
|
|
4269
|
-
}
|
|
4270
|
-
type OpsTriggerRunStatusOptions = {
|
|
4271
|
-
run_id: string;
|
|
4272
|
-
runId?: never;
|
|
4273
|
-
run_ids?: never;
|
|
4274
|
-
runIds?: never;
|
|
4275
|
-
} | {
|
|
4276
|
-
runId: string;
|
|
4277
|
-
run_id?: never;
|
|
4278
|
-
run_ids?: never;
|
|
4279
|
-
runIds?: never;
|
|
4280
|
-
} | {
|
|
4281
|
-
run_ids: string[];
|
|
4282
|
-
run_id?: never;
|
|
4283
|
-
runId?: never;
|
|
4284
|
-
runIds?: never;
|
|
4285
|
-
} | {
|
|
4286
|
-
runIds: string[];
|
|
4287
|
-
run_id?: never;
|
|
4288
|
-
runId?: never;
|
|
4289
|
-
run_ids?: never;
|
|
4290
|
-
};
|
|
4291
|
-
interface OpsQueueStatusOptions {
|
|
4292
|
-
job_id?: string;
|
|
4293
|
-
jobId?: string;
|
|
4294
|
-
idempotency_key?: string;
|
|
4295
|
-
idempotencyKey?: string;
|
|
4296
|
-
summary?: boolean;
|
|
4297
|
-
}
|
|
4298
|
-
interface OpsQueueStatus {
|
|
4299
|
-
success: boolean;
|
|
4300
|
-
producer_envelope?: OpsQueueProducerEnvelope;
|
|
4301
|
-
producerEnvelope?: OpsQueueProducerEnvelope;
|
|
4302
|
-
queue?: {
|
|
4303
|
-
pending?: number;
|
|
4304
|
-
processing?: number;
|
|
4305
|
-
};
|
|
4306
|
-
summary?: {
|
|
4307
|
-
queue?: {
|
|
4308
|
-
pending?: number;
|
|
4309
|
-
processing?: number;
|
|
4310
|
-
completed_last_hour?: number;
|
|
4311
|
-
completedLastHour?: number;
|
|
4312
|
-
failed_last_hour?: number;
|
|
4313
|
-
failedLastHour?: number;
|
|
4314
|
-
pending_by_function?: Record<string, number>;
|
|
4315
|
-
pendingByFunction?: Record<string, number>;
|
|
4316
|
-
};
|
|
4317
|
-
providers?: Record<string, unknown>;
|
|
4318
|
-
provider_stats?: Record<string, unknown>;
|
|
4319
|
-
providerStats?: Record<string, unknown>;
|
|
4320
|
-
redis_status?: Record<string, unknown>;
|
|
4321
|
-
redisStatus?: Record<string, unknown>;
|
|
4322
|
-
recent_events?: Array<Record<string, unknown>>;
|
|
4323
|
-
recentEvents?: Array<Record<string, unknown>>;
|
|
4324
|
-
};
|
|
4325
|
-
job?: {
|
|
4326
|
-
id?: string;
|
|
4327
|
-
jobId?: string;
|
|
4328
|
-
status?: string;
|
|
4329
|
-
function_name?: string;
|
|
4330
|
-
functionName?: string;
|
|
4331
|
-
estimated_wait_ms?: number;
|
|
4332
|
-
estimatedWaitMs?: number;
|
|
4333
|
-
error_message?: string;
|
|
4334
|
-
errorMessage?: string;
|
|
4335
|
-
[key: string]: unknown;
|
|
4336
|
-
};
|
|
4337
|
-
error?: string;
|
|
4338
|
-
diagnosis?: OpsDebugDiagnosis;
|
|
4339
|
-
execution_refs?: ExecutionReference[];
|
|
4340
|
-
}
|
|
4341
|
-
interface OpsQueueProducerEnvelope {
|
|
4342
|
-
schema_version?: string;
|
|
4343
|
-
schemaVersion?: string;
|
|
4344
|
-
producer?: string;
|
|
4345
|
-
queue_name?: string;
|
|
4346
|
-
queueName?: string;
|
|
4347
|
-
status_source?: string;
|
|
4348
|
-
statusSource?: string;
|
|
4349
|
-
idempotency_key?: string | null;
|
|
4350
|
-
idempotencyKey?: string | null;
|
|
4351
|
-
job_id?: string | null;
|
|
4352
|
-
jobId?: string | null;
|
|
4353
|
-
summary_requested?: boolean;
|
|
4354
|
-
summaryRequested?: boolean;
|
|
4355
|
-
retry_after_ms?: number;
|
|
4356
|
-
retryAfterMs?: number;
|
|
4357
|
-
poll_after_seconds?: number;
|
|
4358
|
-
pollAfterSeconds?: number;
|
|
4359
|
-
emitted_at?: string;
|
|
4360
|
-
emittedAt?: string;
|
|
4361
|
-
[key: string]: unknown;
|
|
4362
|
-
}
|
|
4363
|
-
interface OpsReplayResult {
|
|
4364
|
-
success: boolean;
|
|
4365
|
-
replay_run_id: string;
|
|
4366
|
-
replayRunId?: string;
|
|
4367
|
-
original_run_id: string;
|
|
4368
|
-
originalRunId?: string;
|
|
4369
|
-
start_from_node: number;
|
|
4370
|
-
startFromNode?: number;
|
|
4371
|
-
total_nodes: number;
|
|
4372
|
-
totalNodes?: number;
|
|
4373
|
-
diagnosis?: OpsDebugDiagnosis;
|
|
4374
|
-
execution_refs?: ExecutionReference[];
|
|
4375
|
-
}
|
|
4376
|
-
interface OpsDashboardOptions {
|
|
4377
|
-
section?: 'summary' | 'functions' | 'workspaces' | 'timeseries' | 'sources' | 'recent';
|
|
4378
|
-
timeRangeDays?: number;
|
|
4379
|
-
granularity?: 'hour' | 'day' | 'week' | 'month';
|
|
4380
|
-
limit?: number;
|
|
4381
|
-
}
|
|
4382
|
-
interface OpsDashboardResult {
|
|
4383
|
-
today_executions?: number;
|
|
4384
|
-
todayExecutions?: number;
|
|
4385
|
-
today_credits?: number;
|
|
4386
|
-
todayCredits?: number;
|
|
4387
|
-
month_executions?: number;
|
|
4388
|
-
monthExecutions?: number;
|
|
4389
|
-
month_credits?: number;
|
|
4390
|
-
monthCredits?: number;
|
|
4391
|
-
avg_execution_time_ms?: number;
|
|
4392
|
-
avgExecutionTimeMs?: number;
|
|
4393
|
-
[key: string]: unknown;
|
|
4394
|
-
}
|
|
4395
|
-
interface OpsDebugOptions {
|
|
4396
|
-
op_id?: string;
|
|
4397
|
-
opId?: string;
|
|
4398
|
-
include_results?: boolean;
|
|
4399
|
-
includeResults?: boolean;
|
|
4400
|
-
results_limit?: number;
|
|
4401
|
-
resultsLimit?: number;
|
|
4402
|
-
include_queue?: boolean;
|
|
4403
|
-
includeQueue?: boolean;
|
|
4404
|
-
include_dashboard?: boolean;
|
|
4405
|
-
includeDashboard?: boolean;
|
|
4406
|
-
dashboard_limit?: number;
|
|
4407
|
-
dashboardLimit?: number;
|
|
4408
|
-
time_range_days?: number;
|
|
4409
|
-
timeRangeDays?: number;
|
|
4410
|
-
}
|
|
4411
|
-
interface OpsDebugDiagnosticError {
|
|
4412
|
-
step: string;
|
|
4413
|
-
message: string;
|
|
4414
|
-
}
|
|
4415
|
-
interface OpsDebugDiagnosis {
|
|
4416
|
-
state: 'healthy' | 'running' | 'failed' | 'degraded' | 'unknown';
|
|
4417
|
-
retryable: boolean;
|
|
4418
|
-
queue_pending: number;
|
|
4419
|
-
queuePending?: number;
|
|
4420
|
-
queue_processing: number;
|
|
4421
|
-
queueProcessing?: number;
|
|
4422
|
-
queue_failed_last_hour: number;
|
|
4423
|
-
queueFailedLastHour?: number;
|
|
4424
|
-
provider_pressure: 'none' | 'low' | 'medium' | 'high';
|
|
4425
|
-
providerPressure?: 'none' | 'low' | 'medium' | 'high';
|
|
4426
|
-
failed_run_count: number;
|
|
4427
|
-
failedRunCount?: number;
|
|
4428
|
-
primary_error?: string;
|
|
4429
|
-
primaryError?: string;
|
|
4430
|
-
summary: string;
|
|
4431
|
-
}
|
|
4432
|
-
interface OpsDebugResult {
|
|
4433
|
-
success: boolean;
|
|
4434
|
-
op_id: string;
|
|
4435
|
-
opId?: string;
|
|
4436
|
-
checked_at: string;
|
|
4437
|
-
checkedAt?: string;
|
|
4438
|
-
diagnosis: OpsDebugDiagnosis;
|
|
4439
|
-
status: OpsStatusResult;
|
|
4440
|
-
execution_refs: ExecutionReference[];
|
|
4441
|
-
executionRefs?: ExecutionReference[];
|
|
4442
|
-
run_statuses: OpsTriggerRunStatus[];
|
|
4443
|
-
runStatuses?: OpsTriggerRunStatus[];
|
|
4444
|
-
queue?: OpsQueueStatus;
|
|
4445
|
-
dashboard_recent?: unknown;
|
|
4446
|
-
dashboardRecent?: unknown;
|
|
4447
|
-
results?: OpsResultsResult;
|
|
4448
|
-
replay_candidates: ExecutionReference[];
|
|
4449
|
-
replayCandidates?: ExecutionReference[];
|
|
4450
|
-
next_actions: string[];
|
|
4451
|
-
nextActions?: string[];
|
|
4452
|
-
diagnostic_errors: OpsDebugDiagnosticError[];
|
|
4453
|
-
diagnosticErrors?: OpsDebugDiagnosticError[];
|
|
4454
|
-
}
|
|
4455
|
-
interface OpsQuickstartStep {
|
|
4456
|
-
step: number;
|
|
4457
|
-
tool?: string;
|
|
4458
|
-
action?: string;
|
|
4459
|
-
arguments?: Record<string, unknown>;
|
|
4460
|
-
description: string;
|
|
4461
|
-
primitive_id?: string;
|
|
4462
|
-
primitiveId?: string;
|
|
4463
|
-
primitive_version?: string;
|
|
4464
|
-
primitiveVersion?: string;
|
|
4465
|
-
}
|
|
4466
|
-
interface OpsQuickstartWorkflow {
|
|
4467
|
-
workflow_type: string;
|
|
4468
|
-
workflowType?: string;
|
|
4469
|
-
requested_workflow_type?: string;
|
|
4470
|
-
requestedWorkflowType?: string;
|
|
4471
|
-
name: string;
|
|
4472
|
-
description: string;
|
|
4473
|
-
credits_required: number;
|
|
4474
|
-
creditsRequired?: number;
|
|
4475
|
-
steps: OpsQuickstartStep[];
|
|
4476
|
-
primitive_graph?: OpsPrimitive[];
|
|
4477
|
-
primitiveGraph?: OpsPrimitive[];
|
|
4478
|
-
available_types: string[];
|
|
4479
|
-
availableTypes?: string[];
|
|
4480
|
-
}
|
|
4481
|
-
type OpsNangoConnectSessionCreateInput = GtmNangoConnectSessionCreateInput;
|
|
4482
|
-
type OpsNangoIntegrationFlowPrepareInput = GtmNangoIntegrationFlowPrepareInput;
|
|
4483
|
-
type OpsNangoToolsListOptions = GtmNangoToolsListOptions;
|
|
4484
|
-
type OpsNangoToolCallInput = GtmNangoToolCallInput;
|
|
4485
|
-
interface OpsNangoReadWriteProofOptions extends OpsNangoToolsListOptions {
|
|
4486
|
-
limit?: number;
|
|
4487
|
-
readProxyPath?: string;
|
|
4488
|
-
writeProxyPath?: string;
|
|
4489
|
-
method?: string;
|
|
4490
|
-
executeReadProbe?: boolean;
|
|
4491
|
-
executeWriteProbe?: boolean;
|
|
4492
|
-
confirm?: boolean;
|
|
4493
|
-
confirmWrite?: boolean;
|
|
4494
|
-
input?: Record<string, unknown>;
|
|
4495
|
-
writeInput?: Record<string, unknown>;
|
|
4496
|
-
}
|
|
4497
|
-
type OpsNangoActionResultGetInput = GtmNangoActionResultGetInput;
|
|
4498
|
-
interface OpsNangoToolCallAndWaitInput extends OpsNangoToolCallInput {
|
|
4499
|
-
intervalMs?: number;
|
|
4500
|
-
maxPolls?: number;
|
|
4501
|
-
timeoutMs?: number;
|
|
4502
|
-
}
|
|
4503
|
-
interface OpsNangoToolCallAndWaitResult {
|
|
4504
|
-
success?: boolean;
|
|
4505
|
-
call: unknown;
|
|
4506
|
-
result?: unknown;
|
|
4507
|
-
status?: string;
|
|
4508
|
-
action_id?: string;
|
|
4509
|
-
actionId?: string;
|
|
4510
|
-
status_url?: string;
|
|
4511
|
-
statusUrl?: string;
|
|
4512
|
-
polls: number;
|
|
4513
|
-
max_polls: number;
|
|
4514
|
-
maxPolls: number;
|
|
4515
|
-
interval_ms: number;
|
|
4516
|
-
intervalMs: number;
|
|
4517
|
-
timeout_ms: number;
|
|
4518
|
-
timeoutMs: number;
|
|
4519
|
-
timed_out: boolean;
|
|
4520
|
-
timedOut: boolean;
|
|
4521
|
-
}
|
|
4522
|
-
interface OpsNangoDestinationInput {
|
|
4523
|
-
workspaceConnectionId?: string;
|
|
4524
|
-
workspace_connection_id?: string;
|
|
4525
|
-
connectionId?: string;
|
|
4526
|
-
connection_id?: string;
|
|
4527
|
-
providerConfigKey?: string;
|
|
4528
|
-
provider_config_key?: string;
|
|
4529
|
-
integrationId?: string;
|
|
4530
|
-
integration_id?: string;
|
|
4531
|
-
nangoConnectionId?: string;
|
|
4532
|
-
nango_connection_id?: string;
|
|
4533
|
-
actionName?: string;
|
|
4534
|
-
action_name?: string;
|
|
4535
|
-
toolName?: string;
|
|
4536
|
-
tool_name?: string;
|
|
4537
|
-
proxyPath?: string;
|
|
4538
|
-
proxy_path?: string;
|
|
4539
|
-
nangoProxyPath?: string;
|
|
4540
|
-
nango_proxy_path?: string;
|
|
4541
|
-
method?: string;
|
|
4542
|
-
httpMethod?: string;
|
|
4543
|
-
http_method?: string;
|
|
4544
|
-
input?: Record<string, unknown>;
|
|
4545
|
-
arguments?: Record<string, unknown>;
|
|
4546
|
-
fieldMap?: Record<string, unknown>;
|
|
4547
|
-
field_map?: Record<string, unknown>;
|
|
4548
|
-
requiredFields?: string[];
|
|
4549
|
-
required_fields?: string[];
|
|
4550
|
-
writeConfirmed?: boolean;
|
|
4551
|
-
write_confirmed?: boolean;
|
|
4552
|
-
agentWriteConfirmed?: boolean;
|
|
4553
|
-
agent_write_confirmed?: boolean;
|
|
4554
|
-
config?: Record<string, unknown>;
|
|
4555
|
-
}
|
|
4556
|
-
interface OpsNangoScheduleOptions extends Omit<OpsCreateRequest, 'destinations'>, OpsNangoDestinationInput {
|
|
4557
|
-
destinations?: Array<Record<string, unknown>>;
|
|
4558
|
-
}
|
|
4559
|
-
interface OpsNangoScheduleAndWaitOptions extends Omit<OpsScheduleAndWaitOptions, 'destinations'>, OpsNangoDestinationInput {
|
|
4560
|
-
destinations?: Array<Record<string, unknown>>;
|
|
4561
|
-
}
|
|
4562
|
-
declare class Ops {
|
|
4563
|
-
private client;
|
|
4564
|
-
constructor(client: HttpClient);
|
|
4565
|
-
plan(params: OpsPlanRequest | string): Promise<OpsPlanResult>;
|
|
4566
|
-
autopilot(params?: OpsAutopilotOptions): Promise<OpsAutopilotResult>;
|
|
4567
|
-
create(params: OpsCreateRequest | string): Promise<OpsCreateResult>;
|
|
4568
|
-
schedule(params: OpsCreateRequest | string): Promise<OpsCreateResult>;
|
|
4569
|
-
scheduleAndWait(params: OpsScheduleAndWaitOptions | string): Promise<OpsScheduleAndWaitResult>;
|
|
4570
|
-
/** Schedule a recurring Op that delivers through a customer-owned Nango API connection. */
|
|
4571
|
-
scheduleNangoAction(input: OpsNangoScheduleOptions): Promise<OpsCreateResult>;
|
|
4572
|
-
/** Schedule a recurring Nango-backed Op, run the first tick, and return result readback. */
|
|
4573
|
-
scheduleNangoActionAndWait(input: OpsNangoScheduleAndWaitOptions): Promise<OpsScheduleAndWaitResult>;
|
|
4574
|
-
execute(params: OpsExecuteRequest | string): Promise<OpsExecuteResult>;
|
|
4575
|
-
executeAndWait(params: OpsExecuteAndWaitOptions | string): Promise<OpsExecuteAndWaitResult>;
|
|
4576
|
-
run(params: OpsRunOptions | string): Promise<OpsRunResult>;
|
|
4577
|
-
runAndWait(params: OpsRunAndWaitOptions | string): Promise<OpsRunAndWaitResult>;
|
|
4578
|
-
status(params: OpsStatusOptions | string): Promise<OpsStatusResult>;
|
|
4579
|
-
results(params: OpsResultsOptions | string): Promise<OpsResultsResult>;
|
|
4580
|
-
waitForResults(params: OpsWaitForResultsOptions | string): Promise<OpsWaitForResultsResult>;
|
|
4581
|
-
/** Create a short-lived Nango Connect session from the Ops namespace. */
|
|
4582
|
-
createNangoConnectSession(input: OpsNangoConnectSessionCreateInput): Promise<any>;
|
|
4583
|
-
/** Prepare the full Nango provider search, connect, pull/export, Ops, and route flow. */
|
|
4584
|
-
prepareNangoIntegrationFlow(input?: OpsNangoIntegrationFlowPrepareInput): Promise<any>;
|
|
4585
|
-
/** List Nango-backed action tools for a workspace connection without executing them. */
|
|
4586
|
-
listNangoTools(options?: OpsNangoToolsListOptions): Promise<any>;
|
|
4587
|
-
/** Audit connected Nango rows, action/proxy readiness, and read/write proof gaps. */
|
|
4588
|
-
proveNangoReadWrite(options?: OpsNangoReadWriteProofOptions): Promise<any>;
|
|
4589
|
-
/** Dry-run or execute a Nango-backed action tool through the approval-aware MCP bridge. */
|
|
4590
|
-
callNangoTool(input: OpsNangoToolCallInput): Promise<any>;
|
|
4591
|
-
/** Execute a Nango action and poll its async result when a status URL/action id is returned. */
|
|
4592
|
-
callNangoToolAndWait(input: OpsNangoToolCallAndWaitInput): Promise<OpsNangoToolCallAndWaitResult>;
|
|
4593
|
-
/** Poll an async Nango action result by action id or status URL. */
|
|
4594
|
-
getNangoActionResult(input: OpsNangoActionResultGetInput): Promise<any>;
|
|
4595
|
-
proof(params?: OpsProofOptions): Promise<OpsProofResult>;
|
|
4596
|
-
debug(params: OpsDebugOptions | string): Promise<OpsDebugResult>;
|
|
4597
|
-
quickstartWorkflow(workflowType?: string): Promise<OpsQuickstartWorkflow>;
|
|
4598
|
-
approve(params: OpsApproveRequest): Promise<OpsApproveResult>;
|
|
4599
|
-
createRoutine(params: CreateRoutineRequest): Promise<OpsRoutine>;
|
|
4600
|
-
listRoutines(params?: {
|
|
4601
|
-
status?: OpsRoutineStatus;
|
|
4602
|
-
limit?: number;
|
|
4603
|
-
cursor?: string;
|
|
4604
|
-
}): Promise<OpsRoutinesResult>;
|
|
4605
|
-
getRoutine(routineId: string): Promise<OpsRoutine>;
|
|
4606
|
-
updateRoutine(params: UpdateRoutineRequest): Promise<OpsRoutine>;
|
|
4607
|
-
runRoutineNow(params: RunRoutineRequest | string): Promise<OpsRoutineRunResult>;
|
|
4608
|
-
deleteRoutine(routineId: string, permanent?: boolean): Promise<OpsRoutineDeleteResult>;
|
|
4609
|
-
listOutputSinks(params?: ListOutputSinksOptions): Promise<OpsSink[]>;
|
|
4610
|
-
getReadiness(params?: OpsReadinessOptions): Promise<OpsReadinessResult>;
|
|
4611
|
-
doctor(params?: OpsReadinessOptions): Promise<OpsReadinessResult>;
|
|
4612
|
-
createOutputSink(params: CreateOutputSinkRequest): Promise<OpsSink>;
|
|
4613
|
-
attachSinkToRoutine(params: {
|
|
4614
|
-
routine_id?: string;
|
|
4615
|
-
routineId?: string;
|
|
4616
|
-
sink_id?: string;
|
|
4617
|
-
sinkId?: string;
|
|
4618
|
-
}): Promise<OpsRoutineSinkResult>;
|
|
4619
|
-
getRoutineTicks(params: {
|
|
4620
|
-
routine_id?: string;
|
|
4621
|
-
routineId?: string;
|
|
4622
|
-
limit?: number;
|
|
4623
|
-
cursor?: string;
|
|
4624
|
-
}): Promise<OpsRoutineTicksResult>;
|
|
4625
|
-
getLastTickItems(params: {
|
|
4626
|
-
routine_id?: string;
|
|
4627
|
-
routineId?: string;
|
|
4628
|
-
limit?: number;
|
|
4629
|
-
cursor?: string;
|
|
4630
|
-
state?: string;
|
|
4631
|
-
}): Promise<OpsRoutineTickItemsResult>;
|
|
4632
|
-
getTriggerRunStatus(params: OpsTriggerRunStatusOptions | string): Promise<OpsTriggerRunStatus | OpsTriggerBatchRunStatus>;
|
|
4633
|
-
getQueueStatus(params?: OpsQueueStatusOptions): Promise<OpsQueueStatus>;
|
|
4634
|
-
replayFromCheckpoint(executionEventId: string): Promise<OpsReplayResult>;
|
|
4635
|
-
normalizeExecutionReference(input: string | ExecutionReferenceInput): ExecutionReference;
|
|
4636
|
-
collectExecutionReferences(payload: Record<string, unknown>): ExecutionReference[];
|
|
4637
|
-
getDashboard(params?: OpsDashboardOptions): Promise<OpsDashboardResult>;
|
|
4638
|
-
private call;
|
|
4639
|
-
}
|
|
4640
|
-
|
|
4641
|
-
declare class Ai {
|
|
4642
|
-
private client;
|
|
4643
|
-
constructor(client: HttpClient);
|
|
4644
|
-
/**
|
|
4645
|
-
* Run Custom AI Enrichment - Multi Model.
|
|
4646
|
-
*
|
|
4647
|
-
* Uses the hosted default model with bounded synthesis, then returns the
|
|
4648
|
-
* requested structured output fields.
|
|
4649
|
-
*/
|
|
4650
|
-
multiModel(params: CustomAiMultiModelParams): Promise<CustomAiMultiModelResult>;
|
|
4651
|
-
/**
|
|
4652
|
-
* Plan or run experimental AI Enrichment Fusion with explicit spend controls.
|
|
4653
|
-
*/
|
|
4654
|
-
fusion(params: AiEnrichmentFusionParams): Promise<AiEnrichmentFusionResult>;
|
|
4655
|
-
}
|
|
4656
|
-
|
|
4657
|
-
interface PublicGroundTruthSearchParams {
|
|
4658
|
-
query?: string;
|
|
4659
|
-
search?: string;
|
|
4660
|
-
industry?: string;
|
|
4661
|
-
location?: string;
|
|
4662
|
-
sourceId?: string;
|
|
4663
|
-
source_id?: string;
|
|
4664
|
-
entityType?: string;
|
|
4665
|
-
entity_type?: string;
|
|
4666
|
-
nativeId?: string;
|
|
4667
|
-
native_id?: string;
|
|
4668
|
-
entityName?: string;
|
|
4669
|
-
entity_name?: string;
|
|
4670
|
-
domain?: string;
|
|
4671
|
-
websiteUrl?: string;
|
|
4672
|
-
website_url?: string;
|
|
4673
|
-
phone?: string;
|
|
4674
|
-
email?: string;
|
|
4675
|
-
city?: string;
|
|
4676
|
-
state?: string;
|
|
4677
|
-
postalCode?: string;
|
|
4678
|
-
postal_code?: string;
|
|
4679
|
-
country?: string;
|
|
4680
|
-
sourceUrl?: string;
|
|
4681
|
-
source_url?: string;
|
|
4682
|
-
joinKeys?: Record<string, unknown>;
|
|
4683
|
-
join_keys?: Record<string, unknown>;
|
|
4684
|
-
rowData?: Record<string, unknown>;
|
|
4685
|
-
row_data?: Record<string, unknown>;
|
|
4686
|
-
naics?: string;
|
|
4687
|
-
industryCode?: string;
|
|
4688
|
-
industry_code?: string;
|
|
4689
|
-
industryType?: string;
|
|
4690
|
-
industry_type?: string;
|
|
4691
|
-
year?: string;
|
|
4692
|
-
quarter?: string;
|
|
4693
|
-
areaFips?: string;
|
|
4694
|
-
area_fips?: string;
|
|
4695
|
-
geoId?: string;
|
|
4696
|
-
geo_id?: string;
|
|
4697
|
-
ownCode?: string;
|
|
4698
|
-
own_code?: string;
|
|
4699
|
-
sourceUpdatedAfter?: string;
|
|
4700
|
-
source_updated_after?: string;
|
|
4701
|
-
sourceUpdatedBefore?: string;
|
|
4702
|
-
source_updated_before?: string;
|
|
4703
|
-
observedAfter?: string;
|
|
4704
|
-
observed_after?: string;
|
|
4705
|
-
observedBefore?: string;
|
|
4706
|
-
observed_before?: string;
|
|
4707
|
-
limit?: number;
|
|
4708
|
-
offset?: number;
|
|
4709
|
-
}
|
|
4710
|
-
interface PublicGroundTruthRecord {
|
|
4711
|
-
id: string;
|
|
4712
|
-
source_id: string;
|
|
4713
|
-
source_name: string;
|
|
4714
|
-
native_id: string;
|
|
4715
|
-
entity_type: string;
|
|
4716
|
-
entity_name: string;
|
|
4717
|
-
domain: string | null;
|
|
4718
|
-
website_url?: string | null;
|
|
4719
|
-
phone?: string | null;
|
|
4720
|
-
email?: string | null;
|
|
4721
|
-
city: string | null;
|
|
4722
|
-
state: string | null;
|
|
4723
|
-
postal_code?: string | null;
|
|
4724
|
-
country?: string | null;
|
|
4725
|
-
industry_code?: string | null;
|
|
4726
|
-
industry_name?: string | null;
|
|
4727
|
-
join_keys: Record<string, unknown>;
|
|
4728
|
-
row_data: Record<string, unknown>;
|
|
4729
|
-
source_url?: string | null;
|
|
4730
|
-
source_updated_at?: string | null;
|
|
4731
|
-
observed_at?: string | null;
|
|
4732
|
-
rank: number;
|
|
4733
|
-
match_type: string;
|
|
4734
|
-
}
|
|
4735
|
-
interface PublicGroundTruthResolvedIndustry {
|
|
4736
|
-
code_system: string;
|
|
4737
|
-
code: string;
|
|
4738
|
-
title: string;
|
|
4739
|
-
rank: number;
|
|
4740
|
-
match_type: string;
|
|
4741
|
-
}
|
|
4742
|
-
interface PublicGroundTruthSearchResult {
|
|
4743
|
-
success: boolean;
|
|
4744
|
-
query: string;
|
|
4745
|
-
source_id: string | null;
|
|
4746
|
-
entity_type: string | null;
|
|
4747
|
-
filters?: Record<string, unknown>;
|
|
4748
|
-
limit: number;
|
|
4749
|
-
offset: number;
|
|
4750
|
-
total_count: number;
|
|
4751
|
-
returned_count: number;
|
|
4752
|
-
next_offset: number | null;
|
|
4753
|
-
resolved_industries?: PublicGroundTruthResolvedIndustry[];
|
|
4754
|
-
records: PublicGroundTruthRecord[];
|
|
4755
|
-
searchable_fields?: string[];
|
|
4756
|
-
filterable_fields?: string[];
|
|
4757
|
-
credits_charged?: number;
|
|
4758
|
-
}
|
|
4759
|
-
interface PublicGroundTruthSourcesParams {
|
|
4760
|
-
query?: string;
|
|
4761
|
-
search?: string;
|
|
4762
|
-
status?: string;
|
|
4763
|
-
limit?: number;
|
|
4764
|
-
}
|
|
4765
|
-
interface PublicGroundTruthSource {
|
|
4766
|
-
id: string;
|
|
4767
|
-
name: string;
|
|
4768
|
-
authority: string;
|
|
4769
|
-
source_url: string;
|
|
4770
|
-
bulk_url: string | null;
|
|
4771
|
-
access_mode: string;
|
|
4772
|
-
ground_truth_rung: number;
|
|
4773
|
-
join_key_quality: string;
|
|
4774
|
-
primary_join_key: string | null;
|
|
4775
|
-
join_keys: string[];
|
|
4776
|
-
entity_types: string[];
|
|
4777
|
-
free_bulk_access: boolean;
|
|
4778
|
-
update_cadence: string;
|
|
4779
|
-
commercial_use_status: string;
|
|
4780
|
-
ingestion_status: string;
|
|
4781
|
-
last_attempted_at: string | null;
|
|
4782
|
-
last_successful_snapshot_id: string | null;
|
|
4783
|
-
metadata: Record<string, unknown>;
|
|
4784
|
-
updated_at: string | null;
|
|
4785
|
-
}
|
|
4786
|
-
interface PublicGroundTruthSourcesResult {
|
|
4787
|
-
success: boolean;
|
|
4788
|
-
query: string;
|
|
4789
|
-
status: string | null;
|
|
4790
|
-
total: number;
|
|
4791
|
-
returned_count: number;
|
|
4792
|
-
sources: PublicGroundTruthSource[];
|
|
4793
|
-
credits_charged?: number;
|
|
4794
|
-
}
|
|
4795
|
-
declare class PublicGroundTruth {
|
|
4796
|
-
private client;
|
|
4797
|
-
constructor(client: HttpClient);
|
|
4798
|
-
/**
|
|
4799
|
-
* Search the public-ground-truth cache by company/name/domain/native ID,
|
|
4800
|
-
* or by plain-language industry + location.
|
|
4801
|
-
* Results use the same snake_case wire shape returned by the hosted MCP API.
|
|
4802
|
-
*/
|
|
4803
|
-
search(params: PublicGroundTruthSearchParams): Promise<PublicGroundTruthSearchResult>;
|
|
4804
|
-
/**
|
|
4805
|
-
* List available public-ground-truth cache sources and their join-key metadata.
|
|
4806
|
-
*/
|
|
4807
|
-
listSources(params?: PublicGroundTruthSourcesParams): Promise<PublicGroundTruthSourcesResult>;
|
|
4808
|
-
}
|
|
4809
|
-
|
|
4810
|
-
declare class SignalizError extends Error {
|
|
4811
|
-
readonly code: string;
|
|
4812
|
-
readonly errorType: ErrorType;
|
|
4813
|
-
readonly retryAfter?: number;
|
|
4814
|
-
readonly details?: Record<string, unknown>;
|
|
4815
|
-
constructor(data: SignalizErrorData);
|
|
4816
|
-
get isRetryable(): boolean;
|
|
152
|
+
declare class SignalizError extends Error {
|
|
153
|
+
readonly code: string;
|
|
154
|
+
readonly errorType: ErrorType;
|
|
155
|
+
readonly retryAfter?: number;
|
|
156
|
+
readonly details?: Record<string, unknown>;
|
|
157
|
+
constructor(data: SignalizErrorData);
|
|
158
|
+
get isRetryable(): boolean;
|
|
4817
159
|
}
|
|
4818
160
|
|
|
4819
161
|
declare class Signaliz {
|
|
4820
|
-
readonly
|
|
4821
|
-
readonly signals: Signals;
|
|
4822
|
-
readonly systems: Systems;
|
|
4823
|
-
readonly runs: Runs;
|
|
4824
|
-
readonly http: Http;
|
|
4825
|
-
readonly campaigns: Campaigns;
|
|
4826
|
-
readonly campaignBuilderAgent: CampaignBuilderAgent;
|
|
4827
|
-
readonly icps: Icps;
|
|
4828
|
-
readonly leads: Leads;
|
|
4829
|
-
readonly ops: Ops;
|
|
4830
|
-
readonly ai: Ai;
|
|
4831
|
-
readonly gtm: GtmKernel;
|
|
4832
|
-
readonly publicGroundTruth: PublicGroundTruth;
|
|
4833
|
-
private client;
|
|
4834
|
-
private toolListCache?;
|
|
162
|
+
private readonly client;
|
|
4835
163
|
constructor(config: SignalizConfig);
|
|
4836
|
-
|
|
4837
|
-
|
|
4838
|
-
|
|
4839
|
-
|
|
4840
|
-
|
|
4841
|
-
|
|
4842
|
-
|
|
164
|
+
findEmail(params: FindEmailParams): Promise<FindEmailResult>;
|
|
165
|
+
findEmails(params: FindEmailParams[], options?: BatchOptions): Promise<BatchResult<FindEmailResult>>;
|
|
166
|
+
verifyEmail(email: string): Promise<VerifyEmailResult>;
|
|
167
|
+
verifyEmails(emails: string[], options?: BatchOptions): Promise<BatchResult<VerifyEmailResult>>;
|
|
168
|
+
enrichCompanySignals(params: CompanySignalEnrichmentParams): Promise<CompanySignalEnrichmentResult>;
|
|
169
|
+
enrichCompanies(companies: CompanySignalEnrichmentParams[], options?: BatchOptions): Promise<BatchResult<CompanySignalEnrichmentResult>>;
|
|
170
|
+
signalToCopy(params: SignalToCopyParams): Promise<SignalToCopyResult>;
|
|
171
|
+
createSignalCopyBatch(requests: SignalToCopyParams[], options?: BatchOptions): Promise<BatchResult<SignalToCopyResult>>;
|
|
4843
172
|
listTools(): Promise<MCPToolInfo[]>;
|
|
4844
|
-
|
|
4845
|
-
/** Discover tools by natural language query */
|
|
4846
|
-
discover(query: string, category?: string): Promise<MCPToolInfo[]>;
|
|
173
|
+
health(): Promise<PlatformHealth>;
|
|
4847
174
|
}
|
|
4848
175
|
|
|
4849
|
-
export {
|
|
176
|
+
export { type BatchItemResult, type BatchOptions, type BatchResult, type CompanySignal, type CompanySignalEnrichmentParams, type CompanySignalEnrichmentResult, type ErrorType, type FindEmailParams, type FindEmailResult, type MCPToolInfo, type PlatformHealth, type SignalToCopyParams, type SignalToCopyResult, type SignalToCopyVariation, Signaliz, type SignalizConfig, SignalizError, type SignalizErrorData, type VerifyEmailResult };
|