@adcp/sdk 5.25.1 → 6.0.0

package/dist/lib/server/decisioning/specialisms/signals.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * SignalsPlatform — signal-marketplace + signal-owned specialism interface
+ * (v6.0).
+ *
+ * Two specialisms share the same platform interface:
+ *
+ *   - **`signal-marketplace`** — third-party data brokers serving curated
+ *     audience signals (LiveRamp, Oracle Data Cloud, third-party DMPs)
+ *   - **`signal-owned`** — first-party data providers serving their own
+ *     signals (publisher first-party data, retailer customer-graph)
+ *
+ * Both expose the same surface: `getSignals` for catalog discovery and
+ * `activateSignal` for provisioning a signal onto a destination platform.
+ *
+ * Async story: `activate_signal` is sync at the wire level — its response
+ * union has no `Submitted` arm. Long-running activation pipelines (identity-
+ * graph match: 5-30 min, destination provisioning: hours) return the wire
+ * `ActivateSignalSuccess` immediately with deployments in `pending` state,
+ * then emit `publishStatusChange({ resource_type: 'signal', ... })` events
+ * as each deployment reaches `activating` / `deployed` / `failed`.
+ *
+ * Status: Preview / 6.0.
+ *
+ * @public
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=signals.js.map

package/dist/lib/server/decisioning/specialisms/signals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signals.js","sourceRoot":"","sources":["../../../../../src/lib/server/decisioning/specialisms/signals.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG"}

package/dist/lib/server/decisioning/start-time.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Resolve a wire `start_time` into a concrete `Date`, with platform-aware
+ * ASAP semantics.
+ *
+ * The wire shape is `string | undefined` where the string is either an
+ * ISO 8601 timestamp OR the literal `'asap'`. Every platform method that
+ * touches `start_time` has to:
+ *   1. Handle the union (and the undefined case)
+ *   2. Validate that an ISO timestamp parses + isn't in the past
+ *   3. Interpret `'asap'` as a sensible date for THIS platform
+ *
+ * Step 3 is platform-specific. For programmatic sellers, ASAP means
+ * `now()`. For guaranteed/broadcast sellers with a 1-3 day trafficker
+ * approval pipeline, ASAP means `now() + approval lead time` because the
+ * buy can't physically start before the operator signs off. This helper
+ * takes a config object so each adopter injects their own semantics
+ * consistently across `createMediaBuy(Task)` and `updateMediaBuy`.
+ *
+ * @example Programmatic seller (no approval)
+ * ```ts
+ * const startAt = resolveStartTime(req.start_time, {});
+ * // 'asap' → now()
+ * // '2026-05-01T00:00:00Z' → that date
+ * // undefined → now()
+ * ```
+ *
+ * @example Broadcast seller with 2-day IO sign-off + 1-day default lead
+ * ```ts
+ * const startAt = resolveStartTime(req.start_time, {
+ *   asapLeadTimeMs: 2 * 86_400_000,
+ *   defaultLeadTimeMs: 86_400_000,
+ *   notBefore: new Date(),
+ * });
+ * // 'asap' → now() + 2 days
+ * // past date → throws AdcpError(INVALID_REQUEST)
+ * // undefined → now() + 1 day
+ * ```
+ *
+ * @public
+ */
+export interface ResolveStartTimeOptions {
+    /**
+     * When `start_time` is the literal `'asap'`, return `now() + this`.
+     * Models the platform's approval / trafficking pipeline that runs
+     * before a buy can actually start. Default `0` (interpret asap as
+     * truly now, suitable for programmatic platforms).
+     */
+    asapLeadTimeMs?: number;
+    /**
+     * When `start_time` is `undefined`, return `now() + this`. Lets adopters
+     * pick whether "no start_time specified" means "asap" (use the same
+     * lead time) or some other default. Defaults to the value of
+     * `asapLeadTimeMs`.
+     */
+    defaultLeadTimeMs?: number;
+    /**
+     * Reject parsed timestamps strictly before this. Most adopters pass
+     * `new Date()` to forbid past start times. Omit to skip the check.
+     */
+    notBefore?: Date;
+    /**
+     * Override the field name on the error message when validation throws.
+     * Defaults to `'start_time'`. Set to `'patch.start_time'` (or similar)
+     * when calling from `updateMediaBuy`.
+     */
+    fieldName?: string;
+}
+/**
+ * Normalize the wire `start_time` value into a guaranteed-non-null Date.
+ *
+ * Throws `AdcpError('INVALID_REQUEST')` when the string isn't a parseable
+ * ISO 8601 timestamp OR when the parsed date is before `opts.notBefore`.
+ * Returns `now() + lead time` for `'asap'` and `undefined` inputs.
+ */
+export declare function resolveStartTime(raw: string | undefined, opts?: ResolveStartTimeOptions): Date;
+//# sourceMappingURL=start-time.d.ts.map

