@plumbus/core 0.4.1 → 0.4.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 (64) hide show
  1. package/README.md +14 -1
  2. package/dist/.tsbuildinfo +1 -1
  3. package/dist/api/exposure.d.ts +4 -0
  4. package/dist/api/exposure.d.ts.map +1 -0
  5. package/dist/api/exposure.js +5 -0
  6. package/dist/api/exposure.js.map +1 -0
  7. package/dist/api/index.d.ts +1 -0
  8. package/dist/api/index.d.ts.map +1 -1
  9. package/dist/api/index.js +2 -1
  10. package/dist/api/index.js.map +1 -1
  11. package/dist/cli/cli.d.ts.map +1 -1
  12. package/dist/cli/cli.js +2 -1
  13. package/dist/cli/cli.js.map +1 -1
  14. package/dist/cli/commands/api-manifest.d.ts +26 -0
  15. package/dist/cli/commands/api-manifest.d.ts.map +1 -0
  16. package/dist/cli/commands/api-manifest.js +54 -0
  17. package/dist/cli/commands/api-manifest.js.map +1 -0
  18. package/dist/cli/commands/api.d.ts +3 -0
  19. package/dist/cli/commands/api.d.ts.map +1 -0
  20. package/dist/cli/commands/api.js +179 -0
  21. package/dist/cli/commands/api.js.map +1 -0
  22. package/dist/cli/commands/index.d.ts +1 -0
  23. package/dist/cli/commands/index.d.ts.map +1 -1
  24. package/dist/cli/commands/index.js +2 -0
  25. package/dist/cli/commands/index.js.map +1 -1
  26. package/dist/cli/commands/init.d.ts +1 -1
  27. package/dist/cli/commands/init.d.ts.map +1 -1
  28. package/dist/cli/commands/init.js +30 -3
  29. package/dist/cli/commands/init.js.map +1 -1
  30. package/dist/cli/commands/verify.d.ts.map +1 -1
  31. package/dist/cli/commands/verify.js +14 -0
  32. package/dist/cli/commands/verify.js.map +1 -1
  33. package/dist/cli/templates/resources.d.ts.map +1 -1
  34. package/dist/cli/templates/resources.js +6 -0
  35. package/dist/cli/templates/resources.js.map +1 -1
  36. package/dist/define/defineCapability.d.ts +3 -2
  37. package/dist/define/defineCapability.d.ts.map +1 -1
  38. package/dist/define/defineCapability.js +81 -1
  39. package/dist/define/defineCapability.js.map +1 -1
  40. package/dist/governance/index.d.ts +1 -1
  41. package/dist/governance/index.d.ts.map +1 -1
  42. package/dist/governance/index.js +1 -1
  43. package/dist/governance/index.js.map +1 -1
  44. package/dist/governance/rules/api.d.ts +13 -0
  45. package/dist/governance/rules/api.d.ts.map +1 -0
  46. package/dist/governance/rules/api.js +124 -0
  47. package/dist/governance/rules/api.js.map +1 -0
  48. package/dist/governance/rules/index.d.ts +1 -0
  49. package/dist/governance/rules/index.d.ts.map +1 -1
  50. package/dist/governance/rules/index.js +1 -0
  51. package/dist/governance/rules/index.js.map +1 -1
  52. package/dist/index.d.ts +2 -2
  53. package/dist/index.d.ts.map +1 -1
  54. package/dist/index.js +2 -2
  55. package/dist/index.js.map +1 -1
  56. package/dist/types/capability.d.ts +59 -1
  57. package/dist/types/capability.d.ts.map +1 -1
  58. package/dist/types/capability.js +15 -1
  59. package/dist/types/capability.js.map +1 -1
  60. package/dist/types/index.d.ts +1 -1
  61. package/dist/types/index.d.ts.map +1 -1
  62. package/dist/types/index.js.map +1 -1
  63. package/instructions/api.md +19 -0
  64. package/package.json +7 -2
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  **AI-native, contract-driven TypeScript application framework.**
4
4
 
5
- Define your application through six composable primitives — Capabilities, Entities, Events, Flows, Prompts, and Translations — and get deny-by-default security, advisory governance, audit trails, and managed AI integration out of the box. Two opt-in companion packages extend the surface: `@plumbus/chat` for conversational runtimes and `@plumbus/mcp` for serving capabilities to AI agents.
5
+ Define your application through six composable primitives — Capabilities, Entities, Events, Flows, Prompts, and Translations — and get deny-by-default security, advisory governance, audit trails, and managed AI integration out of the box. Optional companion packages extend the surface for partner APIs, MCP agents, chat, knowledge, UI generation, and browser extensions — install only what you need.
6
6
 
7
7
  ## Install
8
8
 
@@ -158,6 +158,19 @@ Wire them up with `plumbus init --agent all`.
158
158
 
159
159
  Full documentation: [github.com/plumbus-framework/plumbus/docs](https://github.com/plumbus-framework/plumbus/tree/main/docs)
160
160
 
161
+ ## The Plumbus ecosystem
162
+
163
+ | Package | Purpose | When to install |
164
+ |---|---|---|
165
+ | **`@plumbus/core`** | **You are here.** Foundation — capabilities, entities, events, flows, prompts, translations, runtime, CLI, audit, governance. | Always (required). |
166
+ | [`@plumbus/ui`](../ui/) | Next.js/React UI — typed API clients, auth helpers, form metadata, scaffolds. | When building a Plumbus web UI. |
167
+ | [`@plumbus/api`](../api/) | Partner external API — manifest, OpenAPI, docs, compatibility diff, test intent. | Optional peer `0.1.x` — when publishing a documented partner-facing HTTP API. |
168
+ | [`@plumbus/mcp`](../mcp/) | MCP runtime — serve capabilities to AI agents (`tools/*`, `tasks/*`, transports). | Optional peer `0.4.x` — when exposing capabilities to MCP clients. |
169
+ | [`@plumbus/chat`](../chat/) | Conversational runtime — `defineChat`, policy guards, context sources, streamed events. | Optional peer `0.1.x` — when adding a chat surface. |
170
+ | [`@plumbus/chat-ui`](../chat-ui/) | React chat UI — hooks and `<ChatPanel />` for the `@plumbus/chat` turn protocol. | Peer of `@plumbus/chat` — when adding a browser chat client. |
171
+ | [`@plumbus/knowledge-base`](../knowledge-base/) | Knowledge providers — scoped sources, registry, chat `knowledgeContext` integration. | Optional peer of `@plumbus/chat` `0.1.x` — when sharing named knowledge across features. |
172
+ | [`@plumbus/browser-extension`](../browser-extension/) | Extension scaffolder — WXT Chrome/Firefox project wired to your capabilities. | With `@plumbus/ui` (`0.1.x`) — when shipping a browser extension UI. |
173
+
161
174
  ## License
162
175
 
163
176
  MIT