@n24q02m/hull 0.4.0 → 0.5.0-beta.1

package/build/storage/key-pool.d.ts.map

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

package/build/storage/key-pool.js

@@ -0,0 +1,374 @@
+/**
+ * Credential rotation over one provider pool (TypeScript mirror of
+ * `hull_core/credentials/pool.py`).
+ *
+ * Failure policy:
+ *
+ * | status        | action                                                    |
+ * |---------------|-----------------------------------------------------------|
+ * | 401 / 403     | disable the credential and move to the next one            |
+ * | 429           | cool it down (`Retry-After` / `rate_limit_reset`, 1s..1h)  |
+ * | 5xx           | retry the same credential once, then move to the next one  |
+ * | anything else | release the lease and re-raise (request problem, not key)  |
+ *
+ * The pool is bounded at `credentials * (1 + max5xxRetries)` calls, and the
+ * final error carries the redacted last error text — a provider that echoes a
+ * key back cannot leak it through hull.
+ */
+export const DEFAULT_COOLDOWN_SECONDS = 60;
+export const MIN_COOLDOWN_SECONDS = 1;
+export const MAX_COOLDOWN_SECONDS = 3600;
+const DISABLE_STATUSES = new Set([401, 403]);
+const COOLDOWN_STATUSES = new Set([429]);
+/** Host -> provider identity used when config does not name one explicitly. */
+export const KNOWN_PROVIDER_HOSTS = {
+    'openrouter.ai': 'openrouter',
+    'api.openai.com': 'openai',
+    'api.anthropic.com': 'anthropic',
+    'generativelanguage.googleapis.com': 'gemini',
+    'api.cohere.com': 'cohere',
+    'api.mistral.ai': 'mistral',
+    'api.together.xyz': 'together',
+    'api.groq.com': 'groq',
+    'api.deepseek.com': 'deepseek',
+    'api.x.ai': 'xai',
+    'api.voyageai.com': 'voyage'
+};
+/**
+ * Derive the provider identity a base URL belongs to. Known hosts map to their
+ * short name; anything else becomes the lowercased host with dots replaced by
+ * hyphens. An unparseable URL falls back to `default`.
+ */
+export function providerFromBaseUrl(baseUrl) {
+    let host = '';
+    try {
+        host = new URL(baseUrl).hostname.toLowerCase();
+    }
+    catch {
+        return 'default';
+    }
+    if (!host)
+        return 'default';
+    for (const [known, provider] of Object.entries(KNOWN_PROVIDER_HOSTS)) {
+        if (host === known || host.endsWith(`.${known}`))
+            return provider;
+    }
+    return host.replaceAll('.', '-');
+}
+export class CredentialPoolError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'CredentialPoolError';
+    }
+}
+export class PoolExhaustedError extends CredentialPoolError {
+    constructor(message, details) {
+        super(message);
+        this.name = 'PoolExhaustedError';
+        this.provider = details.provider;
+        this.accountId = details.accountId ?? null;
+        this.total = details.total ?? 0;
+        this.disabled = details.disabled ?? 0;
+        this.coolingDown = details.coolingDown ?? 0;
+        this.leased = details.leased ?? 0;
+        this.retryAfter = details.retryAfter ?? null;
+        this.lastError = details.lastError ?? null;
+    }
+}
+export class CredentialExistsError extends CredentialPoolError {
+    constructor(message) {
+        super(message);
+        this.name = 'CredentialExistsError';
+    }
+}
+export class CredentialNotFoundError extends CredentialPoolError {
+    constructor(message) {
+        super(message);
+        this.name = 'CredentialNotFoundError';
+    }
+}
+export class AccountError extends CredentialPoolError {
+    constructor(message) {
+        super(message);
+        this.name = 'AccountError';
+    }
+}
+/** Map an HTTP status to `disable` / `cooldown` / `retry` / `fatal`. */
+export function classifyStatus(status) {
+    if (status === null || status === undefined)
+        return 'fatal';
+    if (DISABLE_STATUSES.has(status))
+        return 'disable';
+    if (COOLDOWN_STATUSES.has(status))
+        return 'cooldown';
+    if (status >= 500 && status < 600)
+        return 'retry';
+    return 'fatal';
+}
+function isNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value);
+}
+/** `Retry-After` as delay seconds (numeric form or HTTP-date). */
+export function parseRetryAfter(value, now = Date.now() / 1000) {
+    if (value === null || value === undefined)
+        return null;
+    if (isNumber(value))
+        return Math.max(0, value);
+    const text = String(value).trim();
+    if (!text)
+        return null;
+    const numeric = Number(text);
+    if (Number.isFinite(numeric))
+        return Math.max(0, numeric);
+    const parsed = Date.parse(text);
+    if (Number.isNaN(parsed))
+        return null;
+    return Math.max(0, parsed / 1000 - now);
+}
+/**
+ * `rate_limit_reset`/`x-ratelimit-reset` as delay seconds. Providers use two
+ * shapes: an epoch second (above 1e9) and a delta already in seconds.
+ */
+export function parseRateLimitReset(value, now = Date.now() / 1000) {
+    if (value === null || value === undefined)
+        return null;
+    let numeric;
+    if (isNumber(value)) {
+        numeric = value;
+    }
+    else {
+        const text = String(value).trim();
+        if (!text)
+            return null;
+        numeric = Number(text);
+        if (!Number.isFinite(numeric))
+            return parseRetryAfter(text, now);
+    }
+    if (numeric <= 0)
+        return 0;
+    return numeric > 1_000_000_000 ? Math.max(0, numeric - now) : numeric;
+}
+/** Cooldown for a 429: provider hint first, then the default, always clamped. */
+export function cooldownSeconds(options = {}) {
+    const now = options.now ?? Date.now() / 1000;
+    const minimum = options.minimum ?? MIN_COOLDOWN_SECONDS;
+    const maximum = options.maximum ?? MAX_COOLDOWN_SECONDS;
+    for (const candidate of [
+        parseRetryAfter(options.retryAfter, now),
+        parseRateLimitReset(options.rateLimitReset, now)
+    ]) {
+        if (candidate !== null)
+            return Math.min(maximum, Math.max(minimum, candidate));
+    }
+    return Math.min(maximum, Math.max(minimum, options.defaultSeconds ?? DEFAULT_COOLDOWN_SECONDS));
+}
+function headerValue(headers, name) {
+    if (!headers || typeof headers !== 'object')
+        return undefined;
+    const getter = headers.get;
+    if (typeof getter === 'function') {
+        const value = getter.call(headers, name);
+        if (value !== undefined && value !== null)
+            return value;
+    }
+    const record = headers;
+    const wanted = name.toLowerCase();
+    for (const [key, value] of Object.entries(record)) {
+        if (key.toLowerCase() === wanted && value !== undefined && value !== null)
+            return value;
+    }
+    return undefined;
+}
+/**
+ * Ordered, health-aware rotation over one provider's credentials. A pool is
+ * either the provider's default pool (`accountId` null) or one named account's.
+ */
+export class KeyPool {
+    constructor(store, provider, options = {}) {
+        if (typeof provider !== 'string' || !provider.trim()) {
+            throw new Error('provider must be a non-empty string');
+        }
+        const retries = options.max5xxRetries ?? 1;
+        if (retries < 0)
+            throw new Error('max5xxRetries must be >= 0');
+        const lease = options.leaseSeconds ?? 60;
+        if (lease <= 0)
+            throw new Error('leaseSeconds must be > 0');
+        this.store = store;
+        this.provider = provider.trim();
+        this.accountId = options.accountId ?? null;
+        this.max5xxRetries = retries;
+        this.leaseSeconds = lease;
+        this.clock = options.now ?? (() => store.now());
+    }
+    credentials() {
+        return this.store.poolCredentials(this.provider, this.accountId);
+    }
+    health() {
+        return this.store.poolHealth(this.provider, this.accountId);
+    }
+    toString() {
+        const total = this.store.diagnose(this.provider, this.accountId).total;
+        return `KeyPool(provider=${JSON.stringify(this.provider)}, accountId=${JSON.stringify(this.accountId)}, credentials=${total})`;
+    }
+    acquire(options = {}) {
+        const credential = this.store.leaseFirst(this.provider, this.accountId, {
+            now: this.clock(),
+            leaseSeconds: this.leaseSeconds,
+            exclude: options.exclude ?? []
+        });
+        if (credential === null)
+            throw this.exhaustedError();
+        return credential;
+    }
+    reportSuccess(credential) {
+        this.store.recordSuccess(credential.id);
+    }
+    reportFailure(credential, status, options = {}) {
+        const action = classifyStatus(status);
+        const now = this.clock();
+        if (action === 'cooldown') {
+            const until = now + cooldownSeconds({ retryAfter: options.retryAfter, rateLimitReset: options.rateLimitReset, now });
+            this.store.recordFailure(credential.id, status, { now, cooldownUntil: until });
+        }
+        else if (action === 'disable' || action === 'retry') {
+            this.store.recordFailure(credential.id, status, { now, disable: action === 'disable' });
+        }
+        else {
+            this.store.releaseLease(credential.id);
+        }
+        return action;
+    }
+    enable(credentialId) {
+        this.store.enable(credentialId);
+    }
+    /** Replace every stored key of this provider in `text` with `[redacted]`. */
+    redact(text) {
+        if (!text)
+            return '';
+        let result = text;
+        for (const credential of this.store.credentials(this.provider)) {
+            if (credential.apiKey && result.includes(credential.apiKey)) {
+                result = result.split(credential.apiKey).join('[redacted]');
+            }
+        }
+        return result;
+    }
+    /** HTTP status carried by a provider error (`ProviderError.status`). */
+    static statusOf(error) {
+        if (!error || typeof error !== 'object')
+            return null;
+        const status = error.status;
+        return typeof status === 'number' && Number.isInteger(status) ? status : null;
+    }
+    exhaustedError(lastError) {
+        const detail = this.store.diagnose(this.provider, this.accountId);
+        let message = `no usable ${JSON.stringify(this.provider)} credential`;
+        if (this.accountId !== null)
+            message += ` for account ${JSON.stringify(this.accountId)}`;
+        message += ` (total=${detail.total}, disabled=${detail.disabled}, cooling_down=${detail.coolingDown}, leased=${detail.leased}`;
+        if (detail.retryAfter !== null)
+            message += `, retry in ${Math.round(detail.retryAfter)}s`;
+        message += ')';
+        const redacted = this.redact(lastError);
+        if (redacted)
+            message += `; last error: ${redacted.slice(0, 500)}`;
+        return new PoolExhaustedError(message, {
+            provider: this.provider,
+            accountId: this.accountId,
+            total: detail.total,
+            disabled: detail.disabled,
+            coolingDown: detail.coolingDown,
+            leased: detail.leased,
+            retryAfter: detail.retryAfter,
+            lastError: redacted || null
+        });
+    }
+    run(call, options = {}) {
+        const rotation = new Rotation(this, options.statusOf ?? KeyPool.statusOf);
+        for (;;) {
+            const credential = rotation.nextCredential();
+            if (credential === null)
+                throw rotation.exhausted();
+            try {
+                const result = call(credential);
+                this.reportSuccess(credential);
+                return result;
+            }
+            catch (error) {
+                if (rotation.failed(credential, error) === 'fatal')
+                    throw error;
+            }
+        }
+    }
+    async runAsync(call, options = {}) {
+        const rotation = new Rotation(this, options.statusOf ?? KeyPool.statusOf);
+        for (;;) {
+            const credential = rotation.nextCredential();
+            if (credential === null)
+                throw rotation.exhausted();
+            try {
+                const result = await call(credential);
+                this.reportSuccess(credential);
+                return result;
+            }
+            catch (error) {
+                if (rotation.failed(credential, error) === 'fatal')
+                    throw error;
+            }
+        }
+    }
+}
+class Rotation {
+    constructor(pool, statusOf) {
+        this.attempts = 0;
+        this.retried = new Map();
+        this.skip = new Set();
+        this.lastError = null;
+        this.pool = pool;
+        this.statusOf = statusOf;
+        const total = pool.store.diagnose(pool.provider, pool.accountId).total;
+        this.limit = Math.max(1, total * (1 + pool.max5xxRetries));
+    }
+    nextCredential() {
+        if (this.attempts >= this.limit)
+            return null;
+        let credential;
+        try {
+            credential = this.pool.acquire({ exclude: [...this.skip] });
+        }
+        catch (error) {
+            if (error instanceof PoolExhaustedError)
+                return null;
+            throw error;
+        }
+        this.attempts += 1;
+        return credential;
+    }
+    failed(credential, error) {
+        const record = (error ?? {});
+        let retryAfter = record.retryAfter;
+        let rateLimitReset = record.rateLimitReset;
+        const headers = record.headers;
+        if (headers !== undefined && headers !== null) {
+            retryAfter ??= headerValue(headers, 'retry-after');
+            rateLimitReset ??= headerValue(headers, 'x-ratelimit-reset');
+        }
+        const action = this.pool.reportFailure(credential, this.statusOf(error), { retryAfter, rateLimitReset });
+        this.lastError = this.pool.redact(String(error));
+        if (action === 'retry') {
+            const count = (this.retried.get(credential.id) ?? 0) + 1;
+            this.retried.set(credential.id, count);
+            if (count > this.pool.max5xxRetries)
+                this.skip.add(credential.id);
+        }
+        else if (action === 'disable' || action === 'cooldown') {
+            this.skip.add(credential.id);
+        }
+        return action;
+    }
+    exhausted() {
+        return this.pool.exhaustedError(this.lastError);
+    }
+}
+//# sourceMappingURL=key-pool.js.map

