@oxygen-agent/cli 1.1022.49 → 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 (62) hide show
  1. package/README.md +1 -1
  2. package/dist/command-families/program.js +0 -4
  3. package/dist/command-families/tables/register-views.js +3 -3
  4. package/dist/command-manifest.js +0 -2
  5. package/dist/commands/approvals.js +1 -1
  6. package/dist/commands/budget.js +9 -4
  7. package/dist/commands/companies.js +1 -1
  8. package/dist/commands/members.js +1 -1
  9. package/dist/commands/orgs.js +1 -1
  10. package/dist/commands/publishing.js +25 -16
  11. package/dist/commands/sequences.js +15 -1
  12. package/dist/commands/workflows.js +1 -1
  13. package/node_modules/@oxygen/shared/dist/access/permissions.d.ts +1 -1
  14. package/node_modules/@oxygen/shared/dist/access/permissions.js +1 -1
  15. package/node_modules/@oxygen/shared/dist/access/roles.d.ts +21 -8
  16. package/node_modules/@oxygen/shared/dist/access/roles.js +53 -16
  17. package/node_modules/@oxygen/shared/dist/billing/budget-scopes.d.ts +2 -2
  18. package/node_modules/@oxygen/shared/dist/billing/budget-scopes.js +2 -2
  19. package/node_modules/@oxygen/shared/dist/billing/plan-capabilities.js +1 -1
  20. package/node_modules/@oxygen/shared/dist/capability-intents/index.generated.d.ts +0 -40
  21. package/node_modules/@oxygen/shared/dist/capability-intents/tables.d.ts +0 -20
  22. package/node_modules/@oxygen/shared/dist/capability-intents/tables.js +0 -3
  23. package/node_modules/@oxygen/shared/dist/capability-intents/tables.rules.js +6 -41
  24. package/node_modules/@oxygen/shared/dist/capability-routes/geo.js +1 -1
  25. package/node_modules/@oxygen/shared/dist/capability-routes/tables.js +3 -3
  26. package/node_modules/@oxygen/shared/dist/contracts/browser-operations.js +1 -0
  27. package/node_modules/@oxygen/shared/dist/contracts/customer-operations.js +1 -1
  28. package/node_modules/@oxygen/shared/dist/contracts/geo.js +6 -6
  29. package/node_modules/@oxygen/shared/dist/copilot/plan-hold.d.ts +1 -0
  30. package/node_modules/@oxygen/shared/dist/copilot/plan-hold.js +5 -2
  31. package/node_modules/@oxygen/shared/dist/geo/geo.d.ts +168 -2
  32. package/node_modules/@oxygen/shared/dist/geo/geo.js +358 -71
  33. package/node_modules/@oxygen/shared/dist/onboarding-leads.js +9 -3
  34. package/node_modules/@oxygen/shared/dist/publishing/limits.d.ts +7 -0
  35. package/node_modules/@oxygen/shared/dist/publishing/limits.js +7 -0
  36. package/node_modules/@oxygen/shared/dist/schedule-label.js +29 -1
  37. package/node_modules/@oxygen/shared/dist/sequences/enrollment-origin.d.ts +3 -1
  38. package/node_modules/@oxygen/shared/dist/sequences/enrollment-origin.js +2 -0
  39. package/node_modules/@oxygen/shared/dist/social-capabilities.js +5 -3
  40. package/node_modules/@oxygen/shared/dist/tables/column-output-fields.js +12 -0
  41. package/node_modules/@oxygen/shared/dist/version.d.ts +1 -1
  42. package/node_modules/@oxygen/shared/dist/version.generated.d.ts +1 -1
  43. package/node_modules/@oxygen/shared/dist/version.generated.js +1 -1
  44. package/node_modules/@oxygen/shared/dist/version.js +1 -1
  45. package/node_modules/@oxygen/workflows/dist/graph/diff.d.ts +2 -0
  46. package/node_modules/@oxygen/workflows/dist/graph/diff.js +3 -0
  47. package/node_modules/@oxygen/workflows/dist/graph/index.d.ts +1 -0
  48. package/node_modules/@oxygen/workflows/dist/graph/index.js +1 -0
  49. package/node_modules/@oxygen/workflows/dist/graph/lint.js +44 -1
  50. package/node_modules/@oxygen/workflows/dist/graph/manifest-schema.d.ts +62 -0
  51. package/node_modules/@oxygen/workflows/dist/graph/manifest-schema.js +22 -0
  52. package/node_modules/@oxygen/workflows/dist/graph/output.d.ts +36 -0
  53. package/node_modules/@oxygen/workflows/dist/graph/output.js +111 -0
  54. package/node_modules/@oxygen/workflows/dist/graph/types.d.ts +19 -0
  55. package/node_modules/@oxygen/workflows/dist/graph/types.js +8 -0
  56. package/package.json +1 -1
  57. package/dist/commands/callables.d.ts +0 -3
  58. package/dist/commands/callables.js +0 -111
  59. package/dist/functions-commands.d.ts +0 -6
  60. package/dist/functions-commands.js +0 -85
  61. package/node_modules/@oxygen/shared/dist/contracts/function-library-read.d.ts +0 -14
  62. package/node_modules/@oxygen/shared/dist/contracts/function-library-read.js +0 -16
