@deepagents/experimental 7.7.2 → 7.8.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.
Files changed (54) hide show
  1. package/README.md +16 -5
  2. package/dist/index.js +400 -177
  3. package/dist/index.js.map +4 -4
  4. package/dist/zukhruf/control-plane/agent-control-plane.d.ts.map +1 -1
  5. package/dist/zukhruf/control-plane/agent-thread-limit-error.d.ts +6 -0
  6. package/dist/zukhruf/control-plane/agent-thread-limit-error.d.ts.map +1 -0
  7. package/dist/zukhruf/control-plane/agent-turn-id.d.ts +3 -0
  8. package/dist/zukhruf/control-plane/agent-turn-id.d.ts.map +1 -1
  9. package/dist/zukhruf/control-plane/stale-turn-error.d.ts +7 -0
  10. package/dist/zukhruf/control-plane/stale-turn-error.d.ts.map +1 -0
  11. package/dist/zukhruf/control-plane/turn-not-found-error.d.ts +7 -0
  12. package/dist/zukhruf/control-plane/turn-not-found-error.d.ts.map +1 -0
  13. package/dist/zukhruf/index.d.ts +4 -0
  14. package/dist/zukhruf/index.d.ts.map +1 -1
  15. package/dist/zukhruf/index.js +400 -177
  16. package/dist/zukhruf/index.js.map +4 -4
  17. package/dist/zukhruf/is-named-error.d.ts +7 -0
  18. package/dist/zukhruf/is-named-error.d.ts.map +1 -0
  19. package/dist/zukhruf/mailbox/communication-schema.d.ts +26 -0
  20. package/dist/zukhruf/mailbox/communication-schema.d.ts.map +1 -0
  21. package/dist/zukhruf/mailbox/ddl.postgres.d.ts +2 -0
  22. package/dist/zukhruf/mailbox/ddl.postgres.d.ts.map +1 -0
  23. package/dist/zukhruf/mailbox/postgres.store.d.ts +23 -0
  24. package/dist/zukhruf/mailbox/postgres.store.d.ts.map +1 -0
  25. package/dist/zukhruf/mailbox/sqlite.store.d.ts.map +1 -1
  26. package/dist/zukhruf/plugins/conversation-scheduling/conversation-scheduler.d.ts +1 -1
  27. package/dist/zukhruf/plugins/conversation-scheduling/conversation-scheduler.d.ts.map +1 -1
  28. package/dist/zukhruf/plugins/conversation-scheduling/index.d.ts.map +1 -1
  29. package/dist/zukhruf/plugins/conversation-scheduling/index.js +142 -136
  30. package/dist/zukhruf/plugins/conversation-scheduling/index.js.map +3 -3
  31. package/dist/zukhruf/plugins/http/index.d.ts +2 -2
  32. package/dist/zukhruf/plugins/http/index.d.ts.map +1 -1
  33. package/dist/zukhruf/plugins/http/index.js +72 -17
  34. package/dist/zukhruf/plugins/http/index.js.map +4 -4
  35. package/dist/zukhruf/plugins/schedules/http.d.ts.map +1 -1
  36. package/dist/zukhruf/plugins/schedules/http.js +44 -32
  37. package/dist/zukhruf/plugins/schedules/http.js.map +4 -4
  38. package/dist/zukhruf/plugins/schedules/index.d.ts +2 -2
  39. package/dist/zukhruf/plugins/schedules/index.d.ts.map +1 -1
  40. package/dist/zukhruf/plugins/schedules/index.js +138 -143
  41. package/dist/zukhruf/plugins/schedules/index.js.map +3 -3
  42. package/dist/zukhruf/plugins/uploads/http.js +30 -19
  43. package/dist/zukhruf/plugins/uploads/http.js.map +4 -4
  44. package/dist/zukhruf/plugins/uploads/index.d.ts +2 -2
  45. package/dist/zukhruf/plugins/uploads/index.d.ts.map +1 -1
  46. package/dist/zukhruf/plugins/uploads/index.js +48 -55
  47. package/dist/zukhruf/plugins/uploads/index.js.map +2 -2
  48. package/dist/zukhruf/queue/pg-boss.turn-queue.d.ts +4 -1
  49. package/dist/zukhruf/queue/pg-boss.turn-queue.d.ts.map +1 -1
  50. package/dist/zukhruf/runtime/agent-runtime.d.ts +19 -11
  51. package/dist/zukhruf/runtime/agent-runtime.d.ts.map +1 -1
  52. package/dist/zukhruf/runtime/plugin/plugin-manager.d.ts +4 -4
  53. package/dist/zukhruf/runtime/plugin/plugin-manager.d.ts.map +1 -1
  54. package/package.json +20 -11
package/README.md CHANGED
@@ -137,13 +137,24 @@ mount at its chosen path: create or continue sessions with idempotent `POST`
137
137
  calls, receive the durable `turnId`, check or cancel a specific turn, cancel the
138
138
  active session turn, stream durable UI-message output, and read runtime info
139
139
  plus health checks. `GET /info` advertises mount-relative
140
- `capabilities.history.href` and `capabilities.chat.href`. Runtime plugin
141
- definitions return typed transport-neutral instances. Transport packages bind
142
- those exact installed instances explicitly: `projectHttp(definition, project)`
143
- produces HTTP-owned `publicRoutes`, `authenticatedRoutes`, and discovery
144
- entries, while a future gRPC package can project the same plugin instance into
140
+ `capabilities.history.href` and `capabilities.chat.href`. A runtime plugin's
141
+ `initialize(host)` returns its typed transport-neutral running phase, which
142
+ `host.plugin(definition)` returns. Transport packages bind those exact running
143
+ phases explicitly: `projectHttp(definition, project)` produces HTTP-owned
144
+ `publicRoutes`, `authenticatedRoutes`, and discovery entries, while a future
145
+ gRPC package can project the same running phase into
145
146
  services and streaming without changing core. The HTTP transport plugin rejects
146
147
  duplicate capability names and relative paths.
148
+ Runtime refusals keep their meaning over HTTP, and no answer names another user
149
+ or session: a session the caller does not own answers 404
150
+ `zukhruf/session-not-found`, a turn the session never issued (including a
151
+ regenerate of a message that never ran) answers 404
152
+ `zukhruf/session-turn-not-found`, an approval continuation for a turn the
153
+ session has moved past answers 409 `zukhruf/session-turn-stale`, and a
154
+ sub-agent turn whose tree has no free agent slot answers 429
155
+ `zukhruf/agent-thread-limit`. Hosts that call the runtime directly catch the
156
+ same refusals as `ConversationNotFoundError`, `TurnNotFoundError`,
157
+ `StaleTurnError` and `AgentThreadLimitError` from the main entry.
147
158
  Plugins may also contribute one AI SDK telemetry integration per turn through
148
159
  `telemetry(context)`; the runtime applies every contribution with the agent's
149
160
  declaration-local telemetry policy.