package/build/storage/key-pool.js.map

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

package/build/storage/resolver.js

@@ -32,7 +32,7 @@ export async function resolveConfig(serverName, requiredFields, defaults) {
             return { config: { ...defaults }, source: 'defaults' };
         }
     }
-    // 4. Nothing found -- trigger relay setup
+    // 4. Nothing found -- the caller decides how to prompt for configuration
     return { config: null, source: null };
 }
 //# sourceMappingURL=resolver.js.map

package/build/storage/resolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../src/storage/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AASxD,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,UAAkB,EAClB,cAAwB,EACxB,QAAiC;IAEjC,4EAA4E;IAC5E,MAAM,SAAS,GAA2B,EAAE,CAAA;IAC5C,IAAI,aAAa,GAAG,cAAc,CAAC,MAAM,GAAG,CAAC,CAAA;IAC7C,MAAM,YAAY,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;IAClE,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,OAAO,YAAY,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAA;QAChF,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QACjC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YACxC,SAAS,CAAC,KAAK,CAAC,GAAG,KAAK,CAAA;QAC1B,CAAC;aAAM,CAAC;YACN,aAAa,GAAG,KAAK,CAAA;QACvB,CAAC;IACH,CAAC;IACD,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;IAC7C,CAAC;IAED,6EAA6E;IAC7E,MAAM,UAAU,GAAG,MAAM,gBAAgB,CAAC,UAAU,CAAC,CAAA;IACrD,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,cAAc,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,UAAU,IAAI,UAAU,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAA;QAC3F,IAAI,cAAc,EAAE,CAAC;YACnB,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,CAAA;QAC/C,CAAC;IACH,CAAC;IAED,oBAAoB;IACpB,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,cAAc,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,QAAQ,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAA;QACvF,IAAI,cAAc,EAAE,CAAC;YACnB,OAAO,EAAE,MAAM,EAAE,EAAE,GAAG,QAAQ,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAA;QACxD,CAAC;IACH,CAAC;IAED,0CAA0C;IAC1C,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;AACvC,CAAC"}
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../src/storage/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AASxD,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,UAAkB,EAClB,cAAwB,EACxB,QAAiC;IAEjC,4EAA4E;IAC5E,MAAM,SAAS,GAA2B,EAAE,CAAA;IAC5C,IAAI,aAAa,GAAG,cAAc,CAAC,MAAM,GAAG,CAAC,CAAA;IAC7C,MAAM,YAAY,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;IAClE,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,OAAO,YAAY,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAA;QAChF,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QACjC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YACxC,SAAS,CAAC,KAAK,CAAC,GAAG,KAAK,CAAA;QAC1B,CAAC;aAAM,CAAC;YACN,aAAa,GAAG,KAAK,CAAA;QACvB,CAAC;IACH,CAAC;IACD,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;IAC7C,CAAC;IAED,6EAA6E;IAC7E,MAAM,UAAU,GAAG,MAAM,gBAAgB,CAAC,UAAU,CAAC,CAAA;IACrD,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,cAAc,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,UAAU,IAAI,UAAU,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAA;QAC3F,IAAI,cAAc,EAAE,CAAC;YACnB,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,CAAA;QAC/C,CAAC;IACH,CAAC;IAED,oBAAoB;IACpB,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,cAAc,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,QAAQ,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAA;QACvF,IAAI,cAAc,EAAE,CAAC;YACnB,OAAO,EAAE,MAAM,EAAE,EAAE,GAAG,QAAQ,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAA;QACxD,CAAC;IACH,CAAC;IAED,yEAAyE;IACzE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;AACvC,CAAC"}

