OpenMerch SDK

OpenMerch is a job execution layer for AI agents. Agents submit jobs by type, get structured results back, and pay per job with usage-based billing.

Under the hood, OpenMerch routes jobs to providers via the Machine Payable Protocol (MPP). Agents never interact with MPP directly.

Packages

Package	Version	Status	Description
@openmerch/agent		Runtime SDK	HTTP client for job planning, execution, and billing

Provider integrations are currently operator-managed. Public provider onboarding and provider SDK docs are not part of the current public SDK surface.

Quick Start

npm install @openmerch/agent

import { OpenMerchAgent } from "@openmerch/agent";

const agent = new OpenMerchAgent({
  baseUrl: "https://api.openmerch.dev",
  apiKey: process.env.OPENMERCH_API_KEY!,
});

// check cost before committing
const plan = await agent.planJob({
  job_type: "lead_qualification_v1",
  input: { domain: "acme.com" },
});

// execute the job — cost accrues to your account
const job = await agent.executeJob({
  job_type: "lead_qualification_v1",
  input: { domain: "acme.com" },
  max_cost: plan.estimated_cost.max_microcents,
  idempotency_key: `lead-acme-${Date.now()}`,
});

console.log(job.output);
console.log(job.cost);

See the agent package README for full API reference.

Examples

Example	Description
agent-basic	V1 SDK type surface demo (mocked, no network)

Repo Layout

packages/
  agent/        @openmerch/agent — runtime SDK
examples/
  agent-basic/  Runnable agent example

Migration from Preview Types

The @openmerch/agent package previously exported preview type contracts (TaskRequest, ServiceQuery, WalletBalance, etc.). These have been replaced by the V1 runtime SDK as a pre-1.0 breaking reset.

Old (removed)	New
TaskRequest	ExecuteJobRequest
TaskResult	JobResponse
ServiceQuery / ServiceListing	getCatalog() / planJob()
WalletBalance	Card-on-file billing via getBillingConfig()
AgentConfig (types-only)	AgentConfig (runtime — passed to new OpenMerchAgent())

Development

npm install          # Install all workspace dependencies
npm run build        # Build all packages and examples
npm run typecheck    # Type-check all workspaces (no emit)
npm run test         # Run tests across all workspaces
npm run clean        # Remove build artifacts

See CONTRIBUTING.md for full development guidelines.

Pre-1.0 Stability

These packages are versioned below 1.0. Before 1.0, minor releases may include breaking changes. See individual package READMEs for current scope.

License

MIT