@sentientui/mcp 0.29.2 → 0.30.1
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/AGENTS.md +1 -0
- package/README.md +1 -0
- package/dist/{chunk-HTKHEGTY.js → chunk-OTJE277E.js} +219 -162
- package/dist/index.cjs +219 -162
- package/dist/index.js +1 -1
- package/dist/lib.cjs +220 -162
- package/dist/lib.js +2 -1
- package/package.json +1 -1
package/dist/lib.cjs
CHANGED
|
@@ -3973,44 +3973,96 @@ function registerInternalTrafficTools(server, client) {
|
|
|
3973
3973
|
);
|
|
3974
3974
|
}
|
|
3975
3975
|
|
|
3976
|
-
// src/tools/
|
|
3976
|
+
// src/tools/site-areas.ts
|
|
3977
3977
|
var import_v325 = require("zod/v3");
|
|
3978
|
-
var
|
|
3979
|
-
|
|
3980
|
-
|
|
3981
|
-
|
|
3982
|
-
|
|
3978
|
+
var SIDE_WORDS = { before: "before sign-up", after: "after sign-up" };
|
|
3979
|
+
function registerSiteAreasTools(server, client) {
|
|
3980
|
+
server.registerTool(
|
|
3981
|
+
"get_site_areas",
|
|
3982
|
+
{
|
|
3983
|
+
title: "Site areas (before and after sign-up)",
|
|
3984
|
+
description: "Read which parts of the site are before sign-up (anonymous visitors; the main goal is to convert them: a sign-up, a sale, a form) and which are after sign-up (inside the product, where the site knows who its users are) \u2014 dashboard Settings \u2192 Site areas. Each area is an allowed site, optionally narrowed to a path; a page no area covers is before sign-up. A component gets versions only for audiences of its own side, and serving follows the same line: campaign, arrival and retargeting audiences are before sign-up; declared personas are after sign-up only (they are people already using the product, so they never count toward winning new ones); discovered groups wherever their visits happen. An empty list means the site is not split and nothing is restricted. Also lists every allowed site with how many visitors were signed in (30 days) and a suggested side. To change: manage_settings set_site_areas.",
|
|
3985
|
+
inputSchema: { projectId: projectIdSchema },
|
|
3986
|
+
outputSchema: {
|
|
3987
|
+
split: import_v325.z.boolean().describe("True once the project has split its site into before and after sign-up"),
|
|
3988
|
+
areas: import_v325.z.array(import_v325.z.object({ origin: import_v325.z.string(), path: import_v325.z.string().nullable(), side: import_v325.z.enum(["before", "after"]) })).describe("The areas, as saved"),
|
|
3989
|
+
sites: import_v325.z.array(
|
|
3990
|
+
import_v325.z.object({
|
|
3991
|
+
origin: import_v325.z.string(),
|
|
3992
|
+
internal: import_v325.z.boolean().describe("Marked internal (Settings \u2192 Internal traffic): its visits never count"),
|
|
3993
|
+
visits30d: import_v325.z.number(),
|
|
3994
|
+
signedIn30d: import_v325.z.number().describe("Visits where the site passed a user id"),
|
|
3995
|
+
suggested: import_v325.z.enum(["before", "after"]).nullable().describe("After when most visitors were signed in; null with too few visits")
|
|
3996
|
+
})
|
|
3997
|
+
).describe("Every allowed site")
|
|
3998
|
+
},
|
|
3999
|
+
annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false }
|
|
4000
|
+
},
|
|
4001
|
+
withApiErrorGuidance(async ({ projectId }) => {
|
|
4002
|
+
var _a, _b;
|
|
4003
|
+
const r = await client.get(`/projects/${encodeURIComponent(projectId)}/site-areas`);
|
|
4004
|
+
const areas = (_a = r.areas) != null ? _a : [];
|
|
4005
|
+
const sites = (_b = r.sites) != null ? _b : [];
|
|
4006
|
+
const lines = areas.length === 0 ? ["The site is not split into before and after sign-up: nothing is restricted."] : [
|
|
4007
|
+
"Site areas (a page no area covers is before sign-up):",
|
|
4008
|
+
...areas.map((a2) => {
|
|
4009
|
+
var _a2;
|
|
4010
|
+
return `- ${a2.origin}${(_a2 = a2.path) != null ? _a2 : ""}: ${SIDE_WORDS[a2.side]}`;
|
|
4011
|
+
})
|
|
4012
|
+
];
|
|
4013
|
+
const suggestions = sites.filter((s) => !s.internal && s.suggested !== null);
|
|
4014
|
+
if (suggestions.length > 0) {
|
|
4015
|
+
lines.push(
|
|
4016
|
+
"Signed-in share, last 30 days:",
|
|
4017
|
+
...suggestions.map((s) => `- ${s.origin}: ${s.signedIn30d} of ${s.visits30d} visits signed in \u2192 suggested ${SIDE_WORDS[s.suggested]}`)
|
|
4018
|
+
);
|
|
4019
|
+
}
|
|
4020
|
+
return {
|
|
4021
|
+
content: [{ type: "text", text: lines.join("\n") }],
|
|
4022
|
+
structuredContent: { split: areas.length > 0, areas, sites }
|
|
4023
|
+
};
|
|
4024
|
+
})
|
|
4025
|
+
);
|
|
4026
|
+
}
|
|
4027
|
+
|
|
4028
|
+
// src/tools/cells.ts
|
|
4029
|
+
var import_v326 = require("zod/v3");
|
|
4030
|
+
var personaOutput = import_v326.z.object({
|
|
4031
|
+
key: import_v326.z.string(),
|
|
4032
|
+
displayName: import_v326.z.string(),
|
|
4033
|
+
description: import_v326.z.string().nullable(),
|
|
4034
|
+
share: import_v326.z.number().describe("Fraction of 30-day decided sessions"),
|
|
3983
4035
|
// Both ride the API response; without them zod stripped them and an agent
|
|
3984
4036
|
// reported a declared audience nothing declares as reachable.
|
|
3985
|
-
state:
|
|
3986
|
-
declaredVisits14d:
|
|
4037
|
+
state: import_v326.z.string().optional().describe("everyone | declared | unlocked | candidate | starter \u2014 why the row exists"),
|
|
4038
|
+
declaredVisits14d: import_v326.z.number().nullable().optional().describe(
|
|
3987
4039
|
"Declared rows only: visits in 14 days whose site declared this persona. 0 = not declared yet \u2014 nobody sees versions written for it until the site sends it."
|
|
3988
4040
|
)
|
|
3989
4041
|
});
|
|
3990
|
-
var blockedOutput =
|
|
4042
|
+
var blockedOutput = import_v326.z.enum(["variant_history"]).nullable().optional().describe(
|
|
3991
4043
|
"variant_history: the component's code still runs its own variants test, so versions written here are approved but NOT showing until it is migrated (dashboard Components \u2192 Migrate; automatic once that test has assigned nobody a version for 14 days). Null when the column can serve."
|
|
3992
4044
|
);
|
|
3993
4045
|
var BLOCKED_LINE = "Not showing yet \u2014 your code's own test still runs here. Versions written for this part of the page are approved but no visitor sees them until it is migrated (Components \u2192 this component \u2192 Migrate) \u2014 Sentient does it by itself once that test has shown nobody a version for 14 days.";
|
|
3994
4046
|
var NOT_DECLARED_LINE = "not declared yet \u2014 your site has not told us anyone is this persona in 14 days, so nobody sees versions written for them until your code sends it (the persona prop, init({ persona }) or window.sentient.persona)";
|
|
3995
|
-
var cellOutput =
|
|
3996
|
-
slotId:
|
|
3997
|
-
persona:
|
|
3998
|
-
status:
|
|
3999
|
-
requestedBy:
|
|
4000
|
-
armId:
|
|
4001
|
-
rationale:
|
|
4002
|
-
error:
|
|
4003
|
-
updatedAt:
|
|
4047
|
+
var cellOutput = import_v326.z.object({
|
|
4048
|
+
slotId: import_v326.z.string(),
|
|
4049
|
+
persona: import_v326.z.string(),
|
|
4050
|
+
status: import_v326.z.string().describe("pending | generating | review (waiting for approval) | live | error | rejected"),
|
|
4051
|
+
requestedBy: import_v326.z.string(),
|
|
4052
|
+
armId: import_v326.z.string().nullable(),
|
|
4053
|
+
rationale: import_v326.z.string().nullable(),
|
|
4054
|
+
error: import_v326.z.string().nullable(),
|
|
4055
|
+
updatedAt: import_v326.z.string(),
|
|
4004
4056
|
// These ride the API response too; omitting them from the schema made zod
|
|
4005
4057
|
// STRIP them, so agents could never see refinement or retry state.
|
|
4006
|
-
refinedFrom:
|
|
4007
|
-
notBefore:
|
|
4008
|
-
attempts:
|
|
4009
|
-
performance:
|
|
4010
|
-
shown:
|
|
4011
|
-
conversions:
|
|
4012
|
-
deltaPct:
|
|
4013
|
-
tier:
|
|
4058
|
+
refinedFrom: import_v326.z.string().nullable().optional().describe("Incumbent arm this cell is improving on \u2014 a pending cell with this set still SERVES the incumbent"),
|
|
4059
|
+
notBefore: import_v326.z.string().nullable().optional().describe("ISO time the queue will next consider this cell (retry backoff / daily-cap deferral); null when due now"),
|
|
4060
|
+
attempts: import_v326.z.number().optional().describe("Generation attempts so far"),
|
|
4061
|
+
performance: import_v326.z.object({
|
|
4062
|
+
shown: import_v326.z.number(),
|
|
4063
|
+
conversions: import_v326.z.number(),
|
|
4064
|
+
deltaPct: import_v326.z.number().nullable().describe("Signed % vs the original conversion rate \u2014 a point estimate; only meaningful beside a winning/losing tier"),
|
|
4065
|
+
tier: import_v326.z.string().describe(
|
|
4014
4066
|
'early | no_baseline (under 100 views) | winning | losing (posterior separated from the original, corrected across the slot column) | flat (NOT separated yet \u2014 not "equal")'
|
|
4015
4067
|
)
|
|
4016
4068
|
}).optional().describe("Present on live cells (and, mid-refinement, the incumbent arm): the at-a-glance readout")
|
|
@@ -4023,29 +4075,29 @@ function registerCellTools(server, client) {
|
|
|
4023
4075
|
description: 'The "Who sees what" matrix: which visitor types (personas) have an AI-generated version live in each personalizable region (slot), with per-persona traffic share and the first-miss auto-fill setting. A cell with no row means nothing has been written for that visitor type in that region \u2014 not that it sees only the original: a region can still be testing shared versions (an editor or dashboard alternative) on everyone, which list_components lists with their numbers.' + UNTRUSTED_FIELDS_NOTE,
|
|
4024
4076
|
inputSchema: { projectId: projectIdSchema },
|
|
4025
4077
|
outputSchema: {
|
|
4026
|
-
slots:
|
|
4027
|
-
|
|
4028
|
-
slotId:
|
|
4029
|
-
displayName:
|
|
4030
|
-
supportsForms:
|
|
4078
|
+
slots: import_v326.z.array(
|
|
4079
|
+
import_v326.z.object({
|
|
4080
|
+
slotId: import_v326.z.string(),
|
|
4081
|
+
displayName: import_v326.z.string(),
|
|
4082
|
+
supportsForms: import_v326.z.boolean(),
|
|
4031
4083
|
// API sends this; without it zod stripped the draft-vs-live signal.
|
|
4032
|
-
live:
|
|
4084
|
+
live: import_v326.z.boolean().optional().describe("False for an sdk-registered draft column \u2014 nothing serves until its first generation publishes it"),
|
|
4033
4085
|
blocked: blockedOutput
|
|
4034
4086
|
})
|
|
4035
4087
|
),
|
|
4036
|
-
personas:
|
|
4037
|
-
cells:
|
|
4038
|
-
autoFill:
|
|
4088
|
+
personas: import_v326.z.array(personaOutput),
|
|
4089
|
+
cells: import_v326.z.array(cellOutput),
|
|
4090
|
+
autoFill: import_v326.z.boolean(),
|
|
4039
4091
|
// The API has always sent this; without it in the schema zod stripped
|
|
4040
4092
|
// it, and generate_cell had no way to know a version would wait for a
|
|
4041
4093
|
// human instead of publishing.
|
|
4042
|
-
reviewMode:
|
|
4094
|
+
reviewMode: import_v326.z.boolean().optional().describe("True when generated versions wait for approval (review_cell) instead of publishing automatically"),
|
|
4043
4095
|
// Nullable: a project with no persona set at all reports null, not a
|
|
4044
4096
|
// string. That is the NORMAL state since the default vocabulary was
|
|
4045
4097
|
// emptied, so a non-nullable schema failed output validation on most
|
|
4046
4098
|
// projects and the tool returned nothing but a zod error.
|
|
4047
|
-
personaSource:
|
|
4048
|
-
undecidedShare:
|
|
4099
|
+
personaSource: import_v326.z.string().nullable().describe('Active persona-set source: default | declared | discovered, or null when the project has no persona set (one "everyone" row)'),
|
|
4100
|
+
undecidedShare: import_v326.z.number()
|
|
4049
4101
|
},
|
|
4050
4102
|
annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false }
|
|
4051
4103
|
},
|
|
@@ -4090,26 +4142,26 @@ function registerCellTools(server, client) {
|
|
|
4090
4142
|
description: "One cell's full story: the generated option a visitor type sees in a slot, why it was written (the stored generation rationale), and how it is performing vs the original (deterministic plain-language verdict)." + UNTRUSTED_FIELDS_NOTE,
|
|
4091
4143
|
inputSchema: {
|
|
4092
4144
|
projectId: projectIdSchema,
|
|
4093
|
-
slotId:
|
|
4094
|
-
persona:
|
|
4145
|
+
slotId: import_v326.z.string().min(1).max(128).describe("The slot id (a matrix column)"),
|
|
4146
|
+
persona: import_v326.z.string().min(1).max(64).describe("The persona key (a matrix row)")
|
|
4095
4147
|
},
|
|
4096
4148
|
outputSchema: {
|
|
4097
4149
|
cell: cellOutput.nullable(),
|
|
4098
|
-
arm:
|
|
4099
|
-
id:
|
|
4100
|
-
displayName:
|
|
4101
|
-
content:
|
|
4102
|
-
blocks:
|
|
4150
|
+
arm: import_v326.z.object({
|
|
4151
|
+
id: import_v326.z.string(),
|
|
4152
|
+
displayName: import_v326.z.string().nullable(),
|
|
4153
|
+
content: import_v326.z.string().nullable(),
|
|
4154
|
+
blocks: import_v326.z.unknown().nullable()
|
|
4103
4155
|
}).nullable(),
|
|
4104
|
-
performance:
|
|
4105
|
-
shown:
|
|
4106
|
-
conversions:
|
|
4107
|
-
conversionRate:
|
|
4108
|
-
baselineShown:
|
|
4109
|
-
baselineConversions:
|
|
4110
|
-
baselineConversionRate:
|
|
4156
|
+
performance: import_v326.z.object({
|
|
4157
|
+
shown: import_v326.z.number(),
|
|
4158
|
+
conversions: import_v326.z.number(),
|
|
4159
|
+
conversionRate: import_v326.z.number(),
|
|
4160
|
+
baselineShown: import_v326.z.number(),
|
|
4161
|
+
baselineConversions: import_v326.z.number(),
|
|
4162
|
+
baselineConversionRate: import_v326.z.number()
|
|
4111
4163
|
}).nullable(),
|
|
4112
|
-
verdict:
|
|
4164
|
+
verdict: import_v326.z.string(),
|
|
4113
4165
|
blocked: blockedOutput
|
|
4114
4166
|
},
|
|
4115
4167
|
annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false }
|
|
@@ -4160,14 +4212,14 @@ function registerCellTools(server, client) {
|
|
|
4160
4212
|
description: "Queue AI generation of a version for one (persona, slot) cell; the worker writes it asynchronously, brand-locked. If the project has review mode on, the finished version WAITS for approval (list_cell_reviews / review_cell) and serves nobody until approved; otherwise it publishes automatically as a named option the optimizer explores. Also regenerates or retries a failed cell. Generation volume is capped per plan (Free included). Check get_cell_matrix for progress. Confirm with the user before calling \u2014 each generation is a model call against the plan quota.",
|
|
4161
4213
|
inputSchema: {
|
|
4162
4214
|
projectId: projectIdSchema,
|
|
4163
|
-
slotId:
|
|
4164
|
-
persona:
|
|
4215
|
+
slotId: import_v326.z.string().min(1).max(128).describe("The slot id (a matrix column)"),
|
|
4216
|
+
persona: import_v326.z.string().min(1).max(64).describe("The persona key (a matrix row)")
|
|
4165
4217
|
},
|
|
4166
4218
|
outputSchema: {
|
|
4167
|
-
slotId:
|
|
4168
|
-
persona:
|
|
4169
|
-
status:
|
|
4170
|
-
reviewMode:
|
|
4219
|
+
slotId: import_v326.z.string(),
|
|
4220
|
+
persona: import_v326.z.string(),
|
|
4221
|
+
status: import_v326.z.literal("pending").describe("Queued \u2014 check get_cell_matrix for progress"),
|
|
4222
|
+
reviewMode: import_v326.z.boolean().nullable().describe("True: the version will wait for review_cell approval. False: it publishes automatically. Null: could not be read.")
|
|
4171
4223
|
},
|
|
4172
4224
|
annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false }
|
|
4173
4225
|
},
|
|
@@ -4195,20 +4247,20 @@ function registerCellTools(server, client) {
|
|
|
4195
4247
|
description: "Generated versions waiting for approval (review mode): which slot and visitor type, the proposed text or layout, and why it was written. Approve or reject each with review_cell after the user decides." + UNTRUSTED_FIELDS_NOTE,
|
|
4196
4248
|
inputSchema: { projectId: projectIdSchema },
|
|
4197
4249
|
outputSchema: {
|
|
4198
|
-
reviews:
|
|
4199
|
-
|
|
4200
|
-
slotId:
|
|
4201
|
-
slotName:
|
|
4202
|
-
persona:
|
|
4203
|
-
personaDisplay:
|
|
4204
|
-
content:
|
|
4205
|
-
rationale:
|
|
4206
|
-
refinedFrom:
|
|
4207
|
-
updatedAt:
|
|
4250
|
+
reviews: import_v326.z.array(
|
|
4251
|
+
import_v326.z.object({
|
|
4252
|
+
slotId: import_v326.z.string(),
|
|
4253
|
+
slotName: import_v326.z.string(),
|
|
4254
|
+
persona: import_v326.z.string(),
|
|
4255
|
+
personaDisplay: import_v326.z.string(),
|
|
4256
|
+
content: import_v326.z.string().nullable().describe("Proposed text, when the version is text (null for a block/layout version)"),
|
|
4257
|
+
rationale: import_v326.z.string().nullable(),
|
|
4258
|
+
refinedFrom: import_v326.z.string().nullable().describe("Live version this one would replace; that version keeps serving until approval"),
|
|
4259
|
+
updatedAt: import_v326.z.string(),
|
|
4208
4260
|
blocked: blockedOutput
|
|
4209
4261
|
})
|
|
4210
4262
|
),
|
|
4211
|
-
total:
|
|
4263
|
+
total: import_v326.z.number().int().describe("How many versions are waiting in all. The list holds at most the oldest 200; decide those to see the rest.")
|
|
4212
4264
|
},
|
|
4213
4265
|
annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false }
|
|
4214
4266
|
},
|
|
@@ -4260,17 +4312,17 @@ function registerCellTools(server, client) {
|
|
|
4260
4312
|
description: "Approve or reject ONE generated version waiting for review (see list_cell_reviews). 'approve' publishes it to live visitors of that type; 'reject' discards it (a rejected refinement leaves the current live version in place). This is the human decision review mode exists for \u2014 only call it with the user's explicit go-ahead.",
|
|
4261
4313
|
inputSchema: {
|
|
4262
4314
|
projectId: projectIdSchema,
|
|
4263
|
-
slotId:
|
|
4264
|
-
persona:
|
|
4265
|
-
action:
|
|
4266
|
-
feedback:
|
|
4315
|
+
slotId: import_v326.z.string().min(1).max(128).describe("The slot id of the version under review"),
|
|
4316
|
+
persona: import_v326.z.string().min(1).max(64).describe("The persona key of the version under review"),
|
|
4317
|
+
action: import_v326.z.enum(["approve", "reject"]),
|
|
4318
|
+
feedback: import_v326.z.string().max(2e3).optional().describe("On reject: what was wrong, in the user's words. The next version written for that square is told to address it.")
|
|
4267
4319
|
},
|
|
4268
4320
|
outputSchema: {
|
|
4269
|
-
slotId:
|
|
4270
|
-
persona:
|
|
4271
|
-
action:
|
|
4272
|
-
status:
|
|
4273
|
-
armId:
|
|
4321
|
+
slotId: import_v326.z.string(),
|
|
4322
|
+
persona: import_v326.z.string(),
|
|
4323
|
+
action: import_v326.z.enum(["approve", "reject"]),
|
|
4324
|
+
status: import_v326.z.string().describe("live (approved, or a rejected refinement whose incumbent keeps serving) | rejected"),
|
|
4325
|
+
armId: import_v326.z.string().nullable().describe("The published option id, on approval"),
|
|
4274
4326
|
blocked: blockedOutput
|
|
4275
4327
|
},
|
|
4276
4328
|
annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false }
|
|
@@ -4299,7 +4351,7 @@ function registerCellTools(server, client) {
|
|
|
4299
4351
|
}
|
|
4300
4352
|
|
|
4301
4353
|
// src/tools/agent-reads.ts
|
|
4302
|
-
var
|
|
4354
|
+
var import_v327 = require("zod/v3");
|
|
4303
4355
|
var READ_ONLY = { readOnlyHint: true, idempotentHint: true, openWorldHint: false };
|
|
4304
4356
|
var AREA_NAMES = {
|
|
4305
4357
|
generate: "Generate",
|
|
@@ -4351,15 +4403,15 @@ function registerAgentReadTools(server, client) {
|
|
|
4351
4403
|
description: "See which areas of this project a person has allowed agents to change: Generate, Approve and publish, Run tests, Goals and funnels, Campaigns and audiences, Project settings. Reading is always allowed; this tells you what a write tool will be refused for before you try it. Agents cannot change these switches \u2014 only a person can, in Settings \u2192 Agent access.",
|
|
4352
4404
|
inputSchema: { projectId: projectIdSchema },
|
|
4353
4405
|
outputSchema: {
|
|
4354
|
-
areas:
|
|
4355
|
-
generate:
|
|
4356
|
-
approve:
|
|
4357
|
-
tests:
|
|
4358
|
-
goals:
|
|
4359
|
-
campaigns:
|
|
4360
|
-
settings:
|
|
4406
|
+
areas: import_v327.z.object({
|
|
4407
|
+
generate: import_v327.z.boolean(),
|
|
4408
|
+
approve: import_v327.z.boolean(),
|
|
4409
|
+
tests: import_v327.z.boolean(),
|
|
4410
|
+
goals: import_v327.z.boolean(),
|
|
4411
|
+
campaigns: import_v327.z.boolean(),
|
|
4412
|
+
settings: import_v327.z.boolean()
|
|
4361
4413
|
}).describe("true = agents may act in this area"),
|
|
4362
|
-
canEdit:
|
|
4414
|
+
canEdit: import_v327.z.boolean().describe("Whether THIS credential could change the switches (always false for an agent)")
|
|
4363
4415
|
},
|
|
4364
4416
|
annotations: READ_ONLY
|
|
4365
4417
|
},
|
|
@@ -4386,35 +4438,35 @@ function registerAgentReadTools(server, client) {
|
|
|
4386
4438
|
description: "List this project's named campaigns, their retargeting groups, and the campaigns seen in traffic. Pass campaignId to get one campaign's card instead: clicks, new people, how many came back, conversions per version, and the control group (visitors held back on the original site). Counts only \u2014 no lift is claimed." + UNTRUSTED_FIELDS_NOTE,
|
|
4387
4439
|
inputSchema: __spreadValues({
|
|
4388
4440
|
projectId: projectIdSchema,
|
|
4389
|
-
campaignId:
|
|
4441
|
+
campaignId: import_v327.z.string().optional().describe("A campaign id from this tool's list; returns that campaign's card")
|
|
4390
4442
|
}, rangeInputSchema("30d")),
|
|
4391
4443
|
outputSchema: {
|
|
4392
|
-
campaigns:
|
|
4393
|
-
id:
|
|
4394
|
-
name:
|
|
4395
|
-
status:
|
|
4396
|
-
arrivalType:
|
|
4397
|
-
landingPaths:
|
|
4444
|
+
campaigns: import_v327.z.array(import_v327.z.object({
|
|
4445
|
+
id: import_v327.z.string(),
|
|
4446
|
+
name: import_v327.z.string(),
|
|
4447
|
+
status: import_v327.z.string().nullable(),
|
|
4448
|
+
arrivalType: import_v327.z.string().nullable(),
|
|
4449
|
+
landingPaths: import_v327.z.array(import_v327.z.string())
|
|
4398
4450
|
})).optional(),
|
|
4399
|
-
retargeting:
|
|
4400
|
-
groupId:
|
|
4401
|
-
campaignId:
|
|
4402
|
-
name:
|
|
4403
|
-
status:
|
|
4404
|
-
endsAt:
|
|
4405
|
-
memberCount:
|
|
4451
|
+
retargeting: import_v327.z.array(import_v327.z.object({
|
|
4452
|
+
groupId: import_v327.z.string(),
|
|
4453
|
+
campaignId: import_v327.z.string().nullable(),
|
|
4454
|
+
name: import_v327.z.string(),
|
|
4455
|
+
status: import_v327.z.string().nullable(),
|
|
4456
|
+
endsAt: import_v327.z.string().nullable(),
|
|
4457
|
+
memberCount: import_v327.z.number()
|
|
4406
4458
|
})).optional(),
|
|
4407
|
-
observed:
|
|
4408
|
-
card:
|
|
4409
|
-
campaignId:
|
|
4410
|
-
name:
|
|
4411
|
-
status:
|
|
4412
|
-
clicks:
|
|
4413
|
-
people:
|
|
4414
|
-
cameBack:
|
|
4415
|
-
controlGroup:
|
|
4416
|
-
versions:
|
|
4417
|
-
retargetingGroupId:
|
|
4459
|
+
observed: import_v327.z.array(import_v327.z.object({ campaign: import_v327.z.string(), sessions: import_v327.z.number(), channel: import_v327.z.string().nullable() })).optional(),
|
|
4460
|
+
card: import_v327.z.object({
|
|
4461
|
+
campaignId: import_v327.z.string(),
|
|
4462
|
+
name: import_v327.z.string(),
|
|
4463
|
+
status: import_v327.z.string().nullable(),
|
|
4464
|
+
clicks: import_v327.z.number(),
|
|
4465
|
+
people: import_v327.z.number().describe("New people served as the campaign"),
|
|
4466
|
+
cameBack: import_v327.z.number(),
|
|
4467
|
+
controlGroup: import_v327.z.number().describe("Matched visits held back on the original site"),
|
|
4468
|
+
versions: import_v327.z.array(import_v327.z.object({ label: import_v327.z.string(), shown: import_v327.z.number(), conversions: import_v327.z.number() })).describe("Per section and version; one visitor can appear in several rows, so do not add them up"),
|
|
4469
|
+
retargetingGroupId: import_v327.z.string().nullable()
|
|
4418
4470
|
}).optional().describe("Only when campaignId was given")
|
|
4419
4471
|
},
|
|
4420
4472
|
annotations: READ_ONLY
|
|
@@ -4497,17 +4549,17 @@ function registerAgentReadTools(server, client) {
|
|
|
4497
4549
|
{
|
|
4498
4550
|
title: "Retargeting report",
|
|
4499
4551
|
description: "One retargeting group's numbers: how many people it started with, how many came back, clicks and conversions. These are counts, not lift. Get the group id from list_campaigns." + UNTRUSTED_FIELDS_NOTE,
|
|
4500
|
-
inputSchema: { projectId: projectIdSchema, groupId:
|
|
4552
|
+
inputSchema: { projectId: projectIdSchema, groupId: import_v327.z.string().describe("A retargeting group id from list_campaigns") },
|
|
4501
4553
|
outputSchema: {
|
|
4502
|
-
groupId:
|
|
4503
|
-
name:
|
|
4504
|
-
status:
|
|
4505
|
-
endsAt:
|
|
4506
|
-
members:
|
|
4507
|
-
cameBack:
|
|
4508
|
-
converted:
|
|
4509
|
-
clicks:
|
|
4510
|
-
versions:
|
|
4554
|
+
groupId: import_v327.z.string(),
|
|
4555
|
+
name: import_v327.z.string(),
|
|
4556
|
+
status: import_v327.z.string().nullable(),
|
|
4557
|
+
endsAt: import_v327.z.string().nullable(),
|
|
4558
|
+
members: import_v327.z.number(),
|
|
4559
|
+
cameBack: import_v327.z.number(),
|
|
4560
|
+
converted: import_v327.z.number(),
|
|
4561
|
+
clicks: import_v327.z.number(),
|
|
4562
|
+
versions: import_v327.z.array(import_v327.z.object({ label: import_v327.z.string(), shown: import_v327.z.number(), conversions: import_v327.z.number() }))
|
|
4511
4563
|
},
|
|
4512
4564
|
annotations: READ_ONLY
|
|
4513
4565
|
},
|
|
@@ -4544,20 +4596,20 @@ function registerAgentReadTools(server, client) {
|
|
|
4544
4596
|
description: "The audiences visitors are sorted into: the ones the site declares, the ones discovered from behaviour (with how many sessions, their share of traffic, and how much evidence there is), and whether the discovered set can be promoted to serving yet, with what is blocking it in plain words." + UNTRUSTED_FIELDS_NOTE,
|
|
4545
4597
|
inputSchema: { projectId: projectIdSchema },
|
|
4546
4598
|
outputSchema: {
|
|
4547
|
-
declared:
|
|
4548
|
-
source:
|
|
4549
|
-
members:
|
|
4599
|
+
declared: import_v327.z.object({
|
|
4600
|
+
source: import_v327.z.string().nullable(),
|
|
4601
|
+
members: import_v327.z.array(import_v327.z.object({ key: import_v327.z.string(), displayName: import_v327.z.string(), status: import_v327.z.string().nullable() }))
|
|
4550
4602
|
}).nullable(),
|
|
4551
|
-
discovered:
|
|
4552
|
-
members:
|
|
4553
|
-
key:
|
|
4554
|
-
displayName:
|
|
4555
|
-
sessions:
|
|
4556
|
-
share:
|
|
4557
|
-
evidence:
|
|
4603
|
+
discovered: import_v327.z.object({
|
|
4604
|
+
members: import_v327.z.array(import_v327.z.object({
|
|
4605
|
+
key: import_v327.z.string(),
|
|
4606
|
+
displayName: import_v327.z.string(),
|
|
4607
|
+
sessions: import_v327.z.number().nullable(),
|
|
4608
|
+
share: import_v327.z.number().nullable(),
|
|
4609
|
+
evidence: import_v327.z.string().describe("strong_evidence | moderate_evidence | no_clear_difference | not_enough_data | not_checked_yet")
|
|
4558
4610
|
}))
|
|
4559
4611
|
}).nullable().describe("null when no discovered set exists yet"),
|
|
4560
|
-
promotion:
|
|
4612
|
+
promotion: import_v327.z.object({ eligible: import_v327.z.boolean(), blockers: import_v327.z.array(import_v327.z.string()) }).nullable()
|
|
4561
4613
|
},
|
|
4562
4614
|
annotations: READ_ONLY
|
|
4563
4615
|
},
|
|
@@ -4623,18 +4675,18 @@ function registerAgentReadTools(server, client) {
|
|
|
4623
4675
|
description: "The styles captured from the site (what generated sections borrow), grouped by role, whether their colors were actually measured, when the scan last ran, and the site audit score. Without measured colors a style cannot be checked for readable contrast." + UNTRUSTED_FIELDS_NOTE,
|
|
4624
4676
|
inputSchema: { projectId: projectIdSchema },
|
|
4625
4677
|
outputSchema: {
|
|
4626
|
-
colorsMeasured:
|
|
4627
|
-
roles:
|
|
4628
|
-
role:
|
|
4629
|
-
count:
|
|
4630
|
-
measuredColors:
|
|
4678
|
+
colorsMeasured: import_v327.z.boolean().describe("false when no captured style has a measured text or background color"),
|
|
4679
|
+
roles: import_v327.z.array(import_v327.z.object({
|
|
4680
|
+
role: import_v327.z.string(),
|
|
4681
|
+
count: import_v327.z.number(),
|
|
4682
|
+
measuredColors: import_v327.z.number().describe("How many of these styles have a measured color")
|
|
4631
4683
|
})),
|
|
4632
|
-
lastScan:
|
|
4633
|
-
audit:
|
|
4634
|
-
status:
|
|
4635
|
-
score:
|
|
4636
|
-
auditedAt:
|
|
4637
|
-
checking:
|
|
4684
|
+
lastScan: import_v327.z.object({ editorAt: import_v327.z.string().nullable(), crawlAt: import_v327.z.string().nullable() }),
|
|
4685
|
+
audit: import_v327.z.object({
|
|
4686
|
+
status: import_v327.z.string().nullable(),
|
|
4687
|
+
score: import_v327.z.number().nullable(),
|
|
4688
|
+
auditedAt: import_v327.z.string().nullable(),
|
|
4689
|
+
checking: import_v327.z.boolean()
|
|
4638
4690
|
}).nullable().describe("null when the audit could not be read")
|
|
4639
4691
|
},
|
|
4640
4692
|
annotations: READ_ONLY
|
|
@@ -4690,13 +4742,13 @@ function registerAgentReadTools(server, client) {
|
|
|
4690
4742
|
{
|
|
4691
4743
|
title: "Region history",
|
|
4692
4744
|
description: "A region's published versions over time (newest first, which one is live) and whether the region is still found on the live page. Get the region id from list_components." + UNTRUSTED_FIELDS_NOTE,
|
|
4693
|
-
inputSchema: { projectId: projectIdSchema, regionId:
|
|
4745
|
+
inputSchema: { projectId: projectIdSchema, regionId: import_v327.z.string().describe("The region's id (the slot id shown by list_components)") },
|
|
4694
4746
|
outputSchema: {
|
|
4695
|
-
regionId:
|
|
4696
|
-
currentVersion:
|
|
4697
|
-
versions:
|
|
4698
|
-
recentDecisions:
|
|
4699
|
-
drift:
|
|
4747
|
+
regionId: import_v327.z.string(),
|
|
4748
|
+
currentVersion: import_v327.z.number(),
|
|
4749
|
+
versions: import_v327.z.array(import_v327.z.object({ version: import_v327.z.number(), publishedAt: import_v327.z.string().nullable(), isCurrent: import_v327.z.boolean() })),
|
|
4750
|
+
recentDecisions: import_v327.z.array(import_v327.z.object({ action: import_v327.z.string(), at: import_v327.z.string().nullable() })),
|
|
4751
|
+
drift: import_v327.z.object({ verdict: import_v327.z.string(), message: import_v327.z.string(), checkedUrl: import_v327.z.string().nullable() }).nullable().describe("Whether the region is still found on the live page; null when the check could not run")
|
|
4700
4752
|
},
|
|
4701
4753
|
annotations: READ_ONLY
|
|
4702
4754
|
},
|
|
@@ -4730,7 +4782,7 @@ function registerAgentReadTools(server, client) {
|
|
|
4730
4782
|
}
|
|
4731
4783
|
|
|
4732
4784
|
// src/tools/manage.ts
|
|
4733
|
-
var
|
|
4785
|
+
var import_v328 = require("zod/v3");
|
|
4734
4786
|
var a = (method, route, extra = {}) => __spreadValues({ method, route }, extra);
|
|
4735
4787
|
var ACTIONS = {
|
|
4736
4788
|
manage_generation: {
|
|
@@ -4839,7 +4891,9 @@ var ACTIONS = {
|
|
|
4839
4891
|
// the only thing in the way of "keep our staging site out of the numbers".
|
|
4840
4892
|
set_internal_sites: a("PUT", "internal-traffic/origins", { body: "req" }),
|
|
4841
4893
|
add_internal_email: a("POST", "internal-traffic/emails", { body: "req" }),
|
|
4842
|
-
remove_internal_email: a("DELETE", "internal-traffic/emails", { body: "req" })
|
|
4894
|
+
remove_internal_email: a("DELETE", "internal-traffic/emails", { body: "req" }),
|
|
4895
|
+
// Which parts of the site are before and after sign-up (2026-11-21).
|
|
4896
|
+
set_site_areas: a("PUT", "site-areas", { body: "req" })
|
|
4843
4897
|
}
|
|
4844
4898
|
};
|
|
4845
4899
|
var REFUSAL_NOTE = " If this project has turned off agent access for this area, the call is refused with a sentence saying so \u2014 tell the user, don't retry.";
|
|
@@ -4867,12 +4921,12 @@ var TOOLS = {
|
|
|
4867
4921
|
manage_campaigns: {
|
|
4868
4922
|
title: "Manage campaigns and audiences",
|
|
4869
4923
|
destructive: true,
|
|
4870
|
-
description: "Manage campaigns, retargeting and audiences: create, update or tag campaigns, start retargeting and change its group, declare or edit audiences, promote or roll back the discovered audiences, promote labels, and set the shopping-stage settings, search categories and stage serving. Promote and roll back change who sees what. Pick one `action`; pass the ids it needs." + REFUSAL_NOTE
|
|
4924
|
+
description: "Manage campaigns, retargeting and audiences: create, update or tag campaigns, start retargeting and change its group, declare or edit audiences, promote or roll back the discovered audiences, promote labels, and set the shopping-stage settings, search categories and stage serving. Promote and roll back change who sees what. A declared audience is after sign-up only (see get_site_areas). Pick one `action`; pass the ids it needs." + REFUSAL_NOTE
|
|
4871
4925
|
},
|
|
4872
4926
|
manage_settings: {
|
|
4873
4927
|
title: "Manage project settings",
|
|
4874
4928
|
destructive: true,
|
|
4875
|
-
description: 'Change project settings: rename or edit the project, remove an allowed origin, add, remove or test a webhook, remove a captured style, rescan the site, set page meaning, create, refresh or remove a report share link, set previews and the layout and slot models, send a test event, and accept, dismiss or save a structured insight. Also who counts as already converted: set_gate_settings (body { identifiedIsConverted: boolean } \u2014 true only when reaching the main goal is what creates the account, i.e. the main goal is sign-up; not available on stores) and import_known_people (body { people: [{ userId, convertedAt?, converted?, orderCount?, totalSpent?, currency?, lastOrderAt?, customerSince?, tags? }] }, at most 2000 per call \u2014 the site\'s own user ids for people who already reached the main goal; never names, emails, phone numbers or addresses, which are refused). Who counts as your team or a test site (Settings \u2192 Internal traffic; read the rules first with get_internal_traffic_rules): set_internal_sites (body { origins: [...] } \u2014 the WHOLE list of internal sites, each one already an allowed origin; an origin left out stops being internal), add_internal_email (body { value } \u2014 a team email domain such as "@acme.com", or one exact address, which is stored only as a hash) and remove_internal_email (body { domain } or { hash } from get_internal_traffic_rules). Internal visits still see versions but never count or teach the optimizer, from the moment a rule is on; earlier visits are separated where the rule can tell. Confirm the list with the user first. Removals cannot be undone. The three insight actions (accept_insight, dismiss_insight, save_insight) are always allowed: the Project settings switch does not govern them. Pick one `action`; pass the ids it needs.' + REFUSAL_NOTE
|
|
4929
|
+
description: 'Change project settings: rename or edit the project, remove an allowed origin, add, remove or test a webhook, remove a captured style, rescan the site, set page meaning, create, refresh or remove a report share link, set previews and the layout and slot models, send a test event, and accept, dismiss or save a structured insight. Also who counts as already converted: set_gate_settings (body { identifiedIsConverted: boolean } \u2014 true only when reaching the main goal is what creates the account, i.e. the main goal is sign-up; not available on stores) and import_known_people (body { people: [{ userId, convertedAt?, converted?, orderCount?, totalSpent?, currency?, lastOrderAt?, customerSince?, tags? }] }, at most 2000 per call \u2014 the site\'s own user ids for people who already reached the main goal; never names, emails, phone numbers or addresses, which are refused). Who counts as your team or a test site (Settings \u2192 Internal traffic; read the rules first with get_internal_traffic_rules): set_internal_sites (body { origins: [...] } \u2014 the WHOLE list of internal sites, each one already an allowed origin; an origin left out stops being internal), add_internal_email (body { value } \u2014 a team email domain such as "@acme.com", or one exact address, which is stored only as a hash) and remove_internal_email (body { domain } or { hash } from get_internal_traffic_rules). Internal visits still see versions but never count or teach the optimizer, from the moment a rule is on; earlier visits are separated where the rule can tell. Confirm the list with the user first. Removals cannot be undone. Which parts of the site are before and after sign-up (read first with get_site_areas): set_site_areas (body { areas: [{ origin, path?, side: "before" | "after" }] } \u2014 the WHOLE list, each origin an allowed site; [] removes the split). Components then get versions only for audiences of their own side; confirm with the user first. The three insight actions (accept_insight, dismiss_insight, save_insight) are always allowed: the Project settings switch does not govern them. Pick one `action`; pass the ids it needs.' + REFUSAL_NOTE
|
|
4876
4930
|
}
|
|
4877
4931
|
};
|
|
4878
4932
|
var pathParams = (route) => [...route.matchAll(/:([A-Za-z]+)/g)].map((m) => m[1]);
|
|
@@ -4890,13 +4944,13 @@ function registerManageTools(server, client) {
|
|
|
4890
4944
|
const meta = TOOLS[tool];
|
|
4891
4945
|
const shape = {
|
|
4892
4946
|
projectId: projectIdSchema,
|
|
4893
|
-
action:
|
|
4894
|
-
enabled:
|
|
4895
|
-
body:
|
|
4947
|
+
action: import_v328.z.enum(names).describe("What to do. Each action needs only the fields noted below."),
|
|
4948
|
+
enabled: import_v328.z.boolean().optional().describe("For set_auto_fill, set_require_approval, set_observation_mode: on (true) or off (false)"),
|
|
4949
|
+
body: import_v328.z.record(import_v328.z.unknown()).optional().describe("The fields to send, for actions that change several things at once; the API checks them and says what's wrong")
|
|
4896
4950
|
};
|
|
4897
|
-
if (tool === "manage_generation") shape.depth =
|
|
4898
|
-
if (tool === "manage_settings") shape.origin =
|
|
4899
|
-
for (const p of paramNames(tool)) shape[p] =
|
|
4951
|
+
if (tool === "manage_generation") shape.depth = import_v328.z.enum(["auto", "rewrite", "redesign"]).optional().describe("For set_depth: how far a rewrite may go");
|
|
4952
|
+
if (tool === "manage_settings") shape.origin = import_v328.z.string().optional().describe("For remove_origin: the origin to stop allowing, e.g. https://example.com");
|
|
4953
|
+
for (const p of paramNames(tool)) shape[p] = import_v328.z.string().optional().describe(`Required by the actions whose route has :${p}`);
|
|
4900
4954
|
server.registerTool(
|
|
4901
4955
|
tool,
|
|
4902
4956
|
{
|
|
@@ -4958,6 +5012,8 @@ userId must be the id the site identifies the visitor with (<AdaptiveRoot userId
|
|
|
4958
5012
|
|
|
4959
5013
|
Excluding the team and test sites (dashboard Settings -> Internal traffic): visits marked internal still see versions (QA works) but never count in any report and never teach the optimizer; get_traffic_breakdown lists them as "Your team / test sites". They are marked by internal sites (allowed domains such as staging or localhost), team emails and domains (they match visitors the site identifies with identify(userId, { email }); the SDK sends only a SHA-256 of the address and its domain, never the address), a browser link, or the code flag (the internal prop on <AdaptiveRoot>/<AdaptiveProvider>, init({ internal }), window.sentient.internal). There is no report filter or IP rule, and visits from before a rule was turned on cannot be separated. Read the rules with get_internal_traffic_rules; change them with manage_settings set_internal_sites / add_internal_email / remove_internal_email (Agent access: Project settings), after confirming the list with the user.
|
|
4960
5014
|
|
|
5015
|
+
Two sides of sign-up (dashboard Settings -> Site areas; read with get_site_areas): before sign-up the visitor is anonymous and the goal is to convert them; after sign-up the visitor is inside the product and known. Once a project splits its site, a component gets versions only for audiences of its own side: campaign, arrival and retargeting audiences are before sign-up, declared personas after sign-up only (people already using the product never count toward winning new ones), discovered groups wherever their visits happen. Serving follows the same line: on a before-sign-up page a declared persona is never in force (that visitor is Everyone or a campaign). A version, pin or approval across the line is refused (error other_side) \u2014 pick an audience of the component's side instead of retrying.
|
|
5016
|
+
|
|
4961
5017
|
The main funnel (get_main_funnel): "how is my funnel doing" is answered by the one journey that ends at the project's main goal \u2014 Arrived, the marketer's own steps, the main goal \u2014 counted in people, with those who had already converted left out. It is chosen with manage_goals set_main_funnel and must end at the main goal; with none chosen it is just Arrived -> main goal. Stores get their checkout journey as the main funnel on connect. Use get_funnel_report only for a side journey: it counts one funnel's goals inside a window and includes people who had already converted, so its numbers and the main funnel's do not add up.
|
|
4962
5018
|
|
|
4963
5019
|
Page groups (get_page_groups): "what runs where" is answered by page groups \u2014 the site's pages under names a marketer uses (Home, Product pages, Pricing), each placed on the main funnel, with the people who viewed them and the components and layouts that ran there. A component's place is where it was actually shown; a header shown everywhere is site-wide. A group's placement only organises the view: where a PERSON is in the funnel comes from get_main_funnel. Until a list is saved (manage_goals set_page_groups) the tool returns a suggestion.
|
|
@@ -4967,7 +5023,7 @@ Known people (get_known_people): a person is "known" once they have reached the
|
|
|
4967
5023
|
Write tools change what real visitors see: confirm with the user first. Call get_agent_access before a manage_* write.`;
|
|
4968
5024
|
|
|
4969
5025
|
// src/server.ts
|
|
4970
|
-
var PKG_VERSION = true ? "0.
|
|
5026
|
+
var PKG_VERSION = true ? "0.30.1" : "0.0.0-dev";
|
|
4971
5027
|
function createMcpServer(client) {
|
|
4972
5028
|
const server = new import_mcp.McpServer(
|
|
4973
5029
|
{
|
|
@@ -5015,6 +5071,7 @@ function createMcpServer(client) {
|
|
|
5015
5071
|
registerAgentTrafficTools(server, client);
|
|
5016
5072
|
registerTrafficTools(server, client);
|
|
5017
5073
|
registerInternalTrafficTools(server, client);
|
|
5074
|
+
registerSiteAreasTools(server, client);
|
|
5018
5075
|
registerCellTools(server, client);
|
|
5019
5076
|
registerAgentReadTools(server, client);
|
|
5020
5077
|
registerManageTools(server, client);
|
|
@@ -5071,6 +5128,7 @@ var TOOL_CATALOG = [
|
|
|
5071
5128
|
{ name: "get_agent_traffic", access: "read", summary: "Which AI crawlers, automated browser sessions and agent API callers read the site (windowed)" },
|
|
5072
5129
|
{ name: "get_traffic_breakdown", access: "read", summary: "Where traffic came from: People vs visitors we could not confirm vs automated vs your team / test sites (windowed)" },
|
|
5073
5130
|
{ name: "get_internal_traffic_rules", access: "read", summary: "How the project keeps its team and test sites out of its numbers: internal sites, team email domains and masked emails, browser link, sessions marked internal (7 days)" },
|
|
5131
|
+
{ name: "get_site_areas", access: "read", summary: "Which parts of the site are before sign-up (anonymous visitors to convert) and after (inside the product), with each site's signed-in share and a suggested side" },
|
|
5074
5132
|
{ name: "get_agent_legibility", access: "read", summary: "Whether the pages agents read are machine-legible, with fixes" },
|
|
5075
5133
|
// Agent access reads
|
|
5076
5134
|
{ name: "get_agent_access", access: "read", summary: "Which areas a person has allowed agents to change in this project (Generate, Approve and publish, Run tests, Goals and funnels, Campaigns and audiences, Project settings)" },
|
package/dist/lib.js
CHANGED
|
@@ -4,7 +4,7 @@ import {
|
|
|
4
4
|
ApiError,
|
|
5
5
|
PUBLIC_UI_RESOURCE_URIS,
|
|
6
6
|
createMcpServer
|
|
7
|
-
} from "./chunk-
|
|
7
|
+
} from "./chunk-OTJE277E.js";
|
|
8
8
|
|
|
9
9
|
// src/tool-catalog.ts
|
|
10
10
|
var TOOL_CATALOG = [
|
|
@@ -56,6 +56,7 @@ var TOOL_CATALOG = [
|
|
|
56
56
|
{ name: "get_agent_traffic", access: "read", summary: "Which AI crawlers, automated browser sessions and agent API callers read the site (windowed)" },
|
|
57
57
|
{ name: "get_traffic_breakdown", access: "read", summary: "Where traffic came from: People vs visitors we could not confirm vs automated vs your team / test sites (windowed)" },
|
|
58
58
|
{ name: "get_internal_traffic_rules", access: "read", summary: "How the project keeps its team and test sites out of its numbers: internal sites, team email domains and masked emails, browser link, sessions marked internal (7 days)" },
|
|
59
|
+
{ name: "get_site_areas", access: "read", summary: "Which parts of the site are before sign-up (anonymous visitors to convert) and after (inside the product), with each site's signed-in share and a suggested side" },
|
|
59
60
|
{ name: "get_agent_legibility", access: "read", summary: "Whether the pages agents read are machine-legible, with fixes" },
|
|
60
61
|
// Agent access reads
|
|
61
62
|
{ name: "get_agent_access", access: "read", summary: "Which areas a person has allowed agents to change in this project (Generate, Approve and publish, Run tests, Goals and funnels, Campaigns and audiences, Project settings)" },
|