@metamask/client-mcp-core 0.1.0

package/dist/mcp-server/tools/interaction.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction.d.cts","sourceRoot":"","sources":["../../../src/mcp-server/tools/interaction.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,SAAS,EACT,UAAU,EACV,YAAY,EACZ,aAAa,EACb,WAAW,EACX,cAAc,EACf,2BAAiB;AASlB;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,UAAU,EACjB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAmFnC;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,SAAS,EAChB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CA+ElC;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,YAAY,EACnB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAuErC"}

package/dist/mcp-server/tools/interaction.d.mts

@@ -0,0 +1,26 @@
+import type { ClickInput, ClickResult, TypeInput, TypeResult, WaitForInput, WaitForResult, McpResponse, HandlerOptions } from "../types/index.mjs";
+/**
+ * Handles clicking on an element specified by testId, selector, or accessibility reference.
+ *
+ * @param input The click input containing target selection and timeout options
+ * @param options Optional handler configuration
+ * @returns Promise resolving to click result with target information
+ */
+export declare function handleClick(input: ClickInput, options?: HandlerOptions): Promise<McpResponse<ClickResult>>;
+/**
+ * Handles typing text into an element specified by testId, selector, or accessibility reference.
+ *
+ * @param input The type input containing target selection, text, and timeout options
+ * @param options Optional handler configuration
+ * @returns Promise resolving to type result with target and text length information
+ */
+export declare function handleType(input: TypeInput, options?: HandlerOptions): Promise<McpResponse<TypeResult>>;
+/**
+ * Handles waiting for an element to become visible.
+ *
+ * @param input The wait input containing target selection and timeout options
+ * @param options Optional handler configuration
+ * @returns Promise resolving to wait result with target information
+ */
+export declare function handleWaitFor(input: WaitForInput, options?: HandlerOptions): Promise<McpResponse<WaitForResult>>;
+//# sourceMappingURL=interaction.d.mts.map

package/dist/mcp-server/tools/interaction.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction.d.mts","sourceRoot":"","sources":["../../../src/mcp-server/tools/interaction.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,SAAS,EACT,UAAU,EACV,YAAY,EACZ,aAAa,EACb,WAAW,EACX,cAAc,EACf,2BAAiB;AASlB;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,UAAU,EACjB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAmFnC;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,SAAS,EAChB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CA+ElC;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,YAAY,EACnB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAuErC"}

package/dist/mcp-server/tools/interaction.mjs

@@ -0,0 +1,185 @@
+import { DEFAULT_INTERACTION_TIMEOUT_MS } from "../constants.mjs";
+import { waitForTarget } from "../discovery.mjs";
+import { getSessionManager } from "../session-manager.mjs";
+import { classifyClickError, classifyTypeError, classifyWaitError, isPageClosedError } from "./error-classification.mjs";
+import { runTool } from "./run-tool.mjs";
+import { ErrorCodes } from "../types/index.mjs";
+import { createErrorResponse, validateTargetSelection, isValidTargetSelection, isInvalidTargetSelection } from "../utils/index.mjs";
+/**
+ * Handles clicking on an element specified by testId, selector, or accessibility reference.
+ *
+ * @param input The click input containing target selection and timeout options
+ * @param options Optional handler configuration
+ * @returns Promise resolving to click result with target information
+ */
+export async function handleClick(input, options) {
+    const startTime = Date.now();
+    const sessionManager = getSessionManager();
+    const sessionId = sessionManager.getSessionId();
+    const timeoutMs = input.timeoutMs ?? DEFAULT_INTERACTION_TIMEOUT_MS;
+    const validation = validateTargetSelection(input);
+    if (isInvalidTargetSelection(validation)) {
+        return createErrorResponse(ErrorCodes.MM_INVALID_INPUT, validation.error, { input }, sessionId, startTime);
+    }
+    if (!isValidTargetSelection(validation)) {
+        return createErrorResponse(ErrorCodes.MM_INVALID_INPUT, 'Invalid target selection', { input }, sessionId, startTime);
+    }
+    const { type: targetType, value: targetValue } = validation;
+    return runTool({
+        toolName: 'mm_click',
+        input,
+        options,
+        /**
+         * Executes the click action on the target element.
+         *
+         * @param context The tool execution context containing page and reference map
+         * @returns Promise resolving to click result with success status and target info
+         */
+        execute: async (context) => {
+            const locator = await waitForTarget(context.page, targetType, targetValue, context.refMap, timeoutMs);
+            try {
+                await locator.click();
+                return {
+                    clicked: true,
+                    target: `${targetType}:${targetValue}`,
+                };
+            }
+            catch (clickError) {
+                if (isPageClosedError(clickError)) {
+                    return {
+                        clicked: true,
+                        target: `${targetType}:${targetValue}`,
+                        pageClosedAfterClick: true,
+                    };
+                }
+                throw clickError;
+            }
+        },
+        /**
+         * Returns the target element information for recording.
+         *
+         * @returns Object containing the target type and value
+         */
+        getTarget: () => ({ [targetType]: targetValue }),
+        classifyError: classifyClickError,
+        /**
+         * Sanitizes input for knowledge store recording.
+         *
+         * @returns Sanitized input object with timeout information
+         */
+        sanitizeInputForRecording: () => ({ timeoutMs }),
+    });
+}
+/**
+ * Handles typing text into an element specified by testId, selector, or accessibility reference.
+ *
+ * @param input The type input containing target selection, text, and timeout options
+ * @param options Optional handler configuration
+ * @returns Promise resolving to type result with target and text length information
+ */
+export async function handleType(input, options) {
+    const startTime = Date.now();
+    const sessionManager = getSessionManager();
+    const sessionId = sessionManager.getSessionId();
+    const timeoutMs = input.timeoutMs ?? DEFAULT_INTERACTION_TIMEOUT_MS;
+    const validation = validateTargetSelection(input);
+    if (isInvalidTargetSelection(validation)) {
+        return createErrorResponse(ErrorCodes.MM_INVALID_INPUT, validation.error, { input }, sessionId, startTime);
+    }
+    if (!isValidTargetSelection(validation)) {
+        return createErrorResponse(ErrorCodes.MM_INVALID_INPUT, 'Invalid target selection', { input }, sessionId, startTime);
+    }
+    const { type: targetType, value: targetValue } = validation;
+    return runTool({
+        toolName: 'mm_type',
+        input,
+        options,
+        /**
+         * Executes the type action on the target element.
+         *
+         * @param context The tool execution context containing page and reference map
+         * @returns Promise resolving to type result with success status and text length
+         */
+        execute: async (context) => {
+            const locator = await waitForTarget(context.page, targetType, targetValue, context.refMap, timeoutMs);
+            await locator.fill(input.text);
+            return {
+                typed: true,
+                target: `${targetType}:${targetValue}`,
+                textLength: input.text.length,
+            };
+        },
+        /**
+         * Returns the target element information for recording.
+         *
+         * @returns Object containing the target type and value
+         */
+        getTarget: () => ({ [targetType]: targetValue }),
+        classifyError: classifyTypeError,
+        /**
+         * Sanitizes input for knowledge store recording.
+         *
+         * @returns Sanitized input object with timeout and text information
+         */
+        sanitizeInputForRecording: () => ({
+            timeoutMs,
+            text: input.text,
+            testId: input.testId,
+            selector: input.selector,
+            a11yRef: input.a11yRef,
+        }),
+    });
+}
+/**
+ * Handles waiting for an element to become visible.
+ *
+ * @param input The wait input containing target selection and timeout options
+ * @param options Optional handler configuration
+ * @returns Promise resolving to wait result with target information
+ */
+export async function handleWaitFor(input, options) {
+    const startTime = Date.now();
+    const sessionManager = getSessionManager();
+    const sessionId = sessionManager.getSessionId();
+    const timeoutMs = input.timeoutMs ?? DEFAULT_INTERACTION_TIMEOUT_MS;
+    const validation = validateTargetSelection(input);
+    if (isInvalidTargetSelection(validation)) {
+        return createErrorResponse(ErrorCodes.MM_INVALID_INPUT, validation.error, { input }, sessionId, startTime);
+    }
+    if (!isValidTargetSelection(validation)) {
+        return createErrorResponse(ErrorCodes.MM_INVALID_INPUT, 'Invalid target selection', { input }, sessionId, startTime);
+    }
+    const { type: targetType, value: targetValue } = validation;
+    return runTool({
+        toolName: 'mm_wait_for',
+        input,
+        options,
+        /**
+         * Executes the wait action for the target element.
+         *
+         * @param context The tool execution context containing page and reference map
+         * @returns Promise resolving to wait result with success status and target info
+         */
+        execute: async (context) => {
+            await waitForTarget(context.page, targetType, targetValue, context.refMap, timeoutMs);
+            return {
+                found: true,
+                target: `${targetType}:${targetValue}`,
+            };
+        },
+        /**
+         * Returns the target element information for recording.
+         *
+         * @returns Object containing the target type and value
+         */
+        getTarget: () => ({ [targetType]: targetValue }),
+        classifyError: classifyWaitError,
+        /**
+         * Sanitizes input for knowledge store recording.
+         *
+         * @returns Sanitized input object with timeout information
+         */
+        sanitizeInputForRecording: () => ({ timeoutMs }),
+    });
+}
+//# sourceMappingURL=interaction.mjs.map

