@3ngram/server 0.7.0 → 0.7.2
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.
- package/dist/app.d.ts +4 -4
- package/dist/app.js +2 -2
- package/dist/app.js.map +1 -1
- package/dist/boot.d.ts +3 -3
- package/dist/boot.js +3 -3
- package/dist/mailer.js +1 -2
- package/dist/mailer.js.map +1 -1
- package/dist/mcp/errors.js +3 -3
- package/dist/mcp/errors.js.map +1 -1
- package/dist/mcp/prompts.d.ts +2 -2
- package/dist/mcp/prompts.js +4 -4
- package/dist/mcp/prompts.js.map +1 -1
- package/dist/mcp/server.d.ts +1 -1
- package/dist/mcp/server.js +2 -2
- package/dist/mcp/server.js.map +1 -1
- package/dist/mcp/tools-orient.js +3 -3
- package/dist/mcp/tools-orient.js.map +1 -1
- package/dist/mcp/tools.d.ts +2 -2
- package/dist/mcp/tools.js +10 -10
- package/dist/mcp/tools.js.map +1 -1
- package/dist/middleware/api-key.js +1 -1
- package/dist/middleware/api-key.js.map +1 -1
- package/dist/middleware/oauth-bearer.js +2 -2
- package/dist/middleware/oauth-bearer.js.map +1 -1
- package/dist/middleware/rate-limit.js +3 -3
- package/dist/middleware/rate-limit.js.map +1 -1
- package/dist/middleware/request-context.d.ts +1 -1
- package/dist/middleware/request-context.js +1 -1
- package/dist/rest/errors.js +1 -1
- package/dist/rest/errors.js.map +1 -1
- package/dist/rest/router.js +3 -3
- package/dist/rest/router.js.map +1 -1
- package/dist/rest/scope.js +1 -1
- package/dist/rest/scope.js.map +1 -1
- package/dist/routes/auth.d.ts +1 -1
- package/dist/routes/auth.js +3 -3
- package/dist/routes/auth.js.map +1 -1
- package/dist/routes/mcp.js +2 -2
- package/dist/routes/mcp.js.map +1 -1
- package/dist/routes/oauth-authorize.js +2 -3
- package/dist/routes/oauth-authorize.js.map +1 -1
- package/dist/routes/oauth-register.js +1 -1
- package/dist/routes/oauth-register.js.map +1 -1
- package/dist/routes/oauth-token.js +3 -3
- package/dist/routes/oauth-token.js.map +1 -1
- package/dist/routes/onboarding.js +1 -2
- package/dist/routes/onboarding.js.map +1 -1
- package/dist/routes/well-known.js +1 -1
- package/dist/routes/well-known.js.map +1 -1
- package/package.json +7 -6
package/dist/app.d.ts
CHANGED
|
@@ -8,7 +8,7 @@ export type { Extension } from './composition/extension.js';
|
|
|
8
8
|
export interface AppOptions {
|
|
9
9
|
/**
|
|
10
10
|
* Embedding gateway for the MCP tools. When omitted, it is derived from env
|
|
11
|
-
* (
|
|
11
|
+
* (env-gated): a real OpenAI-compatible client iff LLM_GATEWAY_URL +
|
|
12
12
|
* LLM_GATEWAY_API_KEY are set, else undefined (search returns a typed
|
|
13
13
|
* "not configured" error and remember runs with embedding off).
|
|
14
14
|
*/
|
|
@@ -18,7 +18,7 @@ export interface AppOptions {
|
|
|
18
18
|
* iff REDIS_URL is set (else in-memory). Tests inject limiters directly so NO
|
|
19
19
|
* real Redis is required in CI:
|
|
20
20
|
* - `mcpLimiter` — per-user bucket on /mcp (req.userId, set by oauthBearerAuth).
|
|
21
|
-
* - `authLimiter` — per-IP bucket on /auth/login (
|
|
21
|
+
* - `authLimiter` — per-IP bucket on /auth/login (req.ip is the
|
|
22
22
|
* real client because trust proxy is set).
|
|
23
23
|
* Provide `redis` instead to let boot construct the default limiters over an
|
|
24
24
|
* explicit client (or omit both for the env-derived client).
|
|
@@ -38,7 +38,7 @@ export interface AppOptions {
|
|
|
38
38
|
forgotPasswordLimiter?: RateLimiterMiddleware;
|
|
39
39
|
resetPasswordLimiter?: RateLimiterMiddleware;
|
|
40
40
|
/**
|
|
41
|
-
* Per-IP limiter for POST /oauth/register
|
|
41
|
+
* Per-IP limiter for POST /oauth/register. Defaults to a
|
|
42
42
|
* conservative per-IP bucket built like the two above — /oauth/register is
|
|
43
43
|
* unauthenticated, so it must never ship unlimited. Tuning it is an
|
|
44
44
|
* injection-only change.
|
|
@@ -46,7 +46,7 @@ export interface AppOptions {
|
|
|
46
46
|
registerLimiter?: RateLimiterMiddleware;
|
|
47
47
|
/**
|
|
48
48
|
* Per-IP limiter shared by GET/POST /oauth/authorize and POST /oauth/token
|
|
49
|
-
* (
|
|
49
|
+
* (both are unauthenticated surfaces, so a real conservative
|
|
50
50
|
* bucket is the default, mirroring registerLimiter). Tuning it is an
|
|
51
51
|
* injection-only change (incl. failed-exchange progressive delay).
|
|
52
52
|
*/
|
package/dist/app.js
CHANGED
|
@@ -217,7 +217,7 @@ export function createApp(options = {}) {
|
|
|
217
217
|
app.use(onboardingRouter);
|
|
218
218
|
app.use(profileRouter);
|
|
219
219
|
app.use(mcpRouter({ gateway, limiter: mcpLimiter, budget, access }));
|
|
220
|
-
// REST /api/v1 mirror (
|
|
220
|
+
// REST /api/v1 mirror (docs/concepts/architecture.mdx) — behind the
|
|
221
221
|
// apiKeyAuth chain the router applies itself, so it mounts independent of the
|
|
222
222
|
// MCP Bearer mount. APPEND-ONLY after the existing routers, before the error
|
|
223
223
|
// handler. The same env-gated gateway threaded into mcpRouter is threaded here.
|
|
@@ -260,7 +260,7 @@ export function createApp(options = {}) {
|
|
|
260
260
|
// A malformed JSON body is a client error: express.json() throws a
|
|
261
261
|
// body-parser SyntaxError (status 400, type 'entity.parse.failed') before
|
|
262
262
|
// any route runs. Surface it as the documented 400 invalid_request contract
|
|
263
|
-
//
|
|
263
|
+
// rather than the generic 500.
|
|
264
264
|
if (isBodyParseError(err)) {
|
|
265
265
|
res.status(400).json({ error: 'invalid_request' });
|
|
266
266
|
return;
|
package/dist/app.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"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"}
|
package/dist/boot.d.ts
CHANGED
|
@@ -22,11 +22,11 @@ export interface BootstrapOptions {
|
|
|
22
22
|
* Run the fail-closed boot sequence and start the server:
|
|
23
23
|
* 1. initObservability() FIRST (before express loads — load-order contract).
|
|
24
24
|
* 2. loadEnv() — refuse-by-construction: a misconfigured process dies at boot.
|
|
25
|
-
* 3. assertMeteredOperationsRegistered() — every metered LLM op has a maxCost
|
|
26
|
-
*
|
|
25
|
+
* 3. assertMeteredOperationsRegistered() — every metered LLM op has a maxCost;
|
|
26
|
+
* a missing entry is a loud startup failure, not a runtime
|
|
27
27
|
* surprise.
|
|
28
28
|
* 4. OAuth key validation (when configured) — config validates JWK SHAPE,
|
|
29
|
-
* assertSigningKeysUsable validates KEY MATERIAL as RS256 (
|
|
29
|
+
* assertSigningKeysUsable validates KEY MATERIAL as RS256 (an
|
|
30
30
|
* unusable key kills the process before the first request). Dynamic import
|
|
31
31
|
* keeps core's graph behind initObservability, like the app graph below.
|
|
32
32
|
* 5. Dynamic-import createApp (express graph) and listen; wire signal handlers.
|
package/dist/boot.js
CHANGED
|
@@ -13,11 +13,11 @@ async function resolveExtension(extension) {
|
|
|
13
13
|
* Run the fail-closed boot sequence and start the server:
|
|
14
14
|
* 1. initObservability() FIRST (before express loads — load-order contract).
|
|
15
15
|
* 2. loadEnv() — refuse-by-construction: a misconfigured process dies at boot.
|
|
16
|
-
* 3. assertMeteredOperationsRegistered() — every metered LLM op has a maxCost
|
|
17
|
-
*
|
|
16
|
+
* 3. assertMeteredOperationsRegistered() — every metered LLM op has a maxCost;
|
|
17
|
+
* a missing entry is a loud startup failure, not a runtime
|
|
18
18
|
* surprise.
|
|
19
19
|
* 4. OAuth key validation (when configured) — config validates JWK SHAPE,
|
|
20
|
-
* assertSigningKeysUsable validates KEY MATERIAL as RS256 (
|
|
20
|
+
* assertSigningKeysUsable validates KEY MATERIAL as RS256 (an
|
|
21
21
|
* unusable key kills the process before the first request). Dynamic import
|
|
22
22
|
* keeps core's graph behind initObservability, like the app graph below.
|
|
23
23
|
* 5. Dynamic-import createApp (express graph) and listen; wire signal handlers.
|
package/dist/mailer.js
CHANGED
|
@@ -9,8 +9,7 @@
|
|
|
9
9
|
// configured' } — it does NOT throw. The caller then falls back to the
|
|
10
10
|
// documented owner-level reset / dev-token path. A transport failure at send
|
|
11
11
|
// time is ALSO non-fatal here: it returns { delivered: false, reason: 'send-
|
|
12
|
-
// failed' } so the route can still answer a uniform 200 (no user enumeration
|
|
13
|
-
// ADR-0009) instead of leaking a 500 on a flaky MTA.
|
|
12
|
+
// failed' } so the route can still answer a uniform 200 (no user enumeration) instead of leaking a 500 on a flaky MTA.
|
|
14
13
|
//
|
|
15
14
|
// Hard rule 6: SMTP_PASS and the recipient address never enter a log line — the
|
|
16
15
|
// mailer logs host/port and (on success) the transport message id only.
|
package/dist/mailer.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"mailer.js","sourceRoot":"","sources":["../src/mailer.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,sHAAsH;AACtH,+EAA+E;AAC/E,6EAA6E;AAC7E,kDAAkD;AAClD,EAAE;AACF,8EAA8E;AAC9E,4EAA4E;AAC5E,uEAAuE;AACvE,6EAA6E;AAC7E,6EAA6E;AAC7E,
|
|
1
|
+
{"version":3,"file":"mailer.js","sourceRoot":"","sources":["../src/mailer.ts"],"names":[],"mappings":"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"}
|
package/dist/mcp/errors.js
CHANGED
|
@@ -44,7 +44,7 @@ export function mapToolError(toolName, err) {
|
|
|
44
44
|
// bare ZodError (they are wrapped above), so this branch is input-only.
|
|
45
45
|
if (err instanceof ZodError ||
|
|
46
46
|
err instanceof InvalidEmbeddingError ||
|
|
47
|
-
// A missing/empty orientation selector is the no-firehose guard (mcp-design.
|
|
47
|
+
// A missing/empty orientation selector is the no-firehose guard (docs/concepts/mcp-design.mdx):
|
|
48
48
|
// a 400-class caller mistake, not a server fault. Counted as invalid_input.
|
|
49
49
|
err instanceof MissingSelectorError) {
|
|
50
50
|
mcpToolErrors.add(1, { tool_name: toolName, reason_code: 'invalid_input' });
|
|
@@ -152,13 +152,13 @@ export function mapToolError(toolName, err) {
|
|
|
152
152
|
log().warn({ tool_name: toolName, err: err.name }, 'mcp: proposal not open / not found');
|
|
153
153
|
return fail(`not_found: open proposal ${err.proposalId}`);
|
|
154
154
|
}
|
|
155
|
-
// Accepting an event-type supersedes/updates proposal is refused (
|
|
155
|
+
// Accepting an event-type supersedes/updates proposal is refused (docs/concepts/memory-model.mdx "Consolidation is advisory"
|
|
156
156
|
// episodic exclusion): a documented domain CONFLICT, not a server fault. Names
|
|
157
157
|
// the proposal id + memory_type (a bounded enum) only, never content.
|
|
158
158
|
if (err instanceof EpisodicSupersessionError) {
|
|
159
159
|
mcpToolErrors.add(1, { tool_name: toolName, reason_code: 'conflict' });
|
|
160
160
|
log().warn({ tool_name: toolName, err: err.name }, 'mcp: episodic supersession refused');
|
|
161
|
-
return fail(`conflict: event-type proposal ${err.proposalId} cannot supersede (
|
|
161
|
+
return fail(`conflict: event-type proposal ${err.proposalId} cannot supersede (docs/concepts/memory-model.mdx)`);
|
|
162
162
|
}
|
|
163
163
|
// A fresh apply whose proposed SUCCESSOR (from_id) is no longer live — the
|
|
164
164
|
// proposal went stale while queued (a later revise superseded from_id), so
|
package/dist/mcp/errors.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/mcp/errors.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,gFAAgF;AAChF,iFAAiF;AACjF,iFAAiF;AACjF,iFAAiF;AACjF,iFAAiF;AACjF,uEAAuE;AACvE,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AACnD,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,EACpB,iBAAiB,EACjB,yBAAyB,EACzB,gCAAgC,EAChC,gCAAgC,EAChC,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,EACxB,iCAAiC,EACjC,wBAAwB;AACxB,+DAA+D;AAC/D,0EAA0E;AAC1E,8BAA8B;AAC9B,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,cAAc,CAAA;AAErB,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAA;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAK/D,mFAAmF;AACnF,SAAS,IAAI,CAAC,OAAe;IAC3B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;AACtE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,GAAY;IACzD,6DAA6D;IAC7D,0EAA0E;IAC1E,2EAA2E;IAC3E,yEAAyE;IACzE,0EAA0E;IAC1E,IAAI,GAAG,YAAY,qBAAqB,EAAE,CAAC;QACzC,aAAa,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC,CAAA;QAC5E,GAAG,EAAE,CAAC,KAAK,CACT,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,CAAC,UAAU,EAAE,KAAK,EAAE,GAAG,CAAC,UAAU,EAAE,EAC1F,2CAA2C,CAC5C,CAAA;QACD,OAAO,IAAI,CACT,yCAAyC,QAAQ,0CAA0C,GAAG,CAAC,UAAU,iEAAiE,CAC3K,CAAA;IACH,CAAC;IACD,4EAA4E;IAC5E,4EAA4E;IAC5E,yEAAyE;IACzE,0EAA0E;IAC1E,wEAAwE;IACxE,IACE,GAAG,YAAY,QAAQ;QACvB,GAAG,YAAY,qBAAqB;QACpC,
|
|
1
|
+
{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/mcp/errors.ts"],"names":[],"mappings":"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"}
|
package/dist/mcp/prompts.d.ts
CHANGED
|
@@ -11,12 +11,12 @@ interface RegisterablePrompt {
|
|
|
11
11
|
}
|
|
12
12
|
/**
|
|
13
13
|
* THE code-defined prompt surface. Length === registered count; the v1 cap
|
|
14
|
-
* (EXACTLY 2 — briefing, debrief; mcp-design.
|
|
14
|
+
* (EXACTLY 2 — briefing, debrief; docs/concepts/mcp-design.mdx) is auditable from this one
|
|
15
15
|
* array. Each entry carries its name (auditable) and a server-bound registrar,
|
|
16
16
|
* so the registry stays type-safe over heterogeneous arg shapes without an `any`.
|
|
17
17
|
*/
|
|
18
18
|
export declare const PROMPTS: readonly RegisterablePrompt[];
|
|
19
|
-
/** Hard ceiling per mcp-design.
|
|
19
|
+
/** Hard ceiling per docs/concepts/mcp-design.mdx (v1: exactly 2; resources deferred). */
|
|
20
20
|
export declare const MAX_PROMPTS = 2;
|
|
21
21
|
/**
|
|
22
22
|
* Register every code-defined prompt on the McpServer. Called from
|
package/dist/mcp/prompts.js
CHANGED
|
@@ -16,7 +16,7 @@
|
|
|
16
16
|
// of a per-prompt scope, and these templates expose no data, so transport-level
|
|
17
17
|
// Bearer auth is the complete access control). Confirmed in routes/mcp.ts.
|
|
18
18
|
//
|
|
19
|
-
// V1 CAP (mcp-design.
|
|
19
|
+
// V1 CAP (docs/concepts/mcp-design.mdx): EXACTLY 2 prompts (briefing, debrief). Resources are
|
|
20
20
|
// deferred. {@link PROMPTS}.length is the auditable count; {@link MAX_PROMPTS}
|
|
21
21
|
// is the ceiling.
|
|
22
22
|
//
|
|
@@ -79,7 +79,7 @@ const selectorArgSchema = z
|
|
|
79
79
|
const modeArgSchema = briefingModeSchema.describe('brief (counts + top items, the default) or full (the bounded lists).');
|
|
80
80
|
/**
|
|
81
81
|
* briefing — orient the agent to START a session by calling the briefing TOOL
|
|
82
|
-
* with an EXPLICIT selector (no-firehose, mcp-design.
|
|
82
|
+
* with an EXPLICIT selector (no-firehose, docs/concepts/mcp-design.mdx). The prompt TEXT only
|
|
83
83
|
* orients; it does NOT query — the agent then issues the tool call itself. The
|
|
84
84
|
* `selector`/`mode` args interpolate into a concrete, copy-ready instruction.
|
|
85
85
|
*/
|
|
@@ -158,12 +158,12 @@ const debriefPrompt = definePrompt({
|
|
|
158
158
|
});
|
|
159
159
|
/**
|
|
160
160
|
* THE code-defined prompt surface. Length === registered count; the v1 cap
|
|
161
|
-
* (EXACTLY 2 — briefing, debrief; mcp-design.
|
|
161
|
+
* (EXACTLY 2 — briefing, debrief; docs/concepts/mcp-design.mdx) is auditable from this one
|
|
162
162
|
* array. Each entry carries its name (auditable) and a server-bound registrar,
|
|
163
163
|
* so the registry stays type-safe over heterogeneous arg shapes without an `any`.
|
|
164
164
|
*/
|
|
165
165
|
export const PROMPTS = [briefingPrompt, debriefPrompt];
|
|
166
|
-
/** Hard ceiling per mcp-design.
|
|
166
|
+
/** Hard ceiling per docs/concepts/mcp-design.mdx (v1: exactly 2; resources deferred). */
|
|
167
167
|
export const MAX_PROMPTS = 2;
|
|
168
168
|
/**
|
|
169
169
|
* Register every code-defined prompt on the McpServer. Called from
|
package/dist/mcp/prompts.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/mcp/prompts.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,0EAA0E;AAC1E,EAAE;AACF,gFAAgF;AAChF,8EAA8E;AAC9E,kFAAkF;AAClF,gFAAgF;AAChF,iFAAiF;AACjF,6DAA6D;AAC7D,EAAE;AACF,iFAAiF;AACjF,gFAAgF;AAChF,kFAAkF;AAClF,+EAA+E;AAC/E,gFAAgF;AAChF,gFAAgF;AAChF,2EAA2E;AAC3E,EAAE;AACF
|
|
1
|
+
{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/mcp/prompts.ts"],"names":[],"mappings":"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"}
|
package/dist/mcp/server.d.ts
CHANGED
|
@@ -5,7 +5,7 @@ import { type ToolContext } from './tools.js';
|
|
|
5
5
|
* {@link ToolContext}. Each tool registers its Zod input/output RAW SHAPES (the
|
|
6
6
|
* SDK validates inbound args against inputSchema and the structured result
|
|
7
7
|
* against outputSchema), and delegates to {@link runTool} for uniform metrics +
|
|
8
|
-
* typed-error mapping. The code-defined PROMPTS (briefing, debrief
|
|
8
|
+
* typed-error mapping. The code-defined PROMPTS (briefing, debrief)
|
|
9
9
|
* are registered alongside; registerPrompt auto-enables the `prompts` capability,
|
|
10
10
|
* so prompts/list + prompts/get are served with no transport-route change (both
|
|
11
11
|
* stay Bearer-gated by routes/mcp.ts). Prompts carry no tenant data, so they need
|
package/dist/mcp/server.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
// SPDX-License-Identifier: Apache-2.0
|
|
2
2
|
// MCP server factory — builds a per-request McpServer from the {@link TOOLS}
|
|
3
|
-
// registry. STATELESS (mcp-design.
|
|
3
|
+
// registry. STATELESS (docs/concepts/mcp-design.mdx): a fresh server + transport per request
|
|
4
4
|
// (sessionIdGenerator: undefined), so NO in-process session state survives a
|
|
5
5
|
// request — any instance serves any request and a Railway redeploy is a
|
|
6
6
|
// non-event. The authenticated tenant + optional embedding gateway are captured
|
|
@@ -17,7 +17,7 @@ const SERVER_INFO = { name: '3ngram', version: SERVER_VERSION };
|
|
|
17
17
|
* {@link ToolContext}. Each tool registers its Zod input/output RAW SHAPES (the
|
|
18
18
|
* SDK validates inbound args against inputSchema and the structured result
|
|
19
19
|
* against outputSchema), and delegates to {@link runTool} for uniform metrics +
|
|
20
|
-
* typed-error mapping. The code-defined PROMPTS (briefing, debrief
|
|
20
|
+
* typed-error mapping. The code-defined PROMPTS (briefing, debrief)
|
|
21
21
|
* are registered alongside; registerPrompt auto-enables the `prompts` capability,
|
|
22
22
|
* so prompts/list + prompts/get are served with no transport-route change (both
|
|
23
23
|
* stay Bearer-gated by routes/mcp.ts). Prompts carry no tenant data, so they need
|
package/dist/mcp/server.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,6EAA6E;AAC7E,
|
|
1
|
+
{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,6EAA6E;AAC7E,6FAA6F;AAC7F,6EAA6E;AAC7E,wEAAwE;AACxE,gFAAgF;AAChF,gFAAgF;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAoB,MAAM,YAAY,CAAA;AAE7D,8EAA8E;AAC9E,uEAAuE;AACvE,MAAM,WAAW,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAW,CAAA;AAExE;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,GAAgB;IAC9C,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,WAAW,CAAC,CAAA;IACzC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,IAAa,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAA;IAC1F,CAAC;IACD,eAAe,CAAC,MAAM,CAAC,CAAA;IACvB,OAAO,MAAM,CAAA;AACf,CAAC"}
|
package/dist/mcp/tools-orient.js
CHANGED
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
// internally), shape the structured result. Both are reads -> requiredScope
|
|
10
10
|
// memory:read; runTool enforces the scope BEFORE the handler runs.
|
|
11
11
|
//
|
|
12
|
-
// SELECTOR DISCIPLINE (no-firehose, mcp-design.
|
|
12
|
+
// SELECTOR DISCIPLINE (no-firehose, docs/concepts/mcp-design.mdx centerpiece): both tools REQUIRE
|
|
13
13
|
// an explicit selector. The schema makes it required; core re-checks the semantic
|
|
14
14
|
// invariant and throws MissingSelectorError, mapped to a typed isError by
|
|
15
15
|
// errors.ts. A briefing/handoff can NEVER be the unfiltered firehose the old
|
|
@@ -35,7 +35,7 @@ function ok(structured) {
|
|
|
35
35
|
};
|
|
36
36
|
}
|
|
37
37
|
/**
|
|
38
|
-
* briefing — structured session orientation (mcp-design.
|
|
38
|
+
* briefing — structured session orientation (docs/concepts/mcp-design.mdx JTBD "start my session
|
|
39
39
|
* oriented"). Validates the REQUIRED selector + optional mode, calls core
|
|
40
40
|
* briefing() with the injected `now` (overdue split + stale window derive from
|
|
41
41
|
* it), returns the size-disciplined sections. brief mode (default) = counts + a
|
|
@@ -67,7 +67,7 @@ const briefingTool = {
|
|
|
67
67
|
},
|
|
68
68
|
};
|
|
69
69
|
/**
|
|
70
|
-
* handoff — export structured context for another agent/provider (mcp-design.
|
|
70
|
+
* handoff — export structured context for another agent/provider (docs/concepts/mcp-design.mdx
|
|
71
71
|
* JTBD "carry context to another tool/agent"). Same REQUIRED-selector discipline
|
|
72
72
|
* as briefing. Reuses the briefing aggregation in core (no duplicated SQL); the
|
|
73
73
|
* OUTPUT carries memory CONTENT by design (decisions/preferences) because a
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tools-orient.js","sourceRoot":"","sources":["../../src/mcp/tools-orient.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,wCAAwC;AACxC,gFAAgF;AAChF,kEAAkE;AAClE,sDAAsD;AACtD,EAAE;AACF,yEAAyE;AACzE,+EAA+E;AAC/E,4EAA4E;AAC5E,mEAAmE;AACnE,EAAE;AACF,
|
|
1
|
+
{"version":3,"file":"tools-orient.js","sourceRoot":"","sources":["../../src/mcp/tools-orient.ts"],"names":[],"mappings":"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"}
|
package/dist/mcp/tools.d.ts
CHANGED
|
@@ -18,7 +18,7 @@ type ToolResult = CallToolResult;
|
|
|
18
18
|
*/
|
|
19
19
|
/**
|
|
20
20
|
* The registry-level scope floor a token must satisfy to reach a tool's handler
|
|
21
|
-
* (
|
|
21
|
+
* (per-tool scope mapping). Either:
|
|
22
22
|
* - a SINGLE {@link MemoryScope}: the token MUST carry exactly that scope
|
|
23
23
|
* (single-action tools — reads → {@link MEMORY_READ_SCOPE}, writes →
|
|
24
24
|
* {@link MEMORY_WRITE_SCOPE});
|
|
@@ -75,7 +75,7 @@ export interface ToolContext {
|
|
|
75
75
|
* time, long after this assignment completes.
|
|
76
76
|
*/
|
|
77
77
|
export declare const TOOLS: readonly ToolDefinition[];
|
|
78
|
-
/** Hard ceiling per mcp-design.
|
|
78
|
+
/** Hard ceiling per docs/concepts/mcp-design.mdx / hard rule 8. */
|
|
79
79
|
export declare const MAX_TOOLS = 12;
|
|
80
80
|
/**
|
|
81
81
|
* Run a tool handler with uniform metrics + typed-error mapping. A KNOWN typed
|
package/dist/mcp/tools.js
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
// every core call (which runs withTenant internally) — a tool can only ever
|
|
7
7
|
// touch the caller's own rows (hard rule 3).
|
|
8
8
|
//
|
|
9
|
-
// TOOL-COUNT DISCIPLINE (mcp-design.
|
|
9
|
+
// TOOL-COUNT DISCIPLINE (docs/concepts/mcp-design.mdx, hard rule 8: <=12): the single {@link
|
|
10
10
|
// TOOLS} array is the auditable surface — its length IS the registered tool
|
|
11
11
|
// count. D0 ships exactly THREE (remember/search/get_facts); the other seven
|
|
12
12
|
// JTBD tools land in later slices.
|
|
@@ -51,7 +51,7 @@ function toAsOf(asOf) {
|
|
|
51
51
|
return defined({ validAt: toDate(asOf.validAt), asKnownAt: toDate(asOf.asKnownAt) });
|
|
52
52
|
}
|
|
53
53
|
/**
|
|
54
|
-
* remember — append a memory (mcp-design.
|
|
54
|
+
* remember — append a memory (docs/concepts/mcp-design.mdx JTBD "persist something worth
|
|
55
55
|
* keeping"). Validates via the canonical write schema, calls core remember()
|
|
56
56
|
* (which validates once more at its own boundary and embeds-on-write via the
|
|
57
57
|
* injected gateway), returns the created memory + whether the embed landed.
|
|
@@ -107,7 +107,7 @@ const rememberTool = {
|
|
|
107
107
|
},
|
|
108
108
|
};
|
|
109
109
|
/**
|
|
110
|
-
* search — unified fused retrieval (mcp-design.
|
|
110
|
+
* search — unified fused retrieval (docs/concepts/mcp-design.mdx JTBD "find what I know").
|
|
111
111
|
* Requires a configured embedding gateway: core search() embeds the query and
|
|
112
112
|
* THROWS without an embedding source, so absent a gateway the tool returns a
|
|
113
113
|
* clear typed error rather than a 500. The input contract is query + limit plus
|
|
@@ -115,7 +115,7 @@ const rememberTool = {
|
|
|
115
115
|
* asOf) — validated at the ONE boundary ({@link searchQuerySchema}, hard rule 2)
|
|
116
116
|
* and threaded straight to core search()'s SearchOptions. Each filter NARROWS the
|
|
117
117
|
* candidate set BEFORE fusion; none alters the fusion weights or the
|
|
118
|
-
* supersession ranking (
|
|
118
|
+
* supersession ranking (docs/concepts/memory-model.mdx live-first stays the default). The tool
|
|
119
119
|
* registers the FULL `.strict()` object (not its raw shape), so the SDK parses
|
|
120
120
|
* inbound args strictly at the transport boundary and an UNKNOWN key is REJECTED
|
|
121
121
|
* there — a passed filter the tool exposes is applied, anything else is a clear
|
|
@@ -170,7 +170,7 @@ const searchTool = {
|
|
|
170
170
|
},
|
|
171
171
|
};
|
|
172
172
|
/**
|
|
173
|
-
* get_facts — currently-valid facts for a subject, bi-temporally (mcp-design.
|
|
173
|
+
* get_facts — currently-valid facts for a subject, bi-temporally (docs/concepts/mcp-design.mdx
|
|
174
174
|
* JTBD "what is currently true about X"). Calls core getFacts() with the
|
|
175
175
|
* subject/predicate filters and the as_of coordinates (ISO strings coerced to
|
|
176
176
|
* Date at this boundary).
|
|
@@ -197,7 +197,7 @@ const getFactsTool = {
|
|
|
197
197
|
predicate: input.predicate,
|
|
198
198
|
asOf: toAsOf(input.asOf),
|
|
199
199
|
// Always forward the bounded limit (schema default 50, max 200) so list
|
|
200
|
-
// mode never returns every fact (no-firehose, mcp-design.
|
|
200
|
+
// mode never returns every fact (no-firehose, docs/concepts/mcp-design.mdx).
|
|
201
201
|
limit: input.limit,
|
|
202
202
|
}));
|
|
203
203
|
const output = parseOutput('get_facts', factsToolOutputSchema, {
|
|
@@ -216,7 +216,7 @@ const getFactsTool = {
|
|
|
216
216
|
},
|
|
217
217
|
};
|
|
218
218
|
/**
|
|
219
|
-
* revise — supersede a memory with a corrected successor (mcp-design.
|
|
219
|
+
* revise — supersede a memory with a corrected successor (docs/concepts/mcp-design.mdx JTBD
|
|
220
220
|
* "correct or update what I know"). Wraps core revise(): closes the
|
|
221
221
|
* predecessor's validity and appends a typed-edge-linked successor in one
|
|
222
222
|
* transaction. The edge intent is constrained to the supersession family
|
|
@@ -270,7 +270,7 @@ const reviseTool = {
|
|
|
270
270
|
},
|
|
271
271
|
};
|
|
272
272
|
/**
|
|
273
|
-
* resolve — settle the obligation a memory carries (mcp-design.
|
|
273
|
+
* resolve — settle the obligation a memory carries (docs/concepts/mcp-design.mdx JTBD "resolve /
|
|
274
274
|
* unresolve (flag)"). Wraps core resolveByMemoryId(): keys on the MEMORY id the
|
|
275
275
|
* agent already holds and dispatches on what the memory IS. A COMMITMENT memory
|
|
276
276
|
* maps to its commitment via the unique (user_id, memory_id) index and takes an
|
|
@@ -331,7 +331,7 @@ export const TOOLS = [
|
|
|
331
331
|
// surface (itself included) without a circular import.
|
|
332
332
|
...createAdminTools(() => TOOLS.map((t) => t.name)),
|
|
333
333
|
];
|
|
334
|
-
/** Hard ceiling per mcp-design.
|
|
334
|
+
/** Hard ceiling per docs/concepts/mcp-design.mdx / hard rule 8. */
|
|
335
335
|
export const MAX_TOOLS = 12;
|
|
336
336
|
/**
|
|
337
337
|
* Run a tool handler with uniform metrics + typed-error mapping. A KNOWN typed
|
|
@@ -342,7 +342,7 @@ export const MAX_TOOLS = 12;
|
|
|
342
342
|
*/
|
|
343
343
|
export async function runTool(tool, args, ctx) {
|
|
344
344
|
mcpToolCalls.add(1, { tool_name: tool.name });
|
|
345
|
-
// SCOPE GATE (
|
|
345
|
+
// SCOPE GATE (fail-closed): the token MUST satisfy the tool's
|
|
346
346
|
// scope floor. A single scope demands an exact match; an `anyOf` floor passes
|
|
347
347
|
// when the token carries ANY listed scope (per-action tools — the handler then
|
|
348
348
|
// gates the action-specific scope). ctx.scopes is empty when the token had no
|
package/dist/mcp/tools.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,gFAAgF;AAChF,qEAAqE;AACrE,yEAAyE;AACzE,gFAAgF;AAChF,4EAA4E;AAC5E,6CAA6C;AAC7C,EAAE;AACF,
|
|
1
|
+
{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"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"}
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
// rest of the request — the SAME req.userId + log-context shape the Bearer
|
|
5
5
|
// `authenticate` middleware uses, so the two coexist transparently downstream.
|
|
6
6
|
//
|
|
7
|
-
// STATUS CONTRACT (
|
|
7
|
+
// STATUS CONTRACT (for the capture-hook verify path):
|
|
8
8
|
// 200 valid key -> identity bound, next() runs the route
|
|
9
9
|
// 401 missing / malformed / unknown / revoked key (UNIFORM, no enumeration)
|
|
10
10
|
// 503 resolver-or-DB failure
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"api-key.js","sourceRoot":"","sources":["../../src/middleware/api-key.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,8EAA8E;AAC9E,+EAA+E;AAC/E,2EAA2E;AAC3E,+EAA+E;AAC/E,EAAE;AACF,
|
|
1
|
+
{"version":3,"file":"api-key.js","sourceRoot":"","sources":["../../src/middleware/api-key.ts"],"names":[],"mappings":"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"}
|
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
// the SAME req.userId + log-context shape the C2 `authenticate` and C3
|
|
6
6
|
// `apiKeyAuth` middlewares use, so all three coexist transparently downstream.
|
|
7
7
|
//
|
|
8
|
-
// STATUS CONTRACT (RFC 6750 + RFC 9728 §5.1
|
|
8
|
+
// STATUS CONTRACT (RFC 6750 + RFC 9728 §5.1):
|
|
9
9
|
// 200 valid token -> identity bound, next() runs the route
|
|
10
10
|
// 401 missing / malformed / invalid / wrong-aud / wrong-iss / expired /
|
|
11
11
|
// unknown-kid / revoked token, with a `WWW-Authenticate: Bearer` header.
|
|
@@ -99,7 +99,7 @@ export function oauthBearerAuth(req, res, next) {
|
|
|
99
99
|
}
|
|
100
100
|
req.userId = result.token.userId;
|
|
101
101
|
// Bind the verified token's granted scopes (RFC 6749 space-delimited
|
|
102
|
-
// `scope`) for per-tool enforcement downstream
|
|
102
|
+
// `scope`) for per-tool enforcement downstream. FAIL-CLOSED:
|
|
103
103
|
// a token with no/empty scope claim yields an empty set, so a later
|
|
104
104
|
// memory:write check fails. Scope VALUES are not content, but they are not
|
|
105
105
|
// logged either (only the user-id hash enters the log context).
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"oauth-bearer.js","sourceRoot":"","sources":["../../src/middleware/oauth-bearer.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,mFAAmF;AACnF,iFAAiF;AACjF,iFAAiF;AACjF,uEAAuE;AACvE,+EAA+E;AAC/E,EAAE;AACF,
|
|
1
|
+
{"version":3,"file":"oauth-bearer.js","sourceRoot":"","sources":["../../src/middleware/oauth-bearer.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,mFAAmF;AACnF,iFAAiF;AACjF,iFAAiF;AACjF,uEAAuE;AACvE,+EAA+E;AAC/E,EAAE;AACF,8CAA8C;AAC9C,8DAA8D;AAC9D,2EAA2E;AAC3E,gFAAgF;AAChF,gFAAgF;AAChF,wEAAwE;AACxE,6EAA6E;AAC7E,8EAA8E;AAC9E,0EAA0E;AAC1E,0EAA0E;AAC1E,6EAA6E;AAC7E,iFAAiF;AACjF,+EAA+E;AAC/E,uCAAuC;AACvC,EAAE;AACF,0EAA0E;AAC1E,oEAAoE;AACpE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAA;AAC9E,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAGlE,MAAM,aAAa,GAAG,SAAS,CAAA;AAE/B,0EAA0E;AAC1E,MAAM,cAAc,GAAG,KAAK,CAAA;AAE5B;;;;GAIG;AACH,SAAS,eAAe,CAAC,MAA0B;IACjD,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAC1C,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,KAAK,aAAa,CAAC,WAAW,EAAE,EAAE,CAAC;QACxF,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAA;IACvD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;AAC7C,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,mBAAmB;IAC1B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,eAAe,EAAE,CAAC,QAAQ,CAAC,CAAA;QAC/C,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAA;QACrD,OAAO,GAAG,GAAG,CAAC,MAAM,wCAAwC,IAAI,EAAE,CAAA;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,SAAS,CAAC,GAAa,EAAE,KAAuB;IACvD,MAAM,MAAM,GAAG,CAAC,UAAU,cAAc,GAAG,CAAC,CAAA;IAC5C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,CAAC,IAAI,CAAC,UAAU,KAAK,GAAG,EAAE,iDAAiD,CAAC,CAAA;IACpF,CAAC;IACD,MAAM,WAAW,GAAG,mBAAmB,EAAE,CAAA;IACzC,IAAI,WAAW,KAAK,SAAS;QAAE,MAAM,CAAC,IAAI,CAAC,sBAAsB,WAAW,GAAG,CAAC,CAAA;IAChF,GAAG,CAAC,SAAS,CAAC,kBAAkB,EAAE,UAAU,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAChE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,IAAI,cAAc,EAAE,CAAC,CAAA;AAC1D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,GAAY,EAAE,GAAa,EAAE,IAAkB;IAC7E,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAA;IAC1D,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,SAAS,CAAC,GAAG,CAAC,CAAA;QACd,OAAM;IACR,CAAC;IACD,iBAAiB,CAAC,KAAK,EAAE,eAAe,EAAE,CAAC;SACxC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;QACf,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,SAAS,CAAC,GAAG,EAAE,eAAe,CAAC,CAAA;YAC/B,OAAM;QACR,CAAC;QACD,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAA;QAChC,qEAAqE;QACrE,6DAA6D;QAC7D,oEAAoE;QACpE,2EAA2E;QAC3E,gEAAgE;QAChE,GAAG,CAAC,WAAW,GAAG,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAA;QACtD,WAAW,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QAC5D,IAAI,EAAE,CAAA;IACR,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QACtB,2EAA2E;QAC3E,mEAAmE;QACnE,GAAG,EAAE,CAAC,KAAK,CACT,EAAE,GAAG,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,EAAE,EACpD,oCAAoC,CACrC,CAAA;QACD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC,CAAA;IACxD,CAAC,CAAC,CAAA;AACN,CAAC"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
// SPDX-License-Identifier: Apache-2.0
|
|
2
|
-
// Redis-backed rate limiting (
|
|
2
|
+
// Redis-backed rate limiting (per-IP on the OAuth/login endpoints).
|
|
3
3
|
//
|
|
4
4
|
// REUSABLE FACTORY: createRateLimiter({ points, duration, keyPrefix, ... })
|
|
5
5
|
// returns Express middleware backed by rate-limiter-flexible — RateLimiterRedis
|
|
@@ -7,7 +7,7 @@
|
|
|
7
7
|
// so the bucket MUST live in Redis, not per-process), else RateLimiterMemory
|
|
8
8
|
// (local/CI parity, and the test seam — NO real Redis in CI).
|
|
9
9
|
//
|
|
10
|
-
// KEYING DIMENSIONS (mcp-design.
|
|
10
|
+
// KEYING DIMENSIONS (docs/concepts/mcp-design.mdx "per-user + per-key"):
|
|
11
11
|
// - /mcp -> per-AUTHENTICATED-USER (req.userId, bound by oauthBearerAuth).
|
|
12
12
|
// - /auth/login + future /oauth/* -> per-IP (req.ip — correct because app.ts
|
|
13
13
|
// sets `trust proxy`, so this is the client address, not the Railway proxy).
|
|
@@ -120,7 +120,7 @@ export function createRateLimiter(options) {
|
|
|
120
120
|
//
|
|
121
121
|
// TRADEOFF (DECISION, see header): fail-open trades protection for
|
|
122
122
|
// availability — a Redis outage with failOpen:true lets EVERY request
|
|
123
|
-
// through, so brute-force throttling on /auth/login
|
|
123
|
+
// through, so brute-force throttling on /auth/login
|
|
124
124
|
// silently lapses with no over-limit 429s to alert on. The counter below
|
|
125
125
|
// is the alert signal that makes the outage observable: an operator can
|
|
126
126
|
// react (or flip a specific limiter to failOpen:false to fail-closed,
|