lsm / neokai / 28214896225

82%

Build Type

push

github

Committed by web-flow

Commit Message

feat: add get_external_event MCP tool for on-demand raw event fetch (#2194)

* feat: add get_external_event MCP tool for on-demand raw event fetch

Adds a new get_external_event MCP tool that returns the full raw
external-event record (summary, body, payload, rawPayload, actor,
eventType, externalUrl, ...) via externalEventStore.getById. This is the
on-demand deep-dive counterpart to the lean event "essence" that a
companion task will inject into sessions -- agents need a fetch path
before the injected message is slimmed. Non-breaking / additive.

Changes:
- node-agent-tool-schemas.ts: GetExternalEventSchema + type, added to the
  aggregate NODE_AGENT_TOOL_SCHEMAS map.
- node-agent-tools.ts: get_external_event handler + tool registration,
  gated on an optional externalEventStore config field. Reads are scoped
  to the current space so events never leak across spaces.
- space-agent-tools.ts: mirrored the tool + handler on the LH-agent /
  space-agent surface with the same optional store + space scoping.
- task-agent-manager.ts + rpc-handlers/index.ts: wire the store through
  the node-agent config so sub-sessions get the tool.
- space-runtime-service.ts: pass externalEventStore to all three
  createSpaceAgentMcpServer call sites.
- space-runtime.ts: fix a stale reference in formatExternalEventDigestMessage
  -- it pointed agents at subscribe_external_event (the subscribe tool) for
  details; now points at get_external_event(eventId).

Tests cover both surfaces: known id returns the full record (incl.
rawPayload), unknown id returns not-found, cross-space ids are treated as
not-found, and the tool registers only when the store is wired.

* fix: include event ids in rate-limit digest so get_external_event is callable

Review feedback (P2): the rate-limit digest told agents to call
get_external_event(eventId), but the digest only carried topics and
timestamps — no event ids — so the agent had no argument to fetch.

Include the coalesced event ids in form... (continued)

Coverage Stats

11397 of 16422 branches covered (69.4%)

Branch coverage included in aggregate %.

61 of 65 new or added lines in 7 files covered. (93.85%)

556 existing lines in 7 files now uncovered.

95692 of 114321 relevant lines covered (83.7%)

299.98 hits per line