package/dist/mcp-server/tools/interaction.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction.mjs","sourceRoot":"","sources":["../../../src/mcp-server/tools/interaction.ts"],"names":[],"mappings":"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","sourcesContent":["import { DEFAULT_INTERACTION_TIMEOUT_MS } from '../constants.js';\nimport { waitForTarget } from '../discovery.js';\nimport { getSessionManager } from '../session-manager.js';\nimport {\n  classifyClickError,\n  classifyTypeError,\n  classifyWaitError,\n  isPageClosedError,\n} from './error-classification.js';\nimport { runTool } from './run-tool.js';\nimport type {\n  ClickInput,\n  ClickResult,\n  TypeInput,\n  TypeResult,\n  WaitForInput,\n  WaitForResult,\n  McpResponse,\n  HandlerOptions,\n} from '../types';\nimport { ErrorCodes } from '../types';\nimport {\n  createErrorResponse,\n  validateTargetSelection,\n  isValidTargetSelection,\n  isInvalidTargetSelection,\n} from '../utils';\n\n/**\n * Handles clicking on an element specified by testId, selector, or accessibility reference.\n *\n * @param input The click input containing target selection and timeout options\n * @param options Optional handler configuration\n * @returns Promise resolving to click result with target information\n */\nexport async function handleClick(\n  input: ClickInput,\n  options?: HandlerOptions,\n): Promise<McpResponse<ClickResult>> {\n  const startTime = Date.now();\n  const sessionManager = getSessionManager();\n  const sessionId = sessionManager.getSessionId();\n  const timeoutMs = input.timeoutMs ?? DEFAULT_INTERACTION_TIMEOUT_MS;\n\n  const validation = validateTargetSelection(input);\n  if (isInvalidTargetSelection(validation)) {\n    return createErrorResponse(\n      ErrorCodes.MM_INVALID_INPUT,\n      validation.error,\n      { input },\n      sessionId,\n      startTime,\n    );\n  }\n\n  if (!isValidTargetSelection(validation)) {\n    return createErrorResponse(\n      ErrorCodes.MM_INVALID_INPUT,\n      'Invalid target selection',\n      { input },\n      sessionId,\n      startTime,\n    );\n  }\n\n  const { type: targetType, value: targetValue } = validation;\n\n  return runTool<ClickInput, ClickResult>({\n    toolName: 'mm_click',\n    input,\n    options,\n\n    /**\n     * Executes the click action on the target element.\n     *\n     * @param context The tool execution context containing page and reference map\n     * @returns Promise resolving to click result with success status and target info\n     */\n    execute: async (context) => {\n      const locator = await waitForTarget(\n        context.page,\n        targetType,\n        targetValue,\n        context.refMap,\n        timeoutMs,\n      );\n\n      try {\n        await locator.click();\n        return {\n          clicked: true,\n          target: `${targetType}:${targetValue}`,\n        };\n      } catch (clickError) {\n        if (isPageClosedError(clickError)) {\n          return {\n            clicked: true,\n            target: `${targetType}:${targetValue}`,\n            pageClosedAfterClick: true,\n          };\n        }\n        throw clickError;\n      }\n    },\n\n    /**\n     * Returns the target element information for recording.\n     *\n     * @returns Object containing the target type and value\n     */\n    getTarget: () => ({ [targetType]: targetValue }),\n\n    classifyError: classifyClickError,\n\n    /**\n     * Sanitizes input for knowledge store recording.\n     *\n     * @returns Sanitized input object with timeout information\n     */\n    sanitizeInputForRecording: () => ({ timeoutMs }),\n  });\n}\n\n/**\n * Handles typing text into an element specified by testId, selector, or accessibility reference.\n *\n * @param input The type input containing target selection, text, and timeout options\n * @param options Optional handler configuration\n * @returns Promise resolving to type result with target and text length information\n */\nexport async function handleType(\n  input: TypeInput,\n  options?: HandlerOptions,\n): Promise<McpResponse<TypeResult>> {\n  const startTime = Date.now();\n  const sessionManager = getSessionManager();\n  const sessionId = sessionManager.getSessionId();\n  const timeoutMs = input.timeoutMs ?? DEFAULT_INTERACTION_TIMEOUT_MS;\n\n  const validation = validateTargetSelection(input);\n  if (isInvalidTargetSelection(validation)) {\n    return createErrorResponse(\n      ErrorCodes.MM_INVALID_INPUT,\n      validation.error,\n      { input },\n      sessionId,\n      startTime,\n    );\n  }\n\n  if (!isValidTargetSelection(validation)) {\n    return createErrorResponse(\n      ErrorCodes.MM_INVALID_INPUT,\n      'Invalid target selection',\n      { input },\n      sessionId,\n      startTime,\n    );\n  }\n\n  const { type: targetType, value: targetValue } = validation;\n\n  return runTool<TypeInput, TypeResult>({\n    toolName: 'mm_type',\n    input,\n    options,\n\n    /**\n     * Executes the type action on the target element.\n     *\n     * @param context The tool execution context containing page and reference map\n     * @returns Promise resolving to type result with success status and text length\n     */\n    execute: async (context) => {\n      const locator = await waitForTarget(\n        context.page,\n        targetType,\n        targetValue,\n        context.refMap,\n        timeoutMs,\n      );\n      await locator.fill(input.text);\n\n      return {\n        typed: true,\n        target: `${targetType}:${targetValue}`,\n        textLength: input.text.length,\n      };\n    },\n\n    /**\n     * Returns the target element information for recording.\n     *\n     * @returns Object containing the target type and value\n     */\n    getTarget: () => ({ [targetType]: targetValue }),\n\n    classifyError: classifyTypeError,\n\n    /**\n     * Sanitizes input for knowledge store recording.\n     *\n     * @returns Sanitized input object with timeout and text information\n     */\n    sanitizeInputForRecording: () => ({\n      timeoutMs,\n      text: input.text,\n      testId: input.testId,\n      selector: input.selector,\n      a11yRef: input.a11yRef,\n    }),\n  });\n}\n\n/**\n * Handles waiting for an element to become visible.\n *\n * @param input The wait input containing target selection and timeout options\n * @param options Optional handler configuration\n * @returns Promise resolving to wait result with target information\n */\nexport async function handleWaitFor(\n  input: WaitForInput,\n  options?: HandlerOptions,\n): Promise<McpResponse<WaitForResult>> {\n  const startTime = Date.now();\n  const sessionManager = getSessionManager();\n  const sessionId = sessionManager.getSessionId();\n  const timeoutMs = input.timeoutMs ?? DEFAULT_INTERACTION_TIMEOUT_MS;\n\n  const validation = validateTargetSelection(input);\n  if (isInvalidTargetSelection(validation)) {\n    return createErrorResponse(\n      ErrorCodes.MM_INVALID_INPUT,\n      validation.error,\n      { input },\n      sessionId,\n      startTime,\n    );\n  }\n\n  if (!isValidTargetSelection(validation)) {\n    return createErrorResponse(\n      ErrorCodes.MM_INVALID_INPUT,\n      'Invalid target selection',\n      { input },\n      sessionId,\n      startTime,\n    );\n  }\n\n  const { type: targetType, value: targetValue } = validation;\n\n  return runTool<WaitForInput, WaitForResult>({\n    toolName: 'mm_wait_for',\n    input,\n    options,\n\n    /**\n     * Executes the wait action for the target element.\n     *\n     * @param context The tool execution context containing page and reference map\n     * @returns Promise resolving to wait result with success status and target info\n     */\n    execute: async (context) => {\n      await waitForTarget(\n        context.page,\n        targetType,\n        targetValue,\n        context.refMap,\n        timeoutMs,\n      );\n\n      return {\n        found: true,\n        target: `${targetType}:${targetValue}`,\n      };\n    },\n\n    /**\n     * Returns the target element information for recording.\n     *\n     * @returns Object containing the target type and value\n     */\n    getTarget: () => ({ [targetType]: targetValue }),\n\n    classifyError: classifyWaitError,\n\n    /**\n     * Sanitizes input for knowledge store recording.\n     *\n     * @returns Sanitized input object with timeout information\n     */\n    sanitizeInputForRecording: () => ({ timeoutMs }),\n  });\n}\n"]}

