npm - @fangyb/ahchat-bridge - Versions diffs - 0.1.0 - Mend

@fangyb/ahchat-bridge 0.1.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 (4) hide show

package/dist/cli.js ADDED Viewed

@@ -0,0 +1,177 @@
+import {
+  AgentManager,
+  AskQuestionRegistry,
+  GroupRegistry,
+  HttpAgentRegistry,
+  ServerConnector,
+  SessionStore,
+  acquireLock,
+  createGroupTaskDispatchHandler,
+  createModuleLogger,
+  createTaskDispatchHandler,
+  ensureDir,
+  formatAnswerForSDK,
+  listModels,
+  loadBridgeConfig,
+  wsMetrics
+} from "./chunk-7SODRWIG.js";
+// src/cli.ts
+import cac from "cac";
+var logger = createModuleLogger("bridge");
+var cli = cac("ahchat-bridge");
+cli.command("[command]", "Start the bridge (default: run)").option("--server-url <url>", "WebSocket URL of the AHChat server").option("--token <token>", "Auth token for server registration").option("--data-dir <dir>", "Data directory (default: ~/.ahchat)").option("--log-level <level>", "Log level (default: INFO)").action((args) => {
+  void runBridge({
+    serverUrl: args["server-url"],
+    token: args.token,
+    dataDir: args["data-dir"],
+    logLevel: args["log-level"]
+  });
+});
+cli.command("run", "Start the bridge and connect to server").option("--server-url <url>", "WebSocket URL of the AHChat server").option("--token <token>", "Auth token for server registration").option("--data-dir <dir>", "Data directory (default: ~/.ahchat)").option("--log-level <level>", "Log level (default: INFO)").action((args) => {
+  void runBridge({
+    serverUrl: args["server-url"],
+    token: args.token,
+    dataDir: args["data-dir"],
+    logLevel: args["log-level"]
+  });
+});
+cli.command("version", "Show bridge version").action(() => {
+  console.log("ahchat-bridge v0.1.0");
+});
+cli.help();
+cli.version("0.1.0");
+cli.parse();
+async function runBridge(args) {
+  let config = loadBridgeConfig();
+  if (args.serverUrl) {
+    config = { ...config, serverUrl: args.serverUrl };
+  }
+  if (args.token) {
+    const url = new URL(config.serverUrl);
+    url.searchParams.set("token", args.token);
+    config = { ...config, serverUrl: url.toString() };
+  }
+  if (args.dataDir) {
+    config = { ...config, dataDir: args.dataDir };
+  }
+  if (args.logLevel) {
+    config = { ...config, logLevel: args.logLevel };
+  }
+  ensureDir(config.dataDir);
+  acquireLock(config.dataDir);
+  logger.info("Bridge starting", {
+    bridgeId: config.bridgeId,
+    serverUrl: config.serverUrl,
+    serverApiUrl: config.serverApiUrl
+  });
+  wsMetrics.start(5e3);
+  const sessionStore = new SessionStore(config.dataDir);
+  const agentRegistry = new HttpAgentRegistry(config.serverApiUrl);
+  const groupRegistry = new GroupRegistry(config.serverApiUrl);
+  await agentRegistry.refresh();
+  await groupRegistry.refresh();
+  let connector = null;
+  const emit = (msg) => {
+    connector?.send(msg);
+  };
+  const askQuestionRegistry = new AskQuestionRegistry();
+  const agentManager = new AgentManager(sessionStore, emit, {
+    queryConfig: config.queryConfig,
+    askQuestionRegistry,
+    groupRegistry
+  });
+  const taskDispatchHandler = createTaskDispatchHandler(agentManager, agentRegistry, emit);
+  const groupTaskDispatchHandler = createGroupTaskDispatchHandler(agentManager, agentRegistry, emit);
+  let statusInterval = null;
+  connector = new ServerConnector({
+    config,
+    agentIds: () => agentRegistry.getAll().map((a) => a.id),
+    onTaskDispatch: taskDispatchHandler,
+    onGroupTaskDispatch: groupTaskDispatchHandler,
+    onStopGeneration: async (payload) => {
+      await agentManager.cancelReply(payload);
+    },
+    onConnected: async () => {
+      await agentRegistry.refresh();
+      await groupRegistry.refresh();
+      await agentManager.recoverFromRestart(agentRegistry.getAll());
+    },
+    onServerPush: async (msg) => {
+      switch (msg.type) {
+        case "bridge:list_models_request": {
+          const { requestId } = msg.payload;
+          logger.info("list_models request received", { requestId });
+          try {
+            const models = await listModels();
+            connector?.send({
+              type: "bridge:list_models_response",
+              payload: { requestId, models }
+            });
+            logger.info("list_models response sent", { requestId, count: models.length });
+          } catch (e) {
+            const err = e instanceof Error ? e.message : String(e);
+            connector?.send({
+              type: "bridge:list_models_response",
+              payload: { requestId, error: err }
+            });
+            logger.error("list_models failed", { requestId, error: e });
+          }
+          break;
+        }
+        case "agent:terminate":
+          await agentManager.terminate(msg.payload.agentId);
+          break;
+        case "agent:terminate_scope":
+          logger.info("agent:terminate_scope received", {
+            agentId: msg.payload.agentId,
+            scope: msg.payload.scope
+          });
+          await agentManager.terminateScope(msg.payload.agentId, msg.payload.scope);
+          break;
+        case "agent:created":
+        case "agent:updated":
+          agentRegistry.upsert(msg.payload.agent);
+          break;
+        case "agent:deleted":
+          agentRegistry.remove(msg.payload.agentId);
+          break;
+        case "user:answer_question": {
+          const p = msg.payload;
+          const answerText = formatAnswerForSDK(p);
+          const ok = askQuestionRegistry.resolve(p.questionId, answerText);
+          logger.info("user:answer_question handled", {
+            questionId: p.questionId,
+            agentId: p.agentId,
+            resolved: ok,
+            traceId: p.traceId
+          });
+          break;
+        }
+        default:
+          break;
+      }
+    }
+  });
+  connector.connect();
+  statusInterval = setInterval(() => {
+    if (!connector?.isConnected) return;
+    void agentRegistry.refresh().then(() => {
+      connector?.send(agentManager.getQueryStatus(config.bridgeId));
+    });
+  }, config.queryConfig.statusReportIntervalMs);
+  const shutdown = async (signal) => {
+    logger.info("Shutdown signal received", { signal });
+    if (statusInterval) {
+      clearInterval(statusInterval);
+      statusInterval = null;
+    }
+    wsMetrics.stop();
+    connector?.close();
+    await agentManager.shutdownAll();
+    logger.info("Bridge stopped");
+    process.exit(0);
+  };
+  process.on("SIGINT", () => void shutdown("SIGINT"));
+  process.on("SIGTERM", () => void shutdown("SIGTERM"));
+}

