@adcp/sdk 6.5.0 → 6.7.0

package/dist/lib/mock-server/creative-template/seed-data.js

@@ -0,0 +1,149 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_API_KEY = exports.WORKSPACES = exports.TEMPLATES = void 0;
+/**
+ * Templates seeded across both workspaces. Each represents a common creative
+ * shape (display medium rectangle, leaderboard, mobile banner, video
+ * preroll). The slot definitions intentionally use upstream vocabulary
+ * (`slot_id`) rather than AdCP's `asset_role` so the adapter has to
+ * translate during list_creative_formats projection.
+ */
+exports.TEMPLATES = [
+    {
+        template_id: 'tpl_celtra_display_medrec_v2',
+        name: 'Display Medium Rectangle (300x250)',
+        description: 'Standard IAB medium rectangle with brand-aware text overlay and CTA.',
+        channel: 'display',
+        dimensions: { width: 300, height: 250 },
+        output_kind: 'html_tag',
+        slots: [
+            {
+                slot_id: 'image',
+                asset_type: 'image',
+                required: true,
+                constraints: { width: 300, height: 250, mime_types: ['image/jpeg', 'image/png', 'image/webp'] },
+            },
+            {
+                slot_id: 'headline',
+                asset_type: 'text',
+                required: true,
+                constraints: { max_chars: 40 },
+            },
+            {
+                slot_id: 'cta',
+                asset_type: 'text',
+                required: true,
+                constraints: { max_chars: 20 },
+            },
+            {
+                slot_id: 'click_through',
+                asset_type: 'click_url',
+                required: true,
+            },
+        ],
+        sample_inputs: {
+            image_url: 'https://test-assets.adcontextprotocol.org/acme-outdoor/hero-300x250.jpg',
+            headline: 'Built for the trail.',
+            cta: 'Shop Gear',
+        },
+    },
+    {
+        template_id: 'tpl_celtra_display_leaderboard_v2',
+        name: 'Display Leaderboard (728x90)',
+        description: 'Standard IAB leaderboard with brand-aware text overlay and CTA. JS tag output (carries impression macros, viewability shims, MRAID/SafeFrame hooks per IAB OpenRTB 2.6 §3.2.4).',
+        channel: 'display',
+        dimensions: { width: 728, height: 90 },
+        output_kind: 'javascript_tag',
+        slots: [
+            {
+                slot_id: 'image',
+                asset_type: 'image',
+                required: true,
+                constraints: { width: 728, height: 90, mime_types: ['image/jpeg', 'image/png', 'image/webp'] },
+            },
+            {
+                slot_id: 'headline',
+                asset_type: 'text',
+                required: true,
+                constraints: { max_chars: 60 },
+            },
+            {
+                slot_id: 'cta',
+                asset_type: 'text',
+                required: true,
+                constraints: { max_chars: 20 },
+            },
+            {
+                slot_id: 'click_through',
+                asset_type: 'click_url',
+                required: true,
+            },
+        ],
+    },
+    {
+        template_id: 'tpl_celtra_mobile_banner_v2',
+        name: 'Mobile Banner (320x50)',
+        description: 'Standard IAB mobile banner. JS tag output for in-app/MRAID compatibility.',
+        channel: 'display',
+        dimensions: { width: 320, height: 50 },
+        output_kind: 'javascript_tag',
+        slots: [
+            {
+                slot_id: 'image',
+                asset_type: 'image',
+                required: true,
+                constraints: { width: 320, height: 50, mime_types: ['image/jpeg', 'image/png', 'image/webp'] },
+            },
+            {
+                slot_id: 'cta',
+                asset_type: 'text',
+                required: true,
+                constraints: { max_chars: 16 },
+            },
+            {
+                slot_id: 'click_through',
+                asset_type: 'click_url',
+                required: true,
+            },
+        ],
+    },
+    {
+        template_id: 'tpl_celtra_video_preroll_v1',
+        name: 'Video Preroll (15s)',
+        description: 'In-stream video preroll with 15-second cap and end card.',
+        channel: 'video',
+        duration_seconds: { min: 6, max: 15 },
+        output_kind: 'vast_xml',
+        slots: [
+            {
+                slot_id: 'video',
+                asset_type: 'video',
+                required: true,
+                constraints: { duration_max_seconds: 15, mime_types: ['video/mp4', 'video/webm'] },
+            },
+            {
+                slot_id: 'click_through',
+                asset_type: 'click_url',
+                required: true,
+            },
+        ],
+    },
+];
+exports.WORKSPACES = [
+    {
+        workspace_id: 'ws_acme_studio',
+        display_name: 'Acme Outdoor Creative Studio',
+        adcp_advertiser: 'acmeoutdoor.example',
+        visible_template_ids: exports.TEMPLATES.map(t => t.template_id),
+    },
+    {
+        workspace_id: 'ws_summit_studio',
+        display_name: 'Summit Media Creative Studio',
+        adcp_advertiser: 'summit-media.example',
+        // Summit's workspace doesn't have video access — only display templates.
+        visible_template_ids: exports.TEMPLATES.filter(t => t.channel === 'display').map(t => t.template_id),
+    },
+];
+/** Default static API key. Override via `--api-key` at boot. */
+exports.DEFAULT_API_KEY = 'mock_creative_template_key_do_not_use_in_prod';
+//# sourceMappingURL=seed-data.js.map