package/dist/mcp-server/tools/knowledge.cjs

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleKnowledgeLast = handleKnowledgeLast;
+exports.handleKnowledgeSearch = handleKnowledgeSearch;
+exports.handleKnowledgeSummarize = handleKnowledgeSummarize;
+exports.handleKnowledgeSessions = handleKnowledgeSessions;
+const knowledge_store_js_1 = require("../knowledge-store.cjs");
+const session_manager_js_1 = require("../session-manager.cjs");
+const types_1 = require("../types/index.cjs");
+const utils_1 = require("../utils/index.cjs");
+/**
+ * Handles retrieving the last N steps from knowledge store.
+ *
+ * @param input - Input with number of steps and scope.
+ * @param _options - Handler options (unused).
+ * @returns Response with step records.
+ */
+async function handleKnowledgeLast(input, _options) {
+    const startTime = Date.now();
+    const sessionManager = (0, session_manager_js_1.getSessionManager)();
+    const sessionId = sessionManager.getSessionId();
+    const nSteps = input.n ?? 20;
+    const scope = input.scope ?? 'current';
+    try {
+        const steps = await knowledge_store_js_1.knowledgeStore.getLastSteps(nSteps, scope, sessionId, input.filters);
+        return (0, utils_1.createSuccessResponse)({ steps }, sessionId, startTime);
+    }
+    catch (error) {
+        const message = (0, utils_1.extractErrorMessage)(error);
+        return (0, utils_1.createErrorResponse)(types_1.ErrorCodes.MM_KNOWLEDGE_ERROR, `Failed to retrieve steps: ${message}`, { nSteps, scope }, sessionId, startTime);
+    }
+}
+/**
+ * Handles searching step records in knowledge store.
+ *
+ * @param input - Input with search query and filters.
+ * @param _options - Handler options (unused).
+ * @returns Response with matching steps.
+ */
+async function handleKnowledgeSearch(input, _options) {
+    const startTime = Date.now();
+    const sessionManager = (0, session_manager_js_1.getSessionManager)();
+    const sessionId = sessionManager.getSessionId();
+    const limit = input.limit ?? 20;
+    const scope = input.scope ?? 'all';
+    try {
+        const matches = await knowledge_store_js_1.knowledgeStore.searchSteps(input.query, limit, scope, sessionId, input.filters);
+        return (0, utils_1.createSuccessResponse)({
+            matches,
+            query: input.query,
+        }, sessionId, startTime);
+    }
+    catch (error) {
+        const message = (0, utils_1.extractErrorMessage)(error);
+        return (0, utils_1.createErrorResponse)(types_1.ErrorCodes.MM_KNOWLEDGE_ERROR, `Search failed: ${message}`, { query: input.query, limit, scope }, sessionId, startTime);
+    }
+}
+/**
+ * Handles summarizing a session's steps as a recipe.
+ *
+ * @param input - Input with session scope or ID.
+ * @param _options - Handler options (unused).
+ * @returns Response with session summary.
+ */
+async function handleKnowledgeSummarize(input, _options) {
+    const startTime = Date.now();
+    const sessionManager = (0, session_manager_js_1.getSessionManager)();
+    const currentSessionId = sessionManager.getSessionId();
+    let targetSessionId;
+    if (input.sessionId) {
+        targetSessionId = input.sessionId;
+    }
+    else if (input.scope) {
+        if (input.scope === 'all') {
+            return (0, utils_1.createErrorResponse)(types_1.ErrorCodes.MM_INVALID_INPUT, 'Cannot summarize all sessions. Use scope="current" or provide a specific sessionId.', { input }, currentSessionId, startTime);
+        }
+        else if (input.scope === 'current') {
+            targetSessionId = currentSessionId;
+        }
+        else if (typeof input.scope === 'object' && 'sessionId' in input.scope) {
+            targetSessionId = input.scope.sessionId;
+        }
+    }
+    else {
+        targetSessionId = currentSessionId;
+    }
+    if (!targetSessionId) {
+        return (0, utils_1.createErrorResponse)(types_1.ErrorCodes.MM_INVALID_INPUT, 'No sessionId provided and no active session', { input }, undefined, startTime);
+    }
+    try {
+        const summary = await knowledge_store_js_1.knowledgeStore.summarizeSession(targetSessionId);
+        return (0, utils_1.createSuccessResponse)(summary, targetSessionId, startTime);
+    }
+    catch (error) {
+        const message = (0, utils_1.extractErrorMessage)(error);
+        return (0, utils_1.createErrorResponse)(types_1.ErrorCodes.MM_KNOWLEDGE_ERROR, `Summarize failed: ${message}`, { sessionId: targetSessionId }, targetSessionId, startTime);
+    }
+}
+/**
+ * Handles listing recent sessions with metadata.
+ *
+ * @param input - Input with limit and filters.
+ * @param _options - Handler options (unused).
+ * @returns Response with session list.
+ */
+async function handleKnowledgeSessions(input, _options) {
+    const startTime = Date.now();
+    const sessionManager = (0, session_manager_js_1.getSessionManager)();
+    const sessionId = sessionManager.getSessionId();
+    const limit = input.limit ?? 10;
+    try {
+        const sessions = await knowledge_store_js_1.knowledgeStore.listSessions(limit, input.filters);
+        return (0, utils_1.createSuccessResponse)({ sessions }, sessionId, startTime);
+    }
+    catch (error) {
+        const message = (0, utils_1.extractErrorMessage)(error);
+        return (0, utils_1.createErrorResponse)(types_1.ErrorCodes.MM_KNOWLEDGE_ERROR, `Failed to list sessions: ${message}`, { limit, filters: input.filters }, sessionId, startTime);
+    }
+}
+//# sourceMappingURL=knowledge.cjs.map

