@agentica/rpc 0.16.4 → 0.16.7

package/lib/IMicroAgenticaRpcListener.d.ts

@@ -0,0 +1,89 @@
+import type { IAgenticaEventJson } from "@agentica/core";
+/**
+ * RPC interface of Micro agent listener.
+ *
+ * `IMicroAgenticaRpcListener` is an interface defining an AI agent listener
+ * provided from the client to server through the RPC (Remote Procedure Call)
+ * paradigm in the websocket protocol.
+ *
+ * It has defined the event listener functions of {@link MicroAgenticaEvent}
+ * types. If you skip some event typed functions' implementations,
+ * the skipped event would be ignored.
+ *
+ * Also, the event like listener functions of `IMicroAgenticaRpcListener` type
+ * are remotely called when a client calls the
+ * {@link IAgenticaRpcService.conversate} function remotely, so that the
+ * server responses to the client by the event listener functions.
+ *
+ * You can connect to the WebSocket server of the AI agent like below:
+ *
+ * ```typescript
+ * import {
+ *   IMicroAgenticaRpcListener,
+ *   IAgenticaRpcService
+ * } from "@agentica/core";
+ * import { Driver, WebSocketConnector } from "tgrid";
+ *
+ * const connector: WebSocketConnector<
+ *   null,
+ *   IMicroAgenticaRpcListener,
+ *   IAgenticaRpcService
+ * > = new WebSocketConnector(null, {
+ *   text: async (evt) => {
+ *     console.log(evt.role, evt.text);
+ *   },
+ *   describe: async (evt) => {
+ *     console.log("describer", evt.text);
+ *   },
+ * });
+ * await connector.connect("ws://localhost:3001");
+ *
+ * const driver: Driver<IAgenticaRpcService> = connector.getDriver();
+ * await driver.conversate("Hello, what you can do?");
+ * ```
+ *
+ * @author Samchon
+ */
+export interface IMicroAgenticaRpcListener {
+    /**
+     * Describe the function executions' results.
+     *
+     * Inform description message of the function execution's results from
+     * the AI agent server to client.
+     *
+     * @param evt Event of a description of function execution results
+     */
+    describe: (evt: IAgenticaEventJson.IDescribe) => Promise<void>;
+    /**
+     * Text conversation message.
+     *
+     * @param evt Event of a text conversation message
+     */
+    text: (evt: IAgenticaEventJson.IText) => Promise<void>;
+    /**
+     * Call a function.
+     *
+     * Informs a function calling from the AI agent server to client.
+     *
+     * This event comes before the function execution, so that if you return
+     * a different value from the original {@link IAgenticaEventJson.ICall.arguments},
+     * you can modify the arguments of the function calling.
+     *
+     * Otherwise you do not return anything (`undefined`) or `null` value, the
+     * arguments of the function calling would not be modified. Also, if you are
+     * not interested in the function calling event, you can skit its
+     * implementation.
+     *
+     * @param evt Event of a function calling
+     * @return New arguments if you want to modify, otherwise null or undefined
+     */
+    call?: (evt: IAgenticaEventJson.ICall) => Promise<object | null | void | undefined>;
+    /**
+     * Executition of a function.
+     *
+     * Informs a function execution from the AI agent server to client.
+     *
+     * @param evt Event of a function execution
+     */
+    execute?: (evt: IAgenticaEventJson.IExecute) => Promise<void>;
+}

package/lib/IMicroAgenticaRpcListener.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IMicroAgenticaRpcListener.js.map

package/lib/IMicroAgenticaRpcListener.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IMicroAgenticaRpcListener.js","sourceRoot":"","sources":["../src/IMicroAgenticaRpcListener.ts"],"names":[],"mappings":""}

package/lib/MicroAgenticaRpcService.d.ts

@@ -0,0 +1,79 @@
+import type { IAgenticaController, MicroAgentica } from "@agentica/core";
+import type { ILlmSchema } from "@samchon/openapi";
+import type { IAgenticaRpcService } from "./IAgenticaRpcService";
+import type { IMicroAgenticaRpcListener } from "./IMicroAgenticaRpcListener";
+/**
+ * RPC service for the {@link MicroAgentica}.
+ *
+ * `MicroAgenticaRpcService` is class defining an AI agent service
+ * provided from the server to clients through the RPC (Remote Procedure Call)
+ * paradigm in the websocket protocol.
+ *
+ * Client connecting to the `MicroAgenticaRpcService` providing websocket server
+ * will call the {@link conversate} function remotely through its basic
+ * interface type {@link IAgenticaRpcService} with the RPC paradigm.
+ *
+ * Also, the client provides the {@link IMicroAgenticaRpcListener} type to the
+ * server, so that `MicroAgenticaRpcService` will remotely call the
+ * {@link IMicroAgenticaRpcListener listener}'s functions internally.
+ *
+ * You can open the WebSocket server of the AI agent like below:
+ *
+ * ```typescript
+ * import {
+ *   IMicroAgenticaRpcListener,
+ *   IAgenticaRpcService,
+ *   Agentica,
+ *   MicroAgenticaRpcService,
+ * } from "@agentica/core";
+ * import { WebSocketServer } from "tgrid";
+ *
+ * const server: WebSocketServer<
+ *   null,
+ *   IAgenticaRpcService,
+ *   IMicroAgenticaRpcListener
+ * > = new WebSocketServer();
+ * await server.open(3001, async (acceptor) => {
+ *   await acceptor.accept(
+ *     new MicroAgenticaRpcService({
+ *       agent: new MicroAgentica({ ... }),
+ *       listener: acceptor.getDriver(),
+ *     }),
+ *   );
+ * });
+ * ```
+ *
+ * @author Samchon
+ */
+export declare class MicroAgenticaRpcService<Model extends ILlmSchema.Model> implements IAgenticaRpcService<Model> {
+    private readonly props;
+    /**
+     * Initializer Constructor.
+     *
+     * @param props Properties to construct the RPC service
+     */
+    constructor(props: MicroAgenticaRpcService.IProps<Model>);
+    /**
+     * @inheritDoc
+     */
+    conversate(content: string): Promise<void>;
+    /**
+     * @inheritDoc
+     */
+    getControllers(): Promise<IAgenticaController<Model>[]>;
+}
+export declare namespace MicroAgenticaRpcService {
+    /**
+     * Properties to construct the RPC service.
+     */
+    interface IProps<Model extends ILlmSchema.Model> {
+        /**
+         * AI agent to be controlled.
+         */
+        agent: MicroAgentica<Model>;
+        /**
+         * Listener to be notified.
+         */
+        listener: IMicroAgenticaRpcListener;
+    }
+}

package/lib/MicroAgenticaRpcService.js

