@nexusm/mcp-server 0.1.0

package/dist/tools/memory_create.js

@@ -0,0 +1,242 @@
+/**
+ * Tool: nexus.memory_create (US-037 TASK-011, Wave 2).
+ *
+ * Persist a new memory via the Nexus REST API through `@nexusm/sdk`.
+ *
+ * Schema is locked in proposal §"R2 工具 Schema 锁定" Tool 3 (+ R2.1 grep
+ * corrections + ai R2 D-8 metadata cap + ai R2 D-10 conflict_resolution
+ * enum lock) and MUST be preserved verbatim — `tests/unit/schema_sync.test.ts`
+ * is the parity gate.
+ *
+ * Validation responsibilities (the MCP dispatcher does NOT validate inputs
+ * against the declared inputSchema):
+ *
+ *   1. `valid_until_source` — 5-value enum locked in R2.1
+ *      (permanent / extracted / sdk_provided / extraction_failed /
+ *      superseded_by_conflict). Any other value → `InvalidParams`.
+ *
+ *   2. `metadata` cap (proposal §ai R2 D-8):
+ *      - ≤ 10 keys
+ *      - each string value ≤ 200 chars
+ *      Over-cap → `InvalidParams` BEFORE the SDK call.
+ *
+ *   3. Response `conflict_resolution.status` — 9-value enum locked in
+ *      §ai R2 D-10 (matches migration 020 `memory_conflicts.resolution_status`
+ *      CHECK). Any other value → `InternalError` (treat as backend drift
+ *      or server bug; do NOT silently echo).
+ *
+ * Client construction matches the sibling pattern in `memory_search.ts`:
+ * lazy `NexusClient` singleton from `loadAuthConfig()`, with a
+ * `__resetClientForTesting()` seam so `vi.mock('@nexusm/sdk', ...)` can
+ * re-construct against the fresh mock between cases.
+ */
+import { NexusClient } from '@nexusm/sdk';
+import { loadAuthConfig } from '../auth.js';
+import { McpErrorCode, NexusError, isAxiosLikeError, mapHttpStatusToMcpError } from '../errors.js';
+const NAME = 'nexus.memory_create';
+/** memory_type enum locked in proposal §R2 Tool 3 (matches SDK MemoryType). */
+const MEMORY_TYPE_ENUM = ['episodic', 'semantic', 'procedural'];
+const DEFAULT_MEMORY_TYPE = 'semantic';
+/** valid_until_source enum locked in proposal §R2.1 (5 values, backend Literal). */
+const VALID_UNTIL_SOURCE_ENUM = [
+    'permanent',
+    'extracted',
+    'sdk_provided',
+    'extraction_failed',
+    'superseded_by_conflict',
+];
+/**
+ * conflict_resolution.status enum locked in proposal §ai R2 D-10, matching
+ * migration 020 `memory_conflicts.resolution_status` 9-state CHECK constraint.
+ */
+const CONFLICT_STATUS_ENUM = [
+    'resolved_keep_new',
+    'resolved_keep_old',
+    'resolved_merge',
+    'resolved_keep_both',
+    'pending_judge',
+    'failed_llm',
+    'failed_nli',
+    'skipped_disabled',
+    'no_conflict',
+];
+/** Metadata cap per proposal §ai R2 D-8. */
+const METADATA_MAX_KEYS = 10;
+const METADATA_MAX_VALUE_LEN = 200;
+/** Lazily-instantiated SDK client. Reset by `__resetClientForTesting`. */
+let clientSingleton = null;
+function getClient() {
+    if (clientSingleton === null) {
+        const auth = loadAuthConfig();
+        clientSingleton = new NexusClient({
+            apiKey: auth.apiToken,
+            baseUrl: auth.apiUrl,
+            tenantId: auth.tenantId,
+        });
+    }
+    return clientSingleton;
+}
+/** Test-only seam — mirrors `memory_search.ts`. @internal */
+export function __resetClientForTesting() {
+    clientSingleton = null;
+}
+/**
+ * Guard a backend conflict_resolution payload against the locked 9-state
+ * enum. Unknown status → drift → `InternalError` (proposal §ai R2 D-10).
+ */
+function validateConflictResolution(cr) {
+    if (cr === null || cr === undefined)
+        return null;
+    if (typeof cr !== 'object') {
+        throw new NexusError('SDK returned non-object conflict_resolution', McpErrorCode.InternalError);
+    }
+    const obj = cr;
+    const status = obj.status;
+    if (typeof status !== 'string' || !CONFLICT_STATUS_ENUM.includes(status)) {
+        throw new NexusError(`SDK returned unknown conflict_resolution.status="${String(status)}" (backend drift; ` +
+            `expected one of ${CONFLICT_STATUS_ENUM.join('|')})`, McpErrorCode.InternalError);
+    }
+    return obj;
+}
+export const memoryCreateTool = {
+    name: NAME,
+    description: "Persist a new memory. Use when user explicitly asks to 'remember X' or when storing structured facts (preferences, decisions, code snippets with language tag). Set memory_type to 'episodic' for events, 'semantic' for facts, 'procedural' for how-tos.",
+    inputSchema: {
+        type: 'object',
+        properties: {
+            user_id: { type: 'string' },
+            content: { type: 'string' },
+            memory_type: {
+                type: 'string',
+                enum: [...MEMORY_TYPE_ENUM],
+                default: 'semantic',
+            },
+            metadata: {
+                type: 'object',
+                additionalProperties: true,
+                description: "Free-form structured tags (e.g., {language: 'python', tags: ['snippet', 'react-hooks']}). " +
+                    'Use ≤ 10 keys, value length ≤ 200 chars (proposal §ai R2 D-8 cap; over-cap → InvalidParams).',
+            },
+            valid_until: { type: 'string', format: 'date-time', nullable: true },
+            valid_until_source: {
+                type: 'string',
+                enum: [...VALID_UNTIL_SOURCE_ENUM],
+                nullable: true,
+                description: 'v6 US-035 temporal validity (backend ValidUntilSource Literal, 5 values, locked in proposal §R2.1). ' +
+                    "MCP client typically passes 'sdk_provided' (user-declared) or omits to let backend worker auto-extract. " +
+                    'Any value outside the 5-enum is rejected at args parse stage with InvalidParams.',
+            },
+            agent_id: { type: 'string', nullable: true },
+        },
+        required: ['user_id', 'content'],
+    },
+    outputSchema: {
+        type: 'object',
+        properties: {
+            memory_id: { type: 'string', format: 'uuid' },
+            created_at: { type: 'string', format: 'date-time' },
+            conflict_resolution: {
+                type: 'object',
+                nullable: true,
+                description: 'If v6 US-036 ConflictResolver is enabled (per-tenant feature flag), resolution_status echoed here. ' +
+                    'NULL when feature flag disabled. status enum locked to 9 values (migration 020 CHECK).',
+                properties: {
+                    status: { type: 'string', enum: [...CONFLICT_STATUS_ENUM] },
+                    superseded_memory_ids: { type: 'array', items: { type: 'string' } },
+                },
+                required: ['status'],
+            },
+        },
+        required: ['memory_id', 'created_at'],
+    },
+    handler: async (args) => {
+        // ---- Required fields ----
+        if (typeof args.user_id !== 'string' || args.user_id.length === 0) {
+            throw new NexusError('user_id is required (non-empty string)', McpErrorCode.InvalidParams, 422);
+        }
+        if (typeof args.content !== 'string' || args.content.length === 0) {
+            throw new NexusError('content is required (non-empty string)', McpErrorCode.InvalidParams, 422);
+        }
+        // ---- memory_type enum + default ----
+        let memory_type;
+        if (args.memory_type === undefined || args.memory_type === null) {
+            memory_type = DEFAULT_MEMORY_TYPE;
+        }
+        else if (typeof args.memory_type === 'string' &&
+            MEMORY_TYPE_ENUM.includes(args.memory_type)) {
+            memory_type = args.memory_type;
+        }
+        else {
+            throw new NexusError(`Invalid memory_type "${String(args.memory_type)}". Allowed: ${MEMORY_TYPE_ENUM.join(', ')}.`, McpErrorCode.InvalidParams, 422);
+        }
+        // ---- metadata cap (proposal §ai R2 D-8) ----
+        let metadata;
+        if (args.metadata !== undefined && args.metadata !== null) {
+            if (typeof args.metadata !== 'object' || Array.isArray(args.metadata)) {
+                throw new NexusError('metadata must be an object', McpErrorCode.InvalidParams, 422);
+            }
+            metadata = args.metadata;
+            const keys = Object.keys(metadata);
+            if (keys.length > METADATA_MAX_KEYS) {
+                throw new NexusError(`metadata exceeds cap of ${METADATA_MAX_KEYS} keys (got ${keys.length})`, McpErrorCode.InvalidParams, 422);
+            }
+            for (const [k, v] of Object.entries(metadata)) {
+                if (typeof v === 'string' && v.length > METADATA_MAX_VALUE_LEN) {
+                    throw new NexusError(`metadata.${k} value length ${v.length} exceeds cap of ${METADATA_MAX_VALUE_LEN}`, McpErrorCode.InvalidParams, 422);
+                }
+            }
+        }
+        // ---- valid_until_source enum (R2.1 LOCKED) ----
+        let valid_until_source;
+        if (args.valid_until_source !== undefined && args.valid_until_source !== null) {
+            if (typeof args.valid_until_source !== 'string' ||
+                !VALID_UNTIL_SOURCE_ENUM.includes(args.valid_until_source)) {
+                throw new NexusError(`Invalid valid_until_source "${String(args.valid_until_source)}". ` +
+                    `Allowed: ${VALID_UNTIL_SOURCE_ENUM.join(', ')}.`, McpErrorCode.InvalidParams, 422);
+            }
+            valid_until_source = args.valid_until_source;
+        }
+        const body = {
+            user_id: args.user_id,
+            content: args.content,
+            memory_type,
+        };
+        if (metadata !== undefined)
+            body.metadata = metadata;
+        if (typeof args.valid_until === 'string')
+            body.valid_until = args.valid_until;
+        if (valid_until_source !== undefined)
+            body.valid_until_source = valid_until_source;
+        if (typeof args.agent_id === 'string')
+            body.agent_id = args.agent_id;
+        const client = getClient();
+        // Wave 2B mid_audit-to-pre_merge fix: wrap SDK call + map errors per §M-3
+        // (mirrors context.ts pattern). Without this, axios-like 401/403/429
+        // surface as JSON-RPC InternalError instead of Unauthorized/RateLimited.
+        let created;
+        try {
+            created = (await client.memories.create(body));
+        }
+        catch (err) {
+            if (isAxiosLikeError(err)) {
+                const status = err.response?.status ?? null;
+                const respBody = err.response?.data ?? null;
+                const headers = err.response?.headers;
+                throw mapHttpStatusToMcpError(status, respBody, headers);
+            }
+            throw mapHttpStatusToMcpError(null, null);
+        }
+        // ---- conflict_resolution drift guard (proposal §ai R2 D-10) ----
+        const conflict = validateConflictResolution(created.conflict_resolution);
+        const memory_id = (created.id ?? created.memory_id);
+        const created_at = created.created_at;
+        const output = { memory_id, created_at };
+        if (conflict !== null)
+            output.conflict_resolution = conflict;
+        return {
+            content: [{ type: 'text', text: JSON.stringify(output) }],
+            structuredContent: output,
+        };
+    },
+};
+//# sourceMappingURL=memory_create.js.map

