strands-darwin 0.0.43 → 0.0.45

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (99) hide show
  1. package/README.md +4 -1
  2. package/README.zh-CN.md +4 -1
  3. package/dist/patches/ink+7.1.1.patch +15 -0
  4. package/dist/src/agent/context-breakdown.d.ts +26 -3
  5. package/dist/src/agent/context-breakdown.js +27 -1
  6. package/dist/src/agent/context-breakdown.js.map +1 -1
  7. package/dist/src/agent/goal-check.d.ts +35 -0
  8. package/dist/src/agent/goal-check.js +132 -0
  9. package/dist/src/agent/goal-check.js.map +1 -0
  10. package/dist/src/agent/model-retry.d.ts +6 -1
  11. package/dist/src/agent/model-retry.js +45 -9
  12. package/dist/src/agent/model-retry.js.map +1 -1
  13. package/dist/src/agent/permission-rules.d.ts +31 -13
  14. package/dist/src/agent/permission-rules.js +180 -20
  15. package/dist/src/agent/permission-rules.js.map +1 -1
  16. package/dist/src/agent/permission.d.ts +0 -6
  17. package/dist/src/agent/permission.js +4 -3
  18. package/dist/src/agent/permission.js.map +1 -1
  19. package/dist/src/agent/runtime.d.ts +9 -0
  20. package/dist/src/agent/runtime.js +39 -3
  21. package/dist/src/agent/runtime.js.map +1 -1
  22. package/dist/src/agent/safety-classifier.d.ts +3 -1
  23. package/dist/src/agent/safety-classifier.js +0 -0
  24. package/dist/src/agent/safety-classifier.js.map +1 -1
  25. package/dist/src/agent/working-context.d.ts +16 -0
  26. package/dist/src/agent/working-context.js +20 -0
  27. package/dist/src/agent/working-context.js.map +1 -1
  28. package/dist/src/cli-main.js +36 -1
  29. package/dist/src/cli-main.js.map +1 -1
  30. package/dist/src/cli-mcp.d.ts +12 -0
  31. package/dist/src/cli-mcp.js +111 -0
  32. package/dist/src/cli-mcp.js.map +1 -0
  33. package/dist/src/cli-usage.d.ts +1 -1
  34. package/dist/src/cli-usage.js +2 -0
  35. package/dist/src/cli-usage.js.map +1 -1
  36. package/dist/src/cli.js +4 -0
  37. package/dist/src/cli.js.map +1 -1
  38. package/dist/src/collaboration/command.js +1 -1
  39. package/dist/src/collaboration/command.js.map +1 -1
  40. package/dist/src/collaboration/hub-command.d.ts +7 -0
  41. package/dist/src/collaboration/hub-command.js +23 -0
  42. package/dist/src/collaboration/hub-command.js.map +1 -1
  43. package/dist/src/collaboration/local.d.ts +137 -6
  44. package/dist/src/collaboration/local.js +76 -19
  45. package/dist/src/collaboration/local.js.map +1 -1
  46. package/dist/src/collaboration/tools.js +1 -1
  47. package/dist/src/collaboration/tools.js.map +1 -1
  48. package/dist/src/commands/custom-commands.d.ts +1 -1
  49. package/dist/src/commands/custom-commands.js +3 -1
  50. package/dist/src/commands/custom-commands.js.map +1 -1
  51. package/dist/src/commands/goal-command.d.ts +26 -0
  52. package/dist/src/commands/goal-command.js +32 -0
  53. package/dist/src/commands/goal-command.js.map +1 -0
  54. package/dist/src/config.d.ts +15 -6
  55. package/dist/src/config.js +3 -0
  56. package/dist/src/config.js.map +1 -1
  57. package/dist/src/mcp/oauth-login.d.ts +37 -0
  58. package/dist/src/mcp/oauth-login.js +263 -0
  59. package/dist/src/mcp/oauth-login.js.map +1 -0
  60. package/dist/src/mcp/oauth-net.d.ts +50 -0
  61. package/dist/src/mcp/oauth-net.js +321 -0
  62. package/dist/src/mcp/oauth-net.js.map +1 -0
  63. package/dist/src/mcp/oauth-provider.d.ts +89 -0
  64. package/dist/src/mcp/oauth-provider.js +398 -0
  65. package/dist/src/mcp/oauth-provider.js.map +1 -0
  66. package/dist/src/mcp/oauth-store.d.ts +49 -0
  67. package/dist/src/mcp/oauth-store.js +176 -0
  68. package/dist/src/mcp/oauth-store.js.map +1 -0
  69. package/dist/src/mcp/registry.d.ts +6 -0
  70. package/dist/src/mcp/registry.js +83 -4
  71. package/dist/src/mcp/registry.js.map +1 -1
  72. package/dist/src/tools/shell-env.d.ts +27 -1
  73. package/dist/src/tools/shell-env.js +34 -5
  74. package/dist/src/tools/shell-env.js.map +1 -1
  75. package/dist/src/tui/App.d.ts +4 -1
  76. package/dist/src/tui/App.js +209 -10
  77. package/dist/src/tui/App.js.map +1 -1
  78. package/dist/src/tui/InputBox.d.ts +1 -1
  79. package/dist/src/tui/InputBox.js +1 -1
  80. package/dist/src/tui/context-format.d.ts +7 -3
  81. package/dist/src/tui/context-format.js +28 -3
  82. package/dist/src/tui/context-format.js.map +1 -1
  83. package/dist/src/tui/goal.d.ts +123 -0
  84. package/dist/src/tui/goal.js +187 -0
  85. package/dist/src/tui/goal.js.map +1 -0
  86. package/dist/src/tui/help-format.d.ts +1 -1
  87. package/dist/src/tui/help-format.js +1 -1
  88. package/dist/src/tui/mcp-format.js +5 -1
  89. package/dist/src/tui/mcp-format.js.map +1 -1
  90. package/dist/src/tui/prompt-editor.d.ts +4 -3
  91. package/dist/src/tui/prompt-editor.js +8 -3
  92. package/dist/src/tui/prompt-editor.js.map +1 -1
  93. package/dist/src/update-check.d.ts +45 -0
  94. package/dist/src/update-check.js +184 -0
  95. package/dist/src/update-check.js.map +1 -0
  96. package/dist/src/version.d.ts +6 -0
  97. package/dist/src/version.js +13 -5
  98. package/dist/src/version.js.map +1 -1
  99. package/package.json +1 -1
