@frontmcp/auth 1.7.1 → 1.8.0

package/esm/index.mjs

@@ -537,26 +537,78 @@ function checkIpv4(ip) {
   }
   return { allowed: true, reason: "" };
 }
+function expandIpv6(ip) {
+  let text = ip.toLowerCase();
+  if (text.includes("%")) {
+    text = text.slice(0, text.indexOf("%"));
+  }
+  const dottedQuad = text.match(/^(.*:)(\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3})$/);
+  if (dottedQuad) {
+    const octets = dottedQuad[2].split(".").map(Number);
+    if (octets.some((octet) => !Number.isInteger(octet) || octet < 0 || octet > 255)) return null;
+    const high = (octets[0] << 8 | octets[1]).toString(16);
+    const low = (octets[2] << 8 | octets[3]).toString(16);
+    text = `${dottedQuad[1]}${high}:${low}`;
+  }
+  const halves = text.split("::");
+  if (halves.length > 2) return null;
+  const parseGroups = (part) => {
+    if (part === "") return [];
+    const groups = [];
+    for (const group of part.split(":")) {
+      if (!/^[0-9a-f]{1,4}$/.test(group)) return null;
+      groups.push(parseInt(group, 16));
+    }
+    return groups;
+  };
+  const head = parseGroups(halves[0]);
+  if (head === null) return null;
+  if (halves.length === 1) {
+    return head.length === 8 ? head : null;
+  }
+  const tail = parseGroups(halves[1]);
+  if (tail === null) return null;
+  if (head.length + tail.length > 7) return null;
+  return [...head, ...new Array(8 - head.length - tail.length).fill(0), ...tail];
+}
 function checkIpv6(ip) {
-  const normalizedIp = ip.toLowerCase();
-  if (normalizedIp === "::1") {
+  const groups = expandIpv6(ip);
+  if (!groups) {
+    return { allowed: false, reason: `Malformed IPv6 address: ${ip}` };
+  }
+  const isZeroPrefix = groups.slice(0, 7).every((group) => group === 0);
+  if (isZeroPrefix && groups[7] === 1) {
     return { allowed: false, reason: "IPv6 loopback address (::1) is not allowed" };
   }
-  if (normalizedIp === "::" || normalizedIp === "0:0:0:0:0:0:0:0") {
+  if (isZeroPrefix && groups[7] === 0) {
     return { allowed: false, reason: "IPv6 unspecified address (::) is not allowed" };
   }
-  if (normalizedIp.startsWith("fe8") || normalizedIp.startsWith("fe9") || normalizedIp.startsWith("fea") || normalizedIp.startsWith("feb")) {
+  if ((groups[0] & 65472) === 65152) {
     return { allowed: false, reason: "IPv6 link-local addresses (fe80::/10) are not allowed" };
   }
-  if (normalizedIp.startsWith("fc") || normalizedIp.startsWith("fd")) {
+  if ((groups[0] & 65024) === 64512) {
     return { allowed: false, reason: "IPv6 unique local addresses (fc00::/7) are not allowed" };
   }
-  const ipv4MappedMatch = normalizedIp.match(/^::ffff:(\d+\.\d+\.\d+\.\d+)$/);
-  if (ipv4MappedMatch) {
-    return checkIpv4(ipv4MappedMatch[1]);
+  const embedded = extractEmbeddedIpv4(groups);
+  if (embedded) {
+    return checkIpv4(embedded);
   }
   return { allowed: true, reason: "" };
 }
+function extractEmbeddedIpv4(groups) {
+  const toDotted = () => {
+    const high = groups[6];
+    const low = groups[7];
+    return `${high >> 8}.${high & 255}.${low >> 8}.${low & 255}`;
+  };
+  const firstFive = groups.slice(0, 5).every((group) => group === 0);
+  if (firstFive && groups[5] === 65535) return toDotted();
+  if (firstFive && groups[5] === 0) return toDotted();
+  if (groups[0] === 100 && groups[1] === 65435 && groups.slice(2, 6).every((group) => group === 0)) {
+    return toDotted();
+  }
+  return null;
+}
 function isDomainInList(hostname, domainList) {
   const lowerHostname = hostname.toLowerCase();
   for (const domain of domainList) {
@@ -1326,8 +1378,6 @@ function buildIncrementalAuthPage(params) {
 
       <form method="GET" action="${escapeHtml3(callbackPath)}" class="flex gap-3 pt-4 border-t border-gray-100">
         <input type="hidden" name="pending_auth_id" value="${escapeHtml3(sessionHint)}">
-        <input type="hidden" name="app_id" value="${escapeHtml3(app.appId)}">
-        <input type="hidden" name="incremental" value="true">
         <button type="button" onclick="window.close()"
           class="flex-1 px-4 py-2.5 text-gray-600 hover:text-gray-900 hover:bg-gray-100 font-medium rounded-lg transition-colors">
           Cancel
@@ -1811,6 +1861,7 @@ function buildPendingRecord(params) {
     createdAt: now,
     expiresAt: now + PENDING_AUTH_TTL_MS,
     isIncremental: params.isIncremental,
+    incrementalSub: params.incrementalSub,
     targetAppId: params.targetAppId,
     targetToolId: params.targetToolId,
     existingSessionId: params.existingSessionId,
@@ -2952,6 +3003,44 @@ function buildCredentialResumeUrl(basePath, token) {
   return `${trimmed}/oauth/connect?token=${encodeURIComponent(token)}`;
 }
 
+// libs/auth/src/session/incremental-auth-ticket.ts
+import { randomUUID as randomUUID3, signData as signData2, verifyData as verifyData2 } from "@frontmcp/utils";
+var DEFAULT_INCREMENTAL_TICKET_TTL_MS = 3e5;
+function signIncrementalAuthTicket(input, secret) {
+  const payload = {
+    sub: input.sub,
+    appId: input.appId,
+    ...input.toolId !== void 0 ? { toolId: input.toolId } : {},
+    ...input.priorAppIds !== void 0 ? { priorAppIds: input.priorAppIds } : {},
+    jti: randomUUID3(),
+    exp: Date.now() + (input.ttlMs ?? DEFAULT_INCREMENTAL_TICKET_TTL_MS)
+  };
+  const signedJson = signData2(payload, { secret });
+  return Buffer.from(signedJson, "utf8").toString("base64url");
+}
+function verifyIncrementalAuthTicket(token, secret, now = Date.now()) {
+  let signedJson;
+  try {
+    signedJson = Buffer.from(token, "base64url").toString("utf8");
+  } catch {
+    return null;
+  }
+  const payload = verifyData2(signedJson, { secret });
+  if (!payload) return null;
+  if (typeof payload.sub !== "string" || payload.sub.length === 0) return null;
+  if (typeof payload.appId !== "string" || payload.appId.length === 0) return null;
+  if (typeof payload.jti !== "string" || payload.jti.length === 0) return null;
+  if (!Number.isFinite(payload.exp)) return null;
+  if (payload.toolId !== void 0 && typeof payload.toolId !== "string") return null;
+  if (payload.priorAppIds !== void 0 && (!Array.isArray(payload.priorAppIds) || payload.priorAppIds.some((id) => typeof id !== "string"))) {
+    return null;
+  }
+  if (now >= payload.exp) {
+    return null;
+  }
+  return payload;
+}
+
 // libs/auth/src/session/credentials-accessor.ts
 var CREDENTIALS_ACCESSOR = /* @__PURE__ */ Symbol.for("frontmcp:CREDENTIALS_ACCESSOR");
 
@@ -3416,8 +3505,8 @@ var redisConfigSchema = z4.object({
 
 // libs/auth/src/session/session-crypto.ts
 import {
-  signData as signData2,
-  verifyData as verifyData2,
+  signData as signData3,
+  verifyData as verifyData3,
   isSignedData,
   verifyOrParseData,
   getEnv as getEnv2,
@@ -3507,6 +3596,22 @@ var SessionSecretRequiredError = class extends AuthInternalError {
     super(`Session secret is required for ${component}`, "SESSION_SECRET_REQUIRED");
   }
 };
+var JwtSecretRequiredError = class extends AuthInternalError {
+  constructor(mode) {
+    super(
+      `JWT_SECRET is required in production for auth.mode "${mode}". Without it the server signs tokens with a random per-process secret, so every restart invalidates outstanding tokens and any second instance or isolate rejects tokens the first one minted.`,
+      "JWT_SECRET_REQUIRED"
+    );
+  }
+};
+var JwtSecretWeakError = class extends AuthInternalError {
+  constructor(byteLength) {
+    super(
+      `JWT_SECRET is ${byteLength} bytes; HS256 requires at least 32 (RFC 7518 \xA73.2). A shorter secret is guessable, and whoever guesses it can forge tokens for this server. Generate one with \`openssl rand -hex 32\`.`,
+      "JWT_SECRET_INVALID"
+    );
+  }
+};
 var CredentialProviderAlreadyRegisteredError = class extends AuthInternalError {
   constructor(name) {
     super(`Credential provider "${name}" is already registered`, "CREDENTIAL_PROVIDER_ALREADY_REGISTERED");
@@ -3584,10 +3689,10 @@ function resolveConfig(config) {
   return { secret: getSigningSecret(config) };
 }
 function signSession(session, config) {
-  return signData2(session, resolveConfig(config));
+  return signData3(session, resolveConfig(config));
 }
 function verifySession(signedData, config) {
-  return verifyData2(signedData, resolveConfig(config));
+  return verifyData3(signedData, resolveConfig(config));
 }
 function verifyOrParseSession(data, config) {
   return verifyOrParseData(data, resolveConfig(config));
@@ -3717,7 +3822,7 @@ var SessionRateLimiter = class {
 var defaultSessionRateLimiter = new SessionRateLimiter();
 
 // libs/auth/src/session/session.transport.ts
-import { randomUUID as randomUUID3 } from "@frontmcp/utils";
+import { randomUUID as randomUUID4 } from "@frontmcp/utils";
 var TransportIdGenerator = class {
   /**
    * Create a transport session ID.
@@ -3726,7 +3831,7 @@ var TransportIdGenerator = class {
    * @returns A transport session ID (UUID without dashes)
    */
   static createId() {
-    return randomUUID3().replace(/-/g, "");
+    return randomUUID4().replace(/-/g, "");
   }
 };
 
@@ -3863,7 +3968,7 @@ import { TypedStorage as TypedStorage4 } from "@frontmcp/utils";
 import { EncryptedTypedStorage, EncryptedStorageError } from "@frontmcp/utils";
 
 // libs/auth/src/session/storage/storage-token-store.ts
-import { randomUUID as randomUUID4, TypedStorage as TypedStorage2 } from "@frontmcp/utils";
+import { randomUUID as randomUUID5, TypedStorage as TypedStorage2 } from "@frontmcp/utils";
 var StorageTokenStore = class {
   storage;
   namespace;
@@ -3881,7 +3986,7 @@ var StorageTokenStore = class {
    * Allocate a new unique ID for a token record.
    */
   allocId() {
-    return randomUUID4();
+    return randomUUID5();
   }
   /**
    * Store an encrypted token blob.
@@ -3944,7 +4049,7 @@ var StorageTokenStore = class {
 };
 
 // libs/auth/src/session/storage/storage-authorization-vault.ts
-import { randomUUID as randomUUID5, TypedStorage as TypedStorage3 } from "@frontmcp/utils";
+import { randomUUID as randomUUID6, TypedStorage as TypedStorage3 } from "@frontmcp/utils";
 var StorageAuthorizationVault = class {
   storage;
   namespace;
@@ -3964,7 +4069,7 @@ var StorageAuthorizationVault = class {
   async create(params) {
     const now = Date.now();
     const entry = {
-      id: randomUUID5(),
+      id: randomUUID6(),
       userSub: params.userSub,
       userEmail: params.userEmail,
       userName: params.userName,
@@ -4038,7 +4143,7 @@ var StorageAuthorizationVault = class {
     }
     const now = Date.now();
     const pendingAuth = {
-      id: randomUUID5(),
+      id: randomUUID6(),
       appId: params.appId,
       toolId: params.toolId,
       authUrl: params.authUrl,
@@ -4267,7 +4372,7 @@ var InMemoryAuthorizationVault = class extends StorageAuthorizationVault {
 };
 
 // libs/auth/src/session/redis-session.store.ts
-import { randomUUID as randomUUID6, RedisStorageAdapter as RedisStorageAdapter2 } from "@frontmcp/utils";
+import { randomUUID as randomUUID7, RedisStorageAdapter as RedisStorageAdapter2 } from "@frontmcp/utils";
 var RedisSessionStore = class {
   storage;
   keyPrefix;
@@ -4478,7 +4583,7 @@ var RedisSessionStore = class {
    * Allocate a new session ID
    */
   allocId() {
-    return randomUUID6();
+    return randomUUID7();
   }
   /**
    * Disconnect from Redis (only if we created the connection)
@@ -4514,7 +4619,7 @@ var RedisSessionStore = class {
 };
 
 // libs/auth/src/session/vercel-kv-session.store.ts
-import { randomUUID as randomUUID7, VercelKvStorageAdapter } from "@frontmcp/utils";
+import { randomUUID as randomUUID8, VercelKvStorageAdapter } from "@frontmcp/utils";
 var VercelKvSessionStore = class {
   storage;
   keyPrefix;
@@ -4708,7 +4813,7 @@ var VercelKvSessionStore = class {
    * Allocate a new session ID
    */
   allocId() {
-    return randomUUID7();
+    return randomUUID8();
   }
   /**
    * Disconnect from Vercel KV
@@ -5214,7 +5319,7 @@ var StorageOrchestratedTokenStore = class {
 };
 
 // libs/auth/src/session/federated-auth.session.ts
-import { randomUUID as randomUUID8 } from "@frontmcp/utils";
+import { randomUUID as randomUUID9 } from "@frontmcp/utils";
 function toSessionRecord(session) {
   return {
     ...session,
@@ -5289,7 +5394,7 @@ var InMemoryFederatedAuthSessionStore = class {
   createSession(params) {
     const now = Date.now();
     return {
-      id: randomUUID8(),
+      id: randomUUID9(),
       pendingAuthId: params.pendingAuthId,
       clientId: params.clientId,
       redirectUri: params.redirectUri,
@@ -5321,7 +5426,7 @@ var InMemoryFederatedAuthSessionStore = class {
 function createFederatedAuthSession(params, ttlMs = 15 * 60 * 1e3) {
   const now = Date.now();
   return {
-    id: randomUUID8(),
+    id: randomUUID9(),
     pendingAuthId: params.pendingAuthId,
     clientId: params.clientId,
     redirectUri: params.redirectUri,
@@ -5489,7 +5594,7 @@ var StorageConsentStore = class {
 
 // libs/auth/src/session/encrypted-authorization-vault.ts
 import { z as z5 } from "@frontmcp/lazy-zod";
-import { AsyncLocalStorage, randomUUID as randomUUID9 } from "@frontmcp/utils";
+import { AsyncLocalStorage, randomUUID as randomUUID10 } from "@frontmcp/utils";
 var redisVaultEntrySchema = z5.object({
   /** Vault ID */
   id: z5.string(),
@@ -5650,7 +5755,7 @@ var EncryptedRedisVault = class {
   async create(params) {
     const now = Date.now();
     const entry = {
-      id: randomUUID9(),
+      id: randomUUID10(),
       userSub: params.userSub,
       userEmail: params.userEmail,
       userName: params.userName,
@@ -5709,7 +5814,7 @@ var EncryptedRedisVault = class {
     }
     const now = Date.now();
     const pendingAuth = {
-      id: randomUUID9(),
+      id: randomUUID10(),
       appId: params.appId,
       toolId: params.toolId,
       authUrl: params.authUrl,
@@ -5972,7 +6077,7 @@ var progressiveAuthStateSchema = z6.object({
 });
 
 // libs/auth/src/authorization/authorization.class.ts
-import { base64urlDecode as base64urlDecode4, getMachineId as getMachineId2, randomUUID as randomUUID10 } from "@frontmcp/utils";
+import { base64urlDecode as base64urlDecode4, getMachineId as getMachineId2, randomUUID as randomUUID11 } from "@frontmcp/utils";
 var AuthorizationBase = class _AuthorizationBase {
   id;
   isAnonymous;
@@ -6020,7 +6125,7 @@ var AuthorizationBase = class _AuthorizationBase {
    * @param fingerprint - Optional client fingerprint for tracking
    */
   createTransportSession(protocol, fingerprint) {
-    const sessionId = randomUUID10();
+    const sessionId = randomUUID11();
     const session = {
       id: sessionId,
       authorizationId: this.id,
@@ -6098,11 +6203,22 @@ var AuthorizationBase = class _AuthorizationBase {
   /**
    * Build URL for progressive/incremental authorization.
    * Used when a tool requires authorization for an app that was skipped during initial auth.
+   *
+   * The URL only SKIPS the login step when it carries a valid incremental
+   * ticket (GHSA-2c4g-9c8x-6m8g) — mint one with
+   * {@link signIncrementalAuthTicket} using the server signing secret and pass
+   * it here. Without a ticket the link still works, but the user completes an
+   * ordinary login; `mode=incremental` alone is no longer an authorization
+   * signal and is not emitted.
+   *
    * @param appId - App ID that requires authorization
    * @param baseUrl - Base URL of the server
+   * @param ticket - Signed incremental-authorization ticket for this subject
    */
-  getProgressiveAuthUrl(appId, baseUrl) {
-    return `${baseUrl}/oauth/authorize?app=${encodeURIComponent(appId)}&mode=incremental`;
+  getProgressiveAuthUrl(appId, baseUrl, ticket) {
+    const params = new URLSearchParams({ app: appId });
+    if (ticket) params.set("ticket", ticket);
+    return `${baseUrl}/oauth/authorize?${params.toString()}`;
   }
   /**
    * Check if the authorization is expired
@@ -6209,7 +6325,7 @@ var AuthorizationBase = class _AuthorizationBase {
 };
 
 // libs/auth/src/authorization/public.authorization.ts
-import { randomUUID as randomUUID11 } from "@frontmcp/utils";
+import { randomUUID as randomUUID12 } from "@frontmcp/utils";
 var PublicAuthorization = class _PublicAuthorization extends AuthorizationBase {
   mode = "public";
   /**
@@ -6245,7 +6361,7 @@ var PublicAuthorization = class _PublicAuthorization extends AuthorizationBase {
       allowedTools = "all",
       allowedPrompts = "all"
     } = ctx;
-    const uuid = randomUUID11();
+    const uuid = randomUUID12();
     const sub = `${prefix}:${uuid}`;
     const user = {
       sub,
@@ -8162,10 +8278,48 @@ var publicAuthOptionsSchema = z11.object({
   signKey: jwkSchema.or(z11.instanceof(Uint8Array)).optional()
 });
 
-// libs/auth/src/options/transparent.schema.ts
+// libs/auth/src/options/static.schema.ts
 import { z as z12 } from "@frontmcp/lazy-zod";
-var transparentAuthOptionsSchema = z12.object({
-  mode: z12.literal("transparent"),
+var staticAuthOptionsSchema = z12.object({
+  mode: z12.literal("static"),
+  /**
+   * Accepted credentials. Compared against the presented one in constant time,
+   * over SHA-256 digests so neither the value nor its length leaks by timing.
+   *
+   * Read these from the environment — never commit them.
+   */
+  tokens: z12.array(z12.string().min(1)).min(1),
+  /**
+   * Request header carrying the credential.
+   * @default 'authorization'
+   */
+  header: z12.string().min(1).default("authorization"),
+  /**
+   * Scheme prefix to strip before comparing, matched case-insensitively. Set to
+   * an empty string for headers that carry a bare token (e.g. `x-api-key`).
+   * @default 'Bearer'
+   */
+  scheme: z12.string().default("Bearer"),
+  /**
+   * Scopes granted to a request that presents a valid token.
+   * @default ['static']
+   */
+  scopes: z12.array(z12.string()).default(["static"]),
+  /**
+   * Realm reported in the `WWW-Authenticate` challenge on failure.
+   * @default 'mcp'
+   */
+  realm: z12.string().default("mcp"),
+  /**
+   * Tool/prompt access configuration, same shape the other modes accept.
+   */
+  publicAccess: publicAccessConfigSchema.optional()
+});
+
+// libs/auth/src/options/transparent.schema.ts
+import { z as z13 } from "@frontmcp/lazy-zod";
+var transparentAuthOptionsSchema = z13.object({
+  mode: z13.literal("transparent"),
   /**
    * Flattened remote provider fields (provider, clientId, clientSecret, scopes, providerConfig)
    */
@@ -8174,28 +8328,28 @@ var transparentAuthOptionsSchema = z12.object({
    * Expected token audience
    * If not set, defaults to the resource URL
    */
-  expectedAudience: z12.union([z12.string(), z12.array(z12.string())]).optional(),
+  expectedAudience: z13.union([z13.string(), z13.array(z13.string())]).optional(),
   /**
    * Require an `aud` claim (reject audience-less tokens). Defaults to `false`
    * for IdP compatibility; set `true` to reject tokens with no audience.
    */
-  requireAudience: z12.boolean().optional(),
+  requireAudience: z13.boolean().optional(),
   /**
    * Required scopes for access
    * Empty array means any valid token is accepted
    * @default []
    */
-  requiredScopes: z12.array(z12.string()).default([]),
+  requiredScopes: z13.array(z13.string()).default([]),
   /**
    * Allow anonymous fallback when no token is provided
    * @default false
    */
-  allowAnonymous: z12.boolean().default(false),
+  allowAnonymous: z13.boolean().default(false),
   /**
    * Scopes granted to anonymous sessions (when allowAnonymous=true)
    * @default ['anonymous']
    */
-  anonymousScopes: z12.array(z12.string()).default(["anonymous"]),
+  anonymousScopes: z13.array(z13.string()).default(["anonymous"]),
   /**
    * Public access config for anonymous users (when allowAnonymous=true)
    */
@@ -8203,13 +8357,13 @@ var transparentAuthOptionsSchema = z12.object({
 });
 
 // libs/auth/src/options/orchestrated.schema.ts
-import { z as z13 } from "@frontmcp/lazy-zod";
-var authSlotSchema = z13.enum(["login", "consent", "incremental", "federated", "error"]);
-var authUiMapSchema = z13.partialRecord(authSlotSchema, z13.string().min(1));
-var authExtraHandlerSchema = z13.custom((v) => typeof v === "function", {
+import { z as z14 } from "@frontmcp/lazy-zod";
+var authSlotSchema = z14.enum(["login", "consent", "incremental", "federated", "error"]);
+var authUiMapSchema = z14.partialRecord(authSlotSchema, z14.string().min(1));
+var authExtraHandlerSchema = z14.custom((v) => typeof v === "function", {
   message: "auth.extras entries must be handler functions (input, ctx) => AuthExtraResult."
 });
-var authExtrasMapSchema = z13.record(z13.string().min(1), authExtraHandlerSchema);
+var authExtrasMapSchema = z14.record(z14.string().min(1), authExtraHandlerSchema);
 var sharedAuthFields = {
   local: localSigningConfigSchema.optional(),
   tokenStorage: tokenStorageConfigSchema.default("memory"),
@@ -8217,13 +8371,13 @@ var sharedAuthFields = {
   // Optional (no default) so an unset value resolves to the in-memory encrypted
   // default at runtime; existing configs are unaffected.
   secureStore: secureStoreConfigSchema.optional(),
-  allowDefaultPublic: z13.boolean().default(false),
-  anonymousScopes: z13.array(z13.string()).default(["anonymous"]),
+  allowDefaultPublic: z14.boolean().default(false),
+  anonymousScopes: z14.array(z14.string()).default(["anonymous"]),
   publicAccess: publicAccessConfigSchema.optional(),
   consent: consentConfigSchema.optional(),
   federatedAuth: federatedAuthConfigSchema.optional(),
   refresh: tokenRefreshConfigSchema.optional(),
-  expectedAudience: z13.union([z13.string(), z13.array(z13.string())]).optional(),
+  expectedAudience: z14.union([z14.string(), z14.array(z14.string())]).optional(),
   incrementalAuth: incrementalAuthConfigSchema.optional(),
   /**
    * Require the OAuth client to be KNOWN (registered via DCR / pre-registered,
@@ -8239,46 +8393,46 @@ var sharedAuthFields = {
    * matching for every client. Clients on a configured
    * `dcr.allowedRedirectUris` allowlist still pass.
    */
-  requireRegisteredClients: z13.boolean().default(false),
+  requireRegisteredClients: z14.boolean().default(false),
   cimd: cimdConfigSchema.optional(),
   // #469 — custom auth UI as a slot→file map + extras name→handler map (per-app
   // under splitByApp). Both optional; omitting them serves the built-in pages.
   ui: authUiMapSchema.optional(),
   extras: authExtrasMapSchema.optional()
 };
-var loginFieldSchema = z13.object({
-  type: z13.enum(["text", "password", "email", "select", "hidden"]),
-  label: z13.string().optional(),
-  required: z13.boolean().optional(),
-  placeholder: z13.string().optional(),
-  options: z13.array(z13.object({ value: z13.string(), label: z13.string() })).optional()
+var loginFieldSchema = z14.object({
+  type: z14.enum(["text", "password", "email", "select", "hidden"]),
+  label: z14.string().optional(),
+  required: z14.boolean().optional(),
+  placeholder: z14.string().optional(),
+  options: z14.array(z14.object({ value: z14.string(), label: z14.string() })).optional()
 });
-var loginConfigSchema = z13.object({
-  title: z13.string().optional(),
-  subtitle: z13.string().optional(),
-  logoUri: z13.string().optional(),
-  fields: z13.record(z13.string(), loginFieldSchema).optional(),
+var loginConfigSchema = z14.object({
+  title: z14.string().optional(),
+  subtitle: z14.string().optional(),
+  logoUri: z14.string().optional(),
+  fields: z14.record(z14.string(), loginFieldSchema).optional(),
   // Full HTML override — a function, validated structurally like other callbacks
   // in the codebase (see http/cors handlers using z.custom<…>).
-  render: z13.custom((v) => typeof v === "function", {
+  render: z14.custom((v) => typeof v === "function", {
     message: "login.render must be a function"
   }).optional(),
-  subject: z13.object({
-    fromField: z13.string().optional(),
-    strategy: z13.enum(["per-session", "per-account"]).optional()
+  subject: z14.object({
+    fromField: z14.string().optional(),
+    strategy: z14.enum(["per-session", "per-account"]).optional()
   }).optional()
 });
-var authenticateFnSchema = z13.custom((v) => typeof v === "function", {
+var authenticateFnSchema = z14.custom((v) => typeof v === "function", {
   message: "authenticate must be a function"
 });
-var localAuthSchema = z13.object({
-  mode: z13.literal("local"),
+var localAuthSchema = z14.object({
+  mode: z14.literal("local"),
   ...sharedAuthFields,
   // #468 — opt-out of the email requirement at /oauth/callback for
   // single-operator local setups. Defaults preserve the historical behavior
   // (email required) so existing configs are unaffected.
-  requireEmail: z13.boolean().default(true),
-  anonymousSubject: z13.string().min(1).default("local-operator"),
+  requireEmail: z14.boolean().default(true),
+  anonymousSubject: z14.string().min(1).default("local-operator"),
   // Checkpoint 3a — declarative login customization + custom verification.
   // Both optional; omitting them preserves the default login path exactly.
   login: loginConfigSchema.optional(),
@@ -8286,7 +8440,7 @@ var localAuthSchema = z13.object({
   // Multi-OAuth-provider orchestration — declare upstream providers (GitHub,
   // Slack, Jira, …) to federate at /oauth/authorize. Optional; omitting it
   // preserves the default single-operator local login exactly.
-  providers: z13.array(upstreamProviderSchema).optional(),
+  providers: z14.array(upstreamProviderSchema).optional(),
   // Local-AS Dynamic Client Registration control surface (#462) — gate
   // `POST /oauth/register`, allowlist redirect_uris/client_ids, require an
   // initial access token, and seed pre-registered trusted clients. Optional;
@@ -8294,8 +8448,8 @@ var localAuthSchema = z13.object({
   // no allowlist; no initial access token).
   dcr: localDcrConfigSchema.optional()
 });
-var remoteAuthSchema = z13.object({
-  mode: z13.literal("remote"),
+var remoteAuthSchema = z14.object({
+  mode: z14.literal("remote"),
   ...flatRemoteProviderFields,
   ...sharedAuthFields
 });
@@ -8303,21 +8457,22 @@ var orchestratedLocalSchema = localAuthSchema;
 var orchestratedRemoteSchema = remoteAuthSchema;
 
 // libs/auth/src/options/schema.ts
-import { z as z14 } from "@frontmcp/lazy-zod";
-var authOptionsSchema = z14.union([
+import { z as z15 } from "@frontmcp/lazy-zod";
+var authOptionsSchema = z15.union([
   publicAuthOptionsSchema,
+  staticAuthOptionsSchema,
   transparentAuthOptionsSchema,
   localAuthSchema,
   remoteAuthSchema
 ]);
 
 // libs/auth/src/options/app-auth.schema.ts
-import { z as z15 } from "@frontmcp/lazy-zod";
+import { z as z16 } from "@frontmcp/lazy-zod";
 var standaloneOptionSchema = {
-  standalone: z15.boolean().optional(),
-  excludeFromParent: z15.boolean().optional()
+  standalone: z16.boolean().optional(),
+  excludeFromParent: z16.boolean().optional()
 };
-var appAuthOptionsSchema = z15.union([
+var appAuthOptionsSchema = z16.union([
   publicAuthOptionsSchema.extend(standaloneOptionSchema),
   transparentAuthOptionsSchema.extend(standaloneOptionSchema),
   localAuthSchema.extend(standaloneOptionSchema),
@@ -8331,6 +8486,9 @@ function parseAuthOptions(input) {
 function isPublicMode(options) {
   return options.mode === "public";
 }
+function isStaticMode(options) {
+  return options.mode === "static";
+}
 function isTransparentMode(options) {
   return options.mode === "transparent";
 }
@@ -8357,108 +8515,108 @@ function allowsPublicAccess(options) {
 }
 
 // libs/auth/src/consent/consent.types.ts
-import { z as z16 } from "@frontmcp/lazy-zod";
-var consentToolItemSchema = z16.object({
+import { z as z17 } from "@frontmcp/lazy-zod";
+var consentToolItemSchema = z17.object({
   /** Tool ID (e.g., 'slack:send_message') */
-  id: z16.string().min(1),
+  id: z17.string().min(1),
   /** Tool name for display */
-  name: z16.string().min(1),
+  name: z17.string().min(1),
   /** Tool description */
-  description: z16.string().optional(),
+  description: z17.string().optional(),
   /** App ID this tool belongs to */
-  appId: z16.string().min(1),
+  appId: z17.string().min(1),
   /** App name for display */
-  appName: z16.string().min(1),
+  appName: z17.string().min(1),
   /** Whether the tool is selected by default */
-  defaultSelected: z16.boolean().default(true),
+  defaultSelected: z17.boolean().default(true),
   /** Whether this tool requires specific scopes */
-  requiredScopes: z16.array(z16.string()).optional(),
+  requiredScopes: z17.array(z17.string()).optional(),
   /** Category for grouping (e.g., 'read', 'write', 'admin') */
-  category: z16.string().optional()
+  category: z17.string().optional()
 });
-var consentSelectionSchema = z16.object({
+var consentSelectionSchema = z17.object({
   /** Selected tool IDs */
-  selectedTools: z16.array(z16.string()),
+  selectedTools: z17.array(z17.string()),
   /** Whether all tools were selected */
-  allSelected: z16.boolean(),
+  allSelected: z17.boolean(),
   /** Timestamp when consent was given */
-  consentedAt: z16.string().datetime(),
+  consentedAt: z17.string().datetime(),
   /** Consent version for tracking changes */
-  consentVersion: z16.string().default("1.0")
+  consentVersion: z17.string().default("1.0")
 });
-var consentStateSchema = z16.object({
+var consentStateSchema = z17.object({
   /** Whether consent flow is enabled */
-  enabled: z16.boolean(),
+  enabled: z17.boolean(),
   /** Available tools for consent */
-  availableTools: z16.array(consentToolItemSchema),
+  availableTools: z17.array(consentToolItemSchema),
   /** Pre-selected tools (from previous consent or defaults) */
-  preselectedTools: z16.array(z16.string()).optional(),
+  preselectedTools: z17.array(z17.string()).optional(),
   /** Whether to show all tools or group by app */
-  groupByApp: z16.boolean().default(true),
+  groupByApp: z17.boolean().default(true),
   /** Custom consent message */
-  customMessage: z16.string().optional()
+  customMessage: z17.string().optional()
 });
-var federatedProviderItemSchema = z16.object({
+var federatedProviderItemSchema = z17.object({
   /** Provider ID (derived or explicit) */
-  id: z16.string().min(1),
+  id: z17.string().min(1),
   /** Provider display name */
-  name: z16.string().min(1),
+  name: z17.string().min(1),
   /** Provider description */
-  description: z16.string().optional(),
+  description: z17.string().optional(),
   /** Provider icon URL or emoji */
-  icon: z16.string().optional(),
+  icon: z17.string().optional(),
   /** Provider type */
-  type: z16.enum(["local", "remote", "transparent"]),
+  type: z17.enum(["local", "remote", "transparent"]),
   /** OAuth provider URL (for remote providers) */
-  providerUrl: z16.string().url().optional(),
+  providerUrl: z17.string().url().optional(),
   /** Apps using this provider */
-  appIds: z16.array(z16.string()),
+  appIds: z17.array(z17.string()),
   /** App names using this provider */
-  appNames: z16.array(z16.string()),
+  appNames: z17.array(z17.string()),
   /** Scopes required by this provider */
-  scopes: z16.array(z16.string()),
+  scopes: z17.array(z17.string()),
   /** Whether this is the primary/parent provider */
-  isPrimary: z16.boolean(),
+  isPrimary: z17.boolean(),
   /** Whether this provider is optional (can be skipped) */
-  isOptional: z16.boolean().default(false)
+  isOptional: z17.boolean().default(false)
 });
-var federatedLoginStateSchema = z16.object({
+var federatedLoginStateSchema = z17.object({
   /** All available providers */
-  providers: z16.array(federatedProviderItemSchema),
+  providers: z17.array(federatedProviderItemSchema),
   /** Primary provider ID (if any) */
-  primaryProviderId: z16.string().optional(),
+  primaryProviderId: z17.string().optional(),
   /** Whether user can skip optional providers */
-  allowSkip: z16.boolean().default(true),
+  allowSkip: z17.boolean().default(true),
   /** Pre-selected provider IDs (from previous session) */
-  preselectedProviders: z16.array(z16.string()).optional()
+  preselectedProviders: z17.array(z17.string()).optional()
 });
-var federatedSelectionSchema = z16.object({
+var federatedSelectionSchema = z17.object({
   /** Selected provider IDs */
-  selectedProviders: z16.array(z16.string()),
+  selectedProviders: z17.array(z17.string()),
   /** Skipped provider IDs */
-  skippedProviders: z16.array(z16.string()),
+  skippedProviders: z17.array(z17.string()),
   /** Provider-specific metadata */
-  providerMetadata: z16.record(z16.string(), z16.unknown()).optional()
+  providerMetadata: z17.record(z17.string(), z17.unknown()).optional()
 });
 
 // libs/auth/src/detection/auth-provider-detection.ts
-import { z as z17 } from "@frontmcp/lazy-zod";
-var detectedAuthProviderSchema = z17.object({
-  id: z17.string(),
-  providerUrl: z17.string().optional(),
-  mode: z17.enum(["public", "transparent", "local", "remote"]),
-  appIds: z17.array(z17.string()),
-  scopes: z17.array(z17.string()),
-  isParentProvider: z17.boolean()
+import { z as z18 } from "@frontmcp/lazy-zod";
+var detectedAuthProviderSchema = z18.object({
+  id: z18.string(),
+  providerUrl: z18.string().optional(),
+  mode: z18.enum(["public", "static", "transparent", "local", "remote"]),
+  appIds: z18.array(z18.string()),
+  scopes: z18.array(z18.string()),
+  isParentProvider: z18.boolean()
 });
-var authProviderDetectionResultSchema = z17.object({
-  providers: z17.map(z17.string(), detectedAuthProviderSchema),
-  requiresOrchestration: z17.boolean(),
-  parentProviderId: z17.string().optional(),
-  childProviderIds: z17.array(z17.string()),
-  uniqueProviderCount: z17.number(),
-  validationErrors: z17.array(z17.string()),
-  warnings: z17.array(z17.string())
+var authProviderDetectionResultSchema = z18.object({
+  providers: z18.map(z18.string(), detectedAuthProviderSchema),
+  requiresOrchestration: z18.boolean(),
+  parentProviderId: z18.string().optional(),
+  childProviderIds: z18.array(z18.string()),
+  uniqueProviderCount: z18.number(),
+  validationErrors: z18.array(z18.string()),
+  warnings: z18.array(z18.string())
 });
 function deriveProviderId(options) {
   if (isPublicMode(options)) {
@@ -8847,43 +9005,43 @@ var AudienceValidator = class _AudienceValidator {
 };
 
 // libs/auth/src/vault/auth-providers.types.ts
-import { z as z18 } from "@frontmcp/lazy-zod";
-var credentialScopeSchema = z18.enum(["global", "user", "session"]);
-var loadingStrategySchema = z18.enum(["eager", "lazy"]);
-var getCredentialOptionsSchema = z18.object({
-  forceRefresh: z18.boolean().optional(),
-  scopes: z18.array(z18.string()).optional(),
-  timeout: z18.number().positive().optional()
+import { z as z19 } from "@frontmcp/lazy-zod";
+var credentialScopeSchema = z19.enum(["global", "user", "session"]);
+var loadingStrategySchema = z19.enum(["eager", "lazy"]);
+var getCredentialOptionsSchema = z19.object({
+  forceRefresh: z19.boolean().optional(),
+  scopes: z19.array(z19.string()).optional(),
+  timeout: z19.number().positive().optional()
 }).strict();
-var credentialProviderConfigSchema = z18.object({
-  name: z18.string().min(1),
-  description: z18.string().optional(),
+var credentialProviderConfigSchema = z19.object({
+  name: z19.string().min(1),
+  description: z19.string().optional(),
   scope: credentialScopeSchema,
   loading: loadingStrategySchema,
-  cacheTtl: z18.number().nonnegative().optional(),
+  cacheTtl: z19.number().nonnegative().optional(),
   // Functions validated at runtime, not via Zod (Zod 4 compatibility)
-  factory: z18.any(),
-  refresh: z18.any().optional(),
-  toHeaders: z18.any().optional(),
-  metadata: z18.record(z18.string(), z18.unknown()).optional(),
-  required: z18.boolean().optional()
+  factory: z19.any(),
+  refresh: z19.any().optional(),
+  toHeaders: z19.any().optional(),
+  metadata: z19.record(z19.string(), z19.unknown()).optional(),
+  required: z19.boolean().optional()
 }).strict();
-var authProviderMappingSchema = z18.union([
-  z18.string(),
-  z18.object({
-    name: z18.string().min(1),
-    required: z18.boolean().optional().default(true),
-    scopes: z18.array(z18.string()).optional(),
-    alias: z18.string().optional()
+var authProviderMappingSchema = z19.union([
+  z19.string(),
+  z19.object({
+    name: z19.string().min(1),
+    required: z19.boolean().optional().default(true),
+    scopes: z19.array(z19.string()).optional(),
+    alias: z19.string().optional()
   }).strict()
 ]);
-var authProvidersVaultOptionsSchema = z18.object({
-  enabled: z18.boolean().optional(),
-  useSharedStorage: z18.boolean().optional().default(true),
-  namespace: z18.string().optional().default("authproviders:"),
-  defaultCacheTtl: z18.number().nonnegative().optional().default(36e5),
-  maxCredentialsPerSession: z18.number().positive().optional().default(100),
-  providers: z18.array(credentialProviderConfigSchema).optional()
+var authProvidersVaultOptionsSchema = z19.object({
+  enabled: z19.boolean().optional(),
+  useSharedStorage: z19.boolean().optional().default(true),
+  namespace: z19.string().optional().default("authproviders:"),
+  defaultCacheTtl: z19.number().nonnegative().optional().default(36e5),
+  maxCredentialsPerSession: z19.number().positive().optional().default(100),
+  providers: z19.array(credentialProviderConfigSchema).optional()
 }).strict();
 
 // libs/auth/src/vault/credential-helpers.ts
@@ -10105,20 +10263,20 @@ function resolveRequiredScopes(denial, mapping, authorities) {
 }
 
 // libs/auth/src/authorities/authorities.schema.ts
-import { z as z19 } from "@frontmcp/lazy-zod";
-var rbacRolesPolicySchema = z19.object({
-  all: z19.array(z19.string().min(1)).optional(),
-  any: z19.array(z19.string().min(1)).optional()
+import { z as z20 } from "@frontmcp/lazy-zod";
+var rbacRolesPolicySchema = z20.object({
+  all: z20.array(z20.string().min(1)).optional(),
+  any: z20.array(z20.string().min(1)).optional()
 }).refine((data) => data.all !== void 0 || data.any !== void 0, {
   message: 'Roles policy must have at least "all" or "any"'
 });
-var rbacPermissionsPolicySchema = z19.object({
-  all: z19.array(z19.string().min(1)).optional(),
-  any: z19.array(z19.string().min(1)).optional()
+var rbacPermissionsPolicySchema = z20.object({
+  all: z20.array(z20.string().min(1)).optional(),
+  any: z20.array(z20.string().min(1)).optional()
 }).refine((data) => data.all !== void 0 || data.any !== void 0, {
   message: 'Permissions policy must have at least "all" or "any"'
 });
-var abacOperatorSchema = z19.enum([
+var abacOperatorSchema = z20.enum([
   "eq",
   "neq",
   "in",
@@ -10133,55 +10291,55 @@ var abacOperatorSchema = z19.enum([
   "exists",
   "matches"
 ]);
-var abacConditionSchema = z19.object({
-  path: z19.string().min(1),
+var abacConditionSchema = z20.object({
+  path: z20.string().min(1),
   op: abacOperatorSchema,
-  value: z19.unknown()
+  value: z20.unknown()
 });
-var abacPolicySchema = z19.object({
-  match: z19.record(z19.string(), z19.unknown()).optional(),
-  conditions: z19.array(abacConditionSchema).optional()
+var abacPolicySchema = z20.object({
+  match: z20.record(z20.string(), z20.unknown()).optional(),
+  conditions: z20.array(abacConditionSchema).optional()
 }).refine((data) => data.match !== void 0 || data.conditions !== void 0, {
   message: 'Attributes policy must have at least "match" or "conditions"'
 });
-var resourceIdRefSchema = z19.union([
-  z19.string().min(1),
-  z19.object({ fromInput: z19.string().min(1) }).strict(),
-  z19.object({ fromClaims: z19.string().min(1) }).strict()
+var resourceIdRefSchema = z20.union([
+  z20.string().min(1),
+  z20.object({ fromInput: z20.string().min(1) }).strict(),
+  z20.object({ fromClaims: z20.string().min(1) }).strict()
 ]);
-var rebacPolicySchema = z19.object({
-  type: z19.string().min(1),
-  resource: z19.string().min(1),
+var rebacPolicySchema = z20.object({
+  type: z20.string().min(1),
+  resource: z20.string().min(1),
   resourceId: resourceIdRefSchema
 });
 var basePolicyShape = {
   roles: rbacRolesPolicySchema.optional(),
   permissions: rbacPermissionsPolicySchema.optional(),
   attributes: abacPolicySchema.optional(),
-  relationships: z19.union([rebacPolicySchema, z19.array(rebacPolicySchema)]).optional(),
-  custom: z19.record(z19.string(), z19.unknown()).optional(),
-  guards: z19.array(z19.instanceof(Function)).optional(),
-  operator: z19.enum(["AND", "OR"]).optional()
+  relationships: z20.union([rebacPolicySchema, z20.array(rebacPolicySchema)]).optional(),
+  custom: z20.record(z20.string(), z20.unknown()).optional(),
+  guards: z20.array(z20.instanceof(Function)).optional(),
+  operator: z20.enum(["AND", "OR"]).optional()
 };
-var authoritiesPolicySchema = z19.lazy(
-  () => z19.object({
+var authoritiesPolicySchema = z20.lazy(
+  () => z20.object({
     ...basePolicyShape,
     not: authoritiesPolicySchema.optional(),
-    anyOf: z19.array(authoritiesPolicySchema).optional(),
-    allOf: z19.array(authoritiesPolicySchema).optional()
+    anyOf: z20.array(authoritiesPolicySchema).optional(),
+    allOf: z20.array(authoritiesPolicySchema).optional()
   })
 );
-var authoritiesMetadataSchema = z19.union([
-  z19.string().min(1),
-  z19.array(z19.string().min(1)).min(1),
+var authoritiesMetadataSchema = z20.union([
+  z20.string().min(1),
+  z20.array(z20.string().min(1)).min(1),
   authoritiesPolicySchema
 ]);
-var authoritiesClaimsMappingSchema = z19.record(z19.string(), z19.string().optional()).refine((data) => Object.values(data).some((v) => v !== void 0), {
+var authoritiesClaimsMappingSchema = z20.record(z20.string(), z20.string().optional()).refine((data) => Object.values(data).some((v) => v !== void 0), {
   message: "Claims mapping must have at least one mapping"
 });
-var authoritiesConfigSchema = z19.object({
+var authoritiesConfigSchema = z20.object({
   claimsMapping: authoritiesClaimsMappingSchema.optional(),
-  profiles: z19.record(z19.string().min(1), authoritiesPolicySchema).optional()
+  profiles: z20.record(z20.string().min(1), authoritiesPolicySchema).optional()
 });
 
 // libs/auth/src/authorities/authorities.evaluator.ts
@@ -10861,6 +11019,7 @@ export {
   CredentialProviderAlreadyRegisteredError,
   CredentialStorageError,
   CredentialsAccessorImpl,
+  DEFAULT_INCREMENTAL_TICKET_TTL_MS,
   DEFAULT_RESUME_TTL_MS,
   DEFAULT_THEME,
   DcrClientRegistry,
@@ -10883,6 +11042,8 @@ export {
   InMemoryStoreRequiredError,
   InvalidClientIdUrlError,
   JwksService,
+  JwtSecretRequiredError,
+  JwtSecretWeakError,
   LazyCredentialLoader,
   NoProviderIdError,
   NullOrchestratedAuthAccessor,
@@ -11053,6 +11214,7 @@ export {
   isSoonExpiring,
   isSoonExpiringProvider,
   isSqliteTokenStorage,
+  isStaticMode,
   isTransparentMode,
   jsonWebKeySetSchema,
   jwkParametersSchema,
@@ -11104,6 +11266,7 @@ export {
   sessionIdPayloadSchema,
   sessionJwtPayloadSchema,
   signCredentialResumeToken,
+  signIncrementalAuthTicket,
   signSession,
   skippedAppBehaviorSchema,
   sseTransportStateSchema,
@@ -11111,6 +11274,7 @@ export {
   startNextProvider,
   statefulHttpTransportStateSchema,
   statelessHttpTransportStateSchema,
+  staticAuthOptionsSchema,
   storedSessionSchema,
   streamableHttpTransportStateSchema,
   toEpochSeconds,
@@ -11132,6 +11296,7 @@ export {
   vaultConsentRecordSchema,
   vaultFederatedRecordSchema,
   verifyCredentialResumeToken,
+  verifyIncrementalAuthTicket,
   verifyOrParseSession,
   verifyPkce,
   verifySession,