package/dist/lib/server/decisioning/start-time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-time.d.ts","sourceRoot":"","sources":["../../../../src/lib/server/decisioning/start-time.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAIH,MAAM,WAAW,uBAAuB;IACtC;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,GAAE,uBAA4B,GAAG,IAAI,CAgClG"}

package/dist/lib/server/decisioning/start-time.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * Resolve a wire `start_time` into a concrete `Date`, with platform-aware
+ * ASAP semantics.
+ *
+ * The wire shape is `string | undefined` where the string is either an
+ * ISO 8601 timestamp OR the literal `'asap'`. Every platform method that
+ * touches `start_time` has to:
+ *   1. Handle the union (and the undefined case)
+ *   2. Validate that an ISO timestamp parses + isn't in the past
+ *   3. Interpret `'asap'` as a sensible date for THIS platform
+ *
+ * Step 3 is platform-specific. For programmatic sellers, ASAP means
+ * `now()`. For guaranteed/broadcast sellers with a 1-3 day trafficker
+ * approval pipeline, ASAP means `now() + approval lead time` because the
+ * buy can't physically start before the operator signs off. This helper
+ * takes a config object so each adopter injects their own semantics
+ * consistently across `createMediaBuy(Task)` and `updateMediaBuy`.
+ *
+ * @example Programmatic seller (no approval)
+ * ```ts
+ * const startAt = resolveStartTime(req.start_time, {});
+ * // 'asap' → now()
+ * // '2026-05-01T00:00:00Z' → that date
+ * // undefined → now()
+ * ```
+ *
+ * @example Broadcast seller with 2-day IO sign-off + 1-day default lead
+ * ```ts
+ * const startAt = resolveStartTime(req.start_time, {
+ *   asapLeadTimeMs: 2 * 86_400_000,
+ *   defaultLeadTimeMs: 86_400_000,
+ *   notBefore: new Date(),
+ * });
+ * // 'asap' → now() + 2 days
+ * // past date → throws AdcpError(INVALID_REQUEST)
+ * // undefined → now() + 1 day
+ * ```
+ *
+ * @public
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveStartTime = resolveStartTime;
+const async_outcome_1 = require("./async-outcome");
+/**
+ * Normalize the wire `start_time` value into a guaranteed-non-null Date.
+ *
+ * Throws `AdcpError('INVALID_REQUEST')` when the string isn't a parseable
+ * ISO 8601 timestamp OR when the parsed date is before `opts.notBefore`.
+ * Returns `now() + lead time` for `'asap'` and `undefined` inputs.
+ */
+function resolveStartTime(raw, opts = {}) {
+    const asapLead = opts.asapLeadTimeMs ?? 0;
+    const defaultLead = opts.defaultLeadTimeMs ?? asapLead;
+    const fieldName = opts.fieldName ?? 'start_time';
+    if (raw === undefined) {
+        return new Date(Date.now() + defaultLead);
+    }
+    if (raw === 'asap') {
+        return new Date(Date.now() + asapLead);
+    }
+    const parsed = new Date(raw);
+    if (isNaN(parsed.getTime())) {
+        throw new async_outcome_1.AdcpError('INVALID_REQUEST', {
+            recovery: 'correctable',
+            message: `${fieldName} is not a valid ISO 8601 timestamp: '${raw}'`,
+            field: fieldName,
+            suggestion: "Use 'asap' or an ISO 8601 timestamp (e.g., '2026-05-01T00:00:00Z')",
+        });
+    }
+    if (opts.notBefore && parsed.getTime() < opts.notBefore.getTime()) {
+        throw new async_outcome_1.AdcpError('INVALID_REQUEST', {
+            recovery: 'correctable',
+            message: `${fieldName} is in the past: ${parsed.toISOString()} (cutoff ${opts.notBefore.toISOString()})`,
+            field: fieldName,
+            suggestion: 'Use a future timestamp or `asap`',
+        });
+    }
+    return parsed;
+}
+//# sourceMappingURL=start-time.js.map

