@adcp/sdk 8.1.0-beta.13 → 8.1.0-beta.14

package/README.md

@@ -336,7 +336,7 @@ serve(() => createAdcpServerFromPlatform(platform, { name: 'My Publisher', versi
 
 - `definePlatform` / `defineSalesCorePlatform` / `defineSalesIngestionPlatform` / sibling `define<X>Platform` factories — drop `req: unknown` casts on inline platform objects.
 - `composeMethod(inner, { before, after })` — typed before/after wrappers around any platform method (caching, enrichment under `ext.*`, typed-error guards). Pre-built `accounts.resolve` guards: `requireAccountMatch`, `requireAdvertiserMatch`, `requireOrgScope`.
-- Typed errors: `AuthRequiredError`, `PermissionDeniedError`, `RateLimitedError`, `ServiceUnavailableError`, `GovernanceDeniedError`, `IdempotencyConflictError`, plus the not-found family. Throw these instead of `new AdcpError(code, ...)`.
+- Typed errors: `AuthMissingError`, `AuthInvalidError`, `PermissionDeniedError`, `RateLimitedError`, `ServiceUnavailableError`, `GovernanceDeniedError`, `IdempotencyConflictError`, plus the not-found family. `AuthRequiredError` remains as a deprecated `AUTH_REQUIRED` compatibility wrapper. Throw these instead of `new AdcpError(code, ...)`.
 - `BuyerAgentRegistry` — durable buyer-agent identity surface threaded through `ctx.agent` to every `AccountStore` method. See [`docs/migration-buyer-agent-registry.md`](docs/migration-buyer-agent-registry.md).
 - Three reference `AccountStore` shapes: `InMemoryImplicitAccountStore` (Shape A — buyer-driven `sync_accounts`), `createOAuthPassthroughResolver` (Shape B — vendor OAuth + `/me/adaccounts`), `createRosterAccountStore` (Shape C — publisher-curated roster).
 - Multi-tenant: `createTenantRegistry({...})` for host-routed (one server per tenant) or `createTenantStore({...})` for account-routed (one server, per-entry tenant gate built in, fail-closed when auth principal can't be resolved).

package/bin/adcp-registry.js

@@ -247,10 +247,10 @@ AUTHORIZATION:
 
 OPTIONS:
   --auth TOKEN        API key for authenticated access (required for save)
-  --registry-url URL  Custom registry URL (default: https://adcontextprotocol.org)
+  --registry-url URL  Custom registry URL (default: https://agenticadvertising.org)
   --json              Output raw JSON
   --search TERM       Search filter for list commands
-  --type TYPE         Agent type filter (creative, signals, sales, governance, si)
+  --type TYPE         Agent type filter (sales, creative, signals, measurement, governance, si)
   --health            Include agent health data
   --capabilities      Include agent capabilities data
   --properties        Include agent property data

package/dist/lib/canonical-references/index.d.ts

@@ -0,0 +1,107 @@
+export interface CanonicalReference {
+    uri: string;
+    /** `sha256:` prefix plus 64 lowercase hex characters. */
+    digest: string;
+}
+export type CanonicalReferenceKind = 'format_schema' | 'platform_extensions' | 'generic';
+export type CanonicalReferenceStatus = 'resolved' | 'unresolvable' | 'invalid_document' | 'invalid_schema' | 'digest_mismatch' | 'blocked_unsafe_url' | 'invalid_ref';
+export type CanonicalReferenceErrorCode = 'invalid_ref' | 'non_https_url' | 'unsafe_url' | 'redirect_blocked' | 'http_error' | 'network_error' | 'body_too_large' | 'invalid_json' | 'invalid_json_schema' | 'unsupported_schema_draft' | 'ref_sandbox_violation' | 'external_ref_unpinned' | 'keyword_limit_exceeded' | 'digest_mismatch';
+export interface CanonicalReferenceError {
+    code: CanonicalReferenceErrorCode;
+    message: string;
+    /** True only for transient network/server classes callers may retry later. */
+    retryable: boolean;
+    /** Digest mismatch means the fetched body was not the immutable document requested. */
+    securitySignal?: 'substitution_attack';
+    details?: Record<string, unknown>;
+}
+interface CanonicalReferenceResultBase {
+    ok: boolean;
+    status: CanonicalReferenceStatus;
+    kind: CanonicalReferenceKind;
+    ref: CanonicalReference;
+    cacheKey: string;
+    fromCache: boolean;
+}
+export interface CanonicalReferenceResolvedResult<TDocument = unknown> extends CanonicalReferenceResultBase {
+    ok: true;
+    status: 'resolved';
+    document: TDocument;
+    body: Uint8Array;
+    text: string;
+    contentType?: string;
+    httpStatus: number;
+    schemaMeta?: {
+        draft: 'draft-07' | '2020-12';
+        refCount: number;
+        maxRefDepthSeen: number;
+        keywordCount: number;
+        validationTimeMs: number;
+    };
+}
+export interface FormatSchemaReferenceResolvedResult extends CanonicalReferenceResolvedResult<Record<string, unknown>> {
+    kind: 'format_schema';
+    schemaMeta: NonNullable<CanonicalReferenceResolvedResult['schemaMeta']>;
+}
+export interface CanonicalReferenceFailureResult extends CanonicalReferenceResultBase {
+    ok: false;
+    status: Exclude<CanonicalReferenceStatus, 'resolved'>;
+    error: CanonicalReferenceError;
+    httpStatus?: number;
+}
+export type CanonicalReferenceResult<TDocument = unknown> = CanonicalReferenceResolvedResult<TDocument> | CanonicalReferenceFailureResult;
+export type FormatSchemaReferenceResult = FormatSchemaReferenceResolvedResult | CanonicalReferenceFailureResult;
+export type PlatformExtensionsReferenceResult = CanonicalReferenceResult<unknown>;
+export type ExternalRefDigestMap = ReadonlyMap<string, string> | Readonly<Record<string, string>>;
+export interface CanonicalReferenceCache {
+    get(key: string): CanonicalReferenceResolvedResult | undefined;
+    set(key: string, value: CanonicalReferenceResolvedResult): void;
+}
+export interface CanonicalReferenceResolverOptions {
+    /** Caller-owned cache. Defaults to a fresh per-resolver Map. */
+    cache?: CanonicalReferenceCache;
+    /** Default 5_000 ms. */
+    timeoutMs?: number;
+    /** Default 1 MiB. */
+    maxBodyBytes?: number;
+    /** Test/dev-only escape hatch for loopback fixtures. Production callers should leave false. */
+    allowUnsafeHttp?: boolean;
+    /** Test/dev-only escape hatch for loopback/private-network fixtures. Production callers should leave false. */
+    allowPrivateNetwork?: boolean;
+    /** Default 8 for `format_schema` `$ref` walks. */
+    maxRefDepth?: number;
+    /** Default 256 for `format_schema` `$ref` walks. */
+    maxRefCount?: number;
+    /** Default 10_000 approximate schema keyword/object-key bound. */
+    maxKeywords?: number;
+    /** Default 250 ms soft compile-time budget for JSON Schema validation. */
+    validationBudgetMs?: number;
+    /** Required for each external `$ref` URI in `format_schema`; keeps transitive schemas immutable. */
+    externalRefDigests?: ExternalRefDigestMap;
+    /** Default 8 MiB cumulative cap across external `$ref` bodies. */
+    maxTotalRefBytes?: number;
+    /** Default 5_000 ms total wall-clock budget across external `$ref` resolution. */
+    maxRefResolutionMs?: number;
+    /** Override the trusted mirror host set for `format_schema` external `$ref`s. */
+    mirrorHosts?: readonly string[];
+    /** Single-host convenience override for `format_schema` external `$ref`s. */
+    mirrorHost?: string;
+}
+export interface CanonicalReferenceResolveOptions extends Omit<CanonicalReferenceResolverOptions, 'cache'> {
+    cache?: CanonicalReferenceCache;
+    kind?: CanonicalReferenceKind;
+}
+export interface CanonicalReferenceResolver {
+    cache: CanonicalReferenceCache;
+    resolveFormatSchema(ref: CanonicalReference, options?: Omit<CanonicalReferenceResolveOptions, 'cache' | 'kind'>): Promise<FormatSchemaReferenceResult>;
+    resolvePlatformExtensions(ref: CanonicalReference, options?: Omit<CanonicalReferenceResolveOptions, 'cache' | 'kind'>): Promise<CanonicalReferenceResult<unknown>>;
+    resolve(ref: CanonicalReference, options?: Omit<CanonicalReferenceResolveOptions, 'cache'>): Promise<CanonicalReferenceResult<unknown>>;
+}
+export declare function createCanonicalReferenceCache(): CanonicalReferenceCache;
+export declare function canonicalReferenceCacheKey(ref: CanonicalReference, options?: Pick<CanonicalReferenceResolveOptions, 'allowPrivateNetwork' | 'allowUnsafeHttp' | 'maxBodyBytes'>): string;
+export declare function createCanonicalReferenceResolver(defaults?: CanonicalReferenceResolverOptions): CanonicalReferenceResolver;
+export declare function resolvePlatformExtensionsReference(ref: CanonicalReference, options?: CanonicalReferenceResolveOptions): Promise<PlatformExtensionsReferenceResult>;
+export declare function resolveFormatSchemaReference(ref: CanonicalReference, options?: CanonicalReferenceResolveOptions): Promise<FormatSchemaReferenceResult>;
+export declare function resolveCanonicalReference(ref: CanonicalReference, options?: CanonicalReferenceResolveOptions): Promise<CanonicalReferenceResult<unknown>>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/canonical-references/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/canonical-references/index.ts"],"names":[],"mappings":"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"}