@axiom-lattice/gateway 2.1.87 → 2.1.88

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @axiom-lattice/gateway@2.1.87 build /home/runner/work/agentic/agentic/packages/gateway
+> @axiom-lattice/gateway@2.1.88 build /home/runner/work/agentic/agentic/packages/gateway
 > tsup src/index.ts --format cjs,esm --dts --clean --sourcemap
 
 CLI Building entry: src/index.ts
@@ -11,22 +11,22 @@
 ESM Build start
 [warn] ▲ [WARNING] "import.meta" is not available with the "cjs" output format and will be empty [empty-import-meta]
 
-    src/index.ts:178:33:
-      178 │ const __filename = fileURLToPath(import.meta.url);
+    src/index.ts:175:33:
+      175 │ const __filename = fileURLToPath(import.meta.url);
           ╵                                  ~~~~~~~~~~~
 
   You need to set the output format to "esm" for "import.meta" to work correctly.
 
 
-CJS dist/index.js     242.46 KB
-CJS dist/index.js.map 507.89 KB
-CJS ⚡️ Build success in 387ms
-ESM dist/index.mjs               237.76 KB
+ESM dist/index.mjs               237.01 KB
 ESM dist/sender-PX32VSHB.mjs     873.00 B
+ESM dist/index.mjs.map           504.85 KB
 ESM dist/sender-PX32VSHB.mjs.map 2.07 KB
-ESM dist/index.mjs.map           506.38 KB
-ESM ⚡️ Build success in 391ms
+ESM ⚡️ Build success in 417ms
+CJS dist/index.js     241.90 KB
+CJS dist/index.js.map 506.42 KB
+CJS ⚡️ Build success in 418ms
 DTS Build start
-DTS ⚡️ Build success in 13983ms
+DTS ⚡️ Build success in 13918ms
 DTS dist/index.d.ts  5.01 KB
 DTS dist/index.d.mts 5.01 KB

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @axiom-lattice/gateway
 
+## 2.1.88
+
+### Patch Changes
+
+- 6ff5bd5: fix issue
+- Updated dependencies [6ff5bd5]
+  - @axiom-lattice/agent-eval@2.1.70
+  - @axiom-lattice/core@2.1.76
+  - @axiom-lattice/pg-stores@1.0.67
+  - @axiom-lattice/protocols@2.1.39
+  - @axiom-lattice/queue-redis@1.0.38
+
 ## 2.1.87
 
 ### Patch Changes

package/README.md

@@ -1,125 +1,68 @@
-# Lattice Gateway
+# @axiom-lattice/gateway
 
-这是 Lattice 项目的 API 网关服务，提供了基于 Fastify 的 HTTP API 接口，用于与 Lattice Core 交互。
+Fastify-based HTTP API gateway exposing REST endpoints for agent execution, thread management, and configuration.
 
-## 功能特点
+## Store Consumption
 
-- 基于 Fastify 的 HTTP API
-- 代理调用服务
-- 流式响应支持
-- 事件总线
-- 队列服务（基于 QueueLattice）
-- 日志服务（基于 LoggerLattice，支持自定义配置）
+The gateway reads all stores from `StoreLatticeManager` at startup — no manual wiring needed.
+Register stores via `configureStores` **before** calling `startAsHttpEndpoint()`:
 