package/dist/lib/server/decisioning/start-time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-time.js","sourceRoot":"","sources":["../../../../src/lib/server/decisioning/start-time.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;;AAuCH,4CAgCC;AArED,mDAA4C;AA8B5C;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAAC,GAAuB,EAAE,OAAgC,EAAE;IAC1F,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,IAAI,CAAC,CAAC;IAC1C,MAAM,WAAW,GAAG,IAAI,CAAC,iBAAiB,IAAI,QAAQ,CAAC;IACvD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,YAAY,CAAC;IAEjD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,CAAC,CAAC;IAC5C,CAAC;IACD,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;QACnB,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,yBAAS,CAAC,iBAAiB,EAAE;YACrC,QAAQ,EAAE,aAAa;YACvB,OAAO,EAAE,GAAG,SAAS,wCAAwC,GAAG,GAAG;YACnE,KAAK,EAAE,SAAS;YAChB,UAAU,EAAE,oEAAoE;SACjF,CAAC,CAAC;IACL,CAAC;IAED,IAAI,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC;QAClE,MAAM,IAAI,yBAAS,CAAC,iBAAiB,EAAE;YACrC,QAAQ,EAAE,aAAa;YACvB,OAAO,EAAE,GAAG,SAAS,oBAAoB,MAAM,CAAC,WAAW,EAAE,YAAY,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,GAAG;YACxG,KAAK,EAAE,SAAS;YAChB,UAAU,EAAE,kCAAkC;SAC/C,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/lib/server/decisioning/status-changes.d.ts

