@oxygen-agent/cli 1.1023.41 → 1.1024.24
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 +1 -1
- package/dist/command-families/program.js +0 -4
- package/dist/command-manifest.js +0 -2
- package/dist/commands/budget.js +9 -4
- package/dist/commands/companies.js +1 -1
- package/dist/commands/publishing.js +16 -7
- package/dist/commands/sequences.js +9 -1
- package/dist/commands/workflows.js +1 -1
- package/node_modules/@oxygen/shared/dist/access/permissions.d.ts +1 -1
- package/node_modules/@oxygen/shared/dist/access/permissions.js +1 -1
- package/node_modules/@oxygen/shared/dist/billing/budget-scopes.d.ts +2 -2
- package/node_modules/@oxygen/shared/dist/billing/budget-scopes.js +2 -2
- package/node_modules/@oxygen/shared/dist/billing/plan-capabilities.js +1 -1
- package/node_modules/@oxygen/shared/dist/capability-intents/index.generated.d.ts +0 -40
- package/node_modules/@oxygen/shared/dist/capability-intents/tables.d.ts +0 -20
- package/node_modules/@oxygen/shared/dist/capability-intents/tables.js +0 -3
- package/node_modules/@oxygen/shared/dist/capability-intents/tables.rules.js +6 -41
- package/node_modules/@oxygen/shared/dist/capability-routes/tables.js +3 -3
- package/node_modules/@oxygen/shared/dist/contracts/browser-operations.js +1 -0
- package/node_modules/@oxygen/shared/dist/contracts/geo.js +2 -2
- package/node_modules/@oxygen/shared/dist/copilot/plan-hold.d.ts +1 -0
- package/node_modules/@oxygen/shared/dist/copilot/plan-hold.js +5 -2
- package/node_modules/@oxygen/shared/dist/geo/geo.d.ts +168 -2
- package/node_modules/@oxygen/shared/dist/geo/geo.js +357 -70
- package/node_modules/@oxygen/shared/dist/onboarding-leads.js +9 -3
- package/node_modules/@oxygen/shared/dist/schedule-label.js +29 -1
- package/node_modules/@oxygen/shared/dist/sequences/enrollment-origin.d.ts +3 -1
- package/node_modules/@oxygen/shared/dist/sequences/enrollment-origin.js +2 -0
- package/node_modules/@oxygen/shared/dist/version.d.ts +1 -1
- package/node_modules/@oxygen/shared/dist/version.generated.d.ts +1 -1
- package/node_modules/@oxygen/shared/dist/version.generated.js +1 -1
- package/node_modules/@oxygen/shared/dist/version.js +1 -1
- package/package.json +1 -1
- package/dist/commands/callables.d.ts +0 -3
- package/dist/commands/callables.js +0 -111
- package/dist/functions-commands.d.ts +0 -6
- package/dist/functions-commands.js +0 -85
- package/node_modules/@oxygen/shared/dist/contracts/function-library-read.d.ts +0 -14
- package/node_modules/@oxygen/shared/dist/contracts/function-library-read.js +0 -16
|
@@ -30,17 +30,30 @@ export type GeoPrompt = {
|
|
|
30
30
|
enabled: boolean;
|
|
31
31
|
revision: number;
|
|
32
32
|
};
|
|
33
|
+
/** Raises when extraction rules change; older stored answers are re-derived on read. */
|
|
34
|
+
export declare const GEO_EXTRACTION_VERSION = 3;
|
|
35
|
+
export declare const GEO_DOMAIN_TYPES: readonly ["owned", "competitor", "corporate", "editorial", "institutional", "ugc", "reference", "other"];
|
|
36
|
+
export type GeoDomainType = (typeof GEO_DOMAIN_TYPES)[number];
|
|
37
|
+
export declare const GEO_PAGE_TYPES: readonly ["homepage", "category", "product", "listicle", "comparison", "profile", "alternative", "discussion", "how_to", "article", "other"];
|
|
38
|
+
export type GeoPageType = (typeof GEO_PAGE_TYPES)[number];
|
|
33
39
|
export type GeoCitation = {
|
|
34
40
|
url: string;
|
|
35
41
|
domain: string;
|
|
42
|
+
/** Order in the answer's source list; inline-only links follow it. */
|
|
36
43
|
position: number;
|
|
37
|
-
|
|
44
|
+
/** Domain type. Version 1 answers stored "community"/"review"; they are re-derived on read. */
|
|
45
|
+
category: GeoDomainType;
|
|
46
|
+
page_type: GeoPageType;
|
|
47
|
+
/** The answer text links or numbers this URL; otherwise it was only retrieved (source card, reference list). */
|
|
48
|
+
cited_inline: boolean;
|
|
38
49
|
};
|
|
39
50
|
export type GeoMention = {
|
|
40
51
|
brand: string;
|
|
41
52
|
present: boolean;
|
|
42
53
|
evidence: string | null;
|
|
43
54
|
recommendation_rank: number | null;
|
|
55
|
+
/** 1-based order of first mention among detected tracked brands; ties share a position. */
|
|
56
|
+
position: number | null;
|
|
44
57
|
};
|
|
45
58
|
export type GeoMeasurement = {
|
|
46
59
|
brand: GeoCompetitor;
|
|
@@ -65,6 +78,8 @@ export type GeoAnswer = {
|
|
|
65
78
|
cost_micros: number;
|
|
66
79
|
raw: unknown;
|
|
67
80
|
extraction_version: number;
|
|
81
|
+
/** Set when an older stored answer was re-derived on read; the stored document is unchanged. */
|
|
82
|
+
derived_from_version?: number;
|
|
68
83
|
measurement?: GeoMeasurement;
|
|
69
84
|
cost_basis?: "reported" | "reserved_estimate";
|
|
70
85
|
prompt_revision?: number;
|
|
@@ -112,11 +127,37 @@ export declare const GEO_PILOT_CAP_MICROS = 10000000;
|
|
|
112
127
|
export declare function isGeoEnabled(env?: NodeJS.ProcessEnv): boolean;
|
|
113
128
|
export declare function assertGeoEnabled(env?: NodeJS.ProcessEnv): void;
|
|
114
129
|
export declare function geoDomain(value: string): string | null;
|
|
115
|
-
|
|
130
|
+
/** Normalized citation identity: no fragment or click-tracking parameters. */
|
|
131
|
+
export declare function normalizeGeoUrl(raw: string): {
|
|
132
|
+
url: string;
|
|
133
|
+
domain: string;
|
|
134
|
+
} | null;
|
|
135
|
+
/** URLs the answer prose links inline (markdown targets or bare URLs), normalized. */
|
|
136
|
+
export declare function geoInlineUrls(text: string): string[];
|
|
137
|
+
/** Images, favicons and thumbnails an engine renders beside an answer: never a source. */
|
|
138
|
+
export declare function isGeoAssetUrl(raw: string): boolean;
|
|
139
|
+
/**
|
|
140
|
+
* Domain type: owned/competitor from the capture-time definition, then curated
|
|
141
|
+
* rules, then the TLD. Review platforms are editorial (moderated third-party
|
|
142
|
+
* publications); their product pages are page type "profile".
|
|
143
|
+
*/
|
|
144
|
+
export declare function geoDomainType(domain: string, brand: GeoCompetitor | null, competitors?: GeoCompetitor[]): GeoDomainType;
|
|
145
|
+
/** Page type from the URL alone; the first matching rule wins. */
|
|
146
|
+
export declare function geoPageType(raw: string, domainType: GeoDomainType): GeoPageType;
|
|
147
|
+
export declare function analyzeGeoAnswer(text: string, brand: GeoCompetitor, competitors: GeoCompetitor[], urls: string[], citedUrls?: string[]): {
|
|
116
148
|
mentions: GeoMention[];
|
|
117
149
|
citations: GeoCitation[];
|
|
118
150
|
measurement: GeoMeasurement;
|
|
119
151
|
};
|
|
152
|
+
/**
|
|
153
|
+
* Re-derives mentions and citations of an answer extracted by an earlier version
|
|
154
|
+
* from its stored text and supplier sources, using the capture-time definition.
|
|
155
|
+
* It never calls a supplier and never rewrites the stored document.
|
|
156
|
+
*/
|
|
157
|
+
export declare function upgradeGeoAnswer(answer: GeoAnswer, sources?: {
|
|
158
|
+
urls: string[];
|
|
159
|
+
cited_urls: string[];
|
|
160
|
+
} | null): GeoAnswer;
|
|
120
161
|
/** Exact capture-time configuration, canonicalized for matched comparisons. */
|
|
121
162
|
export declare function geoMeasurementKey(answer: Pick<GeoAnswer, "measurement">): string;
|
|
122
163
|
/** A scraper's question heading is not answer prose, including old stored captures. */
|
|
@@ -131,19 +172,44 @@ export declare function summarizeGeoAnswers(answers: GeoAnswer[], brand: string,
|
|
|
131
172
|
no_overview_samples: number;
|
|
132
173
|
mentioned_samples: number;
|
|
133
174
|
visibility: number | null;
|
|
175
|
+
position_samples: number;
|
|
176
|
+
average_position: number | null;
|
|
177
|
+
won_samples: number;
|
|
178
|
+
win_rate: number | null;
|
|
179
|
+
/** Owned domain among the answer's sources (retrieved or cited). */
|
|
134
180
|
cited_samples: number;
|
|
135
181
|
citation_coverage: number | null;
|
|
182
|
+
owned_cited_samples: number;
|
|
183
|
+
owned_cited_rate: number | null;
|
|
136
184
|
share_of_voice: number | null;
|
|
137
185
|
competitors: {
|
|
138
186
|
name: string;
|
|
139
187
|
mentioned_samples: number;
|
|
140
188
|
share_of_voice: number | null;
|
|
189
|
+
position_samples: number;
|
|
190
|
+
average_position: number | null;
|
|
191
|
+
won_samples: number;
|
|
192
|
+
win_rate: number | null;
|
|
193
|
+
retrieved_samples: number;
|
|
194
|
+
retrieved_rate: number | null;
|
|
195
|
+
cited_samples: number;
|
|
196
|
+
cited_rate: number | null;
|
|
141
197
|
}[];
|
|
142
198
|
sources: {
|
|
143
199
|
domain: string;
|
|
144
200
|
count: number;
|
|
145
201
|
category: string;
|
|
146
202
|
urls: string[];
|
|
203
|
+
retrieved_samples: number;
|
|
204
|
+
retrieved_rate: number | null;
|
|
205
|
+
cited_samples: number;
|
|
206
|
+
cited_rate: number | null;
|
|
207
|
+
pages: {
|
|
208
|
+
url: string;
|
|
209
|
+
page_type: string;
|
|
210
|
+
retrieved_samples: number;
|
|
211
|
+
cited_samples: number;
|
|
212
|
+
}[];
|
|
147
213
|
}[];
|
|
148
214
|
};
|
|
149
215
|
/** No fetching or execution: customer wording and citations are evidence only. */
|
|
@@ -167,19 +233,44 @@ export declare function compareGeoExperiment(before: GeoAnswer[], after: GeoAnsw
|
|
|
167
233
|
no_overview_samples: number;
|
|
168
234
|
mentioned_samples: number;
|
|
169
235
|
visibility: number | null;
|
|
236
|
+
position_samples: number;
|
|
237
|
+
average_position: number | null;
|
|
238
|
+
won_samples: number;
|
|
239
|
+
win_rate: number | null;
|
|
240
|
+
/** Owned domain among the answer's sources (retrieved or cited). */
|
|
170
241
|
cited_samples: number;
|
|
171
242
|
citation_coverage: number | null;
|
|
243
|
+
owned_cited_samples: number;
|
|
244
|
+
owned_cited_rate: number | null;
|
|
172
245
|
share_of_voice: number | null;
|
|
173
246
|
competitors: {
|
|
174
247
|
name: string;
|
|
175
248
|
mentioned_samples: number;
|
|
176
249
|
share_of_voice: number | null;
|
|
250
|
+
position_samples: number;
|
|
251
|
+
average_position: number | null;
|
|
252
|
+
won_samples: number;
|
|
253
|
+
win_rate: number | null;
|
|
254
|
+
retrieved_samples: number;
|
|
255
|
+
retrieved_rate: number | null;
|
|
256
|
+
cited_samples: number;
|
|
257
|
+
cited_rate: number | null;
|
|
177
258
|
}[];
|
|
178
259
|
sources: {
|
|
179
260
|
domain: string;
|
|
180
261
|
count: number;
|
|
181
262
|
category: string;
|
|
182
263
|
urls: string[];
|
|
264
|
+
retrieved_samples: number;
|
|
265
|
+
retrieved_rate: number | null;
|
|
266
|
+
cited_samples: number;
|
|
267
|
+
cited_rate: number | null;
|
|
268
|
+
pages: {
|
|
269
|
+
url: string;
|
|
270
|
+
page_type: string;
|
|
271
|
+
retrieved_samples: number;
|
|
272
|
+
cited_samples: number;
|
|
273
|
+
}[];
|
|
183
274
|
}[];
|
|
184
275
|
};
|
|
185
276
|
after: {
|
|
@@ -191,19 +282,44 @@ export declare function compareGeoExperiment(before: GeoAnswer[], after: GeoAnsw
|
|
|
191
282
|
no_overview_samples: number;
|
|
192
283
|
mentioned_samples: number;
|
|
193
284
|
visibility: number | null;
|
|
285
|
+
position_samples: number;
|
|
286
|
+
average_position: number | null;
|
|
287
|
+
won_samples: number;
|
|
288
|
+
win_rate: number | null;
|
|
289
|
+
/** Owned domain among the answer's sources (retrieved or cited). */
|
|
194
290
|
cited_samples: number;
|
|
195
291
|
citation_coverage: number | null;
|
|
292
|
+
owned_cited_samples: number;
|
|
293
|
+
owned_cited_rate: number | null;
|
|
196
294
|
share_of_voice: number | null;
|
|
197
295
|
competitors: {
|
|
198
296
|
name: string;
|
|
199
297
|
mentioned_samples: number;
|
|
200
298
|
share_of_voice: number | null;
|
|
299
|
+
position_samples: number;
|
|
300
|
+
average_position: number | null;
|
|
301
|
+
won_samples: number;
|
|
302
|
+
win_rate: number | null;
|
|
303
|
+
retrieved_samples: number;
|
|
304
|
+
retrieved_rate: number | null;
|
|
305
|
+
cited_samples: number;
|
|
306
|
+
cited_rate: number | null;
|
|
201
307
|
}[];
|
|
202
308
|
sources: {
|
|
203
309
|
domain: string;
|
|
204
310
|
count: number;
|
|
205
311
|
category: string;
|
|
206
312
|
urls: string[];
|
|
313
|
+
retrieved_samples: number;
|
|
314
|
+
retrieved_rate: number | null;
|
|
315
|
+
cited_samples: number;
|
|
316
|
+
cited_rate: number | null;
|
|
317
|
+
pages: {
|
|
318
|
+
url: string;
|
|
319
|
+
page_type: string;
|
|
320
|
+
retrieved_samples: number;
|
|
321
|
+
cited_samples: number;
|
|
322
|
+
}[];
|
|
207
323
|
}[];
|
|
208
324
|
};
|
|
209
325
|
comparable_cohorts: number;
|
|
@@ -220,19 +336,44 @@ export declare function compareGeoExperiment(before: GeoAnswer[], after: GeoAnsw
|
|
|
220
336
|
no_overview_samples: number;
|
|
221
337
|
mentioned_samples: number;
|
|
222
338
|
visibility: number | null;
|
|
339
|
+
position_samples: number;
|
|
340
|
+
average_position: number | null;
|
|
341
|
+
won_samples: number;
|
|
342
|
+
win_rate: number | null;
|
|
343
|
+
/** Owned domain among the answer's sources (retrieved or cited). */
|
|
223
344
|
cited_samples: number;
|
|
224
345
|
citation_coverage: number | null;
|
|
346
|
+
owned_cited_samples: number;
|
|
347
|
+
owned_cited_rate: number | null;
|
|
225
348
|
share_of_voice: number | null;
|
|
226
349
|
competitors: {
|
|
227
350
|
name: string;
|
|
228
351
|
mentioned_samples: number;
|
|
229
352
|
share_of_voice: number | null;
|
|
353
|
+
position_samples: number;
|
|
354
|
+
average_position: number | null;
|
|
355
|
+
won_samples: number;
|
|
356
|
+
win_rate: number | null;
|
|
357
|
+
retrieved_samples: number;
|
|
358
|
+
retrieved_rate: number | null;
|
|
359
|
+
cited_samples: number;
|
|
360
|
+
cited_rate: number | null;
|
|
230
361
|
}[];
|
|
231
362
|
sources: {
|
|
232
363
|
domain: string;
|
|
233
364
|
count: number;
|
|
234
365
|
category: string;
|
|
235
366
|
urls: string[];
|
|
367
|
+
retrieved_samples: number;
|
|
368
|
+
retrieved_rate: number | null;
|
|
369
|
+
cited_samples: number;
|
|
370
|
+
cited_rate: number | null;
|
|
371
|
+
pages: {
|
|
372
|
+
url: string;
|
|
373
|
+
page_type: string;
|
|
374
|
+
retrieved_samples: number;
|
|
375
|
+
cited_samples: number;
|
|
376
|
+
}[];
|
|
236
377
|
}[];
|
|
237
378
|
};
|
|
238
379
|
after: {
|
|
@@ -244,19 +385,44 @@ export declare function compareGeoExperiment(before: GeoAnswer[], after: GeoAnsw
|
|
|
244
385
|
no_overview_samples: number;
|
|
245
386
|
mentioned_samples: number;
|
|
246
387
|
visibility: number | null;
|
|
388
|
+
position_samples: number;
|
|
389
|
+
average_position: number | null;
|
|
390
|
+
won_samples: number;
|
|
391
|
+
win_rate: number | null;
|
|
392
|
+
/** Owned domain among the answer's sources (retrieved or cited). */
|
|
247
393
|
cited_samples: number;
|
|
248
394
|
citation_coverage: number | null;
|
|
395
|
+
owned_cited_samples: number;
|
|
396
|
+
owned_cited_rate: number | null;
|
|
249
397
|
share_of_voice: number | null;
|
|
250
398
|
competitors: {
|
|
251
399
|
name: string;
|
|
252
400
|
mentioned_samples: number;
|
|
253
401
|
share_of_voice: number | null;
|
|
402
|
+
position_samples: number;
|
|
403
|
+
average_position: number | null;
|
|
404
|
+
won_samples: number;
|
|
405
|
+
win_rate: number | null;
|
|
406
|
+
retrieved_samples: number;
|
|
407
|
+
retrieved_rate: number | null;
|
|
408
|
+
cited_samples: number;
|
|
409
|
+
cited_rate: number | null;
|
|
254
410
|
}[];
|
|
255
411
|
sources: {
|
|
256
412
|
domain: string;
|
|
257
413
|
count: number;
|
|
258
414
|
category: string;
|
|
259
415
|
urls: string[];
|
|
416
|
+
retrieved_samples: number;
|
|
417
|
+
retrieved_rate: number | null;
|
|
418
|
+
cited_samples: number;
|
|
419
|
+
cited_rate: number | null;
|
|
420
|
+
pages: {
|
|
421
|
+
url: string;
|
|
422
|
+
page_type: string;
|
|
423
|
+
retrieved_samples: number;
|
|
424
|
+
cited_samples: number;
|
|
425
|
+
}[];
|
|
260
426
|
}[];
|
|
261
427
|
};
|
|
262
428
|
}[];
|