Skip to content

docs(chatkit): document identities, delegation scope, and external replies - #17

Draft
danielblignaut wants to merge 2 commits into
mainfrom
claude/agent-communication-group-chats-17af87
Draft

danielblignaut wants to merge 2 commits into
mainfrom
claude/agent-communication-group-chats-17af87

Conversation

@danielblignaut

@danielblignaut danielblignaut commented Aug 27, 2026

Copy link
Copy Markdown
Contributor

Companion to trytilde/api#172.

A ChatKit session can now hold several people and several agents at once, including people who arrived through GitHub or Slack and have no Tilde account. Documents:

  • ChatKit identity — what addresses each participant, and why the same handle in two GitHub organizations stays two people.
  • The invocation rule — an agent takes a turn only when a message addresses it; everything else arrives as context.
  • Unlinked external identities carry no permissions. An address on its own proves nothing about who sent it. Stated in both the human page and llms/chatkit.md because it is the rule most likely to be worked around by an agent trying to be helpful.
  • External replies — Tilde now delivers the agent's reply back to the platform the conversation started on, so an agent must not also post it with a provider tool, or the recipient gets it twice.
  • Session-scoped MCP connectionsx-tilde-chatkit-session-id or chatkit: { sessionId }, and the fact that a session the caller may not use rejects the connection rather than silently dropping the scoped tools.

Human pages carry the concepts; llms/chatkit.md carries the exact headers, field names, and rules an agent needs.

Validation

mint validate passes. git diff --check clean. No tool-catalog change, so no provider regeneration is required.

🤖 Generated with Claude Code


View with [code]smith Autofix with [code]smith
Need help on this PR? Tag @codesmith-bot with what you need. Autofix is disabled.

danielblignaut and others added 2 commits August 27, 2026 16:58
…plies

A ChatKit session can now hold several people and several agents at once,
including people who arrived through GitHub or Slack and have no Tilde account.
Document the identity that addresses each of them, the rule that an agent takes
a turn only when a message addresses it, and the fact that an unlinked external
address carries no permissions.

Also document that Tilde now delivers an agent's reply back to the platform the
conversation started on, so an agent must not post that reply itself, and that
scoping the runtime's MCP connection to a session records a delegation as a
child of it.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Reaching another agent no longer needs a per-agent provider added to an MCP
server. Document the four tools a session-scoped connection is offered, that
none of them take a session id, and that a new agent becomes reachable as soon
as the caller has visibility on it.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
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