@@ -0,0 +1,165 @@
+/**
+ * Status-change event bus for the v6.0 decisioning runtime.
+ *
+ * Adopters call `publishStatusChange(...)` from anywhere — webhook handler,
+ * cron, in-process worker, the body of a `*Task` method — to push lifecycle
+ * updates on a resource the framework knows about. The framework records
+ * the change against the resource and projects it to subscribed buyers via
+ * the MCP Resources subscription extension (`notifications/resources/updated`)
+ * and the equivalent A2A DataPart-typed message contract.
+ *
+ * Ten resource types are wired in v6.0 (matches AdCP 3.0 lifecycle
+ * channels):
+ *
+ *   - `media_buy`      — pending → active → completed; paused, canceled
+ *   - `creative`       — pending_review → approved/rejected
+ *   - `audience`       — matching → matched → activating → active
+ *   - `signal`         — pending → activated → expired
+ *   - `proposal`       — issued → accepted/expired/withdrawn
+ *   - `plan`           — draft → submitted → approved/rejected
+ *   - `rights_grant`   — pending → granted/denied/expired
+ *   - `delivery_report`— staging → published (manual report-runs)
+ *   - `property_list`  — list-changed events (cache invalidation, fetch_token revoke)
+ *   - `collection_list`— list-changed events (cache invalidation, fetch_token revoke)
+ *
+ * The bus is module-level so adopters can call `publishStatusChange(...)`
+ * without holding a reference to the server. The framework wires the bus
+ * into the server's resource registry at construction; in tests, the
+ * registry can be swapped via `setStatusChangeBus(...)`.
+ *
+ * Status: Preview / 6.0. Wire-level MCP Resources subscription handlers
+ * and the A2A backport land in a subsequent commit; this file ships the
+ * adopter-facing primitive and an in-memory subscriber model the runtime
+ * can consume.
+ *
+ * @public
+ */
+/**
+ * Resource categories whose lifecycle changes can be published on the
+ * status-change bus and projected to subscribed buyers.
+ *
+ * **Spec status (v6.0):** The AdCP spec doesn't yet ship a closed enum
+ * for `resource_type`. The values below are the v6 SDK's working set —
+ * the resource categories adopters publish lifecycle events against
+ * today. They become wire-visible via the URI scheme
+ * `adcp://{account_id}/{resource_type}/{resource_id}` projected to MCP
+ * Resources subscriptions.
+ *
+ * Filed upstream as adcontextprotocol/adcp#3412 proposing a normative
+ * `enums/status-change-resource-type.json`. When the spec lands the
+ * enum, this type becomes a `$ref` to the generated schema. Until then
+ * adopters subscribing across multiple AdCP agents may see drift; the
+ * SDK's set is the working canonical until the spec consolidates.
+ *
+ * Adopters publishing custom resource types not in this list should
+ * prefix with `x-` (e.g., `'x-pcim_session'`) to reduce collision risk
+ * with the eventual normative enum. The framework accepts any string
+ * (the type is widened with `(string & {})` for forward-compat) but
+ * only the values listed here have stable cross-SDK semantics.
+ */
+export type StatusChangeResourceType = 'media_buy' | 'creative' | 'audience' | 'signal' | 'proposal' | 'plan' | 'rights_grant' | 'delivery_report' | 'property_list' | 'collection_list' | (string & {});
+/**
+ * A single status-change event.
+ *
+ * `account_id` scopes the event to a tenant; subscribers receive only
+ * events for their resolved account. `resource_uri` follows the MCP
+ * Resources URI scheme: `adcp://{account_id}/{resource_type}/{resource_id}`.
+ */
+export interface StatusChange<TPayload = unknown> {
+    account_id: string;
+    resource_type: StatusChangeResourceType;
+    resource_id: string;
+    /** Canonical MCP Resources URI for this resource. */
+    resource_uri: string;
+    /** ISO 8601 timestamp the change was observed. */
+    at: string;
+    /**
+     * Resource-type-specific change payload. Shape is the wire fragment the
+     * subscribed buyer will see — e.g., for `media_buy` it's the AdCP
+     * `media_buy_status_changes` message body.
+     */
+    payload: TPayload;
+    /**
+     * Correlation id linking this change back to the buyer request that
+     * caused it. Useful for "show me everything that happened from this
+     * `create_media_buy` call" observability across HITL flows. Adopters
+     * pass through `ctx.task.id` (for `*Task`-driven changes) or any
+     * stable request identifier they generate at dispatch time.
+     *
+     * Optional — many status changes originate from cron / webhook /
+     * upstream-platform events that have no buyer-request correlation.
+     */
+    caused_by_request_id?: string;
+    /**
+     * Status the resource was transitioning FROM. Lets subscribers assert
+     * legal transitions (`from: 'matching' → to: 'active'` is fine;
+     * `from: 'failed' → to: 'matching'` is a state-machine bug). The
+     * framework doesn't validate transitions in v6.0 (no per-resource
+     * state machine yet); the field is captured and projected to the
+     * wire so downstream consumers can.
+     */
+    previous_status?: string;
+}
+export interface PublishStatusChangeOpts<TPayload = unknown> {
+    account_id: string;
+    resource_type: StatusChangeResourceType;
+    resource_id: string;
+    payload: TPayload;
+    /** Override the timestamp (defaults to now). Useful for replay/backfill. */
+    at?: string;
+    /**
+     * Correlation id linking this change to the buyer request that caused
+     * it. Inside `*Task` method bodies, pass `ctx.task.id` to thread the
+     * task lifecycle. Outside HITL flows, pass any stable request id you
+     * derive at dispatch time. Optional.
+     */
+    caused_by_request_id?: string;
+    /** Status the resource was transitioning FROM. Optional. */
+    previous_status?: string;
+}
+export type StatusChangeListener = (event: StatusChange) => void | Promise<void>;
+export interface StatusChangeBus {
+    publish<TPayload>(opts: PublishStatusChangeOpts<TPayload>): void;
+    /**
+     * Subscribe a listener. Returns an unsubscribe function. Listeners are
+     * fire-and-forget; rejected promises are caught and logged so one bad
+     * subscriber doesn't break delivery to others.
+     */
+    subscribe(listener: StatusChangeListener): () => void;
+    /** Snapshot the most-recent N events (in-memory cache for `tasks/get` + replay). */
+    recent(limit?: number): readonly StatusChange[];
+}
+export declare function createInMemoryStatusChangeBus(opts?: {
+    recentLimit?: number;
+}): StatusChangeBus;
+/**
+ * Push a status change for a resource. Adopters call this from anywhere —
+ * webhook handler, cron, in-process worker — to surface lifecycle changes
+ * the framework projects to subscribed buyers.
+ *
+ * ```ts
+ * // After GAM webhook reports order activation:
+ * publishStatusChange({
+ *   account_id: account.id,
+ *   resource_type: 'media_buy',
+ *   resource_id: gamOrderToBuyId(order),
+ *   payload: { status: 'active', activated_at: order.startTime },
+ * });
+ * ```
+ *
+ * Buyers subscribed via MCP `resources/subscribe` (or the A2A equivalent)
+ * receive the change as a `notifications/resources/updated` notification
+ * carrying the `payload` as the resource's wire fragment.
+ */
+export declare function publishStatusChange<TPayload>(opts: PublishStatusChangeOpts<TPayload>): void;
+/**
+ * Replace the active bus. The framework calls this at server construction
+ * to wire its own bus implementation; tests can call it to swap in a fake.
+ *
+ * Returns the previous bus so the caller can restore it (e.g., in a test
+ * teardown).
+ */
+export declare function setStatusChangeBus(bus: StatusChangeBus): StatusChangeBus;
+/** Read the active bus (for the framework to wire subscribers). */
+export declare function getStatusChangeBus(): StatusChangeBus;
+//# sourceMappingURL=status-changes.d.ts.map