package/dist/mcp-server/tools/knowledge.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.cjs","sourceRoot":"","sources":["../../../src/mcp-server/tools/knowledge.ts"],"names":[],"mappings":"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","sourcesContent":["import { knowledgeStore } from '../knowledge-store.js';\nimport { getSessionManager } from '../session-manager.js';\nimport type {\n  KnowledgeLastInput,\n  KnowledgeLastResult,\n  KnowledgeSearchInput,\n  KnowledgeSearchResult,\n  KnowledgeSummarizeInput,\n  KnowledgeSummarizeResult,\n  KnowledgeSessionsInput,\n  KnowledgeSessionsResult,\n  KnowledgeScope,\n  McpResponse,\n  HandlerOptions,\n} from '../types';\nimport { ErrorCodes } from '../types';\nimport {\n  createSuccessResponse,\n  createErrorResponse,\n  extractErrorMessage,\n} from '../utils';\n\n/**\n * Handles retrieving the last N steps from knowledge store.\n *\n * @param input - Input with number of steps and scope.\n * @param _options - Handler options (unused).\n * @returns Response with step records.\n */\nexport async function handleKnowledgeLast(\n  input: KnowledgeLastInput,\n  _options?: HandlerOptions,\n): Promise<McpResponse<KnowledgeLastResult>> {\n  const startTime = Date.now();\n  const sessionManager = getSessionManager();\n  const sessionId = sessionManager.getSessionId();\n  const nSteps = input.n ?? 20;\n  const scope: KnowledgeScope = input.scope ?? 'current';\n\n  try {\n    const steps = await knowledgeStore.getLastSteps(\n      nSteps,\n      scope,\n      sessionId,\n      input.filters,\n    );\n\n    return createSuccessResponse<KnowledgeLastResult>(\n      { steps },\n      sessionId,\n      startTime,\n    );\n  } catch (error) {\n    const message = extractErrorMessage(error);\n    return createErrorResponse(\n      ErrorCodes.MM_KNOWLEDGE_ERROR,\n      `Failed to retrieve steps: ${message}`,\n      { nSteps, scope },\n      sessionId,\n      startTime,\n    );\n  }\n}\n\n/**\n * Handles searching step records in knowledge store.\n *\n * @param input - Input with search query and filters.\n * @param _options - Handler options (unused).\n * @returns Response with matching steps.\n */\nexport async function handleKnowledgeSearch(\n  input: KnowledgeSearchInput,\n  _options?: HandlerOptions,\n): Promise<McpResponse<KnowledgeSearchResult>> {\n  const startTime = Date.now();\n  const sessionManager = getSessionManager();\n  const sessionId = sessionManager.getSessionId();\n  const limit = input.limit ?? 20;\n  const scope: KnowledgeScope = input.scope ?? 'all';\n\n  try {\n    const matches = await knowledgeStore.searchSteps(\n      input.query,\n      limit,\n      scope,\n      sessionId,\n      input.filters,\n    );\n\n    return createSuccessResponse<KnowledgeSearchResult>(\n      {\n        matches,\n        query: input.query,\n      },\n      sessionId,\n      startTime,\n    );\n  } catch (error) {\n    const message = extractErrorMessage(error);\n    return createErrorResponse(\n      ErrorCodes.MM_KNOWLEDGE_ERROR,\n      `Search failed: ${message}`,\n      { query: input.query, limit, scope },\n      sessionId,\n      startTime,\n    );\n  }\n}\n\n/**\n * Handles summarizing a session's steps as a recipe.\n *\n * @param input - Input with session scope or ID.\n * @param _options - Handler options (unused).\n * @returns Response with session summary.\n */\nexport async function handleKnowledgeSummarize(\n  input: KnowledgeSummarizeInput,\n  _options?: HandlerOptions,\n): Promise<McpResponse<KnowledgeSummarizeResult>> {\n  const startTime = Date.now();\n  const sessionManager = getSessionManager();\n  const currentSessionId = sessionManager.getSessionId();\n\n  let targetSessionId: string | undefined;\n\n  if (input.sessionId) {\n    targetSessionId = input.sessionId;\n  } else if (input.scope) {\n    if (input.scope === 'all') {\n      return createErrorResponse(\n        ErrorCodes.MM_INVALID_INPUT,\n        'Cannot summarize all sessions. Use scope=\"current\" or provide a specific sessionId.',\n        { input },\n        currentSessionId,\n        startTime,\n      );\n    } else if (input.scope === 'current') {\n      targetSessionId = currentSessionId;\n    } else if (typeof input.scope === 'object' && 'sessionId' in input.scope) {\n      targetSessionId = input.scope.sessionId;\n    }\n  } else {\n    targetSessionId = currentSessionId;\n  }\n\n  if (!targetSessionId) {\n    return createErrorResponse(\n      ErrorCodes.MM_INVALID_INPUT,\n      'No sessionId provided and no active session',\n      { input },\n      undefined,\n      startTime,\n    );\n  }\n\n  try {\n    const summary = await knowledgeStore.summarizeSession(targetSessionId);\n\n    return createSuccessResponse<KnowledgeSummarizeResult>(\n      summary,\n      targetSessionId,\n      startTime,\n    );\n  } catch (error) {\n    const message = extractErrorMessage(error);\n    return createErrorResponse(\n      ErrorCodes.MM_KNOWLEDGE_ERROR,\n      `Summarize failed: ${message}`,\n      { sessionId: targetSessionId },\n      targetSessionId,\n      startTime,\n    );\n  }\n}\n\n/**\n * Handles listing recent sessions with metadata.\n *\n * @param input - Input with limit and filters.\n * @param _options - Handler options (unused).\n * @returns Response with session list.\n */\nexport async function handleKnowledgeSessions(\n  input: KnowledgeSessionsInput,\n  _options?: HandlerOptions,\n): Promise<McpResponse<KnowledgeSessionsResult>> {\n  const startTime = Date.now();\n  const sessionManager = getSessionManager();\n  const sessionId = sessionManager.getSessionId();\n  const limit = input.limit ?? 10;\n\n  try {\n    const sessions = await knowledgeStore.listSessions(limit, input.filters);\n\n    return createSuccessResponse<KnowledgeSessionsResult>(\n      { sessions },\n      sessionId,\n      startTime,\n    );\n  } catch (error) {\n    const message = extractErrorMessage(error);\n    return createErrorResponse(\n      ErrorCodes.MM_KNOWLEDGE_ERROR,\n      `Failed to list sessions: ${message}`,\n      { limit, filters: input.filters },\n      sessionId,\n      startTime,\n    );\n  }\n}\n"]}

