system/memos
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1
memos/proto/api/v1
History
boojack 047175dbed chore(mcp): improve tool discoverability, add orientation tools and evals 
Make the OpenAPI-driven MCP surface more usable by agents, following the
mcp-builder guidance.

- Enrich proto descriptions (single source of truth, flows to OpenAPI + MCP
  tool descriptions): document the memo `filter` CEL grammar with fields and
  examples (replacing the dangling "Refer to Shortcut.filter"), clarify the
  created_ts/updated_ts vs create_time/update_time naming, the visibility
  enum, the declarative replace semantics of Set* ops, and steer tag filters
  to `"x" in tags` (not the unsupported `tag == "x"`).
- Mark SetMemoAttachments / SetMemoRelations idempotent via a per-operation
  override the HTTP-method heuristic can't express.
- Curate two read-only orientation tools: shortcut_list_shortcuts (surfaces
  reusable CEL filters) and auth_get_current_user (the single allowed
  auth/identity op, for resolving the current user); guard test updated to
  keep the rest of the auth/user surface excluded.
- Add a task-level evaluation suite (server/router/mcp/evals) with 10
  verified questions, pinned to the deterministic demo seed.
2026-06-27 10:32:42 +08:00
..
ai_service.proto feat(transcription): explicit STT settings with provider, model, prompt (#5926) 2026-05-02 19:35:18 +08:00
attachment_service.proto feat(attachments): add Live Photo and Motion Photo support (#5810) 2026-04-06 10:47:01 +08:00
auth_service.proto feat: replace auto-increment ID with UID for identity provider resource names (#5687) 2026-03-05 21:01:22 +08:00
common.proto
idp_service.proto chore: standardize and improve API structure (#5224) 2025-11-05 22:36:51 +08:00
instance_service.proto feat(storage): add insecure_skip_tls_verify option for S3 2026-06-23 00:04:54 +08:00
memo_service.proto chore(mcp): improve tool discoverability, add orientation tools and evals 2026-06-27 10:32:42 +08:00
README.md
shortcut_service.proto chore(mcp): improve tool discoverability, add orientation tools and evals 2026-06-27 10:32:42 +08:00
user_service.proto chore(webhook): reveal-later signing secret flow 2026-06-26 09:03:24 +08:00

README.md

Memos API Design

This API design should follow the guidelines and best practices outlined in the Google API Improvement Proposals (AIPs).