package/dist/tools/memory_create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory_create.js","sourceRoot":"","sources":["../../src/tools/memory_create.ts"],"names":[],"mappings":"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"}

package/dist/tools/memory_feedback.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Tool: nexus.memory_feedback
+ *
+ * Submit per-memory feedback on a previous nexus.context_retrieve call.
+ * Schema locked in proposal §"R2 工具 Schema 锁定" Tool 4 (R2.1 grep-corrected).
+ *
+ * Wave 2 (TASK-012): full handler — validates inputs, structlogs `user_id`
+ * for audit, then forwards a body that **excludes** `user_id` to
+ * `@nexusm/sdk` `FeedbackService.submit(retrieveId, body)`.
+ *
+ * R2.1 grep corrections vs R2 draft (proposal §"R2.1 grep 修正"):
+ *   - `item_feedback[].reason` maxLength: 255 (was 500)
+ *   - `expected_missing` maxLength: 2000 (was 500)
+ *   - outputSchema is `{feedback_id, retrieve_id, status, created_at}`
+ *     with status="accepted" (R2 wrote `{feedback_id, acknowledged}`,
+ *     which does not match backend FeedbackResponse).
+ *
+ * Backend contract (R2.1 D-1, /v1/feedback/{retrieve_id} PUT):
+ *   The request body MUST NOT contain `user_id`. The backend derives
+ *   user_id from the retrieve_log keyed by the URL path `retrieve_id`.
+ *   We surface `user_id` in inputSchema only so the MCP server can
+ *   structlog it for the audit trail and metric labels. This handler
+ *   strips it before calling the SDK.
+ *
+ * Security:
+ *   - Bearer token is never logged: the audit structlog includes only
+ *     {tool, user_id, retrieve_id, rating}, never headers or env values.
+ *   - SDK errors may carry the bearer token in `cause.config.headers`.
+ *     We never log the raw error; we wrap-and-rethrow so toJSON() (which
+ *     omits `cause`) gates serialization.
+ */
+import type { ToolDefinition } from './types.js';
+/**
+ * Test helper — reset the lazy singleton between cases so each test
+ * picks up a fresh `vi.mock('@nexusm/sdk')` factory invocation.
+ */
+export declare function __resetClientForTesting(): void;
+/** Structlog sink. Always stderr (MCP stdio invariant — stdout is JSON-RPC). */
+type AuditLogger = (line: string) => void;
+/** Test helper — override the audit sink. Pair with __resetClientForTesting. */
+export declare function __setAuditLoggerForTesting(fn: AuditLogger | null): void;
+export declare const memoryFeedbackTool: ToolDefinition;
+export {};
+//# sourceMappingURL=memory_feedback.d.ts.map