@@ -0,0 +1,103 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MicroAgenticaRpcService = void 0;
+/**
+ * RPC service for the {@link MicroAgentica}.
+ *
+ * `MicroAgenticaRpcService` is class defining an AI agent service
+ * provided from the server to clients through the RPC (Remote Procedure Call)
+ * paradigm in the websocket protocol.
+ *
+ * Client connecting to the `MicroAgenticaRpcService` providing websocket server
+ * will call the {@link conversate} function remotely through its basic
+ * interface type {@link IAgenticaRpcService} with the RPC paradigm.
+ *
+ * Also, the client provides the {@link IMicroAgenticaRpcListener} type to the
+ * server, so that `MicroAgenticaRpcService` will remotely call the
+ * {@link IMicroAgenticaRpcListener listener}'s functions internally.
+ *
+ * You can open the WebSocket server of the AI agent like below:
+ *
+ * ```typescript
+ * import {
+ *   IMicroAgenticaRpcListener,
+ *   IAgenticaRpcService,
+ *   Agentica,
+ *   MicroAgenticaRpcService,
+ * } from "@agentica/core";
+ * import { WebSocketServer } from "tgrid";
+ *
+ * const server: WebSocketServer<
+ *   null,
+ *   IAgenticaRpcService,
+ *   IMicroAgenticaRpcListener
+ * > = new WebSocketServer();
+ * await server.open(3001, async (acceptor) => {
+ *   await acceptor.accept(
+ *     new MicroAgenticaRpcService({
+ *       agent: new MicroAgentica({ ... }),
+ *       listener: acceptor.getDriver(),
+ *     }),
+ *   );
+ * });
+ * ```
+ *
+ * @author Samchon
+ */
+class MicroAgenticaRpcService {
+    /**
+     * Initializer Constructor.
+     *
+     * @param props Properties to construct the RPC service
+     */
+    constructor(props) {
+        this.props = props;
+        const { agent, listener } = props;
+        // ESSENTIAL LISTENERS
+        agent.on("text", (evt) => __awaiter(this, void 0, void 0, function* () {
+            yield evt.join();
+            listener.text(evt.toJSON()).catch(() => { });
+        }));
+        agent.on("describe", (evt) => __awaiter(this, void 0, void 0, function* () {
+            yield evt.join();
+            listener.describe(evt.toJSON()).catch(() => { });
+        }));
+        // OPTIONAL LISTENERS
+        agent.on("call", (evt) => __awaiter(this, void 0, void 0, function* () {
+            const args = yield listener.call(evt.toJSON());
+            if (args != null) {
+                evt.arguments = args;
+            }
+        }));
+        agent.on("execute", (evt) => __awaiter(this, void 0, void 0, function* () {
+            listener.execute(evt.toJSON()).catch(() => { });
+        }));
+    }
+    /**
+     * @inheritDoc
+     */
+    conversate(content) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.props.agent.conversate(content);
+        });
+    }
+    /**
+     * @inheritDoc
+     */
+    getControllers() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.props.agent.getControllers();
+        });
+    }
+}
+exports.MicroAgenticaRpcService = MicroAgenticaRpcService;
+//# sourceMappingURL=MicroAgenticaRpcService.js.map

package/lib/MicroAgenticaRpcService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MicroAgenticaRpcService.js","sourceRoot":"","sources":["../src/MicroAgenticaRpcService.ts"],"names":[],"mappings":";;;;;;;;;;;;AAMA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,MAAa,uBAAuB;IAElC;;;;OAIG;IACH,YAAoC,KAA4C;QAA5C,UAAK,GAAL,KAAK,CAAuC;QAC9E,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;QAElC,sBAAsB;QACtB,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAO,GAAG,EAAE,EAAE;YAC7B,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YACjB,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC9C,CAAC,CAAA,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,UAAU,EAAE,CAAO,GAAG,EAAE,EAAE;YACjC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YACjB,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAClD,CAAC,CAAA,CAAC,CAAC;QAEH,qBAAqB;QACrB,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAO,GAAG,EAAE,EAAE;YAC7B,MAAM,IAAI,GAAqC,MAAM,QAAQ,CAAC,IAAK,CACjE,GAAG,CAAC,MAAM,EAAE,CACb,CAAC;YACF,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;gBACjB,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC;YACvB,CAAC;QACH,CAAC,CAAA,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,CAAO,GAAG,EAAE,EAAE;YAChC,QAAQ,CAAC,OAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAClD,CAAC,CAAA,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACU,UAAU,CAAC,OAAe;;YACrC,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAC7C,CAAC;KAAA;IAED;;OAEG;IACU,cAAc;;YACzB,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,EAAkC,CAAC;QAC3E,CAAC;KAAA;CACF;AA/CD,0DA+CC"}

package/lib/index.d.ts

@@ -1,3 +1,5 @@
 export * from "./AgenticaRpcService";
 export * from "./IAgenticaRpcListener";
 export * from "./IAgenticaRpcService";