package/dist/lib/server/decisioning/status-changes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-changes.d.ts","sourceRoot":"","sources":["../../../../src/lib/server/decisioning/status-changes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,wBAAwB,GAChC,WAAW,GACX,UAAU,GACV,UAAU,GACV,QAAQ,GACR,UAAU,GACV,MAAM,GACN,cAAc,GACd,iBAAiB,GACjB,eAAe,GACf,iBAAiB,GAEjB,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAElB;;;;;;GAMG;AACH,MAAM,WAAW,YAAY,CAAC,QAAQ,GAAG,OAAO;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,wBAAwB,CAAC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,EAAE,EAAE,MAAM,CAAC;IACX;;;;OAIG;IACH,OAAO,EAAE,QAAQ,CAAC;IAClB;;;;;;;;;OASG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,uBAAuB,CAAC,QAAQ,GAAG,OAAO;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,wBAAwB,CAAC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,QAAQ,CAAC;IAClB,4EAA4E;IAC5E,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,4DAA4D;IAC5D,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEjF,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,uBAAuB,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IACjE;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI,CAAC;IACtD,oFAAoF;IACpF,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,YAAY,EAAE,CAAC;CACjD;AAID,wBAAgB,6BAA6B,CAAC,IAAI,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,CA8C9F;AAQD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,IAAI,EAAE,uBAAuB,CAAC,QAAQ,CAAC,GAAG,IAAI,CAE3F;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,eAAe,GAAG,eAAe,CAIxE;AAED,mEAAmE;AACnE,wBAAgB,kBAAkB,IAAI,eAAe,CAEpD"}

