@contractspec/example.messaging-agent-actions

Safe messaging agent actions example with fixed intents, allowlisted action execution, workflow dispatch, and deterministic confirmation replies.

What This Demonstrates

• Inbound message normalization for Slack, WhatsApp, Telegram, or any messaging bridge.
• Fixed intent parsing: status, run action, and dispatch workflow.
• Allowlisted action and workflow routing instead of arbitrary tool execution.
• Replayable meetup proof for the canonical status -> action -> workflow walkthrough.

Running Locally

From packages/examples/messaging-agent-actions:

• bun run build
• bun run test
• bun run typecheck
• bun run proof
• bun run preflight

Usage

Use this package when you need a conservative messaging demo that proves agent actions can stay safe, typed, and reviewable even when messages come from live provider webhooks.

Public Entry Points

• Export . resolves through ./src/index.ts.
• Export ./contracts resolves through ./src/contracts/index.ts.
• Export ./docs resolves through ./src/docs/index.ts.
• Export ./example resolves through ./src/example.ts.
• Export ./handlers resolves through ./src/handlers/index.ts.
• Export ./messaging-agent-actions.feature resolves through ./src/messaging-agent-actions.feature.ts.
• Export ./proof/* resolves through ./src/proof/*.ts.

Local Commands

• bun run build — bun run prebuild && bun run build:bundle && bun run build:types
• bun run test — bun test
• bun run typecheck — tsc --noEmit
• bun run proof — bun ../../../scripts/generate-messaging-agent-actions-meetup-proof.ts
• bun run preflight — bun run build && bun run typecheck && bun run test && bun run proof