@adcp/sdk 9.0.0 → 9.1.0

package/dist/lib/protocols/transportDiagnostics.js

@@ -0,0 +1,310 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transportDiagnosticsStorage = void 0;
+exports.withTransportDiagnostics = withTransportDiagnostics;
+exports.sanitizeTransportUrl = sanitizeTransportUrl;
+exports.sanitizeTransportHeaders = sanitizeTransportHeaders;
+exports.wrapFetchWithTransportDiagnostics = wrapFetchWithTransportDiagnostics;
+const node_async_hooks_1 = require("node:async_hooks");
+const node_crypto_1 = require("node:crypto");
+const BODY_SNIPPET_LIMIT = 64 * 1024;
+const REDACTED = '[redacted]';
+const SAFE_HEADER_NAMES = new Set([
+    'accept',
+    'accept-encoding',
+    'content-type',
+    'last-event-id',
+    'mcp-protocol-version',
+    'traceparent',
+    'tracestate',
+    'user-agent',
+    'x-adcp-agent-id',
+    'x-adcp-request-id',
+    'x-correlation-id',
+    'x-request-id',
+    'x-scope3-debug-id',
+]);
+const SENSITIVE_HEADER_NAMES = new Set([
+    'authorization',
+    'cookie',
+    'proxy-authorization',
+    'set-cookie',
+    'x-adcp-auth',
+    'x-api-key',
+    'mcp-session-id',
+]);
+const SENSITIVE_KEY_RE = /(^|[_-])(authorization|cookie|credentials?|secret|signature|token|api[_-]?key|private[_-]?key|idempotency[_-]?key|password)([_-]|$)/i;
+const SENSITIVE_TEXT_FIELD_RE = /((?:"[^"]*(?:authorization|cookie|credentials?|secret|signature|token|api[_-]?key|private[_-]?key|idempotency[_-]?key|password)[^"]*"\s*:\s*)|(?:^|[&\s])[^=&\s]*(?:authorization|cookie|credentials?|secret|signature|token|api[_-]?key|private[_-]?key|idempotency[_-]?key|password)[^=&\s]*=)("[^"]*"|[^&\s,}]+)/gi;
+const URL_LIKE_RE = /\bhttps?:\/\/[^\s"'<>]+/gi;
+exports.transportDiagnosticsStorage = new node_async_hooks_1.AsyncLocalStorage();
+function withTransportDiagnostics(context, fn) {
+    if (!context.onTransportActivity)
+        return fn();
+    const slot = { ...context, pending: [] };
+    return exports.transportDiagnosticsStorage.run(slot, async () => {
+        try {
+            return await fn();
+        }
+        finally {
+            await Promise.allSettled(slot.pending);
+        }
+    });
+}
+function sanitizeTransportUrl(value) {
+    try {
+        const url = new URL(value);
+        url.username = '';
+        url.password = '';
+        url.search = '';
+        url.hash = '';
+        return url.toString();
+    }
+    catch {
+        return 'invalid_url';
+    }
+}
+function sanitizeTransportHeaders(headers) {
+    const out = {};
+    for (const [key, value] of headerEntries(headers)) {
+        const lower = key.toLowerCase();
+        if (SENSITIVE_HEADER_NAMES.has(lower) || SENSITIVE_KEY_RE.test(lower)) {
+            out[lower] = REDACTED;
+        }
+        else if (SAFE_HEADER_NAMES.has(lower) || isSafeCorrelationHeader(lower)) {
+            out[lower] = value;
+        }
+    }
+    return out;
+}
+function wrapFetchWithTransportDiagnostics(upstream) {
+    const wrapped = async (input, init) => {
+        const slot = exports.transportDiagnosticsStorage.getStore();
+        if (!slot?.onTransportActivity)
+            return upstream(input, init);
+        const startedAtMs = Date.now();
+        const startedAt = new Date(startedAtMs).toISOString();
+        const method = getMethod(input, init);
+        const url = sanitizeTransportUrl(getUrl(input));
+        const requestHeaders = sanitizeTransportHeaders(mergeRequestHeaders(input, init));
+        const requestBody = bodySnippet(init?.body);
+        const baseEvent = {
+            agentId: slot.agentId,
+            protocol: slot.protocol,
+            ...(slot.tool && { tool: slot.tool, taskType: slot.taskType ?? slot.tool }),
+            ...(slot.operationId && { operationId: slot.operationId }),
+            ...(slot.taskId && { taskId: slot.taskId }),
+            ...(slot.contextId && { contextId: slot.contextId }),
+            ...(slot.idempotencyKey && { idempotencyKeyHash: fingerprintDiagnosticValue(slot.idempotencyKey) }),
+            method,
+            url,
+            requestHeaders,
+            ...(requestBody && {
+                requestBody: requestBody.body,
+                requestBodyTruncated: requestBody.truncated,
+            }),
+            startedAt,
+        };
+        emitTransportActivity(slot.onTransportActivity, {
+            type: 'request_started',
+            ...baseEvent,
+            timestamp: startedAt,
+        });
+        try {
+            const response = await upstream(input, init);
+            const durationMs = Date.now() - startedAtMs;
+            const responseHeaders = sanitizeResponseHeaders(response.headers);
+            const responseBody = await responseBodySnippet(response);
+            emitTransportActivity(slot.onTransportActivity, {
+                type: 'response_received',
+                ...baseEvent,
+                timestamp: new Date().toISOString(),
+                durationMs,
+                httpStatus: response.status,
+                statusText: response.statusText,
+                responseHeaders,
+                ...(responseBody && {
+                    responseBody: responseBody.body,
+                    responseBodyTruncated: responseBody.truncated,
+                }),
+            });
+            return response;
+        }
+        catch (error) {
+            emitTransportActivity(slot.onTransportActivity, {
+                type: 'request_failed',
+                ...baseEvent,
+                timestamp: new Date().toISOString(),
+                durationMs: Date.now() - startedAtMs,
+                errorName: error instanceof Error ? error.name : typeof error,
+                errorMessage: sanitizeDiagnosticText(error instanceof Error ? error.message : String(error)),
+            });
+            throw error;
+        }
+    };
+    return wrapped;
+}
+function emitTransportActivity(handler, event) {
+    try {
+        const slot = exports.transportDiagnosticsStorage.getStore();
+        const frozen = Object.freeze(structuredClone(event));
+        const pending = Promise.resolve()
+            .then(() => handler(frozen))
+            .then(() => { }, () => { });
+        slot?.pending.push(pending);
+    }
+    catch {
+        // Observability hooks must not change protocol behavior.
+    }
+}
+function getUrl(input) {
+    return typeof input === 'string' ? input : input instanceof URL ? input.toString() : input.url;
+}
+function getMethod(input, init) {
+    return (init?.method ?? (input instanceof Request ? input.method : 'GET')).toUpperCase();
+}
+function mergeRequestHeaders(input, init) {
+    const headers = new Headers(input instanceof Request ? input.headers : undefined);
+    if (init?.headers) {
+        for (const [key, value] of headerEntries(init.headers)) {
+            headers.set(key, value);
+        }
+    }
+    return headers;
+}
+function sanitizeResponseHeaders(headers) {
+    return sanitizeTransportHeaders(headers);
+}
+function headerEntries(headers) {
+    if (!headers)
+        return [];
+    if (headers instanceof Headers) {
+        const entries = [];
+        headers.forEach((value, key) => entries.push([key, value]));
+        return entries;
+    }
+    if (Array.isArray(headers))
+        return headers.map(([key, value]) => [key, value]);
+    return Object.entries(headers).map(([key, value]) => [key, String(value)]);
+}
+function isSafeCorrelationHeader(lower) {
+    if (!lower.startsWith('x-'))
+        return false;
+    return (lower.includes('correlation') || lower.includes('debug') || lower.includes('request-id') || lower.includes('trace'));
+}
+function bodySnippet(body) {
+    if (body == null)
+        return undefined;
+    if (typeof body === 'string')
+        return sanitizeBodyText(body, BODY_SNIPPET_LIMIT);
+    if (body instanceof URLSearchParams)
+        return sanitizeBodyText(body.toString(), BODY_SNIPPET_LIMIT);
+    if (body instanceof Blob)
+        return { body: `[blob ${body.size} bytes]`, truncated: false };
+    if (body instanceof ArrayBuffer) {
+        return sanitizeBodyText(Buffer.from(body).toString('utf8'), BODY_SNIPPET_LIMIT);
+    }
+    if (ArrayBuffer.isView(body)) {
+        return sanitizeBodyText(Buffer.from(body.buffer, body.byteOffset, body.byteLength).toString('utf8'), BODY_SNIPPET_LIMIT);
+    }
+    return undefined;
+}
+async function responseBodySnippet(response) {
+    const contentType = response.headers.get('content-type') ?? '';
+    if (!isDiagnosticTextContentType(contentType))
+        return undefined;
+    try {
+        const { text, truncated } = await readResponseTextBounded(response.clone(), BODY_SNIPPET_LIMIT);
+        return { body: redactSensitiveJsonOrText(text), truncated };
+    }
+    catch {
+        return undefined;
+    }
+}
+function sanitizeBodyText(text, limit) {
+    const truncated = text.length > limit;
+    const bounded = truncated ? text.slice(0, limit) : text;
+    return { body: redactSensitiveJsonOrText(bounded), truncated };
+}
+function redactSensitiveJsonOrText(text) {
+    try {
+        return JSON.stringify(redactSensitiveValue(JSON.parse(text)));
+    }
+    catch {
+        return sanitizeDiagnosticText(text);
+    }
+}
+function redactSensitiveValue(value) {
+    if (Array.isArray(value))
+        return value.map(redactSensitiveValue);
+    if (typeof value === 'string')
+        return sanitizeStringValue(value);
+    if (!value || typeof value !== 'object')
+        return value;
+    const out = {};
+    for (const [key, child] of Object.entries(value)) {
+        out[key] = isSensitiveKey(key) ? REDACTED : redactSensitiveValue(child);
+    }
+    return out;
+}
+function sanitizeDiagnosticText(text) {
+    return text
+        .replace(URL_LIKE_RE, value => sanitizeTransportUrl(value))
+        .replace(/Bearer\s+[A-Za-z0-9._~+/=-]+/gi, 'Bearer [redacted]')
+        .replace(/Basic\s+[A-Za-z0-9+/=-]+/gi, 'Basic [redacted]')
+        .replace(SENSITIVE_TEXT_FIELD_RE, (_match, prefix) => `${prefix}${REDACTED}`);
+}
+function sanitizeStringValue(value) {
+    return sanitizeDiagnosticText(value);
+}
+function normalizedKey(key) {
+    return key.replace(/([a-z0-9])([A-Z])/g, '$1_$2').toLowerCase();
+}
+function isSensitiveKey(key) {
+    return SENSITIVE_KEY_RE.test(normalizedKey(key));
+}
+function isDiagnosticTextContentType(contentType) {
+    const lower = contentType.toLowerCase();
+    if (!lower)
+        return true;
+    if (lower.includes('text/event-stream'))
+        return false;
+    return (lower.startsWith('text/') ||
+        lower.includes('json') ||
+        lower.includes('xml') ||
+        lower.includes('javascript') ||
+        lower.includes('x-www-form-urlencoded'));
+}
+async function readResponseTextBounded(response, limit) {
+    if (!response.body) {
+        const text = await response.text();
+        return { text: text.slice(0, limit), truncated: text.length > limit };
+    }
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let text = '';
+    let truncated = false;
+    try {
+        while (text.length <= limit) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            text += decoder.decode(value, { stream: true });
+            if (text.length > limit) {
+                truncated = true;
+                text = text.slice(0, limit);
+                await reader.cancel();
+                break;
+            }
+        }
+        if (!truncated)
+            text += decoder.decode();
+    }
+    finally {
+        reader.releaseLock();
+    }
+    return { text, truncated };
+}
+function fingerprintDiagnosticValue(value) {
+    return (0, node_crypto_1.createHmac)('sha256', 'adcp-transport-diagnostics').update(value).digest('hex').slice(0, 16);
+}
+//# sourceMappingURL=transportDiagnostics.js.map

