Document existing-user AgentCard wallet imports

[hiroTamada]

Summary

• Document importing an existing AgentCard user with a customer-owned provider configuration, with TypeScript, Python, and CLI examples.
• Explain provider-side validation, sandbox/live mode, connected wallets without cards, failed-import behavior, idempotency, and immutable bindings.
• Keep hosted enrollment as an explicit alternative and distinguish customer-owned imports from Kernel-managed wallet reuse.
• Update the wallet overview and item reference to match the deployed API behavior.

Validation

• mint@4.2.930 validate passed.
• mint@4.2.930 broken-links passed.
• Local preview returned HTTP 200 and rendered the import section and examples.
• Extracted TypeScript and Python import snippets executed against the released 0.127.0 SDKs with mock HTTP transports; both emitted the expected wallet-import request and parsed the connected response.
• TypeScript snippet passed strict type checking; CLI snippet passed bash -n.
• git diff --check passed.

No payment submission or checkout behavior is changed.

---

Note

Low Risk
Documentation-only updates to wallet integration guides; no runtime or API code changes.

Overview
Documents importing an already-connected AgentCard user into a KERNEL wallet when using a customer-owned provider configuration, instead of only describing KERNEL-hosted card_enrollment.

The AgentCard guide adds an Import an existing user section with TypeScript, Python, and CLI examples (spec.user_id from server-side mapping, no per-user OAuth tokens), plus behavior for validation, connected without cards, 400/409 outcomes, and idempotent bindings. Enroll through KERNEL instead is framed as the alternative when user_id is omitted. Lifecycle, enrollment warnings, and the wallet user_id item-reference row now separate customer-owned import from KERNEL-managed org-local reuse.

The wallets overview briefly notes that BYO clients let you connect users in your backend first (Link via tokens; AgentCard via user_id without another hosted enrollment).

^{Reviewed by Cursor Bugbot for commit 43e0710. Bugbot is set up for automated code reviews on this repo. Configure here.}

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated
Kernel	🟢 Ready	View Preview	Oct 19, 2026, 5:03 PM

💡 Tip: Enable Automations to automatically generate PRs for you.