@frontmcp/sdk 1.3.0 → 1.4.1
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/README.md +65 -60
- package/agent/agent.scope.d.ts +164 -0
- package/agent/agent.scope.d.ts.map +1 -1
- package/app/instances/app.esm.instance.d.ts.map +1 -1
- package/app/instances/app.remote.instance.d.ts.map +1 -1
- package/auth/auth-ui/auth-ui.contract.d.ts +149 -0
- package/auth/auth-ui/auth-ui.contract.d.ts.map +1 -0
- package/auth/auth-ui/auth-ui.registry.d.ts +151 -0
- package/auth/auth-ui/auth-ui.registry.d.ts.map +1 -0
- package/auth/auth-ui/auth-ui.render.d.ts +49 -0
- package/auth/auth-ui/auth-ui.render.d.ts.map +1 -0
- package/auth/auth-ui/auth-ui.state.d.ts +62 -0
- package/auth/auth-ui/auth-ui.state.d.ts.map +1 -0
- package/auth/auth-ui/index.d.ts +24 -0
- package/auth/auth-ui/index.d.ts.map +1 -0
- package/auth/auth.registry.d.ts.map +1 -1
- package/auth/authorized-apps.utils.d.ts +51 -0
- package/auth/authorized-apps.utils.d.ts.map +1 -0
- package/auth/consent-tools.helper.d.ts +26 -0
- package/auth/consent-tools.helper.d.ts.map +1 -0
- package/auth/consent.utils.d.ts +62 -0
- package/auth/consent.utils.d.ts.map +1 -0
- package/auth/credentials/credentials.context-extension.d.ts +63 -0
- package/auth/credentials/credentials.context-extension.d.ts.map +1 -0
- package/auth/credentials/credentials.providers.d.ts +40 -0
- package/auth/credentials/credentials.providers.d.ts.map +1 -0
- package/auth/credentials/index.d.ts +3 -0
- package/auth/credentials/index.d.ts.map +1 -0
- package/auth/flows/auth.verify.flow.d.ts.map +1 -1
- package/auth/flows/oauth.auth-ui.flow.d.ts +53 -0
- package/auth/flows/oauth.auth-ui.flow.d.ts.map +1 -0
- package/auth/flows/oauth.authorize.flow.d.ts +51 -9
- package/auth/flows/oauth.authorize.flow.d.ts.map +1 -1
- package/auth/flows/oauth.callback.flow.d.ts +118 -5
- package/auth/flows/oauth.callback.flow.d.ts.map +1 -1
- package/auth/flows/oauth.connect.flow.d.ts +89 -0
- package/auth/flows/oauth.connect.flow.d.ts.map +1 -0
- package/auth/flows/oauth.provider-callback.flow.d.ts +34 -4
- package/auth/flows/oauth.provider-callback.flow.d.ts.map +1 -1
- package/auth/flows/oauth.register.flow.d.ts +16 -20
- package/auth/flows/oauth.register.flow.d.ts.map +1 -1
- package/auth/flows/oauth.token.flow.d.ts +2 -2
- package/auth/flows/oauth.token.flow.d.ts.map +1 -1
- package/auth/flows/oauth.userinfo.flow.d.ts +67 -0
- package/auth/flows/oauth.userinfo.flow.d.ts.map +1 -0
- package/auth/flows/session.verify.flow.d.ts +2 -2
- package/auth/flows/session.verify.flow.d.ts.map +1 -1
- package/auth/flows/well-known.jwks.flow.d.ts +3 -3
- package/auth/flows/well-known.oauth-authorization-server.flow.d.ts +3 -2
- package/auth/flows/well-known.oauth-authorization-server.flow.d.ts.map +1 -1
- package/auth/flows/well-known.prm.flow.d.ts +1 -1
- package/auth/flows/well-known.prm.flow.d.ts.map +1 -1
- package/auth/instances/instance.local-primary-auth.d.ts +226 -12
- package/auth/instances/instance.local-primary-auth.d.ts.map +1 -1
- package/auth/secure-store/index.d.ts +3 -0
- package/auth/secure-store/index.d.ts.map +1 -0
- package/auth/secure-store/secure-store.context-extension.d.ts +61 -0
- package/auth/secure-store/secure-store.context-extension.d.ts.map +1 -0
- package/auth/secure-store/secure-store.providers.d.ts +36 -0
- package/auth/secure-store/secure-store.providers.d.ts.map +1 -0
- package/common/decorators/agent.decorator.d.ts +32 -0
- package/common/decorators/agent.decorator.d.ts.map +1 -1
- package/common/decorators/app.decorator.d.ts.map +1 -1
- package/common/decorators/front-mcp.decorator.d.ts.map +1 -1
- package/common/decorators/skill.decorator.d.ts.map +1 -1
- package/common/decorators/tool.decorator.d.ts +44 -0
- package/common/decorators/tool.decorator.d.ts.map +1 -1
- package/common/entries/scope.entry.d.ts +7 -0
- package/common/entries/scope.entry.d.ts.map +1 -1
- package/common/entries/skill.entry.d.ts +22 -1
- package/common/entries/skill.entry.d.ts.map +1 -1
- package/common/entries/tool.entry.d.ts +17 -0
- package/common/entries/tool.entry.d.ts.map +1 -1
- package/common/interfaces/internal/primary-auth-provider.interface.d.ts +18 -0
- package/common/interfaces/internal/primary-auth-provider.interface.d.ts.map +1 -1
- package/common/interfaces/tool.interface.d.ts +26 -0
- package/common/interfaces/tool.interface.d.ts.map +1 -1
- package/common/metadata/app.metadata.d.ts +472 -0
- package/common/metadata/app.metadata.d.ts.map +1 -1
- package/common/metadata/front-mcp.metadata.d.ts +1773 -52
- package/common/metadata/front-mcp.metadata.d.ts.map +1 -1
- package/common/metadata/index.d.ts +1 -0
- package/common/metadata/index.d.ts.map +1 -1
- package/common/metadata/output-policy.d.ts +82 -0
- package/common/metadata/output-policy.d.ts.map +1 -0
- package/common/metadata/skill.metadata.d.ts +45 -1
- package/common/metadata/skill.metadata.d.ts.map +1 -1
- package/common/metadata/tool-ui.metadata.d.ts +1 -1
- package/common/metadata/tool-ui.metadata.d.ts.map +1 -1
- package/common/metadata/tool.metadata.d.ts +65 -0
- package/common/metadata/tool.metadata.d.ts.map +1 -1
- package/common/schemas/http-output.schema.d.ts +25 -25
- package/common/schemas/http-output.schema.d.ts.map +1 -1
- package/common/tokens/app.tokens.d.ts.map +1 -1
- package/common/tokens/front-mcp.tokens.d.ts.map +1 -1
- package/common/tokens/skill.tokens.d.ts +2 -0
- package/common/tokens/skill.tokens.d.ts.map +1 -1
- package/common/tokens/tool.tokens.d.ts +1 -0
- package/common/tokens/tool.tokens.d.ts.map +1 -1
- package/common/types/auth/session.types.d.ts +2 -2
- package/common/types/options/auth/index.d.ts +4 -4
- package/common/types/options/auth/index.d.ts.map +1 -1
- package/common/types/options/auth/interfaces.d.ts +1 -1
- package/common/types/options/auth/interfaces.d.ts.map +1 -1
- package/common/types/options/auth/orchestrated.schema.d.ts +1 -1
- package/common/types/options/auth/orchestrated.schema.d.ts.map +1 -1
- package/common/types/options/auth/shared.schemas.d.ts +2 -2
- package/common/types/options/auth/shared.schemas.d.ts.map +1 -1
- package/common/types/options/http/index.d.ts +1 -1
- package/common/types/options/http/index.d.ts.map +1 -1
- package/common/types/options/http/interfaces.d.ts +56 -1
- package/common/types/options/http/interfaces.d.ts.map +1 -1
- package/common/types/options/http/schema.d.ts +15 -0
- package/common/types/options/http/schema.d.ts.map +1 -1
- package/common/types/options/session/schema.d.ts +3 -3
- package/common/types/options/transport/schema.d.ts +1 -1
- package/common/utils/caller-dir.utils.d.ts +15 -0
- package/common/utils/caller-dir.utils.d.ts.map +1 -0
- package/common/utils/index.d.ts +1 -0
- package/common/utils/index.d.ts.map +1 -1
- package/errors/index.d.ts +3 -1
- package/errors/index.d.ts.map +1 -1
- package/errors/mcp.error.d.ts +36 -2
- package/errors/mcp.error.d.ts.map +1 -1
- package/errors/tool-credentials-required.error.d.ts +70 -0
- package/errors/tool-credentials-required.error.d.ts.map +1 -0
- package/esm/index.mjs +6553 -2688
- package/flows/flow.instance.d.ts.map +1 -1
- package/front-mcp/front-mcp.d.ts +52 -32
- package/front-mcp/front-mcp.d.ts.map +1 -1
- package/front-mcp/front-mcp.providers.d.ts +700 -8
- package/front-mcp/front-mcp.providers.d.ts.map +1 -1
- package/index.d.ts +29 -4
- package/index.d.ts.map +1 -1
- package/index.js +7138 -3307
- package/package.json +28 -29
- package/scope/flows/http.request.flow.d.ts +18 -1
- package/scope/flows/http.request.flow.d.ts.map +1 -1
- package/scope/optional-dependency.util.d.ts +39 -0
- package/scope/optional-dependency.util.d.ts.map +1 -0
- package/scope/scope.instance.d.ts +17 -0
- package/scope/scope.instance.d.ts.map +1 -1
- package/scope/scope.utils.d.ts.map +1 -1
- package/server/adapters/express.host.adapter.d.ts.map +1 -1
- package/server/custom-routes.helper.d.ts +81 -0
- package/server/custom-routes.helper.d.ts.map +1 -0
- package/skill/flows/http/llm-full-txt.flow.d.ts +1 -1
- package/skill/flows/http/llm-txt.flow.d.ts +1 -1
- package/skill/flows/http/skills-api.flow.d.ts +18 -1
- package/skill/flows/http/skills-api.flow.d.ts.map +1 -1
- package/skill/flows/load-skill.flow.d.ts +7 -0
- package/skill/flows/load-skill.flow.d.ts.map +1 -1
- package/skill/flows/search-skills.flow.d.ts +13 -0
- package/skill/flows/search-skills.flow.d.ts.map +1 -1
- package/skill/index.d.ts +1 -0
- package/skill/index.d.ts.map +1 -1
- package/skill/sep-2640/resources/skill-file.resource.d.ts.map +1 -1
- package/skill/sep-2640/resources/skill-index.resource.d.ts.map +1 -1
- package/skill/sep-2640/resources/skill-md.resource.d.ts.map +1 -1
- package/skill/sep-2640/sep-2640.per-skill.d.ts.map +1 -1
- package/skill/skill-authorities.helper.d.ts +100 -0
- package/skill/skill-authorities.helper.d.ts.map +1 -0
- package/skill/skill.instance.d.ts.map +1 -1
- package/skill/skill.registry.d.ts +34 -0
- package/skill/skill.registry.d.ts.map +1 -1
- package/task/helpers/cli-task-runner.d.ts.map +1 -1
- package/tool/flows/call-tool.flow.d.ts +26 -1
- package/tool/flows/call-tool.flow.d.ts.map +1 -1
- package/tool/flows/tool-credentials.gate.d.ts +31 -0
- package/tool/flows/tool-credentials.gate.d.ts.map +1 -0
- package/tool/flows/tools-list.flow.d.ts.map +1 -1
- package/tool/tool.instance.d.ts.map +1 -1
- package/tool/ui/index.d.ts +1 -1
- package/tool/ui/index.d.ts.map +1 -1
- package/tool/ui/ui-resource.handler.d.ts.map +1 -1
- package/tool/ui/ui-shared.d.ts +33 -1
- package/tool/ui/ui-shared.d.ts.map +1 -1
- package/transport/adapters/transport.local.adapter.d.ts.map +1 -1
- package/transport/flows/handle.sse.flow.d.ts +1 -1
- package/transport/flows/handle.streamable-http.flow.d.ts +58 -1
- package/transport/flows/handle.streamable-http.flow.d.ts.map +1 -1
- package/transport/mcp-handlers/call-tool-request.handler.d.ts.map +1 -1
- package/transport/mcp-handlers/read-resource-request.handler.d.ts.map +1 -1
- package/transport/mcp-handlers/skills-list-request.handler.d.ts.map +1 -1
- package/transport/mcp-handlers/skills-load-request.handler.d.ts.map +1 -1
- package/transport/mcp-handlers/skills-search-request.handler.d.ts.map +1 -1
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Capture the directory of the first user-code frame on the current call stack.
|
|
3
|
+
*
|
|
4
|
+
* Returns `undefined` when no user frame can be determined (e.g. an exotic
|
|
5
|
+
* loader strips stack frames, or the runtime has no V8-style stack) — callers
|
|
6
|
+
* fall back to `process.cwd()`.
|
|
7
|
+
*
|
|
8
|
+
* @param skipBasenames - Additional file basenames to skip (e.g. the caller's
|
|
9
|
+
* own decorator file `front-mcp.decorator.ts` / `.js`), so the FIRST returned
|
|
10
|
+
* frame is the user's module, not the framework's wrapper. Matched by
|
|
11
|
+
* basename only (POSIX + Windows), so `foo.decorator.spec.ts` is NOT skipped
|
|
12
|
+
* when `foo.decorator.ts` is.
|
|
13
|
+
*/
|
|
14
|
+
export declare function captureCallerDir(skipBasenames?: readonly string[]): string | undefined;
|
|
15
|
+
//# sourceMappingURL=caller-dir.utils.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"caller-dir.utils.d.ts","sourceRoot":"","sources":["../../../src/common/utils/caller-dir.utils.ts"],"names":[],"mappings":"AA4BA;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,aAAa,GAAE,SAAS,MAAM,EAAO,GAAG,MAAM,GAAG,SAAS,CAE1F"}
|
package/common/utils/index.d.ts
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC"}
|
package/errors/index.d.ts
CHANGED
|
@@ -1,6 +1,8 @@
|
|
|
1
|
-
export { McpError, PublicMcpError, InternalMcpError, ToolNotFoundError, ToolExecutionError, EntryUnavailableError, ResourceNotFoundError, ResourceReadError, InvalidResourceUriError, InvalidInputError, InvalidOutputError, InvalidMethodError, PayloadTooLargeError, RateLimitError, QuotaExceededError, UnauthorizedError, SessionMissingError, UnsupportedClientVersionError, GenericServerError, DependencyNotFoundError, InvalidHookFlowError, InvalidPluginScopeError, RequestContextNotAvailableError, AuthConfigurationError, GlobalConfigNotFoundError, PromptNotFoundError, PromptExecutionError, isPublicError, toMcpError, formatMcpErrorResponse, extractPublicMessage, MCP_ERROR_CODES, type McpErrorCode, } from './mcp.error';
|
|
1
|
+
export { McpError, PublicMcpError, InternalMcpError, ToolNotFoundError, ToolNotConsentedError, ToolExecutionError, EntryUnavailableError, ResourceNotFoundError, ResourceReadError, InvalidResourceUriError, InvalidInputError, InvalidOutputError, InvalidMethodError, PayloadTooLargeError, RateLimitError, QuotaExceededError, UnauthorizedError, SessionMissingError, UnsupportedClientVersionError, GenericServerError, DependencyNotFoundError, InvalidHookFlowError, InvalidPluginScopeError, RequestContextNotAvailableError, AuthConfigurationError, GlobalConfigNotFoundError, PromptNotFoundError, PromptExecutionError, isPublicError, toMcpError, formatMcpErrorResponse, extractPublicMessage, MCP_ERROR_CODES, type McpErrorCode, } from './mcp.error';
|
|
2
2
|
export { authorizationRequiredDataSchema, authorizationRequiredParamsSchema, authorizationRequiredMetaSchema, AuthorizationRequiredError, } from './authorization-required.error';
|
|
3
3
|
export type { AuthorizationRequiredData, AuthorizationRequiredParams, AuthorizationRequiredMeta, } from './authorization-required.error';
|
|
4
|
+
export { ToolCredentialsRequiredError } from './tool-credentials-required.error';
|
|
5
|
+
export type { ToolCredentialsRequiredData } from './tool-credentials-required.error';
|
|
4
6
|
export { ErrorHandler, createErrorHandler, shouldStopExecution } from './error-handler';
|
|
5
7
|
export type { ErrorHandlerOptions } from './error-handler';
|
|
6
8
|
export { AgentNotFoundError, AgentExecutionError, AgentLoopExceededError, AgentTimeoutError, AgentVisibilityError, AgentLlmError, AgentConfigurationError, AgentNotConfiguredError, AgentToolNotFoundError, } from './agent.errors';
|
package/errors/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"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"}
|
package/errors/mcp.error.d.ts
CHANGED
|
@@ -76,7 +76,14 @@ export declare class PublicMcpError extends McpError {
|
|
|
76
76
|
readonly isPublic = true;
|
|
77
77
|
readonly statusCode: number;
|
|
78
78
|
readonly code: string;
|
|
79
|
-
|
|
79
|
+
/**
|
|
80
|
+
* Optional RFC 6750 `WWW-Authenticate` challenge to forward to the client
|
|
81
|
+
* when the error maps to a 401. Set by callers that attach an auth challenge
|
|
82
|
+
* (e.g. the local transport adapter when a verified token's session can't be
|
|
83
|
+
* reconstructed, #471); rendered by the flow runner into a response header.
|
|
84
|
+
*/
|
|
85
|
+
readonly wwwAuthenticate?: string;
|
|
86
|
+
constructor(message: string, code?: string, statusCode?: number, wwwAuthenticate?: string);
|
|
80
87
|
getPublicMessage(): string;
|
|
81
88
|
}
|
|
82
89
|
/**
|
|
@@ -96,6 +103,33 @@ export declare class InternalMcpError extends McpError {
|
|
|
96
103
|
export declare class ToolNotFoundError extends PublicMcpError {
|
|
97
104
|
constructor(toolName: string);
|
|
98
105
|
}
|
|
106
|
+
/**
|
|
107
|
+
* Tool not consented error.
|
|
108
|
+
*
|
|
109
|
+
* Thrown at `tools/call` time when consent mode is enabled and the caller's
|
|
110
|
+
* verified token carries a `consent` claim whose selected-tool set does NOT
|
|
111
|
+
* include the requested tool. This is the runtime enforcement of the consent
|
|
112
|
+
* screen: a user who unchecked a tool during authorization cannot invoke it.
|
|
113
|
+
*
|
|
114
|
+
* Tokens with NO consent metadata (consent disabled) never reach this error —
|
|
115
|
+
* the call-tool flow skips the check entirely so the default (allow-all)
|
|
116
|
+
* behavior is preserved.
|
|
117
|
+
*
|
|
118
|
+
* Mapped to JSON-RPC -32003 (FORBIDDEN) so clients can distinguish a
|
|
119
|
+
* deliberately-withheld tool from a missing one (-32601 / 404).
|
|
120
|
+
*/
|
|
121
|
+
export declare class ToolNotConsentedError extends PublicMcpError {
|
|
122
|
+
readonly mcpErrorCode: -32003;
|
|
123
|
+
readonly toolName: string;
|
|
124
|
+
constructor(toolName: string);
|
|
125
|
+
toJsonRpcError(): {
|
|
126
|
+
code: number;
|
|
127
|
+
message: string;
|
|
128
|
+
data: {
|
|
129
|
+
tool: string;
|
|
130
|
+
};
|
|
131
|
+
};
|
|
132
|
+
}
|
|
99
133
|
/**
|
|
100
134
|
* Entry unavailable in the current environment.
|
|
101
135
|
* Thrown when a tool/resource/prompt/skill/agent exists but is restricted
|
|
@@ -249,7 +283,7 @@ export declare class QuotaExceededError extends PublicMcpError {
|
|
|
249
283
|
* Unauthorized error
|
|
250
284
|
*/
|
|
251
285
|
export declare class UnauthorizedError extends PublicMcpError {
|
|
252
|
-
constructor(message?: string);
|
|
286
|
+
constructor(message?: string, wwwAuthenticate?: string);
|
|
253
287
|
}
|
|
254
288
|
/**
|
|
255
289
|
* Generic server error wrapper
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"mcp.error.d.ts","sourceRoot":"","sources":["../../src/errors/mcp.error.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,eAAO,MAAM,eAAe;IAC1B,kDAAkD;;IAElD,kCAAkC;;IAElC,+DAA+D;;IAE/D,+BAA+B;;IAE/B,gCAAgC;;IAEhC,8BAA8B;;IAE9B,8BAA8B;;IAE9B,2BAA2B;;CAEnB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAElF;;GAEG;AACH,8BAAsB,QAAS,SAAQ,KAAK;IAC1C;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAEpC;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAErC;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAE/B,SAAS,aAAa,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;IAOvD,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACH,QAAQ,CAAC,gBAAgB,IAAI,MAAM;IAEnC;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;OAEG;IACH,UAAU,CAAC,aAAa,UAAQ,GAAG;QACjC,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC/C,OAAO,EAAE,IAAI,CAAC;QACd,KAAK,CAAC,EAAE;YACN,OAAO,EAAE,MAAM,CAAC;YAChB,IAAI,EAAE,MAAM,CAAC;YACb,SAAS,EAAE,MAAM,CAAC;YAClB,KAAK,CAAC,EAAE,MAAM,CAAC;SAChB,CAAC;KACH;CAmBF;AAED;;;GAGG;AACH,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,QAAQ,CAAC,QAAQ,QAAQ;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;
|
|
1
|
+
{"version":3,"file":"mcp.error.d.ts","sourceRoot":"","sources":["../../src/errors/mcp.error.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Tool Credentials Required Error
|
|
3
|
+
*
|
|
4
|
+
* Thrown by the `checkToolCredentials` stage of the call-tool flow when a tool
|
|
5
|
+
* declares one or more `authProviders` with `required: true` (the default) and
|
|
6
|
+
* the credential for at least one of them is NOT available for the current
|
|
7
|
+
* authenticated session.
|
|
8
|
+
*
|
|
9
|
+
* This is the TOOL-LEVEL credential gate — distinct from {@link AuthorizationRequiredError},
|
|
10
|
+
* which gates at the APP level (progressive app authorization). A tool can be
|
|
11
|
+
* reachable (its app authorized) yet still miss a per-provider credential; this
|
|
12
|
+
* error covers that case and aborts the call BEFORE `execute()` runs.
|
|
13
|
+
*
|
|
14
|
+
* Mapped to JSON-RPC `-32001` (MCP `UNAUTHORIZED`) so clients can distinguish a
|
|
15
|
+
* missing-credential gate from a missing tool (`-32601`) or a withheld/consent
|
|
16
|
+
* tool (`-32003`). The `data` payload carries the offending provider id(s) and
|
|
17
|
+
* an `authUrl` (a framework-signed connect/authorize URL) the client/agent can
|
|
18
|
+
* open to (re)authorize. Both `authUrl` (camelCase, primary) and `auth_url`
|
|
19
|
+
* (snake_case, matching {@link AuthorizationRequiredError}'s convention) are
|
|
20
|
+
* emitted so either naming convention resolves.
|
|
21
|
+
*/
|
|
22
|
+
import { PublicMcpError } from './mcp.error';
|
|
23
|
+
/** JSON-RPC `data` payload for {@link ToolCredentialsRequiredError}. */
|
|
24
|
+
export interface ToolCredentialsRequiredData {
|
|
25
|
+
/** The tool that required the missing credential(s). */
|
|
26
|
+
tool: string;
|
|
27
|
+
/** Provider id(s) whose credential is required but unavailable. */
|
|
28
|
+
providers: string[];
|
|
29
|
+
/** Framework-signed connect/authorize URL (camelCase, primary). */
|
|
30
|
+
authUrl?: string;
|
|
31
|
+
/** Same URL under the snake_case key used by AuthorizationRequiredError. */
|
|
32
|
+
auth_url?: string;
|
|
33
|
+
}
|
|
34
|
+
export declare class ToolCredentialsRequiredError extends PublicMcpError {
|
|
35
|
+
/** JSON-RPC code: MCP UNAUTHORIZED (-32001). */
|
|
36
|
+
readonly mcpErrorCode: -32001;
|
|
37
|
+
/** Tool id that triggered the gate. */
|
|
38
|
+
readonly toolId: string;
|
|
39
|
+
/** Provider id(s) whose credential is required but missing. */
|
|
40
|
+
readonly providers: string[];
|
|
41
|
+
/** Connect/authorize URL to (re)authorize the provider(s), if resolvable. */
|
|
42
|
+
readonly authUrl?: string;
|
|
43
|
+
constructor(params: {
|
|
44
|
+
toolId: string;
|
|
45
|
+
providers: string[];
|
|
46
|
+
authUrl?: string;
|
|
47
|
+
message?: string;
|
|
48
|
+
});
|
|
49
|
+
/**
|
|
50
|
+
* Convert to JSON-RPC error format per MCP specification.
|
|
51
|
+
*
|
|
52
|
+
* @example
|
|
53
|
+
* {
|
|
54
|
+
* "code": -32001,
|
|
55
|
+
* "message": "Tool \"deploy_app\" requires credentials for github ...",
|
|
56
|
+
* "data": {
|
|
57
|
+
* "tool": "deploy_app",
|
|
58
|
+
* "providers": ["github"],
|
|
59
|
+
* "authUrl": "https://.../oauth/connect?token=…",
|
|
60
|
+
* "auth_url": "https://.../oauth/connect?token=…"
|
|
61
|
+
* }
|
|
62
|
+
* }
|
|
63
|
+
*/
|
|
64
|
+
toJsonRpcError(): {
|
|
65
|
+
code: number;
|
|
66
|
+
message: string;
|
|
67
|
+
data: ToolCredentialsRequiredData;
|
|
68
|
+
};
|
|
69
|
+
}
|
|
70
|
+
//# sourceMappingURL=tool-credentials-required.error.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tool-credentials-required.error.d.ts","sourceRoot":"","sources":["../../src/errors/tool-credentials-required.error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAmB,cAAc,EAAE,MAAM,aAAa,CAAC;AAE9D,wEAAwE;AACxE,MAAM,WAAW,2BAA2B;IAC1C,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,4BAA6B,SAAQ,cAAc;IAC9D,gDAAgD;IAChD,QAAQ,CAAC,YAAY,SAAgC;IAErD,uCAAuC;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAE7B,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;gBAEd,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAY/F;;;;;;;;;;;;;;OAcG;IACH,cAAc,IAAI;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,2BAA2B,CAAC;KACnC;CAWF"}
|