toolcraft 0.0.309 → 0.0.311

package/node_modules/tiny-http-mcp-server/node_modules/mcp-oauth/dist/client/default-oauth-client-provider.js

@@ -7,6 +7,7 @@ import { createAuthorizationState } from "./authorization-state.js";
 import { generateCodeChallenge, generateCodeVerifier } from "./pkce.js";
 import { exchangeAuthorizationCode, OAuthError, refreshAccessToken, isRetryableOAuthError, readOAuthJsonObjectResponse } from "./token-endpoint.js";
 import { canonicalizeResourceIndicator } from "../resource-indicator.js";
+import { withOAuthSessionTransaction } from "./session-transaction.js";
 const MAX_JS_DATE_MS = 8_640_000_000_000_000;
 export function createOAuthClientProvider(options) {
     if (isProviderOptions(options)) {
@@ -20,8 +21,6 @@ export function createDefaultOAuthClientProvider(options) {
     const clientStore = options.authStore === undefined ? null : createAuthStoreClientStore(options.authStore);
     const now = options.now ?? Date.now;
     const registeredClients = new Map();
-    const refreshPromises = new Map();
-    const authorizationPromises = new Map();
     if (options.initialGrant !== undefined) {
         let resource;
         try {
@@ -58,7 +57,7 @@ export function createDefaultOAuthClientProvider(options) {
             if (session === null && !initialGrantConsumed && initialGrant?.resource === requestUrl &&
                 initialGrant.tokens !== undefined && !isExpired(initialGrant.tokens, now)) {
                 input.headers.set("Authorization", `Bearer ${initialGrant.tokens.accessToken}`);
-                return;
+                return { ...initialGrant.tokens };
             }
             if (session === null ||
                 accessToken === undefined ||
@@ -68,6 +67,7 @@ export function createDefaultOAuthClientProvider(options) {
             }
             assertRequestMatchesResource(requestUrl, session.resource);
             input.headers.set("Authorization", `Bearer ${accessToken}`);
+            return { ...session.tokens };
         },
         async handleUnauthorized(input) {
             try {
@@ -75,12 +75,28 @@ export function createDefaultOAuthClientProvider(options) {
                 const requestUrl = canonicalizeResourceIndicator(input.requestUrl);
                 const resource = canonicalizeResourceIndicator(input.discovery.resource);
                 assertRequestMatchesResource(requestUrl, resource);
-                const forceRefresh = (hasCachedAccessToken(await loadSession(resource)) || (!initialGrantConsumed && initialGrant?.resource === resource)) &&
-                    input.challenge?.params.error === "invalid_token";
+                const cached = await loadSession(resource);
+                const currentTokens = cached?.tokens ?? (!initialGrantConsumed && initialGrant?.resource === resource ? initialGrant.tokens : undefined);
+                let rejectedCurrentGrant = hasCachedAccessToken(cached) || (!initialGrantConsumed && initialGrant?.resource === resource);
+                let presentedTokens = input.presentedTokens;
+                if (input.presentedTokens !== undefined) {
+                    rejectedCurrentGrant = false;
+                    if (input.presentedTokens !== null) {
+                        const presented = normalizeStoredTokens(input.presentedTokens);
+                        const header = input.requestHeaders?.get("Authorization") ?? "";
+                        const separator = header.indexOf(" ");
+                        if (presented === undefined || header.slice(0, separator).toLowerCase() !== "bearer" || header.slice(separator + 1).trim() !== presented.accessToken)
+                            throw new Error("OAuth rejected-request provenance does not match its authorization header");
+                        presentedTokens = presented;
+                        rejectedCurrentGrant = currentTokens !== undefined && sameTokenGrant(currentTokens, presented);
+                    }
+                }
+                const challengeError = input.challenge?.params.error;
+                const forceRefresh = rejectedCurrentGrant && (challengeError === "invalid_token" || (input.presentedTokens !== undefined && challengeError === undefined));
                 const session = await ensureAuthorizedSession(resource, {
                     ...input.discovery,
                     resource
-                }, input.fetch, true, forceRefresh, input.signal);
+                }, input.fetch, true, forceRefresh, input.signal, presentedTokens);
                 if (session?.tokens?.accessToken === undefined) {
                     return { action: "fail" };
                 }
@@ -95,206 +111,199 @@ export function createDefaultOAuthClientProvider(options) {
             }
         }
     };
-    async function ensureAuthorizedSession(resource, discovery, fetch, allowInteractive, forceRefresh = false, signal) {
+    async function ensureAuthorizedSession(resource, discovery, fetch, allowInteractive, forceRefresh = false, signal, rejectedTokens) {
         signal?.throwIfAborted();
         const canonicalResource = canonicalizeResourceIndicator(resource);
-        let session = await loadSession(canonicalResource);
-        if (session !== null && initialGrant?.resource === canonicalResource)
-            initialGrantConsumed = true;
-        signal?.throwIfAborted();
-        if (discovery !== undefined && getOwnString(discovery.authorizationServerMetadata, "issuer") !== discovery.authorizationServer) {
-            throw new Error("OAuth discovery authorization-server issuer mismatch");
-        }
-        if (session !== null && (canonicalizeResourceIndicator(session.resource) !== canonicalResource
-            || getOwnString(session.discovery.authorizationServerMetadata, "issuer") !== session.authorizationServer
-            || (discovery !== undefined && discovery.authorizationServer !== session.authorizationServer))) {
-            await clearSession(canonicalResource);
-            session = null;
-        }
-        if (session === null && discovery !== undefined && !initialGrantConsumed && initialGrant?.resource === canonicalResource &&
-            initialGrant.tokens !== undefined && initialGrant.client !== null) {
-            assertSecureOAuthFlowEndpoints(discovery.authorizationServerMetadata);
-            session = { resource: canonicalResource, authorizationServer: discovery.authorizationServer,
-                client: initialGrant.client, tokens: initialGrant.tokens, discovery: toStoredDiscovery(discovery) };
-            await saveSession(canonicalResource, session);
-            initialGrantConsumed = true;
+        return withOAuthSessionTransaction(sessionStore, canonicalResource, async () => {
+            let session = await loadSession(canonicalResource);
+            if (session !== null && initialGrant?.resource === canonicalResource)
+                initialGrantConsumed = true;
             signal?.throwIfAborted();
-        }
-        const sessionDiscovery = resolveDiscovery(discovery, session);
-        if (session?.tokens !== undefined && !forceRefresh && !isExpired(session.tokens, now)) {
-            return session;
-        }
-        if (session?.tokens?.refreshToken !== undefined &&
-            sessionDiscovery !== undefined &&
-            (forceRefresh || isExpired(session.tokens, now))) {
-            session = await refreshSession(canonicalResource, session, sessionDiscovery, fetch, signal);
-            if (session?.tokens !== undefined && !isExpired(session.tokens, now)) {
+            if (discovery !== undefined && getOwnString(discovery.authorizationServerMetadata, "issuer") !== discovery.authorizationServer) {
+                throw new Error("OAuth discovery authorization-server issuer mismatch");
+            }
+            if (session !== null && (canonicalizeResourceIndicator(session.resource) !== canonicalResource
+                || getOwnString(session.discovery.authorizationServerMetadata, "issuer") !== session.authorizationServer
+                || (discovery !== undefined && discovery.authorizationServer !== session.authorizationServer))) {
+                await clearSession(canonicalResource);
+                session = null;
+            }
+            if (session === null && discovery !== undefined && !initialGrantConsumed && initialGrant?.resource === canonicalResource &&
+                initialGrant.tokens !== undefined && initialGrant.client !== null) {
+                assertSecureOAuthFlowEndpoints(discovery.authorizationServerMetadata);
+                session = { resource: canonicalResource, authorizationServer: discovery.authorizationServer,
+                    client: initialGrant.client, tokens: initialGrant.tokens, discovery: toStoredDiscovery(discovery) };
+                await saveSession(canonicalResource, session);
+                initialGrantConsumed = true;
+                signal?.throwIfAborted();
+            }
+            if (forceRefresh && rejectedTokens !== undefined && (rejectedTokens === null || session?.tokens === undefined || !sameTokenGrant(session.tokens, rejectedTokens)))
+                forceRefresh = false;
+            const sessionDiscovery = resolveDiscovery(discovery, session);
+            if (session?.refreshState === "pending") {
+                if (!allowInteractive || options.allowInteractive === false || sessionDiscovery === undefined)
+                    throw new Error("OAuth refresh outcome is unknown; authorize again before using this resource");
+                return authorizeSession(canonicalResource, clearSessionTokens(session), sessionDiscovery, fetch, signal);
+            }
+            if (session?.tokens !== undefined && !forceRefresh && !isExpired(session.tokens, now)) {
                 return session;
             }
-        }
-        if (forceRefresh && session?.tokens !== undefined) {
-            session = clearSessionTokens(session);
-            await saveSession(canonicalResource, session);
-        }
-        if (!allowInteractive || sessionDiscovery === undefined) {
-            return session;
-        }
-        if (options.allowInteractive === false)
-            throw new Error("OAuth interactive authorization is disabled");
-        return authorizeSession(canonicalResource, session, sessionDiscovery, fetch, signal);
+            if (session?.tokens?.refreshToken !== undefined &&
+                sessionDiscovery !== undefined &&
+                (forceRefresh || isExpired(session.tokens, now))) {
+                session = await refreshSession(canonicalResource, session, sessionDiscovery, fetch, signal);
+                if (session?.tokens !== undefined && !isExpired(session.tokens, now)) {
+                    return session;
+                }
+            }
+            if (forceRefresh && session?.tokens !== undefined) {
+                session = clearSessionTokens(session);
+                await saveSession(canonicalResource, session);
+            }
+            if (!allowInteractive || sessionDiscovery === undefined) {
+                return session;
+            }
+            if (options.allowInteractive === false)
+                throw new Error("OAuth interactive authorization is disabled");
+            return authorizeSession(canonicalResource, session, sessionDiscovery, fetch, signal);
+        }, { signal, timeoutMs: options.sessionLockTimeoutMs });
     }
     async function refreshSession(resource, session, discovery, fetch, signal) {
         signal?.throwIfAborted();
         assertSecureOAuthFlowEndpoints(discovery.authorizationServerMetadata);
-        const inFlight = refreshPromises.get(resource);
-        if (inFlight !== undefined) {
-            return inFlight;
+        if (session.tokens?.refreshToken === undefined) {
+            return session;
         }
-        const promise = (async () => {
+        const pendingSession = { ...clearSessionTokens(session), refreshState: "pending" };
+        await saveSession(resource, pendingSession);
+        signal?.throwIfAborted();
+        let refreshAttempted = false;
+        let refreshedTokens;
+        while (true) {
             try {
-                if (session.tokens?.refreshToken === undefined) {
-                    return session;
+                refreshedTokens = await refreshAccessToken({
+                    tokenEndpoint: requireOwnString(discovery.authorizationServerMetadata, "token_endpoint", "Authorization server metadata"),
+                    clientId: session.client.clientId,
+                    clientSecret: session.client.clientSecret,
+                    refreshToken: session.tokens.refreshToken,
+                    resource,
+                    fetch, signal,
+                    now
+                });
+                break;
+            }
+            catch (error) {
+                signal?.throwIfAborted();
+                // Network errors, lost/malformed bodies and gateway failures cannot
+                // establish whether a rotating refresh token was already consumed.
+                if (!(error instanceof OAuthError) || !error.outcomeKnown)
+                    throw error;
+                if (error.error === "invalid_grant") {
+                    const clearedSession = clearSessionTokens(session);
+                    await saveSession(resource, clearedSession);
+                    return clearedSession;
                 }
-                let refreshAttempted = false;
-                let refreshedTokens;
-                while (true) {
-                    try {
-                        refreshedTokens = await refreshAccessToken({
-                            tokenEndpoint: requireOwnString(discovery.authorizationServerMetadata, "token_endpoint", "Authorization server metadata"),
-                            clientId: session.client.clientId,
-                            clientSecret: session.client.clientSecret,
-                            refreshToken: session.tokens.refreshToken,
-                            resource,
-                            fetch, signal,
-                            now
-                        });
-                        break;
-                    }
-                    catch (error) {
-                        signal?.throwIfAborted();
-                        if (error instanceof OAuthError && error.error === "invalid_grant") {
-                            const clearedSession = clearSessionTokens(session);
-                            await saveSession(resource, clearedSession);
-                            return clearedSession;
-                        }
-                        if (shouldReRegisterStoredDynamicClient(error, await loadRegisteredClient(discovery.authorizationServer), false)) {
-                            await clearRegisteredClient(discovery.authorizationServer);
-                            await clearSession(resource);
-                            return null;
-                        }
-                        if (!refreshAttempted && isRetryableOAuthError(error)) {
-                            refreshAttempted = true;
-                            continue;
-                        }
-                        throw error;
-                    }
+                if (shouldReRegisterStoredDynamicClient(error, await loadRegisteredClient(discovery.authorizationServer), false)) {
+                    await clearRegisteredClient(discovery.authorizationServer);
+                    await clearSession(resource);
+                    return null;
                 }
-                const updatedSession = {
-                    ...session,
-                    tokens: {
-                        ...refreshedTokens,
-                        refreshToken: refreshedTokens.refreshToken ?? session.tokens.refreshToken
-                    },
-                    discovery: toStoredDiscovery(discovery)
-                };
-                await saveSession(resource, updatedSession);
-                return updatedSession;
-            }
-            finally {
-                refreshPromises.delete(resource);
+                if (!refreshAttempted && isRetryableOAuthError(error)) {
+                    refreshAttempted = true;
+                    continue;
+                }
+                await saveSession(resource, session);
+                throw error;
             }
-        })();
-        refreshPromises.set(resource, promise);
-        return promise;
+        }
+        const updatedSession = {
+            ...session,
+            tokens: {
+                ...refreshedTokens,
+                refreshToken: refreshedTokens.refreshToken ?? session.tokens.refreshToken
+            },
+            discovery: toStoredDiscovery(discovery)
+        };
+        await saveSession(resource, updatedSession);
+        return updatedSession;
     }
     async function authorizeSession(resource, existingSession, discovery, fetch, signal) {
         signal?.throwIfAborted();
-        const inFlight = authorizationPromises.get(resource);
-        if (inFlight !== undefined) {
-            return inFlight;
-        }
-        const promise = (async () => {
-            assertS256PkceSupport(discovery.authorizationServerMetadata);
-            assertSecureOAuthFlowEndpoints(discovery.authorizationServerMetadata);
-            let currentSession = existingSession;
-            let transientRetryAttempted = false;
-            let reRegistrationAttempted = false;
-            while (true) {
-                const loopback = await createLoopbackAuthorizationSession({
-                    openBrowser: options.browser.openBrowser,
-                    readLine: options.browser.readLine,
-                    createServer: options.browser.createServer,
-                    landingPage: options.browser.landingPage,
-                    redirectUri: options.browser.redirectUri,
-                    signal: options.browser.signal === undefined ? signal : signal === undefined ? options.browser.signal : AbortSignal.any([signal, options.browser.signal]),
-                    timeoutMs: options.browser.timeoutMs
+        assertS256PkceSupport(discovery.authorizationServerMetadata);
+        assertSecureOAuthFlowEndpoints(discovery.authorizationServerMetadata);
+        let currentSession = existingSession;
+        let transientRetryAttempted = false;
+        let reRegistrationAttempted = false;
+        while (true) {
+            const loopback = await createLoopbackAuthorizationSession({
+                openBrowser: options.browser.openBrowser,
+                readLine: options.browser.readLine,
+                createServer: options.browser.createServer,
+                landingPage: options.browser.landingPage,
+                redirectUri: options.browser.redirectUri,
+                signal: options.browser.signal === undefined ? signal : signal === undefined ? options.browser.signal : AbortSignal.any([signal, options.browser.signal]),
+                timeoutMs: options.browser.timeoutMs
+            });
+            let resolvedClient = null;
+            try {
+                resolvedClient = await resolveClient(currentSession, discovery, loopback.redirectUri, fetch, signal);
+                const sessionWithoutTokens = {
+                    resource,
+                    authorizationServer: discovery.authorizationServer,
+                    client: resolvedClient.client,
+                    discovery: toStoredDiscovery(discovery)
+                };
+                await saveSession(resource, sessionWithoutTokens);
+                const verifier = generateCodeVerifier();
+                const challenge = generateCodeChallenge(verifier);
+                const authorizationUrl = buildAuthorizationUrl({
+                    metadata: discovery.authorizationServerMetadata,
+                    resource,
+                    clientId: resolvedClient.client.clientId,
+                    redirectUri: loopback.redirectUri,
+                    codeChallenge: challenge,
+                    clientMetadata: getClientMetadata(options.client)
                 });
-                let resolvedClient = null;
-                try {
-                    resolvedClient = await resolveClient(currentSession, discovery, loopback.redirectUri, fetch, signal);
-                    const sessionWithoutTokens = {
-                        resource,
-                        authorizationServer: discovery.authorizationServer,
-                        client: resolvedClient.client,
-                        discovery: toStoredDiscovery(discovery)
-                    };
-                    await saveSession(resource, sessionWithoutTokens);
-                    const verifier = generateCodeVerifier();
-                    const challenge = generateCodeChallenge(verifier);
-                    const authorizationUrl = buildAuthorizationUrl({
-                        metadata: discovery.authorizationServerMetadata,
-                        resource,
-                        clientId: resolvedClient.client.clientId,
-                        redirectUri: loopback.redirectUri,
-                        codeChallenge: challenge,
-                        clientMetadata: getClientMetadata(options.client)
-                    });
-                    const code = await loopback.waitForCode(authorizationUrl);
-                    const tokens = await exchangeAuthorizationCode({
-                        tokenEndpoint: requireOwnString(discovery.authorizationServerMetadata, "token_endpoint", "Authorization server metadata"),
-                        clientId: resolvedClient.client.clientId,
-                        clientSecret: resolvedClient.client.clientSecret,
-                        code,
-                        codeVerifier: verifier,
-                        redirectUri: loopback.redirectUri,
-                        resource,
-                        fetch, signal,
-                        now
-                    });
-                    const session = {
-                        ...sessionWithoutTokens,
-                        tokens
-                    };
-                    await saveSession(resource, session);
-                    return session;
-                }
-                catch (error) {
-                    signal?.throwIfAborted();
-                    if (shouldReRegisterStoredDynamicClient(error, resolvedClient, reRegistrationAttempted)) {
-                        reRegistrationAttempted = true;
-                        await clearRegisteredClient(discovery.authorizationServer);
-                        await clearSession(resource);
-                        currentSession = null;
-                        continue;
-                    }
-                    if (!transientRetryAttempted && isRetryableOAuthError(error)) {
-                        transientRetryAttempted = true;
-                        await clearSession(resource);
-                        currentSession = null;
-                        continue;
-                    }
-                    throw error;
+                const code = await loopback.waitForCode(authorizationUrl);
+                const tokens = await exchangeAuthorizationCode({
+                    tokenEndpoint: requireOwnString(discovery.authorizationServerMetadata, "token_endpoint", "Authorization server metadata"),
+                    clientId: resolvedClient.client.clientId,
+                    clientSecret: resolvedClient.client.clientSecret,
+                    code,
+                    codeVerifier: verifier,
+                    redirectUri: loopback.redirectUri,
+                    resource,
+                    fetch, signal,
+                    now
+                });
+                const session = {
+                    ...sessionWithoutTokens,
+                    tokens
+                };
+                await saveSession(resource, session);
+                return session;
+            }
+            catch (error) {
+                signal?.throwIfAborted();
+                if (shouldReRegisterStoredDynamicClient(error, resolvedClient, reRegistrationAttempted)) {
+                    reRegistrationAttempted = true;
+                    await clearRegisteredClient(discovery.authorizationServer);
+                    await clearSession(resource);
+                    currentSession = null;
+                    continue;
                 }
-                finally {
-                    loopback.close();
+                if (!transientRetryAttempted && isRetryableOAuthError(error)) {
+                    transientRetryAttempted = true;
+                    await clearSession(resource);
+                    currentSession = null;
+                    continue;
                 }
+                throw error;
             }
-        })();
-        const finalPromise = promise.finally(() => {
-            authorizationPromises.delete(resource);
-        });
-        authorizationPromises.set(resource, finalPromise);
-        return finalPromise;
+            finally {
+                loopback.close();
+            }
+        }
     }
     async function resolveClient(existingSession, discovery, redirectUri, fetch, parentSignal) {
         parentSignal?.throwIfAborted();
@@ -454,9 +463,14 @@ function resolveDiscovery(discovery, session) {
         authorizationServerMetadata: metadata
     };
 }
+function sameTokenGrant(left, right) {
+    return left.accessToken === right.accessToken && left.refreshToken === right.refreshToken &&
+        left.tokenType === right.tokenType && left.expiresAt === right.expiresAt && left.scope === right.scope;
+}
 function clearSessionTokens(session) {
     const nextSession = { ...session };
     delete nextSession.tokens;
+    delete nextSession.refreshState;
     return nextSession;
 }
 function hasCachedAccessToken(session) {
@@ -466,6 +480,9 @@ function normalizeLoadedSession(session) {
     if (session === null) {
         return null;
     }
+    const refreshState = getOwnEntry(session, "refreshState");
+    if (refreshState !== undefined && (refreshState !== "pending" || getOwnEntry(session, "tokens") !== undefined))
+        throw new Error("Stored OAuth refresh state is invalid");
     const client = normalizeStoredClient(getOwnEntry(session, "client"));
     if (client === null) {
         return { ...session, client: { clientId: "" }, tokens: undefined };

package/node_modules/tiny-http-mcp-server/node_modules/mcp-oauth/dist/client/session-transaction.d.ts

@@ -0,0 +1,6 @@
+import type { OAuthSessionStore } from "./types.js";
+/** Serialize the complete read/redeem/write operation, with independent cancellation for waiters. */
+export declare function withOAuthSessionTransaction<T>(store: OAuthSessionStore, resource: string, operation: () => Promise<T>, options?: {
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}): Promise<T>;

package/node_modules/tiny-http-mcp-server/node_modules/mcp-oauth/dist/client/session-transaction.js

@@ -0,0 +1,42 @@
+const queues = new WeakMap();
+/** Serialize the complete read/redeem/write operation, with independent cancellation for waiters. */
+export async function withOAuthSessionTransaction(store, resource, operation, options = {}) {
+    const timeoutMs = options.timeoutMs ?? 30_000;
+    if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 1 || timeoutMs > 2_147_483_647)
+        throw new Error("sessionLockTimeoutMs must be an integer from 1 to 2147483647 milliseconds");
+    options.signal?.throwIfAborted();
+    const started = performance.now();
+    const pending = queues.get(store) ?? new Map();
+    queues.set(store, pending);
+    const previous = pending.get(resource) ?? Promise.resolve();
+    let release;
+    const current = new Promise(resolve => { release = resolve; });
+    const tail = previous.then(() => current);
+    pending.set(resource, tail);
+    try {
+        let timer;
+        let rejectWait;
+        const waiting = new Promise((resolve, reject) => { rejectWait = reject; previous.then(resolve, reject); });
+        const abort = () => rejectWait(options.signal?.reason);
+        try {
+            timer = setTimeout(() => rejectWait(new Error("Timed out waiting for OAuth session transaction lock")), timeoutMs);
+            options.signal?.addEventListener("abort", abort, { once: true });
+            if (options.signal?.aborted)
+                abort();
+            await waiting;
+        }
+        finally {
+            clearTimeout(timer);
+            options.signal?.removeEventListener("abort", abort);
+        }
+        options.signal?.throwIfAborted();
+        return store.withLock === undefined ? await operation() : await store.withLock(resource, operation, {
+            signal: options.signal, timeoutMs: Math.max(0, timeoutMs - (performance.now() - started))
+        });
+    }
+    finally {
+        release();
+        void tail.then(() => { if (pending.get(resource) === tail)
+            pending.delete(resource); });
+    }
+}

package/node_modules/tiny-http-mcp-server/node_modules/mcp-oauth/dist/client/token-endpoint.d.ts

@@ -13,7 +13,9 @@ export declare class OAuthError extends Error {
     readonly status: number;
     readonly retryable: boolean;
     readonly terminal: boolean;
-    constructor(shape: OAuthErrorShape, status: number);
+    /** True only when a complete OAuth error response establishes rejection. */
+    readonly outcomeKnown: boolean;
+    constructor(shape: OAuthErrorShape, status: number, outcomeKnown?: boolean);
 }
 export declare function isRetryableOAuthError(error: unknown): error is OAuthError;
 export declare function exchangeAuthorizationCode(input: {

package/node_modules/tiny-http-mcp-server/node_modules/mcp-oauth/dist/client/token-endpoint.js

@@ -11,7 +11,9 @@ export class OAuthError extends Error {
     status;
     retryable;
     terminal;
-    constructor(shape, status) {
+    /** True only when a complete OAuth error response establishes rejection. */
+    outcomeKnown;
+    constructor(shape, status, outcomeKnown = true) {
         super(shape.error_description ?? shape.error);
         this.name = "OAuthError";
         this.error = shape.error;
@@ -22,6 +24,7 @@ export class OAuthError extends Error {
         this.status = status;
         this.retryable = isRetryableOAuthError(this);
         this.terminal = !this.retryable;
+        this.outcomeKnown = outcomeKnown;
     }
 }
 export function isRetryableOAuthError(error) {
@@ -147,7 +150,8 @@ export async function readOAuthJsonObjectResponse(response, signal) {
     }
     const record = payload;
     if (!response.ok) {
-        throw new OAuthError(readOAuthError(record, fallbackError.error), response.status);
+        const error = getOwnEntry(record, "error");
+        throw new OAuthError(readOAuthError(record, fallbackError.error), response.status, typeof error === "string" && error.trim().length > 0);
     }
     return record;
 }
@@ -166,7 +170,7 @@ function getOwnEntry(record, key) {
 }
 function createFallbackOAuthError(status) {
     const error = status === 503 ? "temporarily_unavailable" : "server_error";
-    return new OAuthError({ error }, status);
+    return new OAuthError({ error }, status, false);
 }
 function normalizeBearerTokenType(value) {
     if (typeof value !== "string") {

package/node_modules/tiny-http-mcp-server/node_modules/mcp-oauth/dist/client/types.d.ts

@@ -33,7 +33,7 @@ export interface OAuthClientProvider {
         headers: Headers;
         fetch: OAuthMetadataFetch;
         signal?: AbortSignal;
-    }): Promise<void> | void;
+    }): Promise<StoredOAuthTokens | void> | StoredOAuthTokens | void;
     handleUnauthorized(input: {
         requestUrl: URL;
         response: Response;
@@ -41,6 +41,10 @@ export interface OAuthClientProvider {
         discovery: OAuthDiscoveryResult;
         fetch: OAuthMetadataFetch;
         signal?: AbortSignal;
+        /** Headers actually attached to this rejected request. */
+        requestHeaders?: Headers;
+        /** Owned snapshot returned when this request was authorized, or null if absent. */
+        presentedTokens?: StoredOAuthTokens | null;
     }): Promise<{
         action: "retry";
     } | {
@@ -74,6 +78,8 @@ export interface StoredOAuthSession {
         clientSecret?: string;
     };
     tokens?: StoredOAuthTokens;
+    /** A refresh was begun; its winning response may not have been persisted. */
+    refreshState?: "pending";
     discovery: {
         resourceMetadataUrl: string;
         resourceMetadata: Record<string, unknown>;
@@ -84,6 +90,11 @@ export interface OAuthSessionStore {
     load(resource: string): Promise<StoredOAuthSession | null>;
     save(resource: string, session: StoredOAuthSession): Promise<void>;
     clear(resource: string): Promise<void>;
+    /** Backend-wide lock covering a complete read/redeem/write transaction. */
+    withLock?<T>(resource: string, operation: () => Promise<T>, options: {
+        signal?: AbortSignal;
+        timeoutMs: number;
+    }): Promise<T>;
 }
 export interface DefaultOAuthClientProviderOptions {
     client: {
@@ -99,6 +110,8 @@ export interface DefaultOAuthClientProviderOptions {
     };
     /** Disable interactive authorization while allowing cached tokens and silent refresh. */
     allowInteractive?: boolean;
+    /** Maximum wait to acquire a session transaction lock (default 30,000 ms). */
+    sessionLockTimeoutMs?: number;
     /** Import an existing grant for one resource. Persisted sessions take precedence. */
     initialGrant?: {
         resource: string;

package/node_modules/tiny-http-mcp-server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tiny-http-mcp-server",
-  "version": "0.1.24",
+  "version": "0.1.28",
   "description": "Minimal MCP server over HTTP built on tiny-stdio-mcp-server",
   "type": "module",
   "main": "dist/index.js",