package/dist/lib/server/decisioning/status-changes.js

@@ -0,0 +1,131 @@
+"use strict";
+/**
+ * Status-change event bus for the v6.0 decisioning runtime.
+ *
+ * Adopters call `publishStatusChange(...)` from anywhere — webhook handler,
+ * cron, in-process worker, the body of a `*Task` method — to push lifecycle
+ * updates on a resource the framework knows about. The framework records
+ * the change against the resource and projects it to subscribed buyers via
+ * the MCP Resources subscription extension (`notifications/resources/updated`)
+ * and the equivalent A2A DataPart-typed message contract.
+ *
+ * Ten resource types are wired in v6.0 (matches AdCP 3.0 lifecycle
+ * channels):
+ *
+ *   - `media_buy`      — pending → active → completed; paused, canceled
+ *   - `creative`       — pending_review → approved/rejected
+ *   - `audience`       — matching → matched → activating → active
+ *   - `signal`         — pending → activated → expired
+ *   - `proposal`       — issued → accepted/expired/withdrawn
+ *   - `plan`           — draft → submitted → approved/rejected
+ *   - `rights_grant`   — pending → granted/denied/expired
+ *   - `delivery_report`— staging → published (manual report-runs)
+ *   - `property_list`  — list-changed events (cache invalidation, fetch_token revoke)
+ *   - `collection_list`— list-changed events (cache invalidation, fetch_token revoke)
+ *
+ * The bus is module-level so adopters can call `publishStatusChange(...)`
+ * without holding a reference to the server. The framework wires the bus
+ * into the server's resource registry at construction; in tests, the
+ * registry can be swapped via `setStatusChangeBus(...)`.
+ *
+ * Status: Preview / 6.0. Wire-level MCP Resources subscription handlers
+ * and the A2A backport land in a subsequent commit; this file ships the
+ * adopter-facing primitive and an in-memory subscriber model the runtime
+ * can consume.
+ *
+ * @public
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createInMemoryStatusChangeBus = createInMemoryStatusChangeBus;
+exports.publishStatusChange = publishStatusChange;
+exports.setStatusChangeBus = setStatusChangeBus;
+exports.getStatusChangeBus = getStatusChangeBus;
+const DEFAULT_RECENT_LIMIT = 1000;
+function createInMemoryStatusChangeBus(opts) {
+    const listeners = new Set();
+    const recent = [];
+    const recentLimit = opts?.recentLimit ?? DEFAULT_RECENT_LIMIT;
+    return {
+        publish(eventOpts) {
+            const event = {
+                account_id: eventOpts.account_id,
+                resource_type: eventOpts.resource_type,
+                resource_id: eventOpts.resource_id,
+                resource_uri: `adcp://${eventOpts.account_id}/${eventOpts.resource_type}/${eventOpts.resource_id}`,
+                at: eventOpts.at ?? new Date().toISOString(),
+                payload: eventOpts.payload,
+                ...(eventOpts.caused_by_request_id !== undefined && { caused_by_request_id: eventOpts.caused_by_request_id }),
+                ...(eventOpts.previous_status !== undefined && { previous_status: eventOpts.previous_status }),
+            };
+            recent.push(event);
+            if (recent.length > recentLimit)
+                recent.shift();
+            for (const listener of listeners) {
+                try {
+                    const result = listener(event);
+                    if (result && typeof result.catch === 'function') {
+                        result.catch((err) => {
+                            // eslint-disable-next-line no-console
+                            console.warn('[adcp] status-change listener rejected:', err);
+                        });
+                    }
+                }
+                catch (err) {
+                    // eslint-disable-next-line no-console
+                    console.warn('[adcp] status-change listener threw:', err);
+                }
+            }
+        },
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => listeners.delete(listener);
+        },
+        recent(limit) {
+            const n = limit ?? recent.length;
+            return recent.slice(-n);
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Module-level adopter-facing primitive
+// ---------------------------------------------------------------------------
+let activeBus = createInMemoryStatusChangeBus();
+/**
+ * Push a status change for a resource. Adopters call this from anywhere —
+ * webhook handler, cron, in-process worker — to surface lifecycle changes
+ * the framework projects to subscribed buyers.
+ *
+ * ```ts
+ * // After GAM webhook reports order activation:
+ * publishStatusChange({
+ *   account_id: account.id,
+ *   resource_type: 'media_buy',
+ *   resource_id: gamOrderToBuyId(order),
+ *   payload: { status: 'active', activated_at: order.startTime },
+ * });
+ * ```
+ *
+ * Buyers subscribed via MCP `resources/subscribe` (or the A2A equivalent)
+ * receive the change as a `notifications/resources/updated` notification
+ * carrying the `payload` as the resource's wire fragment.
+ */
+function publishStatusChange(opts) {
+    activeBus.publish(opts);
+}
+/**
+ * Replace the active bus. The framework calls this at server construction
+ * to wire its own bus implementation; tests can call it to swap in a fake.
+ *
+ * Returns the previous bus so the caller can restore it (e.g., in a test
+ * teardown).
+ */
+function setStatusChangeBus(bus) {
+    const prev = activeBus;
+    activeBus = bus;
+    return prev;
+}
+/** Read the active bus (for the framework to wire subscribers). */
+function getStatusChangeBus() {
+    return activeBus;
+}
+//# sourceMappingURL=status-changes.js.map

