@mastra/code-sdk 0.0.0-client-tool-results-20260912062135

package/dist/auth/device-code.js

@@ -0,0 +1,129 @@
+//#region src/auth/device-code.ts
+/**
+* Generic RFC 8628 (OAuth 2.0 Device Authorization Grant) polling helpers.
+*
+* Ported from pi-mono's device-code utility, restructured as a single-step
+* API so the same poll semantics can be driven two ways:
+*   - `pollDeviceCodeUntilComplete()` — blocking loop for TUI flows.
+*   - `stepDeviceCodePoll()` — exactly one upstream poll per call, with a
+*     JSON-serializable `DeviceCodePollState` so web routes can persist the
+*     state between HTTP requests (any replica can continue the poll).
+*
+* Inspired by pi-mono:
+* https://github.com/badlogic/pi-mono/blob/main/packages/ai/src/utils/oauth/device-code.ts
+*/
+const DEFAULT_INTERVAL_SECONDS = 5;
+const INITIAL_POLL_INTERVAL_MULTIPLIER = 1.2;
+const SLOW_DOWN_POLL_INTERVAL_MULTIPLIER = 1.4;
+const SLOW_DOWN_INTERVAL_INCREMENT_MS = 5e3;
+function createDeviceCodePollState(options) {
+	const now = options.now ?? Date.now();
+	const intervalSeconds = typeof options.intervalSeconds === "number" && options.intervalSeconds > 0 ? options.intervalSeconds : DEFAULT_INTERVAL_SECONDS;
+	return {
+		deadlineAt: now + options.expiresInSeconds * 1e3,
+		intervalMs: Math.max(1e3, Math.floor(intervalSeconds * 1e3)),
+		slowDownResponses: 0
+	};
+}
+function timeoutMessage(state) {
+	if (state.slowDownResponses > 0) return "Device flow timed out after one or more slow_down responses. This is often caused by clock drift in WSL or VM environments. Please sync or restart the VM clock and try again.";
+	return "Device flow timed out";
+}
+/**
+* Delay to wait before the next poll, honoring slow_down growth and clamped
+* to the remaining lifetime of the device code.
+*/
+function nextPollDelayMs(state, now = Date.now()) {
+	const multiplier = state.slowDownResponses > 0 ? SLOW_DOWN_POLL_INTERVAL_MULTIPLIER : INITIAL_POLL_INTERVAL_MULTIPLIER;
+	const remainingMs = Math.max(0, state.deadlineAt - now);
+	return Math.min(Math.ceil(state.intervalMs * multiplier), remainingMs);
+}
+/**
+* Perform exactly one upstream poll and fold the outcome into the poll state.
+* Never throws for flow-level conditions — timeouts and provider errors are
+* reported as `{ status: 'failed' }` so callers can persist/report them.
+*/
+async function stepDeviceCodePoll(state, pollOnce, now = Date.now()) {
+	if (now >= state.deadlineAt) return {
+		status: "failed",
+		error: timeoutMessage(state),
+		state
+	};
+	const outcome = await pollOnce();
+	switch (outcome.status) {
+		case "complete": return {
+			status: "complete",
+			result: outcome.result,
+			state
+		};
+		case "failed": return {
+			status: "failed",
+			error: outcome.error,
+			state
+		};
+		case "slow_down": {
+			const next = {
+				...state,
+				slowDownResponses: state.slowDownResponses + 1,
+				intervalMs: typeof outcome.intervalSeconds === "number" && outcome.intervalSeconds > 0 ? outcome.intervalSeconds * 1e3 : Math.max(1e3, state.intervalMs + SLOW_DOWN_INTERVAL_INCREMENT_MS)
+			};
+			return {
+				status: "slow_down",
+				nextPollMs: nextPollDelayMs(next, now),
+				state: next
+			};
+		}
+		case "pending": {
+			const next = typeof outcome.intervalSeconds === "number" && outcome.intervalSeconds > 0 ? {
+				...state,
+				intervalMs: Math.max(1e3, outcome.intervalSeconds * 1e3)
+			} : state;
+			return {
+				status: "pending",
+				nextPollMs: nextPollDelayMs(next, now),
+				state: next
+			};
+		}
+	}
+}
+/** Sleep that can be interrupted by an AbortSignal. */
+function abortableSleep(ms, signal) {
+	return new Promise((resolve, reject) => {
+		if (signal?.aborted) {
+			reject(/* @__PURE__ */ new Error("Login cancelled"));
+			return;
+		}
+		let timeout;
+		const onAbort = () => {
+			clearTimeout(timeout);
+			reject(/* @__PURE__ */ new Error("Login cancelled"));
+		};
+		timeout = setTimeout(() => {
+			signal?.removeEventListener("abort", onAbort);
+			resolve();
+		}, ms);
+		signal?.addEventListener("abort", onAbort, { once: true });
+	});
+}
+/**
+* Blocking poll loop for TUI flows: waits the appropriate interval between
+* polls, honors slow_down growth, aborts on the signal, and throws on
+* failure/timeout (with a clock-drift hint after slow_down responses).
+*/
+async function pollDeviceCodeUntilComplete(options) {
+	let state = options.state;
+	const sleep = options.sleep ?? abortableSleep;
+	while (true) {
+		if (options.signal?.aborted) throw new Error("Login cancelled");
+		if (Date.now() >= state.deadlineAt) throw new Error(timeoutMessage(state));
+		await sleep(nextPollDelayMs(state), options.signal);
+		const step = await stepDeviceCodePoll(state, options.pollOnce);
+		state = step.state;
+		if (step.status === "complete") return step.result;
+		if (step.status === "failed") throw new Error(step.error);
+	}
+}
+//#endregion
+export { abortableSleep, createDeviceCodePollState, nextPollDelayMs, pollDeviceCodeUntilComplete, stepDeviceCodePoll };
+
+//# sourceMappingURL=device-code.js.map