package/dist/lib/mock-server/creative-template/seed-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed-data.js","sourceRoot":"","sources":["../../../../src/lib/mock-server/creative-template/seed-data.ts"],"names":[],"mappings":";;;AA8BA;;;;;;GAMG;AACU,QAAA,SAAS,GAAmB;IACvC;QACE,WAAW,EAAE,8BAA8B;QAC3C,IAAI,EAAE,oCAAoC;QAC1C,WAAW,EAAE,sEAAsE;QACnF,OAAO,EAAE,SAAS;QAClB,UAAU,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;QACvC,WAAW,EAAE,UAAU;QACvB,KAAK,EAAE;YACL;gBACE,OAAO,EAAE,OAAO;gBAChB,UAAU,EAAE,OAAO;gBACnB,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,YAAY,EAAE,WAAW,EAAE,YAAY,CAAC,EAAE;aAChG;YACD;gBACE,OAAO,EAAE,UAAU;gBACnB,UAAU,EAAE,MAAM;gBAClB,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;aAC/B;YACD;gBACE,OAAO,EAAE,KAAK;gBACd,UAAU,EAAE,MAAM;gBAClB,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;aAC/B;YACD;gBACE,OAAO,EAAE,eAAe;gBACxB,UAAU,EAAE,WAAW;gBACvB,QAAQ,EAAE,IAAI;aACf;SACF;QACD,aAAa,EAAE;YACb,SAAS,EAAE,yEAAyE;YACpF,QAAQ,EAAE,sBAAsB;YAChC,GAAG,EAAE,WAAW;SACjB;KACF;IACD;QACE,WAAW,EAAE,mCAAmC;QAChD,IAAI,EAAE,8BAA8B;QACpC,WAAW,EACT,iLAAiL;QACnL,OAAO,EAAE,SAAS;QAClB,UAAU,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE;QACtC,WAAW,EAAE,gBAAgB;QAC7B,KAAK,EAAE;YACL;gBACE,OAAO,EAAE,OAAO;gBAChB,UAAU,EAAE,OAAO;gBACnB,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,YAAY,EAAE,WAAW,EAAE,YAAY,CAAC,EAAE;aAC/F;YACD;gBACE,OAAO,EAAE,UAAU;gBACnB,UAAU,EAAE,MAAM;gBAClB,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;aAC/B;YACD;gBACE,OAAO,EAAE,KAAK;gBACd,UAAU,EAAE,MAAM;gBAClB,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;aAC/B;YACD;gBACE,OAAO,EAAE,eAAe;gBACxB,UAAU,EAAE,WAAW;gBACvB,QAAQ,EAAE,IAAI;aACf;SACF;KACF;IACD;QACE,WAAW,EAAE,6BAA6B;QAC1C,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE,2EAA2E;QACxF,OAAO,EAAE,SAAS;QAClB,UAAU,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE;QACtC,WAAW,EAAE,gBAAgB;QAC7B,KAAK,EAAE;YACL;gBACE,OAAO,EAAE,OAAO;gBAChB,UAAU,EAAE,OAAO;gBACnB,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,YAAY,EAAE,WAAW,EAAE,YAAY,CAAC,EAAE;aAC/F;YACD;gBACE,OAAO,EAAE,KAAK;gBACd,UAAU,EAAE,MAAM;gBAClB,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;aAC/B;YACD;gBACE,OAAO,EAAE,eAAe;gBACxB,UAAU,EAAE,WAAW;gBACvB,QAAQ,EAAE,IAAI;aACf;SACF;KACF;IACD;QACE,WAAW,EAAE,6BAA6B;QAC1C,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE,0DAA0D;QACvE,OAAO,EAAE,OAAO;QAChB,gBAAgB,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;QACrC,WAAW,EAAE,UAAU;QACvB,KAAK,EAAE;YACL;gBACE,OAAO,EAAE,OAAO;gBAChB,UAAU,EAAE,OAAO;gBACnB,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,EAAE,oBAAoB,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,WAAW,EAAE,YAAY,CAAC,EAAE;aACnF;YACD;gBACE,OAAO,EAAE,eAAe;gBACxB,UAAU,EAAE,WAAW;gBACvB,QAAQ,EAAE,IAAI;aACf;SACF;KACF;CACF,CAAC;AAEW,QAAA,UAAU,GAAoB;IACzC;QACE,YAAY,EAAE,gBAAgB;QAC9B,YAAY,EAAE,8BAA8B;QAC5C,eAAe,EAAE,qBAAqB;QACtC,oBAAoB,EAAE,iBAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;KACxD;IACD;QACE,YAAY,EAAE,kBAAkB;QAChC,YAAY,EAAE,8BAA8B;QAC5C,eAAe,EAAE,sBAAsB;QACvC,yEAAyE;QACzE,oBAAoB,EAAE,iBAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;KAC7F;CACF,CAAC;AAEF,gEAAgE;AACnD,QAAA,eAAe,GAAG,+CAA+C,CAAC"}

