@plumbus/core 0.4.2 → 0.6.0

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 (324) hide show
  1. package/README.md +2 -1
  2. package/dist/.tsbuildinfo +1 -1
  3. package/dist/ai/ai/cost-tracker.d.ts +93 -0
  4. package/dist/ai/ai/derive-ledger-usage.d.ts +10 -0
  5. package/dist/ai/ai/model-pricing.d.ts +51 -0
  6. package/dist/ai/ai/provider.d.ts +214 -0
  7. package/dist/ai/ai/refusal.d.ts +27 -0
  8. package/dist/ai/ai/usage-client.d.ts +30 -0
  9. package/dist/ai/ai-service.d.ts +1 -1
  10. package/dist/ai/ai-service.d.ts.map +1 -1
  11. package/dist/ai/ai-service.js +21 -16
  12. package/dist/ai/ai-service.js.map +1 -1
  13. package/dist/ai/cost-tracker.d.ts +17 -1
  14. package/dist/ai/cost-tracker.d.ts.map +1 -1
  15. package/dist/ai/cost-tracker.js +8 -6
  16. package/dist/ai/cost-tracker.js.map +1 -1
  17. package/dist/ai/derive-ledger-usage.d.ts +11 -0
  18. package/dist/ai/derive-ledger-usage.d.ts.map +1 -0
  19. package/dist/ai/derive-ledger-usage.js +36 -0
  20. package/dist/ai/derive-ledger-usage.js.map +1 -0
  21. package/dist/ai/index.d.ts +1 -0
  22. package/dist/ai/index.d.ts.map +1 -1
  23. package/dist/ai/index.js +1 -0
  24. package/dist/ai/index.js.map +1 -1
  25. package/dist/ai/types/config.d.ts +72 -0
  26. package/dist/ai/types/enums.d.ts +73 -0
  27. package/dist/api/route-generator.d.ts.map +1 -1
  28. package/dist/api/route-generator.js +27 -14
  29. package/dist/api/route-generator.js.map +1 -1
  30. package/dist/cli/cli.d.ts.map +1 -1
  31. package/dist/cli/cli.js +3 -1
  32. package/dist/cli/cli.js.map +1 -1
  33. package/dist/cli/commands/dev.d.ts.map +1 -1
  34. package/dist/cli/commands/dev.js +38 -149
  35. package/dist/cli/commands/dev.js.map +1 -1
  36. package/dist/cli/commands/doctor.d.ts +6 -0
  37. package/dist/cli/commands/doctor.d.ts.map +1 -1
  38. package/dist/cli/commands/doctor.js +92 -4
  39. package/dist/cli/commands/doctor.js.map +1 -1
  40. package/dist/cli/commands/event.d.ts.map +1 -1
  41. package/dist/cli/commands/event.js +3 -0
  42. package/dist/cli/commands/event.js.map +1 -1
  43. package/dist/cli/commands/events-ops.d.ts +4 -0
  44. package/dist/cli/commands/events-ops.d.ts.map +1 -0
  45. package/dist/cli/commands/events-ops.js +203 -0
  46. package/dist/cli/commands/events-ops.js.map +1 -0
  47. package/dist/cli/commands/flow-schedule-list.d.ts +31 -0
  48. package/dist/cli/commands/flow-schedule-list.d.ts.map +1 -0
  49. package/dist/cli/commands/flow-schedule-list.js +93 -0
  50. package/dist/cli/commands/flow-schedule-list.js.map +1 -0
  51. package/dist/cli/commands/flow.d.ts.map +1 -1
  52. package/dist/cli/commands/flow.js +75 -1
  53. package/dist/cli/commands/flow.js.map +1 -1
  54. package/dist/cli/commands/generate.d.ts +4 -0
  55. package/dist/cli/commands/generate.d.ts.map +1 -1
  56. package/dist/cli/commands/generate.js +94 -3
  57. package/dist/cli/commands/generate.js.map +1 -1
  58. package/dist/cli/commands/index.d.ts +2 -0
  59. package/dist/cli/commands/index.d.ts.map +1 -1
  60. package/dist/cli/commands/index.js +2 -0
  61. package/dist/cli/commands/index.js.map +1 -1
  62. package/dist/cli/commands/init.d.ts +1 -1
  63. package/dist/cli/commands/init.d.ts.map +1 -1
  64. package/dist/cli/commands/init.js +55 -4
  65. package/dist/cli/commands/init.js.map +1 -1
  66. package/dist/cli/commands/mcp.d.ts.map +1 -1
  67. package/dist/cli/commands/mcp.js +2 -0
  68. package/dist/cli/commands/mcp.js.map +1 -1
  69. package/dist/cli/commands/start.d.ts +3 -6
  70. package/dist/cli/commands/start.d.ts.map +1 -1
  71. package/dist/cli/commands/start.js +71 -180
  72. package/dist/cli/commands/start.js.map +1 -1
  73. package/dist/cli/commands/verify.d.ts +3 -1
  74. package/dist/cli/commands/verify.d.ts.map +1 -1
  75. package/dist/cli/commands/verify.js +17 -9
  76. package/dist/cli/commands/verify.js.map +1 -1
  77. package/dist/cli/commands/voice.d.ts +12 -0
  78. package/dist/cli/commands/voice.d.ts.map +1 -0
  79. package/dist/cli/commands/voice.js +109 -0
  80. package/dist/cli/commands/voice.js.map +1 -0
  81. package/dist/cli/commands/worker.d.ts +19 -0
  82. package/dist/cli/commands/worker.d.ts.map +1 -0
  83. package/dist/cli/commands/worker.js +234 -0
  84. package/dist/cli/commands/worker.js.map +1 -0
  85. package/dist/cli/mcp-serve-context.d.ts +3 -0
  86. package/dist/cli/mcp-serve-context.d.ts.map +1 -1
  87. package/dist/cli/mcp-serve-context.js +133 -111
  88. package/dist/cli/mcp-serve-context.js.map +1 -1
  89. package/dist/cli/templates/resources.d.ts.map +1 -1
  90. package/dist/cli/templates/resources.js +7 -2
  91. package/dist/cli/templates/resources.js.map +1 -1
  92. package/dist/cli/utils.d.ts +4 -0
  93. package/dist/cli/utils.d.ts.map +1 -1
  94. package/dist/cli/utils.js +9 -0
  95. package/dist/cli/utils.js.map +1 -1
  96. package/dist/cli/voice-agent-bootstrap.d.ts +22 -0
  97. package/dist/cli/voice-agent-bootstrap.d.ts.map +1 -0
  98. package/dist/cli/voice-agent-bootstrap.js +12 -0
  99. package/dist/cli/voice-agent-bootstrap.js.map +1 -0
  100. package/dist/cli/voice-serve-context.d.ts +7 -0
  101. package/dist/cli/voice-serve-context.d.ts.map +1 -0
  102. package/dist/cli/voice-serve-context.js +26 -0
  103. package/dist/cli/voice-serve-context.js.map +1 -0
  104. package/dist/data/drift-inspector.d.ts +2 -2
  105. package/dist/data/drift-inspector.d.ts.map +1 -1
  106. package/dist/data/drift-inspector.js +2 -1
  107. package/dist/data/drift-inspector.js.map +1 -1
  108. package/dist/data/migration.d.ts.map +1 -1
  109. package/dist/data/migration.js +2 -0
  110. package/dist/data/migration.js.map +1 -1
  111. package/dist/define/defineCapability.d.ts +5 -0
  112. package/dist/define/defineCapability.d.ts.map +1 -1
  113. package/dist/define/defineCapability.js +23 -0
  114. package/dist/define/defineCapability.js.map +1 -1
  115. package/dist/errors/http.d.ts.map +1 -1
  116. package/dist/errors/http.js +1 -0
  117. package/dist/errors/http.js.map +1 -1
  118. package/dist/errors/index.d.ts.map +1 -1
  119. package/dist/errors/index.js +1 -0
  120. package/dist/errors/index.js.map +1 -1
  121. package/dist/events/dispatcher.d.ts +4 -0
  122. package/dist/events/dispatcher.d.ts.map +1 -1
  123. package/dist/events/dispatcher.js +24 -1
  124. package/dist/events/dispatcher.js.map +1 -1
  125. package/dist/events/emitter.d.ts +2 -0
  126. package/dist/events/emitter.d.ts.map +1 -1
  127. package/dist/events/emitter.js +6 -3
  128. package/dist/events/emitter.js.map +1 -1
  129. package/dist/events/queue-adapter.d.ts +7 -0
  130. package/dist/events/queue-adapter.d.ts.map +1 -0
  131. package/dist/events/queue-adapter.js +4 -0
  132. package/dist/events/queue-adapter.js.map +1 -0
  133. package/dist/events/queue.d.ts +16 -13
  134. package/dist/events/queue.d.ts.map +1 -1
  135. package/dist/events/queue.js +79 -22
  136. package/dist/events/queue.js.map +1 -1
  137. package/dist/events/worker.d.ts +4 -0
  138. package/dist/events/worker.d.ts.map +1 -1
  139. package/dist/events/worker.js +47 -1
  140. package/dist/events/worker.js.map +1 -1
  141. package/dist/execution/canonical-name.d.ts +13 -0
  142. package/dist/execution/canonical-name.d.ts.map +1 -0
  143. package/dist/execution/canonical-name.js +17 -0
  144. package/dist/execution/canonical-name.js.map +1 -0
  145. package/dist/execution/capability-executor.d.ts +1 -1
  146. package/dist/execution/capability-executor.d.ts.map +1 -1
  147. package/dist/execution/capability-executor.js +52 -24
  148. package/dist/execution/capability-executor.js.map +1 -1
  149. package/dist/execution/capability-invocation.d.ts +34 -0
  150. package/dist/execution/capability-invocation.d.ts.map +1 -0
  151. package/dist/execution/capability-invocation.js +138 -0
  152. package/dist/execution/capability-invocation.js.map +1 -0
  153. package/dist/execution/capability-registry.d.ts +6 -4
  154. package/dist/execution/capability-registry.d.ts.map +1 -1
  155. package/dist/execution/capability-registry.js +13 -7
  156. package/dist/execution/capability-registry.js.map +1 -1
  157. package/dist/execution/context-factory.d.ts.map +1 -1
  158. package/dist/execution/context-factory.js +18 -1
  159. package/dist/execution/context-factory.js.map +1 -1
  160. package/dist/execution/index.d.ts +4 -0
  161. package/dist/execution/index.d.ts.map +1 -1
  162. package/dist/execution/index.js +2 -0
  163. package/dist/execution/index.js.map +1 -1
  164. package/dist/execution/invocation-emit-scope.d.ts +11 -0
  165. package/dist/execution/invocation-emit-scope.d.ts.map +1 -0
  166. package/dist/execution/invocation-emit-scope.js +8 -0
  167. package/dist/execution/invocation-emit-scope.js.map +1 -0
  168. package/dist/flows/engine.d.ts +7 -1
  169. package/dist/flows/engine.d.ts.map +1 -1
  170. package/dist/flows/engine.js +75 -10
  171. package/dist/flows/engine.js.map +1 -1
  172. package/dist/flows/flow-delayed.d.ts +34 -0
  173. package/dist/flows/flow-delayed.d.ts.map +1 -0
  174. package/dist/flows/flow-delayed.js +60 -0
  175. package/dist/flows/flow-delayed.js.map +1 -0
  176. package/dist/flows/flow-queue.d.ts +10 -0
  177. package/dist/flows/flow-queue.d.ts.map +1 -0
  178. package/dist/flows/flow-queue.js +25 -0
  179. package/dist/flows/flow-queue.js.map +1 -0
  180. package/dist/flows/scheduler.d.ts +0 -12
  181. package/dist/flows/scheduler.d.ts.map +1 -1
  182. package/dist/flows/scheduler.js +15 -0
  183. package/dist/flows/scheduler.js.map +1 -1
  184. package/dist/flows/schema.d.ts +17 -0
  185. package/dist/flows/schema.d.ts.map +1 -1
  186. package/dist/flows/schema.js +2 -0
  187. package/dist/flows/schema.js.map +1 -1
  188. package/dist/flows/step-consumer.d.ts +24 -0
  189. package/dist/flows/step-consumer.d.ts.map +1 -0
  190. package/dist/flows/step-consumer.js +72 -0
  191. package/dist/flows/step-consumer.js.map +1 -0
  192. package/dist/flows/triggers.d.ts +1 -1
  193. package/dist/flows/triggers.d.ts.map +1 -1
  194. package/dist/flows/triggers.js +5 -7
  195. package/dist/flows/triggers.js.map +1 -1
  196. package/dist/governance/capability-source-scan.d.ts +7 -0
  197. package/dist/governance/capability-source-scan.d.ts.map +1 -0
  198. package/dist/governance/capability-source-scan.js +80 -0
  199. package/dist/governance/capability-source-scan.js.map +1 -0
  200. package/dist/governance/rules/architecture.d.ts.map +1 -1
  201. package/dist/governance/rules/architecture.js +2 -0
  202. package/dist/governance/rules/architecture.js.map +1 -1
  203. package/dist/governance/rules/capability-dependencies.d.ts +8 -0
  204. package/dist/governance/rules/capability-dependencies.d.ts.map +1 -0
  205. package/dist/governance/rules/capability-dependencies.js +195 -0
  206. package/dist/governance/rules/capability-dependencies.js.map +1 -0
  207. package/dist/governance/rules/index.d.ts +2 -0
  208. package/dist/governance/rules/index.d.ts.map +1 -1
  209. package/dist/governance/rules/index.js +2 -0
  210. package/dist/governance/rules/index.js.map +1 -1
  211. package/dist/governance/rules/worker.d.ts +9 -0
  212. package/dist/governance/rules/worker.d.ts.map +1 -0
  213. package/dist/governance/rules/worker.js +89 -0
  214. package/dist/governance/rules/worker.js.map +1 -0
  215. package/dist/index.d.ts +8 -3
  216. package/dist/index.d.ts.map +1 -1
  217. package/dist/index.js +4 -2
  218. package/dist/index.js.map +1 -1
  219. package/dist/jobs/dispatch.d.ts +18 -0
  220. package/dist/jobs/dispatch.d.ts.map +1 -0
  221. package/dist/jobs/dispatch.js +50 -0
  222. package/dist/jobs/dispatch.js.map +1 -0
  223. package/dist/jobs/index.d.ts +9 -0
  224. package/dist/jobs/index.d.ts.map +1 -0
  225. package/dist/jobs/index.js +8 -0
  226. package/dist/jobs/index.js.map +1 -0
  227. package/dist/jobs/routes.d.ts +10 -0
  228. package/dist/jobs/routes.d.ts.map +1 -0
  229. package/dist/jobs/routes.js +44 -0
  230. package/dist/jobs/routes.js.map +1 -0
  231. package/dist/jobs/schema.d.ts +264 -0
  232. package/dist/jobs/schema.d.ts.map +1 -0
  233. package/dist/jobs/schema.js +34 -0
  234. package/dist/jobs/schema.js.map +1 -0
  235. package/dist/jobs/service.d.ts +52 -0
  236. package/dist/jobs/service.d.ts.map +1 -0
  237. package/dist/jobs/service.js +168 -0
  238. package/dist/jobs/service.js.map +1 -0
  239. package/dist/jobs/types.d.ts +30 -0
  240. package/dist/jobs/types.d.ts.map +1 -0
  241. package/dist/jobs/types.js +4 -0
  242. package/dist/jobs/types.js.map +1 -0
  243. package/dist/mcp/manifest-generator.d.ts.map +1 -1
  244. package/dist/mcp/manifest-generator.js +3 -2
  245. package/dist/mcp/manifest-generator.js.map +1 -1
  246. package/dist/observability/metrics.d.ts +9 -1
  247. package/dist/observability/metrics.d.ts.map +1 -1
  248. package/dist/observability/metrics.js +28 -1
  249. package/dist/observability/metrics.js.map +1 -1
  250. package/dist/runtime/bootstrap.d.ts +51 -0
  251. package/dist/runtime/bootstrap.d.ts.map +1 -0
  252. package/dist/runtime/bootstrap.js +140 -0
  253. package/dist/runtime/bootstrap.js.map +1 -0
  254. package/dist/runtime/index.d.ts +7 -0
  255. package/dist/runtime/index.d.ts.map +1 -0
  256. package/dist/runtime/index.js +6 -0
  257. package/dist/runtime/index.js.map +1 -0
  258. package/dist/runtime/load-extensions.d.ts +4 -0
  259. package/dist/runtime/load-extensions.d.ts.map +1 -0
  260. package/dist/runtime/load-extensions.js +41 -0
  261. package/dist/runtime/load-extensions.js.map +1 -0
  262. package/dist/runtime/queue-factory.d.ts +44 -0
  263. package/dist/runtime/queue-factory.d.ts.map +1 -0
  264. package/dist/runtime/queue-factory.js +156 -0
  265. package/dist/runtime/queue-factory.js.map +1 -0
  266. package/dist/runtime/register-consumers.d.ts +29 -0
  267. package/dist/runtime/register-consumers.d.ts.map +1 -0
  268. package/dist/runtime/register-consumers.js +233 -0
  269. package/dist/runtime/register-consumers.js.map +1 -0
  270. package/dist/runtime/start-worker-pool.d.ts +32 -0
  271. package/dist/runtime/start-worker-pool.d.ts.map +1 -0
  272. package/dist/runtime/start-worker-pool.js +91 -0
  273. package/dist/runtime/start-worker-pool.js.map +1 -0
  274. package/dist/runtime/worker-health.d.ts +19 -0
  275. package/dist/runtime/worker-health.d.ts.map +1 -0
  276. package/dist/runtime/worker-health.js +41 -0
  277. package/dist/runtime/worker-health.js.map +1 -0
  278. package/dist/server/bootstrap.d.ts +6 -0
  279. package/dist/server/bootstrap.d.ts.map +1 -1
  280. package/dist/server/bootstrap.js +24 -1
  281. package/dist/server/bootstrap.js.map +1 -1
  282. package/dist/testing/context.d.ts +3 -0
  283. package/dist/testing/context.d.ts.map +1 -1
  284. package/dist/testing/context.js +12 -0
  285. package/dist/testing/context.js.map +1 -1
  286. package/dist/testing/e2e.d.ts +6 -0
  287. package/dist/testing/e2e.d.ts.map +1 -1
  288. package/dist/testing/e2e.js +2 -0
  289. package/dist/testing/e2e.js.map +1 -1
  290. package/dist/testing/simulate-flow.d.ts.map +1 -1
  291. package/dist/testing/simulate-flow.js +10 -0
  292. package/dist/testing/simulate-flow.js.map +1 -1
  293. package/dist/types/capability.d.ts +8 -0
  294. package/dist/types/capability.d.ts.map +1 -1
  295. package/dist/types/capability.js.map +1 -1
  296. package/dist/types/config.d.ts +2 -0
  297. package/dist/types/config.d.ts.map +1 -1
  298. package/dist/types/context.d.ts +49 -1
  299. package/dist/types/context.d.ts.map +1 -1
  300. package/dist/types/enums.d.ts +1 -0
  301. package/dist/types/enums.d.ts.map +1 -1
  302. package/dist/types/enums.js +1 -0
  303. package/dist/types/enums.js.map +1 -1
  304. package/dist/types/errors.d.ts +1 -0
  305. package/dist/types/errors.d.ts.map +1 -1
  306. package/dist/types/event.d.ts +10 -0
  307. package/dist/types/event.d.ts.map +1 -1
  308. package/dist/types/event.js +5 -1
  309. package/dist/types/event.js.map +1 -1
  310. package/dist/worker/bootstrap.d.ts +32 -1
  311. package/dist/worker/bootstrap.d.ts.map +1 -1
  312. package/dist/worker/bootstrap.js +166 -2
  313. package/dist/worker/bootstrap.js.map +1 -1
  314. package/instructions/capabilities.md +36 -1
  315. package/instructions/deployment.md +96 -11
  316. package/instructions/events.md +11 -0
  317. package/instructions/flows.md +12 -4
  318. package/instructions/governance.md +6 -0
  319. package/instructions/mcp.md +1 -1
  320. package/instructions/patterns.md +1 -0
  321. package/instructions/security.md +9 -0
  322. package/instructions/testing.md +12 -1
  323. package/instructions/upgrading-0.5-capabilities.md +181 -0
  324. package/package.json +16 -4
package/README.md CHANGED
@@ -165,10 +165,11 @@ Full documentation: [github.com/plumbus-framework/plumbus/docs](https://github.c
165
165
  | **`@plumbus/core`** | **You are here.** Foundation — capabilities, entities, events, flows, prompts, translations, runtime, CLI, audit, governance. | Always (required). |
166
166
  | [`@plumbus/ui`](../ui/) | Next.js/React UI — typed API clients, auth helpers, form metadata, scaffolds. | When building a Plumbus web UI. |
167
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. |
168
+ | [`@plumbus/mcp`](../mcp/) | MCP runtime — serve capabilities to AI agents (`tools/*`, `tasks/*`, transports). | Optional peer `0.5.x` — when exposing capabilities to MCP clients. |
169
169
  | [`@plumbus/chat`](../chat/) | Conversational runtime — `defineChat`, policy guards, context sources, streamed events. | Optional peer `0.1.x` — when adding a chat surface. |
170
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
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/voice`](../voice/) | Real-time voice runtime — `defineVoice`, STT/TTS/transport providers, session worker, cost ledger. | Optional peer `0.1.x` — when adding speech I/O (not speech-to-speech); complements `@plumbus/chat` text surfaces. |
172
173
  | [`@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
174
 
174
175
  ## License