LearnNewsExamplesServices
Frontmatter
id8321
titleFix broken manage_database_backup tool shape in Memory Core OpenAPI
stateClosed
labels
bugai
assigneestobiu
createdAtJan 4, 2026, 7:05 PM
updatedAtJan 4, 2026, 7:12 PM
githubUrlhttps://github.com/neomjs/neo/issues/8321
authortobiu
commentsCount0
parentIssuenull
subIssues[]
subIssuesCompleted0
subIssuesTotal0
blockedBy[]
blocking[]
closedAtJan 4, 2026, 7:12 PM

Fix broken manage_database_backup tool shape in Memory Core OpenAPI

Closed v11.18.0 bugai
tobiu
tobiu commented on Jan 4, 2026, 7:05 PM

The recent consolidation of backup tools (Issue #8320) introduced a multipart/form-data definition and complex response schemas that broke the Memory Core.

Root Causes:

  1. Tool Shape Incompatibility: The multipart/form-data content type and format: binary for the file argument are incompatible with text-based LLM interactions and standard MCP tool definitions.
  2. Schema Validation Failure: The use of oneOf in the manage_database_backup response schema caused zod-to-json-schema conversion errors (expected "object") during tool discovery, preventing the server from listing tools.
  3. Implementation Mismatch: The DatabaseService.mjs implementation returned inconsistent data structures (e.g., missing message in imports, returning total) that did not align with the defined OpenAPI schema.

Solution:

  1. Simplify Input Schema: Change requestBody to application/json and file to a string path.
  2. Unified Response Schema: Replace oneOf with a single BackupActionResponse schema containing nullable fields (imported, skipped, total, mode) and a mandatory message.
  3. Standardize Service Output: Update DatabaseService.mjs to return a consistent object structure matching the new schema.
tobiu added the bug label on Jan 4, 2026, 7:05 PM
tobiu added the ai label on Jan 4, 2026, 7:05 PM
tobiu assigned to @tobiu on Jan 4, 2026, 7:11 PM
tobiu referenced in commit b7539d3 - "fix: standardize manage_database_backup return values and schema (Issue #8321)" on Jan 4, 2026, 7:11 PM
tobiu closed this issue on Jan 4, 2026, 7:12 PM