package/dist/lib/protocols/transportDiagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transportDiagnostics.js","sourceRoot":"","sources":["../../../src/lib/protocols/transportDiagnostics.ts"],"names":[],"mappings":";;;AAuFA,4DAaC;AAED,oDAWC;AAED,4DAWC;AAED,8EAmEC;AAnMD,uDAAqD;AACrD,6CAAyC;AAiDzC,MAAM,kBAAkB,GAAG,EAAE,GAAG,IAAI,CAAC;AACrC,MAAM,QAAQ,GAAG,YAAY,CAAC;AAE9B,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,QAAQ;IACR,iBAAiB;IACjB,cAAc;IACd,eAAe;IACf,sBAAsB;IACtB,aAAa;IACb,YAAY;IACZ,YAAY;IACZ,iBAAiB;IACjB,mBAAmB;IACnB,kBAAkB;IAClB,cAAc;IACd,mBAAmB;CACpB,CAAC,CAAC;AAEH,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC;IACrC,eAAe;IACf,QAAQ;IACR,qBAAqB;IACrB,YAAY;IACZ,aAAa;IACb,WAAW;IACX,gBAAgB;CACjB,CAAC,CAAC;AAEH,MAAM,gBAAgB,GACpB,sIAAsI,CAAC;AACzI,MAAM,uBAAuB,GAC3B,uTAAuT,CAAC;AAC1T,MAAM,WAAW,GAAG,2BAA2B,CAAC;AAEnC,QAAA,2BAA2B,GAAG,IAAI,oCAAiB,EAA4B,CAAC;AAE7F,SAAgB,wBAAwB,CACtC,OAAsF,EACtF,EAAoB;IAEpB,IAAI,CAAC,OAAO,CAAC,mBAAmB;QAAE,OAAO,EAAE,EAAE,CAAC;IAC9C,MAAM,IAAI,GAA6B,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACnE,OAAO,mCAA2B,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE;QACtD,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzC,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAgB,oBAAoB,CAAC,KAAa;IAChD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3B,GAAG,CAAC,QAAQ,GAAG,EAAE,CAAC;QAClB,GAAG,CAAC,QAAQ,GAAG,EAAE,CAAC;QAClB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC;QAChB,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC;QACd,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,aAAa,CAAC;IACvB,CAAC;AACH,CAAC;AAED,SAAgB,wBAAwB,CAAC,OAAgC;IACvE,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;QAClD,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QAChC,IAAI,sBAAsB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACtE,GAAG,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC;QACxB,CAAC;aAAM,IAAI,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,uBAAuB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1E,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;QACrB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAgB,iCAAiC,CAAC,QAAsB;IACtE,MAAM,OAAO,GAAiB,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAClD,MAAM,IAAI,GAAG,mCAA2B,CAAC,QAAQ,EAAE,CAAC;QACpD,IAAI,CAAC,IAAI,EAAE,mBAAmB;YAAE,OAAO,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAE7D,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC/B,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAC;QACtD,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACtC,MAAM,GAAG,GAAG,oBAAoB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAChD,MAAM,cAAc,GAAG,wBAAwB,CAAC,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;QAClF,MAAM,WAAW,GAAG,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC5C,MAAM,SAAS,GAAG;YAChB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAC3E,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;YAC1D,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;YAC3C,GAAG,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;YACpD,GAAG,CAAC,IAAI,CAAC,cAAc,IAAI,EAAE,kBAAkB,EAAE,0BAA0B,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;YACnG,MAAM;YACN,GAAG;YACH,cAAc;YACd,GAAG,CAAC,WAAW,IAAI;gBACjB,WAAW,EAAE,WAAW,CAAC,IAAI;gBAC7B,oBAAoB,EAAE,WAAW,CAAC,SAAS;aAC5C,CAAC;YACF,SAAS;SACV,CAAC;QAEF,qBAAqB,CAAC,IAAI,CAAC,mBAAmB,EAAE;YAC9C,IAAI,EAAE,iBAAiB;YACvB,GAAG,SAAS;YACZ,SAAS,EAAE,SAAS;SACrB,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YAC7C,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,CAAC;YAC5C,MAAM,eAAe,GAAG,uBAAuB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAClE,MAAM,YAAY,GAAG,MAAM,mBAAmB,CAAC,QAAQ,CAAC,CAAC;YACzD,qBAAqB,CAAC,IAAI,CAAC,mBAAmB,EAAE;gBAC9C,IAAI,EAAE,mBAAmB;gBACzB,GAAG,SAAS;gBACZ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,UAAU;gBACV,UAAU,EAAE,QAAQ,CAAC,MAAM;gBAC3B,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,eAAe;gBACf,GAAG,CAAC,YAAY,IAAI;oBAClB,YAAY,EAAE,YAAY,CAAC,IAAI;oBAC/B,qBAAqB,EAAE,YAAY,CAAC,SAAS;iBAC9C,CAAC;aACH,CAAC,CAAC;YACH,OAAO,QAAQ,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,qBAAqB,CAAC,IAAI,CAAC,mBAAmB,EAAE;gBAC9C,IAAI,EAAE,gBAAgB;gBACtB,GAAG,SAAS;gBACZ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW;gBACpC,SAAS,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,KAAK;gBAC7D,YAAY,EAAE,sBAAsB,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;aAC7F,CAAC,CAAC;YACH,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,CAAC;IACF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,qBAAqB,CAAC,OAAiC,EAAE,KAAwB;IACxF,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,mCAA2B,CAAC,QAAQ,EAAE,CAAC;QACpD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;QACrD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE;aAC9B,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;aAC3B,IAAI,CACH,GAAG,EAAE,GAAE,CAAC,EACR,GAAG,EAAE,GAAE,CAAC,CACT,CAAC;QACJ,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,yDAAyD;IAC3D,CAAC;AACH,CAAC;AAED,SAAS,MAAM,CAAC,KAAwB;IACtC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,YAAY,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC;AACjG,CAAC;AAED,SAAS,SAAS,CAAC,KAAwB,EAAE,IAAkB;IAC7D,OAAO,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,KAAK,YAAY,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;AAC3F,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAwB,EAAE,IAAkB;IACvE,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,KAAK,YAAY,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAClF,IAAI,IAAI,EAAE,OAAO,EAAE,CAAC;QAClB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACvD,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,uBAAuB,CAAC,OAAgB;IAC/C,OAAO,wBAAwB,CAAC,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,aAAa,CAAC,OAAgC;IACrD,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,IAAI,OAAO,YAAY,OAAO,EAAE,CAAC;QAC/B,MAAM,OAAO,GAA4B,EAAE,CAAC;QAC5C,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;QAC5D,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;IAC/E,OAAO,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAa;IAC5C,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,OAAO,CACL,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CACpH,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,IAAiC;IACpD,IAAI,IAAI,IAAI,IAAI;QAAE,OAAO,SAAS,CAAC;IACnC,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,gBAAgB,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;IAChF,IAAI,IAAI,YAAY,eAAe;QAAE,OAAO,gBAAgB,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,kBAAkB,CAAC,CAAC;IAClG,IAAI,IAAI,YAAY,IAAI;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,IAAI,CAAC,IAAI,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACzF,IAAI,IAAI,YAAY,WAAW,EAAE,CAAC;QAChC,OAAO,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,kBAAkB,CAAC,CAAC;IAClF,CAAC;IACD,IAAI,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,OAAO,gBAAgB,CACrB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAC3E,kBAAkB,CACnB,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,QAAkB;IACnD,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;IAC/D,IAAI,CAAC,2BAA2B,CAAC,WAAW,CAAC;QAAE,OAAO,SAAS,CAAC;IAChE,IAAI,CAAC;QACH,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,MAAM,uBAAuB,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,kBAAkB,CAAC,CAAC;QAChG,OAAO,EAAE,IAAI,EAAE,yBAAyB,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY,EAAE,KAAa;IACnD,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtC,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACxD,OAAO,EAAE,IAAI,EAAE,yBAAyB,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;AACjE,CAAC;AAED,SAAS,yBAAyB,CAAC,IAAY;IAC7C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAc;IAC1C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IACjE,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;IACjE,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,GAAG,CAAC,GAAG,CAAC,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,sBAAsB,CAAC,IAAY;IAC1C,OAAO,IAAI;SACR,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;SAC1D,OAAO,CAAC,gCAAgC,EAAE,mBAAmB,CAAC;SAC9D,OAAO,CAAC,4BAA4B,EAAE,kBAAkB,CAAC;SACzD,OAAO,CAAC,uBAAuB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,GAAG,MAAM,GAAG,QAAQ,EAAE,CAAC,CAAC;AAClF,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAa;IACxC,OAAO,sBAAsB,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,aAAa,CAAC,GAAW;IAChC,OAAO,GAAG,CAAC,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;AAClE,CAAC;AAED,SAAS,cAAc,CAAC,GAAW;IACjC,OAAO,gBAAgB,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,2BAA2B,CAAC,WAAmB;IACtD,MAAM,KAAK,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC;IACxC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,IAAI,KAAK,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QAAE,OAAO,KAAK,CAAC;IACtD,OAAO,CACL,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC;QACzB,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QACtB,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC;QACrB,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC;QAC5B,KAAK,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CACxC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,uBAAuB,CACpC,QAAkB,EAClB,KAAa;IAEb,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;IACxE,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC;YAC5B,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5C,IAAI,IAAI;gBAAE,MAAM;YAChB,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YAChD,IAAI,IAAI,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;gBACxB,SAAS,GAAG,IAAI,CAAC;gBACjB,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;gBAC5B,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;gBACtB,MAAM;YACR,CAAC;QACH,CAAC;QACD,IAAI,CAAC,SAAS;YAAE,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAC3C,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,WAAW,EAAE,CAAC;IACvB,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AAC7B,CAAC;AAED,SAAS,0BAA0B,CAAC,KAAa;IAC/C,OAAO,IAAA,wBAAU,EAAC,QAAQ,EAAE,4BAA4B,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACrG,CAAC"}