+export * from "./IMicroAgenticaRpcListener";
+export * from "./MicroAgenticaRpcService";

package/lib/index.js

@@ -17,4 +17,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./AgenticaRpcService"), exports);
 __exportStar(require("./IAgenticaRpcListener"), exports);
 __exportStar(require("./IAgenticaRpcService"), exports);
+__exportStar(require("./IMicroAgenticaRpcListener"), exports);
+__exportStar(require("./MicroAgenticaRpcService"), exports);
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAqC;AACrC,yDAAuC;AACvC,wDAAsC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAqC;AACrC,yDAAuC;AACvC,wDAAsC;AACtC,8DAA4C;AAC5C,4DAA0C"}

package/lib/index.mjs

@@ -37,5 +37,35 @@ class AgenticaRpcService {
     }
 }
 
-export { AgenticaRpcService };
+class MicroAgenticaRpcService {
+    constructor(props) {
+        this.props = props;
+        const {agent, listener} = props;
+        agent.on("text", (async evt => {
+            await evt.join();
+            listener.text(evt.toJSON()).catch((() => {}));
+        }));
+        agent.on("describe", (async evt => {
+            await evt.join();
+            listener.describe(evt.toJSON()).catch((() => {}));
+        }));
+        agent.on("call", (async evt => {
+            const args = await listener.call(evt.toJSON());
+            if (args != null) {
+                evt.arguments = args;
+            }
+        }));
+        agent.on("execute", (async evt => {
+            listener.execute(evt.toJSON()).catch((() => {}));
+        }));
+    }
+    async conversate(content) {
+        await this.props.agent.conversate(content);
+    }
+    async getControllers() {
+        return this.props.agent.getControllers();
+    }
+}
+
+export { AgenticaRpcService, MicroAgenticaRpcService };
 //# sourceMappingURL=index.mjs.map

