@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.
- package/README.md +1 -1
- package/dist/command-families/program.js +0 -4
- package/dist/command-families/tables/register-views.js +3 -3
- package/dist/command-manifest.js +0 -2
- package/dist/commands/approvals.js +1 -1
- package/dist/commands/budget.js +9 -4
- package/dist/commands/companies.js +1 -1
- package/dist/commands/members.js +1 -1
- package/dist/commands/orgs.js +1 -1
- package/dist/commands/publishing.js +25 -16
- package/dist/commands/sequences.js +15 -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/access/roles.d.ts +21 -8
- package/node_modules/@oxygen/shared/dist/access/roles.js +53 -16
- 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/geo.js +1 -1
- 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/customer-operations.js +1 -1
- package/node_modules/@oxygen/shared/dist/contracts/geo.js +6 -6
- 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 +358 -71
- package/node_modules/@oxygen/shared/dist/onboarding-leads.js +9 -3
- package/node_modules/@oxygen/shared/dist/publishing/limits.d.ts +7 -0
- package/node_modules/@oxygen/shared/dist/publishing/limits.js +7 -0
- 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/social-capabilities.js +5 -3
- package/node_modules/@oxygen/shared/dist/tables/column-output-fields.js +12 -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/node_modules/@oxygen/workflows/dist/graph/diff.d.ts +2 -0
- package/node_modules/@oxygen/workflows/dist/graph/diff.js +3 -0
- package/node_modules/@oxygen/workflows/dist/graph/index.d.ts +1 -0
- package/node_modules/@oxygen/workflows/dist/graph/index.js +1 -0
- package/node_modules/@oxygen/workflows/dist/graph/lint.js +44 -1
- package/node_modules/@oxygen/workflows/dist/graph/manifest-schema.d.ts +62 -0
- package/node_modules/@oxygen/workflows/dist/graph/manifest-schema.js +22 -0
- package/node_modules/@oxygen/workflows/dist/graph/output.d.ts +36 -0
- package/node_modules/@oxygen/workflows/dist/graph/output.js +111 -0
- package/node_modules/@oxygen/workflows/dist/graph/types.d.ts +19 -0
- package/node_modules/@oxygen/workflows/dist/graph/types.js +8 -0
- 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
|
@@ -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
|
-
|
|
109
|
-
|
|
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: ["
|
|
148
|
-
|
|
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: "
|
|
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: "
|
|
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", "
|
|
12
|
-
gatewayCommands: ["tables create", "tools search", "columns add", "columns catalog", "enrich-column preview", "tables link", "
|
|
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", "
|
|
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
|
|
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
|
|
79
|
-
operation("projects.create", "/projects", "POST", "projects create", "Create a
|
|
80
|
-
operation("projects.get", "/projects/{project_id}", "GET", "projects get", "Read a
|
|
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
|
|
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,
|
|
123
|
-
operation("sources.list", "/projects/{project_id}/sources", "GET", "sources list", "Find domains and pages cited
|
|
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.", {
|
|
@@ -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
|
|
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
|
-
|
|
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
|
}[];
|