package/dist/lib/server/decisioning/status-changes.js.map

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

package/dist/lib/server/decisioning/status-mappers.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Native status mapping. Real ad systems have their own status models
+ * (GAM uses DRAFT/APPROVED/etc.; Spotify uses PENDING/ACTIVE; LiveRamp
+ * uses INGESTING/MATCHED/ACTIVATED). The platform implements one mapper
+ * per AdCP-typed status; framework calls them where wire responses need
+ * the AdCP-typed value.
+ *
+ * **Scope**: each mapper is a wire-status decoder for a single native
+ * status string. Rollup logic — taking N native statuses across multiple
+ * objects (GAM Order + LineItems, Criteo campaign + line items + creatives)
+ * and computing one AdCP-typed status — is platform-specific and lives in
+ * adapter code, NOT here. The mapper answers "what does GAM's `READY` mean
+ * in AdCP terms?"; the adapter answers "if any LineItem is `DISAPPROVED`,
+ * the buy is `rejected`; if all are `DELIVERING`, the buy is `active`".
+ *
+ * Status: Preview / 6.0.
+ *
+ * @public
+ */
+import type { AdcpAccountStatus } from './account';
+/**
+ * One method per AdCP-typed status. All optional — platforms only map the
+ * statuses their AdCP-claimed specialisms expose.
+ */
+export interface StatusMappers {
+    account?(native: string): AdcpAccountStatus;
+    mediaBuy?(native: string): AdcpMediaBuyStatus;
+    creative?(native: string): AdcpCreativeStatus;
+    plan?(native: string): AdcpPlanStatus;
+}
+export type AdcpMediaBuyStatus = 'pending_creatives' | 'pending_start' | 'active' | 'paused' | 'completed' | 'rejected' | 'canceled';
+export type AdcpCreativeStatus = 'pending_review' | 'approved' | 'rejected' | 'archived';
+export type AdcpPlanStatus = 'active' | 'exhausted' | 'expired' | 'paused';
+/**
+ * Identity mappers — when the platform's native status strings already match
+ * AdCP's typed enums (most modern platforms do for `active` / `paused`),
+ * adopters use this instead of writing the obvious passthrough functions.
+ *
+ * Falls back to the AdCP default for unknown native values:
+ *   - mediaBuy: `'pending_creatives'`
+ *   - creative: `'pending_review'`
+ *   - account:  `'active'`
+ *   - plan:     `'active'`
+ */
+export declare const identityStatusMappers: StatusMappers;
+//# sourceMappingURL=status-mappers.d.ts.map