package/build/token-auth/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * HTTP token-table auth (`no-auth` / `token` / `multi`), the TS port of
  * core-py `hull_core.auth` + `hull_core.limits`. Self-contained: nothing
- * here imports the relay, OAuth, or transport modules.
+ * here imports the transport modules.
  */
 export { AuthConfigError, Authenticator, type AuthOutcome, defaultUsersFile, HTTP_AUTH_MODES, type HttpAuthConfig, parseBearer } from './authenticator.js';
 export { type TokenCliHandler, type TokenCliIO, tokenCliHandler } from './cli.js';

package/build/token-auth/index.js

@@ -1,7 +1,7 @@
 /**
  * HTTP token-table auth (`no-auth` / `token` / `multi`), the TS port of
  * core-py `hull_core.auth` + `hull_core.limits`. Self-contained: nothing
- * here imports the relay, OAuth, or transport modules.
+ * here imports the transport modules.
  */
 export { AuthConfigError, Authenticator, defaultUsersFile, HTTP_AUTH_MODES, parseBearer } from './authenticator.js';
 export { tokenCliHandler } from './cli.js';

package/build/transport/index.d.ts

@@ -1,5 +1,4 @@
 export type { HttpAuthConfig } from '../token-auth/authenticator.js';
-export { type HttpRoute, type HttpServerHandle, type JWTClaims, type RunHttpServerOptions, runHttpServer } from './local-server.js';
-export { type AuthenticatedRequest, OAuthMiddleware, type OAuthMiddlewareOptions } from './oauth-middleware.js';
+export { type HttpRoute, type HttpServerHandle, jsonResponse, type RunHttpServerOptions, runHttpServer } from './local-server.js';
 export { StreamableHTTPServer, type StreamableHTTPServerOptions } from './streamable-http.js';
 //# sourceMappingURL=index.d.ts.map

package/build/transport/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AACpE,OAAO,EACL,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,oBAAoB,EACzB,aAAa,EACd,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,KAAK,oBAAoB,EACzB,eAAe,EACf,KAAK,sBAAsB,EAC5B,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EACL,oBAAoB,EACpB,KAAK,2BAA2B,EACjC,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AACpE,OAAO,EACL,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,YAAY,EACZ,KAAK,oBAAoB,EACzB,aAAa,EACd,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,oBAAoB,EACpB,KAAK,2BAA2B,EACjC,MAAM,sBAAsB,CAAA"}

package/build/transport/index.js

@@ -1,4 +1,3 @@
-export { runHttpServer } from './local-server.js';
-export { OAuthMiddleware } from './oauth-middleware.js';
+export { jsonResponse, runHttpServer } from './local-server.js';
 export { StreamableHTTPServer } from './streamable-http.js';
 //# sourceMappingURL=index.js.map

package/build/transport/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,aAAa,EACd,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAEL,eAAe,EAEhB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EACL,oBAAoB,EAErB,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,YAAY,EAEZ,aAAa,EACd,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,oBAAoB,EAErB,MAAM,sBAAsB,CAAA"}