@frontmcp/sdk 0.7.2 → 0.8.0

package/errors/elicitation.error.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Elicitation Error Classes
+ *
+ * Errors related to MCP elicitation requests.
+ */
+import { PublicMcpError, InternalMcpError } from './mcp.error';
+/**
+ * Elicitation not supported error.
+ *
+ * Thrown when attempting to elicit from a client that does not support
+ * elicitation, or when the transport is not available for elicitation.
+ */
+export declare class ElicitationNotSupportedError extends PublicMcpError {
+    constructor(message?: string);
+}
+/**
+ * Elicitation fallback required.
+ *
+ * Thrown when elicitation is requested but the client doesn't support the
+ * standard elicitation protocol. This is NOT a failure error - it triggers
+ * the fallback flow where the tool returns instructions to the LLM, and
+ * the LLM uses the sendElicitationResult tool to continue.
+ *
+ * This error carries all context needed to re-invoke the tool when
+ * the result arrives via sendElicitationResult.
+ */
+export declare class ElicitationFallbackRequired extends PublicMcpError {
+    /** Unique identifier for this elicitation request */
+    readonly elicitId: string;
+    /** Message to display to the user */
+    readonly elicitMessage: string;
+    /** JSON Schema for the expected response */
+    readonly schema: Record<string, unknown>;
+    /** Name of the tool that requested elicitation */
+    readonly toolName: string;
+    /** Original input arguments passed to the tool */
+    readonly toolInput: unknown;
+    /** Time-to-live in milliseconds */
+    readonly ttl: number;
+    constructor(
+    /** Unique identifier for this elicitation request */
+    elicitId: string, 
+    /** Message to display to the user */
+    elicitMessage: string, 
+    /** JSON Schema for the expected response */
+    schema: Record<string, unknown>, 
+    /** Name of the tool that requested elicitation */
+    toolName: string, 
+    /** Original input arguments passed to the tool */
+    toolInput: unknown, 
+    /** Time-to-live in milliseconds */
+    ttl: number);
+    getPublicMessage(): string;
+}
+/**
+ * Elicitation timeout error.
+ *
+ * Thrown when an elicitation request times out waiting for user response.
+ * This error is thrown to kill the tool/agent execution memory and ensure
+ * resources are properly cleaned up.
+ */
+export declare class ElicitationTimeoutError extends PublicMcpError {
+    /** The ID of the timed-out elicitation request */
+    readonly elicitId: string;
+    /** The TTL that was exceeded (in milliseconds) */
+    readonly ttl: number;
+    constructor(elicitId: string, ttl: number);
+    getPublicMessage(): string;
+}
+/**
+ * Elicitation store not initialized error.
+ *
+ * Thrown when attempting to access the elicitation store before scope initialization
+ * has completed. Callers should await scope.ready before accessing elicitationStore.
+ */
+export declare class ElicitationStoreNotInitializedError extends InternalMcpError {
+    constructor();
+}
+/**
+ * Elicitation disabled error.
+ *
+ * Thrown when attempting to use elicitation when it is disabled in server configuration.
+ * To enable elicitation, set `elicitation: { enabled: true }` in @FrontMcp metadata.
+ */
+export declare class ElicitationDisabledError extends PublicMcpError {
+    constructor();
+    getPublicMessage(): string;
+}
+/**
+ * Elicitation encryption error.
+ *
+ * Thrown when encryption/decryption fails for elicitation data,
+ * typically when sessionId is missing or key derivation fails.
+ */
+export declare class ElicitationEncryptionError extends InternalMcpError {
+    readonly originalError?: Error;
+    constructor(message: string, originalError?: Error);
+    getInternalMessage(): string;
+}
+/**
+ * Elicitation subscription error.
+ *
+ * Thrown when subscription to elicitation pub/sub channel fails.
+ * This is distinct from timeout - it indicates a transport or infrastructure
+ * failure rather than user non-response.
+ */
+export declare class ElicitationSubscriptionError extends InternalMcpError {
+    /** The ID of the elicitation request that failed to subscribe */
+    readonly elicitId: string;
+    /** The underlying error that caused the subscription failure */
+    readonly originalError?: Error;
+    constructor(elicitId: string, originalError?: Error);
+    getInternalMessage(): string;
+}
+//# sourceMappingURL=elicitation.error.d.ts.map

package/errors/elicitation.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elicitation.error.d.ts","sourceRoot":"","sources":["../../src/errors/elicitation.error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/D;;;;;GAKG;AACH,qBAAa,4BAA6B,SAAQ,cAAc;gBAClD,OAAO,SAAwC;CAG5D;AAED;;;;;;;;;;GAUG;AACH,qBAAa,2BAA4B,SAAQ,cAAc;IAE3D,qDAAqD;aACrC,QAAQ,EAAE,MAAM;IAChC,qCAAqC;aACrB,aAAa,EAAE,MAAM;IACrC,4CAA4C;aAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC/C,kDAAkD;aAClC,QAAQ,EAAE,MAAM;IAChC,kDAAkD;aAClC,SAAS,EAAE,OAAO;IAClC,mCAAmC;aACnB,GAAG,EAAE,MAAM;;IAX3B,qDAAqD;IACrC,QAAQ,EAAE,MAAM;IAChC,qCAAqC;IACrB,aAAa,EAAE,MAAM;IACrC,4CAA4C;IAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC/C,kDAAkD;IAClC,QAAQ,EAAE,MAAM;IAChC,kDAAkD;IAClC,SAAS,EAAE,OAAO;IAClC,mCAAmC;IACnB,GAAG,EAAE,MAAM;IAKpB,gBAAgB,IAAI,MAAM;CAGpC;AAED;;;;;;GAMG;AACH,qBAAa,uBAAwB,SAAQ,cAAc;IACzD,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,kDAAkD;IAClD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAET,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;IAMhC,gBAAgB,IAAI,MAAM;CAGpC;AAED;;;;;GAKG;AACH,qBAAa,mCAAoC,SAAQ,gBAAgB;;CAOxE;AAED;;;;;GAKG;AACH,qBAAa,wBAAyB,SAAQ,cAAc;;IASjD,gBAAgB,IAAI,MAAM;CAGpC;AAED;;;;;GAKG;AACH,qBAAa,0BAA2B,SAAQ,gBAAgB;IAC9D,QAAQ,CAAC,aAAa,CAAC,EAAE,KAAK,CAAC;gBAEnB,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,KAAK;IAKzC,kBAAkB,IAAI,MAAM;CAMtC;AAED;;;;;;GAMG;AACH,qBAAa,4BAA6B,SAAQ,gBAAgB;IAChE,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,gEAAgE;IAChE,QAAQ,CAAC,aAAa,CAAC,EAAE,KAAK,CAAC;gBAEnB,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,KAAK;IAS1C,kBAAkB,IAAI,MAAM;CAMtC"}