package/dist/mcp-server/tools/knowledge.d.cts

@@ -0,0 +1,34 @@
+import type { KnowledgeLastInput, KnowledgeLastResult, KnowledgeSearchInput, KnowledgeSearchResult, KnowledgeSummarizeInput, KnowledgeSummarizeResult, KnowledgeSessionsInput, KnowledgeSessionsResult, McpResponse, HandlerOptions } from "../types/index.cjs";
+/**
+ * Handles retrieving the last N steps from knowledge store.
+ *
+ * @param input - Input with number of steps and scope.
+ * @param _options - Handler options (unused).
+ * @returns Response with step records.
+ */
+export declare function handleKnowledgeLast(input: KnowledgeLastInput, _options?: HandlerOptions): Promise<McpResponse<KnowledgeLastResult>>;
+/**
+ * Handles searching step records in knowledge store.
+ *
+ * @param input - Input with search query and filters.
+ * @param _options - Handler options (unused).
+ * @returns Response with matching steps.
+ */
+export declare function handleKnowledgeSearch(input: KnowledgeSearchInput, _options?: HandlerOptions): Promise<McpResponse<KnowledgeSearchResult>>;
+/**
+ * Handles summarizing a session's steps as a recipe.
+ *
+ * @param input - Input with session scope or ID.
+ * @param _options - Handler options (unused).
+ * @returns Response with session summary.
+ */
+export declare function handleKnowledgeSummarize(input: KnowledgeSummarizeInput, _options?: HandlerOptions): Promise<McpResponse<KnowledgeSummarizeResult>>;
+/**
+ * Handles listing recent sessions with metadata.
+ *
+ * @param input - Input with limit and filters.
+ * @param _options - Handler options (unused).
+ * @returns Response with session list.
+ */
+export declare function handleKnowledgeSessions(input: KnowledgeSessionsInput, _options?: HandlerOptions): Promise<McpResponse<KnowledgeSessionsResult>>;
+//# sourceMappingURL=knowledge.d.cts.map

