Skip to content

Align session-id copy with prefix addressing#66

Open
nertzy wants to merge 1 commit into
nicobailon:mainfrom
nertzy:align-session-id-copy
Open

Align session-id copy with prefix addressing#66
nertzy wants to merge 1 commit into
nicobailon:mainfrom
nertzy:align-session-id-copy

Conversation

@nertzy

@nertzy nertzy commented Jul 16, 2026

Copy link
Copy Markdown

What

Align the intercom tool's human/agent-facing copy with how session addressing actually resolves.

list renders every session as name (shortId) (the leading 8 chars of the session ID). resolveSessionTarget already accepts a leading ID prefix, so that short id is a valid target - but nothing told the caller that:

  • the duplicate-name error said Use the session ID instead. while list only ever shows the short id, so the caller had no addressable identifier;
  • the tool description and the to param help only mentioned "name or ID".

Agents (and humans) hit this whenever two sessions share a name: name-addressing throws, the only visible id looks un-addressable, and send/ask fail in a loop.

Change

  • Duplicate-name error now points at the short ids shown by list, e.g.
    Multiple sessions named "twin" are connected. Address one by the id shown in parentheses by "list" (aaaa1111, bbbb2222).
  • Tool description + to param document name / full ID / short-id-prefix as valid targets.
  • Test asserting the collision error names both short ids.

No behavior change to resolveSessionTarget - prefix resolution already existed on main; this makes the surface copy match it.

Test

npm test - 92 pass.

The intercom tool renders each session in "list" as name (shortId), but the
tool description, the "to" param help, and the duplicate-name error never told
the caller that the parenthesized short id is itself a valid target. Agents
read "Use the session ID instead", saw only the short id, and had no signal
that it resolves - producing repeated send/ask failures whenever two sessions
shared a name.

resolveSessionTarget already resolves a leading ID prefix; this aligns the
human/agent-facing copy with that behavior:

- duplicate-name error now points at the short ids shown by "list"
- tool description and "to" param document name / full ID / short-id-prefix
- add a test asserting the collision error names both short ids
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