Kernel

import Kernel from '@onkernel/sdk';

const kernel = new Kernel({ projectID: process.env.KERNEL_PROJECT_ID! });

// 1. One vault per user, one Agentcard wallet inside it.
const vault = await kernel.vaults.upsert({ name: 'user-12345' });
const wallet = await kernel.vaults.items.upsert('agentcard-wallet', {
  id_or_name: vault.id,
  type: 'wallet',
  spec: { provider: 'agentcard' },
});
// First time: show wallet's enrollment action to the user, wait for status "connected".

// 2. A card item per purchase, with what the user will approve.
const card = await kernel.vaults.items.upsert('notebook-order', {
  id_or_name: vault.id,
  type: 'card',
  spec: {
    provider: 'agentcard',
    wallet: wallet.key,
    merchant: 'shop.example.com',
    amount: 2306, // minor units
    currency: 'usd',
  },
});

// 3. A browser with the vault attached. The agent shops and submits the card aliases.
const browser = await kernel.browsers.create({
  vaults: [{ id: vault.id }],
  headless: false,
  timeout_seconds: 1800,
});

npm i @agent-cards/checkout@0.3.0 @onkernel/sdk playwright-core

import Kernel from '@onkernel/sdk';
import { chromium } from 'playwright-core';
import { VaultClient, attachToPlaywright } from '@agent-cards/checkout';

const kernel = new Kernel({ apiKey: process.env.KERNEL_API_KEY! });
const kernelBrowser = await kernel.browsers.create({ stealth: true });
const browser = await chromium.connectOverCDP(kernelBrowser.cdp_ws_url);
const context = browser.contexts()[0] ?? (await browser.newContext({ serviceWorkers: 'block' }));
const page = context.pages()[0] ?? (await context.newPage());

const vault = new VaultClient({
  clientId: process.env.AGENTCARD_CLIENT_ID!,
  clientSecret: process.env.AGENTCARD_CLIENT_SECRET!,
});
await vault.syncRegistry();

const checkout = await attachToPlaywright(page, {
  vault,
  user: 'usr_8f3k2m',
  merchant: 'shop.example.com',
  amountCents: 2306,
  currency: 'usd',
  onApprovalUrl: (url) => sendToUser(url),
});