Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 5 additions & 8 deletions .changeset/sdk-v2-rebuild.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,15 +2,15 @@
"scope3": major
---

SDK v2.0.0: Persona-based API architecture
Persona-based API architecture for Agentic Platform v2

Complete rebuild of the Scope3 SDK with persona-based design for the Agentic Platform v2 API.

**New Features:**
- Unified `Scope3Client` with `persona` parameter: `buyer` or `partner`
- Full CLI with `scope3` command for all API operations
- REST and MCP adapter support
- Buyer resources: advertisers, campaigns (discovery/performance/audience), bundles, signals, reporting, sales agents
- Buyer resources: advertisers, campaigns (discovery/performance/audience), bundles, signals, reporting, sales agents, conversion events, creative sets
- Partner resources: partners, agents (with OAuth flows)

**CLI Highlights:**
Expand All @@ -25,7 +25,9 @@ Complete rebuild of the Scope3 SDK with persona-based design for the Agentic Pla
- Campaign type `bundle` renamed to `discovery`
- Reporting moved from advertiser sub-resource to top-level `client.reporting`
- Removed auto-generated types from OpenAPI (now manually maintained)
- New API surface matches Agentic Platform v2
- Auth uses `Authorization: Bearer` header (was `x-scope3-api-key`)
- Response envelope: `{ data, pagination, error }` (was flat)
- MCP uses single `api_call` tool (was per-resource tools)

**Migration Guide:**

Expand All @@ -43,8 +45,3 @@ const buyerClient = new Scope3Client({ apiKey: '...', persona: 'buyer' });
// For partners (agent registration, OAuth):
const partnerClient = new Scope3Client({ apiKey: '...', persona: 'partner' });
```

**Testing:**
- 211 tests passing
- Verified with real API calls to staging environment
- CLI tested for all major workflows
2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "scope3",
"version": "2.0.0",
"version": "1.1.0",
"description": "Scope3 SDK - REST and MCP client for the Agentic Platform",
"engines": {
"node": ">=18"
Expand Down