package/dist/lib/schemas-data/v2.5/_provenance.json

@@ -4,5 +4,5 @@
   "source_sha": "4e553ad955f83b49c7d221ab5c3ff78237ad02e3",
   "source_tarball_sha256": "580656d6466ef9f0d1119985e6726c2efea718dc671e2ad30957fcb2fd54af0f",
   "upstream_adcp_version": "2.5.3",
-  "synced_at": "2026-06-18T12:48:20.952Z"
+  "synced_at": "2026-06-25T16:14:45.393Z"
 }

package/dist/lib/version.d.ts

@@ -1,7 +1,7 @@
 /**
  * AdCP SDK library version
  */
-export declare const LIBRARY_VERSION = "9.0.0";
+export declare const LIBRARY_VERSION = "9.1.0";
 /**
  * AdCP specification version this library is built for
  */
@@ -33,10 +33,10 @@ export type AdcpVersion = (typeof COMPATIBLE_ADCP_VERSIONS)[number];
  * Full version information
  */
 export declare const VERSION_INFO: {
-    readonly library: "9.0.0";
+    readonly library: "9.1.0";
     readonly adcp: "3.1.0";
     readonly compatibleVersions: readonly ["v2.5", "v2.6", "v3", "3.0.0-beta.1", "3.0-beta.1", "3.0-beta", "3.0.0-beta.3", "3.0-beta.3", "3.0.0", "3.0", "3.0.1", "3.0.2", "3.0.3", "3.0.4", "3.0.5", "3.0.6", "3.0.7", "3.0.8", "3.0.9", "3.0.10", "3.0.11", "3.0.12", "3.1.0", "3.1"];
-    readonly generatedAt: "2026-06-18T12:32:23.435Z";
+    readonly generatedAt: "2026-06-25T16:06:01.340Z";
 };
 /**
  * Get the AdCP specification version this library is built for

package/dist/lib/version.js

@@ -12,7 +12,7 @@ exports.toReleasePrecisionVersion = toReleasePrecisionVersion;
 /**
  * AdCP SDK library version
  */
-exports.LIBRARY_VERSION = '9.0.0';
+exports.LIBRARY_VERSION = '9.1.0';
 /**
  * AdCP specification version this library is built for
  */
@@ -60,10 +60,10 @@ exports.COMPATIBLE_ADCP_VERSIONS = [
  * Full version information
  */
 exports.VERSION_INFO = {
-    library: '9.0.0',
+    library: '9.1.0',
     adcp: '3.1.0',
     compatibleVersions: exports.COMPATIBLE_ADCP_VERSIONS,
-    generatedAt: '2026-06-18T12:32:23.435Z',
+    generatedAt: '2026-06-25T16:06:01.340Z',
 };
 /**
  * Get the AdCP specification version this library is built for

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adcp/sdk",
-  "version": "9.0.0",
+  "version": "9.1.0",
   "description": "AdCP SDK — client, server, and compliance harnesses for the AdContext Protocol (MCP + A2A)",
   "workspaces": [
     ".",
@@ -399,7 +399,7 @@
     "secure-json-parse": "^4.1.0",
     "structured-headers": "^2.0.2",
     "tldts": "^7.0.29",
-    "undici": "^6.25.0",
+    "undici": "^6.27.0",
     "ws": "^8.21.0",
     "yaml": "^2.7.1"
   },