@kenhkl/agent-moss 0.16.9 → 0.16.13

package/dist/server.d.ts

@@ -27,5 +27,22 @@ declare function startServer(host?: string, port?: number): Promise<{
     serve: () => Promise<void>;
     port: number;
 }>;
+/**
+ * 以 **Unix Domain Socket** 方式启动（镜像 Python `server/socket_server.py` 的
+ * `agent-moss server --mode socket`）。复用同一份 Hono app/路由，只换传输层。
+ *
+ * 为什么需要：同机多实例 / 不想占用 TCP 端口 / 只允许本机访问的部署。
+ * 用 `node:http` 的 createServer + `getRequestListener(app.fetch)` 而不是
+ * `@hono/node-server` 的 serve() —— 后者只接受 `{hostname, port}`，不支持 uds。
+ *
+ * 与 TCP 模式的差异：无端口占用探测（socket 路径是显式的）；启动前清理**残留 socket
+ * 文件**（进程被 kill -9 时文件会留下，直接 bind 会 EADDRINUSE 起不来 —— 这也是
+ * Python 侧 uvicorn 的同款坑，见 socket_server.py 的说明）。
+ */
+declare function startUnixSocketServer(socketPath?: string): Promise<{
+    socketPath: string;
+    serve: () => Promise<void>;
+    close: () => Promise<void>;
+}>;
 
-export { createApp, findFreePort, logDeploymentSelfCheck, startServer };
+export { createApp, findFreePort, logDeploymentSelfCheck, startServer, startUnixSocketServer };