@sentientui/mcp 0.29.0 → 0.29.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 -1
- package/README.md +1 -1
- package/dist/{chunk-X6MTB6FY.js → chunk-K7BUXTYP.js} +4 -4
- package/dist/index.cjs +4 -4
- package/dist/index.js +1 -1
- package/dist/lib.cjs +4 -4
- package/dist/lib.js +1 -1
- package/package.json +1 -1
package/AGENTS.md
CHANGED
|
@@ -13,7 +13,7 @@ SentientUI is a UI personalization platform that assigns visitors to variant com
|
|
|
13
13
|
- **Behaviour groups** (`get_persona_breakdown` `behaviourGroups`) — visitors whose visit patterns look alike ("Behaviour group 2"). Reporting only: they are **not** personas or audiences, nothing is shown to them, and they are never named after an audience. `get_persona_breakdown` `personas` counts the audience each visit was actually **served as** — the same number as the Matrix share in `get_cell_matrix`.
|
|
14
14
|
- **Names never target.** A version's display name, or a key in code `variants`, does not choose who sees it. To give one audience one version every time, pin it (`manage_approvals` `pin`, or the dashboard's "Always show this to …"). Pinned visitors stop teaching the optimizer for that component.
|
|
15
15
|
|
|
16
|
-
**Hybrid components need Migrate first.** An `<Adaptive>` with children **and** `variants` whose id already ran a variants test keeps serving that old test. Generated or dashboard-written versions for it do not serve — even when approved — until it is migrated (dashboard Components → the component → Migrate…, or `manage_tests` `migrate_component`). Check before you generate for one.
|
|
16
|
+
**Hybrid components need Migrate first.** An `<Adaptive>` with children **and** `variants` whose id already ran a variants test keeps serving that old test. Generated or dashboard-written versions for it do not serve — even when approved — until it is migrated (dashboard Components → the component → Migrate…, or `manage_tests` `migrate_component`). Sentient migrates it by itself once the code's test has assigned nobody a version for 14 days. Check before you generate for one.
|
|
17
17
|
|
|
18
18
|
**Funnels need a source per step.** A funnel is an ordered list of goal ids, and every step must have something that sends it — a page-visit goal, a click or form goal, `useGoal` in the browser, or `trackServerGoal` from the backend. A step nothing sends never fills, and the funnel reads as broken. Join a component to a funnel with `<Adaptive id="…" funnel="<funnelId>">`.
|
|
19
19
|
|
package/README.md
CHANGED
|
@@ -148,7 +148,7 @@ A demo token is provisioned automatically — 10 calls/month, read-only (write t
|
|
|
148
148
|
>
|
|
149
149
|
> **Which audiences actually serve.** A *declared* persona serves only on visits where your site declares it (`persona` prop on `<AdaptiveRoot>` / `<AdaptiveProvider>`, `init({ persona })`, or `window.sentient.persona`) — adding it to the vocabulary only names it. A *discovered* audience serves once it is promoted. *Campaigns*, arrival types and retargeting groups reach visitors by how they arrived, which is how to reach anonymous traffic. `get_persona_breakdown` counts the audience each visit was actually served as (the Matrix share); its `behaviourGroups` are descriptive groups of similar behaviour, not personas — never read one as an audience's visitors. A version's name never targets anyone — pin it to an audience instead. Pinned visitors stop teaching the optimizer for that component.
|
|
150
150
|
>
|
|
151
|
-
> **Hybrid components need Migrate.** An `<Adaptive>` with children *and* `variants` whose id already ran a variants test keeps serving that test; generated versions for it do not serve until it is migrated (`manage_tests` `migrate_component`, or Migrate… in the dashboard).
|
|
151
|
+
> **Hybrid components need Migrate.** An `<Adaptive>` with children *and* `variants` whose id already ran a variants test keeps serving that test; generated versions for it do not serve until it is migrated (`manage_tests` `migrate_component`, or Migrate… in the dashboard) — automatic once the code's test has assigned nobody a version for 14 days.
|
|
152
152
|
>
|
|
153
153
|
> **Funnels and server goals.** Every funnel step needs something that sends it. For a step your backend confirms, the call is `trackServerGoal({ serverKey, userId, name, dedupeKey })` from `@sentientui/react/server` (or `@sentientui/core/server`) — see `AGENTS.md` for the exact block.
|
|
154
154
|
>
|
|
@@ -3958,9 +3958,9 @@ var personaOutput = z25.object({
|
|
|
3958
3958
|
)
|
|
3959
3959
|
});
|
|
3960
3960
|
var blockedOutput = z25.enum(["variant_history"]).nullable().optional().describe(
|
|
3961
|
-
"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). Null when the column can serve."
|
|
3961
|
+
"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."
|
|
3962
3962
|
);
|
|
3963
|
-
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).";
|
|
3963
|
+
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.";
|
|
3964
3964
|
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)";
|
|
3965
3965
|
var cellOutput = z25.object({
|
|
3966
3966
|
slotId: z25.string(),
|
|
@@ -4917,7 +4917,7 @@ Audiences, and what makes each one serve (precedence: declared > retargeting > d
|
|
|
4917
4917
|
- get_persona_breakdown personas counts the audience each visit was actually served as (the same number as the Matrix share in get_cell_matrix). Its behaviourGroups ("Behaviour group N") are visitors who behaved alike: not personas or audiences, they serve nothing \u2014 never report one as an audience's visitors.
|
|
4918
4918
|
- A version's name, or a code variants key, never targets an audience. To give one audience one version, pin it (manage_approvals pin); pinned visitors stop teaching the optimizer for that component.
|
|
4919
4919
|
|
|
4920
|
-
Components: an <Adaptive> with children and variants whose id already ran a variants test keeps serving that old test; dashboard-written or generated versions for it do not serve until it is migrated (dashboard Components -> Migrate..., or manage_tests migrate_component).
|
|
4920
|
+
Components: an <Adaptive> with children and variants whose id already ran a variants test keeps serving that old test; dashboard-written or generated versions for it do not serve until it is migrated (dashboard Components -> Migrate..., or manage_tests migrate_component). Sentient migrates it by itself once the code's test has assigned nobody a version for 14 days.
|
|
4921
4921
|
|
|
4922
4922
|
Funnels: every step must have something that sends it (a page-visit rule, a click or form goal, useGoal in the browser, or trackServerGoal from the server), or that step never fills.
|
|
4923
4923
|
|
|
@@ -4937,7 +4937,7 @@ Known people (get_known_people): a person is "known" once they have reached the
|
|
|
4937
4937
|
Write tools change what real visitors see: confirm with the user first. Call get_agent_access before a manage_* write.`;
|
|
4938
4938
|
|
|
4939
4939
|
// src/server.ts
|
|
4940
|
-
var PKG_VERSION = true ? "0.29.
|
|
4940
|
+
var PKG_VERSION = true ? "0.29.1" : "0.0.0-dev";
|
|
4941
4941
|
function createMcpServer(client) {
|
|
4942
4942
|
const server = new McpServer(
|
|
4943
4943
|
{
|
package/dist/index.cjs
CHANGED
|
@@ -3962,9 +3962,9 @@ var personaOutput = import_v325.z.object({
|
|
|
3962
3962
|
)
|
|
3963
3963
|
});
|
|
3964
3964
|
var blockedOutput = import_v325.z.enum(["variant_history"]).nullable().optional().describe(
|
|
3965
|
-
"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). Null when the column can serve."
|
|
3965
|
+
"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."
|
|
3966
3966
|
);
|
|
3967
|
-
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).";
|
|
3967
|
+
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.";
|
|
3968
3968
|
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)";
|
|
3969
3969
|
var cellOutput = import_v325.z.object({
|
|
3970
3970
|
slotId: import_v325.z.string(),
|
|
@@ -4921,7 +4921,7 @@ Audiences, and what makes each one serve (precedence: declared > retargeting > d
|
|
|
4921
4921
|
- get_persona_breakdown personas counts the audience each visit was actually served as (the same number as the Matrix share in get_cell_matrix). Its behaviourGroups ("Behaviour group N") are visitors who behaved alike: not personas or audiences, they serve nothing \u2014 never report one as an audience's visitors.
|
|
4922
4922
|
- A version's name, or a code variants key, never targets an audience. To give one audience one version, pin it (manage_approvals pin); pinned visitors stop teaching the optimizer for that component.
|
|
4923
4923
|
|
|
4924
|
-
Components: an <Adaptive> with children and variants whose id already ran a variants test keeps serving that old test; dashboard-written or generated versions for it do not serve until it is migrated (dashboard Components -> Migrate..., or manage_tests migrate_component).
|
|
4924
|
+
Components: an <Adaptive> with children and variants whose id already ran a variants test keeps serving that old test; dashboard-written or generated versions for it do not serve until it is migrated (dashboard Components -> Migrate..., or manage_tests migrate_component). Sentient migrates it by itself once the code's test has assigned nobody a version for 14 days.
|
|
4925
4925
|
|
|
4926
4926
|
Funnels: every step must have something that sends it (a page-visit rule, a click or form goal, useGoal in the browser, or trackServerGoal from the server), or that step never fills.
|
|
4927
4927
|
|
|
@@ -4941,7 +4941,7 @@ Known people (get_known_people): a person is "known" once they have reached the
|
|
|
4941
4941
|
Write tools change what real visitors see: confirm with the user first. Call get_agent_access before a manage_* write.`;
|
|
4942
4942
|
|
|
4943
4943
|
// src/server.ts
|
|
4944
|
-
var PKG_VERSION = true ? "0.29.
|
|
4944
|
+
var PKG_VERSION = true ? "0.29.1" : "0.0.0-dev";
|
|
4945
4945
|
function createMcpServer(client) {
|
|
4946
4946
|
const server = new import_mcp.McpServer(
|
|
4947
4947
|
{
|
package/dist/index.js
CHANGED
package/dist/lib.cjs
CHANGED
|
@@ -3988,9 +3988,9 @@ var personaOutput = import_v325.z.object({
|
|
|
3988
3988
|
)
|
|
3989
3989
|
});
|
|
3990
3990
|
var blockedOutput = import_v325.z.enum(["variant_history"]).nullable().optional().describe(
|
|
3991
|
-
"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). Null when the column can serve."
|
|
3991
|
+
"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
3992
|
);
|
|
3993
|
-
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).";
|
|
3993
|
+
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
3994
|
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
3995
|
var cellOutput = import_v325.z.object({
|
|
3996
3996
|
slotId: import_v325.z.string(),
|
|
@@ -4947,7 +4947,7 @@ Audiences, and what makes each one serve (precedence: declared > retargeting > d
|
|
|
4947
4947
|
- get_persona_breakdown personas counts the audience each visit was actually served as (the same number as the Matrix share in get_cell_matrix). Its behaviourGroups ("Behaviour group N") are visitors who behaved alike: not personas or audiences, they serve nothing \u2014 never report one as an audience's visitors.
|
|
4948
4948
|
- A version's name, or a code variants key, never targets an audience. To give one audience one version, pin it (manage_approvals pin); pinned visitors stop teaching the optimizer for that component.
|
|
4949
4949
|
|
|
4950
|
-
Components: an <Adaptive> with children and variants whose id already ran a variants test keeps serving that old test; dashboard-written or generated versions for it do not serve until it is migrated (dashboard Components -> Migrate..., or manage_tests migrate_component).
|
|
4950
|
+
Components: an <Adaptive> with children and variants whose id already ran a variants test keeps serving that old test; dashboard-written or generated versions for it do not serve until it is migrated (dashboard Components -> Migrate..., or manage_tests migrate_component). Sentient migrates it by itself once the code's test has assigned nobody a version for 14 days.
|
|
4951
4951
|
|
|
4952
4952
|
Funnels: every step must have something that sends it (a page-visit rule, a click or form goal, useGoal in the browser, or trackServerGoal from the server), or that step never fills.
|
|
4953
4953
|
|
|
@@ -4967,7 +4967,7 @@ Known people (get_known_people): a person is "known" once they have reached the
|
|
|
4967
4967
|
Write tools change what real visitors see: confirm with the user first. Call get_agent_access before a manage_* write.`;
|
|
4968
4968
|
|
|
4969
4969
|
// src/server.ts
|
|
4970
|
-
var PKG_VERSION = true ? "0.29.
|
|
4970
|
+
var PKG_VERSION = true ? "0.29.1" : "0.0.0-dev";
|
|
4971
4971
|
function createMcpServer(client) {
|
|
4972
4972
|
const server = new import_mcp.McpServer(
|
|
4973
4973
|
{
|
package/dist/lib.js
CHANGED