@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.
Files changed (39) hide show
  1. package/README.md +1 -1
  2. package/dist/command-families/program.js +0 -4
  3. package/dist/command-manifest.js +0 -2
  4. package/dist/commands/budget.js +9 -4
  5. package/dist/commands/companies.js +1 -1
  6. package/dist/commands/publishing.js +16 -7
  7. package/dist/commands/sequences.js +9 -1
  8. package/dist/commands/workflows.js +1 -1
  9. package/node_modules/@oxygen/shared/dist/access/permissions.d.ts +1 -1
  10. package/node_modules/@oxygen/shared/dist/access/permissions.js +1 -1
  11. package/node_modules/@oxygen/shared/dist/billing/budget-scopes.d.ts +2 -2
  12. package/node_modules/@oxygen/shared/dist/billing/budget-scopes.js +2 -2
  13. package/node_modules/@oxygen/shared/dist/billing/plan-capabilities.js +1 -1
  14. package/node_modules/@oxygen/shared/dist/capability-intents/index.generated.d.ts +0 -40
  15. package/node_modules/@oxygen/shared/dist/capability-intents/tables.d.ts +0 -20
  16. package/node_modules/@oxygen/shared/dist/capability-intents/tables.js +0 -3
  17. package/node_modules/@oxygen/shared/dist/capability-intents/tables.rules.js +6 -41
  18. package/node_modules/@oxygen/shared/dist/capability-routes/tables.js +3 -3
  19. package/node_modules/@oxygen/shared/dist/contracts/browser-operations.js +1 -0
  20. package/node_modules/@oxygen/shared/dist/contracts/geo.js +2 -2
  21. package/node_modules/@oxygen/shared/dist/copilot/plan-hold.d.ts +1 -0
  22. package/node_modules/@oxygen/shared/dist/copilot/plan-hold.js +5 -2
  23. package/node_modules/@oxygen/shared/dist/geo/geo.d.ts +168 -2
  24. package/node_modules/@oxygen/shared/dist/geo/geo.js +357 -70
  25. package/node_modules/@oxygen/shared/dist/onboarding-leads.js +9 -3
  26. package/node_modules/@oxygen/shared/dist/schedule-label.js +29 -1
  27. package/node_modules/@oxygen/shared/dist/sequences/enrollment-origin.d.ts +3 -1
  28. package/node_modules/@oxygen/shared/dist/sequences/enrollment-origin.js +2 -0
  29. package/node_modules/@oxygen/shared/dist/version.d.ts +1 -1
  30. package/node_modules/@oxygen/shared/dist/version.generated.d.ts +1 -1
  31. package/node_modules/@oxygen/shared/dist/version.generated.js +1 -1
  32. package/node_modules/@oxygen/shared/dist/version.js +1 -1
  33. package/package.json +1 -1
  34. package/dist/commands/callables.d.ts +0 -3
  35. package/dist/commands/callables.js +0 -111
  36. package/dist/functions-commands.d.ts +0 -6
  37. package/dist/functions-commands.js +0 -85
  38. package/node_modules/@oxygen/shared/dist/contracts/function-library-read.d.ts +0 -14
  39. 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
- category: "owned" | "competitor" | "community" | "review" | "editorial" | "other";
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
- export declare function analyzeGeoAnswer(text: string, brand: GeoCompetitor, competitors: GeoCompetitor[], urls: string[]): {
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
  }[];