Codex

npm install -g @openai/codex

# Podium Integration Context

## SDK

- Package: `@podium-sdk/node-sdk`
- Install: `npm install @podium-sdk/node-sdk`

```typescript
import { createPodiumClient } from '@podium-sdk/node-sdk';

const client = createPodiumClient({
  apiKey: process.env.PODIUM_API_KEY,
});
```

## Key SDK Namespaces

- `client.product` — Product CRUD, variants, media
- `client.agentic` — Product feed, checkout sessions
- `client.companion` — Profiles, recommendations, interactions
- `client.user` — User management, points, rewards
- `client.userOrder` — Order lifecycle, checkout, discounts
- `client.tasks` — Task pools, bounties, verification
- `client.x402` — USDC payment flows
- `client.campaign` — Campaigns, voting, surveys

## API

- Base URL (staging): `https://podium-staging.up.railway.app/api/v1`
- Auth: `Authorization: Bearer <podium_api_key>`
- API keys are org-scoped: `podium_test_*` (staging) or `podium_live_*` (production)

## Patterns

- Always use SDK methods over raw fetch when available
- Pagination: `{ page: number, limit: number }`
- POST/PUT payloads go in `requestBody`
- Error shape: `{ error: string, statusCode: number }`

## Architecture

- Multi-tenant PostgreSQL with row-level security
- x402 for machine-native USDC payments on Base
- Companion profiles for user taste/intent data
- Enrichment pipeline for AI product attributes
- Async event system for background job processing

codex

codex --multi-agent "Build a complete product catalog page with search, filtering by category, and a detail view. Use the Podium SDK for all data fetching."

export PODIUM_API_KEY="podium_live_sk_..."

PODIUM_API_KEY=podium_live_sk_...