package/errors/index.d.ts

@@ -2,5 +2,6 @@ export { McpError, PublicMcpError, InternalMcpError, ToolNotFoundError, ToolExec
 export { authorizationRequiredDataSchema, authorizationRequiredParamsSchema, authorizationRequiredMetaSchema, AuthorizationRequiredData, AuthorizationRequiredParams, AuthorizationRequiredMeta, AuthorizationRequiredError, } from './authorization-required.error';
 export { ErrorHandler, ErrorHandlerOptions, createErrorHandler, shouldStopExecution } from './error-handler';
 export { AgentNotFoundError, AgentExecutionError, AgentLoopExceededError, AgentTimeoutError, AgentVisibilityError, AgentLlmError, AgentConfigurationError, AgentNotConfiguredError, AgentToolNotFoundError, } from './agent.errors';
+export { ElicitationNotSupportedError, ElicitationTimeoutError, ElicitationFallbackRequired, ElicitationStoreNotInitializedError, ElicitationDisabledError, ElicitationEncryptionError, ElicitationSubscriptionError, } from './elicitation.error';
 export { RemoteConnectionError, RemoteDisconnectError, RemoteTimeoutError, RemoteToolNotFoundError, RemoteResourceNotFoundError, RemotePromptNotFoundError, RemoteAuthError, RemoteAuthorizationError, RemoteToolExecutionError, RemoteResourceReadError, RemotePromptGetError, RemoteTransportError, RemoteUnsupportedTransportError, RemoteCapabilityDiscoveryError, RemoteCapabilityNotSupportedError, RemoteConfigurationError, RemoteNotConnectedError, } from './remote.errors';
 //# sourceMappingURL=index.d.ts.map

package/errors/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,QAAQ,EACR,cAAc,EACd,gBAAgB,EAEhB,iBAAiB,EACjB,kBAAkB,EAElB,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,EAEvB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAElB,cAAc,EACd,kBAAkB,EAElB,iBAAiB,EAEjB,mBAAmB,EACnB,6BAA6B,EAE7B,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,uBAAuB,EACvB,+BAA+B,EAE/B,sBAAsB,EACtB,yBAAyB,EAEzB,mBAAmB,EACnB,oBAAoB,EAEpB,aAAa,EACb,UAAU,EACV,sBAAsB,EAEtB,eAAe,EACf,KAAK,YAAY,GAClB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAEL,+BAA+B,EAC/B,iCAAiC,EACjC,+BAA+B,EAE/B,yBAAyB,EACzB,2BAA2B,EAC3B,yBAAyB,EAEzB,0BAA0B,GAC3B,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAG7G,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,EACb,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAEL,qBAAqB,EACrB,qBAAqB,EAErB,kBAAkB,EAElB,uBAAuB,EACvB,2BAA2B,EAC3B,yBAAyB,EAEzB,eAAe,EACf,wBAAwB,EAExB,wBAAwB,EACxB,uBAAuB,EACvB,oBAAoB,EAEpB,oBAAoB,EACpB,+BAA+B,EAE/B,8BAA8B,EAC9B,iCAAiC,EAEjC,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,QAAQ,EACR,cAAc,EACd,gBAAgB,EAEhB,iBAAiB,EACjB,kBAAkB,EAElB,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,EAEvB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAElB,cAAc,EACd,kBAAkB,EAElB,iBAAiB,EAEjB,mBAAmB,EACnB,6BAA6B,EAE7B,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,uBAAuB,EACvB,+BAA+B,EAE/B,sBAAsB,EACtB,yBAAyB,EAEzB,mBAAmB,EACnB,oBAAoB,EAEpB,aAAa,EACb,UAAU,EACV,sBAAsB,EAEtB,eAAe,EACf,KAAK,YAAY,GAClB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAEL,+BAA+B,EAC/B,iCAAiC,EACjC,+BAA+B,EAE/B,yBAAyB,EACzB,2BAA2B,EAC3B,yBAAyB,EAEzB,0BAA0B,GAC3B,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAG7G,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,EACb,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,4BAA4B,EAC5B,uBAAuB,EACvB,2BAA2B,EAC3B,mCAAmC,EACnC,wBAAwB,EACxB,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAEL,qBAAqB,EACrB,qBAAqB,EAErB,kBAAkB,EAElB,uBAAuB,EACvB,2BAA2B,EAC3B,yBAAyB,EAEzB,eAAe,EACf,wBAAwB,EAExB,wBAAwB,EACxB,uBAAuB,EACvB,oBAAoB,EAEpB,oBAAoB,EACpB,+BAA+B,EAE/B,8BAA8B,EAC9B,iCAAiC,EAEjC,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC"}