package/dist/auth/device-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-code.js","names":[],"sources":["../../src/auth/device-code.ts"],"sourcesContent":["/**\n * Generic RFC 8628 (OAuth 2.0 Device Authorization Grant) polling helpers.\n *\n * Ported from pi-mono's device-code utility, restructured as a single-step\n * API so the same poll semantics can be driven two ways:\n *   - `pollDeviceCodeUntilComplete()` — blocking loop for TUI flows.\n *   - `stepDeviceCodePoll()` — exactly one upstream poll per call, with a\n *     JSON-serializable `DeviceCodePollState` so web routes can persist the\n *     state between HTTP requests (any replica can continue the poll).\n *\n * Inspired by pi-mono:\n * https://github.com/badlogic/pi-mono/blob/main/packages/ai/src/utils/oauth/device-code.ts\n */\n\nconst DEFAULT_INTERVAL_SECONDS = 5;\nconst INITIAL_POLL_INTERVAL_MULTIPLIER = 1.2;\nconst SLOW_DOWN_POLL_INTERVAL_MULTIPLIER = 1.4;\nconst SLOW_DOWN_INTERVAL_INCREMENT_MS = 5000;\n\n/**\n * Serializable poll-loop state. Safe to round-trip through JSON (e.g. a\n * `pending jsonb` column) so device-code polling can span HTTP requests.\n */\nexport interface DeviceCodePollState {\n  /** ms epoch after which the device authorization is considered expired. */\n  deadlineAt: number;\n  /** Current base poll interval in ms (grows on slow_down responses). */\n  intervalMs: number;\n  /** Number of slow_down responses observed so far. */\n  slowDownResponses: number;\n}\n\nexport function createDeviceCodePollState(options: {\n  /** Poll interval suggested by the server, in seconds. Defaults to 5 (RFC 8628). */\n  intervalSeconds?: number;\n  /** Lifetime of the device code, in seconds. */\n  expiresInSeconds: number;\n  /** Override \"now\" for tests. */\n  now?: number;\n}): DeviceCodePollState {\n  const now = options.now ?? Date.now();\n  const intervalSeconds =\n    typeof options.intervalSeconds === 'number' && options.intervalSeconds > 0\n      ? options.intervalSeconds\n      : DEFAULT_INTERVAL_SECONDS;\n  return {\n    deadlineAt: now + options.expiresInSeconds * 1000,\n    intervalMs: Math.max(1000, Math.floor(intervalSeconds * 1000)),\n    slowDownResponses: 0,\n  };\n}\n\n/**\n * Classified result of one upstream token-endpoint poll. Providers implement\n * the HTTP request and map their response shape onto this union.\n */\nexport type DeviceCodePollOutcome<T> =\n  | { status: 'complete'; result: T }\n  | { status: 'pending'; intervalSeconds?: number }\n  | { status: 'slow_down'; intervalSeconds?: number }\n  | { status: 'failed'; error: string };\n\nexport type DeviceCodeStepResult<T> =\n  | { status: 'complete'; result: T; state: DeviceCodePollState }\n  | { status: 'pending'; nextPollMs: number; state: DeviceCodePollState }\n  | { status: 'slow_down'; nextPollMs: number; state: DeviceCodePollState }\n  | { status: 'failed'; error: string; state: DeviceCodePollState };\n\nfunction timeoutMessage(state: DeviceCodePollState): string {\n  if (state.slowDownResponses > 0) {\n    // Repeated slow_down responses followed by a timeout usually means the\n    // local clock is behind the server's (common in WSL/VMs after sleep).\n    return 'Device flow timed out after one or more slow_down responses. This is often caused by clock drift in WSL or VM environments. Please sync or restart the VM clock and try again.';\n  }\n  return 'Device flow timed out';\n}\n\n/**\n * Delay to wait before the next poll, honoring slow_down growth and clamped\n * to the remaining lifetime of the device code.\n */\nexport function nextPollDelayMs(state: DeviceCodePollState, now: number = Date.now()): number {\n  const multiplier =\n    state.slowDownResponses > 0 ? SLOW_DOWN_POLL_INTERVAL_MULTIPLIER : INITIAL_POLL_INTERVAL_MULTIPLIER;\n  const remainingMs = Math.max(0, state.deadlineAt - now);\n  return Math.min(Math.ceil(state.intervalMs * multiplier), remainingMs);\n}\n\n/**\n * Perform exactly one upstream poll and fold the outcome into the poll state.\n * Never throws for flow-level conditions — timeouts and provider errors are\n * reported as `{ status: 'failed' }` so callers can persist/report them.\n */\nexport async function stepDeviceCodePoll<T>(\n  state: DeviceCodePollState,\n  pollOnce: () => Promise<DeviceCodePollOutcome<T>>,\n  now: number = Date.now(),\n): Promise<DeviceCodeStepResult<T>> {\n  if (now >= state.deadlineAt) {\n    return { status: 'failed', error: timeoutMessage(state), state };\n  }\n\n  const outcome = await pollOnce();\n\n  switch (outcome.status) {\n    case 'complete':\n      return { status: 'complete', result: outcome.result, state };\n    case 'failed':\n      return { status: 'failed', error: outcome.error, state };\n    case 'slow_down': {\n      const next: DeviceCodePollState = {\n        ...state,\n        slowDownResponses: state.slowDownResponses + 1,\n        // RFC 8628 section 3.5: grow the interval by 5 seconds, unless the\n        // server told us the interval to use.\n        intervalMs:\n          typeof outcome.intervalSeconds === 'number' && outcome.intervalSeconds > 0\n            ? outcome.intervalSeconds * 1000\n            : Math.max(1000, state.intervalMs + SLOW_DOWN_INTERVAL_INCREMENT_MS),\n      };\n      return { status: 'slow_down', nextPollMs: nextPollDelayMs(next, now), state: next };\n    }\n    case 'pending': {\n      const next: DeviceCodePollState =\n        typeof outcome.intervalSeconds === 'number' && outcome.intervalSeconds > 0\n          ? { ...state, intervalMs: Math.max(1000, outcome.intervalSeconds * 1000) }\n          : state;\n      return { status: 'pending', nextPollMs: nextPollDelayMs(next, now), state: next };\n    }\n  }\n}\n\n/** Sleep that can be interrupted by an AbortSignal. */\nexport function abortableSleep(ms: number, signal?: AbortSignal): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (signal?.aborted) {\n      reject(new Error('Login cancelled'));\n      return;\n    }\n\n    let timeout: ReturnType<typeof setTimeout>;\n    const onAbort = () => {\n      clearTimeout(timeout);\n      reject(new Error('Login cancelled'));\n    };\n\n    timeout = setTimeout(() => {\n      signal?.removeEventListener('abort', onAbort);\n      resolve();\n    }, ms);\n\n    signal?.addEventListener('abort', onAbort, { once: true });\n  });\n}\n\n/**\n * Blocking poll loop for TUI flows: waits the appropriate interval between\n * polls, honors slow_down growth, aborts on the signal, and throws on\n * failure/timeout (with a clock-drift hint after slow_down responses).\n */\nexport async function pollDeviceCodeUntilComplete<T>(options: {\n  state: DeviceCodePollState;\n  pollOnce: () => Promise<DeviceCodePollOutcome<T>>;\n  signal?: AbortSignal;\n  /** Override the sleep implementation for tests. */\n  sleep?: (ms: number, signal?: AbortSignal) => Promise<void>;\n}): Promise<T> {\n  let state = options.state;\n  const sleep = options.sleep ?? abortableSleep;\n\n  while (true) {\n    if (options.signal?.aborted) {\n      throw new Error('Login cancelled');\n    }\n    if (Date.now() >= state.deadlineAt) {\n      throw new Error(timeoutMessage(state));\n    }\n\n    await sleep(nextPollDelayMs(state), options.signal);\n\n    const step = await stepDeviceCodePoll(state, options.pollOnce);\n    state = step.state;\n\n    if (step.status === 'complete') {\n      return step.result;\n    }\n    if (step.status === 'failed') {\n      throw new Error(step.error);\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/auth/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * OAuth credential management for AI providers.
+ */
+export * from './types.js';
+export * from './provider-auth-error.js';
+export * from './storage.js';
+export { anthropicOAuthProvider } from './providers/anthropic.js';
+export { githubCopilotOAuthProvider } from './providers/github-copilot.js';
+export { kimiCodingOAuthProvider } from './providers/kimi-coding.js';
+export { openaiCodexOAuthProvider } from './providers/openai-codex.js';
+export { xaiOAuthProvider } from './providers/xai.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/auth/index.js

@@ -0,0 +1,8 @@
+import { anthropicOAuthProvider } from "./providers/anthropic.js";
+import { githubCopilotOAuthProvider } from "./providers/github-copilot.js";
+import { kimiCodingOAuthProvider } from "./providers/kimi-coding.js";
+import { openaiCodexOAuthProvider } from "./providers/openai-codex.js";
+import { xaiOAuthProvider } from "./providers/xai.js";
+import { AuthStorage, PROVIDER_DEFAULT_MODELS, getOAuthProvider, getOAuthProviders } from "./storage.js";
+import { PROVIDER_AUTH_REQUIRED_ERROR, ProviderAuthRequiredError } from "./provider-auth-error.js";
+export { AuthStorage, PROVIDER_AUTH_REQUIRED_ERROR, PROVIDER_DEFAULT_MODELS, ProviderAuthRequiredError, anthropicOAuthProvider, getOAuthProvider, getOAuthProviders, githubCopilotOAuthProvider, kimiCodingOAuthProvider, openaiCodexOAuthProvider, xaiOAuthProvider };

package/dist/auth/pkce.d.ts

@@ -0,0 +1,13 @@
+/**
+ * PKCE utilities using Web Crypto API.
+ * Works in both Node.js 20+ and browsers.
+ */
+/**
+ * Generate PKCE code verifier and challenge.
+ * Uses Web Crypto API for cross-platform compatibility.
+ */
+export declare function generatePKCE(): Promise<{
+    verifier: string;
+    challenge: string;
+}>;
+//# sourceMappingURL=pkce.d.ts.map

package/dist/auth/pkce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pkce.d.ts","sourceRoot":"","sources":["../../src/auth/pkce.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH;;;GAGG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,CAaD"}

package/dist/auth/pkce.js

@@ -0,0 +1,32 @@
+//#region src/auth/pkce.ts
+/**
+* PKCE utilities using Web Crypto API.
+* Works in both Node.js 20+ and browsers.
+*/
+/**
+* Encode bytes as base64url string.
+*/
+function base64urlEncode(bytes) {
+	let binary = "";
+	for (const byte of bytes) binary += String.fromCharCode(byte);
+	return btoa(binary).replace(/\+/g, "-").replace(/\//g, "_").replace(/=/g, "");
+}
+/**
+* Generate PKCE code verifier and challenge.
+* Uses Web Crypto API for cross-platform compatibility.
+*/
+async function generatePKCE() {
+	const verifierBytes = /* @__PURE__ */ new Uint8Array(32);
+	crypto.getRandomValues(verifierBytes);
+	const verifier = base64urlEncode(verifierBytes);
+	const data = new TextEncoder().encode(verifier);
+	const hashBuffer = await crypto.subtle.digest("SHA-256", data);
+	return {
+		verifier,
+		challenge: base64urlEncode(new Uint8Array(hashBuffer))
+	};
+}
+//#endregion
+export { generatePKCE };
+
+//# sourceMappingURL=pkce.js.map

package/dist/auth/pkce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pkce.js","names":[],"sources":["../../src/auth/pkce.ts"],"sourcesContent":["/**\n * PKCE utilities using Web Crypto API.\n * Works in both Node.js 20+ and browsers.\n */\n\n/**\n * Encode bytes as base64url string.\n */\nfunction base64urlEncode(bytes: Uint8Array): string {\n  let binary = '';\n  for (const byte of bytes) {\n    binary += String.fromCharCode(byte);\n  }\n  return btoa(binary).replace(/\\+/g, '-').replace(/\\//g, '_').replace(/=/g, '');\n}\n\n/**\n * Generate PKCE code verifier and challenge.\n * Uses Web Crypto API for cross-platform compatibility.\n */\nexport async function generatePKCE(): Promise<{\n  verifier: string;\n  challenge: string;\n}> {\n  // Generate random verifier\n  const verifierBytes = new Uint8Array(32);\n  crypto.getRandomValues(verifierBytes);\n  const verifier = base64urlEncode(verifierBytes);\n\n  // Compute SHA-256 challenge\n  const encoder = new TextEncoder();\n  const data = encoder.encode(verifier);\n  const hashBuffer = await crypto.subtle.digest('SHA-256', data);\n  const challenge = base64urlEncode(new Uint8Array(hashBuffer));\n\n  return { verifier, challenge };\n}\n"],"mappings":";;;;;;;;AAQA,SAAS,gBAAgB,OAA2B;CAClD,IAAI,SAAS;CACb,KAAK,MAAM,QAAQ,OACjB,UAAU,OAAO,aAAa,IAAI;CAEpC,OAAO,KAAK,MAAM,CAAC,CAAC,QAAQ,OAAO,GAAG,CAAC,CAAC,QAAQ,OAAO,GAAG,CAAC,CAAC,QAAQ,MAAM,EAAE;AAC9E;;;;;AAMA,eAAsB,eAGnB;CAED,MAAM,gCAAgB,IAAI,WAAW,EAAE;CACvC,OAAO,gBAAgB,aAAa;CACpC,MAAM,WAAW,gBAAgB,aAAa;CAI9C,MAAM,OAAO,IADO,YACD,CAAC,CAAC,OAAO,QAAQ;CACpC,MAAM,aAAa,MAAM,OAAO,OAAO,OAAO,WAAW,IAAI;CAG7D,OAAO;EAAE;EAAU,WAFD,gBAAgB,IAAI,WAAW,UAAU,CAEhC;CAAE;AAC/B"}

package/dist/auth/provider-auth-error.d.ts

@@ -0,0 +1,12 @@
+/** Wire-stable `Error.name`: the server flattens errors to `{ name, message }`, so hosts match on this. */
+export declare const PROVIDER_AUTH_REQUIRED_ERROR = "ProviderAuthRequiredError";
+/**
+ * A provider credential is missing or no longer usable. The message states the
+ * fact only — how the user re-authenticates is the host's call (`/login` in the
+ * TUI, Settings → Models in the factory web UI), so no host advertises a
+ * command another host doesn't have.
+ */
+export declare class ProviderAuthRequiredError extends Error {
+    readonly name = "ProviderAuthRequiredError";
+}
+//# sourceMappingURL=provider-auth-error.d.ts.map

package/dist/auth/provider-auth-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-auth-error.d.ts","sourceRoot":"","sources":["../../src/auth/provider-auth-error.ts"],"names":[],"mappings":"AAAA,2GAA2G;AAC3G,eAAO,MAAM,4BAA4B,8BAA8B,CAAC;AAExE;;;;;GAKG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,IAAI,+BAAgC;CAC9C"}

package/dist/auth/provider-auth-error.js

@@ -0,0 +1,16 @@
+//#region src/auth/provider-auth-error.ts
+/** Wire-stable `Error.name`: the server flattens errors to `{ name, message }`, so hosts match on this. */
+const PROVIDER_AUTH_REQUIRED_ERROR = "ProviderAuthRequiredError";
+/**
+* A provider credential is missing or no longer usable. The message states the
+* fact only — how the user re-authenticates is the host's call (`/login` in the
+* TUI, Settings → Models in the factory web UI), so no host advertises a
+* command another host doesn't have.
+*/
+var ProviderAuthRequiredError = class extends Error {
+	name = PROVIDER_AUTH_REQUIRED_ERROR;
+};
+//#endregion
+export { PROVIDER_AUTH_REQUIRED_ERROR, ProviderAuthRequiredError };
+
+//# sourceMappingURL=provider-auth-error.js.map

package/dist/auth/provider-auth-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-auth-error.js","names":[],"sources":["../../src/auth/provider-auth-error.ts"],"sourcesContent":["/** Wire-stable `Error.name`: the server flattens errors to `{ name, message }`, so hosts match on this. */\nexport const PROVIDER_AUTH_REQUIRED_ERROR = 'ProviderAuthRequiredError';\n\n/**\n * A provider credential is missing or no longer usable. The message states the\n * fact only — how the user re-authenticates is the host's call (`/login` in the\n * TUI, Settings → Models in the factory web UI), so no host advertises a\n * command another host doesn't have.\n */\nexport class ProviderAuthRequiredError extends Error {\n  readonly name = PROVIDER_AUTH_REQUIRED_ERROR;\n}\n"],"mappings":";;AACA,MAAa,+BAA+B;;;;;;;AAQ5C,IAAa,4BAAb,cAA+C,MAAM;CACnD,OAAgB;AAClB"}

package/dist/auth/providers/anthropic.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Anthropic OAuth flow (Claude Pro/Max)
+ *
+ * Inspired by pi-mono's OAuth implementation:
+ * https://github.com/badlogic/pi-mono/blob/main/packages/ai/src/utils/oauth/anthropic.ts
+ *
+ * The flow is a paste-code PKCE flow: the redirect lands on Anthropic's hosted
+ * callback page which displays `code#state` for the user to paste back. That
+ * makes it deployable without any inbound connection to the server, so the
+ * primitives are split into `startAnthropicLogin()` / `completeAnthropicLogin()`
+ * which can span separate HTTP requests (only the PKCE verifier needs to be
+ * persisted in between).
+ */
+import type { OAuthCredentials, OAuthProviderInterface } from '../types.js';
+export interface AnthropicLoginStart {
+    /** Authorization URL for the user to open. */
+    url: string;
+    /** PKCE code verifier — persist it to complete the login later. */
+    verifier: string;
+}
+/**
+ * Start an Anthropic login: generate PKCE state and build the authorization URL.
+ */
+export declare function startAnthropicLogin(): Promise<AnthropicLoginStart>;
+/**
+ * Complete an Anthropic login: parse the pasted authorization input
+ * (full URL, `code#state`, or query string), validate its state, and exchange
+ * it for tokens using the verifier from `startAnthropicLogin()`.
+ */
+export declare function completeAnthropicLogin(input: string, verifier: string): Promise<OAuthCredentials>;
+/**
+ * Login with Anthropic OAuth (paste-code flow), blocking on the prompt callback.
+ */
+export declare function loginAnthropic(onAuthUrl: (url: string) => void, onPromptCode: () => Promise<string>): Promise<OAuthCredentials>;
+/**
+ * Refresh Anthropic OAuth token
+ */
+export declare function refreshAnthropicToken(refreshToken: string): Promise<OAuthCredentials>;
+export declare const anthropicOAuthProvider: OAuthProviderInterface;
+//# sourceMappingURL=anthropic.d.ts.map

package/dist/auth/providers/anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../../src/auth/providers/anthropic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAuB,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAYjG,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAexE;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA+CvG;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,EAChC,YAAY,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAClC,OAAO,CAAC,gBAAgB,CAAC,CAU3B;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA4B3F;AAED,eAAO,MAAM,sBAAsB,EAAE,sBAkBpC,CAAC"}

package/dist/auth/providers/anthropic.js

@@ -0,0 +1,126 @@
+import { parseAuthorizationInput } from "../authorization-input.js";
+import { generatePKCE } from "../pkce.js";
+//#region src/auth/providers/anthropic.ts
+/**
+* Anthropic OAuth flow (Claude Pro/Max)
+*
+* Inspired by pi-mono's OAuth implementation:
+* https://github.com/badlogic/pi-mono/blob/main/packages/ai/src/utils/oauth/anthropic.ts
+*
+* The flow is a paste-code PKCE flow: the redirect lands on Anthropic's hosted
+* callback page which displays `code#state` for the user to paste back. That
+* makes it deployable without any inbound connection to the server, so the
+* primitives are split into `startAnthropicLogin()` / `completeAnthropicLogin()`
+* which can span separate HTTP requests (only the PKCE verifier needs to be
+* persisted in between).
+*/
+const decode = (s) => atob(s);
+const CLIENT_ID = decode("OWQxYzI1MGEtZTYxYi00NGQ5LTg4ZWQtNTk0NGQxOTYyZjVl");
+const AUTHORIZE_URL = "https://claude.ai/oauth/authorize";
+const TOKEN_URL = "https://console.anthropic.com/v1/oauth/token";
+const REDIRECT_URI = "https://console.anthropic.com/oauth/code/callback";
+const SCOPES = "org:create_api_key user:profile user:inference";
+/**
+* Start an Anthropic login: generate PKCE state and build the authorization URL.
+*/
+async function startAnthropicLogin() {
+	const { verifier, challenge } = await generatePKCE();
+	const authParams = new URLSearchParams({
+		code: "true",
+		client_id: CLIENT_ID,
+		response_type: "code",
+		redirect_uri: REDIRECT_URI,
+		scope: SCOPES,
+		code_challenge: challenge,
+		code_challenge_method: "S256",
+		state: verifier
+	});
+	return {
+		url: `${AUTHORIZE_URL}?${authParams.toString()}`,
+		verifier
+	};
+}
+/**
+* Complete an Anthropic login: parse the pasted authorization input
+* (full URL, `code#state`, or query string), validate its state, and exchange
+* it for tokens using the verifier from `startAnthropicLogin()`.
+*/
+async function completeAnthropicLogin(input, verifier) {
+	const { code, state } = parseAuthorizationInput(input);
+	if (!code) throw new Error("Missing authorization code");
+	if (!state || state !== verifier) throw new Error("Invalid authorization state");
+	const tokenResponse = await fetch(TOKEN_URL, {
+		method: "POST",
+		signal: AbortSignal.timeout(15e3),
+		headers: { "Content-Type": "application/json" },
+		body: JSON.stringify({
+			grant_type: "authorization_code",
+			client_id: CLIENT_ID,
+			code,
+			state,
+			redirect_uri: REDIRECT_URI,
+			code_verifier: verifier
+		})
+	});
+	if (!tokenResponse.ok) {
+		const error = await tokenResponse.text();
+		throw new Error(`Token exchange failed: ${error}`);
+	}
+	const tokenData = await tokenResponse.json();
+	const expiresAt = Date.now() + tokenData.expires_in * 1e3 - 300 * 1e3;
+	return {
+		refresh: tokenData.refresh_token,
+		access: tokenData.access_token,
+		expires: expiresAt
+	};
+}
+/**
+* Login with Anthropic OAuth (paste-code flow), blocking on the prompt callback.
+*/
+async function loginAnthropic(onAuthUrl, onPromptCode) {
+	const { url, verifier } = await startAnthropicLogin();
+	onAuthUrl(url);
+	return completeAnthropicLogin(await onPromptCode(), verifier);
+}
+/**
+* Refresh Anthropic OAuth token
+*/
+async function refreshAnthropicToken(refreshToken) {
+	const response = await fetch(TOKEN_URL, {
+		method: "POST",
+		signal: AbortSignal.timeout(15e3),
+		headers: { "Content-Type": "application/json" },
+		body: JSON.stringify({
+			grant_type: "refresh_token",
+			client_id: CLIENT_ID,
+			refresh_token: refreshToken
+		})
+	});
+	if (!response.ok) {
+		const error = await response.text();
+		throw new Error(`Anthropic token refresh failed: ${error}`);
+	}
+	const data = await response.json();
+	return {
+		refresh: data.refresh_token,
+		access: data.access_token,
+		expires: Date.now() + data.expires_in * 1e3 - 300 * 1e3
+	};
+}
+const anthropicOAuthProvider = {
+	id: "anthropic",
+	name: "Anthropic (Claude Pro/Max)",
+	async login(callbacks) {
+		return loginAnthropic((url) => callbacks.onAuth({ url }), () => callbacks.onPrompt({ message: "Paste the authorization code:" }));
+	},
+	async refreshToken(credentials) {
+		return refreshAnthropicToken(credentials.refresh);
+	},
+	getApiKey(credentials) {
+		return credentials.access;
+	}
+};
+//#endregion
+export { anthropicOAuthProvider, completeAnthropicLogin, loginAnthropic, refreshAnthropicToken, startAnthropicLogin };
+
+//# sourceMappingURL=anthropic.js.map

package/dist/auth/providers/anthropic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.js","names":[],"sources":["../../../src/auth/providers/anthropic.ts"],"sourcesContent":["/**\n * Anthropic OAuth flow (Claude Pro/Max)\n *\n * Inspired by pi-mono's OAuth implementation:\n * https://github.com/badlogic/pi-mono/blob/main/packages/ai/src/utils/oauth/anthropic.ts\n *\n * The flow is a paste-code PKCE flow: the redirect lands on Anthropic's hosted\n * callback page which displays `code#state` for the user to paste back. That\n * makes it deployable without any inbound connection to the server, so the\n * primitives are split into `startAnthropicLogin()` / `completeAnthropicLogin()`\n * which can span separate HTTP requests (only the PKCE verifier needs to be\n * persisted in between).\n */\n\nimport { parseAuthorizationInput } from '../authorization-input.js';\nimport { generatePKCE } from '../pkce.js';\nimport type { OAuthCredentials, OAuthLoginCallbacks, OAuthProviderInterface } from '../types.js';\n\nconst decode = (s: string) => atob(s);\nconst CLIENT_ID = decode('OWQxYzI1MGEtZTYxYi00NGQ5LTg4ZWQtNTk0NGQxOTYyZjVl');\nconst AUTHORIZE_URL = 'https://claude.ai/oauth/authorize';\n// pi-mono uses `https://platform.claude.com/v1/oauth/token` with extra scopes\n// (user:sessions:claude_code, user:mcp_servers, user:file_upload); we keep the\n// console.anthropic.com endpoints that are known to work for our scope set.\nconst TOKEN_URL = 'https://console.anthropic.com/v1/oauth/token';\nconst REDIRECT_URI = 'https://console.anthropic.com/oauth/code/callback';\nconst SCOPES = 'org:create_api_key user:profile user:inference';\n\nexport interface AnthropicLoginStart {\n  /** Authorization URL for the user to open. */\n  url: string;\n  /** PKCE code verifier — persist it to complete the login later. */\n  verifier: string;\n}\n\n/**\n * Start an Anthropic login: generate PKCE state and build the authorization URL.\n */\nexport async function startAnthropicLogin(): Promise<AnthropicLoginStart> {\n  const { verifier, challenge } = await generatePKCE();\n\n  const authParams = new URLSearchParams({\n    code: 'true',\n    client_id: CLIENT_ID,\n    response_type: 'code',\n    redirect_uri: REDIRECT_URI,\n    scope: SCOPES,\n    code_challenge: challenge,\n    code_challenge_method: 'S256',\n    state: verifier,\n  });\n\n  return { url: `${AUTHORIZE_URL}?${authParams.toString()}`, verifier };\n}\n\n/**\n * Complete an Anthropic login: parse the pasted authorization input\n * (full URL, `code#state`, or query string), validate its state, and exchange\n * it for tokens using the verifier from `startAnthropicLogin()`.\n */\nexport async function completeAnthropicLogin(input: string, verifier: string): Promise<OAuthCredentials> {\n  const { code, state } = parseAuthorizationInput(input);\n  if (!code) {\n    throw new Error('Missing authorization code');\n  }\n  if (!state || state !== verifier) {\n    throw new Error('Invalid authorization state');\n  }\n\n  const tokenResponse = await fetch(TOKEN_URL, {\n    method: 'POST',\n    // Bound the OAuth exchange so an unresponsive upstream cannot pin the\n    // caller (and, in the shipyard server, the containing project lock)\n    // indefinitely. See 2025-07-23 shipyard latency incident.\n    signal: AbortSignal.timeout(15_000),\n    headers: {\n      'Content-Type': 'application/json',\n    },\n    body: JSON.stringify({\n      grant_type: 'authorization_code',\n      client_id: CLIENT_ID,\n      code,\n      state,\n      redirect_uri: REDIRECT_URI,\n      code_verifier: verifier,\n    }),\n  });\n\n  if (!tokenResponse.ok) {\n    const error = await tokenResponse.text();\n    throw new Error(`Token exchange failed: ${error}`);\n  }\n\n  const tokenData = (await tokenResponse.json()) as {\n    access_token: string;\n    refresh_token: string;\n    expires_in: number;\n  };\n\n  // Calculate expiry time (current time + expires_in seconds - 5 min buffer)\n  const expiresAt = Date.now() + tokenData.expires_in * 1000 - 5 * 60 * 1000;\n\n  return {\n    refresh: tokenData.refresh_token,\n    access: tokenData.access_token,\n    expires: expiresAt,\n  };\n}\n\n/**\n * Login with Anthropic OAuth (paste-code flow), blocking on the prompt callback.\n */\nexport async function loginAnthropic(\n  onAuthUrl: (url: string) => void,\n  onPromptCode: () => Promise<string>,\n): Promise<OAuthCredentials> {\n  const { url, verifier } = await startAnthropicLogin();\n\n  // Notify caller with URL to open\n  onAuthUrl(url);\n\n  // Wait for user to paste authorization code (format: code#state)\n  const authCode = await onPromptCode();\n\n  return completeAnthropicLogin(authCode, verifier);\n}\n\n/**\n * Refresh Anthropic OAuth token\n */\nexport async function refreshAnthropicToken(refreshToken: string): Promise<OAuthCredentials> {\n  const response = await fetch(TOKEN_URL, {\n    method: 'POST',\n    signal: AbortSignal.timeout(15_000),\n    headers: { 'Content-Type': 'application/json' },\n    body: JSON.stringify({\n      grant_type: 'refresh_token',\n      client_id: CLIENT_ID,\n      refresh_token: refreshToken,\n    }),\n  });\n\n  if (!response.ok) {\n    const error = await response.text();\n    throw new Error(`Anthropic token refresh failed: ${error}`);\n  }\n\n  const data = (await response.json()) as {\n    access_token: string;\n    refresh_token: string;\n    expires_in: number;\n  };\n\n  return {\n    refresh: data.refresh_token,\n    access: data.access_token,\n    expires: Date.now() + data.expires_in * 1000 - 5 * 60 * 1000,\n  };\n}\n\nexport const anthropicOAuthProvider: OAuthProviderInterface = {\n  id: 'anthropic',\n  name: 'Anthropic (Claude Pro/Max)',\n\n  async login(callbacks: OAuthLoginCallbacks): Promise<OAuthCredentials> {\n    return loginAnthropic(\n      url => callbacks.onAuth({ url }),\n      () => callbacks.onPrompt({ message: 'Paste the authorization code:' }),\n    );\n  },\n\n  async refreshToken(credentials: OAuthCredentials): Promise<OAuthCredentials> {\n    return refreshAnthropicToken(credentials.refresh);\n  },\n\n  getApiKey(credentials: OAuthCredentials): string {\n    return credentials.access;\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;;AAkBA,MAAM,UAAU,MAAc,KAAK,CAAC;AACpC,MAAM,YAAY,OAAO,kDAAkD;AAC3E,MAAM,gBAAgB;AAItB,MAAM,YAAY;AAClB,MAAM,eAAe;AACrB,MAAM,SAAS;;;;AAYf,eAAsB,sBAAoD;CACxE,MAAM,EAAE,UAAU,cAAc,MAAM,aAAa;CAEnD,MAAM,aAAa,IAAI,gBAAgB;EACrC,MAAM;EACN,WAAW;EACX,eAAe;EACf,cAAc;EACd,OAAO;EACP,gBAAgB;EAChB,uBAAuB;EACvB,OAAO;CACT,CAAC;CAED,OAAO;EAAE,KAAK,GAAG,cAAc,GAAG,WAAW,SAAS;EAAK;CAAS;AACtE;;;;;;AAOA,eAAsB,uBAAuB,OAAe,UAA6C;CACvG,MAAM,EAAE,MAAM,UAAU,wBAAwB,KAAK;CACrD,IAAI,CAAC,MACH,MAAM,IAAI,MAAM,4BAA4B;CAE9C,IAAI,CAAC,SAAS,UAAU,UACtB,MAAM,IAAI,MAAM,6BAA6B;CAG/C,MAAM,gBAAgB,MAAM,MAAM,WAAW;EAC3C,QAAQ;EAIR,QAAQ,YAAY,QAAQ,IAAM;EAClC,SAAS,EACP,gBAAgB,mBAClB;EACA,MAAM,KAAK,UAAU;GACnB,YAAY;GACZ,WAAW;GACX;GACA;GACA,cAAc;GACd,eAAe;EACjB,CAAC;CACH,CAAC;CAED,IAAI,CAAC,cAAc,IAAI;EACrB,MAAM,QAAQ,MAAM,cAAc,KAAK;EACvC,MAAM,IAAI,MAAM,0BAA0B,OAAO;CACnD;CAEA,MAAM,YAAa,MAAM,cAAc,KAAK;CAO5C,MAAM,YAAY,KAAK,IAAI,IAAI,UAAU,aAAa,MAAO,MAAS;CAEtE,OAAO;EACL,SAAS,UAAU;EACnB,QAAQ,UAAU;EAClB,SAAS;CACX;AACF;;;;AAKA,eAAsB,eACpB,WACA,cAC2B;CAC3B,MAAM,EAAE,KAAK,aAAa,MAAM,oBAAoB;CAGpD,UAAU,GAAG;CAKb,OAAO,uBAAuB,MAFP,aAAa,GAEI,QAAQ;AAClD;;;;AAKA,eAAsB,sBAAsB,cAAiD;CAC3F,MAAM,WAAW,MAAM,MAAM,WAAW;EACtC,QAAQ;EACR,QAAQ,YAAY,QAAQ,IAAM;EAClC,SAAS,EAAE,gBAAgB,mBAAmB;EAC9C,MAAM,KAAK,UAAU;GACnB,YAAY;GACZ,WAAW;GACX,eAAe;EACjB,CAAC;CACH,CAAC;CAED,IAAI,CAAC,SAAS,IAAI;EAChB,MAAM,QAAQ,MAAM,SAAS,KAAK;EAClC,MAAM,IAAI,MAAM,mCAAmC,OAAO;CAC5D;CAEA,MAAM,OAAQ,MAAM,SAAS,KAAK;CAMlC,OAAO;EACL,SAAS,KAAK;EACd,QAAQ,KAAK;EACb,SAAS,KAAK,IAAI,IAAI,KAAK,aAAa,MAAO,MAAS;CAC1D;AACF;AAEA,MAAa,yBAAiD;CAC5D,IAAI;CACJ,MAAM;CAEN,MAAM,MAAM,WAA2D;EACrE,OAAO,gBACL,QAAO,UAAU,OAAO,EAAE,IAAI,CAAC,SACzB,UAAU,SAAS,EAAE,SAAS,gCAAgC,CAAC,CACvE;CACF;CAEA,MAAM,aAAa,aAA0D;EAC3E,OAAO,sBAAsB,YAAY,OAAO;CAClD;CAEA,UAAU,aAAuC;EAC/C,OAAO,YAAY;CACrB;AACF"}

package/dist/auth/providers/github-copilot.d.ts

@@ -0,0 +1,154 @@
+/**
+ * GitHub Copilot OAuth flow
+ *
+ * Inspired by:
+ *   - pi-mono: https://github.com/badlogic/pi-mono/blob/main/packages/ai/src/utils/oauth/github-copilot.ts
+ *   - opencode: https://github.com/anomalyco/opencode/blob/dev/packages/opencode/src/plugin/github-copilot/copilot.ts
+ *
+ * Storage layout in AuthStorage:
+ *   - `refresh` holds the long-lived GitHub OAuth access token (used to mint Copilot tokens).
+ *   - `access`  holds the short-lived Copilot bearer token (~30 minutes).
+ *   - `expires` is the Copilot bearer expiry (ms epoch, with a 5-minute safety buffer).
+ *   - `enterpriseUrl` is the GitHub Enterprise hostname, or undefined for github.com.
+ */
+import type { OAuthCredentials, OAuthProviderInterface } from '../types.js';
+export type GitHubCopilotCredentials = OAuthCredentials & {
+    enterpriseUrl?: string;
+};
+export declare const COPILOT_USER_AGENT = "GitHubCopilotChat/0.35.0";
+/** Headers that Copilot endpoints expect from a VS Code-like client. */
+export declare const COPILOT_HEADERS: {
+    readonly 'User-Agent': "GitHubCopilotChat/0.35.0";
+    readonly 'Editor-Version': "vscode/1.107.0";
+    readonly 'Editor-Plugin-Version': "copilot-chat/0.35.0";
+    readonly 'Copilot-Integration-Id': "vscode-chat";
+};
+/**
+ * Normalize a user-entered Enterprise URL/domain into a hostname (e.g. `company.ghe.com`).
+ * Returns null for an empty input or an unparseable URL.
+ */
+export declare function normalizeDomain(input: string): string | null;
+/**
+ * Resolve the Copilot API base URL.
+ * Prefers the `proxy-ep` parsed from the bearer token, then falls back to enterprise/individual defaults.
+ */
+export declare function getGitHubCopilotBaseUrl(token?: string, enterpriseDomain?: string): string;
+/**
+ * Serializable pending state for a Copilot device-code login. Safe to persist
+ * (e.g. a `pending jsonb` column) so polling can span HTTP requests/replicas.
+ */
+export interface CopilotDeviceLoginPending {
+    /** GitHub host performing the flow (`github.com` or an Enterprise hostname). */
+    domain: string;
+    /** Enterprise hostname, or undefined for github.com. Recorded on the final credentials. */
+    enterpriseDomain?: string;
+    deviceCode: string;
+    userCode: string;
+    /** Verification URL for the user to open. */
+    url: string;
+    instructions: string;
+    /** Current base poll interval in ms (grows on slow_down). */
+    intervalMs: number;
+    /** Safety margin applied to intervalMs when computing the next wait. */
+    intervalMultiplier: number;
+    /** Number of slow_down responses seen (used for the clock-drift hint). */
+    slowDownCount: number;
+    /** ms epoch after which the device authorization expires. */
+    deadlineAt: number;
+}
+export type CopilotDevicePollResult = {
+    status: 'complete';
+    credentials: GitHubCopilotCredentials;
+} | {
+    status: 'pending';
+    pending: CopilotDeviceLoginPending;
+    nextPollMs: number;
+} | {
+    status: 'failed';
+    error: string;
+};
+/** Delay to wait before the next upstream poll for a pending Copilot device login. */
+export declare function copilotNextPollDelayMs(pending: CopilotDeviceLoginPending): number;
+/**
+ * Start a Copilot device-code login: request a user code and return the
+ * serializable pending state for subsequent polls. Wait `copilotNextPollDelayMs`
+ * before the first poll.
+ */
+export declare function startGitHubCopilotDeviceLogin(enterpriseDomain?: string, options?: {
+    signal?: AbortSignal;
+}): Promise<CopilotDeviceLoginPending>;
+/**
+ * Perform exactly one upstream poll for a pending Copilot device login.
+ * On success, exchanges the GitHub OAuth token for a Copilot bearer token and
+ * returns full credentials. Never throws for flow-level conditions; network
+ * errors from fetch still propagate.
+ */
+export declare function pollGitHubCopilotDeviceLogin(pending: CopilotDeviceLoginPending, options?: {
+    signal?: AbortSignal;
+    onProgress?: (message: string) => void;
+}): Promise<CopilotDevicePollResult>;
+/**
+ * Refresh the short-lived Copilot bearer token using the long-lived GitHub OAuth token.
+ *
+ * `refreshToken` here is the GitHub OAuth access token; the Copilot endpoint returns a
+ * fresh bearer token (`token`) and absolute expiry (`expires_at`, seconds since epoch).
+ */
+export declare function refreshGitHubCopilotToken(refreshToken: string, enterpriseDomain?: string, signal?: AbortSignal): Promise<GitHubCopilotCredentials>;
+/**
+ * Login with GitHub Copilot OAuth (device-code flow).
+ *
+ * Prompts for an optional GitHub Enterprise URL/domain, performs the device-code flow,
+ * then exchanges the GitHub OAuth token for a Copilot bearer token.
+ */
+export declare function loginGitHubCopilot(options: {
+    onAuth: (url: string, instructions?: string) => void;
+    onPrompt: (prompt: {
+        message: string;
+        placeholder?: string;
+        allowEmpty?: boolean;
+    }) => Promise<string>;
+    onProgress?: (message: string) => void;
+    signal?: AbortSignal;
+}): Promise<GitHubCopilotCredentials>;
+/**
+ * Filtered, normalized entry from the Copilot `/models` API.
+ *
+ * The full API payload includes a lot of capability metadata; we only keep the bits
+ * we need to expose models in `listAvailableModels()` and route requests sensibly.
+ */
+export type CopilotModelEntry = {
+    /** Stable model id (e.g. `claude-sonnet-4.5`, `gpt-4.1`). */
+    id: string;
+    /** Human-readable display name (e.g. `Claude Sonnet 4.5`). */
+    name: string;
+    /** Vendor field from the API (e.g. `Anthropic`, `OpenAI`). */
+    vendor: string;
+    /**
+     * Endpoints the model exposes (e.g. `/chat/completions`, `/responses`, `/v1/messages`).
+     * Empty when the API didn't return `supported_endpoints` for this entry.
+     */
+    supportedEndpoints: string[];
+    /** True when `supported_endpoints` includes `/v1/messages` (Anthropic-shaped Copilot model). */
+    isAnthropicShaped: boolean;
+    /** True when `capabilities.supports.vision` is true. */
+    supportsVision: boolean;
+    /** True when the model supports tool calling. */
+    supportsToolCalls: boolean;
+};
+/**
+ * Fetch the Copilot model list available to the current subscription.
+ *
+ * Hits `${baseURL}/models` with the Copilot bearer token, filters to
+ * `model_picker_enabled === true && policy.state !== 'disabled'`, and returns
+ * a normalized list. Mirrors opencode's filtering rules.
+ *
+ * Inspired by:
+ *   - opencode: https://github.com/anomalyco/opencode/blob/dev/packages/opencode/src/plugin/github-copilot/models.ts
+ */
+export declare function fetchCopilotModels(opts: {
+    baseUrl: string;
+    bearerToken: string;
+    signal?: AbortSignal;
+}): Promise<CopilotModelEntry[]>;
+export declare const githubCopilotOAuthProvider: OAuthProviderInterface;
+//# sourceMappingURL=github-copilot.d.ts.map

package/dist/auth/providers/github-copilot.d.ts.map

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