Skip to content

Conversation

@humanagent
Copy link
Collaborator

@humanagent humanagent commented Jan 31, 2026

Upgrade examples and docs to @xmtp/agent-sdk 2.0.0 and switch message APIs to MessageContext.conversation.sendText/sendActions/sendMarkdown/sendWalletSendCalls across example handlers

Bumps SDK to 2.0.0, replaces deprecated ctx.sendText and generic conversation.send calls with conversation-specific send methods, refactors inline actions to use @xmtp/node-sdk, updates attachments to ctx.sendRemoteAttachment and downloadRemoteAttachment, and adds/refreshes repository documentation and changelog.

📍Where to Start

Start with SDK usage changes in Agent.createFromEnv and handler message sends in examples/xmtp-generalstore/index.ts, then review inline actions refactor in utils/inline-actions.ts and attachment handling in examples/xmtp-attachments/index.ts.


📊 Macroscope summarized fde0501. 50 files reviewed, 20 issues evaluated, 1 issue filtered, 1 comment posted

🗂️ Filtered Issues

examples/xmtp-gated-group/index.ts — 0 comments posted, 1 evaluated, 1 filtered
  • line 127: The logic for tracking group membership fails due to inconsistent user identifier usage that becomes problematic with the SDK migration implied by the diff. The middleware checks membership using ctx.message.senderInboxId (line 57), but the handler adds users to the set using ctx.getSenderAddress() (line 141). The switch from agent.client.conversations.newGroup (V2) to agent.createGroupWithAddresses (V3/Agent SDK) in the diff at line 127 implies a context where senderInboxId (Identity) and senderAddress (Wallet) are distinct values. Consequently, usersInGroup.has(senderInboxId) will return false even after usersInGroup.add(senderAddress) is called, causing state loss. This allows users to bypass the validation and repeatedly trigger the group creation flow. [ Already posted ]

- Update all example packages to use agent-sdk 2.0.0-rc3 from root
- Fix xmtp-attachments: Update EncryptedAttachment API (payload instead of content.payload)
- Fix xmtp-gated-group: Use agent.createGroupWithAddresses instead of conversations.newGroup
- Fix xmtp-thinking-reaction: Use ReactionSchema enum and ctx.sendReaction
- Fix xmtp-generalstore: Import ActionStyle from @xmtp/node-sdk correctly
- Fix utils/inline-actions: Import ActionStyle as value, not type
- Update sendRemoteAttachment to use ctx.sendRemoteAttachment
- All builds passing, lint warnings only (no errors)
@humanagent humanagent changed the title Agentsdk200 AgentsSDK 2.0.0 Jan 31, 2026
- Add 8 skills with 30 rule files covering core XMTP patterns
- Skills: agent-basics, commands, inline-actions, attachments, transactions, groups, reactions, domain-resolver
- Remove .cursor/rules/ (content moved to skills/)
- Update README with skills listing and installation instructions
- Add AGENTS.md with AI agent guidelines
- Remove Related examples sections from all skills
- Remove lib/ bundled code directories (skills can't import)
- Add implementation snippets directly in SKILL.md files
- Update code examples to remove prescriptive import paths
- Skills now show patterns and how to implement helpers
Copy link

@macroscopeapp macroscopeapp bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Re-evaluating approvability for fde0501

Skills are now in the correct location for Cursor to automatically
discover and use them as AI context.
@humanagent humanagent changed the title AgentsSDK 2.0.0 AgentsSDK 2.0.0 + Skills Jan 31, 2026
@humanagent humanagent merged commit 4ae5516 into main Feb 4, 2026
5 checks passed
@humanagent humanagent deleted the agentsdk200 branch February 4, 2026 10:48
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