package/dist/lib/mock-server/creative-template/server.d.ts

@@ -0,0 +1,13 @@
+import { type MockTemplate, type MockWorkspace } from './seed-data';
+export interface BootOptions {
+    port: number;
+    apiKey?: string;
+    templates?: MockTemplate[];
+    workspaces?: MockWorkspace[];
+}
+export interface BootResult {
+    url: string;
+    close: () => Promise<void>;
+}
+export declare function bootCreativeTemplate(options: BootOptions): Promise<BootResult>;
+//# sourceMappingURL=server.d.ts.map

package/dist/lib/mock-server/creative-template/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../src/lib/mock-server/creative-template/server.ts"],"names":[],"mappings":"AAEA,OAAO,EAA0C,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5G,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAsBD,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAgDpF"}

package/dist/lib/mock-server/creative-template/server.js

@@ -0,0 +1,325 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bootCreativeTemplate = bootCreativeTemplate;
+const node_http_1 = require("node:http");
+const node_crypto_1 = require("node:crypto");
+const seed_data_1 = require("./seed-data");
+async function bootCreativeTemplate(options) {
+    const apiKey = options.apiKey ?? seed_data_1.DEFAULT_API_KEY;
+    const templates = options.templates ?? seed_data_1.TEMPLATES;
+    const workspaces = options.workspaces ?? seed_data_1.WORKSPACES;
+    const renders = new Map();
+    // client_request_id idempotency table — keyed by `<workspace_id>::<key>`.
+    const idempotency = new Map();
+    // Traffic counters keyed by `<METHOD> <route-template>`. Harness queries
+    // `GET /_debug/traffic` after the storyboard run and asserts headline
+    // routes were hit ≥1. Façade adapters that skip the upstream produce zero
+    // counters and fail the assertion. adcontextprotocol/adcp-client#1225.
+    const traffic = new Map();
+    const bump = (routeTemplate) => {
+        traffic.set(routeTemplate, (traffic.get(routeTemplate) ?? 0) + 1);
+    };
+    const server = (0, node_http_1.createServer)((req, res) => {
+        handleRequest(req, res, { apiKey, templates, workspaces, renders, idempotency, traffic, bump }).catch(err => {
+            const requestId = req.headers['x-request-id'] ?? (0, node_crypto_1.randomUUID)();
+            writeJson(res, 500, {
+                code: 'internal_error',
+                message: err?.message ?? 'unexpected error',
+                request_id: requestId,
+            });
+        });
+    });
+    await new Promise((resolve, reject) => {
+        server.once('error', reject);
+        server.listen(options.port, '127.0.0.1', () => {
+            server.removeListener('error', reject);
+            resolve();
+        });
+    });
+    const addr = server.address();
+    const boundPort = typeof addr === 'object' && addr ? addr.port : options.port;
+    const url = `http://127.0.0.1:${boundPort}`;
+    return {
+        url,
+        close: () => new Promise((resolve, reject) => {
+            server.close(err => (err ? reject(err) : resolve()));
+        }),
+    };
+}
+async function handleRequest(req, res, ctx) {
+    const url = new URL(req.url ?? '/', `http://127.0.0.1`);
+    const path = url.pathname;
+    const method = req.method ?? 'GET';
+    // Façade-detection traffic dump — harness-only, no auth required.
+    if (method === 'GET' && path === '/_debug/traffic') {
+        writeJson(res, 200, { traffic: Object.fromEntries(ctx.traffic) });
+        return;
+    }
+    // Discovery endpoint — replaces the hardcoded principal-mapping table the
+    // harness used to inline into Claude's prompt. Adapters resolve at runtime
+    // by querying with the AdCP-side identifier they receive from buyers
+    // (`account.advertiser`, `account.brand.domain`). No auth required —
+    // discovery happens before the agent has any workspace context. Issue #1225.
+    if (method === 'GET' && path === '/_lookup/workspace') {
+        ctx.bump('GET /_lookup/workspace');
+        const adcpAdvertiser = url.searchParams.get('adcp_advertiser');
+        if (!adcpAdvertiser) {
+            writeJson(res, 400, {
+                code: 'invalid_request',
+                message: 'adcp_advertiser query parameter is required.',
+            });
+            return;
+        }
+        const match = ctx.workspaces.find(w => w.adcp_advertiser === adcpAdvertiser);
+        if (!match) {
+            writeJson(res, 404, {
+                code: 'workspace_not_found',
+                message: `No upstream workspace registered for adcp_advertiser=${adcpAdvertiser}.`,
+            });
+            return;
+        }
+        writeJson(res, 200, {
+            adcp_advertiser: match.adcp_advertiser,
+            workspace_id: match.workspace_id,
+            display_name: match.display_name,
+        });
+        return;
+    }
+    // Authentication.
+    const auth = req.headers['authorization'];
+    if (!auth || !auth.startsWith('Bearer ') || auth.slice(7) !== ctx.apiKey) {
+        writeJson(res, 401, { code: 'unauthorized', message: 'Missing or invalid bearer credential.' });
+        return;
+    }
+    // Path-based workspace scoping. Matches /v3/workspaces/{ws}/...
+    const wsMatch = path.match(/^\/v3\/workspaces\/([^/]+)(\/.*)?$/);
+    if (!wsMatch || !wsMatch[1]) {
+        writeJson(res, 404, { code: 'not_found', message: `No route for ${method} ${path}` });
+        return;
+    }
+    const workspaceId = decodeURIComponent(wsMatch[1]);
+    const subPath = wsMatch[2] ?? '/';
+    const workspace = ctx.workspaces.find(w => w.workspace_id === workspaceId);
+    if (!workspace) {
+        writeJson(res, 404, { code: 'workspace_not_found', message: `Workspace ${workspaceId} not found.` });
+        return;
+    }
+    // Bump traffic counters on each real-route hit so /_debug/traffic can later
+    // report which endpoints the adapter actually exercised.
+    if (method === 'GET' && subPath === '/templates') {
+        ctx.bump('GET /v3/workspaces/{ws}/templates');
+        return handleListTemplates(url, ctx, workspace, res);
+    }
+    const tplMatch = subPath.match(/^\/templates\/([^/]+)$/);
+    if (method === 'GET' && tplMatch && tplMatch[1]) {
+        ctx.bump('GET /v3/workspaces/{ws}/templates/{id}');
+        return handleGetTemplate(decodeURIComponent(tplMatch[1]), ctx, workspace, res);
+    }
+    if (method === 'POST' && subPath === '/renders') {
+        ctx.bump('POST /v3/workspaces/{ws}/renders');
+        return handleCreateRender(req, ctx, workspace, res);
+    }
+    const rMatch = subPath.match(/^\/renders\/([^/]+)$/);
+    if (method === 'GET' && rMatch && rMatch[1]) {
+        ctx.bump('GET /v3/workspaces/{ws}/renders/{id}');
+        return handleGetRender(decodeURIComponent(rMatch[1]), ctx, workspace, res);
+    }
+    writeJson(res, 404, { code: 'not_found', message: `No route for ${method} ${path}` });
+}
+function handleListTemplates(url, ctx, ws, res) {
+    const visible = ctx.templates.filter(t => ws.visible_template_ids.includes(t.template_id));
+    const channel = url.searchParams.get('channel');
+    const filtered = channel ? visible.filter(t => t.channel === channel) : visible;
+    writeJson(res, 200, { templates: filtered });
+}
+function handleGetTemplate(templateId, ctx, ws, res) {
+    const template = ctx.templates.find(t => t.template_id === templateId);
+    if (!template) {
+        writeJson(res, 404, { code: 'template_not_found', message: `Template ${templateId} not found.` });
+        return;
+    }
+    if (!ws.visible_template_ids.includes(templateId)) {
+        writeJson(res, 404, {
+            code: 'template_not_visible',
+            message: `Template ${templateId} is not visible to workspace ${ws.workspace_id}.`,
+        });
+        return;
+    }
+    writeJson(res, 200, template);
+}
+async function handleCreateRender(req, ctx, ws, res) {
+    let body;
+    try {
+        body = await readJson(req);
+    }
+    catch {
+        writeJson(res, 400, { code: 'invalid_json', message: 'Request body must be valid JSON.' });
+        return;
+    }
+    if (!isObject(body)) {
+        writeJson(res, 400, { code: 'invalid_request', message: 'Body must be an object.' });
+        return;
+    }
+    const { template_id, inputs, mode, client_request_id } = body;
+    if (typeof template_id !== 'string' || !Array.isArray(inputs) || (mode !== 'preview' && mode !== 'build')) {
+        writeJson(res, 400, {
+            code: 'invalid_request',
+            message: 'template_id (string), inputs (array), and mode ("preview" or "build") are required.',
+        });
+        return;
+    }
+    const template = ctx.templates.find(t => t.template_id === template_id);
+    if (!template || !ws.visible_template_ids.includes(template_id)) {
+        writeJson(res, 404, {
+            code: template ? 'template_not_visible' : 'template_not_found',
+            message: `Template ${template_id} ${template ? 'not visible' : 'not found'}.`,
+        });
+        return;
+    }
+    const fingerprint = fingerprintBody(template_id, inputs, mode);
+    // Idempotency replay (same body) / conflict (mismatched body).
+    if (typeof client_request_id === 'string' && client_request_id.length > 0) {
+        const idemKey = `${ws.workspace_id}::${client_request_id}`;
+        const existing = ctx.idempotency.get(idemKey);
+        if (existing) {
+            const render = ctx.renders.get(existing);
+            if (render) {
+                if (render.body_fingerprint !== fingerprint) {
+                    writeJson(res, 409, {
+                        code: 'idempotency_conflict',
+                        message: `client_request_id ${client_request_id} was previously used with a different body. Use a fresh idempotency key for distinct requests.`,
+                    });
+                    return;
+                }
+                writeJson(res, 200, serializeRender(render));
+                return;
+            }
+        }
+    }
+    const renderId = `rnd_${(0, node_crypto_1.randomUUID)().replace(/-/g, '').slice(0, 16)}`;
+    const now = new Date();
+    const render = {
+        render_id: renderId,
+        workspace_id: ws.workspace_id,
+        status: 'queued',
+        template_id,
+        mode,
+        body_fingerprint: fingerprint,
+        created_at: now.toISOString(),
+        updated_at: now.toISOString(),
+    };
+    ctx.renders.set(renderId, render);
+    if (typeof client_request_id === 'string' && client_request_id.length > 0) {
+        ctx.idempotency.set(`${ws.workspace_id}::${client_request_id}`, renderId);
+    }
+    writeJson(res, 202, serializeRender(render));
+}
+function handleGetRender(renderId, ctx, ws, res) {
+    const render = ctx.renders.get(renderId);
+    if (!render) {
+        writeJson(res, 404, { code: 'render_not_found', message: `Render ${renderId} not found.` });
+        return;
+    }
+    if (render.workspace_id !== ws.workspace_id) {
+        writeJson(res, 404, {
+            code: 'render_not_in_workspace',
+            message: `Render ${renderId} not found in workspace ${ws.workspace_id}.`,
+        });
+        return;
+    }
+    // Auto-promote queued → running on first poll, running → complete on second.
+    // Real platforms render in seconds-to-minutes; the mock simulates a fast
+    // async with two state transitions to exercise polling without making the
+    // matrix run drag. The `else if` chain means a `complete` render is a
+    // terminal state — subsequent polls return the same complete render
+    // without further mutation. Callers serializing polls (one GET at a time)
+    // observe each transition exactly once; concurrent polls in flight will
+    // both see the post-transition state, which is fine for a fixture but
+    // means the matrix harness should not race polls against itself.
+    const template = ctx.templates.find(t => t.template_id === render.template_id);
+    if (render.status === 'queued') {
+        render.status = 'running';
+        render.updated_at = new Date().toISOString();
+    }
+    else if (render.status === 'running') {
+        render.status = 'complete';
+        render.updated_at = new Date().toISOString();
+        render.output = synthesizeOutput(render, template);
+    }
+    writeJson(res, 200, serializeRender(render));
+}
+function synthesizeOutput(render, template) {
+    // Fixture output. Real platforms return real ad tags / VAST XML / etc; the
+    // mock returns plausible-looking synthetic output so adapters can pattern-
+    // match without rendering anything real. The kind is driven by the
+    // template's output_kind so the adapter has to read it and project to AdCP
+    // creative_manifest correctly.
+    const previewBase = `https://mock-creative-template.example/preview/${render.render_id}`;
+    if (!template) {
+        return { preview_url: previewBase };
+    }
+    if (template.output_kind === 'vast_xml') {
+        return {
+            vast_xml: `<?xml version="1.0"?><VAST version="4.2"><Ad id="${render.render_id}"><InLine><AdSystem>MockCreativeTemplate</AdSystem><AdTitle>${template.name}</AdTitle></InLine></Ad></VAST>`,
+            preview_url: previewBase,
+            assets: [{ kind: 'video_tag', mime_type: 'application/xml+vast' }],
+        };
+    }
+    if (template.output_kind === 'javascript_tag') {
+        return {
+            tag_javascript: `(function(){var d=document;var img=d.createElement('img');img.src='${previewBase}.png';d.write(img.outerHTML);})();`,
+            preview_url: previewBase,
+            assets: [{ kind: 'js_tag', mime_type: 'application/javascript' }],
+        };
+    }
+    // default html_tag
+    return {
+        tag_html: `<a href="https://example.com/click"><img src="${previewBase}.png" width="${template.dimensions?.width ?? 300}" height="${template.dimensions?.height ?? 250}" alt="${template.name}" /></a>`,
+        preview_url: previewBase,
+        assets: [{ kind: 'html_tag', mime_type: 'text/html' }],
+    };
+}
+function serializeRender(r) {
+    // workspace_id / body_fingerprint are internal book-keeping — strip from public payload.
+    const { workspace_id, body_fingerprint, ...rest } = r;
+    return rest;
+}
+function fingerprintBody(templateId, inputs, mode) {
+    // Stable JSON canonicalization for body equivalence. Serializing a sorted-
+    // key copy gives whitespace/order independence without pulling in a
+    // dependency. Inputs are array-position-significant (slot order matters
+    // for some upstream renders), so we don't sort the array itself.
+    return JSON.stringify({ template_id: templateId, inputs, mode });
+}
+function readJson(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on('data', c => chunks.push(c));
+        req.on('error', reject);
+        req.on('end', () => {
+            const raw = Buffer.concat(chunks).toString('utf8');
+            if (!raw) {
+                resolve({});
+                return;
+            }
+            try {
+                resolve(JSON.parse(raw));
+            }
+            catch (err) {
+                reject(err);
+            }
+        });
+    });
+}
+function writeJson(res, status, body) {
+    const json = JSON.stringify(body);
+    res.writeHead(status, {
+        'content-type': 'application/json; charset=utf-8',
+        'content-length': Buffer.byteLength(json),
+    });
+    res.end(json);
+}
+function isObject(x) {
+    return typeof x === 'object' && x !== null && !Array.isArray(x);
+}
+//# sourceMappingURL=server.js.map

