@adonis-agora/agent 0.54.0 → 0.56.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 (129) hide show
  1. package/CHANGELOG.md +62 -0
  2. package/dist/providers/agent_provider.d.ts.map +1 -1
  3. package/dist/providers/agent_provider.js +139 -10
  4. package/dist/providers/agent_provider.js.map +1 -1
  5. package/dist/src/ag-ui/adapter.d.ts +26 -0
  6. package/dist/src/ag-ui/adapter.d.ts.map +1 -0
  7. package/dist/src/ag-ui/adapter.js +295 -0
  8. package/dist/src/ag-ui/adapter.js.map +1 -0
  9. package/dist/src/ag-ui/encoder.d.ts +107 -0
  10. package/dist/src/ag-ui/encoder.d.ts.map +1 -0
  11. package/dist/src/ag-ui/encoder.js +519 -0
  12. package/dist/src/ag-ui/encoder.js.map +1 -0
  13. package/dist/src/ag-ui/index.d.ts +12 -0
  14. package/dist/src/ag-ui/index.d.ts.map +1 -0
  15. package/dist/src/ag-ui/index.js +12 -0
  16. package/dist/src/ag-ui/index.js.map +1 -0
  17. package/dist/src/ag-ui/input.d.ts +72 -0
  18. package/dist/src/ag-ui/input.d.ts.map +1 -0
  19. package/dist/src/ag-ui/input.js +216 -0
  20. package/dist/src/ag-ui/input.js.map +1 -0
  21. package/dist/src/ag-ui/interrupt-id.d.ts +27 -0
  22. package/dist/src/ag-ui/interrupt-id.d.ts.map +1 -0
  23. package/dist/src/ag-ui/interrupt-id.js +42 -0
  24. package/dist/src/ag-ui/interrupt-id.js.map +1 -0
  25. package/dist/src/ag-ui/stream.d.ts +28 -0
  26. package/dist/src/ag-ui/stream.d.ts.map +1 -0
  27. package/dist/src/ag-ui/stream.js +68 -0
  28. package/dist/src/ag-ui/stream.js.map +1 -0
  29. package/dist/src/ag-ui/types.d.ts +202 -0
  30. package/dist/src/ag-ui/types.d.ts.map +1 -0
  31. package/dist/src/ag-ui/types.js +33 -0
  32. package/dist/src/ag-ui/types.js.map +1 -0
  33. package/dist/src/agent-loop.d.ts.map +1 -1
  34. package/dist/src/agent-loop.js +1 -0
  35. package/dist/src/agent-loop.js.map +1 -1
  36. package/dist/src/agent-service.d.ts +28 -0
  37. package/dist/src/agent-service.d.ts.map +1 -1
  38. package/dist/src/agent-service.js +58 -5
  39. package/dist/src/agent-service.js.map +1 -1
  40. package/dist/src/ai-tool-ref.d.ts +26 -4
  41. package/dist/src/ai-tool-ref.d.ts.map +1 -1
  42. package/dist/src/ai-tool-ref.js +6 -1
  43. package/dist/src/ai-tool-ref.js.map +1 -1
  44. package/dist/src/confirmed-tool.d.ts +2 -2
  45. package/dist/src/confirmed-tool.d.ts.map +1 -1
  46. package/dist/src/confirmed-tool.js.map +1 -1
  47. package/dist/src/define_config.d.ts +8 -0
  48. package/dist/src/define_config.d.ts.map +1 -1
  49. package/dist/src/define_config.js.map +1 -1
  50. package/dist/src/guardrails/agent.d.ts.map +1 -1
  51. package/dist/src/guardrails/agent.js +11 -0
  52. package/dist/src/guardrails/agent.js.map +1 -1
  53. package/dist/src/index.d.ts +5 -3
  54. package/dist/src/index.d.ts.map +1 -1
  55. package/dist/src/index.js +5 -3
  56. package/dist/src/index.js.map +1 -1
  57. package/dist/src/mcp-client/options.d.ts +12 -0
  58. package/dist/src/mcp-client/options.d.ts.map +1 -1
  59. package/dist/src/mcp-client/tool-source.d.ts.map +1 -1
  60. package/dist/src/mcp-client/tool-source.js +2 -0
  61. package/dist/src/mcp-client/tool-source.js.map +1 -1
  62. package/dist/src/media/index.d.ts +1 -1
  63. package/dist/src/media/index.d.ts.map +1 -1
  64. package/dist/src/media/index.js +1 -1
  65. package/dist/src/media/index.js.map +1 -1
  66. package/dist/src/media/media-attachment-staging.d.ts +107 -6
  67. package/dist/src/media/media-attachment-staging.d.ts.map +1 -1
  68. package/dist/src/media/media-attachment-staging.js +173 -21
  69. package/dist/src/media/media-attachment-staging.js.map +1 -1
  70. package/dist/src/react/ag-ui.d.ts +41 -0
  71. package/dist/src/react/ag-ui.d.ts.map +1 -0
  72. package/dist/src/react/ag-ui.js +63 -0
  73. package/dist/src/react/ag-ui.js.map +1 -0
  74. package/dist/src/react/client.d.ts +12 -0
  75. package/dist/src/react/client.d.ts.map +1 -0
  76. package/dist/src/react/client.js +21 -0
  77. package/dist/src/react/client.js.map +1 -0
  78. package/dist/src/react/index.d.ts +3 -8
  79. package/dist/src/react/index.d.ts.map +1 -1
  80. package/dist/src/react/index.js +4 -20
  81. package/dist/src/react/index.js.map +1 -1
  82. package/dist/src/react/media.d.ts +18 -0
  83. package/dist/src/react/media.d.ts.map +1 -0
  84. package/dist/src/react/media.js +18 -0
  85. package/dist/src/react/media.js.map +1 -0
  86. package/dist/src/spi/agent-store.d.ts +29 -0
  87. package/dist/src/spi/agent-store.d.ts.map +1 -1
  88. package/dist/src/spi/agent-store.js.map +1 -1
  89. package/dist/src/spi/attachment-staging.d.ts +5 -0
  90. package/dist/src/spi/attachment-staging.d.ts.map +1 -1
  91. package/dist/src/spi/protocol-adapter.d.ts +57 -0
  92. package/dist/src/spi/protocol-adapter.d.ts.map +1 -0
  93. package/dist/src/spi/protocol-adapter.js +2 -0
  94. package/dist/src/spi/protocol-adapter.js.map +1 -0
  95. package/dist/src/spi/tool.d.ts +24 -0
  96. package/dist/src/spi/tool.d.ts.map +1 -1
  97. package/dist/src/stores/factory.d.ts +8 -2
  98. package/dist/src/stores/factory.d.ts.map +1 -1
  99. package/dist/src/stores/factory.js +8 -2
  100. package/dist/src/stores/factory.js.map +1 -1
  101. package/dist/src/stores/lucid-schema.d.ts.map +1 -1
  102. package/dist/src/stores/lucid-schema.js +2 -0
  103. package/dist/src/stores/lucid-schema.js.map +1 -1
  104. package/dist/src/stores/lucid.d.ts +12 -0
  105. package/dist/src/stores/lucid.d.ts.map +1 -1
  106. package/dist/src/stores/lucid.js +48 -1
  107. package/dist/src/stores/lucid.js.map +1 -1
  108. package/dist/src/stream-events.d.ts +2 -0
  109. package/dist/src/stream-events.d.ts.map +1 -1
  110. package/dist/src/testing/in-memory-store.d.ts +7 -0
  111. package/dist/src/testing/in-memory-store.d.ts.map +1 -1
  112. package/dist/src/testing/in-memory-store.js +37 -1
  113. package/dist/src/testing/in-memory-store.js.map +1 -1
  114. package/dist/src/tool-discovery.d.ts.map +1 -1
  115. package/dist/src/tool-discovery.js +27 -9
  116. package/dist/src/tool-discovery.js.map +1 -1
  117. package/dist/src/tool-filters.d.ts +33 -0
  118. package/dist/src/tool-filters.d.ts.map +1 -0
  119. package/dist/src/tool-filters.js +45 -0
  120. package/dist/src/tool-filters.js.map +1 -0
  121. package/dist/src/tool-registry.d.ts +33 -5
  122. package/dist/src/tool-registry.d.ts.map +1 -1
  123. package/dist/src/tool-registry.js +55 -11
  124. package/dist/src/tool-registry.js.map +1 -1
  125. package/dist/src/types.d.ts +16 -0
  126. package/dist/src/types.d.ts.map +1 -1
  127. package/package.json +22 -3
  128. package/skills/agent-setup/SKILL.md +36 -0
  129. package/skills/agent-tools/SKILL.md +19 -1
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,6FAA6F;AAC7F,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,6FAA6F;IAC7F,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEhF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC;;;;OAIG;IACH,WAAW,EAAE,gBAAgB,CAAC;IAC9B,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wHAAwH;IACxH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IACvD;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,4EAA4E;AAC5E,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,gBAAgB,CAAC;CAC/B;AAED,qDAAqD;AACrD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB;AAED,gCAAgC;AAChC,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;;;OAIG;IACH,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,4FAA4F;IAC5F,YAAY,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,OAAO,GACP,YAAY,GACZ,SAAS,GACT,WAAW,GACX,mBAAmB,CAAC;AAExB,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,sDAAsD;AACtD,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE1D;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,mGAAmG;IACnG,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,GAAG,EAAE,MAAM,CAAC;IACZ,kFAAkF;IAClF,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;CACd;AAED,uDAAuD;AACvD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,eAAe,EAAE,CAAC;IAC9B,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,mGAAmG;IACnG,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,aAAa,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAE7E,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,iGAAiG;IACjG,YAAY,EAAE,MAAM,GAAG,aAAa,CAAC;IACrC,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,gFAAgF;AAChF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,sGAAsG;IACtG,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,+CAA+C;AAC/C,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;IACb,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,sGAAsG;IACtG,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,8FAA8F;IAC9F,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,YAAY;IAC3B,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+FAA+F;IAC/F,YAAY,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC;IACtC,oFAAoF;IACpF,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB;;;;;;;;;;OAUG;IACH,WAAW,CAAC,EAAE,CAAC,MAAM,GAAG,YAAY,CAAC,EAAE,CAAC;IACxC,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;;;;;OAQG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IACd;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,eAAe,EAAE,CAAC;IAC9B,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,uGAAuG;IACvG,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,+FAA+F;IAC/F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mGAAmG;IACnG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACxB;;;;OAIG;IACH,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B;;;OAGG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,2EAA2E;AAC3E,MAAM,MAAM,oBAAoB,GAAG,IAAI,GAAG,MAAM,CAAC;AAEjD,qFAAqF;AACrF,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,oBAAoB,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;AAErF,oGAAoG;AACpG,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,sBAAsB,CAAC;IAC/B,mGAAmG;IACnG,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAa,SAAQ,aAAa;IACjD,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B;;;OAGG;IACH,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,MAAM,cAAc,GACtB,eAAe,GACf,kBAAkB,GAClB,UAAU,GACV,UAAU,GACV,QAAQ;AACV,4EAA4E;GAC1E,SAAS,CAAC;AAEd,4FAA4F;AAC5F,MAAM,WAAW,qBAAqB;IACpC,6DAA6D;IAC7D,OAAO,EAAE,OAAO,CAAC;IACjB,6DAA6D;IAC7D,MAAM,EAAE,WAAW,GAAG,WAAW,GAAG,IAAI,CAAC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,iDAAiD;IACjD,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,qBAAqB,CAAC;IACnC,oFAAoF;IACpF,MAAM,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAC7B,8EAA8E;IAC9E,KAAK,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;IAC7B,oEAAoE;IACpE,QAAQ,EAAE;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;CAClC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@adonis-agora/agent",
3
- "version": "0.54.0",
3
+ "version": "0.56.0",
4
4
  "description": "Governed, durable-backed AI agent (chat + tool-calling + governance) for AdonisJS — part of the Agora ecosystem.",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -66,6 +66,11 @@