package/dist/tools/memory_feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory_feedback.d.ts","sourceRoot":"","sources":["../../src/tools/memory_feedback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAOH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAoBjD;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAED,gFAAgF;AAChF,KAAK,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;AAK1C,gFAAgF;AAChF,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CAEvE;AAyHD,eAAO,MAAM,kBAAkB,EAAE,cAyGhC,CAAC"}

package/dist/tools/memory_feedback.js

@@ -0,0 +1,259 @@
+/**
+ * Tool: nexus.memory_feedback
+ *
+ * Submit per-memory feedback on a previous nexus.context_retrieve call.
+ * Schema locked in proposal §"R2 工具 Schema 锁定" Tool 4 (R2.1 grep-corrected).
+ *
+ * Wave 2 (TASK-012): full handler — validates inputs, structlogs `user_id`
+ * for audit, then forwards a body that **excludes** `user_id` to
+ * `@nexusm/sdk` `FeedbackService.submit(retrieveId, body)`.
+ *
+ * R2.1 grep corrections vs R2 draft (proposal §"R2.1 grep 修正"):
+ *   - `item_feedback[].reason` maxLength: 255 (was 500)
+ *   - `expected_missing` maxLength: 2000 (was 500)
+ *   - outputSchema is `{feedback_id, retrieve_id, status, created_at}`
+ *     with status="accepted" (R2 wrote `{feedback_id, acknowledged}`,
+ *     which does not match backend FeedbackResponse).
+ *
+ * Backend contract (R2.1 D-1, /v1/feedback/{retrieve_id} PUT):
+ *   The request body MUST NOT contain `user_id`. The backend derives
+ *   user_id from the retrieve_log keyed by the URL path `retrieve_id`.
+ *   We surface `user_id` in inputSchema only so the MCP server can
+ *   structlog it for the audit trail and metric labels. This handler
+ *   strips it before calling the SDK.
+ *
+ * Security:
+ *   - Bearer token is never logged: the audit structlog includes only
+ *     {tool, user_id, retrieve_id, rating}, never headers or env values.
+ *   - SDK errors may carry the bearer token in `cause.config.headers`.
+ *     We never log the raw error; we wrap-and-rethrow so toJSON() (which
+ *     omits `cause`) gates serialization.
+ */
+import { NexusClient } from '@nexusm/sdk';
+import { loadAuthConfig } from '../auth.js';
+import { McpErrorCode, NexusError, isAxiosLikeError, mapHttpStatusToMcpError } from '../errors.js';
+const NAME = 'nexus.memory_feedback';
+/** Lazy NexusClient singleton — built on first handler invocation so
+ *  importing the module does not require env vars (matches memory_search). */
+let _client = null;
+function getClient() {
+    if (_client === null) {
+        const cfg = loadAuthConfig();
+        _client = new NexusClient({
+            apiKey: cfg.apiToken,
+            baseUrl: cfg.apiUrl,
+            tenantId: cfg.tenantId,
+        });
+    }
+    return _client;
+}
+/**
+ * Test helper — reset the lazy singleton between cases so each test
+ * picks up a fresh `vi.mock('@nexusm/sdk')` factory invocation.
+ */
+export function __resetClientForTesting() {
+    _client = null;
+}
+let auditLogger = (line) => {
+    process.stderr.write(`${line}\n`);
+};
+/** Test helper — override the audit sink. Pair with __resetClientForTesting. */
+export function __setAuditLoggerForTesting(fn) {
+    auditLogger = fn ?? ((line) => process.stderr.write(`${line}\n`));
+}
+/**
+ * Validate raw MCP `arguments` against the R2.1 schema rules that JSON
+ * Schema cannot express purely at the SDK layer (range, length caps).
+ *
+ * Throws {@link NexusError}(InvalidParams) on any violation — caught at
+ * the MCP dispatch layer (src/index.ts) and converted to a JSON-RPC
+ * error response per proposal §M-3. Matches the memory_search pattern.
+ */
+function parseAndValidate(args) {
+    const reject = (msg) => {
+        throw new NexusError(msg, McpErrorCode.InvalidParams, null);
+    };
+    // user_id — required, non-empty string.
+    const userIdRaw = args['user_id'];
+    if (typeof userIdRaw !== 'string' || userIdRaw.trim() === '') {
+        reject("'user_id' is required and must be a non-empty string");
+    }
+    const user_id = userIdRaw.trim();
+    // retrieve_id — required, non-empty string.
+    const retrieveIdRaw = args['retrieve_id'];
+    if (typeof retrieveIdRaw !== 'string' || retrieveIdRaw.trim() === '') {
+        reject("'retrieve_id' is required and must be a non-empty string");
+    }
+    const retrieve_id = retrieveIdRaw.trim();
+    // rating — required, integer 1..5 (hard reject 0 / 6 / floats / non-numbers).
+    const ratingRaw = args['rating'];
+    if (typeof ratingRaw !== 'number' ||
+        !Number.isInteger(ratingRaw) ||
+        ratingRaw < 1 ||
+        ratingRaw > 5) {
+        reject("'rating' must be an integer between 1 and 5");
+    }
+    const rating = ratingRaw;
+    // item_feedback — optional array of {memory_id, useful, reason?}.
+    let item_feedback;
+    if (args['item_feedback'] !== undefined && args['item_feedback'] !== null) {
+        if (!Array.isArray(args['item_feedback'])) {
+            reject("'item_feedback' must be an array when provided");
+        }
+        item_feedback = args['item_feedback'].map((raw, idx) => {
+            if (typeof raw !== 'object' || raw === null) {
+                reject(`'item_feedback[${idx}]' must be an object`);
+            }
+            const item = raw;
+            const memory_id = item['memory_id'];
+            const useful = item['useful'];
+            if (typeof memory_id !== 'string' || memory_id.trim() === '') {
+                reject(`'item_feedback[${idx}].memory_id' is required (non-empty string)`);
+            }
+            if (typeof useful !== 'boolean') {
+                reject(`'item_feedback[${idx}].useful' is required (boolean)`);
+            }
+            const reasonRaw = item['reason'];
+            let reason;
+            if (reasonRaw !== undefined && reasonRaw !== null) {
+                if (typeof reasonRaw !== 'string') {
+                    reject(`'item_feedback[${idx}].reason' must be a string when provided`);
+                }
+                if (reasonRaw.length > 255) {
+                    reject(`'item_feedback[${idx}].reason' exceeds maxLength 255 (got ${reasonRaw.length})`);
+                }
+                reason = reasonRaw;
+            }
+            return {
+                memory_id: memory_id,
+                useful: useful,
+                ...(reason !== undefined ? { reason } : {}),
+            };
+        });
+    }
+    // expected_missing — optional string <= 2000 chars.
+    let expected_missing;
+    const emRaw = args['expected_missing'];
+    if (emRaw !== undefined && emRaw !== null) {
+        if (typeof emRaw !== 'string') {
+            reject("'expected_missing' must be a string when provided");
+        }
+        if (emRaw.length > 2000) {
+            reject(`'expected_missing' exceeds maxLength 2000 (got ${emRaw.length})`);
+        }
+        expected_missing = emRaw;
+    }
+    // context — optional free-form object.
+    let context;
+    const ctxRaw = args['context'];
+    if (ctxRaw !== undefined && ctxRaw !== null) {
+        if (typeof ctxRaw !== 'object' || Array.isArray(ctxRaw)) {
+            reject("'context' must be a plain object when provided");
+        }
+        context = ctxRaw;
+    }
+    // Build body — `user_id` deliberately omitted (R2.1 D-1).
+    const body = {
+        rating,
+        ...(item_feedback !== undefined ? { item_feedback } : {}),
+        ...(expected_missing !== undefined ? { expected_missing } : {}),
+        ...(context !== undefined ? { context } : {}),
+    };
+    return { user_id, retrieve_id, body };
+}
+export const memoryFeedbackTool = {
+    name: NAME,
+    description: 'Submit per-memory feedback on a previous nexus.context_retrieve call. Pass retrieve_id from earlier output. Rating 1-5, plus per-memory useful flag with optional reason. v5 feedback loop drives quality_score reranking.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            user_id: {
+                type: 'string',
+                description: 'MCP server **internal** audit/logging field, **not forwarded** to backend FeedbackRequest body. Backend derives user_id from retrieve_log (route is PUT /v1/feedback/{retrieve_id}). This field is only used for MCP server-side structlog + metric label.',
+            },
+            retrieve_id: {
+                type: 'string',
+                format: 'uuid',
+                description: 'From earlier nexus.context_retrieve output. MCP server uses this value as PUT URL path parameter.',
+            },
+            rating: { type: 'integer', minimum: 1, maximum: 5 },
+            item_feedback: {
+                type: 'array',
+                items: {
+                    type: 'object',
+                    properties: {
+                        memory_id: { type: 'string', format: 'uuid' },
+                        useful: { type: 'boolean' },
+                        reason: { type: 'string', nullable: true, maxLength: 255 },
+                    },
+                    required: ['memory_id', 'useful'],
+                },
+                description: 'Per-memory useful flag with optional reason. Maps to backend FeedbackRequest.item_feedback[].',
+            },
+            expected_missing: {
+                type: 'string',
+                nullable: true,
+                maxLength: 2000,
+                description: 'Free-text on what relevant memories were missing from retrieval. (PII-filtered before storage by backend)',
+            },
+            context: {
+                type: 'object',
+                nullable: true,
+                additionalProperties: true,
+                description: "Free-form context for feedback (e.g., {client: 'claude-code', session_id: '...'}).",
+            },
+        },
+        required: ['user_id', 'retrieve_id', 'rating'],
+    },
+    outputSchema: {
+        type: 'object',
+        properties: {
+            feedback_id: { type: 'string', format: 'uuid' },
+            retrieve_id: { type: 'string', format: 'uuid' },
+            status: {
+                type: 'string',
+                enum: ['accepted'],
+                description: "Submission status (currently always 'accepted', enum reserved for future expansion)",
+            },
+            created_at: { type: 'string', format: 'date-time' },
+        },
+        required: ['feedback_id', 'retrieve_id', 'status', 'created_at'],
+    },
+    handler: async (args) => {
+        // parseAndValidate throws NexusError(InvalidParams) on violation;
+        // we let it propagate so the MCP dispatch layer can map it to a
+        // JSON-RPC error response (matches memory_search convention).
+        const parsed = parseAndValidate(args);
+        // Audit structlog (stderr only). Body intentionally does NOT include
+        // user_id — that property travels only on this log line.
+        auditLogger(JSON.stringify({
+            event: 'mcp.memory_feedback.submit',
+            tool: NAME,
+            user_id: parsed.user_id,
+            retrieve_id: parsed.retrieve_id,
+            rating: parsed.body.rating,
+        }));
+        const client = getClient();
+        // Wave 2B mid_audit-to-pre_merge fix: wrap SDK call + map errors per §M-3
+        // (mirrors context.ts pattern). Without this, axios-like 401/403/429
+        // surface as JSON-RPC InternalError instead of Unauthorized/RateLimited.
+        let result;
+        try {
+            result = await client.feedback.submit(parsed.retrieve_id, parsed.body);
+        }
+        catch (err) {
+            if (isAxiosLikeError(err)) {
+                const status = err.response?.status ?? null;
+                const respBody = err.response?.data ?? null;
+                const headers = err.response?.headers;
+                throw mapHttpStatusToMcpError(status, respBody, headers);
+            }
+            throw mapHttpStatusToMcpError(null, null);
+        }
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result) }],
+            structuredContent: result,
+        };
+    },
+};
+//# sourceMappingURL=memory_feedback.js.map

