@adcp/sdk 15.9.0 → 16.0.0-beta.1

package/dist/lib/identity-3.3/types.d.ts

@@ -0,0 +1,127 @@
+/** Experimental drafts; the released SDK wire/schema pin remains 3.2.4. */
+export type AgentOnboardingMode = 'open' | 'application' | 'invite_only';
+export type BillingParty = 'operator' | 'agent' | 'advertiser';
+export type AgentOnboardingRequirementKind = 'agent_identity' | 'grant' | 'billing_entity' | 'contract' | 'credit_application' | 'aao_verified' | 'storyboard' | 'sandbox' | 'experimental_feature';
+export interface AgentOnboardingRequirement {
+    kind: AgentOnboardingRequirementKind | (string & {});
+    role?: string;
+    verification_modes?: string[];
+    specialisms?: string[];
+    adcp_version?: string;
+    id?: string;
+    ext?: Record<string, unknown>;
+}
+export interface AgentOnboardingTier {
+    mode: AgentOnboardingMode;
+    url?: string;
+    requirements?: AgentOnboardingRequirement[];
+    ext?: Record<string, unknown>;
+}
+export interface AgentOnboarding {
+    sandbox?: AgentOnboardingTier;
+    billing?: Partial<Record<BillingParty, AgentOnboardingTier>>;
+    url?: string;
+    documentation_url?: string;
+    message?: string;
+    ext?: Record<string, unknown>;
+}
+export interface BuyerOnboardingPosture {
+    mode: 'considers_unsolicited' | 'application' | 'invite_only';
+    requirements?: AgentOnboardingRequirement[];
+    url?: string;
+    documentation_url?: string;
+    message?: string;
+    ext?: Record<string, unknown>;
+}
+export interface PrincipalRelationship {
+    status: 'pending' | 'active' | 'suspended' | 'blocked';
+    expires_at?: string;
+    setup?: {
+        message: string;
+        url?: string;
+        expires_at?: string;
+        [key: string]: unknown;
+    };
+    ext?: Record<string, unknown>;
+}
+export type IdentityPrincipalChangedReason = 'relationship_changed' | 'relationship_expiring';
+export interface TrustAgent {
+    url: string;
+    roles: string[];
+    id?: string;
+    protocols?: string[];
+    countries?: string[];
+    profiles?: {
+        adcp?: {
+            onboarding?: BuyerOnboardingPosture;
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+export interface TrustGrant {
+    grantee: string;
+    scopes: string[];
+    agents?: {
+        url: string;
+    }[];
+    countries?: string[];
+    valid_from?: string;
+    valid_until?: string;
+    profiles?: {
+        adcp?: {
+            brands?: string[];
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+export interface TrustRecord {
+    agents?: TrustAgent[];
+    grants?: TrustGrant[];
+    acknowledgements?: unknown[];
+    exclusive_grants?: boolean;
+    authoritative_location?: string;
+    profiles?: {
+        adcp?: {
+            onboarding?: BuyerOnboardingPosture;
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+export type RevocationReason = 'unspecified' | 'keyCompromise' | 'cACompromise' | 'affiliationChanged' | 'superseded' | 'cessationOfOperation' | 'certificateHold' | 'removeFromCRL' | 'privilegeWithdrawn' | 'aACompromise';
+export interface RevocationDetail {
+    reason?: RevocationReason;
+    invalidity_date?: string;
+}
+export interface AgentGrantDeniedDetails {
+    scope: 'agent';
+    reason: 'grant_absent';
+}
+export interface Identity33Capabilities {
+    request_signing?: {
+        profiles?: ('adcp/request-signing/v1' | 'web-bot-auth')[];
+        wba_draft_revision?: string;
+    };
+    webhook_signing?: {
+        supported: boolean;
+        profiles?: ('adcp/webhook-signing/v1' | 'web-bot-auth')[];
+        wba_draft_revision?: string;
+    };
+    account?: {
+        agent_onboarding?: AgentOnboarding;
+    };
+}
+export type Identity33GetPrincipalResponse = Omit<import('../types/tools.generated').GetPrincipalResponse, 'result'> & {
+    result: (Exclude<import('../types/tools.generated').GetPrincipalResponse['result'], {
+        kind: 'failed';
+    }> & {
+        relationship?: PrincipalRelationship;
+    }) | Extract<import('../types/tools.generated').GetPrincipalResponse['result'], {
+        kind: 'failed';
+    }>;
+};

package/dist/lib/identity-3.3/types.js

@@ -0,0 +1,16 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);

package/dist/lib/identity-3.3/validation.d.mts

@@ -0,0 +1,2 @@
+import type { ValidationOutcome } from '../validation/schema-validator.mjs';
+export declare function validateIdentity33Payload(tool: string, direction: 'request' | 'response', payload: unknown, version?: string): ValidationOutcome;

package/dist/lib/identity-3.3/validation.d.ts

@@ -0,0 +1,2 @@
+import type { ValidationOutcome } from '../validation/schema-validator';
+export declare function validateIdentity33Payload(tool: string, direction: 'request' | 'response', payload: unknown, version?: string): ValidationOutcome;

package/dist/lib/identity-3.3/validation.js

@@ -0,0 +1,125 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var validation_exports = {};
+__export(validation_exports, {
+  validateIdentity33Payload: () => validateIdentity33Payload
+});
+module.exports = __toCommonJS(validation_exports);
+var import_ajv = __toESM(require("ajv"));
+var import_ajv_formats = __toESM(require("ajv-formats"));
+var import_schema_loader = require('../validation/schema-loader.js');
+var import_schemas = __toESM(require('./schemas.draft.js'));
+const validators = /* @__PURE__ */ new WeakMap();
+function validateIdentity33Payload(tool, direction, payload, version) {
+  const key = JSON.stringify([tool, direction, version]);
+  const stable = (0, import_schema_loader.getValidator)(tool, direction === "request" ? "request" : "sync", version);
+  if (!stable) return { valid: true, issues: [], variant: "skipped" };
+  let cache = validators.get(stable);
+  if (!cache) {
+    cache = /* @__PURE__ */ new Map();
+    validators.set(stable, cache);
+  }
+  let validator = cache.get(key);
+  if (!validator) {
+    let walk2 = function(node, name = "") {
+      if (!node || typeof node !== "object") return;
+      if (Array.isArray(node)) {
+        node.forEach((item) => walk2(item, name));
+        return;
+      }
+      const object = node;
+      if ((name === "reporting_webhook" || name === "artifact_webhook" || /Reporting Webhook|Artifact Webhook/i.test(object.title ?? "")) && Array.isArray(object.required))
+        object.required = object.required.filter((field) => field !== "authentication");
+      if (name === "reason" && Array.isArray(object.enum) && object.enum.includes("destination_state_changed"))
+        object.enum = [...object.enum, "relationship_changed", "relationship_expiring"];
+      if (object.properties?.url && object.properties?.authentication)
+        object.properties.signing_profile = { type: "string", enum: ["adcp/webhook-signing/v1", "web-bot-auth"] };
+      if (tool === "get_principal" && direction === "response" && object.properties?.kind && ["current", "recognized", "unconfigured"].includes(object.properties.kind.const))
+        object.properties.relationship = { ...relationship, $id: void 0 };
+      if (tool === "get_adcp_capabilities" && object.properties?.supported_billing)
+        object.properties.agent_onboarding = { ...onboarding, $id: void 0 };
+      if (tool === "get_adcp_capabilities" && ["request_signing", "webhook_signing"].includes(name) && object.properties)
+        object.properties.profiles = {
+          type: "array",
+          items: {
+            type: "string",
+            enum: name === "request_signing" ? ["adcp/request-signing/v1", "web-bot-auth"] : ["adcp/webhook-signing/v1", "web-bot-auth"]
+          },
+          minItems: 1,
+          uniqueItems: true
+        };
+      if (tool === "get_adcp_capabilities" && ["request_signing", "webhook_signing"].includes(name) && object.properties)
+        object.properties.wba_draft_revision = { type: "string", minLength: 1 };
+      for (const [k, value] of Object.entries(object)) if (k !== "$id") walk2(value, k);
+    };
+    var walk = walk2;
+    const schema = structuredClone(stable.schema);
+    const relationship = import_schemas.default.find((s) => s.$id === "/schemas/core/principal-relationship.json");
+    const onboarding = import_schemas.default.find((s) => s.$id === "/schemas/core/agent-onboarding.json");
+    walk2(schema);
+    const ajv = new import_ajv.default({ strict: false, allErrors: true });
+    (0, import_ajv_formats.default)(ajv);
+    for (const draft of import_schemas.default) ajv.addSchema({ ...draft, $id: "https://adcontextprotocol.org" + draft.$id });
+    validator = ajv.compile(schema);
+    cache.set(key, validator);
+  }
+  let valid = validator(payload) === true;
+  if (valid && tool === "get_adcp_capabilities" && payload && typeof payload === "object") {
+    const body = payload;
+    const posture = body.account?.agent_onboarding;
+    if (posture && (!body.experimental_features?.includes("account.agent_onboarding") || posture.sandbox !== void 0 && body.account?.sandbox !== true || Object.keys(posture.billing ?? {}).some((k) => !body.account?.supported_billing?.includes(k))))
+      return {
+        valid: false,
+        variant: "sync",
+        issues: [
+          {
+            pointer: "/account/agent_onboarding",
+            keyword: "experimental",
+            schemaPath: "/identity33/agent_onboarding",
+            message: "Onboarding requires its feature declaration and supported account tiers"
+          }
+        ]
+      };
+  }
+  return {
+    valid,
+    variant: direction === "request" ? "request" : "sync",
+    issues: valid ? [] : (validator.errors ?? []).map((e) => ({
+      pointer: e.instancePath,
+      keyword: e.keyword,
+      message: e.message ?? "Invalid value",
+      params: e.params,
+      schemaPath: e.schemaPath
+    }))
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  validateIdentity33Payload
+});

package/dist/lib/identity-3.3/validation.mjs

@@ -0,0 +1,91 @@
+import Ajv from "ajv";
+import addFormats from "ajv-formats";
+import { getValidator } from "../validation/schema-loader.mjs";
+import schemas from "./schemas.draft.mjs";
+const validators = /* @__PURE__ */ new WeakMap();
+function validateIdentity33Payload(tool, direction, payload, version) {
+  const key = JSON.stringify([tool, direction, version]);
+  const stable = getValidator(tool, direction === "request" ? "request" : "sync", version);
+  if (!stable) return { valid: true, issues: [], variant: "skipped" };
+  let cache = validators.get(stable);
+  if (!cache) {
+    cache = /* @__PURE__ */ new Map();
+    validators.set(stable, cache);
+  }
+  let validator = cache.get(key);
+  if (!validator) {
+    let walk2 = function(node, name = "") {
+      if (!node || typeof node !== "object") return;
+      if (Array.isArray(node)) {
+        node.forEach((item) => walk2(item, name));
+        return;
+      }
+      const object = node;
+      if ((name === "reporting_webhook" || name === "artifact_webhook" || /Reporting Webhook|Artifact Webhook/i.test(object.title ?? "")) && Array.isArray(object.required))
+        object.required = object.required.filter((field) => field !== "authentication");
+      if (name === "reason" && Array.isArray(object.enum) && object.enum.includes("destination_state_changed"))
+        object.enum = [...object.enum, "relationship_changed", "relationship_expiring"];
+      if (object.properties?.url && object.properties?.authentication)
+        object.properties.signing_profile = { type: "string", enum: ["adcp/webhook-signing/v1", "web-bot-auth"] };
+      if (tool === "get_principal" && direction === "response" && object.properties?.kind && ["current", "recognized", "unconfigured"].includes(object.properties.kind.const))
+        object.properties.relationship = { ...relationship, $id: void 0 };
+      if (tool === "get_adcp_capabilities" && object.properties?.supported_billing)
+        object.properties.agent_onboarding = { ...onboarding, $id: void 0 };
+      if (tool === "get_adcp_capabilities" && ["request_signing", "webhook_signing"].includes(name) && object.properties)
+        object.properties.profiles = {
+          type: "array",
+          items: {
+            type: "string",
+            enum: name === "request_signing" ? ["adcp/request-signing/v1", "web-bot-auth"] : ["adcp/webhook-signing/v1", "web-bot-auth"]
+          },
+          minItems: 1,
+          uniqueItems: true
+        };
+      if (tool === "get_adcp_capabilities" && ["request_signing", "webhook_signing"].includes(name) && object.properties)
+        object.properties.wba_draft_revision = { type: "string", minLength: 1 };
+      for (const [k, value] of Object.entries(object)) if (k !== "$id") walk2(value, k);
+    };
+    var walk = walk2;
+    const schema = structuredClone(stable.schema);
+    const relationship = schemas.find((s) => s.$id === "/schemas/core/principal-relationship.json");
+    const onboarding = schemas.find((s) => s.$id === "/schemas/core/agent-onboarding.json");
+    walk2(schema);
+    const ajv = new Ajv({ strict: false, allErrors: true });
+    addFormats(ajv);
+    for (const draft of schemas) ajv.addSchema({ ...draft, $id: "https://adcontextprotocol.org" + draft.$id });
+    validator = ajv.compile(schema);
+    cache.set(key, validator);
+  }
+  let valid = validator(payload) === true;
+  if (valid && tool === "get_adcp_capabilities" && payload && typeof payload === "object") {
+    const body = payload;
+    const posture = body.account?.agent_onboarding;
+    if (posture && (!body.experimental_features?.includes("account.agent_onboarding") || posture.sandbox !== void 0 && body.account?.sandbox !== true || Object.keys(posture.billing ?? {}).some((k) => !body.account?.supported_billing?.includes(k))))
+      return {
+        valid: false,
+        variant: "sync",
+        issues: [
+          {
+            pointer: "/account/agent_onboarding",
+            keyword: "experimental",
+            schemaPath: "/identity33/agent_onboarding",
+            message: "Onboarding requires its feature declaration and supported account tiers"
+          }
+        ]
+      };
+  }
+  return {
+    valid,
+    variant: direction === "request" ? "request" : "sync",
+    issues: valid ? [] : (validator.errors ?? []).map((e) => ({
+      pointer: e.instancePath,
+      keyword: e.keyword,
+      message: e.message ?? "Invalid value",
+      params: e.params,
+      schemaPath: e.schemaPath
+    }))
+  };
+}
+export {
+  validateIdentity33Payload
+};

package/dist/lib/index.d.mts

@@ -216,7 +216,7 @@ export { FormatAsset, imageAssetSlot, videoAssetSlot, audioAssetSlot, textAssetS
 export { Render, urlRender, htmlRender, bothRender } from './utils/render-builders.mjs';
 export { FormatRender, displayRender, parameterizedRender, templateRender, type DimensionsRender, type ParameterizedRender, type RenderItem, } from './utils/format-render-builders.mjs';
 export { CanonicalFormat, canonicalFormatDeclaration, type CanonicalFormatDeclaration, type CanonicalFormatDeclaration as Format, type CanonicalFormatDeclarationFields, type CanonicalFormatKind, type CanonicalFormatParams, type ProductCardDetailedFields, type ProductCardFields, } from './v2/projection/index.mjs';
-export { toCanonicalFormatOptionsWithRoutes, toAdditiveCanonicalProduct, withAdditiveCanonicalFormatOptions, toCanonicalOnlyProduct, toCanonicalOnlyResponse, packageRefsForFormatOptions, FormatOptionRefsLookupError, CreativeFormatCapabilityError, CreativeFormatProjectionError, type CreativeFormatWireMode, type LegacyFormatConversionContext, type LegacyFormatConverter, type LegacyFormatResolutionContext, type LegacyFormatResolver, legacyFormatConverterFromCatalogSnapshots, canonicalFormatLegacyResolverFromCatalogSnapshots, canonicalFormatLegacyResolverFromRoutes, legacyRoutesForProduct, projectionAdaptersFromCatalogSnapshots, type ProjectionCatalogAdapters, type ProjectionCatalogSnapshot, type ProjectionCatalogSource, type CanonicalFormatLegacyResolver, type CanonicalFormatLegacyResolutionContext, type CanonicalFormatLegacyRoute, type AdditiveCanonicalProduct, type CanonicalOnlyProduct, type CanonicalCreativeAsset, type CanonicalCreativeAsset as CreativeAsset, type CanonicalSyncCreativeAsset, type CanonicalCreateMediaBuyInput, type CanonicalCreateMediaBuyRequest, type CanonicalCreateMediaBuyRequest as CreateMediaBuyRequest, type CanonicalCreateMediaBuyResponse, type CanonicalCreateMediaBuyResponse as CreateMediaBuyResponse, type CanonicalCreativeResponse, type CanonicalCreativeFilters, type CanonicalCreativeFilters as CreativeFilters, type CanonicalGetCreativeDeliveryResponse, type CanonicalGetCreativeDeliveryResponse as GetCreativeDeliveryResponse, type CanonicalGetMediaBuyDeliveryResponse, type CanonicalGetMediaBuyDeliveryResponse as GetMediaBuyDeliveryResponse, type CanonicalGetMediaBuysResponse, type CanonicalGetMediaBuysResponse as GetMediaBuysResponse, type CanonicalGetProductsResponse as GetProductsResponse, type CanonicalGetProductsRequest, type CanonicalGetProductsRequest as GetProductsRequest, type CanonicalListCreativesRequest, type CanonicalListCreativesRequest as ListCreativesRequest, type CanonicalListCreativesResponse, type CanonicalListCreativesResponse as ListCreativesResponse, type CanonicalListedCreative, type CanonicalPackageRequest, type CanonicalPackageRequest as PackageRequest, type CanonicalPackageUpdate, type CanonicalPackageUpdate as PackageUpdate, type CanonicalPackage, type CanonicalPackage as Package, type CanonicalPlacement, type CanonicalPlacement as Placement, type CanonicalPreviewCreativeRequest, type CanonicalPreviewCreativeRequest as PreviewCreativeRequest, type CanonicalPreviewCreativeResponse, type CanonicalPreviewCreativeResponse as PreviewCreativeResponse, type CanonicalProduct, type CanonicalProduct as Product, type CanonicalProjectedCreative, type CanonicalSyncCreativesRequest, type CanonicalSyncCreativesRequest as SyncCreativesRequest, type CanonicalSyncCreativesResponse, type CanonicalSyncCreativesResponse as SyncCreativesResponse, type CanonicalUpdateMediaBuyRequest, type CanonicalUpdateMediaBuyRequest as UpdateMediaBuyRequest, type CanonicalUpdateMediaBuyResponse, type CanonicalUpdateMediaBuyResponse as UpdateMediaBuyResponse, type LegacyCreativeAsset, type CanonicalCreativeFormatSelectorContainer, type PackageFormatRefs, type ProjectionDiagnostic, type SyncCreativeFormatProjection, } from './v2/projection/index.mjs';
+export { toCanonicalFormatOptionsWithRoutes, toAdditiveCanonicalProduct, withAdditiveCanonicalFormatOptions, toCanonicalOnlyProduct, toCanonicalOnlyResponse, packageRefsForFormatOptions, FormatOptionRefsLookupError, CreativeFormatCapabilityError, CreativeFormatProjectionError, type CreativeFormatWireMode, type LegacyFormatConversionContext, type LegacyFormatConverter, type LegacyFormatResolutionContext, type LegacyFormatResolver, legacyFormatConverterFromCatalogSnapshots, canonicalFormatLegacyResolverFromCatalogSnapshots, canonicalFormatLegacyResolverFromRoutes, legacyRoutesForProduct, projectionAdaptersFromCatalogSnapshots, type ProjectionCatalogAdapters, type ProjectionCatalogSnapshot, type ProjectionCatalogSource, type CanonicalFormatLegacyResolver, type CanonicalFormatLegacyResolutionContext, type CanonicalFormatLegacyRoute, type LegacyRoutesForProductOptions, type AdditiveCanonicalProduct, type CanonicalOnlyProduct, type CanonicalCreativeAsset, type CanonicalCreativeAsset as CreativeAsset, type CanonicalSyncCreativeAsset, type CanonicalCreateMediaBuyInput, type CanonicalCreateMediaBuyRequest, type CanonicalCreateMediaBuyRequest as CreateMediaBuyRequest, type CanonicalCreateMediaBuyResponse, type CanonicalCreateMediaBuyResponse as CreateMediaBuyResponse, type CanonicalCreativeResponse, type CanonicalCreativeFilters, type CanonicalCreativeFilters as CreativeFilters, type CanonicalGetCreativeDeliveryResponse, type CanonicalGetCreativeDeliveryResponse as GetCreativeDeliveryResponse, type CanonicalGetMediaBuyDeliveryResponse, type CanonicalGetMediaBuyDeliveryResponse as GetMediaBuyDeliveryResponse, type CanonicalGetMediaBuysResponse, type CanonicalGetMediaBuysResponse as GetMediaBuysResponse, type CanonicalGetProductsResponse as GetProductsResponse, type CanonicalGetProductsRequest, type CanonicalGetProductsRequest as GetProductsRequest, type CanonicalListCreativesRequest, type CanonicalListCreativesRequest as ListCreativesRequest, type CanonicalListCreativesResponse, type CanonicalListCreativesResponse as ListCreativesResponse, type CanonicalListedCreative, type CanonicalPackageRequest, type CanonicalPackageRequest as PackageRequest, type CanonicalPackageUpdate, type CanonicalPackageUpdate as PackageUpdate, type CanonicalPackage, type CanonicalPackage as Package, type CanonicalPlacement, type CanonicalPlacement as Placement, type CanonicalPreviewCreativeRequest, type CanonicalPreviewCreativeRequest as PreviewCreativeRequest, type CanonicalPreviewCreativeResponse, type CanonicalPreviewCreativeResponse as PreviewCreativeResponse, type CanonicalProduct, type CanonicalProduct as Product, type CanonicalProjectedCreative, type CanonicalSyncCreativesRequest, type CanonicalSyncCreativesRequest as SyncCreativesRequest, type CanonicalSyncCreativesResponse, type CanonicalSyncCreativesResponse as SyncCreativesResponse, type CanonicalUpdateMediaBuyRequest, type CanonicalUpdateMediaBuyRequest as UpdateMediaBuyRequest, type CanonicalUpdateMediaBuyResponse, type CanonicalUpdateMediaBuyResponse as UpdateMediaBuyResponse, type LegacyCreativeAsset, type CanonicalCreativeFormatSelectorContainer, type PackageFormatRefs, type ProjectionDiagnostic, type SyncCreativeFormatProjection, } from './v2/projection/index.mjs';
 export { activationKey, segmentIdActivationKey, keyValueActivationKey } from './utils/activation-key-builders.mjs';
 export { signalId, catalogSignalId, agentSignalId, getSignalId, getSignalIssuer } from './utils/signal-id-builders.mjs';
 export { buildActivateSignalRequest, getSignalActivationId, getSignalPricingOptionIds, normalizeDiscoveredSignal, } from './utils/signal-discovery-helpers.mjs';

package/dist/lib/index.d.ts

@@ -216,7 +216,7 @@ export { FormatAsset, imageAssetSlot, videoAssetSlot, audioAssetSlot, textAssetS
 export { Render, urlRender, htmlRender, bothRender } from './utils/render-builders';
 export { FormatRender, displayRender, parameterizedRender, templateRender, type DimensionsRender, type ParameterizedRender, type RenderItem, } from './utils/format-render-builders';
 export { CanonicalFormat, canonicalFormatDeclaration, type CanonicalFormatDeclaration, type CanonicalFormatDeclaration as Format, type CanonicalFormatDeclarationFields, type CanonicalFormatKind, type CanonicalFormatParams, type ProductCardDetailedFields, type ProductCardFields, } from './v2/projection';
-export { toCanonicalFormatOptionsWithRoutes, toAdditiveCanonicalProduct, withAdditiveCanonicalFormatOptions, toCanonicalOnlyProduct, toCanonicalOnlyResponse, packageRefsForFormatOptions, FormatOptionRefsLookupError, CreativeFormatCapabilityError, CreativeFormatProjectionError, type CreativeFormatWireMode, type LegacyFormatConversionContext, type LegacyFormatConverter, type LegacyFormatResolutionContext, type LegacyFormatResolver, legacyFormatConverterFromCatalogSnapshots, canonicalFormatLegacyResolverFromCatalogSnapshots, canonicalFormatLegacyResolverFromRoutes, legacyRoutesForProduct, projectionAdaptersFromCatalogSnapshots, type ProjectionCatalogAdapters, type ProjectionCatalogSnapshot, type ProjectionCatalogSource, type CanonicalFormatLegacyResolver, type CanonicalFormatLegacyResolutionContext, type CanonicalFormatLegacyRoute, type AdditiveCanonicalProduct, type CanonicalOnlyProduct, type CanonicalCreativeAsset, type CanonicalCreativeAsset as CreativeAsset, type CanonicalSyncCreativeAsset, type CanonicalCreateMediaBuyInput, type CanonicalCreateMediaBuyRequest, type CanonicalCreateMediaBuyRequest as CreateMediaBuyRequest, type CanonicalCreateMediaBuyResponse, type CanonicalCreateMediaBuyResponse as CreateMediaBuyResponse, type CanonicalCreativeResponse, type CanonicalCreativeFilters, type CanonicalCreativeFilters as CreativeFilters, type CanonicalGetCreativeDeliveryResponse, type CanonicalGetCreativeDeliveryResponse as GetCreativeDeliveryResponse, type CanonicalGetMediaBuyDeliveryResponse, type CanonicalGetMediaBuyDeliveryResponse as GetMediaBuyDeliveryResponse, type CanonicalGetMediaBuysResponse, type CanonicalGetMediaBuysResponse as GetMediaBuysResponse, type CanonicalGetProductsResponse as GetProductsResponse, type CanonicalGetProductsRequest, type CanonicalGetProductsRequest as GetProductsRequest, type CanonicalListCreativesRequest, type CanonicalListCreativesRequest as ListCreativesRequest, type CanonicalListCreativesResponse, type CanonicalListCreativesResponse as ListCreativesResponse, type CanonicalListedCreative, type CanonicalPackageRequest, type CanonicalPackageRequest as PackageRequest, type CanonicalPackageUpdate, type CanonicalPackageUpdate as PackageUpdate, type CanonicalPackage, type CanonicalPackage as Package, type CanonicalPlacement, type CanonicalPlacement as Placement, type CanonicalPreviewCreativeRequest, type CanonicalPreviewCreativeRequest as PreviewCreativeRequest, type CanonicalPreviewCreativeResponse, type CanonicalPreviewCreativeResponse as PreviewCreativeResponse, type CanonicalProduct, type CanonicalProduct as Product, type CanonicalProjectedCreative, type CanonicalSyncCreativesRequest, type CanonicalSyncCreativesRequest as SyncCreativesRequest, type CanonicalSyncCreativesResponse, type CanonicalSyncCreativesResponse as SyncCreativesResponse, type CanonicalUpdateMediaBuyRequest, type CanonicalUpdateMediaBuyRequest as UpdateMediaBuyRequest, type CanonicalUpdateMediaBuyResponse, type CanonicalUpdateMediaBuyResponse as UpdateMediaBuyResponse, type LegacyCreativeAsset, type CanonicalCreativeFormatSelectorContainer, type PackageFormatRefs, type ProjectionDiagnostic, type SyncCreativeFormatProjection, } from './v2/projection';
+export { toCanonicalFormatOptionsWithRoutes, toAdditiveCanonicalProduct, withAdditiveCanonicalFormatOptions, toCanonicalOnlyProduct, toCanonicalOnlyResponse, packageRefsForFormatOptions, FormatOptionRefsLookupError, CreativeFormatCapabilityError, CreativeFormatProjectionError, type CreativeFormatWireMode, type LegacyFormatConversionContext, type LegacyFormatConverter, type LegacyFormatResolutionContext, type LegacyFormatResolver, legacyFormatConverterFromCatalogSnapshots, canonicalFormatLegacyResolverFromCatalogSnapshots, canonicalFormatLegacyResolverFromRoutes, legacyRoutesForProduct, projectionAdaptersFromCatalogSnapshots, type ProjectionCatalogAdapters, type ProjectionCatalogSnapshot, type ProjectionCatalogSource, type CanonicalFormatLegacyResolver, type CanonicalFormatLegacyResolutionContext, type CanonicalFormatLegacyRoute, type LegacyRoutesForProductOptions, type AdditiveCanonicalProduct, type CanonicalOnlyProduct, type CanonicalCreativeAsset, type CanonicalCreativeAsset as CreativeAsset, type CanonicalSyncCreativeAsset, type CanonicalCreateMediaBuyInput, type CanonicalCreateMediaBuyRequest, type CanonicalCreateMediaBuyRequest as CreateMediaBuyRequest, type CanonicalCreateMediaBuyResponse, type CanonicalCreateMediaBuyResponse as CreateMediaBuyResponse, type CanonicalCreativeResponse, type CanonicalCreativeFilters, type CanonicalCreativeFilters as CreativeFilters, type CanonicalGetCreativeDeliveryResponse, type CanonicalGetCreativeDeliveryResponse as GetCreativeDeliveryResponse, type CanonicalGetMediaBuyDeliveryResponse, type CanonicalGetMediaBuyDeliveryResponse as GetMediaBuyDeliveryResponse, type CanonicalGetMediaBuysResponse, type CanonicalGetMediaBuysResponse as GetMediaBuysResponse, type CanonicalGetProductsResponse as GetProductsResponse, type CanonicalGetProductsRequest, type CanonicalGetProductsRequest as GetProductsRequest, type CanonicalListCreativesRequest, type CanonicalListCreativesRequest as ListCreativesRequest, type CanonicalListCreativesResponse, type CanonicalListCreativesResponse as ListCreativesResponse, type CanonicalListedCreative, type CanonicalPackageRequest, type CanonicalPackageRequest as PackageRequest, type CanonicalPackageUpdate, type CanonicalPackageUpdate as PackageUpdate, type CanonicalPackage, type CanonicalPackage as Package, type CanonicalPlacement, type CanonicalPlacement as Placement, type CanonicalPreviewCreativeRequest, type CanonicalPreviewCreativeRequest as PreviewCreativeRequest, type CanonicalPreviewCreativeResponse, type CanonicalPreviewCreativeResponse as PreviewCreativeResponse, type CanonicalProduct, type CanonicalProduct as Product, type CanonicalProjectedCreative, type CanonicalSyncCreativesRequest, type CanonicalSyncCreativesRequest as SyncCreativesRequest, type CanonicalSyncCreativesResponse, type CanonicalSyncCreativesResponse as SyncCreativesResponse, type CanonicalUpdateMediaBuyRequest, type CanonicalUpdateMediaBuyRequest as UpdateMediaBuyRequest, type CanonicalUpdateMediaBuyResponse, type CanonicalUpdateMediaBuyResponse as UpdateMediaBuyResponse, type LegacyCreativeAsset, type CanonicalCreativeFormatSelectorContainer, type PackageFormatRefs, type ProjectionDiagnostic, type SyncCreativeFormatProjection, } from './v2/projection';
 export { activationKey, segmentIdActivationKey, keyValueActivationKey } from './utils/activation-key-builders';
 export { signalId, catalogSignalId, agentSignalId, getSignalId, getSignalIssuer } from './utils/signal-id-builders';
 export { buildActivateSignalRequest, getSignalActivationId, getSignalPricingOptionIds, normalizeDiscoveredSignal, } from './utils/signal-discovery-helpers';

package/dist/lib/reporting/azure/index.d.mts

@@ -1,5 +1,8 @@
 import type { BlobServiceClient } from '@azure/storage-blob';
 import type { ReportingRowObjectProviderV1 } from '../ledger/row-storage-object.mjs';
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export interface CreateAzureBlobReportingRowObjectProviderOptionsV1 {
     /** Official client used by bindings without a `credentialRef`. */
     client?: BlobServiceClient;
@@ -22,5 +25,7 @@ export interface CreateAzureBlobReportingRowObjectProviderOptionsV1 {
  * identical bytes at the same key (ETags are content-derived and cannot fence that).
  * The probe refuses accounts without versioning and proves create-only behaviour
  * empirically.
+ *
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
  */
 export declare function createAzureBlobReportingRowObjectProviderV1(options: CreateAzureBlobReportingRowObjectProviderOptionsV1): ReportingRowObjectProviderV1;

package/dist/lib/reporting/azure/index.d.ts

@@ -1,5 +1,8 @@
 import type { BlobServiceClient } from '@azure/storage-blob';
 import type { ReportingRowObjectProviderV1 } from '../ledger/row-storage-object';
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export interface CreateAzureBlobReportingRowObjectProviderOptionsV1 {
     /** Official client used by bindings without a `credentialRef`. */
     client?: BlobServiceClient;
@@ -22,5 +25,7 @@ export interface CreateAzureBlobReportingRowObjectProviderOptionsV1 {
  * identical bytes at the same key (ETags are content-derived and cannot fence that).
  * The probe refuses accounts without versioning and proves create-only behaviour
  * empirically.
+ *
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
  */
 export declare function createAzureBlobReportingRowObjectProviderV1(options: CreateAzureBlobReportingRowObjectProviderOptionsV1): ReportingRowObjectProviderV1;

package/dist/lib/reporting/azure/index.js

@@ -86,12 +86,12 @@ function createAzureBlobReportingRowObjectProviderV1(options) {
     return client.getContainerClient(input.location.container);
   };
   const blobFor = (input) => {
-    if (typeof input.key !== "string" || input.key.length === 0 || input.key.length > 1024) {
+    if (typeof input.objectRef !== "string" || input.objectRef.length === 0 || input.objectRef.length > 1024) {
       throw new import_row_storage_errors.ReportingRowStoreError("INVALID_INPUT", "object key is invalid");
     }
-    return containerFor(input).getBlockBlobClient(input.key);
+    return containerFor(input).getBlockBlobClient(input.objectRef);
   };
-  const pinned = (blob, nativeVersion) => typeof nativeVersion === "string" && VERSION_ID.test(nativeVersion) ? { blob: blob.withVersion(nativeVersion), versionId: nativeVersion } : null;
+  const pinned = (blob, nativeVersionRef) => typeof nativeVersionRef === "string" && VERSION_ID.test(nativeVersionRef) ? { blob: blob.withVersion(nativeVersionRef), versionId: nativeVersionRef } : null;
   async function assertCreateOnlyEnforced(container, prefix, signal) {
     const blob = container.getBlockBlobClient(`${prefix}/.adcp-probe/${(0, import_node_crypto.randomUUID)()}`);
     const versionIds = [];
@@ -158,19 +158,19 @@ function createAzureBlobReportingRowObjectProviderV1(options) {
             metadata: metadataOf(input.metadata),
             abortSignal: context.signal
           });
-          return { created: true, nativeVersion: versionOf(response) };
+          return { created: true, nativeVersionRef: versionOf(response) };
         } catch (error) {
           if (!isConflict(error)) throw error;
         }
         const existing = await blob.getProperties({ abortSignal: context.signal });
-        return { created: false, nativeVersion: versionOf(existing) };
+        return { created: false, nativeVersionRef: versionOf(existing) };
       });
     },
     get(input, context) {
       return (0, import_row_storage_provider_io.runReportingRowProviderOperation)(context.signal, async () => {
         const blob = blobFor(input);
         (0, import_row_storage_provider_io.assertReportingRowReadBounds)(input);
-        const target = pinned(blob, input.nativeVersion);
+        const target = pinned(blob, input.nativeVersionRef);
         if (target === null) return null;
         try {
           if (input.range?.length === 0) {
@@ -207,10 +207,29 @@ function createAzureBlobReportingRowObjectProviderV1(options) {
         }
       });
     },
+    stat(input, context) {
+      return (0, import_row_storage_provider_io.runReportingRowProviderOperation)(context.signal, async () => {
+        const blob = blobFor(input);
+        const target = pinned(blob, input.nativeVersionRef);
+        if (target === null) return null;
+        try {
+          const properties = await target.blob.getProperties({ abortSignal: context.signal });
+          if (!servedVersion(properties, target.versionId)) return null;
+          const size = properties.contentLength;
+          if (typeof size !== "number" || !Number.isSafeInteger(size) || size < 0) {
+            throw new import_row_storage_errors.ReportingRowStoreError("PROVIDER_UNAVAILABLE", "blob metadata is malformed");
+          }
+          return { nativeVersionRef: target.versionId, sizeBytes: size };
+        } catch (error) {
+          if (isMissing(error) || statusOf(error) === 400) return null;
+          throw error;
+        }
+      });
+    },
     delete(input, context) {
       return (0, import_row_storage_provider_io.runReportingRowProviderOperation)(context.signal, async () => {
         const blob = blobFor(input);
-        const target = pinned(blob, input.nativeVersion);
+        const target = pinned(blob, input.nativeVersionRef);
         if (target === null) return "absent";
         const signal = context.signal;
         try {

package/dist/lib/reporting/azure/index.mjs

@@ -70,12 +70,12 @@ function createAzureBlobReportingRowObjectProviderV1(options) {
     return client.getContainerClient(input.location.container);
   };
   const blobFor = (input) => {
-    if (typeof input.key !== "string" || input.key.length === 0 || input.key.length > 1024) {
+    if (typeof input.objectRef !== "string" || input.objectRef.length === 0 || input.objectRef.length > 1024) {
       throw new ReportingRowStoreError("INVALID_INPUT", "object key is invalid");
     }
-    return containerFor(input).getBlockBlobClient(input.key);
+    return containerFor(input).getBlockBlobClient(input.objectRef);
   };
-  const pinned = (blob, nativeVersion) => typeof nativeVersion === "string" && VERSION_ID.test(nativeVersion) ? { blob: blob.withVersion(nativeVersion), versionId: nativeVersion } : null;
+  const pinned = (blob, nativeVersionRef) => typeof nativeVersionRef === "string" && VERSION_ID.test(nativeVersionRef) ? { blob: blob.withVersion(nativeVersionRef), versionId: nativeVersionRef } : null;
   async function assertCreateOnlyEnforced(container, prefix, signal) {
     const blob = container.getBlockBlobClient(`${prefix}/.adcp-probe/${randomUUID()}`);
     const versionIds = [];
@@ -142,19 +142,19 @@ function createAzureBlobReportingRowObjectProviderV1(options) {
             metadata: metadataOf(input.metadata),
             abortSignal: context.signal
           });
-          return { created: true, nativeVersion: versionOf(response) };
+          return { created: true, nativeVersionRef: versionOf(response) };
         } catch (error) {
           if (!isConflict(error)) throw error;
         }
         const existing = await blob.getProperties({ abortSignal: context.signal });
-        return { created: false, nativeVersion: versionOf(existing) };
+        return { created: false, nativeVersionRef: versionOf(existing) };
       });
     },
     get(input, context) {
       return runReportingRowProviderOperation(context.signal, async () => {
         const blob = blobFor(input);
         assertReportingRowReadBounds(input);
-        const target = pinned(blob, input.nativeVersion);
+        const target = pinned(blob, input.nativeVersionRef);
         if (target === null) return null;
         try {
           if (input.range?.length === 0) {
@@ -191,10 +191,29 @@ function createAzureBlobReportingRowObjectProviderV1(options) {
         }
       });
     },
+    stat(input, context) {
+      return runReportingRowProviderOperation(context.signal, async () => {
+        const blob = blobFor(input);
+        const target = pinned(blob, input.nativeVersionRef);
+        if (target === null) return null;
+        try {
+          const properties = await target.blob.getProperties({ abortSignal: context.signal });
+          if (!servedVersion(properties, target.versionId)) return null;
+          const size = properties.contentLength;
+          if (typeof size !== "number" || !Number.isSafeInteger(size) || size < 0) {
+            throw new ReportingRowStoreError("PROVIDER_UNAVAILABLE", "blob metadata is malformed");
+          }
+          return { nativeVersionRef: target.versionId, sizeBytes: size };
+        } catch (error) {
+          if (isMissing(error) || statusOf(error) === 400) return null;
+          throw error;
+        }
+      });
+    },
     delete(input, context) {
       return runReportingRowProviderOperation(context.signal, async () => {
         const blob = blobFor(input);
-        const target = pinned(blob, input.nativeVersion);
+        const target = pinned(blob, input.nativeVersionRef);
         if (target === null) return "absent";
         const signal = context.signal;
         try {