-## 安装
-
-```bash
-pnpm install
-```
-
-## 启动服务
-
-```bash
-# 开发环境
-pnpm dev
-
-# 生产环境
-pnpm build
-pnpm start
-```
-
-## API 接口
-
-### Configuration API
-
-The gateway supports dynamic configuration updates via JSON. You can update environment variables at runtime without restarting the server.
+```typescript
+import { configureStores } from "@axiom-lattice/core";
+import { createPgStoreConfig } from "@axiom-lattice/pg-stores";
+import { LatticeGateway } from "@axiom-lattice/gateway";
 
-#### Get Configuration
+const stores = createPgStoreConfig(process.env.DATABASE_URL);
+await configureStores({ ...stores });
 
-```bash
-GET /api/config
+// Gateway picks up stores from StoreLatticeManager automatically
+LatticeGateway.startAsHttpEndpoint({ port: 4001 });
 ```
 
-Returns the current configuration (sensitive values are masked).
+### How it works
 
-#### Update Configuration
+The gateway internally calls `getStoreLattice("default", type)` for each store it needs:
 
-```bash
-PUT /api/config
-Content-Type: application/json
+- **`channelBinding`** — used by `MessageRouter` for sender-to-agent binding resolution
+- **`channelInstallation`** — used for channel instance lookup
+- **`database`** — `SqlDatabaseManager` reads configs lazily on first query
+- **`metrics`** — `MetricsServerManager` loads configs on first access
+- **All other stores** — consumed by controllers via `getStoreLattice("default", type)`
 
-{
-  "config": {
-    "port": 4001,
-    "queueServiceType": "redis",
-    "redisUrl": "redis://localhost:6379",
-    "redisPassword": "your-password",
-    "queueName": "tasks"
-  }
-}
-```
-
-**Note**: When updating `queueServiceType`, the queue service will be automatically reconfigured.
+No `setConfigStore()` or `loadConfigsFromStore()` calls needed — each manager reads directly from `StoreLatticeManager`.
 
-**Example**:
+## Quick Start
 
 ```typescript
-// Update configuration from frontend
-const response = await fetch("http://localhost:4001/api/config", {
-  method: "PUT",
-  headers: {
-    "Content-Type": "application/json",
-  },
-  body: JSON.stringify({
-    config: {
-      queueServiceType: "redis",
-      redisUrl: "redis://localhost:6379",
-      redisPassword: "your-password",
-    },
-  }),
-});
+import { LatticeGateway } from "@axiom-lattice/gateway";
 
-const result = await response.json();
-console.log(result); // { success: true, message: "Configuration updated successfully", data: {...} }
+LatticeGateway.startAsHttpEndpoint({
+  port: 4001,
+  queueServiceConfig: { type: "memory", defaultStartPollingQueue: true },
+});
 ```
 
-### 代理调用
-
-- `POST /api/v1/run`: 运行代理
-- `POST /api/v1/run/stream`: 流式运行代理
-- `GET /api/v1/run/:thread_id`: 获取运行状态
-- `GET /api/v1/run/:thread_id/messages`: 获取消息历史
-
-## Logger 配置
-
-Gateway 使用 Logger Lattice 进行日志管理，支持自定义日志配置。详细说明请参考 [LOGGER_CONFIG.md](./LOGGER_CONFIG.md)。
-
-### 快速开始
+## Logger Configuration
 
 ```typescript
 import { LatticeGateway } from "@axiom-lattice/gateway";
 import { LoggerType } from "@axiom-lattice/protocols";
 