package/dist/mcp-server/tools/knowledge.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.d.cts","sourceRoot":"","sources":["../../../src/mcp-server/tools/knowledge.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EAEvB,WAAW,EACX,cAAc,EACf,2BAAiB;AAQlB;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,kBAAkB,EACzB,QAAQ,CAAC,EAAE,cAAc,GACxB,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC,CA8B3C;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,oBAAoB,EAC3B,QAAQ,CAAC,EAAE,cAAc,GACxB,OAAO,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC,CAkC7C;AAED;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,uBAAuB,EAC9B,QAAQ,CAAC,EAAE,cAAc,GACxB,OAAO,CAAC,WAAW,CAAC,wBAAwB,CAAC,CAAC,CAuDhD;AAED;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,sBAAsB,EAC7B,QAAQ,CAAC,EAAE,cAAc,GACxB,OAAO,CAAC,WAAW,CAAC,uBAAuB,CAAC,CAAC,CAwB/C"}

package/dist/mcp-server/tools/knowledge.d.mts

@@ -0,0 +1,34 @@
+import type { KnowledgeLastInput, KnowledgeLastResult, KnowledgeSearchInput, KnowledgeSearchResult, KnowledgeSummarizeInput, KnowledgeSummarizeResult, KnowledgeSessionsInput, KnowledgeSessionsResult, McpResponse, HandlerOptions } from "../types/index.mjs";
+/**
+ * Handles retrieving the last N steps from knowledge store.
+ *
+ * @param input - Input with number of steps and scope.
+ * @param _options - Handler options (unused).
+ * @returns Response with step records.
+ */
+export declare function handleKnowledgeLast(input: KnowledgeLastInput, _options?: HandlerOptions): Promise<McpResponse<KnowledgeLastResult>>;
+/**
+ * Handles searching step records in knowledge store.
+ *
+ * @param input - Input with search query and filters.
+ * @param _options - Handler options (unused).
+ * @returns Response with matching steps.
+ */
+export declare function handleKnowledgeSearch(input: KnowledgeSearchInput, _options?: HandlerOptions): Promise<McpResponse<KnowledgeSearchResult>>;
+/**
+ * Handles summarizing a session's steps as a recipe.
+ *
+ * @param input - Input with session scope or ID.
+ * @param _options - Handler options (unused).
+ * @returns Response with session summary.
+ */
+export declare function handleKnowledgeSummarize(input: KnowledgeSummarizeInput, _options?: HandlerOptions): Promise<McpResponse<KnowledgeSummarizeResult>>;
+/**
+ * Handles listing recent sessions with metadata.
+ *
+ * @param input - Input with limit and filters.
+ * @param _options - Handler options (unused).
+ * @returns Response with session list.
+ */
+export declare function handleKnowledgeSessions(input: KnowledgeSessionsInput, _options?: HandlerOptions): Promise<McpResponse<KnowledgeSessionsResult>>;
+//# sourceMappingURL=knowledge.d.mts.map

package/dist/mcp-server/tools/knowledge.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.d.mts","sourceRoot":"","sources":["../../../src/mcp-server/tools/knowledge.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EAEvB,WAAW,EACX,cAAc,EACf,2BAAiB;AAQlB;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,kBAAkB,EACzB,QAAQ,CAAC,EAAE,cAAc,GACxB,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC,CA8B3C;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,oBAAoB,EAC3B,QAAQ,CAAC,EAAE,cAAc,GACxB,OAAO,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC,CAkC7C;AAED;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,uBAAuB,EAC9B,QAAQ,CAAC,EAAE,cAAc,GACxB,OAAO,CAAC,WAAW,CAAC,wBAAwB,CAAC,CAAC,CAuDhD;AAED;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,sBAAsB,EAC7B,QAAQ,CAAC,EAAE,cAAc,GACxB,OAAO,CAAC,WAAW,CAAC,uBAAuB,CAAC,CAAC,CAwB/C"}