66
66
  "import": "./dist/src/testing/index.js",
67
67
  "default": "./dist/src/testing/index.js"
68
68
  },
69
+ "./ag-ui": {
70
+ "types": "./dist/src/ag-ui/index.d.ts",
71
+ "import": "./dist/src/ag-ui/index.js",
72
+ "default": "./dist/src/ag-ui/index.js"
73
+ },
69
74
  "./durable": {
70
75
  "types": "./dist/src/durable/index.d.ts",
71
76
  "import": "./dist/src/durable/index.js",
@@ -151,6 +156,11 @@
151
156
  "import": "./dist/src/react/genui/json-render.js",
152
157
  "default": "./dist/src/react/genui/json-render.js"
153
158
  },
159
+ "./react/media": {
160
+ "types": "./dist/src/react/media.d.ts",
161
+ "import": "./dist/src/react/media.js",
162
+ "default": "./dist/src/react/media.js"
163
+ },
154
164
  "./react/markdown": {
155
165
  "types": "./dist/src/react/markdown.d.ts",
156
166
  "import": "./dist/src/react/markdown.js",
@@ -195,7 +205,8 @@
195
205
  "@adonisjs/lucid": "^22.4.0",
196
206
  "@adonisjs/redis": "^9.2.0 || ^10.0.0 || ^11.0.0",
197
207
  "@dudousxd/nestjs-agent-core": ">=0.26.0 <1.0.0",
198
- "@dudousxd/nestjs-agent-react": ">=0.28.0 <1.0.0",
208
+ "@dudousxd/nestjs-agent-react": ">=0.30.0 <1.0.0",
209
+ "@dudousxd/nestjs-media-client": ">=0.3.0 <1.0.0",
199
210
  "@qdrant/js-client-rest": "^1.11.0",
200
211
  "ai": "^7.0.0",
201
212
  "node-sql-parser": "^5.3.0",
@@ -248,6 +259,9 @@
248
259
  "@dudousxd/nestjs-agent-react": {
249
260
  "optional": true
250
261
  },
262
+ "@dudousxd/nestjs-media-client": {
263
+ "optional": true
264
+ },
251
265
  "@adonis-agora/media": {
252
266
  "optional": true
253
267
  }
@@ -261,9 +275,12 @@
261
275
  "@adonisjs/core": "7.5.2",
262
276
  "@adonisjs/lucid": "22.4.2",
263
277
  "@adonisjs/redis": "11.0.0",
278
+ "@ag-ui/client": "1.0.1",
279
+ "@ag-ui/core": "1.0.1",
264
280
  "@ai-sdk/react": "^4.0.125",
265
281
  "@dudousxd/nestjs-agent-core": "0.33.0",
266
- "@dudousxd/nestjs-agent-react": "0.28.0",
282
+ "@dudousxd/nestjs-agent-react": "0.31.0",
283
+ "@dudousxd/nestjs-media-client": "0.3.0",
267
284
  "@qdrant/js-client-rest": "1.19.0",
268
285
  "@tanstack/intent": "0.4.0",
269
286
  "@testing-library/dom": "10.4.2",
@@ -272,6 +289,7 @@
272
289
  "@types/react": "19.3.0",
273
290
  "@types/react-dom": "19.3.0",
274
291
  "ai": "7.0.102",
292
+ "ajv": "^8.20.0",
275
293
  "better-sqlite3": "13.0.3",
276
294
  "jsdom": "30.1.1",
277
295
  "luxon": "3.7.2",
@@ -279,6 +297,7 @@
279
297
  "pg": "8.23.0",
280
298
  "react": "19.3.0",
281
299
  "react-dom": "19.3.0",
300
+ "rxjs": "^7.8.1",
282
301
  "typescript": "7.0.2",
283
302
  "vitest": "5.0.2",
284
303
  "zod": "4.6.5"
@@ -233,8 +233,44 @@ function Chat() {
233
233
  made mid-turn is queued (`whileRunning: 'block'` to refuse instead). `path` on the provider must
234
234
  match `config/agent.ts`'s `path`.
235
235
 
236
+ ### Pattern 5 — serve an AG-UI client with `agUiAdapter()`
237
+
238
+ ```ts
239
+ // config/agent.ts
240
+ import { agUiAdapter } from '@adonis-agora/agent/ag-ui'
241
+
242
+ export default defineConfig({
243
+ // …
244
+ adapters: [agUiAdapter()], // mounts POST <path>/ag-ui — a RunAgentInput in, AG-UI 1.0 events out
245
+ })
246
+ ```
247
+
248
+ ```ts
249
+ import { HttpAgent } from '@ag-ui/client'
250
+
251
+ const agent = new HttpAgent({ url: '/agent/ag-ui' })
252
+ agent.addMessage({ id: crypto.randomUUID(), role: 'user', content: 'Refund order 7' })
253
+ await agent.runAgent()
254
+ ```
255
+
256
+ A run that parks on an approval or a question set ENDS with `outcome: { type: 'interrupt' }`;
257
+ answer it in the next request's `resume` (`{ approved: boolean }` for `tool_approval`,
258
+ `{ answers }` for `input_required`). The interrupt id is the whole address, so with a shared
259
+ token sink any replica serves the resume. The native stream is unchanged.
260
+
261
+ Source: `packages/adonis/docs/ag-ui.mdx`, `packages/adonis/src/ag-ui/`.
262
+
236
263
  ## Common mistakes
237
264
 
265
+ ### MEDIUM — restating history to the AG-UI route and expecting it to be read
266
+
267
+ The route answers the LAST user message of `messages`; the thread's history is the one the server
268
+ stored under `threadId`. Media parts must be inline (`source.type: 'data'`) and need
269
+ `attachments:` configured — a `url` or `file` source is dropped with an `agora.warning`.
270
+
271
+ Source: `packages/adonis/docs/ag-ui.mdx`.
272
+
273
+
238
274
  ### HIGH — calling `useAgentChat()` outside `<AgentProvider>`
239
275
 
240
276
  ```tsx
@@ -50,7 +50,7 @@ export default class GetWeather extends ReadTool<Input, { tempC: number }> {
50
50
  name: 'get_weather',
51
51
  description: 'Current weather for a city.',
52
52
  input,
53
- roles: ['MEMBER'], // omit → config.defaultRoles (['ADMIN'] by default)
53
+ roles: ['MEMBER'], // omit → config.defaultRoles ([] — open — by default)
54
54
  }
55
55
 
56
56
  async execute({ city }: Input, _ctx: AiToolCtx) {
@@ -209,6 +209,24 @@ arguments and expires (`ttlMs`, default 15 min).
209
209
  Source: `packages/adonis/docs/mcp.mdx` ("Writes with a human gate"),
210
210
  `packages/adonis/src/confirmed-tool.ts`.
211
211
 
212
+ ## Feature flags and per-user gates — `enabled`, `isEnabled()`, `canUse(actor)`
213
+
214
+ ```ts
215
+ // A flag with no service behind it: on the options (boolean, or a predicate re-read every turn).
216
+ static tool = { name: 'search_docs', description: '...', input, enabled: () => env.get('DOCS') === true }
217
+
218
+ // A flag or entitlement that needs a service: methods on the (container-resolved) class.
219
+ isEnabled() { return this.flags.on('docs') }
220
+ canUse(actor: Actor) { return this.plans.includesDocs(actor.tenantRef) }
221
+ ```
222
+
223
+ `defineTool` / `defineConfirmedTool` take `enabled` and `canUse` as options; `mcpServers[]`
224
+ takes both per server. Order on the offered list AND on invoke: allow-list → `enabled` →
225
+ `RolesPolicy` → `canUse`; none can widen. A disabled tool is never shown to the model and
226
+ invoking one throws `ToolDisabledError` (not `ToolForbiddenError`). Prefer these to registering a
227
+ tool conditionally, and to refusing inside `execute` (which costs the model a turn).
228
+ Source: `packages/adonis/docs/authoring/tools.mdx`, `packages/adonis/src/tool-filters.ts`.
229
+
212
230
  ## Common mistakes
213
231
 
214
232
  ### CRITICAL — shipping a privileged tool without `roles`