@axiom-lattice/gateway 2.1.88 → 2.1.90

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @axiom-lattice/gateway@2.1.88 build /home/runner/work/agentic/agentic/packages/gateway
+> @axiom-lattice/gateway@2.1.90 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,24 @@
 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:175:33:
-      175 │ const __filename = fileURLToPath(import.meta.url);
+    src/index.ts:183:33:
+      183 │ 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               237.01 KB
 ESM dist/sender-PX32VSHB.mjs     873.00 B
-ESM dist/index.mjs.map           504.85 KB
+ESM dist/a2a-ERG5RMUW.mjs        15.95 KB
+ESM dist/index.mjs               246.84 KB
 ESM dist/sender-PX32VSHB.mjs.map 2.07 KB
-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
+ESM dist/a2a-ERG5RMUW.mjs.map    32.14 KB
+ESM dist/index.mjs.map           526.83 KB
+ESM ⚡️ Build success in 420ms
+CJS dist/index.js     268.14 KB
+CJS dist/index.js.map 560.68 KB
+CJS ⚡️ Build success in 426ms
 DTS Build start
-DTS ⚡️ Build success in 13918ms
-DTS dist/index.d.ts  5.01 KB
-DTS dist/index.d.mts 5.01 KB
+DTS ⚡️ Build success in 13594ms
+DTS dist/index.d.ts  7.57 KB
+DTS dist/index.d.mts 7.57 KB

package/AGENTS.md

@@ -24,6 +24,12 @@ src/
     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
 ```
@@ -40,6 +46,62 @@ src/
 - **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/`

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @axiom-lattice/gateway
 
+## 2.1.90
+
+### Patch Changes
+
+- b7cd409: enhance more features a2a, cli
+- Updated dependencies [b7cd409]
+  - @axiom-lattice/pg-stores@1.0.69
+  - @axiom-lattice/protocols@2.1.40
+  - @axiom-lattice/core@2.1.78
+  - @axiom-lattice/agent-eval@2.1.72
+  - @axiom-lattice/queue-redis@1.0.39
+
+## 2.1.89
+
+### Patch Changes
+
+- 176bfe8: custom middleware, enhance messagerouter
+- Updated dependencies [176bfe8]
+  - @axiom-lattice/core@2.1.77
+  - @axiom-lattice/agent-eval@2.1.71
+  - @axiom-lattice/pg-stores@1.0.68
+
 ## 2.1.88
 
 ### Patch Changes