-// 使用默认配置
-LatticeGateway.startAsHttpEndpoint({
-  port: 4001,
-});
-
-// 自定义日志配置
 LatticeGateway.startAsHttpEndpoint({
   port: 4001,
   loggerConfig: {
-    file: "./logs/my-app/gateway",
+    name: "default",
+    type: LoggerType.PINO,
     serviceName: "my-service",
   },
 });
 ```
 
-## 目录结构
+## API Endpoints
 
-- `src/config/`: 配置文件
-- `src/controllers/`: 控制器
-- `src/routes/`: 路由定义
-- `src/services/`: 服务实现
-- `src/types/`: 类型定义
-- `LOGGER_CONFIG.md`: Logger 配置详细文档
+- `POST /api/v1/run` — Execute agent
+- `POST /api/v1/run/stream` — Stream agent execution
+- `GET /api/v1/run/:thread_id` — Get run status
+- `GET /api/v1/run/:thread_id/messages` — Get message history
+- `GET /api/config` — Get gateway configuration
+- `PUT /api/config` — Update gateway configuration

package/dist/index.js

@@ -1715,7 +1715,7 @@ async function executeDataQuery(request, reply) {
         message: `Metrics server not registered: ${body.serverKey}. Please register the server first.`
       };
     }
-    const client = import_core12.metricsServerManager.getClient(tenantId, body.serverKey);
+    const client = await import_core12.metricsServerManager.getClient(tenantId, body.serverKey);
     if (isSemanticQuery) {
       return await executeSemanticQuery(client, body, reply);
     } else {
@@ -3915,7 +3915,7 @@ async function testMetricsServerConnection(request, reply) {
     const testKey = `__test_${key}_${Date.now()}`;
     import_core21.metricsServerManager.registerServer(tenantId, testKey, config.config);
     try {
-      const client = import_core21.metricsServerManager.getClient(tenantId, testKey);
+      const client = await import_core21.metricsServerManager.getClient(tenantId, testKey);
       const result = await client.testConnection();
       import_core21.metricsServerManager.removeServer(tenantId, testKey);
       return {
@@ -3966,7 +3966,7 @@ async function listAvailableMetrics(request, reply) {
     if (!import_core21.metricsServerManager.hasServer(tenantId, key)) {
       import_core21.metricsServerManager.registerServer(tenantId, key, config.config);
     }
-    const client = import_core21.metricsServerManager.getClient(tenantId, key);
+    const client = await import_core21.metricsServerManager.getClient(tenantId, key);
     const metrics = await client.listMetrics();
     return {
       success: true,
@@ -4012,7 +4012,7 @@ async function queryMetricsData(request, reply) {
     if (!import_core21.metricsServerManager.hasServer(tenantId, key)) {
       import_core21.metricsServerManager.registerServer(tenantId, key, config.config);
     }
-    const client = import_core21.metricsServerManager.getClient(tenantId, key);
+    const client = await import_core21.metricsServerManager.getClient(tenantId, key);
     const result = await client.queryMetricData(metricName, {
       startTime,
       endTime,
@@ -6354,19 +6354,8 @@ function registerChannelInstallationRoutes(app2) {
   app2.delete("/api/channel-installations/:installationId", deleteChannelInstallation);
 }
 
-// src/bindings/index.ts
-var registryInstance = null;
-function setBindingRegistry(registry) {
-  registryInstance = registry;
-}
-function getBindingRegistry() {
-  if (!registryInstance) {
-    throw new Error("BindingRegistry not initialized. Call setBindingRegistry() first.");
-  }
-  return registryInstance;
-}
-
 // src/controllers/channel-bindings.ts
+var import_core28 = require("@axiom-lattice/core");
 function getTenantId12(request) {
   const userTenantId = request.user?.tenantId;
   if (userTenantId) return userTenantId;
@@ -6376,7 +6365,7 @@ async function getBindingList(request, _reply) {
   const tenantId = getTenantId12(request);
   const { channel, agentId, channelInstallationId, limit, offset } = request.query;
   try {
-    const registry = getBindingRegistry();
+    const registry = (0, import_core28.getBindingRegistry)();
     const bindings = await registry.list({ channel, agentId, tenantId, channelInstallationId, limit, offset });
     return { success: true, message: "Bindings retrieved", data: { records: bindings, total: bindings.length } };
   } catch (error) {
@@ -6387,7 +6376,7 @@ async function getBindingList(request, _reply) {
 async function getBinding(request, reply) {
   const tenantId = getTenantId12(request);
   try {
-    const registry = getBindingRegistry();
+    const registry = (0, import_core28.getBindingRegistry)();
     const bindings = await registry.list({ tenantId });
     const binding = bindings.find((b) => b.id === request.params.id);
     if (!binding || binding.tenantId !== tenantId) {
@@ -6403,7 +6392,7 @@ async function getBinding(request, reply) {
 async function createBinding(request, reply) {
   const tenantId = getTenantId12(request);
   try {
-    const registry = getBindingRegistry();
+    const registry = (0, import_core28.getBindingRegistry)();
     const binding = await registry.create({ ...request.body, tenantId });
     reply.status(201);
     return { success: true, message: "Binding created", data: binding };
@@ -6416,7 +6405,7 @@ async function createBinding(request, reply) {
 async function updateBinding(request, reply) {
   try {
     const tenantId = getTenantId12(request);
-    const registry = getBindingRegistry();
+    const registry = (0, import_core28.getBindingRegistry)();
     const bindings = await registry.list({ tenantId });
     const existing = bindings.find((b) => b.id === request.params.id);
     if (!existing || existing.tenantId !== tenantId) {
@@ -6434,7 +6423,7 @@ async function updateBinding(request, reply) {
 async function deleteBinding(request, reply) {
   try {
     const tenantId = getTenantId12(request);
-    const registry = getBindingRegistry();
+    const registry = (0, import_core28.getBindingRegistry)();
     const bindings = await registry.list({ tenantId });
     const existing = bindings.find((b) => b.id === request.params.id);
     if (!existing || existing.tenantId !== tenantId) {
@@ -6453,7 +6442,7 @@ async function resolveBinding(request, _reply) {
   const tenantId = getTenantId12(request);
   const { channel, senderId, channelInstallationId } = request.query;
   try {
-    const registry = getBindingRegistry();
+    const registry = (0, import_core28.getBindingRegistry)();
     const binding = await registry.resolve({ channel, senderId, channelInstallationId, tenantId });
     if (!binding) {
       return { success: false, message: "No binding found", data: null };
@@ -6690,7 +6679,7 @@ var registerLatticeRoutes = (app2, channelDeps) => {
 };
 
 // src/router/MessageRouter.ts
-var import_core28 = require("@axiom-lattice/core");
+var import_core29 = require("@axiom-lattice/core");
 var import_crypto8 = require("crypto");
 var BindingNotFoundError = class extends Error {
   constructor(message) {
@@ -6806,7 +6795,7 @@ var MessageRouter = class {
         }
         let threadId = ctx.binding.threadMode === "per_conversation" ? void 0 : ctx.binding.threadId;
         if (!threadId) {
-          const threadStore = (0, import_core28.getStoreLattice)("default", "thread").store;
+          const threadStore = (0, import_core29.getStoreLattice)("default", "thread").store;
           const newThreadId = (0, import_crypto8.randomUUID)();
           console.log({
             event: "dispatch:thread:create",
@@ -6847,7 +6836,7 @@ var MessageRouter = class {
           senderId: message.sender.id,
           contentLength: message.content.text.length
         }, "Dispatching to agent");
-        const agent = import_core28.agentInstanceManager.getAgent({
+        const agent = import_core29.agentInstanceManager.getAgent({
           tenant_id: tenantId,
           assistant_id: ctx.binding.agentId,
           thread_id: threadId,
@@ -7027,7 +7016,7 @@ function createAuditLoggerMiddleware() {
 }
 
 // src/index.ts
-var import_core30 = require("@axiom-lattice/core");
+var import_core31 = require("@axiom-lattice/core");
 
 // src/swagger.ts
 var import_swagger = __toESM(require("@fastify/swagger"));
@@ -7092,7 +7081,7 @@ var configureSwagger = async (app2, customSwaggerConfig, customSwaggerUiConfig)
 };
 
 // src/services/agent_task_consumer.ts
-var import_core29 = require("@axiom-lattice/core");
+var import_core30 = require("@axiom-lattice/core");
 var handleAgentTask = async (taskRequest, retryCount = 0) => {
   const {
     assistant_id,
@@ -7110,18 +7099,18 @@ var handleAgentTask = async (taskRequest, retryCount = 0) => {
     console.log(
       `\u5F00\u59CB\u5904\u7406\u4EFB\u52A1 [assistant_id: ${assistant_id}, thread_id: ${thread_id}]`
     );
-    const agent = import_core29.agentInstanceManager.getAgent({ assistant_id, thread_id, tenant_id, workspace_id: runConfig?.workspaceId, project_id: runConfig?.projectId, custom_run_config: runConfig });
-    await agent.addMessage({ input, command, custom_run_config: runConfig }, import_core29.QueueMode.STEER);
+    const agent = import_core30.agentInstanceManager.getAgent({ assistant_id, thread_id, tenant_id, workspace_id: runConfig?.workspaceId, project_id: runConfig?.projectId, custom_run_config: runConfig });
+    await agent.addMessage({ input, command, custom_run_config: runConfig }, import_core30.QueueMode.STEER);
     if (callback_event) {
       agent.subscribeOnce("message:completed", (evt) => {
-        import_core29.eventBus.publish(callback_event, {
+        import_core30.eventBus.publish(callback_event, {
           success: true,
           state: evt.state,
           config: { assistant_id, thread_id, tenant_id }
         });
         if (main_thread_id && main_tenant_id) {
           try {
-            const mainAgent = import_core29.agentInstanceManager.getAgent({
+            const mainAgent = import_core30.agentInstanceManager.getAgent({
               assistant_id: main_assistant_id ?? assistant_id,
               thread_id: main_thread_id,
               tenant_id: main_tenant_id
@@ -7149,7 +7138,7 @@ ${summary}`
         }
       });
       agent.subscribeOnce("message:interrupted", (evt) => {
-        import_core29.eventBus.publish(callback_event, {
+        import_core30.eventBus.publish(callback_event, {
           success: true,
           state: evt.state,
           config: { assistant_id, thread_id, tenant_id }
@@ -7173,7 +7162,7 @@ ${summary}`
       return handleAgentTask(taskRequest, nextRetryCount);
     }
     if (callback_event) {
-      import_core29.eventBus.publish(callback_event, {
+      import_core30.eventBus.publish(callback_event, {
         success: false,
         error: error instanceof Error ? error.message : String(error),
         config: { assistant_id, thread_id, tenant_id }
@@ -7211,7 +7200,7 @@ var _AgentTaskConsumer = class _AgentTaskConsumer {
    * 初始化事件监听和队列轮询
    */
   initialize() {
-    import_core29.eventBus.subscribe(import_core29.AGENT_TASK_EVENT, this.trigger_agent_task.bind(this));
+    import_core30.eventBus.subscribe(import_core30.AGENT_TASK_EVENT, this.trigger_agent_task.bind(this));
     this.startPollingQueue();
     console.log("Agent\u4EFB\u52A1\u6D88\u8D39\u8005\u5DF2\u542F\u52A8\u5E76\u76D1\u542C\u4EFB\u52A1\u4E8B\u4EF6\u548C\u961F\u5217");
   }
@@ -7330,7 +7319,7 @@ var _AgentTaskConsumer = class _AgentTaskConsumer {
     handleAgentTask(taskRequest).catch((error) => {
       console.error("\u5904\u7406Agent\u4EFB\u52A1\u65F6\u53D1\u751F\u672A\u6355\u83B7\u7684\u9519\u8BEF:", error);
       if (taskRequest.callback_event) {
-        import_core29.eventBus.publish(taskRequest.callback_event, {
+        import_core30.eventBus.publish(taskRequest.callback_event, {
           success: false,
           error: error instanceof Error ? error.message : String(error),
           config: {
@@ -7350,7 +7339,7 @@ _AgentTaskConsumer.agent_run_endpoint = "http://localhost:4001/api/runs";
 var AgentTaskConsumer = _AgentTaskConsumer;
 
 // src/index.ts
-var import_core31 = require("@axiom-lattice/core");
+var import_core32 = require("@axiom-lattice/core");
 var import_protocols4 = require("@axiom-lattice/protocols");
 var import_meta = {};
 process.on("unhandledRejection", (reason, promise) => {
@@ -7366,11 +7355,11 @@ var DEFAULT_LOGGER_CONFIG = {
 var loggerLattice = initializeLogger(DEFAULT_LOGGER_CONFIG);
 var logger3 = loggerLattice.client;
 function initializeLogger(config) {
-  if (import_core31.loggerLatticeManager.hasLattice("default")) {
-    import_core31.loggerLatticeManager.removeLattice("default");
+  if (import_core32.loggerLatticeManager.hasLattice("default")) {
+    import_core32.loggerLatticeManager.removeLattice("default");
   }
-  (0, import_core31.registerLoggerLattice)("default", config);
-  return (0, import_core31.getLoggerLattice)("default");
+  (0, import_core32.registerLoggerLattice)("default", config);
+  return (0, import_core32.getLoggerLattice)("default");
 }
 var app = (0, import_fastify.default)({
   logger: false,
@@ -7473,7 +7462,7 @@ app.setErrorHandler((error, request, reply) => {
 });
 function getConfiguredSandboxProvider() {
   const sandboxProviderType = process.env.SANDBOX_PROVIDER_TYPE || "microsandbox-remote";
-  return (0, import_core31.createSandboxProvider)({
+  return (0, import_core32.createSandboxProvider)({
     type: sandboxProviderType,
     remoteBaseURL: process.env.SANDBOX_BASE_URL,
     microsandboxServiceBaseURL: process.env.MICROSANDBOX_SERVICE_BASE_URL,
@@ -7505,8 +7494,7 @@ var start = async (config) => {
       const { getStoreLattice: getStoreLattice16 } = await import("@axiom-lattice/core");
       const bindingStore = getStoreLattice16("default", "channelBinding").store;
       const installationStore = getStoreLattice16("default", "channelInstallation").store;
-      setBindingRegistry(bindingStore);
-      (0, import_core30.setBindingRegistry)(bindingStore);
+      (0, import_core31.setBindingRegistry)(bindingStore);
       const adapterRegistry = new ChannelAdapterRegistry();
       adapterRegistry.register(larkChannelAdapter);
       const router = new MessageRouter({
@@ -7523,16 +7511,8 @@ var start = async (config) => {
     } catch {
     }
     registerLatticeRoutes(app, channelDeps);
-    try {
-      const storeLattice = (0, import_core31.getStoreLattice)("default", "database");
-      const store = storeLattice.store;
-      import_core31.sqlDatabaseManager.setConfigStore(store);
-      logger3.info("Database config store set for SqlDatabaseManager");
-    } catch (error) {
-      logger3.warn("Failed to set database config store: " + (error instanceof Error ? error.message : String(error)));
-    }
-    if (!import_core31.sandboxLatticeManager.hasLattice("default")) {
-      import_core31.sandboxLatticeManager.registerLattice("default", getConfiguredSandboxProvider());
+    if (!import_core32.sandboxLatticeManager.hasLattice("default")) {
+      import_core32.sandboxLatticeManager.registerLattice("default", getConfiguredSandboxProvider());
       logger3.info("Registered sandbox manager from env configuration");
     }
     const target_port = config?.port || Number(process.env.PORT) || 4001;
@@ -7553,7 +7533,7 @@ var start = async (config) => {
     }
     try {
       logger3.info("Starting agent instance recovery...");
-      const restoreStats = await import_core31.agentInstanceManager.restore();
+      const restoreStats = await import_core32.agentInstanceManager.restore();
       logger3.info(`Agent recovery complete: ${restoreStats.restored} threads restored, ${restoreStats.errors} errors`);
     } catch (error) {
       logger3.error("Agent recovery failed", { error });