package/dist/mcp-server/tools/knowledge.mjs

@@ -0,0 +1,114 @@
+import { knowledgeStore } from "../knowledge-store.mjs";
+import { getSessionManager } from "../session-manager.mjs";
+import { ErrorCodes } from "../types/index.mjs";
+import { createSuccessResponse, createErrorResponse, extractErrorMessage } from "../utils/index.mjs";
+/**
+ * Handles retrieving the last N steps from knowledge store.
+ *
+ * @param input - Input with number of steps and scope.
+ * @param _options - Handler options (unused).
+ * @returns Response with step records.
+ */
+export async function handleKnowledgeLast(input, _options) {
+    const startTime = Date.now();
+    const sessionManager = getSessionManager();
+    const sessionId = sessionManager.getSessionId();
+    const nSteps = input.n ?? 20;
+    const scope = input.scope ?? 'current';
+    try {
+        const steps = await knowledgeStore.getLastSteps(nSteps, scope, sessionId, input.filters);
+        return createSuccessResponse({ steps }, sessionId, startTime);
+    }
+    catch (error) {
+        const message = extractErrorMessage(error);
+        return createErrorResponse(ErrorCodes.MM_KNOWLEDGE_ERROR, `Failed to retrieve steps: ${message}`, { nSteps, scope }, sessionId, startTime);
+    }
+}
+/**
+ * Handles searching step records in knowledge store.
+ *
+ * @param input - Input with search query and filters.
+ * @param _options - Handler options (unused).
+ * @returns Response with matching steps.
+ */
+export async function handleKnowledgeSearch(input, _options) {
+    const startTime = Date.now();
+    const sessionManager = getSessionManager();
+    const sessionId = sessionManager.getSessionId();
+    const limit = input.limit ?? 20;
+    const scope = input.scope ?? 'all';
+    try {
+        const matches = await knowledgeStore.searchSteps(input.query, limit, scope, sessionId, input.filters);
+        return createSuccessResponse({
+            matches,
+            query: input.query,
+        }, sessionId, startTime);
+    }
+    catch (error) {
+        const message = extractErrorMessage(error);
+        return createErrorResponse(ErrorCodes.MM_KNOWLEDGE_ERROR, `Search failed: ${message}`, { query: input.query, limit, scope }, sessionId, startTime);
+    }
+}
+/**
+ * Handles summarizing a session's steps as a recipe.
+ *
+ * @param input - Input with session scope or ID.
+ * @param _options - Handler options (unused).
+ * @returns Response with session summary.
+ */
+export async function handleKnowledgeSummarize(input, _options) {
+    const startTime = Date.now();
+    const sessionManager = getSessionManager();
+    const currentSessionId = sessionManager.getSessionId();
+    let targetSessionId;
+    if (input.sessionId) {
+        targetSessionId = input.sessionId;
+    }
+    else if (input.scope) {
+        if (input.scope === 'all') {
+            return createErrorResponse(ErrorCodes.MM_INVALID_INPUT, 'Cannot summarize all sessions. Use scope="current" or provide a specific sessionId.', { input }, currentSessionId, startTime);
+        }
+        else if (input.scope === 'current') {
+            targetSessionId = currentSessionId;
+        }
+        else if (typeof input.scope === 'object' && 'sessionId' in input.scope) {
+            targetSessionId = input.scope.sessionId;
+        }
+    }
+    else {
+        targetSessionId = currentSessionId;
+    }
+    if (!targetSessionId) {
+        return createErrorResponse(ErrorCodes.MM_INVALID_INPUT, 'No sessionId provided and no active session', { input }, undefined, startTime);
+    }
+    try {
+        const summary = await knowledgeStore.summarizeSession(targetSessionId);
+        return createSuccessResponse(summary, targetSessionId, startTime);
+    }
+    catch (error) {
+        const message = extractErrorMessage(error);
+        return createErrorResponse(ErrorCodes.MM_KNOWLEDGE_ERROR, `Summarize failed: ${message}`, { sessionId: targetSessionId }, targetSessionId, startTime);
+    }
+}
+/**
+ * Handles listing recent sessions with metadata.
+ *
+ * @param input - Input with limit and filters.
+ * @param _options - Handler options (unused).
+ * @returns Response with session list.
+ */
+export async function handleKnowledgeSessions(input, _options) {
+    const startTime = Date.now();
+    const sessionManager = getSessionManager();
+    const sessionId = sessionManager.getSessionId();
+    const limit = input.limit ?? 10;
+    try {
+        const sessions = await knowledgeStore.listSessions(limit, input.filters);
+        return createSuccessResponse({ sessions }, sessionId, startTime);
+    }
+    catch (error) {
+        const message = extractErrorMessage(error);
+        return createErrorResponse(ErrorCodes.MM_KNOWLEDGE_ERROR, `Failed to list sessions: ${message}`, { limit, filters: input.filters }, sessionId, startTime);
+    }
+}
+//# sourceMappingURL=knowledge.mjs.map