package/dist/lib/mock-server/creative-template/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../../src/lib/mock-server/creative-template/server.ts"],"names":[],"mappings":"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"}

package/dist/lib/mock-server/index.d.ts

@@ -0,0 +1,64 @@
+export interface MockServerOptions {
+    specialism: string;
+    port: number;
+    apiKey?: string;
+}
+/**
+ * How an adapter authenticates with the upstream mock. Specialism mocks
+ * advertise one of these so the matrix harness can build the right
+ * adapter-prompt section.
+ */
+export type MockServerAuth = {
+    kind: 'static_bearer';
+    /** Bearer token attached on every API call. */
+    apiKey: string;
+} | {
+    kind: 'oauth_client_credentials';
+    /** OAuth `client_id` for the `client_credentials` grant. */
+    clientId: string;
+    /** OAuth `client_secret` paired with `clientId`. */
+    clientSecret: string;
+    /** Path to the OAuth token endpoint relative to the mock URL,
+     * e.g. `/oauth/token`. Adapters POST `grant_type=client_credentials`
+     * with the client_id/secret to receive an access_token, then attach
+     * it as Bearer on subsequent API calls. Token expires after
+     * `expires_in` seconds (mock returns this in the token response);
+     * adapters refresh via the same endpoint with `grant_type=refresh_token`. */
+    tokenPath: string;
+};
+export interface MockServerHandle {
+    url: string;
+    /** Auth shape this mock requires. The matrix harness branches on
+     * `auth.kind` when building the adapter prompt — different shapes
+     * produce different adapter-side wiring. */
+    auth: MockServerAuth;
+    close: () => Promise<void>;
+    /** Adopter-friendly summary for boot-log printing. */
+    summary: () => string;
+    /** Specialism-agnostic principal-mapping table the matrix harness inlines
+     * into the build prompt so Claude can wire AdCP-side identity to upstream
+     * tenant/workspace ids without re-deriving them per specialism. */
+    principalMapping: PrincipalMappingEntry[];
+    /** Human-prose description of how the upstream gates per-tenant scope —
+     * e.g. "via X-Operator-Id header" or "via path /v3/workspaces/{id}/...".
+     * Surfaces in the harness prompt to make the auth-translation requirement
+     * explicit. */
+    principalScope: string;
+}
+export interface PrincipalMappingEntry {
+    adcpField: string;
+    adcpValue: string;
+    upstreamField: string;
+    upstreamValue: string;
+}
+/**
+ * Boot a mock upstream platform for the given specialism. Returns a handle
+ * the caller (CLI or matrix harness) uses to read connection details and
+ * shut down cleanly.
+ *
+ * Adding a new specialism means adding the upstream-shape OpenAPI + seed
+ * data + boot function under `src/lib/mock-server/<specialism>/` and a
+ * switch case here.
+ */
+export declare function bootMockServer(options: MockServerOptions): Promise<MockServerHandle>;
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/mock-server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/mock-server/index.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,GACtB;IACE,IAAI,EAAE,eAAe,CAAC;IACtB,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;CAChB,GACD;IACE,IAAI,EAAE,0BAA0B,CAAC;IACjC,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,YAAY,EAAE,MAAM,CAAC;IACrB;;;;;iFAK6E;IAC7E,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEN,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ;;gDAE4C;IAC5C,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,sDAAsD;IACtD,OAAO,EAAE,MAAM,MAAM,CAAC;IACtB;;uEAEmE;IACnE,gBAAgB,EAAE,qBAAqB,EAAE,CAAC;IAC1C;;;mBAGe;IACf,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA0F1F"}