package/lib/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":["../src/AgenticaRpcService.ts"],"sourcesContent":[null],"names":["AgenticaRpcService","constructor","props","this","agent","listener","on","async","evt","join","text","toJSON","catch","describe","initialize","select","cancel","args","call","arguments","execute","conversate","content","getControllers"],"mappings":"MAiDaA;IAOX,WAAAC,CAAoCC;QAAAC,KAAKD,QAALA;QAClC,OAAME,OAAOC,YAAeH;QAG5BE,MAAME,GAAG,SAAQC,MAAOC;kBAChBA,IAAIC;YACVJ,SAASK,KAAKF,IAAIG,UAAUC,OAAM;AAAS;QAE7CR,MAAME,GAAG,aAAYC,MAAOC;kBACpBA,IAAIC;YACVJ,SAASQ,SAASL,IAAIG,UAAUC,OAAM;AAAS;QAIjDR,MAAME,GAAG,eAAcC,MAAOC;YAC5BH,SAASS,WAAYN,IAAIG,UAAUC,OAAM;AAAS;QAEpDR,MAAME,GAAG,WAAUC,MAAOC;YACxBH,SAASU,OAAQP,IAAIG,UAAUC,OAAM;AAAS;QAEhDR,MAAME,GAAG,WAAUC,MAAOC;YACxBH,SAASW,OAAQR,IAAIG,UAAUC,OAAM;AAAS;QAEhDR,MAAME,GAAG,SAAQC,MAAOC;YACtB,MAAMS,aAA+CZ,SAASa,KAC5DV,IAAIG;YAEN,IAAIM,QAAQ,MAAM;gBAChBT,IAAIW,YAAYF;;;QAGpBb,MAAME,GAAG,YAAWC,MAAOC;YACzBH,SAASe,QAASZ,IAAIG,UAAUC,OAAM;AAAS;;IAO5C,gBAAMS,CAAWC;cAChBnB,KAAKD,MAAME,MAAMiB,WAAWC;;IAM7B,oBAAMC;QACX,OAAOpB,KAAKD,MAAME,MAAMmB;;;;"}
+{"version":3,"file":"index.mjs","sources":["../src/AgenticaRpcService.ts","../src/MicroAgenticaRpcService.ts"],"sourcesContent":[null,null],"names":["AgenticaRpcService","constructor","props","this","agent","listener","on","async","evt","join","text","toJSON","catch","describe","initialize","select","cancel","args","call","arguments","execute","conversate","content","getControllers","MicroAgenticaRpcService"],"mappings":"MAiDaA;IAOX,WAAAC,CAAoCC;QAAAC,KAAKD,QAALA;QAClC,OAAME,OAAOC,YAAeH;QAG5BE,MAAME,GAAG,SAAQC,MAAOC;kBAChBA,IAAIC;YACVJ,SAASK,KAAKF,IAAIG,UAAUC,OAAM;AAAS;QAE7CR,MAAME,GAAG,aAAYC,MAAOC;kBACpBA,IAAIC;YACVJ,SAASQ,SAASL,IAAIG,UAAUC,OAAM;AAAS;QAIjDR,MAAME,GAAG,eAAcC,MAAOC;YAC5BH,SAASS,WAAYN,IAAIG,UAAUC,OAAM;AAAS;QAEpDR,MAAME,GAAG,WAAUC,MAAOC;YACxBH,SAASU,OAAQP,IAAIG,UAAUC,OAAM;AAAS;QAEhDR,MAAME,GAAG,WAAUC,MAAOC;YACxBH,SAASW,OAAQR,IAAIG,UAAUC,OAAM;AAAS;QAEhDR,MAAME,GAAG,SAAQC,MAAOC;YACtB,MAAMS,aAA+CZ,SAASa,KAC5DV,IAAIG;YAEN,IAAIM,QAAQ,MAAM;gBAChBT,IAAIW,YAAYF;;;QAGpBb,MAAME,GAAG,YAAWC,MAAOC;YACzBH,SAASe,QAASZ,IAAIG,UAAUC,OAAM;AAAS;;IAO5C,gBAAMS,CAAWC;cAChBnB,KAAKD,MAAME,MAAMiB,WAAWC;;IAM7B,oBAAMC;QACX,OAAOpB,KAAKD,MAAME,MAAMmB;;;;MCtDfC;IAOX,WAAAvB,CAAoCC;QAAAC,KAAKD,QAALA;QAClC,OAAME,OAAOC,YAAeH;QAG5BE,MAAME,GAAG,SAAQC,MAAOC;kBAChBA,IAAIC;YACVJ,SAASK,KAAKF,IAAIG,UAAUC,OAAM;AAAS;QAE7CR,MAAME,GAAG,aAAYC,MAAOC;kBACpBA,IAAIC;YACVJ,SAASQ,SAASL,IAAIG,UAAUC,OAAM;AAAS;QAIjDR,MAAME,GAAG,SAAQC,MAAOC;YACtB,MAAMS,aAA+CZ,SAASa,KAC5DV,IAAIG;YAEN,IAAIM,QAAQ,MAAM;gBAChBT,IAAIW,YAAYF;;;QAGpBb,MAAME,GAAG,YAAWC,MAAOC;YACzBH,SAASe,QAASZ,IAAIG,UAAUC,OAAM;AAAS;;IAO5C,gBAAMS,CAAWC;cAChBnB,KAAKD,MAAME,MAAMiB,WAAWC;;IAM7B,oBAAMC;QACX,OAAOpB,KAAKD,MAAME,MAAMmB;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentica/rpc",
-  "version": "0.16.4",
+  "version": "0.16.7",
   "description": "Agentic AI Library specialized in LLM Function Calling",
   "author": "Wrtn Technologies",
   "license": "MIT",
@@ -37,7 +37,7 @@
   "dependencies": {
     "@samchon/openapi": "^4.0.0",
     "typia": "^9.0.1",
-    "@agentica/core": "^0.16.4"
+    "@agentica/core": "^0.16.7"
   },
   "devDependencies": {
     "@rollup/plugin-terser": "^0.4.4",

package/src/IMicroAgenticaRpcListener.ts

@@ -0,0 +1,93 @@
+import type { IAgenticaEventJson } from "@agentica/core";
+
+/**
+ * RPC interface of Micro agent listener.
+ *
+ * `IMicroAgenticaRpcListener` is an interface defining an AI agent listener
+ * provided from the client to server through the RPC (Remote Procedure Call)
+ * paradigm in the websocket protocol.
+ *
+ * It has defined the event listener functions of {@link MicroAgenticaEvent}
+ * types. If you skip some event typed functions' implementations,
+ * the skipped event would be ignored.
+ *
+ * Also, the event like listener functions of `IMicroAgenticaRpcListener` type
+ * are remotely called when a client calls the
+ * {@link IAgenticaRpcService.conversate} function remotely, so that the
+ * server responses to the client by the event listener functions.
+ *
+ * You can connect to the WebSocket server of the AI agent like below:
+ *
+ * ```typescript
+ * import {
+ *   IMicroAgenticaRpcListener,
+ *   IAgenticaRpcService
+ * } from "@agentica/core";
+ * import { Driver, WebSocketConnector } from "tgrid";
+ *
+ * const connector: WebSocketConnector<
+ *   null,
+ *   IMicroAgenticaRpcListener,
+ *   IAgenticaRpcService
+ * > = new WebSocketConnector(null, {
+ *   text: async (evt) => {
+ *     console.log(evt.role, evt.text);
+ *   },
+ *   describe: async (evt) => {
+ *     console.log("describer", evt.text);
+ *   },
+ * });
+ * await connector.connect("ws://localhost:3001");
+ *
+ * const driver: Driver<IAgenticaRpcService> = connector.getDriver();
+ * await driver.conversate("Hello, what you can do?");
+ * ```
+ *
+ * @author Samchon
+ */
+export interface IMicroAgenticaRpcListener {
+  /**
+   * Describe the function executions' results.
+   *
+   * Inform description message of the function execution's results from
+   * the AI agent server to client.
+   *
+   * @param evt Event of a description of function execution results
+   */
+  describe: (evt: IAgenticaEventJson.IDescribe) => Promise<void>;
+
+  /**
+   * Text conversation message.
+   *
+   * @param evt Event of a text conversation message
+   */
+  text: (evt: IAgenticaEventJson.IText) => Promise<void>;
+
+  /**
+   * Call a function.
+   *
+   * Informs a function calling from the AI agent server to client.
+   *
+   * This event comes before the function execution, so that if you return
+   * a different value from the original {@link IAgenticaEventJson.ICall.arguments},
+   * you can modify the arguments of the function calling.
+   *
+   * Otherwise you do not return anything (`undefined`) or `null` value, the
+   * arguments of the function calling would not be modified. Also, if you are
+   * not interested in the function calling event, you can skit its
+   * implementation.
+   *
+   * @param evt Event of a function calling
+   * @return New arguments if you want to modify, otherwise null or undefined
+   */
+  call?: (evt: IAgenticaEventJson.ICall) => Promise<object | null | void | undefined>;
+
+  /**
+   * Executition of a function.
+   *
+   * Informs a function execution from the AI agent server to client.
+   *
+   * @param evt Event of a function execution
+   */
+  execute?: (evt: IAgenticaEventJson.IExecute) => Promise<void>;
+}

package/src/MicroAgenticaRpcService.ts

@@ -0,0 +1,113 @@
+import type { IAgenticaController, MicroAgentica } from "@agentica/core";
+import type { ILlmSchema } from "@samchon/openapi";
+
+import type { IAgenticaRpcService } from "./IAgenticaRpcService";
+import type { IMicroAgenticaRpcListener } from "./IMicroAgenticaRpcListener";
+
+/**
+ * RPC service for the {@link MicroAgentica}.
+ *
+ * `MicroAgenticaRpcService` is class defining an AI agent service
+ * provided from the server to clients through the RPC (Remote Procedure Call)
+ * paradigm in the websocket protocol.
+ *
+ * Client connecting to the `MicroAgenticaRpcService` providing websocket server
+ * will call the {@link conversate} function remotely through its basic
+ * interface type {@link IAgenticaRpcService} with the RPC paradigm.
+ *
+ * Also, the client provides the {@link IMicroAgenticaRpcListener} type to the
+ * server, so that `MicroAgenticaRpcService` will remotely call the
+ * {@link IMicroAgenticaRpcListener listener}'s functions internally.
+ *
+ * You can open the WebSocket server of the AI agent like below:
+ *
+ * ```typescript
+ * import {
+ *   IMicroAgenticaRpcListener,
+ *   IAgenticaRpcService,
+ *   Agentica,
+ *   MicroAgenticaRpcService,
+ * } from "@agentica/core";
+ * import { WebSocketServer } from "tgrid";
+ *
+ * const server: WebSocketServer<
+ *   null,
+ *   IAgenticaRpcService,
+ *   IMicroAgenticaRpcListener
+ * > = new WebSocketServer();
+ * await server.open(3001, async (acceptor) => {
+ *   await acceptor.accept(
+ *     new MicroAgenticaRpcService({
+ *       agent: new MicroAgentica({ ... }),
+ *       listener: acceptor.getDriver(),
+ *     }),
+ *   );
+ * });
+ * ```
+ *
+ * @author Samchon
+ */
+export class MicroAgenticaRpcService<Model extends ILlmSchema.Model>
+implements IAgenticaRpcService<Model> {
+  /**
+   * Initializer Constructor.
+   *
+   * @param props Properties to construct the RPC service
+   */
+  public constructor(private readonly props: MicroAgenticaRpcService.IProps<Model>) {
+    const { agent, listener } = props;
+
+    // ESSENTIAL LISTENERS
+    agent.on("text", async (evt) => {
+      await evt.join();
+      listener.text(evt.toJSON()).catch(() => {});
+    });
+    agent.on("describe", async (evt) => {
+      await evt.join();
+      listener.describe(evt.toJSON()).catch(() => {});
+    });
+
+    // OPTIONAL LISTENERS
+    agent.on("call", async (evt) => {
+      const args: object | null | undefined | void = await listener.call!(
+        evt.toJSON(),
+      );
+      if (args != null) {
+        evt.arguments = args;
+      }
+    });
+    agent.on("execute", async (evt) => {
+      listener.execute!(evt.toJSON()).catch(() => {});
+    });
+  }
+
+  /**
+   * @inheritDoc
+   */
+  public async conversate(content: string): Promise<void> {
+    await this.props.agent.conversate(content);
+  }
+
+  /**
+   * @inheritDoc
+   */
+  public async getControllers(): Promise<IAgenticaController<Model>[]> {
+    return this.props.agent.getControllers() as IAgenticaController<Model>[];
+  }
+}
+export namespace MicroAgenticaRpcService {
+  /**
+   * Properties to construct the RPC service.
+   */
+  export interface IProps<Model extends ILlmSchema.Model> {
+    /**
+     * AI agent to be controlled.
+     */
+    agent: MicroAgentica<Model>;
+
+    /**
+     * Listener to be notified.
+     */
+    listener: IMicroAgenticaRpcListener;
+  }
+}

package/src/index.ts

@@ -1,3 +1,5 @@
 export * from "./AgenticaRpcService";
 export * from "./IAgenticaRpcListener";
 export * from "./IAgenticaRpcService";
+export * from "./IMicroAgenticaRpcListener";
+export * from "./MicroAgenticaRpcService";