fusion

Files

gsxdsm 9c43736794 FN-8870: add structural approval and report mail

Add typed report and approval metadata to the mailbox contract.

- Define and validate structural mail kinds, report sections, and approval references.
- Let agents send validated reports while reserving approval mail for engine emission.
- Emit idempotent, fail-soft approval notifications and document the contract.

Files changed:
 .changeset/fn-8870-structural-mail-contract.md     |   7 ++
 docs/agents.md                                     |   2 +
 docs/architecture.md                               |   4 +
 .../message-metadata-structural-mail.test.ts       |  25 ++++
 packages/core/src/index.gate.ts                    |   2 +-
 packages/core/src/index.ts                         |   2 +-
 packages/core/src/types.ts                         |  30 +++++
 packages/core/src/types/messaging/messages.ts      |  21 ++++
 ...gent-tools-send-message-structural-mail.test.ts |  34 +++++
 .../src/__tests__/approval-mail-emission.test.ts   | 137 +++++++++++++++++++++
 packages/engine/src/agent-heartbeat.ts             |   3 +
 packages/engine/src/agent-tools.ts                 |  28 ++++-
 packages/engine/src/agents/approval-mail.ts        |  40 ++++++
 packages/engine/src/executor.ts                    |   3 +
 14 files changed, 334 insertions(+), 4 deletions(-)

Fusion-Task-Id: FN-8870

Fusion-Task-Lineage: 7d30b2f9-c004-4975-86b1-9600e2c8d76f

Co-authored-by: Fusion (runfusion.ai) <noreply@runfusion.ai>

2026-08-09 00:41:18 -07:00

active-session-registry.ts

refactor: domain folder layout (types, API, core, engine) (#2398 )

2026-08-03 00:20:53 -07:00

agent-action-gate.ts

FN-8764: route workflow stages through durable role agents

2026-08-07 01:36:34 -07:00

agent-heartbeat-error-recovery.ts

refactor: domain folder layout (types, API, core, engine) (#2398 )

2026-08-03 00:20:53 -07:00

agent-heartbeat-prompts.ts

refactor: domain folder layout (types, API, core, engine) (#2398 )