package/dist/mcp-server/tools/knowledge.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.mjs","sourceRoot":"","sources":["../../../src/mcp-server/tools/knowledge.ts"],"names":[],"mappings":"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","sourcesContent":["import { knowledgeStore } from '../knowledge-store.js';\nimport { getSessionManager } from '../session-manager.js';\nimport type {\n  KnowledgeLastInput,\n  KnowledgeLastResult,\n  KnowledgeSearchInput,\n  KnowledgeSearchResult,\n  KnowledgeSummarizeInput,\n  KnowledgeSummarizeResult,\n  KnowledgeSessionsInput,\n  KnowledgeSessionsResult,\n  KnowledgeScope,\n  McpResponse,\n  HandlerOptions,\n} from '../types';\nimport { ErrorCodes } from '../types';\nimport {\n  createSuccessResponse,\n  createErrorResponse,\n  extractErrorMessage,\n} from '../utils';\n\n/**\n * Handles retrieving the last N steps from knowledge store.\n *\n * @param input - Input with number of steps and scope.\n * @param _options - Handler options (unused).\n * @returns Response with step records.\n */\nexport async function handleKnowledgeLast(\n  input: KnowledgeLastInput,\n  _options?: HandlerOptions,\n): Promise<McpResponse<KnowledgeLastResult>> {\n  const startTime = Date.now();\n  const sessionManager = getSessionManager();\n  const sessionId = sessionManager.getSessionId();\n  const nSteps = input.n ?? 20;\n  const scope: KnowledgeScope = input.scope ?? 'current';\n\n  try {\n    const steps = await knowledgeStore.getLastSteps(\n      nSteps,\n      scope,\n      sessionId,\n      input.filters,\n    );\n\n    return createSuccessResponse<KnowledgeLastResult>(\n      { steps },\n      sessionId,\n      startTime,\n    );\n  } catch (error) {\n    const message = extractErrorMessage(error);\n    return createErrorResponse(\n      ErrorCodes.MM_KNOWLEDGE_ERROR,\n      `Failed to retrieve steps: ${message}`,\n      { nSteps, scope },\n      sessionId,\n      startTime,\n    );\n  }\n}\n\n/**\n * Handles searching step records in knowledge store.\n *\n * @param input - Input with search query and filters.\n * @param _options - Handler options (unused).\n * @returns Response with matching steps.\n */\nexport async function handleKnowledgeSearch(\n  input: KnowledgeSearchInput,\n  _options?: HandlerOptions,\n): Promise<McpResponse<KnowledgeSearchResult>> {\n  const startTime = Date.now();\n  const sessionManager = getSessionManager();\n  const sessionId = sessionManager.getSessionId();\n  const limit = input.limit ?? 20;\n  const scope: KnowledgeScope = input.scope ?? 'all';\n\n  try {\n    const matches = await knowledgeStore.searchSteps(\n      input.query,\n      limit,\n      scope,\n      sessionId,\n      input.filters,\n    );\n\n    return createSuccessResponse<KnowledgeSearchResult>(\n      {\n        matches,\n        query: input.query,\n      },\n      sessionId,\n      startTime,\n    );\n  } catch (error) {\n    const message = extractErrorMessage(error);\n    return createErrorResponse(\n      ErrorCodes.MM_KNOWLEDGE_ERROR,\n      `Search failed: ${message}`,\n      { query: input.query, limit, scope },\n      sessionId,\n      startTime,\n    );\n  }\n}\n\n/**\n * Handles summarizing a session's steps as a recipe.\n *\n * @param input - Input with session scope or ID.\n * @param _options - Handler options (unused).\n * @returns Response with session summary.\n */\nexport async function handleKnowledgeSummarize(\n  input: KnowledgeSummarizeInput,\n  _options?: HandlerOptions,\n): Promise<McpResponse<KnowledgeSummarizeResult>> {\n  const startTime = Date.now();\n  const sessionManager = getSessionManager();\n  const currentSessionId = sessionManager.getSessionId();\n\n  let targetSessionId: string | undefined;\n\n  if (input.sessionId) {\n    targetSessionId = input.sessionId;\n  } else if (input.scope) {\n    if (input.scope === 'all') {\n      return createErrorResponse(\n        ErrorCodes.MM_INVALID_INPUT,\n        'Cannot summarize all sessions. Use scope=\"current\" or provide a specific sessionId.',\n        { input },\n        currentSessionId,\n        startTime,\n      );\n    } else if (input.scope === 'current') {\n      targetSessionId = currentSessionId;\n    } else if (typeof input.scope === 'object' && 'sessionId' in input.scope) {\n      targetSessionId = input.scope.sessionId;\n    }\n  } else {\n    targetSessionId = currentSessionId;\n  }\n\n  if (!targetSessionId) {\n    return createErrorResponse(\n      ErrorCodes.MM_INVALID_INPUT,\n      'No sessionId provided and no active session',\n      { input },\n      undefined,\n      startTime,\n    );\n  }\n\n  try {\n    const summary = await knowledgeStore.summarizeSession(targetSessionId);\n\n    return createSuccessResponse<KnowledgeSummarizeResult>(\n      summary,\n      targetSessionId,\n      startTime,\n    );\n  } catch (error) {\n    const message = extractErrorMessage(error);\n    return createErrorResponse(\n      ErrorCodes.MM_KNOWLEDGE_ERROR,\n      `Summarize failed: ${message}`,\n      { sessionId: targetSessionId },\n      targetSessionId,\n      startTime,\n    );\n  }\n}\n\n/**\n * Handles listing recent sessions with metadata.\n *\n * @param input - Input with limit and filters.\n * @param _options - Handler options (unused).\n * @returns Response with session list.\n */\nexport async function handleKnowledgeSessions(\n  input: KnowledgeSessionsInput,\n  _options?: HandlerOptions,\n): Promise<McpResponse<KnowledgeSessionsResult>> {\n  const startTime = Date.now();\n  const sessionManager = getSessionManager();\n  const sessionId = sessionManager.getSessionId();\n  const limit = input.limit ?? 10;\n\n  try {\n    const sessions = await knowledgeStore.listSessions(limit, input.filters);\n\n    return createSuccessResponse<KnowledgeSessionsResult>(\n      { sessions },\n      sessionId,\n      startTime,\n    );\n  } catch (error) {\n    const message = extractErrorMessage(error);\n    return createErrorResponse(\n      ErrorCodes.MM_KNOWLEDGE_ERROR,\n      `Failed to list sessions: ${message}`,\n      { limit, filters: input.filters },\n      sessionId,\n      startTime,\n    );\n  }\n}\n"]}