@@ -0,0 +1,321 @@
1
+ /**
2
+ * Network policy for MCP OAuth (SER-107): which URLs an OAuth exchange may touch, and the one
3
+ * fetch every interactive-login request goes through.
4
+ *
5
+ * An MCP server — and, through its metadata, whatever authorization server it names — is
6
+ * attacker-influenced input the moment a checkout or a third party controls it. So every URL that
7
+ * comes out of discovery (protected-resource metadata, authorization-server metadata, the
8
+ * authorization, token and registration endpoints, redirects) is checked here before darwin
9
+ * requests it or sends a user's browser to it: `https` only (plain `http` only for a loopback
10
+ * host, and only when the MCP server itself is local), no credentials or fragments in the URL,
11
+ * and no loopback / private / link-local / metadata-service address unless the configured MCP
12
+ * server is itself on such an address (or the user set `allowPrivateNetwork`). Names are checked
13
+ * again where the socket is opened — a `lookup` hook that sees the addresses actually connected
14
+ * to — so a hostname that resolves to a private address, or rebinds between check and use, is
15
+ * refused too.
16
+ *
17
+ * Nothing here logs, and nothing here knows a token: it moves bytes that the caller owns.
18
+ */
19
+ import dns from 'node:dns';
20
+ import http from 'node:http';
21
+ import https from 'node:https';
22
+ import net from 'node:net';
23
+ /** A refusal by the OAuth network policy. The message is safe to show: it never carries a secret. */
24
+ export class OAuthPolicyError extends Error {
25
+ constructor(message) {
26
+ super(message);
27
+ this.name = 'OAuthPolicyError';
28
+ }
29
+ }
30
+ /** Longest URL accepted from any metadata document. */
31
+ export const MAX_OAUTH_URL_LENGTH = 2048;
32
+ /** Largest response body any OAuth request may return. */
33
+ export const MAX_OAUTH_RESPONSE_BYTES = 1024 * 1024;
34
+ /** Per-request ceiling, connect through last byte. */
35
+ export const OAUTH_REQUEST_TIMEOUT_MS = 15_000;
36
+ const MAX_REDIRECTS = 3;
37
+ function ipv4Bytes(address) {
38
+ const parts = address.split('.');
39
+ if (parts.length !== 4)
40
+ return undefined;
41
+ const bytes = parts.map((part) => (/^\d{1,3}$/.test(part) ? Number(part) : NaN));
42
+ return bytes.every((byte) => byte >= 0 && byte <= 255) ? bytes : undefined;
43
+ }
44
+ function ipv6Bytes(address) {
45
+ let text = address.toLowerCase();
46
+ const zone = text.indexOf('%');
47
+ if (zone >= 0)
48
+ text = text.slice(0, zone);
49
+ const dotted = /(\d+\.\d+\.\d+\.\d+)$/.exec(text);
50
+ if (dotted !== null) {
51
+ const v4 = ipv4Bytes(dotted[1]);
52
+ if (v4 === undefined)
53
+ return undefined;
54
+ text = `${text.slice(0, -dotted[1].length)}${((v4[0] << 8) | v4[1]).toString(16)}:${((v4[2] << 8) | v4[3]).toString(16)}`;
55
+ }
56
+ const halves = text.split('::');
57
+ if (halves.length > 2)
58
+ return undefined;
59
+ const head = halves[0] === '' ? [] : halves[0].split(':');
60
+ const tail = halves.length === 2 ? (halves[1] === '' ? [] : halves[1].split(':')) : [];
61
+ const missing = 8 - head.length - tail.length;
62
+ if (halves.length === 1 ? missing !== 0 : missing < 1)
63
+ return undefined;
64
+ const groups = [...head, ...Array(halves.length === 2 ? missing : 0).fill('0'), ...tail];
65
+ const bytes = [];
66
+ for (const group of groups) {
67
+ if (!/^[0-9a-f]{1,4}$/.test(group))
68
+ return undefined;
69
+ const value = Number.parseInt(group, 16);
70
+ bytes.push(value >> 8, value & 0xff);
71
+ }
72
+ return bytes;
73
+ }
74
+ /**
75
+ * Whether an address is anything but a globally routable unicast one: loopback, private,
76
+ * link-local (cloud metadata lives at 169.254.169.254), CGNAT, multicast, reserved,
77
+ * unspecified — and IPv4-mapped / NAT64 IPv6 forms of those. Unparseable text counts as
78
+ * non-public: the safe direction.
79
+ */
80
+ export function isNonPublicAddress(address) {
81
+ const bare = address.startsWith('[') && address.endsWith(']') ? address.slice(1, -1) : address;
82
+ if (net.isIPv4(bare)) {
83
+ const [a = 0, b = 0, c = 0] = ipv4Bytes(bare);
84
+ return (a === 0 || a === 10 || a === 127 || a >= 224 ||
85
+ (a === 100 && b >= 64 && b <= 127) ||
86
+ (a === 169 && b === 254) ||
87
+ (a === 172 && b >= 16 && b <= 31) ||
88
+ (a === 192 && b === 0 && c === 0) ||
89
+ (a === 192 && b === 168) ||
90
+ (a === 198 && (b === 18 || b === 19)));
91
+ }
92
+ if (net.isIPv6(bare)) {
93
+ const bytes = ipv6Bytes(bare);
94
+ if (bytes === undefined)
95
+ return true;
96
+ const allZeroUntil = (end) => bytes.slice(0, end).every((byte) => byte === 0);
97
+ if (allZeroUntil(15) && (bytes[15] === 0 || bytes[15] === 1))
98
+ return true; // :: and ::1
99
+ const embedded = () => bytes.slice(12).join('.');
100
+ if (allZeroUntil(10) && bytes[10] === 0xff && bytes[11] === 0xff)
101
+ return isNonPublicAddress(embedded()); // ::ffff:v4
102
+ if (allZeroUntil(12))
103
+ return true; // deprecated IPv4-compatible
104
+ if (bytes[0] === 0x00 && bytes[1] === 0x64 && bytes[2] === 0xff && bytes[3] === 0x9b && bytes.slice(4, 12).every((byte) => byte === 0)) {
105
+ return isNonPublicAddress(embedded()); // NAT64 64:ff9b::/96
106
+ }
107
+ return ((bytes[0] & 0xfe) === 0xfc || // fc00::/7 unique local
108
+ (bytes[0] === 0xfe && (bytes[1] & 0xc0) === 0x80) || // fe80::/10 link-local
109
+ bytes[0] === 0xff || // multicast
110
+ (bytes[0] === 0x20 && bytes[1] === 0x01 && bytes[2] === 0x0d && bytes[3] === 0xb8) // documentation
111
+ );
112
+ }
113
+ return true;
114
+ }
115
+ /** `localhost`, `*.localhost`, or a loopback literal. */
116
+ export function isLoopbackHost(hostname) {
117
+ const host = hostname.toLowerCase().replace(/^\[|\]$/g, '').replace(/\.$/, '');
118
+ if (host === 'localhost' || host.endsWith('.localhost'))
119
+ return true;
120
+ if (net.isIPv4(host))
121
+ return ipv4Bytes(host)[0] === 127;
122
+ if (net.isIPv6(host)) {
123
+ const bytes = ipv6Bytes(host);
124
+ if (bytes === undefined)
125
+ return false;
126
+ if (bytes.slice(0, 15).every((byte) => byte === 0) && bytes[15] === 1)
127
+ return true;
128
+ return bytes.slice(0, 10).every((byte) => byte === 0) && bytes[10] === 0xff && bytes[11] === 0xff && bytes[12] === 127;
129
+ }
130
+ return false;
131
+ }
132
+ /** A host that is `localhost` or an IP literal in a non-public range: a local/private MCP server. */
133
+ export function isPrivateLiteralHost(hostname) {
134
+ const host = hostname.toLowerCase().replace(/^\[|\]$/g, '').replace(/\.$/, '');
135
+ if (isLoopbackHost(host))
136
+ return true;
137
+ return net.isIP(host) !== 0 && isNonPublicAddress(host);
138
+ }
139
+ /**
140
+ * Parses and vets one URL that discovery, configuration or a redirect produced. Returns the parsed
141
+ * URL, or throws {@link OAuthPolicyError} naming `what` and the rule — never the URL's query.
142
+ */
143
+ export function validateOAuthUrl(raw, what, context) {
144
+ const text = raw instanceof URL ? raw.href : raw;
145
+ if (text.length > MAX_OAUTH_URL_LENGTH)
146
+ throw new OAuthPolicyError(`${what}: URL is longer than ${MAX_OAUTH_URL_LENGTH} characters`);
147
+ let url;
148
+ try {
149
+ url = new URL(text);
150
+ }
151
+ catch {
152
+ throw new OAuthPolicyError(`${what}: not a valid absolute URL`);
153
+ }
154
+ if (url.protocol !== 'https:' && url.protocol !== 'http:') {
155
+ throw new OAuthPolicyError(`${what}: scheme ${url.protocol.replace(':', '')} is not allowed (https only)`);
156
+ }
157
+ if (url.username !== '' || url.password !== '')
158
+ throw new OAuthPolicyError(`${what}: URL must not carry credentials`);
159
+ if (url.hash !== '')
160
+ throw new OAuthPolicyError(`${what}: URL must not carry a fragment`);
161
+ if (url.hostname === '')
162
+ throw new OAuthPolicyError(`${what}: URL has no host`);
163
+ const loopback = isLoopbackHost(url.hostname);
164
+ if (url.protocol === 'http:' && !(loopback && context.allowPrivate)) {
165
+ throw new OAuthPolicyError(`${what}: plain http is only allowed for a loopback host when the MCP server is local`);
166
+ }
167
+ if (!context.allowPrivate && isPrivateLiteralHost(url.hostname)) {
168
+ throw new OAuthPolicyError(`${what}: ${url.hostname} is a loopback/private address, which a non-local MCP server may not point at`);
169
+ }
170
+ return url;
171
+ }
172
+ function toHeaderRecord(headers) {
173
+ const out = {};
174
+ if (headers === undefined)
175
+ return out;
176
+ new Headers(headers).forEach((value, key) => {
177
+ out[key] = value;
178
+ });
179
+ return out;
180
+ }
181
+ function bodyText(body) {
182
+ if (body === undefined || body === null)
183
+ return undefined;
184
+ if (typeof body === 'string')
185
+ return body;
186
+ if (body instanceof URLSearchParams)
187
+ return body.toString();
188
+ throw new OAuthPolicyError('OAuth request body type is not supported');
189
+ }
190
+ /** `dns.lookup` that refuses non-public results unless private destinations are allowed. */
191
+ function guardedLookup(allowPrivate) {
192
+ return ((hostname, options, callback) => {
193
+ dns.lookup(hostname, { ...options, all: true }, (error, addresses) => {
194
+ if (error !== null)
195
+ return callback(error);
196
+ const list = addresses;
197
+ const bad = allowPrivate ? undefined : list.find((entry) => isNonPublicAddress(entry.address));
198
+ if (bad !== undefined) {
199
+ return callback(new OAuthPolicyError(`${hostname} resolves to a loopback/private address; refused`));
200
+ }
201
+ if (options.all === true)
202
+ return callback(null, list);
203
+ return callback(null, list[0].address, list[0].family);
204
+ });
205
+ });
206
+ }
207
+ async function requestOnce(url, method, headers, body, options) {
208
+ const maxBytes = options.maxBytes ?? MAX_OAUTH_RESPONSE_BYTES;
209
+ const timeoutMs = options.timeoutMs ?? OAUTH_REQUEST_TIMEOUT_MS;
210
+ return await new Promise((resolve, reject) => {
211
+ const transport = url.protocol === 'https:' ? https : http;
212
+ const finish = (fn) => {
213
+ clearTimeout(timer);
214
+ options.signal?.removeEventListener('abort', onAbort);
215
+ fn();
216
+ };
217
+ const request = transport.request(url, {
218
+ method,
219
+ headers: {
220
+ ...headers,
221
+ ...(body === undefined ? {} : { 'content-length': String(Buffer.byteLength(body)) }),
222
+ },
223
+ lookup: guardedLookup(options.allowPrivate),
224
+ agent: false,
225
+ }, (response) => {
226
+ const chunks = [];
227
+ let size = 0;
228
+ response.on('data', (chunk) => {
229
+ size += chunk.length;
230
+ if (size > maxBytes) {
231
+ request.destroy(new OAuthPolicyError(`OAuth response exceeds ${maxBytes} bytes`));
232
+ return;
233
+ }
234
+ chunks.push(chunk);
235
+ });
236
+ response.on('end', () => {
237
+ const responseHeaders = new Headers();
238
+ for (const [key, value] of Object.entries(response.headers)) {
239
+ if (value === undefined)
240
+ continue;
241
+ for (const item of Array.isArray(value) ? value : [value])
242
+ responseHeaders.append(key, item);
243
+ }
244
+ finish(() => resolve({
245
+ status: response.statusCode ?? 0,
246
+ statusText: response.statusMessage ?? '',
247
+ headers: responseHeaders,
248
+ body: Buffer.concat(chunks),
249
+ }));
250
+ });
251
+ response.on('error', (error) => finish(() => reject(error)));
252
+ });
253
+ const onAbort = () => request.destroy(new Error('OAuth request cancelled'));
254
+ const timer = setTimeout(() => request.destroy(new Error(`OAuth request timed out after ${timeoutMs} ms`)), timeoutMs);
255
+ timer.unref();
256
+ if (options.signal?.aborted === true) {
257
+ finish(() => reject(new Error('OAuth request cancelled')));
258
+ request.destroy();
259
+ return;
260
+ }
261
+ options.signal?.addEventListener('abort', onAbort, { once: true });
262
+ request.on('error', (error) => finish(() => reject(error)));
263
+ if (body !== undefined)
264
+ request.write(body);
265
+ request.end();
266
+ });
267
+ }
268
+ /**
269
+ * The SDK `FetchLike` for interactive login: every request URL is vetted by
270
+ * {@link validateOAuthUrl}, the socket's addresses are vetted again by the lookup hook, redirects
271
+ * are followed by hand (at most {@link MAX_REDIRECTS}, GET only, each hop re-vetted), and the
272
+ * response is bounded in size and time. It is the only fetch the login flow uses.
273
+ */
274
+ export function createGuardedFetch(options) {
275
+ return async (input, init) => {
276
+ let url = validateOAuthUrl(input, 'OAuth request', options);
277
+ let method = (init?.method ?? 'GET').toUpperCase();
278
+ let body = bodyText(init?.body);
279
+ const headers = toHeaderRecord(init?.headers);
280
+ for (let hop = 0;; hop += 1) {
281
+ const result = await requestOnce(url, method, headers, body, options);
282
+ const location = result.headers.get('location');
283
+ if ([301, 302, 303, 307, 308].includes(result.status) && location !== null) {
284
+ if (hop >= MAX_REDIRECTS)
285
+ throw new OAuthPolicyError(`OAuth request redirected more than ${MAX_REDIRECTS} times`);
286
+ if (method !== 'GET')
287
+ throw new OAuthPolicyError('OAuth request answered a non-GET with a redirect; refused');
288
+ url = validateOAuthUrl(new URL(location, url), 'OAuth redirect', options);
289
+ method = 'GET';
290
+ body = undefined;
291
+ continue;
292
+ }
293
+ const nullBody = [101, 204, 205, 304].includes(result.status);
294
+ return new Response(nullBody ? null : new Uint8Array(result.body), {
295
+ status: result.status,
296
+ statusText: result.statusText,
297
+ headers: result.headers,
298
+ });
299
+ }
300
+ };
301
+ }
302
+ /**
303
+ * Resolves `hostname` and refuses when any address is non-public (unless private destinations are
304
+ * allowed). Used as a pre-flight on the runtime refresh path, where the SDK — not darwin — opens
305
+ * the socket, so the lookup hook above cannot see it.
306
+ */
307
+ export async function assertHostResolvesPublic(hostname, context) {
308
+ if (context.allowPrivate)
309
+ return;
310
+ const bare = hostname.replace(/^\[|\]$/g, '');
311
+ if (net.isIP(bare) !== 0) {
312
+ if (isNonPublicAddress(bare))
313
+ throw new OAuthPolicyError(`${hostname} is a loopback/private address; refused`);
314
+ return;
315
+ }
316
+ const addresses = await dns.promises.lookup(bare, { all: true });
317
+ if (addresses.some((entry) => isNonPublicAddress(entry.address))) {
318
+ throw new OAuthPolicyError(`${hostname} resolves to a loopback/private address; refused`);
319
+ }
320
+ }
321
+ //# sourceMappingURL=oauth-net.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"oauth-net.js","sourceRoot":"","sources":["../../../src/mcp/oauth-net.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,89 @@
1
+ import type { AddClientAuthentication, OAuthClientProvider, OAuthDiscoveryState } from '@modelcontextprotocol/sdk/client/auth.js';
2
+ import type { OAuthClientInformationMixed, OAuthClientMetadata, OAuthTokens } from '@modelcontextprotocol/sdk/shared/auth.js';
3
+ import { type OAuthRecord } from './oauth-store.js';
4
+ /** Raised inside a session when a server needs `darwin mcp login`; the message is the guidance. */
5
+ export declare class McpLoginRequiredError extends Error {
6
+ constructor(server: string, detail?: string);
7
+ }
8
+ /** The `oauth` key of one server entry, validated. */
9
+ export interface OAuthServerSettings {
10
+ readonly name: string;
11
+ /** The interpolated MCP endpoint. */
12
+ readonly serverUrl: URL;
13
+ readonly scope?: string;
14
+ /** A pre-registered public client id; without one the login uses dynamic client registration. */
15
+ readonly clientId?: string;
16
+ /** Fixed loopback callback port (needed by pre-registered redirect URIs); default an ephemeral one. */
17
+ readonly callbackPort?: number;
18
+ /** A local/private MCP server, or the user's explicit `allowPrivateNetwork`: private OAuth endpoints allowed. */
19
+ readonly allowPrivate: boolean;
20
+ }
21
+ /**
22
+ * Reads the `oauth` key of a server entry: `undefined` when the server has none (or `false`), the
23
+ * settings when it has a valid one, {@link ConfigError} when the entry asks for OAuth but cannot
24
+ * have it. A typo in a credential setting should stop startup rather than hide a server.
25
+ */
26
+ export declare function resolveOAuthSettings(name: string, entry: unknown): OAuthServerSettings | undefined;
27
+ /**
28
+ * Vets a discovery document: the authorization server and each endpoint it names must pass the
29
+ * URL policy and share the authorization server's origin, its `issuer` must be that origin, and
30
+ * any protected-resource metadata must describe this MCP server's origin. Throws
31
+ * {@link OAuthPolicyError}.
32
+ */
33
+ export declare function validateDiscoveryState(state: OAuthDiscoveryState, settings: OAuthServerSettings): void;
34
+ export type OAuthProviderMode = 'login' | 'runtime';
35
+ export interface OAuthProviderOptions {
36
+ readonly settings: OAuthServerSettings;
37
+ readonly mode: OAuthProviderMode;
38
+ /** login: the loopback redirect URI the callback listener is bound to. */
39
+ readonly redirectUrl?: string;
40
+ /** login: receives the vetted authorization URL (the browser step). */
41
+ readonly onAuthorizationUrl?: (url: URL) => void | Promise<void>;
42
+ /** runtime: the record read at load, when one applied. */
43
+ readonly record?: OAuthRecord;
44
+ /** runtime: why no record applied. */
45
+ readonly recordProblem?: 'absent' | 'mismatch' | 'invalid';
46
+ }
47
+ export declare class DarwinOAuthProvider implements OAuthClientProvider {
48
+ readonly settings: OAuthServerSettings;
49
+ readonly mode: OAuthProviderMode;
50
+ /** Set when a session request needed a login this process cannot perform. */
51
+ loginRequired: boolean;
52
+ private readonly redirect;
53
+ private readonly onAuthorizationUrl;
54
+ private record;
55
+ private readonly recordProblem;
56
+ private client;
57
+ private tokenState;
58
+ private discovery;
59
+ private verifier;
60
+ private stateValue;
61
+ constructor(options: OAuthProviderOptions);
62
+ /** What `/mcp` may say: never a token, never a timestamp of one. */
63
+ authStatus(): 'logged-in' | 'login-required' | 'not-logged-in';
64
+ get redirectUrl(): string;
65
+ get clientMetadata(): OAuthClientMetadata;
66
+ /** The `state` value of the authorization request this provider issued (login mode). */
67
+ get expectedState(): string | undefined;
68
+ state(): string;
69
+ clientInformation(): OAuthClientInformationMixed | undefined;
70
+ saveClientInformation(info: OAuthClientInformationMixed): void;
71
+ tokens(): OAuthTokens | undefined;
72
+ saveTokens(tokens: OAuthTokens): Promise<void>;
73
+ redirectToAuthorization(url: URL): Promise<void>;
74
+ saveCodeVerifier(codeVerifier: string): void;
75
+ codeVerifier(): string;
76
+ saveDiscoveryState(state: OAuthDiscoveryState): void;
77
+ discoveryState(): OAuthDiscoveryState | undefined;
78
+ validateResourceURL(_defaultResource: string | URL, resource?: string): Promise<URL | undefined>;
79
+ /** Before every token request: re-vet the endpoint (and its DNS), then authenticate as the client. */
80
+ readonly addClientAuthentication: AddClientAuthentication;
81
+ invalidateCredentials(scope: 'all' | 'client' | 'tokens' | 'verifier' | 'discovery'): Promise<void>;
82
+ /** Login mode: the record the finished login stores. Throws if the login has no tokens yet. */
83
+ buildRecord(): OAuthRecord;
84
+ }
85
+ /**
86
+ * The provider a session attaches to an OAuth-configured server: reads the stored login once (the
87
+ * only token-store read a session makes, and only for servers that are armed and opted in).
88
+ */
89
+ export declare function createRuntimeOAuthProvider(settings: OAuthServerSettings): Promise<DarwinOAuthProvider>;