@siteverb/webmcp 0.1.0-rc.0

package/dist/src/validation.js

@@ -0,0 +1,119 @@
+const DEFINED_TOOL = Symbol('siteverb.defined-tool');
+const STABLE_ID_PATTERN = /^[a-z][a-z0-9_-]*(?:\.[a-z][a-z0-9_-]*)+$/;
+const TOOL_NAME_PATTERN = /^[A-Za-z0-9_.-]{1,128}$/;
+function diagnostic(code, message, path, severity) {
+    return { code, message, path, severity };
+}
+function inspectParameterDescriptions(value, path, diagnostics) {
+    if (value === null || typeof value !== 'object')
+        return;
+    if (Array.isArray(value)) {
+        value.forEach((entry, index) => inspectParameterDescriptions(entry, `${path}[${index}]`, diagnostics));
+        return;
+    }
+    const record = value;
+    if (typeof record.description === 'string' && record.description.length > 150) {
+        diagnostics.push(diagnostic('parameter-description-budget', 'Parameter descriptions should stay within 150 characters for current agent clients.', `${path}.description`, 'warning'));
+    }
+    for (const [key, entry] of Object.entries(record)) {
+        inspectParameterDescriptions(entry, `${path}.${key}`, diagnostics);
+    }
+}
+function inspectAnnotations(annotations, diagnostics) {
+    if (annotations === undefined)
+        return;
+    if ((annotations.readOnlyHint !== undefined && typeof annotations.readOnlyHint !== 'boolean') ||
+        (annotations.untrustedContentHint !== undefined &&
+            typeof annotations.untrustedContentHint !== 'boolean')) {
+        diagnostics.push(diagnostic('invalid-annotations', 'WebMCP annotation hints must be booleans.', 'annotations', 'error'));
+    }
+}
+function cloneSchema(schema) {
+    if (schema === undefined)
+        return undefined;
+    const serialized = JSON.stringify(schema);
+    if (serialized === undefined) {
+        throw new TypeError('inputSchema must be JSON serializable.');
+    }
+    return JSON.parse(serialized);
+}
+function deepFreeze(value) {
+    if (value === null || typeof value !== 'object' || Object.isFrozen(value))
+        return value;
+    Object.freeze(value);
+    for (const nested of Object.values(value))
+        deepFreeze(nested);
+    return value;
+}
+export function inspectToolDefinition(definition) {
+    const diagnostics = [];
+    if (typeof definition.id !== 'string' ||
+        definition.id.length > 128 ||
+        !STABLE_ID_PATTERN.test(definition.id)) {
+        diagnostics.push(diagnostic('invalid-stable-id', 'id must be a dot-namespaced stable key such as "catalog.search-products".', 'id', 'error'));
+    }
+    if (typeof definition.name !== 'string' || !TOOL_NAME_PATTERN.test(definition.name)) {
+        diagnostics.push(diagnostic('invalid-tool-name', 'name must contain 1-128 ASCII letters, digits, underscores, hyphens, or periods.', 'name', 'error'));
+    }
+    else if (definition.name.length > 30) {
+        diagnostics.push(diagnostic('tool-name-budget', 'Tool names should stay within 30 characters for current agent clients.', 'name', 'warning'));
+    }
+    if (typeof definition.description !== 'string' || definition.description.trim() === '') {
+        diagnostics.push(diagnostic('invalid-description', 'description must be a non-empty string.', 'description', 'error'));
+    }
+    else if (definition.description.length > 500) {
+        diagnostics.push(diagnostic('description-budget', 'Tool descriptions should stay within 500 characters for current agent clients.', 'description', 'warning'));
+    }
+    if (definition.title !== undefined && typeof definition.title !== 'string') {
+        diagnostics.push(diagnostic('invalid-title', 'title must be a string when provided.', 'title', 'error'));
+    }
+    if (typeof definition.execute !== 'function') {
+        diagnostics.push(diagnostic('invalid-execute', 'execute must be a function.', 'execute', 'error'));
+    }
+    if (definition.inputSchema !== undefined &&
+        (definition.inputSchema === null ||
+            typeof definition.inputSchema !== 'object' ||
+            Array.isArray(definition.inputSchema))) {
+        diagnostics.push(diagnostic('invalid-input-schema', 'inputSchema must be a JSON Schema object when provided.', 'inputSchema', 'error'));
+    }
+    else if (definition.inputSchema !== undefined) {
+        try {
+            const serialized = JSON.stringify(definition.inputSchema);
+            if (serialized === undefined)
+                throw new TypeError('Schema serialized to undefined.');
+            inspectParameterDescriptions(definition.inputSchema, 'inputSchema', diagnostics);
+        }
+        catch {
+            diagnostics.push(diagnostic('invalid-input-schema', 'inputSchema must be JSON serializable.', 'inputSchema', 'error'));
+        }
+    }
+    inspectAnnotations(definition.annotations, diagnostics);
+    return Object.freeze(diagnostics);
+}
+export function defineTool(definition) {
+    const diagnostics = inspectToolDefinition(definition);
+    const errors = diagnostics.filter((entry) => entry.severity === 'error');
+    if (errors.length > 0) {
+        throw new TypeError(errors.map((entry) => `${entry.path}: ${entry.message}`).join('\n'));
+    }
+    const tool = {
+        ...definition,
+        ...(definition.inputSchema === undefined
+            ? {}
+            : { inputSchema: deepFreeze(cloneSchema(definition.inputSchema)) }),
+        ...(definition.annotations === undefined
+            ? {}
+            : { annotations: Object.freeze({ ...definition.annotations }) }),
+    };
+    Object.defineProperty(tool, DEFINED_TOOL, {
+        enumerable: false,
+        value: true,
+    });
+    return Object.freeze(tool);
+}
+export function isDefinedTool(value) {
+    return Boolean(value &&
+        typeof value === 'object' &&
+        value[DEFINED_TOOL] === true);
+}
+//# sourceMappingURL=validation.js.map

