@axiom-lattice/gateway 3.0.2 → 3.0.3

package/package.json

@@ -1,7 +1,10 @@
 {
   "name": "@axiom-lattice/gateway",
-  "version": "3.0.2",
+  "version": "3.0.3",
   "main": "dist/index.js",
+  "files": [
+    "dist"
+  ],
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
   "exports": {
@@ -41,11 +44,11 @@
     "redis": "^5.0.1",
     "uuid": "^9.0.1",
     "zod": "3.25.76",
-    "@axiom-lattice/cli-a2a": "0.1.7",
-    "@axiom-lattice/core": "3.0.2",
-    "@axiom-lattice/pg-stores": "2.0.2",
-    "@axiom-lattice/protocols": "3.0.1",
-    "@axiom-lattice/queue-redis": "1.0.55"
+    "@axiom-lattice/cli-a2a": "0.1.8",
+    "@axiom-lattice/core": "3.0.3",
+    "@axiom-lattice/pg-stores": "2.0.3",
+    "@axiom-lattice/protocols": "3.0.2",
+    "@axiom-lattice/queue-redis": "1.0.56"
   },
   "devDependencies": {
     "@types/bcrypt": "^6.0.0",

package/.eslintrc.json

@@ -1,22 +0,0 @@
-{
-  "root": true,
-  "env": {
-    "node": true,
-    "es2021": true
-  },
-  "extends": ["eslint:recommended", "plugin:@typescript-eslint/recommended"],
-  "parser": "@typescript-eslint/parser",
-  "parserOptions": {
-    "ecmaVersion": 12,
-    "sourceType": "module"
-  },
-  "plugins": ["@typescript-eslint"],
-  "rules": {
-    "indent": "off", // 禁用缩进规则
-    "linebreak-style": ["warn", "unix"],
-    "semi": ["warn", "always"],
-    "no-unused-vars": "off",
-    "@typescript-eslint/no-unused-vars": ["warn"],
-    "@typescript-eslint/no-explicit-any": "off" // 禁用对 any 类型的检查
-  }
-}

package/.turbo/turbo-build.log

@@ -1,46 +0,0 @@
-
-> @axiom-lattice/gateway@3.0.2 build /home/runner/work/agentic/agentic/packages/gateway
-> tsup src/index.ts --format cjs,esm --dts --clean --sourcemap
-
-CLI Building entry: src/index.ts
-CLI Using tsconfig: tsconfig.json
-CLI tsup v8.5.0
-CLI Target: es2020
-CLI Cleaning output folder
-CJS Build start
-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:200:33:
-      200 │ const __filename = fileURLToPath(import.meta.url);
-          ╵                                  ~~~~~~~~~~~
-
-  You need to set the output format to "esm" for "import.meta" to work correctly.
-
-
-ESM dist/index.mjs                             371.32 KB
-ESM dist/mcp-configs-SHRMQHIL.mjs              685.00 B
-ESM dist/chunk-K4XELOSO.mjs                    12.52 KB
-ESM dist/sender-PX32VSHB.mjs                   873.00 B
-ESM dist/WechatChannelAdapter-WSDKR4OA.mjs     8.27 KB
-ESM dist/chunk-6CUQGDJI.mjs                    6.42 KB
-ESM dist/a2a-QMHEH3ZT.mjs                      17.78 KB
-ESM dist/resources-VA7LSDKN.mjs                15.81 KB
-ESM dist/chunk-LHQY46YB.mjs                    1.46 KB
-ESM dist/index.mjs.map                         773.05 KB
-ESM dist/mcp-configs-SHRMQHIL.mjs.map          71.00 B
-ESM dist/chunk-K4XELOSO.mjs.map                25.53 KB
-ESM dist/sender-PX32VSHB.mjs.map               2.07 KB
-ESM dist/WechatChannelAdapter-WSDKR4OA.mjs.map 16.28 KB
-ESM dist/chunk-6CUQGDJI.mjs.map                14.04 KB
-ESM dist/a2a-QMHEH3ZT.mjs.map                  35.64 KB
-ESM dist/resources-VA7LSDKN.mjs.map            29.34 KB
-ESM dist/chunk-LHQY46YB.mjs.map                2.39 KB
-ESM ⚡️ Build success in 660ms
-CJS dist/index.js     444.31 KB
-CJS dist/index.js.map 898.76 KB
-CJS ⚡️ Build success in 663ms
-DTS Build start
-DTS ⚡️ Build success in 21089ms
-DTS dist/index.d.ts  7.57 KB
-DTS dist/index.d.mts 7.57 KB

package/AGENTS.md

@@ -1,112 +0,0 @@
-## OVERVIEW
-Fastify-based HTTP API gateway exposing REST endpoints for agent execution, thread management, and config CRUD.
-
-## STRUCTURE
-```
-src/
-  index.ts          # Gateway startup, Fastify config
-  routes/index.ts   # Route definitions (registerLatticeRoutes)
-  controllers/      # Route handlers
-    run.ts          # Agent execution endpoints
-    assistant.ts    # Agent CRUD
-    threads.ts      # Thread lifecycle
-    memory.ts       # Agent state/memory access
-    skills.ts       # Skill registry
-    tools.ts        # Tool configs
-    models.ts       # Model registry
-    schedules.ts    # Task scheduling
-    database-configs.ts    # DB connection configs
-    workspace.ts    # Workspace CRUD
-    config.ts       # Gateway config
-    health.ts       # Health checks
-  services/         # Business logic
-    agent_service.ts       # Agent invocation/streaming
-    queue_service.ts       # Task queue (memory/redis)
-    agent_task_consumer.ts # Queue consumer
-    sandbox_service.ts     # Sandbox proxy
-  channels/         # External channel adapters (Lark, Slack, etc.)
-    lark/           # Lark (Feishu) adapter
-    registry.ts     # ChannelAdapterRegistry
-  router/           # Message routing
-    MessageRouter.ts # Inbound message dispatch + channel reply
-    MessageContext.ts # Request-scoped context
-  schemas/index.ts  # Zod/Fastify schemas
-  logger/Logger.ts  # Logger lattice integration
-```
-
-## WHERE TO LOOK
-- **Run agent**: `routes/index.ts` (/api/runs), `controllers/run.ts`, `services/agent_service.ts`
-- **Stream responses**: `controllers/run.ts` (SSE via reply.hijack), `services/agent_service.ts#agent_stream`
-- **Thread CRUD**: `routes/index.ts`, `controllers/threads.ts`
-- **Assistant CRUD**: `routes/index.ts`, `controllers/assistant.ts`
-- **Memory/State**: `routes/index.ts` (/api/assistants/:id/:thread_id/state), `controllers/memory.ts`
-- **Skills registry**: `routes/index.ts`, `controllers/skills.ts`
-- **Scheduling**: `routes/index.ts`, `controllers/schedules.ts`
-- **Config endpoints**: `routes/index.ts`, `controllers/config.ts`
-- **DB configs**: `routes/index.ts`, `controllers/database-configs.ts`
-- **Queue setup**: `services/queue_service.ts`, `services/agent_task_consumer.ts`
-- **Logger lattice**: `logger/Logger.ts`, integration in `index.ts`
-- **Channel message routing**: `router/MessageRouter.ts`, `channels/lark/`
-- **Channel reply mechanism**: `router/MessageRouter.ts#dispatch` (see below)
-
-## CHANNEL MESSAGE REPLY FLOW
-
-When an external channel (e.g. Lark) sends a message to a bound agent, the gateway
-routes the message and sends the AI response back to the channel. The flow:
-
-```
-1. Channel webhook → ChannelAdapter.receive(rawPayload)
-   → InboundMessage with replyTarget set
-
-2. MessageRouter.dispatch(inboundMessage)
-   → resolve binding → create/reuse thread
-   → subscribe to Agent 'reply:ready' event (before addMessage)
-   → agent.addMessage({ custom_run_config: { _replyTarget: replyTarget } })
-
-3. Agent queue processes the message
-   → agentStreamExecutor() runs the agent
-   → emits 'reply:ready' { state, customRunConfig }
-
-4. reply:ready callback fires
-   → extracts last AI message from state.values.messages
-   → calls ChannelAdapter.sendReply(replyTarget, { text }, installation)
-   → reply appears in the external channel
-```
-
-### Reply deduplication per thread
-
-`MessageRouter` uses a counter-based subscription (`_replySubs: Map<string, { count, timer }>`) to handle
-multiple concurrent dispatches on the same thread:
-
-- Each dispatch increments the counter, only the first registers the `subscribeOnce` listener.
-- When `reply:ready` fires, the callback decrements the counter. The subscription is removed
-  only when the counter reaches 0.
-- A 1-hour timeout cleans up stale subscriptions (e.g. agent aborted, sequence error).
-
-### Reply timing across QueueModes
-
-| Mode | `reply:ready` emitted | Reply behavior |
-|------|----------------------|----------------|
-| STEER | After each execution | 1 reply per message |
-| FOLLOWUP | After each execution | 1 reply per message |
-| COLLECT | After the batch (all per-message events first) | 1 reply for the entire batch |
-
-### Key logs for debugging
-
-| Event | Meaning |
-|-------|---------|
-| `dispatch:reply:subscribed` | First reply subscription for this thread |
-| `dispatch:reply:incremented` | Additional dispatch joined existing subscription |
-| `dispatch:reply:sending` | AI text extracted, about to call sendReply |
-| `dispatch:reply:sent` | Channel API responded OK |
-| `dispatch:reply:failed` | Channel API returned an error |
-| `dispatch:reply:empty` | Agent produced no output, skipping reply |
-| `dispatch:reply:timeout` | No reply:ready fired within 1h, subscription cleaned up |
-
-## CONVENTIONS
-- Controllers export named handlers, consume from `services/`
-- Services contain business logic, talk to `@axiom-lattice/core`
-- Routes registered via `registerLatticeRoutes(app)`
-- Streaming: use `reply.hijack()` + SSE headers, iterate async generators
-- Tenant/workspace headers: `x-tenant-id`, `x-workspace-id`, `x-project-id`
-- Schemas in `schemas/index.ts` for validation/Swagger