negotium 0.1.38 → 0.1.40

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 (56) hide show
  1. package/README.md +19 -0
  2. package/dist/agent-helpers.js +16249 -6273
  3. package/dist/agent-helpers.js.map +83 -36
  4. package/dist/browser-runtime.js +1610 -0
  5. package/dist/browser-runtime.js.map +28 -0
  6. package/dist/hosted-agent.js +2 -2
  7. package/dist/hosted-agent.js.map +2 -2
  8. package/dist/main.js +4130 -3609
  9. package/dist/main.js.map +25 -25
  10. package/dist/mcp-factories.js +15184 -331
  11. package/dist/mcp-factories.js.map +102 -9
  12. package/dist/prompts.js +122 -51
  13. package/dist/prompts.js.map +3 -3
  14. package/dist/query-runtime.js +339 -23
  15. package/dist/query-runtime.js.map +11 -6
  16. package/dist/runtime/src/agents/archiver.ts +407 -296
  17. package/dist/runtime/src/agents/mcp-tools/ask-user.ts +455 -274
  18. package/dist/runtime/src/agents/mcp-tools/self-config.ts +139 -65
  19. package/dist/runtime/src/agents/mcp-tools/spawn-subagent.ts +1037 -816
  20. package/dist/runtime/src/agents/public-helpers.ts +83 -0
  21. package/dist/runtime/src/agents/self-config-core.ts +574 -278
  22. package/dist/runtime/src/agents/topic-cleanup.ts +167 -129
  23. package/dist/runtime/src/index.ts +4 -1
  24. package/dist/runtime/src/mcp/factories/index.ts +9 -0
  25. package/dist/runtime/src/mcp/session-comm/topic-catalog.ts +132 -0
  26. package/dist/runtime/src/mcp/session-comm/topics.ts +23 -57
  27. package/dist/runtime/src/platform/playwright/manager.ts +323 -50
  28. package/dist/runtime/src/platform/playwright/public-runtime.ts +45 -0
  29. package/dist/runtime/src/prompts/builders.ts +205 -52
  30. package/dist/runtime/src/query/public-runtime.ts +8 -0
  31. package/dist/runtime/src/query/state.ts +69 -33
  32. package/dist/runtime/src/storage/runtime-leases.ts +16 -15
  33. package/dist/runtime/src/storage/runtime-process-leases.ts +13 -12
  34. package/dist/runtime/src/storage/runtime-topic-state.ts +12 -9
  35. package/dist/runtime/src/storage/storage-public.ts +4 -0
  36. package/dist/runtime/src/version.ts +1 -1
  37. package/dist/storage.js +419 -1
  38. package/dist/storage.js.map +7 -3
  39. package/dist/types/packages/core/src/agents/api-topic-agent-switch.d.ts +38 -0
  40. package/dist/types/packages/core/src/agents/archiver.d.ts +52 -16
  41. package/dist/types/packages/core/src/agents/mcp-tools/ask-user.d.ts +89 -4
  42. package/dist/types/packages/core/src/agents/mcp-tools/self-config.d.ts +17 -0
  43. package/dist/types/packages/core/src/agents/mcp-tools/spawn-subagent.d.ts +112 -25
  44. package/dist/types/packages/core/src/agents/public-helpers.d.ts +7 -0
  45. package/dist/types/packages/core/src/agents/self-config-core.d.ts +185 -0
  46. package/dist/types/packages/core/src/agents/topic-cleanup.d.ts +30 -24
  47. package/dist/types/packages/core/src/mcp/factories/index.d.ts +1 -0
  48. package/dist/types/packages/core/src/mcp/session-comm/topic-catalog.d.ts +46 -0
  49. package/dist/types/packages/core/src/platform/playwright/manager.d.ts +56 -2
  50. package/dist/types/packages/core/src/platform/playwright/public-runtime.d.ts +4 -0
  51. package/dist/types/packages/core/src/prompts/builders.d.ts +37 -3
  52. package/dist/types/packages/core/src/query/public-runtime.d.ts +1 -0
  53. package/dist/types/packages/core/src/query/state.d.ts +13 -0
  54. package/dist/types/packages/core/src/storage/storage-public.d.ts +4 -0
  55. package/dist/types/packages/core/src/version.d.ts +1 -1
  56. package/package.json +6 -1
package/README.md CHANGED
@@ -237,6 +237,25 @@ Supplying `AgentAuthHost` and `TaskEventHost` keeps auth paths, environment stat
237
237
  owned by the embedding process. The default host remains available only as a convenience for the
238
238
  standalone Negotium runtime.
239
239
 
240
+ The same subpath exposes host-injected lifecycle factories for downstream runtimes:
241
+
242
+ ```ts
243
+ import {
244
+ createArchiverRuntime,
245
+ createAskUserRuntime,
246
+ createSelfConfigRuntime,
247
+ createSubagentLifecycle,
248
+ createTopicLogMaintenance,
249
+ } from "negotium/agent-helpers";
250
+ ```
251
+
252
+ Use `createPromptBuilders` from `negotium/prompts` for ordered product prompt sections and
253
+ `createSessionTargetCatalog` from `negotium/mcp-factories` for collision-safe session target
254
+ listing and validation. Product scheduling, MCP catalogs, ports and environment configuration, and
255
+ top-level agent wiring remain owned by the embedding host. See
256
+ the [Otium runtime deduplication contract](https://github.com/maestrojeong/negotium/blob/main/docs/OTIUM-RUNTIME-DEDUP.md)
257
+ for the full host interfaces and migration boundaries.
258
+
240
259
  ## MCP catalog policy
241
260
 
242
261
  `negotium/mcp-catalog` exposes transport-independent required/optional classification. Embedding