package/dist/src/validation.js.map

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

package/dist/src/version.d.ts

@@ -0,0 +1,2 @@
+export declare const SITEVERB_WEBMCP_VERSION = "0.1.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/src/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,UAAU,CAAC"}

package/dist/src/version.js

@@ -0,0 +1,2 @@
+export const SITEVERB_WEBMCP_VERSION = '0.1.0';
+//# sourceMappingURL=version.js.map

package/dist/src/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,uBAAuB,GAAG,OAAO,CAAC"}

package/dist/telemetry.d.ts

@@ -0,0 +1,21 @@
+import type { SiteverbOptions, TelemetryErrorClass, TelemetryEventName, TelemetryFlushReason, TelemetryStatus, TelemetryToolIdentity } from './types.js';
+interface EventFields {
+    readonly durationMs?: number;
+    readonly errorClass?: TelemetryErrorClass;
+    readonly invocationId?: string;
+    readonly sequenceIndex?: number;
+    readonly tool?: TelemetryToolIdentity;
+    readonly webmcpSupported?: boolean;
+}
+export interface TelemetryManager {
+    readonly enabled: boolean;
+    emit(event: TelemetryEventName, fields?: EventFields): void;
+    flush(reason?: TelemetryFlushReason): Promise<void>;
+    nextSequence(): number;
+    status(): TelemetryStatus;
+    dispose(): void;
+}
+export declare function createTelemetryManager(options: SiteverbOptions, webmcpSupported: boolean): TelemetryManager;
+export declare function classifyTelemetryError(error: unknown, signal: AbortSignal): TelemetryErrorClass;
+export {};
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,eAAe,EAGf,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,qBAAqB,EAEtB,MAAM,YAAY,CAAC;AAGpB,UAAU,WAAW;IACnB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,mBAAmB,CAAC;IAC1C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,qBAAqB,CAAC;IACtC,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;CACpC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,IAAI,CAAC,KAAK,EAAE,kBAAkB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAC5D,KAAK,CAAC,MAAM,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,YAAY,IAAI,MAAM,CAAC;IACvB,MAAM,IAAI,eAAe,CAAC;IAC1B,OAAO,IAAI,IAAI,CAAC;CACjB;AAkFD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,eAAe,EACxB,eAAe,EAAE,OAAO,GACvB,gBAAgB,CAyMlB;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,GAAG,mBAAmB,CAU/F"}

package/dist/telemetry.js