package/dist/index.js ADDED Viewed

@@ -0,0 +1,143 @@
+import {
+  AgentManager,
+  AskQuestionRegistry,
+  GroupRegistry,
+  HttpAgentRegistry,
+  ServerConnector,
+  SessionStore,
+  acquireLock,
+  createGroupTaskDispatchHandler,
+  createModuleLogger,
+  createTaskDispatchHandler,
+  ensureDir,
+  formatAnswerForSDK,
+  listModels,
+  loadBridgeConfig,
+  wsMetrics
+} from "./chunk-7SODRWIG.js";
+// src/index.ts
+var logger = createModuleLogger("bridge");
+async function main() {
+  const config = loadBridgeConfig();
+  ensureDir(config.dataDir);
+  acquireLock(config.dataDir);
+  logger.info("Bridge starting", {
+    bridgeId: config.bridgeId,
+    serverUrl: config.serverUrl,
+    serverApiUrl: config.serverApiUrl
+  });
+  wsMetrics.start(5e3);
+  const sessionStore = new SessionStore(config.dataDir);
+  const agentRegistry = new HttpAgentRegistry(config.serverApiUrl);
+  const groupRegistry = new GroupRegistry(config.serverApiUrl);
+  await agentRegistry.refresh();
+  await groupRegistry.refresh();
+  let connector = null;
+  const emit = (msg) => {
+    connector?.send(msg);
+  };
+  const askQuestionRegistry = new AskQuestionRegistry();
+  const agentManager = new AgentManager(sessionStore, emit, {
+    queryConfig: config.queryConfig,
+    askQuestionRegistry,
+    groupRegistry
+  });
+  const taskDispatchHandler = createTaskDispatchHandler(agentManager, agentRegistry, emit);
+  const groupTaskDispatchHandler = createGroupTaskDispatchHandler(agentManager, agentRegistry, emit);
+  let statusInterval = null;
+  connector = new ServerConnector({
+    config,
+    agentIds: () => agentRegistry.getAll().map((a) => a.id),
+    onTaskDispatch: taskDispatchHandler,
+    onGroupTaskDispatch: groupTaskDispatchHandler,
+    onStopGeneration: async (payload) => {
+      await agentManager.cancelReply(payload);
+    },
+    onConnected: async () => {
+      await agentRegistry.refresh();
+      await groupRegistry.refresh();
+      await agentManager.recoverFromRestart(agentRegistry.getAll());
+    },
+    onServerPush: async (msg) => {
+      switch (msg.type) {
+        case "bridge:list_models_request": {
+          const { requestId } = msg.payload;
+          logger.info("list_models request received", { requestId });
+          try {
+            const models = await listModels();
+            connector?.send({
+              type: "bridge:list_models_response",
+              payload: { requestId, models }
+            });
+            logger.info("list_models response sent", { requestId, count: models.length });
+          } catch (e) {
+            const err = e instanceof Error ? e.message : String(e);
+            connector?.send({
+              type: "bridge:list_models_response",
+              payload: { requestId, error: err }
+            });
+            logger.error("list_models failed", { requestId, error: e });
+          }
+          break;
+        }
+        case "agent:terminate":
+          await agentManager.terminate(msg.payload.agentId);
+          break;
+        case "agent:terminate_scope":
+          logger.info("agent:terminate_scope received", {
+            agentId: msg.payload.agentId,
+            scope: msg.payload.scope
+          });
+          await agentManager.terminateScope(msg.payload.agentId, msg.payload.scope);
+          break;
+        case "agent:created":
+        case "agent:updated":
+          agentRegistry.upsert(msg.payload.agent);
+          break;
+        case "agent:deleted":
+          agentRegistry.remove(msg.payload.agentId);
+          break;
+        case "user:answer_question": {
+          const p = msg.payload;
+          const answerText = formatAnswerForSDK(p);
+          const ok = askQuestionRegistry.resolve(p.questionId, answerText);
+          logger.info("user:answer_question handled", {
+            questionId: p.questionId,
+            agentId: p.agentId,
+            resolved: ok,
+            traceId: p.traceId
+          });
+          break;
+        }
+        default:
+          break;
+      }
+    }
+  });
+  connector.connect();
+  statusInterval = setInterval(() => {
+    if (!connector?.isConnected) return;
+    void agentRegistry.refresh().then(() => {
+      connector?.send(agentManager.getQueryStatus(config.bridgeId));
+    });
+  }, config.queryConfig.statusReportIntervalMs);
+  const shutdown = async (signal) => {
+    logger.info("Shutdown signal received", { signal });
+    if (statusInterval) {
+      clearInterval(statusInterval);
+      statusInterval = null;
+    }
+    wsMetrics.stop();
+    connector?.close();
+    await agentManager.shutdownAll();
+    logger.info("Bridge stopped");
+    process.exit(0);
+  };
+  process.on("SIGINT", () => void shutdown("SIGINT"));
+  process.on("SIGTERM", () => void shutdown("SIGTERM"));
+}
+void main().catch((e) => {
+  logger.error("Bridge failed to start", { error: e });
+  process.exit(1);
+});

package/package.json ADDED Viewed

@@ -0,0 +1,41 @@
+{
+  "name": "@fangyb/ahchat-bridge",
+  "version": "0.1.0",
+  "description": "AHChat Bridge CLI — connect your local Claude Code agents to an AHChat server",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "ahchat-bridge": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts src/cli.ts --format esm --clean --shims",
+    "dev": "tsx src/index.ts",
+    "start": "tsx src/index.ts",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "@ahchat/logger": "workspace:*",
+    "@ahchat/shared": "workspace:*",
+    "@anthropic-ai/claude-agent-sdk": "^0.2",
+    "cac": "^6.7.14",
+    "ws": "^8.18.0",
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.21",
+    "@types/ws": "^8.5.14",
+    "tsup": "^8.3.5",
+    "tsx": "^4.19.4",
+    "typescript": "^5.8.3",
+    "vitest": "^3.1.4"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}