Skip to content

feat: generalize prompt-injection mailman layer + one-shot poll/send CLI#1

Open
sampurnamo wants to merge 12 commits intoagentralabs:mainfrom
sampurnamo:feat/pubsub-delivery-example
Open

feat: generalize prompt-injection mailman layer + one-shot poll/send CLI#1
sampurnamo wants to merge 12 commits intoagentralabs:mainfrom
sampurnamo:feat/pubsub-delivery-example

Conversation

@sampurnamo
Copy link

@sampurnamo sampurnamo commented Mar 4, 2026

Summary

This PR packages reusable, project-agnostic coordination improvements that build on the earlier pub/sub delivery work:

  • adds one-shot chat poll/send CLI subcommands for deterministic hook-style prompt injection workflows
  • adds a generic multi-agent coordination guide (mailman-layer pattern)
  • adds verified pub/sub fan-out delivery example walkthrough
  • clarifies recipient-scoped delivery semantics in CLI docs
  • scrubs project/person-specific references to keep this as a general architecture contribution

Included commits

  • 73ac526 feat(acomm): add one-shot chat poll/send subcommands
  • 229a283 docs(example): use generic subscriber defaults
  • 1892fbb docs(coordination): remove agent-specific names and add hook pattern to summary
  • 2febd46 docs(coordination): remove Triveni-specific watcher references
  • dcc7b0e docs(coordination): simplify Layer 3 path — hook only, not plugin
  • 3ce337d docs(coordination): correct Layer 3 future path — achievable today via plugin
  • 3c3a488 docs(coordination): add watcher lifecycle wrapper usage
  • a664257 docs: add multi-agent coordination guide
  • e4778d7 docs(cli): clarify send/receive stream vs recipient-scoped delivery
  • 4600c6e docs(examples): add verified pubsub fan-out delivery walkthrough

Validation

  • cargo test -p agentic-comm-cli --quiet (pass)

Scope

No project-specific naming, no Triveni/sister coupling, no protocol-specific assumptions.

Covers verified patterns from live multi-session testing:
- channel semantics: direct/group (recipient:null) vs pub/sub fan-out
- cross-session delivery: store-level, confirmed with live message IDs
- three-layer awareness model: store delivery, human-terminal watcher,
  agent-session explicit polling
- poll-before-respond discipline for preventing parallel-reply blindspots
- watcher channel scope and dynamic channel resolution
- summary table of patterns and routing behavior

All commands and behaviors verified against live triveni.acomm store.
…a plugin

Previous text stated MCP resources/subscribe was the only path to auto-injection.
Corrected: the UserPromptSubmit hook pattern (Mira/MemSearch) achieves the same
outcome today without any MCP protocol changes. A proper acomm plugin can be built
using this pattern. MCP resources/subscribe remains aspirational for true mid-turn push.
A UserPromptSubmit hook script outputting acomm deltas is sufficient.
No MCP plugin architecture needed. Peer messages become ambient context,
same mechanism as task list / code snippet injection already in use.
…to summary

- Replace meera/ishika subscriber/recipient examples with generic agent-a/agent-b
- Replace real probe message content in cross-session table with generic placeholders
- Add UserPromptSubmit hook row to summary table — the ambient context injection pattern
@sampurnamo sampurnamo changed the title docs/examples: add verified pubsub fan-out delivery example feat: generalize prompt-injection mailman layer + one-shot poll/send CLI Mar 5, 2026
@omoshola-o omoshola-o mentioned this pull request Mar 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant