@picked/client 0.0.83 → 0.0.84-next.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (46) hide show
  1. package/dist/.tsbuildinfo +1 -1
  2. package/dist/api-BpE3VU63.cjs +1 -0
  3. package/dist/{api-C7k-sqTX.js → api-Cur_xnAf.js} +1 -1
  4. package/dist/cjs/index.js +2 -2
  5. package/dist/cjs/plugins/dynamic-experiences/index.js +1 -1
  6. package/dist/cjs/plugins/experience-browser-storage/index.js +1 -1
  7. package/dist/cjs/server/index.js +1 -1
  8. package/dist/docs/reference/sdk/analytics-events.md +11 -2
  9. package/dist/docs/reference/sdk/ssr/slots-and-placements.md +54 -0
  10. package/dist/docs/reference/tools/mcp.md +38 -31
  11. package/dist/esm/index.js +377 -399
  12. package/dist/esm/plugins/dynamic-experiences/index.js +2 -2
  13. package/dist/esm/plugins/experience-browser-storage/index.js +12 -10
  14. package/dist/esm/server/index.js +40 -36
  15. package/dist/experience-instance-DifOgdCW.cjs +1 -0
  16. package/dist/{experience-instance-BibCf-8y.js → experience-instance-VZQBpVEW.js} +265 -239
  17. package/dist/{plugin-Ch3nd-iX.js → plugin-BuyAO6JE.js} +68 -52
  18. package/dist/plugin-Yf4me2Nm.cjs +1 -0
  19. package/dist/preview-unavailable-CY23cDO-.cjs +1 -0
  20. package/dist/{version-COZoqJaS.js → preview-unavailable-EL7XtSOv.js} +104 -61
  21. package/dist/{provider-URanKqBl.js → provider-CVGDO2eV.js} +6 -3
  22. package/dist/provider-DRB8eke6.cjs +1 -0
  23. package/dist/types/data-source/preview-unavailable.d.ts +18 -0
  24. package/dist/types/data-source/preview-unavailable.d.ts.map +1 -0
  25. package/dist/types/data-source/provider.d.ts +5 -0
  26. package/dist/types/data-source/provider.d.ts.map +1 -1
  27. package/dist/types/entities/experience-instance/experience-instance.d.ts +14 -1
  28. package/dist/types/entities/experience-instance/experience-instance.d.ts.map +1 -1
  29. package/dist/types/exports.d.ts +1 -0
  30. package/dist/types/exports.d.ts.map +1 -1
  31. package/dist/types/picked.d.ts +7 -0
  32. package/dist/types/picked.d.ts.map +1 -1
  33. package/dist/types/plugins/dynamic-experiences/plugin.d.ts.map +1 -1
  34. package/dist/types/plugins/experience-browser-storage/plugin.d.ts.map +1 -1
  35. package/dist/types/server/serialize.d.ts +1 -0
  36. package/dist/types/server/serialize.d.ts.map +1 -1
  37. package/dist/types/utils/events.d.ts +4 -0
  38. package/dist/types/utils/events.d.ts.map +1 -1
  39. package/dist/types/utils/search-params.d.ts +20 -0
  40. package/dist/types/utils/search-params.d.ts.map +1 -1
  41. package/package.json +3 -3
  42. package/dist/api-CSANsJg3.cjs +0 -1
  43. package/dist/experience-instance-CMfjyLaI.cjs +0 -1
  44. package/dist/plugin-ByOn3B0I.cjs +0 -1
  45. package/dist/provider-CxjhDODz.cjs +0 -1
  46. package/dist/version-BlPyWs4m.cjs +0 -1
package/dist/docs/reference/tools/mcp.md CHANGED
@@ -12,57 +12,64 @@ Context Protocol (MCP).
12
12
 
13
13
  ### Discovery
14
14
 
15
- | Tool | Description |
16
- | ------------------------ | ------------------------------------------------------------ |
17
- | `list_projects` | Lists your organizations and projects |
18
- | `list_workspaces` | Lists the workspaces in a project |
19
- | `get_workspace_overview` | Reads the full workspace state |
15
+ | Tool | Description |
16
+ | ------------------------ | -------------------------------------------------------------- |
17
+ | `list_projects` | Lists your organizations and projects |
18
+ | `list_workspaces` | Lists the workspaces in a project |
19
+ | `get_workspace_overview` | Reads the live version and the workspace draft |
20
20
  | `get_schema_info` | Reads the documentation for Picked concepts and the data model |