@@ -111,26 +111,6 @@ export declare const CAPABILITY_ROUTE_MCP_CALL_GROUPS: readonly [{
111
111
  };
112
112
  };
113
113
  }, {
114
- functionsList: () => {
115
- tool: string;
116
- arguments: {
117
- operation: string;
118
- };
119
- };
120
- functionsDescribe: () => {
121
- tool: string;
122
- arguments: {
123
- operation: string;
124
- function: string;
125
- };
126
- };
127
- functionsRuns: () => {
128
- tool: string;
129
- arguments: {
130
- operation: string;
131
- function: string;
132
- };
133
- };
134
114
  companyPageFollowers: () => {
135
115
  tool: string;
136
116
  arguments: {
@@ -267,26 +247,6 @@ export declare const CAPABILITY_ROUTE_MCP_CALLS: {
267
247
  };
268
248
  };
269
249
  };
270
- functionsList: () => {
271
- tool: string;
272
- arguments: {
273
- operation: string;
274
- };
275
- };
276
- functionsDescribe: () => {
277
- tool: string;
278
- arguments: {
279
- operation: string;
280
- function: string;
281
- };
282
- };
283
- functionsRuns: () => {
284
- tool: string;
285
- arguments: {
286
- operation: string;
287
- function: string;
288
- };
289
- };
290
250
  companyPageFollowers: () => {
291
251
  tool: string;
292
252
  arguments: {
@@ -1,25 +1,5 @@
1
1
  /** This card's exact commands as MCP calls (see CAPABILITY_ROUTE_MCP_CALLS). */
2
2
  export declare const mcpCalls: {
3
- functionsList: () => {
4
- tool: string;
5
- arguments: {
6
- operation: string;
7
- };
8
- };
9
- functionsDescribe: () => {
10
- tool: string;
11
- arguments: {
12
- operation: string;
13
- function: string;
14
- };
15
- };
16
- functionsRuns: () => {
17
- tool: string;
18
- arguments: {
19
- operation: string;
20
- function: string;
21
- };
22
- };
23
3
  companyPageFollowers: () => {
24
4
  tool: string;
25
5
  arguments: {
@@ -3,9 +3,6 @@ import { isOwnLinkedInNetworkIntent } from "./connected-linkedin.js";
3
3
  import { isNetNewLinkedInInitiation } from "./sequences.js";
4
4
  /** This card's exact commands as MCP calls (see CAPABILITY_ROUTE_MCP_CALLS). */
5
5
  export const mcpCalls = {
6
- functionsList: () => ({ tool: "oxygen_callables_manage", arguments: { operation: "list_functions" } }),
7
- functionsDescribe: () => ({ tool: "oxygen_callables_manage", arguments: { operation: "describe", function: "<function>" } }),
8
- functionsRuns: () => ({ tool: "oxygen_callables_manage", arguments: { operation: "runs", function: "<function>" } }),
9
6
  // `records` is a number the tool drops when it is not one; 1000 is its default.
10
7
  companyPageFollowers: () => ({
11
8
  tool: "oxygen_tables_followers",
@@ -105,47 +105,12 @@ export const rules = {
105
105
  recommend: (card, query) => {
106
106
  if (card.primitive !== "tables" || !isFunctionIntent(query))
107
107
  return null;
108
- if (/\b(?:list|show|read|see|my)\b.{0,30}\bfavou?rites?\b/.test(query))
109
- return {
110
- tools: ["oxygen_callables_manage"], commands: ["functions list", "functions describe"],
111
- exactMcpCall: { tool: "oxygen_callables_manage", arguments: { operation: "list_functions", filter: "favorites" } },
112
- };
113
- if (/\b(runs|invocations?|history)\b/.test(query))
114
- return {
115
- tools: ["oxygen_callables_manage"], commands: ["functions runs", "functions describe"],
116
- exactMcpCall: mcpCalls.functionsRuns(),
117
- };
118
- const functionMutation = [
119
- [/\b(publish)\b/, "functions publish"],
120
- [/\b(bind|attach)\b/, "functions bind"],
121
- [/\b(rename)\b/, "functions rename"],
122
- [/\b(delete|remove)\b/, "functions delete"],
123
- [/\b(duplicate|copy)\b/, "functions duplicate"],
124
- [/\b(unfavorite|unfavourite)\b/, "functions unfavorite"],
125
- [/\b(favorite|favourite)\b/, "functions favorite"],
126
- [/\b(enable|disable)\b/, /\bdisable\b/.test(query) ? "functions disable" : "functions enable"],
127
- [/\b(create|save|edit)\b/, "functions draft"],
128
- ];
129
- const mutation = functionMutation.find(([pattern]) => pattern.test(query));
130
- if (mutation)
131
- return {
132
- tools: ["oxygen_callables_manage"],
133
- commands: [/\bcreate\b/.test(query) ? "functions list" : "functions describe", mutation[1]],
134
- exactMcpCall: /\bcreate\b/.test(query) ? mcpCalls.functionsList() : mcpCalls.functionsDescribe(),
135
- };
136
- if (/\b(run|execute|invoke)\b/.test(query))
137
- return {
138
- tools: ["oxygen_callables_manage", "oxygen_columns_run"], commands: ["functions describe", "columns run"],
139
- exactMcpCall: mcpCalls.functionsDescribe(),
140
- };
141
- if (/\b(describe|inspect|inputs?|outputs?|steps?|caps?|version|details?)\b/.test(query))
142
- return {
143
- tools: ["oxygen_callables_manage"], commands: ["functions describe", "functions runs"],
144
- exactMcpCall: mcpCalls.functionsDescribe(),
145
- };
108
+ // Functions were replaced by Workflow columns (2026-10-31): a reusable
109
+ // per-row capability is a Workflow that a Table column calls.
146
110
  return {
147
- tools: ["oxygen_callables_manage"], commands: ["functions list", "functions describe"],
148
- exactMcpCall: { ...mcpCalls.functionsList(), ...(/\b(favorites|favourites)\b/.test(query) ? { arguments: { operation: "list_functions", filter: "favorites" } } : {}) },
111
+ tools: ["oxygen_workflows_list", "oxygen_columns_add"],
112
+ commands: ["workflows list", "columns add"],
113
+ exactMcpCall: { tool: "oxygen_workflows_list", arguments: {} },
149
114
  };
150
115
  },
151
116
  },
@@ -291,7 +256,7 @@ export const rules = {
291
256
  view: (card, query) => card.primitive === "tables" && isFunctionIntent(query) ? {
292
257
  card: {
293
258
  ...card,
294
- execution: "List, describe or inspect Function runs without executing. Draft edits are isolated; publish requires the inspected draft hash and changes future invocations. Bind adds a caller column for free; columns run previews cost before a bounded approved run. External MCP uses oxygen_capabilities_read for oxygen_callables_manage operation=list/list_functions/describe/runs; other operations use oxygen_capabilities_call. Built-in agents invoke the native tool under their existing policy.",
259
+ execution: "Functions were replaced by Workflow columns. Build the reusable steps as a hosted workflow with an api trigger and a declared output (AI prompt and Web research steps run like AI columns), then add a Workflow column with columns add --kind tool and definition mode workflow; columns run previews cost before a bounded paid run.",
295
260
  },
296
261
  } : null,
297
262
  },
@@ -2,7 +2,7 @@ export const route = {
2
2
  order: 100,
3
3
  card: {
4
4
  id: "geo", layer: "Data", primitive: "geo", posture: "mixed",
5
- owns: "GEO / AEO AI-search tracking: buyer prompts, consumer answers, citations, competitive visibility, customer chat evidence and optimization experiments. Experimental staff/dev access.",
5
+ owns: "SEO / GEO AI-search tracking: buyer prompts, consumer answers, citations, competitive visibility, customer chat evidence and optimization experiments. Experimental staff/dev access.",
6
6
  notFor: "Direct model API benchmarks, automatic public edits, autonomous publishing or personalized chat attribution.",
7
7
  execution: "Staff in dev workspaces only. Preview consumer collection and cost, start within the $10 shared pilot cap, inspect answers and citations, then record reviewed changes and compare later samples. Reads never collect or spend.",
8
8
  gatewayTools: ["oxygen_geo_projects_list", "oxygen_geo_engines_list", "oxygen_geo_analytics_get", "oxygen_geo_runs_preview"],
@@ -8,10 +8,10 @@ export const route = {
8
8
  notFor: "Canonical CRM truth: use Records via oxygen_crm_objects_list, oxygen_crm_record_get or oxygen_crm_record_search. Not message cadence or an off-platform spreadsheet runtime.",
9
9
  execution: "Create and run work in hosted OXYGEN Tables; validate a small sample before bounded paid runs. To see what a table's own columns can be enriched with and what each costs per row before adding anything, run `tools search --for-table <table>` (MCP oxygen_tools_search with for_table): free, it returns priced suggestions with the exact add command. For standard person or company enrichment, `columns add <table> --preset person_enrich|company_enrich` (MCP oxygen_columns_add with preset) adds the maintained bundle in one call before any hand-built tool column. Person questions over that bundle's profile payload (skill set, grad school, location, job fit, current company) and person appearance research (events, keynotes, podcasts, GitHub profile) are `columns catalog --category people` templates, added with `columns add <table> --prompt-key <key> --input <name>=<column>`. For a company fact OXYGEN already knows how to research (founders, parent company, funding, cloud provider, offers demos, industry, NAICS, HQ, LinkedIn/Crunchbase page lookups) or a page extraction, `columns catalog` lists the ready-made template and `columns add <table> --prompt-key <key> --input <name>=<column>` (MCP oxygen_columns_add with prompt_key) adds it with no prompt to write. For ICP tiers, read the saved profile with `knowledge page get icp`, then add native Classify Score: `columns add <table> --label 'ICP fit' --score 'low,medium,high' --prompt '<ICP criteria using {{evidence_column}} tokens>' --grounding workspace`. It costs 0.075 credits/row; preview with `columns run --dry-run`. `columns catalog --family classification --json` puts Classify in `data.native`; `data.entries` holds separate prompt templates that can cost more.",
10
10
  posture: "mixed",
11
- gatewayTools: ["oxygen_tables_create", "oxygen_tools_search", "oxygen_columns_add", "oxygen_columns_catalog", "oxygen_enrich_column_preview", "oxygen_tables_link_bulk", "oxygen_callables_manage", "oxygen_tables_records_import"],
12
- gatewayCommands: ["tables create", "tools search", "columns add", "columns catalog", "enrich-column preview", "tables link", "functions list", "functions draft", "tables records import"],
11
+ gatewayTools: ["oxygen_tables_create", "oxygen_tools_search", "oxygen_columns_add", "oxygen_columns_catalog", "oxygen_enrich_column_preview", "oxygen_tables_link_bulk", "oxygen_tables_records_import"],
12
+ gatewayCommands: ["tables create", "tools search", "columns add", "columns catalog", "enrich-column preview", "tables link", "tables records import"],
13
13
  skills: ["oxygen-tables", "oxygen-enrichment", "oxygen-table-tidy", "oxygen-diagnostics", "oxygen-clay-migration", "oxygen-signals"],
14
- endpointSections: ["action-columns", "callables", "functions", "columns", "company-enrichment", "enrich-column", "enrichment", "migrations", "projects", "supabase", "table-action-items", "table-action-runs", "table-ingestion-runs", "tables"],
14
+ endpointSections: ["action-columns", "columns", "company-enrichment", "enrich-column", "enrichment", "migrations", "projects", "supabase", "table-action-items", "table-action-runs", "table-ingestion-runs", "tables"],
15
15
  // "link"/"join"/"connect"/"relate" route here for `tables link`. Added after a
16
16
  // blind user eval asked for exactly "link two tables" and was routed to
17
17
  // `tables create` / `columns add` / `enrich-column preview` — none of which
@@ -61,6 +61,7 @@ export const BROWSER_OPERATIONS = [
61
61
  operation("workflows.observed_output", "/api/cli/workflows/{workflow}/observed-output", "GET", "workflows observed-output", "oxygen_workflow_observed_output", "workflows", "Inspect observed output paths and bounded samples from an exact run or recent matching workflow revision.", { run_id: text(), source_hash: text() }),
62
62
  operation("workflows.run.events", "/api/cli/workflows/{workflow}/runs/{run}/events", "GET", "workflows runs events", "oxygen_workflow_run_events", "workflows", "Read the exact Workflow run's bounded event history and whether it is still active.", { limit: int({ minimum: 1, maximum: 1000 }) }),
63
63
  operation("workflows.run.step_statuses", "/api/cli/workflows/{workflow}/runs/{run}/step-statuses", "GET", "workflows runs step-statuses", "oxygen_workflow_run_step_statuses", "workflows", "Read the current Workflow run status and every step status for immediate execution readback."),
64
+ operation("workflows.run.steps", "/api/cli/workflows/{workflow}/runs/{run}/steps", "GET", "workflows runs steps", "oxygen_workflow_run_steps", "workflows", "Read one Workflow run as its named steps: status, a plain-language outcome per step, timing, credits, the customer-safe failure and bounded input/output."),
64
65
  operation("workflows.tool_output_paths", "/api/cli/workflows/tool-output-paths", "GET", "workflows tool-output-paths", "oxygen_workflow_tool_output_paths", "workflows", "Discover bounded workspace-observed tool output paths and run/revision provenance, without exposing provider values.", { tool_id: strings() }, ["tool_id"], { repeatedQueryFields: ["tool_id"] }),
65
66
  operation("tables.resource.edit", table, "PATCH", "tables edit", "oxygen_table_resource_edit", "tables", "Rename a Table or move it to a workspace project; returns the saved Table.", { name: text(), project_id: text() }),
66
67
  operation("tables.resource.archive", table, "DELETE", "tables archive", "oxygen_tables_archive", "tables", "Archive a Table indefinitely without dropping its physical data or scheduling a purge.", {}, [], nativeCli),
@@ -56,7 +56,7 @@ export const CUSTOMER_OPERATIONS = [
56
56
  operation("comments.edit", "/api/cli/collab/comments/{comment_id}", "PATCH", "comments edit", "oxygen_comments_edit", "collaboration", "Edit your own internal workspace comment; records the edit time.", { body: text() }, ["body"], mcpOnly),
57
57
  operation("comments.delete", "/api/cli/collab/comments/{comment_id}", "DELETE", "comments delete", "oxygen_comments_delete", "collaboration", "Retract your own internal workspace comment while retaining its audit trail.", {}, [], mcpOnly),
58
58
  operation("approvals.cancel", "/api/cli/collab/requests/{request_id}/cancel", "POST", "approvals cancel", "oxygen_approvals_cancel", "collaboration", "Withdraw an approval request you created; grants no approval.", { note: text() }, [], mcpOnly),
59
- operation("members.role", "/api/cli/collab/members/role", "POST", "members role", "oxygen_members_role_set", "collaboration", "Set a member's workspace role: admin, member, rep (sales rep), viewer or client; null only clears a restricted role. Admin only; you cannot change your own role, and an admin becomes a member before taking a restricted role. Admin and member change in Clerk; may read pending Clerk invitations; sends no invitation. Free.", { email: text(), role: nullable(enumOf(["admin", "member", ...OXYGEN_ROLES])) }, ["email", "role"], { ...mcpOnly, annotations: { openWorldHint: true } }),
59
+ operation("members.role", "/api/cli/collab/members/role", "POST", "members role", "oxygen_members_role_set", "collaboration", "Set a member's workspace role, held in Clerk: admin, member, rep (sales rep), viewer or client; null lifts a restricted role. Admin only; you cannot change your own role. May read pending Clerk invitations; sends no invitation. Free.", { email: text(), role: nullable(enumOf(["admin", "member", ...OXYGEN_ROLES])) }, ["email", "role"], { ...mcpOnly, annotations: { openWorldHint: true } }),
60
60
  operation("members.workspace_role", "/api/cli/collab/members/workspace-role", "POST", "orgs member-role", "oxygen_members_workspace_role_set", "collaboration", "Change a member's workspace role in Clerk; admin only, with self-role and last-administrator protection. Free.", { email: text(), role: enumOf(["admin", "member"]) }, ["email", "role"], { ...mcpOnly, annotations: { openWorldHint: true } }),
61
61
  operation("copilot.sessions.list", "/api/cli/copilot/sessions", "GET", "copilot list", "oxygen_copilot_sessions_list", "agents", "List attended Copilot sessions in this workspace.", COPILOT_SESSIONS_LIST_CONTRACT.properties, [], mcpOnly),
62
62
  operation("copilot.history", "/api/cli/copilot/sessions/{session_id}/history", "GET", "copilot history", "oxygen_copilot_history", "agents", "Search past Oxygent chat messages and recorded app links, with source-turn URLs. Use chat.session_id from oxygents get/list. Results index recorded links, not Markdown-only links; their source turn may be a later update, not creation. Markdown remains searchable as message text.", { query: str({ maxLength: 200, description: "Literal substring in user and assistant messages; also filters recorded links. Omit to list recorded links only." }), offset: int({ minimum: 0, description: "Page offset, initially 0; continue with next_offset from the previous response." }), limit: int({ minimum: 1, maximum: 100, description: "Items per page (default 30)." }) }, []),
@@ -75,14 +75,14 @@ function operation(id, suffix, method, command, summary, fields = {}, required =
75
75
  };
76
76
  }
77
77
  export const GEO_OPERATIONS = [
78
- operation("projects.list", "/projects", "GET", "projects list", "List GEO / AEO AI-search tracking projects."),
79
- operation("projects.create", "/projects", "POST", "projects create", "Create a GEO / AEO brand tracking project, private to the selected workspace and its authorized staff in dev. This never publishes data.", project, ["name", "domains"]),
80
- operation("projects.get", "/projects/{project_id}", "GET", "projects get", "Read a GEO / AEO project and its tracking settings."),
78
+ operation("projects.list", "/projects", "GET", "projects list", "List SEO / GEO AI-search tracking projects."),
79
+ operation("projects.create", "/projects", "POST", "projects create", "Create a SEO / GEO brand tracking project, private to the selected workspace and its authorized staff in dev. This never publishes data.", project, ["name", "domains"]),
80
+ operation("projects.get", "/projects/{project_id}", "GET", "projects get", "Read a SEO / GEO project and its tracking settings."),
81
81
  operation("projects.update", "/projects/{project_id}", "PATCH", "projects update", "Change brand aliases, ICP, markets or tracking settings.", project),
82
82
  operation("context.get", "/context", "GET", "context get", "Read editable brand, ICP and offering context from workspace Knowledge."),
83
83
  operation("engines.list", "/engines", "GET", "engines list", "Inspect consumer answer-engine readiness, supported markets and collection cost."),
84
84
  operation("prompts.list", "/projects/{project_id}/prompts", "GET", "prompts list", "List tracked buyer prompts and research provenance.", { limit: filters.limit, cursor: filters.cursor }),
85
- operation("prompts.create", "/projects/{project_id}/prompts", "POST", "prompts add", "Add a reviewed buyer question to GEO / AEO tracking.", prompt, ["text"]),
85
+ operation("prompts.create", "/projects/{project_id}/prompts", "POST", "prompts add", "Add a reviewed buyer question to SEO / GEO tracking.", prompt, ["text"]),
86
86
  operation("prompts.update", "/projects/{project_id}/prompts/{document_id}", "PATCH", "prompts update", "Revise or pause one tracked buyer question.", prompt),
87
87
  operation("prompts.import", "/projects/{project_id}/prompts/import", "POST", "prompts import", "Import reviewed buyer prompts in one bounded batch.", {
88
88
  prompts: arr(obj(prompt, { required: ["text"] }), {
@@ -119,8 +119,8 @@ export const GEO_OPERATIONS = [
119
119
  description: "ISO 8601 capture timestamp, e.g. 2026-10-09T00:00:00Z. Omit to record the import time.",
120
120
  }),
121
121
  }, ["engine", "prompt", "text"]),
122
- operation("analytics.get", "/projects/{project_id}/analytics", "GET", "analytics get", "Read AI visibility, citations, share of voice and trends with sample denominators.", filters),
123
- operation("sources.list", "/projects/{project_id}/sources", "GET", "sources list", "Find domains and pages cited by AI, including competitive citation gaps.", filters),
122
+ operation("analytics.get", "/projects/{project_id}/analytics", "GET", "analytics get", "Read AI visibility, position, win rate, retrieved and cited sources, share of voice and trends with sample denominators.", filters),
123
+ operation("sources.list", "/projects/{project_id}/sources", "GET", "sources list", "Find domains and pages AI retrieved or cited inline, with domain and page types and competitive citation gaps.", filters),
124
124
  operation("evidence.preview", "/projects/{project_id}/evidence/preview", "POST", "evidence preview", "Preview and redact ChatGPT/Claude conversation exports before saving.", { transcript: text(1000000), redact: strings() }, ["transcript"]),
125
125
  operation("evidence.list", "/projects/{project_id}/evidence", "GET", "evidence list", "List customer conversation evidence and original buyer language.", { limit: filters.limit, cursor: filters.cursor }),
126
126
  operation("evidence.create", "/projects/{project_id}/evidence", "POST", "evidence save", "Save a reviewed redacted conversation with optional CRM attribution.", {
@@ -19,6 +19,7 @@ export declare function copilotPlanHoldMessage(input: {
19
19
  leads?: {
20
20
  sourced: number;
21
21
  emails: number;
22
+ tableUrl?: string | null;
22
23
  } | null;
23
24
  }): string;
24
25
  /**
@@ -21,9 +21,12 @@ export function copilotPlanHoldMessage(input) {
21
21
  return "Your workspace is set up, so from here I work on a plan. Pick one and I'll start on this right away.";
22
22
  }
23
23
  const name = play.own ? "Your play" : `Your play "${play.title}"`;
24
+ // The people are the proof (current chat, 2026-10-31: "show as many leads as
25
+ // possible with the mails before the plan"): their count, and where to see them.
26
+ const list = input.leads?.tableUrl ? `[Lead list](${input.leads.tableUrl})` : "Lead list";
24
27
  const leads = input.leads && input.leads.sourced > 0
25
- ? ` It starts from the ${input.leads.sourced.toLocaleString("en-US")} decision makers already in your Lead list`
26
- + (input.leads.emails > 0 ? ` (${input.leads.emails.toLocaleString("en-US")} with a work email).` : ".")
28
+ ? ` It starts from the ${input.leads.sourced.toLocaleString("en-US")} decision makers already in your ${list}`
29
+ + (input.leads.emails > 0 ? ` (${input.leads.emails.toLocaleString("en-US")} with a work email), free to look through.` : ".")
27
30
  : "";
28
31
  return `${name} is ready to run.${leads} On a plan I source the rest, write the sequence and enroll your buyers, so it is ready to send. Pick a plan and I'll run it right away.`;
29
32
  }
@@ -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
  }[];