meta/api_structure_2025-07-23.md

API structure, 2025-07-23

agents/mcp_server.py

MODELS

• class NoteInput(BaseModel):
• class NoteOutput(BaseModel):
• class DiaryInput(BaseModel):
• class DiaryOutput(BaseModel):
• class DiaryListOutput(BaseModel):
• class ConceptInput(BaseModel):
• class ConceptOutput(BaseModel):
• class Concept(BaseModel):
• class LinkInput(BaseModel):
• class LinkOutput(BaseModel):
• class Edge(BaseModel):
• class GraphExpansionOutput(BaseModel):
• class GraphExport(BaseModel):
• class GraphImportData(BaseModel):
• class ConceptUpdate(BaseModel):
• class ConceptQueryOutput(BaseModel):
• class NoteTagUpdate(BaseModel): ROUTES
• @app.get("/status")
• @app.post("/diary/write", response_model=dict)
• @app.get("/diary/read", response_model=DiaryListOutput)
• @app.delete("/diary/delete/{entry_id}")
• @app.get("/diary/get_entry/{entry_id}", response_model=DiaryOutput)
• @app.post("/diary/search_entries", response_model=DiaryListOutput)
• @app.get("/diary/tag_stats", response_model=dict)
• @app.get("/diary/export", response_model=DiaryListOutput)
• @app.post("/graph/add_concept", response_model=ConceptOutput)
• @app.post("/graph/add_link", response_model=LinkOutput)
• @app.get("/graph/expand", response_model=GraphExpansionOutput)
• @app.get("/graph/list_concepts", response_model=List[Concept])
• @app.get("/graph/list_links", response_model=List[Edge])
• @app.get("/graph/get_concept/{id}", response_model=Concept)
• @app.delete("/graph/delete_concept/{id}")
• @app.delete("/graph/delete_link/{id}")
• @app.put("/graph/update_concept/{id}")
• @app.post("/graph/merge_concepts")
• @app.get("/graph/search_links", response_model=List[Edge])
• @app.get("/graph/search_concepts", response_model=List[Concept])
• @app.get("/graph/query_concept", response_model=ConceptQueryOutput)
• @app.post("/graph/relate_concepts", response_model=LinkOutput)
• @app.get("/graph/export", response_model=GraphExport)
• @app.post("/graph/import")
• @app.post("/note/write", response_model=dict)
• @app.get("/note/next", response_model=Optional[NoteOutput])
• @app.post("/note/mark_read", response_model=dict)
• @app.post("/note/set_tags", response_model=dict)
• @app.get("/note/random", response_model=Optional[NoteOutput])
• @app.get("/note/by_tag", response_model=List[NoteOutput])
• @app.on_event("shutdown")

agents/tools/storage.py

• class Storage:

  • def init(self, config=None):

  • def _init_db(self):

  • Методы для работы с дневником

    • def write_diary_entry(self, text, tags=None):
    • def read_diary_entries(self, limit=10, tag_filter=None):
    • def search_diary_by_time_range(self, from_ts, to_ts):
    • def delete_diary_entry_by_id(self, entry_id):
    • def get_diary_tag_stats(self):
    • def export_diary_entries(self):

  • Методы для работы с концептами

    • def create_concept(self, name, description=None):
    • def get_concept_by_name(self, name):
    • def list_concepts(self):

  • Методы для работы с связями

    • def link_concepts(self, from_name, to_name, relation_type):
    • def get_links_for_concept(self, concept_name):

  • Сложные операции над графом

    • def expand_concept_graph(self, start_id, depth):
    • def delete_concept_by_id(self, concept_id):
    • def delete_link_by_id(self, link_id):
    • def export_semantic_graph(self):
    • def update_concept_fields(self, concept_id, name=None, description=None):
    • def search_links_by_relation(self, relation):
    • def search_concepts(self, query):
    • def merge_concepts(self, source_id, target_id):
    • def find_concept_id_by_name(self, name):

  • Методы для заметок

    • def write_note(self, text, tags=None):
    • def read_notes(self, limit=10, tag_filter=None):
    • def get_notes_after(self, since_ts):
    • def get_first_unread_note(self):
    • def mark_note_as_read(self, note_id: int):
    • def set_tags(self, note_id: int, tags: list[str]):
    • def get_random_note_by_tags(self, include_tags: list[str]):

  • Утилиты

    • def close(self):