package/dist/lib/server/decisioning/status-mappers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-mappers.d.ts","sourceRoot":"","sources":["../../../../src/lib/server/decisioning/status-mappers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEnD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAAC;IAC5C,QAAQ,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,CAAC;IAC9C,QAAQ,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,CAAC;IAC9C,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAAC;CACvC;AAED,MAAM,MAAM,kBAAkB,GAC1B,mBAAmB,GACnB,eAAe,GACf,QAAQ,GACR,QAAQ,GACR,WAAW,GACX,UAAU,GACV,UAAU,CAAC;AAEf,MAAM,MAAM,kBAAkB,GAAG,gBAAgB,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC;AAEzF,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE3E;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB,EAAE,aAcnC,CAAC"}

package/dist/lib/server/decisioning/status-mappers.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * Native status mapping. Real ad systems have their own status models
+ * (GAM uses DRAFT/APPROVED/etc.; Spotify uses PENDING/ACTIVE; LiveRamp
+ * uses INGESTING/MATCHED/ACTIVATED). The platform implements one mapper
+ * per AdCP-typed status; framework calls them where wire responses need
+ * the AdCP-typed value.
+ *
+ * **Scope**: each mapper is a wire-status decoder for a single native
+ * status string. Rollup logic — taking N native statuses across multiple
+ * objects (GAM Order + LineItems, Criteo campaign + line items + creatives)
+ * and computing one AdCP-typed status — is platform-specific and lives in
+ * adapter code, NOT here. The mapper answers "what does GAM's `READY` mean
+ * in AdCP terms?"; the adapter answers "if any LineItem is `DISAPPROVED`,
+ * the buy is `rejected`; if all are `DELIVERING`, the buy is `active`".
+ *
+ * Status: Preview / 6.0.
+ *
+ * @public
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.identityStatusMappers = void 0;
+/**
+ * Identity mappers — when the platform's native status strings already match
+ * AdCP's typed enums (most modern platforms do for `active` / `paused`),
+ * adopters use this instead of writing the obvious passthrough functions.
+ *
+ * Falls back to the AdCP default for unknown native values:
+ *   - mediaBuy: `'pending_creatives'`
+ *   - creative: `'pending_review'`
+ *   - account:  `'active'`
+ *   - plan:     `'active'`
+ */
+exports.identityStatusMappers = {
+    mediaBuy: native => (['pending_creatives', 'pending_start', 'active', 'paused', 'completed', 'rejected', 'canceled'].includes(native)
+        ? native
+        : 'pending_creatives'),
+    creative: native => (['pending_review', 'approved', 'rejected', 'archived'].includes(native)
+        ? native
+        : 'pending_review'),
+    account: native => (['active', 'pending_approval', 'rejected', 'payment_required', 'suspended', 'closed'].includes(native)
+        ? native
+        : 'active'),
+    plan: native => (['active', 'exhausted', 'expired', 'paused'].includes(native) ? native : 'active'),
+};
+//# sourceMappingURL=status-mappers.js.map

package/dist/lib/server/decisioning/status-mappers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-mappers.js","sourceRoot":"","sources":["../../../../src/lib/server/decisioning/status-mappers.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;AA4BH;;;;;;;;;;GAUG;AACU,QAAA,qBAAqB,GAAkB;IAClD,QAAQ,EAAE,MAAM,CAAC,EAAE,CACjB,CAAC,CAAC,mBAAmB,EAAE,eAAe,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC/G,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,mBAAmB,CAAuB;IAChD,QAAQ,EAAE,MAAM,CAAC,EAAE,CACjB,CAAC,CAAC,gBAAgB,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;QACtE,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,gBAAgB,CAAuB;IAC7C,OAAO,EAAE,MAAM,CAAC,EAAE,CAChB,CAAC,CAAC,QAAQ,EAAE,kBAAkB,EAAE,UAAU,EAAE,kBAAkB,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;QACrG,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,QAAQ,CAAsB;IACpC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAmB;CACtH,CAAC"}