21
- | `list_picked_docs` | Lists every Picked documentation page with its URL |
22
- | `read_picked_doc` | Reads one documentation page, or one section of it |
21
+ | `list_picked_docs` | Lists every Picked documentation page with its URL |
22
+ | `read_picked_doc` | Reads one documentation page, or one section of it |
23
23
 
24
24
  ### Experiences
25
25
 
26
- | Tool | Description |
27
- | ------------------------ | ----------------------------------------------------------------------------------------- |
28
- | `create_experience` | Creates an experience |
29
- | `get_experience` | Reads an experience, with its flow graph |
30
- | `list_experiences` | Lists your experiences |
26
+ | Tool | Description |
27
+ | ------------------------ | -------------------------------------------------------------------------------------------------- |
28
+ | `create_experience` | Creates an experience |
29
+ | `get_experience` | Reads an experience, with its flow graph |
30
+ | `list_experiences` | Lists your experiences |
31
31
  | `update_experience_flow` | Creates, updates, or deletes steps, conditions, actions, fields, nodes, and edges as one operation |
32
32
 
33
33
  ### Steps, fields, conditions, and actions
34
34
 
35
- | Tool | Description |
36
- | ----------------------------------- | --------------- |
37
- | `get_step` / `list_steps` | Read steps |
38
- | `get_field` / `list_fields` | Read fields |
39
- | `get_condition` / `list_conditions` | Read conditions |
40
- | `get_action` / `list_actions` | Read actions |
35
+ | Tool | Description |
36
+ | ----------------------------------- | ---------------------------------------------------------------- |
37
+ | `get_step` / `list_steps` | Read steps |
38
+ | `update_step` | Renames a step, or binds it to the content entry that it renders |
39
+ | `get_field` / `list_fields` | Read fields |
40
+ | `get_condition` / `list_conditions` | Read conditions |
41
+ | `get_action` / `list_actions` | Read actions |
41
42
 
42
43
  ### Feature flags
43
44
 
44
- | Tool | Description |
45
- | ---------------- | ---------------------------------------------------- |
46
- | `create_feature` | Creates a feature flag |
47
- | `get_feature` | Reads a feature flag |
48
- | `list_features` | Lists your feature flags |
49
- | `update_feature` | Updates the name, description, state, or weight |
45
+ | Tool | Description |
46
+ | ---------------- | ----------------------------------------------- |
47
+ | `create_feature` | Creates a feature flag |
48
+ | `get_feature` | Reads a feature flag |
49
+ | `list_features` | Lists your feature flags |
50
+ | `update_feature` | Updates the name, description, state, or weight |
50
51
 
51
52
  ### Analytics
52
53
 
53
- | Tool | Description |
54
- | ---------------- | ---------------------------------------------------------------- |
55
- | `query_pickedql` | Runs a PickedQL analytics query and returns the rows as a table |
54
+ | Tool | Description |
55
+ | ---------------- | --------------------------------------------------------------- |
56
+ | `query_pickedql` | Runs a PickedQL analytics query and returns the rows as a table |
56
57
 
57
58
  Call `get_schema_info` with the topic `pickedql` to see the tables, the virtual
58
59
  functions, and the dimension columns before you write a query.
59
60
 
60
61
  ### Publish
61
62
 
62
- | Tool | Description |
63
- | ------------------- | ---------------------------------------------- |
64
- | `get_preview_url` | Makes a preview URL for your unpublished work |
65
- | `publish_workspace` | Publishes the workspace |
63
+ | Tool | Description |
64
+ | ---------------------------- | ---------------------------------------------------------------------- |
65
+ | `get_preview_url` | Makes a preview URL for your unpublished work |
66
+ | `publish_workspace` | Publishes the workspace |
67
+ | `list_workspace_versions` | Lists the published versions of a project, and shows the live one |
68
+ | `compare_workspace_versions` | Shows the differences between the live version, a version, and a draft |
69
+
70
+ The `list_*` and `get_*` tools read the workspace draft. The draft can be
71
+ different from the live version that visitors see. Use
72
+ `compare_workspace_versions` to see what is live and what changes when you publish.
66
73
 
67
74
  ## Example prompts
68
75