@@ -0,0 +1,276 @@
+import { createFetchTelemetryTransport } from './transport.js';
+import { randomId } from './id.js';
+import { SITEVERB_WEBMCP_VERSION } from './version.js';
+function resolveSessionId(siteId) {
+    const key = `__siteverb_session:${siteId}`;
+    try {
+        const existing = globalThis.sessionStorage?.getItem(key);
+        if (existing)
+            return existing;
+        const created = randomId();
+        globalThis.sessionStorage?.setItem(key, created);
+        return created;
+    }
+    catch {
+        return randomId();
+    }
+}
+function resolveRouteTemplate(route) {
+    try {
+        return typeof route === 'function' ? route() : route;
+    }
+    catch {
+        return undefined;
+    }
+}
+function boundedLabel(value, name, maxLength) {
+    if (value === undefined)
+        return undefined;
+    if (value.length === 0 || value.length > maxLength || /[\u0000-\u001f\u007f]/.test(value)) {
+        throw new TypeError(`${name} must contain 1-${maxLength} characters without controls.`);
+    }
+    return value;
+}
+function safeRouteTemplate(value) {
+    if (typeof value !== 'string' ||
+        value.length === 0 ||
+        value.length > 500 ||
+        !value.startsWith('/') ||
+        value.startsWith('//') ||
+        /[?#\u0000-\u001f\u007f]/.test(value)) {
+        return undefined;
+    }
+    return value;
+}
+function positiveInteger(value, fallback, name) {
+    if (value === undefined)
+        return fallback;
+    if (!Number.isSafeInteger(value) || value <= 0) {
+        throw new TypeError(`${name} must be a positive integer.`);
+    }
+    return value;
+}
+function report(options, diagnostic) {
+    try {
+        options.onDiagnostic?.(diagnostic);
+    }
+    catch {
+        // Diagnostics must never alter application behavior.
+    }
+}
+function disabledManager() {
+    return Object.freeze({
+        enabled: false,
+        emit: () => undefined,
+        flush: async () => undefined,
+        nextSequence: () => 0,
+        status: () => ({
+            autoRetryPaused: false,
+            consecutiveFailures: 0,
+            droppedEvents: 0,
+            enabled: false,
+            pendingEvents: 0,
+        }),
+        dispose: () => undefined,
+    });
+}
+export function createTelemetryManager(options, webmcpSupported) {
+    if (!options.telemetry)
+        return disabledManager();
+    const siteId = boundedLabel(options.siteId, 'siteId', 128);
+    if (!siteId)
+        throw new TypeError('siteId is required when telemetry is enabled.');
+    const environment = boundedLabel(options.environment, 'environment', 64);
+    const release = boundedLabel(options.release, 'release', 200);
+    const telemetry = options.telemetry;
+    const transport = telemetry.transport ??
+        (telemetry.endpoint
+            ? createFetchTelemetryTransport({ endpoint: telemetry.endpoint })
+            : (() => {
+                throw new TypeError('telemetry requires either a transport or endpoint.');
+            })());
+    const flushIntervalMs = positiveInteger(telemetry.flushIntervalMs, 5_000, 'telemetry.flushIntervalMs');
+    const maxBatchSize = positiveInteger(telemetry.maxBatchSize, 20, 'telemetry.maxBatchSize');
+    const maxQueueSize = positiveInteger(telemetry.maxQueueSize, 1_000, 'telemetry.maxQueueSize');
+    const maxRetryAttempts = positiveInteger(telemetry.maxRetryAttempts, 5, 'telemetry.maxRetryAttempts');
+    const retryMaxDelayMs = positiveInteger(telemetry.retryMaxDelayMs, 60_000, 'telemetry.retryMaxDelayMs');
+    if (maxBatchSize > maxQueueSize) {
+        throw new TypeError('telemetry.maxBatchSize cannot exceed telemetry.maxQueueSize.');
+    }
+    const pageSessionId = resolveSessionId(siteId);
+    let queue = [];
+    let pendingBatch;
+    let inFlight;
+    let timer;
+    let disposed = false;
+    let autoRetryPaused = false;
+    let consecutiveFailures = 0;
+    let droppedEvents = 0;
+    let eventIndex = 0;
+    let sequenceIndex = 0;
+    let invalidRouteTemplateReported = false;
+    const schedule = (delayMs = flushIntervalMs) => {
+        if (disposed || autoRetryPaused || timer || (queue.length === 0 && !pendingBatch))
+            return;
+        timer = setTimeout(() => {
+            timer = undefined;
+            void flush('interval').catch(() => undefined);
+        }, delayMs);
+    };
+    const emit = (event, fields = {}) => {
+        if (disposed)
+            return;
+        if (queue.length + (pendingBatch?.events.length ?? 0) >= maxQueueSize) {
+            droppedEvents += 1;
+            report(options, {
+                code: 'telemetry-dropped',
+                message: 'A Siteverb telemetry event was dropped because the bounded queue is full.',
+                severity: 'warning',
+            });
+            return;
+        }
+        const candidateRouteTemplate = resolveRouteTemplate(options.routeTemplate);
+        const routeTemplate = safeRouteTemplate(candidateRouteTemplate);
+        if (candidateRouteTemplate !== undefined &&
+            routeTemplate === undefined &&
+            !invalidRouteTemplateReported) {
+            invalidRouteTemplateReported = true;
+            report(options, {
+                code: 'telemetry-route-template-invalid',
+                message: 'Siteverb omitted an invalid route template; use a bounded pathname template without query or fragment data.',
+                severity: 'warning',
+            });
+        }
+        queue.push(Object.freeze({
+            dataClass: 'production',
+            event,
+            eventId: randomId(),
+            eventIndex: eventIndex++,
+            occurredAt: new Date().toISOString(),
+            pageSessionId,
+            ...(environment === undefined ? {} : { environment }),
+            ...(release === undefined ? {} : { release }),
+            ...(routeTemplate === undefined ? {} : { routeTemplate }),
+            ...fields,
+        }));
+        if (queue.length >= maxBatchSize)
+            void flush('size').catch(() => undefined);
+        else
+            schedule();
+    };
+    const flush = async (reason = 'manual') => {
+        if (timer) {
+            clearTimeout(timer);
+            timer = undefined;
+        }
+        if (inFlight) {
+            await inFlight;
+            if ((reason === 'manual' || reason === 'lifecycle') && queue.length > 0) {
+                return flush(reason);
+            }
+            return;
+        }
+        if (!pendingBatch && queue.length === 0)
+            return;
+        if (reason === 'manual' || reason === 'lifecycle')
+            autoRetryPaused = false;
+        const batch = pendingBatch ??
+            Object.freeze({
+                batchId: randomId(),
+                events: Object.freeze(queue.splice(0, maxBatchSize)),
+                protocolVersion: 1,
+                sdkVersion: SITEVERB_WEBMCP_VERSION,
+                sentAt: new Date().toISOString(),
+                siteId,
+            });
+        pendingBatch = batch;
+        const attempt = (async () => {
+            try {
+                await transport.send(batch, reason);
+                if (pendingBatch?.batchId === batch.batchId)
+                    pendingBatch = undefined;
+                consecutiveFailures = 0;
+                autoRetryPaused = false;
+            }
+            catch (cause) {
+                consecutiveFailures += 1;
+                autoRetryPaused = consecutiveFailures >= maxRetryAttempts;
+                report(options, {
+                    cause,
+                    code: 'telemetry-send-failed',
+                    message: autoRetryPaused
+                        ? 'Siteverb paused automatic telemetry retries; call flush() to retry the retained batch.'
+                        : 'Siteverb could not deliver a telemetry batch; the same batch will be retried.',
+                    severity: 'warning',
+                });
+                if (!autoRetryPaused) {
+                    schedule(Math.min(flushIntervalMs * 2 ** Math.max(0, consecutiveFailures - 1), retryMaxDelayMs));
+                }
+                throw cause;
+            }
+        })();
+        let trackedAttempt;
+        trackedAttempt = attempt.finally(() => {
+            if (inFlight === trackedAttempt)
+                inFlight = undefined;
+        });
+        inFlight = trackedAttempt;
+        await trackedAttempt;
+        if ((reason === 'manual' || reason === 'lifecycle') && queue.length > 0) {
+            return flush(reason);
+        }
+        schedule();
+    };
+    const lifecycleFlush = () => {
+        void flush('lifecycle').catch(() => undefined);
+    };
+    const visibilityFlush = () => {
+        if (typeof document !== 'undefined' && document.visibilityState === 'hidden')
+            lifecycleFlush();
+    };
+    globalThis.addEventListener?.('pagehide', lifecycleFlush);
+    globalThis.document?.addEventListener?.('visibilitychange', visibilityFlush);
+    const manager = {
+        enabled: true,
+        emit,
+        flush,
+        nextSequence: () => sequenceIndex++,
+        status: () => ({
+            autoRetryPaused,
+            consecutiveFailures,
+            droppedEvents,
+            enabled: true,
+            pendingEvents: queue.length + (pendingBatch?.events.length ?? 0),
+        }),
+        dispose: () => {
+            if (disposed)
+                return;
+            disposed = true;
+            if (timer)
+                clearTimeout(timer);
+            timer = undefined;
+            globalThis.removeEventListener?.('pagehide', lifecycleFlush);
+            globalThis.document?.removeEventListener?.('visibilitychange', visibilityFlush);
+            lifecycleFlush();
+        },
+    };
+    emit('surface_loaded', { webmcpSupported });
+    return Object.freeze(manager);
+}
+export function classifyTelemetryError(error, signal) {
+    if (signal.aborted || (error instanceof DOMException && error.name === 'AbortError'))
+        return 'abort';
+    const name = error instanceof Error ? error.name.toLowerCase().replaceAll(/[-_]/g, '') : '';
+    if (name === 'timeouterror')
+        return 'timeout';
+    if (name === 'networkerror')
+        return 'network';
+    if (name === 'notfounderror')
+        return 'not-found';
+    if (name === 'notallowederror' || name === 'securityerror')
+        return 'permission';
+    if (name === 'validationerror' || name === 'invalidstateerror')
+        return 'validation';
+    return 'unknown';
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/telemetry.js.map

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

package/dist/testing/index.d.ts

@@ -0,0 +1,3 @@
+export { createMemoryModelContext, createMemoryTelemetryTransport } from './memory.js';
+export type { MemoryModelContext, MemoryTelemetryTransport } from './memory.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC;AACvF,YAAY,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC"}

package/dist/testing/index.js

@@ -0,0 +1,2 @@
+export { createMemoryModelContext, createMemoryTelemetryTransport } from './memory.js';
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC"}

package/dist/testing/memory.d.ts

@@ -0,0 +1,17 @@
+import type { NativeModelContext, NativeModelContextTool, NativeRegisteredTool, TelemetryBatch, TelemetryFlushReason, TelemetryTransport } from '../types.js';
+export interface MemoryModelContext extends NativeModelContext {
+    readonly registrations: ReadonlyMap<string, NativeModelContextTool>;
+    addUninstrumentedTool(tool: NativeRegisteredTool): void;
+    executeTool(name: string, input?: Record<string, unknown>, options?: {
+        readonly signal?: AbortSignal;
+    }): Promise<unknown>;
+}
+export declare function createMemoryModelContext(): MemoryModelContext;
+export interface MemoryTelemetryTransport extends TelemetryTransport {
+    readonly batches: readonly TelemetryBatch[];
+    readonly reasons: readonly TelemetryFlushReason[];
+    failWith(error: unknown): void;
+    recover(): void;
+}
+export declare function createMemoryTelemetryTransport(): MemoryTelemetryTransport;
+//# sourceMappingURL=memory.d.ts.map

package/dist/testing/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/testing/memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,sBAAsB,EAEtB,oBAAoB,EACpB,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,kBAAmB,SAAQ,kBAAkB;IAC5D,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IACpE,qBAAqB,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACxD,WAAW,CACT,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAC1C,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB;AAED,wBAAgB,wBAAwB,IAAI,kBAAkB,CAoD7D;AAED,MAAM,WAAW,wBAAyB,SAAQ,kBAAkB;IAClE,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAClD,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/B,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,8BAA8B,IAAI,wBAAwB,CAoBzE"}

package/dist/testing/memory.js

@@ -0,0 +1,72 @@
+export function createMemoryModelContext() {
+    const registrations = new Map();
+    const uninstrumented = new Map();
+    return {
+        registrations,
+        async registerTool(tool, options) {
+            if (registrations.has(tool.name) || uninstrumented.has(tool.name)) {
+                throw new DOMException(`Tool "${tool.name}" is already registered.`, 'InvalidStateError');
+            }
+            if (options?.signal?.aborted)
+                throw options.signal.reason;
+            registrations.set(tool.name, tool);
+            options?.signal?.addEventListener('abort', () => registrations.delete(tool.name), {
+                once: true,
+            });
+        },
+        async getTools() {
+            return [
+                ...Array.from(registrations.values(), (tool) => ({
+                    name: tool.name,
+                    title: tool.title ?? '',
+                    description: tool.description,
+                    ...(tool.inputSchema === undefined ? {} : { inputSchema: tool.inputSchema }),
+                    ...(tool.annotations === undefined ? {} : { annotations: tool.annotations }),
+                })),
+                ...uninstrumented.values(),
+            ].sort((left, right) => left.name.localeCompare(right.name));
+        },
+        addUninstrumentedTool(tool) {
+            uninstrumented.set(tool.name, tool);
+        },
+        async executeTool(name, input = {}, options = {}) {
+            const tool = registrations.get(name);
+            if (!tool)
+                throw new DOMException(`Tool "${name}" was not found.`, 'NotFoundError');
+            const controller = new AbortController();
+            const onAbort = () => controller.abort(options.signal?.reason);
+            if (options.signal?.aborted)
+                onAbort();
+            else
+                options.signal?.addEventListener('abort', onAbort, { once: true });
+            try {
+                return await tool.execute(input, { signal: controller.signal });
+            }
+            finally {
+                options.signal?.removeEventListener('abort', onAbort);
+            }
+        },
+    };
+}
+export function createMemoryTelemetryTransport() {
+    const batches = [];
+    const reasons = [];
+    let failure;
+    return {
+        batches,
+        reasons,
+        send(batch, reason) {
+            if (failure !== undefined)
+                throw failure;
+            batches.push(batch);
+            reasons.push(reason);
+        },
+        failWith(error) {
+            failure = error;
+        },
+        recover() {
+            failure = undefined;
+        },
+    };
+}
+//# sourceMappingURL=memory.js.map

package/dist/testing/memory.js.map

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

package/dist/transport.d.ts

@@ -0,0 +1,7 @@
+import type { TelemetryTransport } from './types.js';
+export interface FetchTelemetryTransportOptions {
+    readonly endpoint: string;
+    readonly fetch?: typeof globalThis.fetch;
+}
+export declare function createFetchTelemetryTransport(options: FetchTelemetryTransportOptions): TelemetryTransport;
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAwC,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE3F,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CAC1C;AAyCD,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,8BAA8B,GACtC,kBAAkB,CAqBpB"}

package/dist/transport.js

@@ -0,0 +1,55 @@
+function validateEndpoint(value) {
+    if (value.length === 0 ||
+        value.length > 2_000 ||
+        value !== value.trim() ||
+        /[\u0000-\u001f\u007f]/.test(value)) {
+        throw new TypeError('Telemetry endpoint must be a bounded URL without controls.');
+    }
+    if (value.startsWith('/') && !value.startsWith('//')) {
+        const base = 'https://siteverb.invalid';
+        const resolved = new URL(value, base);
+        if (resolved.origin !== base || value.includes('?') || value.includes('#')) {
+            throw new TypeError('Telemetry endpoint must not contain query or fragment data.');
+        }
+        return value;
+    }
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        throw new TypeError('Telemetry endpoint must be a relative, HTTPS, or loopback HTTP URL.');
+    }
+    const loopback = url.hostname === 'localhost' || url.hostname === '127.0.0.1' || url.hostname === '[::1]';
+    if ((url.protocol !== 'https:' && !(url.protocol === 'http:' && loopback)) ||
+        url.username ||
+        url.password ||
+        url.search ||
+        url.hash) {
+        throw new TypeError('Telemetry endpoint must use HTTPS or loopback HTTP without credentials, query, or fragment data.');
+    }
+    return url.href;
+}
+export function createFetchTelemetryTransport(options) {
+    if (typeof options.endpoint !== 'string')
+        throw new TypeError('A telemetry endpoint is required.');
+    const endpoint = validateEndpoint(options.endpoint);
+    const fetcher = options.fetch ?? globalThis.fetch?.bind(globalThis);
+    return Object.freeze({
+        async send(batch, _reason) {
+            const body = JSON.stringify(batch);
+            if (!fetcher)
+                throw new Error('fetch is unavailable for the telemetry transport.');
+            const response = await fetcher(endpoint, {
+                body,
+                credentials: 'omit',
+                headers: { 'content-type': 'application/json' },
+                keepalive: true,
+                method: 'POST',
+            });
+            if (!response.ok)
+                throw new Error(`Telemetry endpoint returned HTTP ${response.status}.`);
+        },
+    });
+}
+//# sourceMappingURL=transport.js.map