@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 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.0" : "0.0.0-dev";
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.0" : "0.0.0-dev";
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
@@ -2,7 +2,7 @@
2
2
  import {
3
3
  ApiClient,
4
4
  createMcpServer
5
- } from "./chunk-X6MTB6FY.js";
5
+ } from "./chunk-K7BUXTYP.js";
6
6
 
7
7
  // src/index.ts
8
8
  import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
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.0" : "0.0.0-dev";
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
@@ -4,7 +4,7 @@ import {
4
4
  ApiError,
5
5
  PUBLIC_UI_RESOURCE_URIS,
6
6
  createMcpServer
7
- } from "./chunk-X6MTB6FY.js";
7
+ } from "./chunk-K7BUXTYP.js";
8
8
 
9
9
  // src/tool-catalog.ts
10
10
  var TOOL_CATALOG = [
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sentientui/mcp",
3
- "version": "0.29.0",
3
+ "version": "0.29.1",
4
4
  "description": "MCP server for SentientUI — exposes project data and actions to AI agents",
5
5
  "license": "MIT",
6
6
  "homepage": "https://sentient-ui.com",