package/dist/tools/memory_feedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory_feedback.js","sourceRoot":"","sources":["../../src/tools/memory_feedback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAGH,OAAO,EAAE,WAAW,EAA8B,MAAM,aAAa,CAAC;AAEtE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAGnG,MAAM,IAAI,GAAG,uBAAuB,CAAC;AAErC;8EAC8E;AAC9E,IAAI,OAAO,GAAuB,IAAI,CAAC;AAEvC,SAAS,SAAS;IAChB,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,MAAM,GAAG,GAAG,cAAc,EAAE,CAAC;QAC7B,OAAO,GAAG,IAAI,WAAW,CAAC;YACxB,MAAM,EAAE,GAAG,CAAC,QAAQ;YACpB,OAAO,EAAE,GAAG,CAAC,MAAM;YACnB,QAAQ,EAAE,GAAG,CAAC,QAAQ;SACvB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO,GAAG,IAAI,CAAC;AACjB,CAAC;AAID,IAAI,WAAW,GAAgB,CAAC,IAAI,EAAE,EAAE;IACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;AACpC,CAAC,CAAC;AAEF,gFAAgF;AAChF,MAAM,UAAU,0BAA0B,CAAC,EAAsB;IAC/D,WAAW,GAAG,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC;AACpE,CAAC;AAQD;;;;;;;GAOG;AACH,SAAS,gBAAgB,CAAC,IAA6B;IACrD,MAAM,MAAM,GAAG,CAAC,GAAW,EAAS,EAAE;QACpC,MAAM,IAAI,UAAU,CAAC,GAAG,EAAE,YAAY,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;IAC9D,CAAC,CAAC;IAEF,wCAAwC;IACxC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;IAClC,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC7D,MAAM,CAAC,sDAAsD,CAAC,CAAC;IACjE,CAAC;IACD,MAAM,OAAO,GAAI,SAAoB,CAAC,IAAI,EAAE,CAAC;IAE7C,4CAA4C;IAC5C,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC;IAC1C,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACrE,MAAM,CAAC,0DAA0D,CAAC,CAAC;IACrE,CAAC;IACD,MAAM,WAAW,GAAI,aAAwB,CAAC,IAAI,EAAE,CAAC;IAErD,8EAA8E;IAC9E,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IACjC,IACE,OAAO,SAAS,KAAK,QAAQ;QAC7B,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC;QAC5B,SAAS,GAAG,CAAC;QACb,SAAS,GAAG,CAAC,EACb,CAAC;QACD,MAAM,CAAC,6CAA6C,CAAC,CAAC;IACxD,CAAC;IACD,MAAM,MAAM,GAAG,SAAmB,CAAC;IAEnC,kEAAkE;IAClE,IAAI,aAAqD,CAAC;IAC1D,IAAI,IAAI,CAAC,eAAe,CAAC,KAAK,SAAS,IAAI,IAAI,CAAC,eAAe,CAAC,KAAK,IAAI,EAAE,CAAC;QAC1E,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC;YAC1C,MAAM,CAAC,gDAAgD,CAAC,CAAC;QAC3D,CAAC;QACD,aAAa,GAAI,IAAI,CAAC,eAAe,CAAe,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;YACpE,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;gBAC5C,MAAM,CAAC,kBAAkB,GAAG,sBAAsB,CAAC,CAAC;YACtD,CAAC;YACD,MAAM,IAAI,GAAG,GAA8B,CAAC;YAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;YACpC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC9B,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;gBAC7D,MAAM,CAAC,kBAAkB,GAAG,6CAA6C,CAAC,CAAC;YAC7E,CAAC;YACD,IAAI,OAAO,MAAM,KAAK,SAAS,EAAE,CAAC;gBAChC,MAAM,CAAC,kBAAkB,GAAG,iCAAiC,CAAC,CAAC;YACjE,CAAC;YACD,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;YACjC,IAAI,MAA0B,CAAC;YAC/B,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;gBAClD,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;oBAClC,MAAM,CAAC,kBAAkB,GAAG,0CAA0C,CAAC,CAAC;gBAC1E,CAAC;gBACD,IAAK,SAAoB,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;oBACvC,MAAM,CACJ,kBAAkB,GAAG,wCAAyC,SAAoB,CAAC,MAAM,GAAG,CAC7F,CAAC;gBACJ,CAAC;gBACD,MAAM,GAAG,SAAmB,CAAC;YAC/B,CAAC;YACD,OAAO;gBACL,SAAS,EAAE,SAAmB;gBAC9B,MAAM,EAAE,MAAiB;gBACzB,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC5C,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED,oDAAoD;IACpD,IAAI,gBAAoC,CAAC;IACzC,MAAM,KAAK,GAAG,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACvC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,CAAC,mDAAmD,CAAC,CAAC;QAC9D,CAAC;QACD,IAAK,KAAgB,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;YACpC,MAAM,CAAC,kDAAmD,KAAgB,CAAC,MAAM,GAAG,CAAC,CAAC;QACxF,CAAC;QACD,gBAAgB,GAAG,KAAe,CAAC;IACrC,CAAC;IAED,uCAAuC;IACvC,IAAI,OAA4C,CAAC;IACjD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;IAC/B,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAC5C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACxD,MAAM,CAAC,gDAAgD,CAAC,CAAC;QAC3D,CAAC;QACD,OAAO,GAAG,MAAiC,CAAC;IAC9C,CAAC;IAED,0DAA0D;IAC1D,MAAM,IAAI,GAA0B;QAClC,MAAM;QACN,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,GAAG,CAAC,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9C,CAAC;IAEF,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;AACxC,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAmB;IAChD,IAAI,EAAE,IAAI;IACV,WAAW,EACT,4NAA4N;IAC9N,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,4PAA4P;aAC/P;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE,MAAM;gBACd,WAAW,EACT,mGAAmG;aACtG;YACD,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE;YACnD,aAAa,EAAE;gBACb,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE;wBAC7C,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;wBAC3B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE;qBAC3D;oBACD,QAAQ,EAAE,CAAC,WAAW,EAAE,QAAQ,CAAC;iBAClC;gBACD,WAAW,EACT,+FAA+F;aAClG;YACD,gBAAgB,EAAE;gBAChB,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,SAAS,EAAE,IAAI;gBACf,WAAW,EACT,2GAA2G;aAC9G;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,oBAAoB,EAAE,IAAI;gBAC1B,WAAW,EACT,oFAAoF;aACvF;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,QAAQ,CAAC;KAC/C;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE;YAC/C,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE;YAC/C,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,UAAU,CAAC;gBAClB,WAAW,EACT,qFAAqF;aACxF;YACD,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE;SACpD;QACD,QAAQ,EAAE,CAAC,aAAa,EAAE,aAAa,EAAE,QAAQ,EAAE,YAAY,CAAC;KACjE;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAA2B,EAAE;QAC/C,kEAAkE;QAClE,gEAAgE;QAChE,8DAA8D;QAC9D,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAEtC,qEAAqE;QACrE,yDAAyD;QACzD,WAAW,CACT,IAAI,CAAC,SAAS,CAAC;YACb,KAAK,EAAE,4BAA4B;YACnC,IAAI,EAAE,IAAI;YACV,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM;SAC3B,CAAC,CACH,CAAC;QAEF,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,0EAA0E;QAC1E,qEAAqE;QACrE,yEAAyE;QACzE,IAAI,MAAM,CAAC;QACX,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QACzE,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,IAAI,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC1B,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,EAAE,MAAM,IAAI,IAAI,CAAC;gBAC5C,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,EAAE,IAAI,IAAI,IAAI,CAAC;gBAC5C,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,EAAE,OAAwD,CAAC;gBACvF,MAAM,uBAAuB,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC3D,CAAC;YACD,MAAM,uBAAuB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC5C,CAAC;QAED,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YACzD,iBAAiB,EAAE,MAA4C;SAChE,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/tools/memory_search.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Tool: nexus.memory_search (US-037 TASK-010, Wave 2).
+ *
+ * Targeted memory search over the Nexus REST API via `@nexusm/sdk`.
+ *
+ * Schema is locked in proposal §"R2 工具 Schema 锁定" Tool 2 (+ R2.1) and
+ * MUST be preserved verbatim — the parity check
+ * `tests/unit/schema_sync.test.ts` will fail loudly if drift is introduced.
+ *
+ * Design decisions resolved during implementation:
+ *
+ *   - `mode` defaults to `'hybrid'` per proposal §M-11 / §A2-D-1
+ *     (no pure-keyword mode in Phase 1; hybrid handles CJK via the
+ *     backend's trigram `word_similarity` fallback documented in
+ *     `repositories/__init__.py::search_by_trigram`).
+ *
+ *   - Enum violations on `mode` are surfaced as a JSON-RPC
+ *     `InvalidParams` protocol error (proposal §M-3 mapping table:
+ *     422 → InvalidParams). The MCP core dispatcher in `src/index.ts`
+ *     does NOT validate input against the declared inputSchema — that
+ *     responsibility lives in this handler.
+ *
+ *   - `score_threshold` is forwarded to the SDK body verbatim. The
+ *     backend `/memories/search` endpoint accepts it under that exact
+ *     name (the SDK's older `threshold` field is a historical alias
+ *     that the backend also accepts; the locked MCP schema uses the
+ *     new name, so we forward the new name).
+ *
+ *   - `NexusClient` is lazily constructed on first handler invocation
+ *     from `loadAuthConfig()` and cached for subsequent calls. This
+ *     keeps construction cost off the `tools/list` hot path and lets
+ *     tests inject a mock via `vi.mock('@nexusm/sdk', ...)` before the
+ *     first call.
+ */
+import { type ToolDefinition } from './types.js';
+/**
+ * Test-only seam: reset the cached client so a `vi.mock` of `@nexusm/sdk`
+ * applied between tests can re-construct against the fresh mock.
+ *
+ * @internal
+ */
+export declare function __resetClientForTesting(): void;
+export declare const memorySearchTool: ToolDefinition;
+//# sourceMappingURL=memory_search.d.ts.map

package/dist/tools/memory_search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory_search.d.ts","sourceRoot":"","sources":["../../src/tools/memory_search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAKH,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAuBjD;;;;;GAKG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAaD,eAAO,MAAM,gBAAgB,EAAE,cAwG9B,CAAC"}