@agentica/core 0.19.0 → 0.20.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 (59) hide show
  1. package/lib/context/AgenticaOperation.d.ts +3 -4
  2. package/lib/context/internal/AgenticaOperationComposer.js +8 -1
  3. package/lib/context/internal/AgenticaOperationComposer.js.map +1 -1
  4. package/lib/context/internal/AgenticaOperationComposer.spec.js +39 -10
  5. package/lib/context/internal/AgenticaOperationComposer.spec.js.map +1 -1
  6. package/lib/functional/assertHttpLlmApplication.js +168 -168
  7. package/lib/functional/assertMcpController.d.ts +24 -0
  8. package/lib/functional/assertMcpController.js +1701 -0
  9. package/lib/functional/assertMcpController.js.map +1 -0
  10. package/lib/functional/validateHttpLlmApplication.js +148 -148
  11. package/lib/index.d.ts +1 -1
  12. package/lib/index.js +1 -1
  13. package/lib/index.js.map +1 -1
  14. package/lib/index.mjs +2013 -404
  15. package/lib/index.mjs.map +1 -1
  16. package/lib/orchestrate/call.js +11 -1
  17. package/lib/orchestrate/call.js.map +1 -1
  18. package/lib/orchestrate/initialize.js +60 -60
  19. package/lib/structures/IAgenticaController.d.ts +8 -4
  20. package/lib/structures/mcp/index.d.ts +0 -2
  21. package/lib/structures/mcp/index.js +0 -2
  22. package/lib/structures/mcp/index.js.map +1 -1
  23. package/lib/utils/AsyncQueue.d.ts +10 -0
  24. package/lib/utils/AsyncQueue.js +33 -9
  25. package/lib/utils/AsyncQueue.js.map +1 -1
  26. package/lib/utils/AsyncQueue.spec.d.ts +1 -0
  27. package/lib/utils/AsyncQueue.spec.js +280 -0
  28. package/lib/utils/AsyncQueue.spec.js.map +1 -0
  29. package/lib/utils/MPSC.spec.d.ts +1 -0
  30. package/lib/utils/MPSC.spec.js +222 -0
  31. package/lib/utils/MPSC.spec.js.map +1 -0
  32. package/lib/utils/StreamUtil.spec.d.ts +1 -0
  33. package/lib/utils/StreamUtil.spec.js +471 -0
  34. package/lib/utils/StreamUtil.spec.js.map +1 -0
  35. package/package.json +3 -3
  36. package/src/context/AgenticaOperation.ts +5 -6
  37. package/src/context/internal/AgenticaOperationComposer.spec.ts +45 -14
  38. package/src/context/internal/AgenticaOperationComposer.ts +10 -2
  39. package/src/functional/assertMcpController.ts +49 -0
  40. package/src/index.ts +1 -1
  41. package/src/orchestrate/call.ts +14 -4
  42. package/src/structures/IAgenticaController.ts +9 -4
  43. package/src/structures/mcp/index.ts +0 -2
  44. package/src/utils/AsyncQueue.spec.ts +355 -0
  45. package/src/utils/AsyncQueue.ts +36 -8
  46. package/src/utils/MPSC.spec.ts +276 -0
  47. package/src/utils/StreamUtil.spec.ts +520 -0
  48. package/lib/functional/assertMcpLlmApplication.d.ts +0 -18
  49. package/lib/functional/assertMcpLlmApplication.js +0 -74
  50. package/lib/functional/assertMcpLlmApplication.js.map +0 -1
  51. package/lib/structures/mcp/IMcpLlmApplication.d.ts +0 -9
  52. package/lib/structures/mcp/IMcpLlmApplication.js +0 -3
  53. package/lib/structures/mcp/IMcpLlmApplication.js.map +0 -1
  54. package/lib/structures/mcp/IMcpLlmFunction.d.ts +0 -17
  55. package/lib/structures/mcp/IMcpLlmFunction.js +0 -3
  56. package/lib/structures/mcp/IMcpLlmFunction.js.map +0 -1
  57. package/src/functional/assertMcpLlmApplication.ts +0 -32
  58. package/src/structures/mcp/IMcpLlmApplication.ts +0 -10
  59. package/src/structures/mcp/IMcpLlmFunction.ts +0 -19
@@ -0,0 +1,24 @@
1
+ import type { Client } from "@modelcontextprotocol/sdk/client/index.d.ts";
2
+ import type { ILlmSchema, IMcpLlmApplication } from "@samchon/openapi";
3
+ import type { IAgenticaController } from "../structures/IAgenticaController";
4
+ /**
5
+ * Create an MCP controller with type assertion.
6
+ *
7
+ * Create an {@link IAgenticaController.IMcp} instance which represents
8
+ * an MCP (Model Context Protocol) controller with LLM function calling
9
+ * schemas and client connection.
10
+ *
11
+ * @param props Properties to create the MCP controller
12
+ * @param props.name Name of the MCP implementation.
13
+ * @param props.client Client connection to the MCP implementation.
14
+ * @param props.model Model schema of the LLM function calling.
15
+ * @param props.options Options to create the MCP controller.
16
+ * @returns MCP LLM application instance
17
+ * @author Samchon
18
+ */
19
+ export declare function assertMcpController<Model extends ILlmSchema.Model>(props: {
20
+ name: string;
21
+ client: Client;
22
+ model: Model;
23
+ options?: Partial<IMcpLlmApplication.IOptions<Model>>;
24
+ }): Promise<IAgenticaController.IMcp<Model>>;