DeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.
Python ai-agentsai-tutorclawbotcli-tooldeepresearchinteractive-learninglearningmulti-agent-systemsrag
chore(contracts): sync browser APIs after PR integration
Bingxi Zhao (Frank)e91d9800edf6
diff --git a/web/contracts/generated/api.ts b/web/contracts/generated/api.tsindex d2a7989e1..8dcf701a0 100644--- a/web/contracts/generated/api.ts+++ b/web/contracts/generated/api.ts@@ -2225,6 +2225,26 @@ export interface paths {readonly patch?: never;readonly trace?: never;};+ readonly "/api/knowledge-bases/{kb_name}/visual-assets/{asset_id}": {+ readonly parameters: {+ readonly query?: never;+ readonly header?: never;+ readonly path?: never;+ readonly cookie?: never;+ };+ /**+ * Serve Kb Visual Asset+ * @description Serve a verified source image from an access checked local KB.+ */+ readonly get: operations["serve_kb_visual_asset_api_knowledge_bases__kb_name__visual_assets__asset_id__get"];+ readonly put?: never;+ readonly post?: never;+ readonly delete?: never;+ readonly options?: never;+ readonly head?: never;+ readonly patch?: never;+ readonly trace?: never;+ };readonly "/api/knowledge-bases/{kb_name}/web-source": {readonly parameters: {readonly query?: never;@@ -2293,6 +2313,23 @@ export interface paths {readonly patch?: never;readonly trace?: never;};+ readonly "/api/knowledge-bases/{kb_name}/web-source/{source_id}/pairings": {+ readonly parameters: {+ readonly query?: never;+ readonly header?: never;+ readonly path?: never;+ readonly cookie?: never;+ };+ /** Get Web Source Pairings */+ readonly get: operations["get_web_source_pairings_api_knowledge_bases__kb_name__web_source__source_id__pairings_get"];+ readonly put?: never;+ readonly post?: never;+ readonly delete?: never;+ readonly options?: never;+ readonly head?: never;+ readonly patch?: never;+ readonly trace?: never;+ };readonly "/api/knowledge-bases/{kb_name}/web-source/{source_id}/retry": {readonly parameters: {readonly query?: never;@@ -2436,6 +2473,26 @@ export interface paths {readonly patch?: never;readonly trace?: never;};+ readonly "/api/knowledge-bases/connect-kiwix": {+ readonly parameters: {+ readonly query?: never;+ readonly header?: never;+ readonly path?: never;+ readonly cookie?: never;+ };+ readonly get?: never;+ readonly put?: never;+ /**+ * Connect Kiwix Route+ * @description Bind a KB to a kiwix-serve archive; no ingest or index is created.+ */+ readonly post: operations["connect_kiwix_route_api_knowledge_bases_connect_kiwix_post"];+ readonly delete?: never;+ readonly options?: never;+ readonly head?: never;+ readonly patch?: never;+ readonly trace?: never;+ };readonly "/api/knowledge-bases/connect-lightrag-server": {readonly parameters: {readonly query?: never;@@ -2640,6 +2697,46 @@ export interface paths {readonly patch?: never;readonly trace?: never;};+ readonly "/api/knowledge-bases/kiwix-articles": {+ readonly parameters: {+ readonly query?: never;+ readonly header?: never;+ readonly path?: never;+ readonly cookie?: never;+ };+ /**+ * Search Kiwix Articles+ * @description List bounded article matches for Knowledge Center and Reading import.+ */+ readonly get: operations["search_kiwix_articles_api_knowledge_bases_kiwix_articles_get"];+ readonly put?: never;+ readonly post?: never;+ readonly delete?: never;+ readonly options?: never;+ readonly head?: never;+ readonly patch?: never;+ readonly trace?: never;+ };+ readonly "/api/knowledge-bases/kiwix-catalog": {+ readonly parameters: {+ readonly query?: never;+ readonly header?: never;+ readonly path?: never;+ readonly cookie?: never;+ };+ /**+ * List Kiwix Catalog+ * @description List exact ZIM names from legacy OPDS; v2 can omit loaded archives.+ */+ readonly get: operations["list_kiwix_catalog_api_knowledge_bases_kiwix_catalog_get"];+ readonly put?: never;+ readonly post?: never;+ readonly delete?: never;+ readonly options?: never;+ readonly head?: never;+ readonly patch?: never;+ readonly trace?: never;+ };readonly "/api/knowledge-bases/list-ima": {readonly parameters: {readonly query?: never;@@ -2708,6 +2805,26 @@ export interface paths {readonly patch?: never;readonly trace?: never;};+ readonly "/api/knowledge-bases/probe-kiwix": {+ readonly parameters: {+ readonly query?: never;+ readonly header?: never;+ readonly path?: never;+ readonly cookie?: never;+ };+ readonly get?: never;+ readonly put?: never;+ /**+ * Probe Kiwix Route+ * @description Verify that one archive is readable without copying its ZIM file.+ */+ readonly post: operations["probe_kiwix_route_api_knowledge_bases_probe_kiwix_post"];+ readonly delete?: never;+ readonly options?: never;+ readonly head?: never;+ readonly patch?: never;+ readonly trace?: never;+ };readonly "/api/knowledge-bases/probe-lightrag-server": {readonly parameters: {readonly query?: never;@@ -6179,6 +6296,29 @@ export interface paths {readonly patch?: never;readonly trace?: never;};+ readonly "/api/reading/library/import-zim-article": {+ readonly parameters: {+ readonly query?: never;+ readonly header?: never;+ readonly path?: never;+ readonly cookie?: never;+ };+ readonly get?: never;+ readonly put?: never;+ /**+ * Import Zim Article+ * @description Open one selected Kiwix article in Immersive Reading.+ *+ * Only its bounded text snapshot enters the reading store. The ZIM archive+ * stays on the existing kiwix-serve instance, without bulk extraction.+ */+ readonly post: operations["import_zim_article_api_reading_library_import_zim_article_post"];+ readonly delete?: never;+ readonly options?: never;+ readonly head?: never;+ readonly patch?: never;+ readonly trace?: never;+ };readonly "/api/reading/library/materials": {readonly parameters: {readonly query?: never;@@ -6489,6 +6629,23 @@ export interface paths {readonly patch?: never;readonly trace?: never;};+ readonly "/api/reading/materials/{material_id}/quiz/rewards": {+ readonly parameters: {+ readonly query?: never;+ readonly header?: never;+ readonly path?: never;+ readonly cookie?: never;+ };+ /** List Quiz Rewards */+ readonly get: operations["list_quiz_rewards_api_reading_materials__material_id__quiz_rewards_get"];+ readonly put?: never;+ readonly post?: never;+ readonly delete?: never;+ readonly options?: never;+ readonly head?: never;+ readonly patch?: never;+ readonly trace?: never;+ };readonly "/api/reading/materials/{material_id}/raw": {readonly parameters: {readonly query?: never;@@ -6509,6 +6666,26 @@ export interface paths {readonly patch?: never;readonly trace?: never;};+ readonly "/api/reading/materials/{material_id}/read-aloud": {+ readonly parameters: {+ readonly query?: never;+ readonly header?: never;+ readonly path?: never;+ readonly cookie?: never;+ };+ readonly get?: never;+ readonly put?: never;+ /**+ * Read Material Aloud+ * @description Synthesize one assigned material unit with the active server voice.+ */+ readonly post: operations["read_material_aloud_api_reading_materials__material_id__read_aloud_post"];+ readonly delete?: never;+ readonly options?: never;+ readonly head?: never;+ readonly patch?: never;+ readonly trace?: never;+ };readonly "/api/reading/materials/{material_id}/render": {readonly parameters: {readonly query?: never;@@ -8616,6 +8793,40 @@ export interface paths {readonly patch?: never;readonly trace?: never;};+ readonly "/api/settings/workspace/knowledge-bases/move": {+ readonly parameters: {+ readonly query?: never;+ readonly header?: never;+ readonly path?: never;+ readonly cookie?: never;+ };+ readonly get?: never;+ readonly put?: never;+ /** Move Knowledge Base */+ readonly post: operations["move_knowledge_base_api_settings_workspace_knowledge_bases_move_post"];+ readonly delete?: never;+ readonly options?: never;+ readonly head?: never;+ readonly patch?: never;+ readonly trace?: never;+ };+ readonly "/api/settings/workspace/knowledge-bases/preview-move": {+ readonly parameters: {+ readonly query?: never;+ readonly header?: never;+ readonly path?: never;+ readonly cookie?: never;+ };+ readonly get?: never;+ readonly put?: never;+ /** Preview Knowledge Move */+ readonly post: operations["preview_knowledge_move_api_settings_workspace_knowledge_bases_preview_move_post"];+ readonly delete?: never;+ readonly options?: never;+ readonly head?: never;+ readonly patch?: never;+ readonly trace?: never;+ };readonly "/api/settings/workspace/registrations": {readonly parameters: {readonly query?: never;@@ -9740,6 +9951,60 @@ export interface paths {readonly patch?: never;readonly trace?: never;};+ readonly "/api/video-learning/materials/{material_id}/mark-suggestions": {+ readonly parameters: {+ readonly query?: never;+ readonly header?: never;+ readonly path?: never;+ readonly cookie?: never;+ };+ readonly get?: never;+ readonly put?: never;+ /** Suggest Video Marks */+ readonly post: operations["suggest_video_marks_api_video_learning_materials__material_id__mark_suggestions_post"];+ readonly delete?: never;+ readonly options?: never;+ readonly head?: never;+ readonly patch?: never;+ readonly trace?: never;+ };+ readonly "/api/video-learning/materials/{material_id}/marks": {+ readonly parameters: {+ readonly query?: never;+ readonly header?: never;+ readonly path?: never;+ readonly cookie?: never;+ };+ /** List Video Marks */+ readonly get: operations["list_video_marks_api_video_learning_materials__material_id__marks_get"];+ readonly put?: never;+ /** Create Video Mark */+ readonly post: operations["create_video_mark_api_video_learning_materials__material_id__marks_post"];+ readonly delete?: never;+ readonly options?: never;+ readonly head?: never;+ readonly patch?: never;+ readonly trace?: never;+ };+ readonly "/api/video-learning/materials/{material_id}/marks/{mark_id}": {+ readonly parameters: {+ readonly query?: never;+ readonly header?: never;+ readonly path?: never;+ readonly cookie?: never;+ };+ /** Get Video Mark */+ readonly get: operations["get_video_mark_api_video_learning_materials__material_id__marks__mark_id__get"];+ readonly put?: never;+ readonly post?: never;+ /** Delete Video Mark */+ readonly delete: operations["delete_video_mark_api_video_learning_materials__material_id__marks__mark_id__delete"];+ readonly options?: never;+ readonly head?: never;+ /** Update Video Mark */+ readonly patch: operations["update_video_mark_api_video_learning_materials__material_id__marks__mark_id__patch"];+ readonly trace?: never;+ };readonly "/api/video-learning/materials/{material_id}/notes": {readonly parameters: {readonly query?: never;@@ -10599,7 +10864,8 @@ export interface components {*/readonly language: string;readonly llm_selection?:- components["schemas"]["LLMSelectionPayload"] | null;+ | components["schemas"]["deeptutor__api__routers__memory__LLMSelectionPayload"]+ | null;};/*** AuthStatusResponse@@ -10635,6 +10901,9 @@ export interface components {};/** AutoMarkRequest */readonly AutoMarkRequest: {+ readonly llm_selection?:+ | components["schemas"]["deeptutor__api__routers__co_writer__LLMSelectionPayload"]+ | null;/** Text */readonly text: string;};@@ -10645,6 +10914,45 @@ export interface components {/** Operation Id */readonly operation_id: string;};+ /** BilingualPairingInfo */+ readonly BilingualPairingInfo: {+ /** Pairing Id */+ readonly pairing_id: string;+ /**+ * Pairing Method+ * @default hreflang+ */+ readonly pairing_method: string;+ /**+ * Source File+ * @default+ */+ readonly source_file: string;+ /**+ * Source Lang+ * @default+ */+ readonly source_lang: string;+ /** Source Url */+ readonly source_url: string;+ /**+ * Target File+ * @default+ */+ readonly target_file: string;+ /**+ * Target Lang+ * @default+ */+ readonly target_lang: string;+ /** Target Url */+ readonly target_url: string;+ /**+ * Updated At+ * @default 0+ */+ readonly updated_at: number;+ };/** Body_admin_import_users_api_auth_users_import_post */readonly Body_admin_import_users_api_auth_users_import_post: {/** File */@@ -10686,6 +10994,8 @@ export interface components {* @default*/readonly search_mode: string;+ /** Storage Workspace Id */+ readonly storage_workspace_id?: string | null;};/** Body_import_docx_api_documents_import_docx_post */readonly Body_import_docx_api_documents_import_docx_post: {@@ -11268,6 +11578,15 @@ export interface components {/** Name */readonly name: string;};+ /** ConnectKiwixRequest */+ readonly ConnectKiwixRequest: {+ /** Name */+ readonly name: string;+ /** Server Url */+ readonly server_url: string;+ /** Zim Name */+ readonly zim_name: string;+ };/** ConnectLightRagServerRequest */readonly ConnectLightRagServerRequest: {/**@@ -11657,7 +11976,8 @@ export interface components {*/readonly language: string;readonly llm_selection?:- components["schemas"]["LLMSelectionPayload"] | null;+ | components["schemas"]["deeptutor__api__routers__memory__LLMSelectionPayload"]+ | null;};/** DeepDiveRequest */readonly DeepDiveRequest: {@@ -11684,6 +12004,22 @@ export interface components {/** Page Id */readonly page_id: string;};+ /** LLMSelectionPayload */+ readonly deeptutor__api__routers__co_writer__LLMSelectionPayload: {+ /** Model Id */+ readonly model_id: string;+ /** Profile Id */+ readonly profile_id: string;+ /** Reasoning Effort */+ readonly reasoning_effort?: string | null;+ };+ /** LLMSelectionPayload */+ readonly deeptutor__api__routers__memory__LLMSelectionPayload: {+ /** Model Id */+ readonly model_id: string;+ /** Profile Id */+ readonly profile_id: string;+ };/** ProgressRequest */readonly deeptutor__api__routers__video_learning__ProgressRequest: {/**@@ -11881,6 +12217,9 @@ export interface components {readonly instruction: string;/** Kb Name */readonly kb_name?: string | null;+ readonly llm_selection?:+ | components["schemas"]["deeptutor__api__routers__co_writer__LLMSelectionPayload"]+ | null;/** Source */readonly source?: ("rag" | "web") | null;/** Text */@@ -12275,6 +12614,13 @@ export interface components {*/readonly public_base_url: string;};+ /** KiwixConnectionRequest */+ readonly KiwixConnectionRequest: {+ /** Server Url */+ readonly server_url: string;+ /** Zim Name */+ readonly zim_name: string;+ };/** KnowledgeBaseInfo */readonly KnowledgeBaseInfo: {/**@@ -12319,6 +12665,16 @@ export interface components {/** Status */readonly status?: string | null;};+ /** KnowledgeMovePayload */+ readonly KnowledgeMovePayload: {+ /** Source Id */+ readonly source_id: string;+ /**+ * Target Workspace Id+ * @default+ */+ readonly target_workspace_id: string;+ };/** KnowledgePointInput */readonly KnowledgePointInput: {/**@@ -12357,7 +12713,7 @@ export interface components {* Language* @enum {string}*/- readonly language: "en" | "zh" | "fr" | "de" | "uk";+ readonly language: "en" | "zh" | "fr" | "de" | "uk" | "pl";};/** LearnerOverrideRequest */readonly LearnerOverrideRequest: {@@ -12699,13 +13055,6 @@ export interface components {/** Profile Id */readonly profile_id: string;};- /** LLMSelectionPayload */- readonly LLMSelectionPayload: {- /** Model Id */- readonly model_id: string;- /** Profile Id */- readonly profile_id: string;- };/*** LoginRequest* @description Payload for the POST /login endpoint.@@ -12724,6 +13073,70 @@ export interface components {*/readonly confirmation: "update-and-restart";};+ /** MarkCreateRequest */+ readonly MarkCreateRequest: {+ /**+ * End Locator+ * @default 0+ */+ readonly end_locator: number;+ /** End Seconds */+ readonly end_seconds: number;+ /** Kind */+ readonly kind: string;+ /** Metadata */+ readonly metadata?: {+ readonly [key: string]: unknown;+ };+ /**+ * Note+ * @default+ */+ readonly note: string;+ /**+ * Quote+ * @default+ */+ readonly quote: string;+ /**+ * Start Locator+ * @default 0+ */+ readonly start_locator: number;+ /** Start Seconds */+ readonly start_seconds: number;+ };+ /** MarkPatchRequest */+ readonly MarkPatchRequest: {+ /** End Locator */+ readonly end_locator?: number | null;+ /** End Seconds */+ readonly end_seconds?: number | null;+ /** Kind */+ readonly kind?: string | null;+ /** Metadata */+ readonly metadata?: {+ readonly [key: string]: unknown;+ } | null;+ /** Note */+ readonly note?: string | null;+ /** Quote */+ readonly quote?: string | null;+ /** Reviewed */+ readonly reviewed?: boolean | null;+ /** Start Locator */+ readonly start_locator?: number | null;+ /** Start Seconds */+ readonly start_seconds?: number | null;+ };+ /** MarkSuggestionRequest */+ readonly MarkSuggestionRequest: {+ /**+ * Time Seconds+ * @default 0+ */+ readonly time_seconds: number;+ };/*** MasteryCardAnswer* @description An answer submitted from a mastery question card.@@ -14007,6 +14420,9 @@ export interface components {readonly instruction: string;/** Kb Name */readonly kb_name?: string | null;+ readonly llm_selection?:+ | components["schemas"]["deeptutor__api__routers__co_writer__LLMSelectionPayload"]+ | null;/*** Mode* @default rewrite@@ -14033,6 +14449,11 @@ export interface components {*/readonly tools_used: readonly string[];};+ /** ReadAloudAudioPayload */+ readonly ReadAloudAudioPayload: {+ /** Locator */+ readonly locator: number;+ };/*** ReadingActivityRecord* @description One successful Reading-extension action, without source content.@@ -14306,7 +14727,8 @@ export interface components {/** Layer */readonly layer: string;readonly llm_selection?:- components["schemas"]["LLMSelectionPayload"] | null;+ | components["schemas"]["deeptutor__api__routers__memory__LLMSelectionPayload"]+ | null;/*** Mode* @enum {string}@@ -15365,7 +15787,7 @@ export interface components {/** Code Block Wrap Long Lines */readonly code_block_wrap_long_lines?: boolean | null;/** Language */- readonly language?: ("en" | "zh" | "fr" | "de" | "uk") | null;+ readonly language?: ("en" | "zh" | "fr" | "de" | "uk" | "pl") | null;/** Response Language */readonly response_language?:| (@@ -15572,7 +15994,8 @@ export interface components {*/readonly language: string;readonly llm_selection?:- components["schemas"]["LLMSelectionPayload"] | null;+ | components["schemas"]["deeptutor__api__routers__memory__LLMSelectionPayload"]+ | null;};/** UpdateSettingsRequest */readonly UpdateSettingsRequest: {@@ -15941,6 +16364,10 @@ export interface components {* @default true*/readonly auto_sync_enabled: boolean;+ /** Bilingual Pairings */+ readonly bilingual_pairings?: readonly {+ readonly [key: string]: unknown;+ }[];/*** Enabled* @default true@@ -16100,6 +16527,23 @@ export interface components {*/readonly transcript_provider: string;};+ /** ZimArticleImportRequest */+ readonly ZimArticleImportRequest: {+ /** Article Path */+ readonly article_path: string;+ /** Kb Ref */+ readonly kb_ref: string;+ /**+ * Title+ * @default+ */+ readonly title: string;+ /**+ * Workspace Id+ * @default+ */+ readonly workspace_id: string;+ };};responses: never;parameters: never;@@ -16136,6 +16580,8 @@ export type SchemaAuthStatusResponse =components["schemas"]["AuthStatusResponse"];export type SchemaAutoMarkRequest = components["schemas"]["AutoMarkRequest"];export type SchemaAutoMarkResponse = components["schemas"]["AutoMarkResponse"];+export type SchemaBilingualPairingInfo =+ components["schemas"]["BilingualPairingInfo"];export type SchemaBodyAdminImportUsersApiAuthUsersImportPost =components["schemas"]["Body_admin_import_users_api_auth_users_import_post"];export type SchemaBodyCreateKnowledgeBaseApiKnowledgeBasesPost =@@ -16217,6 +16663,8 @@ export type SchemaConnectFolderRequest =components["schemas"]["ConnectFolderRequest"];export type SchemaConnectImaRequest =components["schemas"]["ConnectImaRequest"];+export type SchemaConnectKiwixRequest =+ components["schemas"]["ConnectKiwixRequest"];export type SchemaConnectLightRagServerRequest =components["schemas"]["ConnectLightRagServerRequest"];export type SchemaConnectMarginNote4Request =@@ -16260,6 +16708,10 @@ export type SchemaDedupRequest = components["schemas"]["DedupRequest"];export type SchemaDeepDiveRequest = components["schemas"]["DeepDiveRequest"];export type SchemaDeeptutorApiRoutersBookProgressRequest =components["schemas"]["deeptutor__api__routers__book__ProgressRequest"];+export type SchemaDeeptutorApiRoutersCoWriterLlmSelectionPayload =+ components["schemas"]["deeptutor__api__routers__co_writer__LLMSelectionPayload"];+export type SchemaDeeptutorApiRoutersMemoryLlmSelectionPayload =+ components["schemas"]["deeptutor__api__routers__memory__LLMSelectionPayload"];export type SchemaDeeptutorApiRoutersVideoLearningProgressRequest =components["schemas"]["deeptutor__api__routers__video_learning__ProgressRequest"];export type SchemaDeleteBlockRequest =@@ -16345,8 +16797,12 @@ export type SchemaInstallSkillRequest =components["schemas"]["InstallSkillRequest"];export type SchemaInvidiousSettings =components["schemas"]["InvidiousSettings"];+export type SchemaKiwixConnectionRequest =+ components["schemas"]["KiwixConnectionRequest"];export type SchemaKnowledgeBaseInfo =components["schemas"]["KnowledgeBaseInfo"];+export type SchemaKnowledgeMovePayload =+ components["schemas"]["KnowledgeMovePayload"];export type SchemaKnowledgePointInput =components["schemas"]["KnowledgePointInput"];export type SchemaKnowledgeType = components["schemas"]["KnowledgeType"];@@ -16383,11 +16839,14 @@ export type SchemaListImaResponse = components["schemas"]["ListImaResponse"];export type SchemaLlamaIndexConfigUpdate =components["schemas"]["LlamaIndexConfigUpdate"];export type SchemaLlmSelection = components["schemas"]["LLMSelection"];-export type SchemaLlmSelectionPayload =- components["schemas"]["LLMSelectionPayload"];export type SchemaLoginRequest = components["schemas"]["LoginRequest"];export type SchemaManagedUpdateRequest =components["schemas"]["ManagedUpdateRequest"];+export type SchemaMarkCreateRequest =+ components["schemas"]["MarkCreateRequest"];+export type SchemaMarkPatchRequest = components["schemas"]["MarkPatchRequest"];+export type SchemaMarkSuggestionRequest =+ components["schemas"]["MarkSuggestionRequest"];export type SchemaMasteryCardAnswer =components["schemas"]["MasteryCardAnswer"];export type SchemaMasteryCardSkip = components["schemas"]["MasteryCardSkip"];@@ -16476,6 +16935,8 @@ export type SchemaQuizResultsRequest =export type SchemaReactEditRequest = components["schemas"]["ReactEditRequest"];export type SchemaReactEditResponse =components["schemas"]["ReactEditResponse"];+export type SchemaReadAloudAudioPayload =+ components["schemas"]["ReadAloudAudioPayload"];export type SchemaReadingActivityRecord =components["schemas"]["ReadingActivityRecord"];export type SchemaReadingLearningRecords =@@ -16667,6 +17128,8 @@ export type SchemaWorkspaceResources =export type SchemaWorkspaceUpdateRequest =components["schemas"]["WorkspaceUpdateRequest"];export type SchemaYouTubeSettings = components["schemas"]["YouTubeSettings"];+export type SchemaZimArticleImportRequest =+ components["schemas"]["ZimArticleImportRequest"];export type $defs = Record<string, never>;export interface operations {readonly root__get: {@@ -21491,6 +21954,42 @@ export interface operations {};};};+ readonly serve_kb_visual_asset_api_knowledge_bases__kb_name__visual_assets__asset_id__get: {+ readonly parameters: {+ readonly query?: never;+ readonly header?: {+ readonly Authorization?: string | null;+ };+ readonly path: {+ readonly asset_id: string;+ readonly kb_name: string;+ };+ readonly cookie?: {+ readonly dt_token?: string | null;+ };+ };+ readonly requestBody?: never;+ readonly responses: {+ /** @description Successful Response */+ readonly 200: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": unknown;+ };+ };+ /** @description Validation Error */+ readonly 422: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": components["schemas"]["HTTPValidationError"];+ };+ };+ };+ };readonly add_web_source_api_knowledge_bases__kb_name__web_source_post: {readonly parameters: {readonly query?: never;@@ -21637,6 +22136,42 @@ export interface operations {};};};+ readonly get_web_source_pairings_api_knowledge_bases__kb_name__web_source__source_id__pairings_get: {+ readonly parameters: {+ readonly query?: never;+ readonly header?: {+ readonly Authorization?: string | null;+ };+ readonly path: {+ readonly kb_name: string;+ readonly source_id: string;+ };+ readonly cookie?: {+ readonly dt_token?: string | null;+ };+ };+ readonly requestBody?: never;+ readonly responses: {+ /** @description Successful Response */+ readonly 200: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": readonly components["schemas"]["BilingualPairingInfo"][];+ };+ };+ /** @description Validation Error */+ readonly 422: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": components["schemas"]["HTTPValidationError"];+ };+ };+ };+ };readonly retry_web_source_sync_api_knowledge_bases__kb_name__web_source__source_id__retry_post: {readonly parameters: {readonly query?: never;@@ -21888,6 +22423,45 @@ export interface operations {};};};+ readonly connect_kiwix_route_api_knowledge_bases_connect_kiwix_post: {+ readonly parameters: {+ readonly query?: never;+ readonly header?: {+ readonly Authorization?: string | null;+ };+ readonly path?: never;+ readonly cookie?: {+ readonly dt_token?: string | null;+ };+ };+ readonly requestBody: {+ readonly content: {+ readonly "application/json": components["schemas"]["ConnectKiwixRequest"];+ };+ };+ readonly responses: {+ /** @description Successful Response */+ readonly 200: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": {+ readonly [key: string]: unknown;+ };+ };+ };+ /** @description Validation Error */+ readonly 422: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": components["schemas"]["HTTPValidationError"];+ };+ };+ };+ };readonly connect_lightrag_server_route_api_knowledge_bases_connect_lightrag_server_post: {readonly parameters: {readonly query?: never;@@ -22207,9 +22781,12 @@ export interface operations {};};};- readonly list_ima_route_api_knowledge_bases_list_ima_post: {+ readonly search_kiwix_articles_api_knowledge_bases_kiwix_articles_get: {readonly parameters: {- readonly query?: never;+ readonly query: {+ readonly kb_ref: string;+ readonly q: string;+ };readonly header?: {readonly Authorization?: string | null;};@@ -22218,11 +22795,45 @@ export interface operations {readonly dt_token?: string | null;};};- readonly requestBody: {- readonly content: {- readonly "application/json": components["schemas"]["ListImaRequest"];+ readonly requestBody?: never;+ readonly responses: {+ /** @description Successful Response */+ readonly 200: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": {+ readonly [key: string]: unknown;+ };+ };+ };+ /** @description Validation Error */+ readonly 422: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": components["schemas"]["HTTPValidationError"];+ };+ };+ };+ };+ readonly list_kiwix_catalog_api_knowledge_bases_kiwix_catalog_get: {+ readonly parameters: {+ readonly query: {+ readonly q?: string;+ readonly server_url: string;+ };+ readonly header?: {+ readonly Authorization?: string | null;+ };+ readonly path?: never;+ readonly cookie?: {+ readonly dt_token?: string | null;};};+ readonly requestBody?: never;readonly responses: {/** @description Successful Response */readonly 200: {@@ -22230,7 +22841,9 @@ export interface operations {readonly [name: string]: unknown;};content: {- readonly "application/json": components["schemas"]["ListImaResponse"];+ readonly "application/json": {+ readonly [key: string]: unknown;+ };};};/** @description Validation Error */@@ -22244,7 +22857,7 @@ export interface operations {};};};- readonly probe_linked_folder_route_api_knowledge_bases_probe_folder_post: {+ readonly list_ima_route_api_knowledge_bases_list_ima_post: {readonly parameters: {readonly query?: never;readonly header?: {@@ -22257,7 +22870,7 @@ export interface operations {};readonly requestBody: {readonly content: {- readonly "application/json": components["schemas"]["ProbeFolderRequest"];+ readonly "application/json": components["schemas"]["ListImaRequest"];};};readonly responses: {@@ -22267,7 +22880,7 @@ export interface operations {readonly [name: string]: unknown;};content: {- readonly "application/json": unknown;+ readonly "application/json": components["schemas"]["ListImaResponse"];};};/** @description Validation Error */@@ -22281,7 +22894,7 @@ export interface operations {};};};- readonly probe_ima_route_api_knowledge_bases_probe_ima_post: {+ readonly probe_linked_folder_route_api_knowledge_bases_probe_folder_post: {readonly parameters: {readonly query?: never;readonly header?: {@@ -22294,7 +22907,7 @@ export interface operations {};readonly requestBody: {readonly content: {- readonly "application/json": components["schemas"]["ProbeImaRequest"];+ readonly "application/json": components["schemas"]["ProbeFolderRequest"];};};readonly responses: {@@ -22318,7 +22931,7 @@ export interface operations {};};};- readonly probe_lightrag_server_route_api_knowledge_bases_probe_lightrag_server_post: {+ readonly probe_ima_route_api_knowledge_bases_probe_ima_post: {readonly parameters: {readonly query?: never;readonly header?: {@@ -22331,7 +22944,7 @@ export interface operations {};readonly requestBody: {readonly content: {- readonly "application/json": components["schemas"]["ProbeLightRagServerRequest"];+ readonly "application/json": components["schemas"]["ProbeImaRequest"];};};readonly responses: {@@ -22355,7 +22968,7 @@ export interface operations {};};};- readonly probe_weknora_route_api_knowledge_bases_probe_weknora_post: {+ readonly probe_kiwix_route_api_knowledge_bases_probe_kiwix_post: {readonly parameters: {readonly query?: never;readonly header?: {@@ -22368,7 +22981,7 @@ export interface operations {};readonly requestBody: {readonly content: {- readonly "application/json": components["schemas"]["ProbeWeKnoraRequest"];+ readonly "application/json": components["schemas"]["KiwixConnectionRequest"];};};readonly responses: {@@ -22378,7 +22991,9 @@ export interface operations {readonly [name: string]: unknown;};content: {- readonly "application/json": unknown;+ readonly "application/json": {+ readonly [key: string]: unknown;+ };};};/** @description Validation Error */@@ -22392,20 +23007,22 @@ export interface operations {};};};- readonly get_rag_pipeline_preflight_api_knowledge_bases_rag_pipelines__provider__preflight_get: {+ readonly probe_lightrag_server_route_api_knowledge_bases_probe_lightrag_server_post: {readonly parameters: {readonly query?: never;readonly header?: {readonly Authorization?: string | null;};- readonly path: {- readonly provider: string;- };+ readonly path?: never;readonly cookie?: {readonly dt_token?: string | null;};};- readonly requestBody?: never;+ readonly requestBody: {+ readonly content: {+ readonly "application/json": components["schemas"]["ProbeLightRagServerRequest"];+ };+ };readonly responses: {/** @description Successful Response */readonly 200: {@@ -22427,7 +23044,7 @@ export interface operations {};};};- readonly set_rag_active_model_api_knowledge_bases_rag_pipelines_active_model_put: {+ readonly probe_weknora_route_api_knowledge_bases_probe_weknora_post: {readonly parameters: {readonly query?: never;readonly header?: {@@ -22440,7 +23057,79 @@ export interface operations {};readonly requestBody: {readonly content: {- readonly "application/json": components["schemas"]["ActiveModelUpdate"];+ readonly "application/json": components["schemas"]["ProbeWeKnoraRequest"];+ };+ };+ readonly responses: {+ /** @description Successful Response */+ readonly 200: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": unknown;+ };+ };+ /** @description Validation Error */+ readonly 422: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": components["schemas"]["HTTPValidationError"];+ };+ };+ };+ };+ readonly get_rag_pipeline_preflight_api_knowledge_bases_rag_pipelines__provider__preflight_get: {+ readonly parameters: {+ readonly query?: never;+ readonly header?: {+ readonly Authorization?: string | null;+ };+ readonly path: {+ readonly provider: string;+ };+ readonly cookie?: {+ readonly dt_token?: string | null;+ };+ };+ readonly requestBody?: never;+ readonly responses: {+ /** @description Successful Response */+ readonly 200: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": unknown;+ };+ };+ /** @description Validation Error */+ readonly 422: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": components["schemas"]["HTTPValidationError"];+ };+ };+ };+ };+ readonly set_rag_active_model_api_knowledge_bases_rag_pipelines_active_model_put: {+ readonly parameters: {+ readonly query?: never;+ readonly header?: {+ readonly Authorization?: string | null;+ };+ readonly path?: never;+ readonly cookie?: {+ readonly dt_token?: string | null;+ };+ };+ readonly requestBody: {+ readonly content: {+ readonly "application/json": components["schemas"]["ActiveModelUpdate"];};};readonly responses: {@@ -30428,6 +31117,45 @@ export interface operations {};};};+ readonly import_zim_article_api_reading_library_import_zim_article_post: {+ readonly parameters: {+ readonly query?: never;+ readonly header?: {+ readonly Authorization?: string | null;+ };+ readonly path?: never;+ readonly cookie?: {+ readonly dt_token?: string | null;+ };+ };+ readonly requestBody: {+ readonly content: {+ readonly "application/json": components["schemas"]["ZimArticleImportRequest"];+ };+ };+ readonly responses: {+ /** @description Successful Response */+ readonly 200: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": {+ readonly [key: string]: unknown;+ };+ };+ };+ /** @description Validation Error */+ readonly 422: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": components["schemas"]["HTTPValidationError"];+ };+ };+ };+ };readonly list_library_materials_api_reading_library_materials_get: {readonly parameters: {readonly query?: {@@ -31176,6 +31904,43 @@ export interface operations {};};};+ readonly list_quiz_rewards_api_reading_materials__material_id__quiz_rewards_get: {+ readonly parameters: {+ readonly query?: never;+ readonly header?: {+ readonly Authorization?: string | null;+ };+ readonly path: {+ readonly material_id: string;+ };+ readonly cookie?: {+ readonly dt_token?: string | null;+ };+ };+ readonly requestBody?: never;+ readonly responses: {+ /** @description Successful Response */+ readonly 200: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": {+ readonly [key: string]: unknown;+ };+ };+ };+ /** @description Validation Error */+ readonly 422: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": components["schemas"]["HTTPValidationError"];+ };+ };+ };+ };readonly get_raw_api_reading_materials__material_id__raw_get: {readonly parameters: {readonly query?: never;@@ -31211,6 +31976,45 @@ export interface operations {};};};+ readonly read_material_aloud_api_reading_materials__material_id__read_aloud_post: {+ readonly parameters: {+ readonly query?: never;+ readonly header?: {+ readonly Authorization?: string | null;+ };+ readonly path: {+ readonly material_id: string;+ };+ readonly cookie?: {+ readonly dt_token?: string | null;+ };+ };+ readonly requestBody: {+ readonly content: {+ readonly "application/json": components["schemas"]["ReadAloudAudioPayload"];+ };+ };+ readonly responses: {+ /** @description Successful Response */+ readonly 200: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": unknown;+ };+ };+ /** @description Validation Error */+ readonly 422: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": components["schemas"]["HTTPValidationError"];+ };+ };+ };+ };readonly get_render_api_reading_materials__material_id__render_get: {readonly parameters: {readonly query?: never;@@ -35963,6 +36767,84 @@ export interface operations {};};};+ readonly move_knowledge_base_api_settings_workspace_knowledge_bases_move_post: {+ readonly parameters: {+ readonly query?: never;+ readonly header?: {+ readonly Authorization?: string | null;+ };+ readonly path?: never;+ readonly cookie?: {+ readonly dt_token?: string | null;+ };+ };+ readonly requestBody: {+ readonly content: {+ readonly "application/json": components["schemas"]["KnowledgeMovePayload"];+ };+ };+ readonly responses: {+ /** @description Successful Response */+ readonly 200: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": {+ readonly [key: string]: unknown;+ };+ };+ };+ /** @description Validation Error */+ readonly 422: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": components["schemas"]["HTTPValidationError"];+ };+ };+ };+ };+ readonly preview_knowledge_move_api_settings_workspace_knowledge_bases_preview_move_post: {+ readonly parameters: {+ readonly query?: never;+ readonly header?: {+ readonly Authorization?: string | null;+ };+ readonly path?: never;+ readonly cookie?: {+ readonly dt_token?: string | null;+ };+ };+ readonly requestBody: {+ readonly content: {+ readonly "application/json": components["schemas"]["KnowledgeMovePayload"];+ };+ };+ readonly responses: {+ /** @description Successful Response */+ readonly 200: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": {+ readonly [key: string]: unknown;+ };+ };+ };+ /** @description Validation Error */+ readonly 422: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": components["schemas"]["HTTPValidationError"];+ };+ };+ };+ };readonly list_workspaces_api_settings_workspace_registrations_get: {readonly parameters: {readonly query?: never;@@ -38359,6 +39241,243 @@ export interface operations {};};};+ readonly suggest_video_marks_api_video_learning_materials__material_id__mark_suggestions_post: {+ readonly parameters: {+ readonly query?: never;+ readonly header?: {+ readonly Authorization?: string | null;+ };+ readonly path: {+ readonly material_id: string;+ };+ readonly cookie?: {+ readonly dt_token?: string | null;+ };+ };+ readonly requestBody: {+ readonly content: {+ readonly "application/json": components["schemas"]["MarkSuggestionRequest"];+ };+ };+ readonly responses: {+ /** @description Successful Response */+ readonly 200: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": {+ readonly [key: string]: unknown;+ };+ };+ };+ /** @description Validation Error */+ readonly 422: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": components["schemas"]["HTTPValidationError"];+ };+ };+ };+ };+ readonly list_video_marks_api_video_learning_materials__material_id__marks_get: {+ readonly parameters: {+ readonly query?: never;+ readonly header?: {+ readonly Authorization?: string | null;+ };+ readonly path: {+ readonly material_id: string;+ };+ readonly cookie?: {+ readonly dt_token?: string | null;+ };+ };+ readonly requestBody?: never;+ readonly responses: {+ /** @description Successful Response */+ readonly 200: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": readonly {+ readonly [key: string]: unknown;+ }[];+ };+ };+ /** @description Validation Error */+ readonly 422: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": components["schemas"]["HTTPValidationError"];+ };+ };+ };+ };+ readonly create_video_mark_api_video_learning_materials__material_id__marks_post: {+ readonly parameters: {+ readonly query?: never;+ readonly header?: {+ readonly Authorization?: string | null;+ };+ readonly path: {+ readonly material_id: string;+ };+ readonly cookie?: {+ readonly dt_token?: string | null;+ };+ };+ readonly requestBody: {+ readonly content: {+ readonly "application/json": components["schemas"]["MarkCreateRequest"];+ };+ };+ readonly responses: {+ /** @description Successful Response */+ readonly 201: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": {+ readonly [key: string]: unknown;+ };+ };+ };+ /** @description Validation Error */+ readonly 422: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": components["schemas"]["HTTPValidationError"];+ };+ };+ };+ };+ readonly get_video_mark_api_video_learning_materials__material_id__marks__mark_id__get: {+ readonly parameters: {+ readonly query?: never;+ readonly header?: {+ readonly Authorization?: string | null;+ };+ readonly path: {+ readonly mark_id: string;+ readonly material_id: string;+ };+ readonly cookie?: {+ readonly dt_token?: string | null;+ };+ };+ readonly requestBody?: never;+ readonly responses: {+ /** @description Successful Response */+ readonly 200: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": {+ readonly [key: string]: unknown;+ };+ };+ };+ /** @description Validation Error */+ readonly 422: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": components["schemas"]["HTTPValidationError"];+ };+ };+ };+ };+ readonly delete_video_mark_api_video_learning_materials__material_id__marks__mark_id__delete: {+ readonly parameters: {+ readonly query?: never;+ readonly header?: {+ readonly Authorization?: string | null;+ };+ readonly path: {+ readonly mark_id: string;+ readonly material_id: string;+ };+ readonly cookie?: {+ readonly dt_token?: string | null;+ };+ };+ readonly requestBody?: never;+ readonly responses: {+ /** @description Successful Response */+ readonly 200: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": {+ readonly [key: string]: boolean;+ };+ };+ };+ /** @description Validation Error */+ readonly 422: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": components["schemas"]["HTTPValidationError"];+ };+ };+ };+ };+ readonly update_video_mark_api_video_learning_materials__material_id__marks__mark_id__patch: {+ readonly parameters: {+ readonly query?: never;+ readonly header?: {+ readonly Authorization?: string | null;+ };+ readonly path: {+ readonly mark_id: string;+ readonly material_id: string;+ };+ readonly cookie?: {+ readonly dt_token?: string | null;+ };+ };+ readonly requestBody: {+ readonly content: {+ readonly "application/json": components["schemas"]["MarkPatchRequest"];+ };+ };+ readonly responses: {+ /** @description Successful Response */+ readonly 200: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": {+ readonly [key: string]: unknown;+ };+ };+ };+ /** @description Validation Error */+ readonly 422: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": components["schemas"]["HTTPValidationError"];+ };+ };+ };+ };readonly list_video_notes_api_video_learning_materials__material_id__notes_get: {readonly parameters: {readonly query?: never;diff --git a/web/contracts/schema/openapi.json b/web/contracts/schema/openapi.jsonindex 0b18a5069..4665e4c46 100644--- a/web/contracts/schema/openapi.json+++ b/web/contracts/schema/openapi.json@@ -571,7 +571,7 @@"llm_selection": {"anyOf": [{- "$ref": "#/components/schemas/LLMSelectionPayload"+ "$ref": "#/components/schemas/deeptutor__api__routers__memory__LLMSelectionPayload"},{"type": "null"@@ -674,6 +674,16 @@},"AutoMarkRequest": {"properties": {+ "llm_selection": {+ "anyOf": [+ {+ "$ref": "#/components/schemas/deeptutor__api__routers__co_writer__LLMSelectionPayload"+ },+ {+ "type": "null"+ }+ ]+ },"text": {"maxLength": 600000,"title": "Text",@@ -704,6 +714,59 @@"title": "AutoMarkResponse","type": "object"},+ "BilingualPairingInfo": {+ "properties": {+ "pairing_id": {+ "title": "Pairing Id",+ "type": "string"+ },+ "pairing_method": {+ "default": "hreflang",+ "title": "Pairing Method",+ "type": "string"+ },+ "source_file": {+ "default": "",+ "title": "Source File",+ "type": "string"+ },+ "source_lang": {+ "default": "",+ "title": "Source Lang",+ "type": "string"+ },+ "source_url": {+ "title": "Source Url",+ "type": "string"+ },+ "target_file": {+ "default": "",+ "title": "Target File",+ "type": "string"+ },+ "target_lang": {+ "default": "",+ "title": "Target Lang",+ "type": "string"+ },+ "target_url": {+ "title": "Target Url",+ "type": "string"+ },+ "updated_at": {+ "default": 0,+ "title": "Updated At",+ "type": "integer"+ }+ },+ "required": [+ "pairing_id",+ "source_url",+ "target_url"+ ],+ "title": "BilingualPairingInfo",+ "type": "object"+ },"Body_admin_import_users_api_auth_users_import_post": {"properties": {"file": {@@ -764,6 +827,17 @@"default": "","title": "Search Mode","type": "string"+ },+ "storage_workspace_id": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Storage Workspace Id"}},"required": [@@ -2036,6 +2110,29 @@"title": "ConnectImaRequest","type": "object"},+ "ConnectKiwixRequest": {+ "properties": {+ "name": {+ "title": "Name",+ "type": "string"+ },+ "server_url": {+ "title": "Server Url",+ "type": "string"+ },+ "zim_name": {+ "title": "Zim Name",+ "type": "string"+ }+ },+ "required": [+ "server_url",+ "zim_name",+ "name"+ ],+ "title": "ConnectKiwixRequest",+ "type": "object"+ },"ConnectLightRagServerRequest": {"properties": {"api_key": {@@ -2859,7 +2956,7 @@"llm_selection": {"anyOf": [{- "$ref": "#/components/schemas/LLMSelectionPayload"+ "$ref": "#/components/schemas/deeptutor__api__routers__memory__LLMSelectionPayload"},{"type": "null"@@ -3334,6 +3431,16 @@],"title": "Kb Name"},+ "llm_selection": {+ "anyOf": [+ {+ "$ref": "#/components/schemas/deeptutor__api__routers__co_writer__LLMSelectionPayload"+ },+ {+ "type": "null"+ }+ ]+ },"source": {"anyOf": [{@@ -4297,6 +4404,24 @@"title": "InvidiousSettings","type": "object"},+ "KiwixConnectionRequest": {+ "properties": {+ "server_url": {+ "title": "Server Url",+ "type": "string"+ },+ "zim_name": {+ "title": "Zim Name",+ "type": "string"+ }+ },+ "required": [+ "server_url",+ "zim_name"+ ],+ "title": "KiwixConnectionRequest",+ "type": "object"+ },"KnowledgeBaseInfo": {"properties": {"assigned": {@@ -4415,6 +4540,25 @@"title": "KnowledgeBaseInfo","type": "object"},+ "KnowledgeMovePayload": {+ "properties": {+ "source_id": {+ "minLength": 1,+ "title": "Source Id",+ "type": "string"+ },+ "target_workspace_id": {+ "default": "",+ "title": "Target Workspace Id",+ "type": "string"+ }+ },+ "required": [+ "source_id"+ ],+ "title": "KnowledgeMovePayload",+ "type": "object"+ },"KnowledgePointInput": {"properties": {"client_ref": {@@ -4512,24 +4656,6 @@"title": "LLMSelection","type": "object"},- "LLMSelectionPayload": {- "properties": {- "model_id": {- "title": "Model Id",- "type": "string"- },- "profile_id": {- "title": "Profile Id",- "type": "string"- }- },- "required": [- "profile_id",- "model_id"- ],- "title": "LLMSelectionPayload",- "type": "object"- },"LanguageUpdate": {"properties": {"language": {@@ -4538,7 +4664,8 @@"zh","fr","de",- "uk"+ "uk",+ "pl"],"title": "Language","type": "string"@@ -5550,6 +5677,192 @@"title": "ManagedUpdateRequest","type": "object"},+ "MarkCreateRequest": {+ "properties": {+ "end_locator": {+ "default": 0,+ "minimum": 0.0,+ "title": "End Locator",+ "type": "integer"+ },+ "end_seconds": {+ "maximum": 86400.0,+ "minimum": 0.0,+ "title": "End Seconds",+ "type": "number"+ },+ "kind": {+ "maxLength": 32,+ "minLength": 1,+ "title": "Kind",+ "type": "string"+ },+ "metadata": {+ "additionalProperties": true,+ "title": "Metadata",+ "type": "object"+ },+ "note": {+ "default": "",+ "maxLength": 2000,+ "title": "Note",+ "type": "string"+ },+ "quote": {+ "default": "",+ "maxLength": 4000,+ "title": "Quote",+ "type": "string"+ },+ "start_locator": {+ "default": 0,+ "minimum": 0.0,+ "title": "Start Locator",+ "type": "integer"+ },+ "start_seconds": {+ "maximum": 86400.0,+ "minimum": 0.0,+ "title": "Start Seconds",+ "type": "number"+ }+ },+ "required": [+ "kind",+ "start_seconds",+ "end_seconds"+ ],+ "title": "MarkCreateRequest",+ "type": "object"+ },+ "MarkPatchRequest": {+ "properties": {+ "end_locator": {+ "anyOf": [+ {+ "minimum": 0.0,+ "type": "integer"+ },+ {+ "type": "null"+ }+ ],+ "title": "End Locator"+ },+ "end_seconds": {+ "anyOf": [+ {+ "maximum": 86400.0,+ "minimum": 0.0,+ "type": "number"+ },+ {+ "type": "null"+ }+ ],+ "title": "End Seconds"+ },+ "kind": {+ "anyOf": [+ {+ "maxLength": 32,+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Kind"+ },+ "metadata": {+ "anyOf": [+ {+ "additionalProperties": true,+ "type": "object"+ },+ {+ "type": "null"+ }+ ],+ "title": "Metadata"+ },+ "note": {+ "anyOf": [+ {+ "maxLength": 2000,+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Note"+ },+ "quote": {+ "anyOf": [+ {+ "maxLength": 4000,+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Quote"+ },+ "reviewed": {+ "anyOf": [+ {+ "type": "boolean"+ },+ {+ "type": "null"+ }+ ],+ "title": "Reviewed"+ },+ "start_locator": {+ "anyOf": [+ {+ "minimum": 0.0,+ "type": "integer"+ },+ {+ "type": "null"+ }+ ],+ "title": "Start Locator"+ },+ "start_seconds": {+ "anyOf": [+ {+ "maximum": 86400.0,+ "minimum": 0.0,+ "type": "number"+ },+ {+ "type": "null"+ }+ ],+ "title": "Start Seconds"+ }+ },+ "title": "MarkPatchRequest",+ "type": "object"+ },+ "MarkSuggestionRequest": {+ "properties": {+ "time_seconds": {+ "default": 0.0,+ "maximum": 86400.0,+ "minimum": 0.0,+ "title": "Time Seconds",+ "type": "number"+ }+ },+ "title": "MarkSuggestionRequest",+ "type": "object"+ },"MasteryCardAnswer": {"additionalProperties": false,"description": "An answer submitted from a mastery question card.\n\nThe card outlives the turn that posed it — posing a question ends that\nturn — so the answer arrives as the next turn's message. This says which\nquestion the message is answering, letting the runtime commit it to the\nengine before the tutor's first token instead of asking the model to\nrecover the pairing from prose.",@@ -7701,6 +8014,16 @@],"title": "Kb Name"},+ "llm_selection": {+ "anyOf": [+ {+ "$ref": "#/components/schemas/deeptutor__api__routers__co_writer__LLMSelectionPayload"+ },+ {+ "type": "null"+ }+ ]+ },"mode": {"default": "rewrite","enum": [@@ -7762,6 +8085,20 @@"title": "ReactEditResponse","type": "object"},+ "ReadAloudAudioPayload": {+ "properties": {+ "locator": {+ "minimum": 1.0,+ "title": "Locator",+ "type": "integer"+ }+ },+ "required": [+ "locator"+ ],+ "title": "ReadAloudAudioPayload",+ "type": "object"+ },"ReadingActivityRecord": {"description": "One successful Reading-extension action, without source content.","properties": {@@ -8425,7 +8762,7 @@"llm_selection": {"anyOf": [{- "$ref": "#/components/schemas/LLMSelectionPayload"+ "$ref": "#/components/schemas/deeptutor__api__routers__memory__LLMSelectionPayload"},{"type": "null"@@ -10788,7 +11125,8 @@"zh","fr","de",- "uk"+ "uk",+ "pl"],"type": "string"},@@ -11576,7 +11914,7 @@"llm_selection": {"anyOf": [{- "$ref": "#/components/schemas/LLMSelectionPayload"+ "$ref": "#/components/schemas/deeptutor__api__routers__memory__LLMSelectionPayload"},{"type": "null"@@ -12303,6 +12641,14 @@"title": "Auto Sync Enabled","type": "boolean"},+ "bilingual_pairings": {+ "items": {+ "additionalProperties": true,+ "type": "object"+ },+ "title": "Bilingual Pairings",+ "type": "array"+ },"enabled": {"default": true,"title": "Enabled",@@ -12684,6 +13030,39 @@"title": "YouTubeSettings","type": "object"},+ "ZimArticleImportRequest": {+ "properties": {+ "article_path": {+ "maxLength": 2048,+ "minLength": 1,+ "title": "Article Path",+ "type": "string"+ },+ "kb_ref": {+ "maxLength": 300,+ "minLength": 1,+ "title": "Kb Ref",+ "type": "string"+ },+ "title": {+ "default": "",+ "maxLength": 300,+ "title": "Title",+ "type": "string"+ },+ "workspace_id": {+ "default": "",+ "title": "Workspace Id",+ "type": "string"+ }+ },+ "required": [+ "kb_ref",+ "article_path"+ ],+ "title": "ZimArticleImportRequest",+ "type": "object"+ },"deeptutor__api__routers__book__ProgressRequest": {"properties": {"book_id": {@@ -12702,6 +13081,54 @@"title": "ProgressRequest","type": "object"},+ "deeptutor__api__routers__co_writer__LLMSelectionPayload": {+ "additionalProperties": false,+ "properties": {+ "model_id": {+ "title": "Model Id",+ "type": "string"+ },+ "profile_id": {+ "title": "Profile Id",+ "type": "string"+ },+ "reasoning_effort": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Reasoning Effort"+ }+ },+ "required": [+ "profile_id",+ "model_id"+ ],+ "title": "LLMSelectionPayload",+ "type": "object"+ },+ "deeptutor__api__routers__memory__LLMSelectionPayload": {+ "properties": {+ "model_id": {+ "title": "Model Id",+ "type": "string"+ },+ "profile_id": {+ "title": "Profile Id",+ "type": "string"+ }+ },+ "required": [+ "profile_id",+ "model_id"+ ],+ "title": "LLMSelectionPayload",+ "type": "object"+ },"deeptutor__api__routers__video_learning__ProgressRequest": {"properties": {"duration_seconds": {@@ -20710,10 +21137,10 @@]}},- "/api/knowledge-bases/connect-lightrag-server": {+ "/api/knowledge-bases/connect-kiwix": {"post": {- "description": "Connect an external LightRAG server as a retrieval-only knowledge base.\n\nRe-probes server-side (never trusts the client's verdict), then registers a\npointer (``type: lightrag_server``). Retrieval is offloaded to the server's\n``/query`` endpoint — no copy, no local index.",- "operationId": "connect_lightrag_server_route_api_knowledge_bases_connect_lightrag_server_post",+ "description": "Bind a KB to a kiwix-serve archive; no ingest or index is created.",+ "operationId": "connect_kiwix_route_api_knowledge_bases_connect_kiwix_post","parameters": [{"in": "header",@@ -20752,7 +21179,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/ConnectLightRagServerRequest"+ "$ref": "#/components/schemas/ConnectKiwixRequest"}}},@@ -20762,7 +21189,11 @@"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": true,+ "title": "Response Connect Kiwix Route Api Knowledge Bases Connect Kiwix Post",+ "type": "object"+ }}},"description": "Successful Response"@@ -20778,16 +21209,16 @@"description": "Validation Error"}},- "summary": "Connect Lightrag Server Route",+ "summary": "Connect Kiwix Route","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/connect-marginnote4": {+ "/api/knowledge-bases/connect-lightrag-server": {"post": {- "description": "Register a connected MarginNote 4 library as a knowledge base.\n\nCreates a ``type: marginnote4`` pointer so the MarginNote capability can\nbind to it on turns where the user selects this KB. When ``db_path`` is\nomitted the capability derives a default SQLite path from the KB name.",- "operationId": "connect_marginnote4_api_knowledge_bases_connect_marginnote4_post",+ "description": "Connect an external LightRAG server as a retrieval-only knowledge base.\n\nRe-probes server-side (never trusts the client's verdict), then registers a\npointer (``type: lightrag_server``). Retrieval is offloaded to the server's\n``/query`` endpoint — no copy, no local index.",+ "operationId": "connect_lightrag_server_route_api_knowledge_bases_connect_lightrag_server_post","parameters": [{"in": "header",@@ -20826,7 +21257,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/ConnectMarginNote4Request"+ "$ref": "#/components/schemas/ConnectLightRagServerRequest"}}},@@ -20852,16 +21283,16 @@"description": "Validation Error"}},- "summary": "Connect Marginnote4",+ "summary": "Connect Lightrag Server Route","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/connect-obsidian": {+ "/api/knowledge-bases/connect-marginnote4": {"post": {- "description": "Connect an existing Obsidian vault as a knowledge base.\n\nRegisters a pointer to the user's vault directory (``type: obsidian``) — no\nupload, no index. The vault must be a directory the server can reach (i.e. a\nlocal/self-hosted deployment); the Obsidian capability reads it live.",- "operationId": "connect_obsidian_vault_api_knowledge_bases_connect_obsidian_post",+ "description": "Register a connected MarginNote 4 library as a knowledge base.\n\nCreates a ``type: marginnote4`` pointer so the MarginNote capability can\nbind to it on turns where the user selects this KB. When ``db_path`` is\nomitted the capability derives a default SQLite path from the KB name.",+ "operationId": "connect_marginnote4_api_knowledge_bases_connect_marginnote4_post","parameters": [{"in": "header",@@ -20900,7 +21331,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/ConnectObsidianRequest"+ "$ref": "#/components/schemas/ConnectMarginNote4Request"}}},@@ -20926,16 +21357,16 @@"description": "Validation Error"}},- "summary": "Connect Obsidian Vault",+ "summary": "Connect Marginnote4","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/connect-weknora": {+ "/api/knowledge-bases/connect-obsidian": {"post": {- "description": "Connect a self-hosted WeKnora knowledge base for retrieval only.",- "operationId": "connect_weknora_route_api_knowledge_bases_connect_weknora_post",+ "description": "Connect an existing Obsidian vault as a knowledge base.\n\nRegisters a pointer to the user's vault directory (``type: obsidian``) — no\nupload, no index. The vault must be a directory the server can reach (i.e. a\nlocal/self-hosted deployment); the Obsidian capability reads it live.",+ "operationId": "connect_obsidian_vault_api_knowledge_bases_connect_obsidian_post","parameters": [{"in": "header",@@ -20974,7 +21405,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/ConnectWeKnoraRequest"+ "$ref": "#/components/schemas/ConnectObsidianRequest"}}},@@ -21000,16 +21431,16 @@"description": "Validation Error"}},- "summary": "Connect Weknora Route",+ "summary": "Connect Obsidian Vault","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/default": {- "get": {- "description": "Get the default knowledge base.",- "operationId": "get_default_kb_api_knowledge_bases_default_get",+ "/api/knowledge-bases/connect-weknora": {+ "post": {+ "description": "Connect a self-hosted WeKnora knowledge base for retrieval only.",+ "operationId": "connect_weknora_route_api_knowledge_bases_connect_weknora_post","parameters": [{"in": "header",@@ -21044,6 +21475,16 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/ConnectWeKnoraRequest"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -21064,26 +21505,17 @@"description": "Validation Error"}},- "summary": "Get Default Kb",+ "summary": "Connect Weknora Route","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/default/{kb_name}": {- "put": {- "description": "Set the default knowledge base.",- "operationId": "set_default_kb_api_knowledge_bases_default__kb_name__put",+ "/api/knowledge-bases/default": {+ "get": {+ "description": "Get the default knowledge base.",+ "operationId": "get_default_kb_api_knowledge_bases_default_get","parameters": [- {- "in": "path",- "name": "kb_name",- "required": true,- "schema": {- "title": "Kb Name",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -21137,91 +21569,26 @@"description": "Validation Error"}},- "summary": "Set Default Kb",+ "summary": "Get Default Kb","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/delete": {- "post": {- "description": "Delete a knowledge base named in the body rather than in the path.\n\nThe path route below cannot reach every registered name. A name is a\n``kb_config.json`` key, and until the ``register_*`` methods validated it\nthe connect-* endpoints wrote whatever the user typed — including a ``/``.\nuvicorn percent-decodes the path before routing, so ``%2F`` becomes a real\nseparator and ``{kb_name}`` (compiled to ``[^/]+``) cannot span it: every\nper-KB route 404s and the KB is visible in the list but unreachable.\n\nA body is never split into path segments, so this reaches those entries.\nWidening the path route to ``{kb_name:path}`` would not do — it is\ndeclared ahead of the DELETE routes for linked folders, GitHub sources and\nweb sources, and a greedy converter would silently swallow all three.",- "operationId": "delete_knowledge_base_by_name_api_knowledge_bases_delete_post",+ "/api/knowledge-bases/default/{kb_name}": {+ "put": {+ "description": "Set the default knowledge base.",+ "operationId": "set_default_kb_api_knowledge_bases_default__kb_name__put","parameters": [{- "in": "header",- "name": "Authorization",- "required": false,- "schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Authorization"- }- },- {- "in": "cookie",- "name": "dt_token",- "required": false,+ "in": "path",+ "name": "kb_name",+ "required": true,"schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Dt Token"- }- }- ],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/DeleteKnowledgeBaseRequest"- }+ "title": "Kb Name",+ "type": "string"}},- "required": true- },- "responses": {- "200": {- "content": {- "application/json": {- "schema": {}- }- },- "description": "Successful Response"- },- "422": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- },- "description": "Validation Error"- }- },- "summary": "Delete Knowledge Base By Name",- "tags": [- "knowledge-bases"- ]- }- },- "/api/knowledge-bases/embedding-usage": {- "get": {- "description": "References in this account's workspaces; no provider secrets or other users' KBs.",- "operationId": "get_embedding_usage_api_knowledge_bases_embedding_usage_get",- "parameters": [{"in": "header","name": "Authorization",@@ -21275,16 +21642,16 @@"description": "Validation Error"}},- "summary": "Get Embedding Usage",+ "summary": "Set Default Kb","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/health": {- "get": {- "description": "Health check endpoint",- "operationId": "health_check_api_knowledge_bases_health_get",+ "/api/knowledge-bases/delete": {+ "post": {+ "description": "Delete a knowledge base named in the body rather than in the path.\n\nThe path route below cannot reach every registered name. A name is a\n``kb_config.json`` key, and until the ``register_*`` methods validated it\nthe connect-* endpoints wrote whatever the user typed — including a ``/``.\nuvicorn percent-decodes the path before routing, so ``%2F`` becomes a real\nseparator and ``{kb_name}`` (compiled to ``[^/]+``) cannot span it: every\nper-KB route 404s and the KB is visible in the list but unreachable.\n\nA body is never split into path segments, so this reaches those entries.\nWidening the path route to ``{kb_name:path}`` would not do — it is\ndeclared ahead of the DELETE routes for linked folders, GitHub sources and\nweb sources, and a greedy converter would silently swallow all three.",+ "operationId": "delete_knowledge_base_by_name_api_knowledge_bases_delete_post","parameters": [{"in": "header",@@ -21319,6 +21686,16 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/DeleteKnowledgeBaseRequest"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -21339,16 +21716,16 @@"description": "Validation Error"}},- "summary": "Health Check",+ "summary": "Delete Knowledge Base By Name","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/list-ima": {- "post": {- "description": "List IMA knowledge bases without storing or echoing credentials.",- "operationId": "list_ima_route_api_knowledge_bases_list_ima_post",+ "/api/knowledge-bases/embedding-usage": {+ "get": {+ "description": "References in this account's workspaces; no provider secrets or other users' KBs.",+ "operationId": "get_embedding_usage_api_knowledge_bases_embedding_usage_get","parameters": [{"in": "header",@@ -21383,23 +21760,11 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/ListImaRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {- "schema": {- "$ref": "#/components/schemas/ListImaResponse"- }+ "schema": {}}},"description": "Successful Response"@@ -21415,16 +21780,16 @@"description": "Validation Error"}},- "summary": "List Ima Route",+ "summary": "Get Embedding Usage","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/probe-folder": {- "post": {- "description": "Inspect a local folder for a ready engine index before linking it.\n\nReturns the probe verdict (ready index? embedding compatible? warnings?) so\nthe UI can present and confirm before any registration happens. Does not\ncreate a knowledge base.",- "operationId": "probe_linked_folder_route_api_knowledge_bases_probe_folder_post",+ "/api/knowledge-bases/health": {+ "get": {+ "description": "Health check endpoint",+ "operationId": "health_check_api_knowledge_bases_health_get","parameters": [{"in": "header",@@ -21459,16 +21824,6 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/ProbeFolderRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {@@ -21489,17 +21844,39 @@"description": "Validation Error"}},- "summary": "Probe Linked Folder Route",+ "summary": "Health Check","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/probe-ima": {- "post": {- "description": "Test-connect to a Tencent IMA knowledge base before binding a KB to it.\n\nReturns the verdict (credentials accepted? does the library id resolve, and\nwhat is it called?) so the UI can confirm before any registration happens.\nCreates nothing.",- "operationId": "probe_ima_route_api_knowledge_bases_probe_ima_post",+ "/api/knowledge-bases/kiwix-articles": {+ "get": {+ "description": "List bounded article matches for Knowledge Center and Reading import.",+ "operationId": "search_kiwix_articles_api_knowledge_bases_kiwix_articles_get","parameters": [+ {+ "in": "query",+ "name": "kb_ref",+ "required": true,+ "schema": {+ "maxLength": 300,+ "minLength": 1,+ "title": "Kb Ref",+ "type": "string"+ }+ },+ {+ "in": "query",+ "name": "q",+ "required": true,+ "schema": {+ "maxLength": 500,+ "minLength": 1,+ "title": "Q",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -21533,21 +21910,105 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/ProbeImaRequest"+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {+ "additionalProperties": true,+ "title": "Response Search Kiwix Articles Api Knowledge Bases Kiwix Articles Get",+ "type": "object"+ }}- }+ },+ "description": "Successful Response"},- "required": true+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }},+ "summary": "Search Kiwix Articles",+ "tags": [+ "knowledge-bases"+ ]+ }+ },+ "/api/knowledge-bases/kiwix-catalog": {+ "get": {+ "description": "List exact ZIM names from legacy OPDS; v2 can omit loaded archives.",+ "operationId": "list_kiwix_catalog_api_knowledge_bases_kiwix_catalog_get",+ "parameters": [+ {+ "in": "query",+ "name": "server_url",+ "required": true,+ "schema": {+ "maxLength": 2048,+ "minLength": 1,+ "title": "Server Url",+ "type": "string"+ }+ },+ {+ "in": "query",+ "name": "q",+ "required": false,+ "schema": {+ "default": "",+ "maxLength": 100,+ "title": "Q",+ "type": "string"+ }+ },+ {+ "in": "header",+ "name": "Authorization",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"+ }+ },+ {+ "in": "cookie",+ "name": "dt_token",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"+ }+ }+ ],"responses": {"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": true,+ "title": "Response List Kiwix Catalog Api Knowledge Bases Kiwix Catalog Get",+ "type": "object"+ }}},"description": "Successful Response"@@ -21563,16 +22024,16 @@"description": "Validation Error"}},- "summary": "Probe Ima Route",+ "summary": "List Kiwix Catalog","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/probe-lightrag-server": {+ "/api/knowledge-bases/list-ima": {"post": {- "description": "Test-connect to an external LightRAG server before binding a KB to it.\n\nReturns the verdict (reachable? is it a LightRAG server? API key accepted?)\nso the UI can confirm before any registration happens. Creates nothing.",- "operationId": "probe_lightrag_server_route_api_knowledge_bases_probe_lightrag_server_post",+ "description": "List IMA knowledge bases without storing or echoing credentials.",+ "operationId": "list_ima_route_api_knowledge_bases_list_ima_post","parameters": [{"in": "header",@@ -21611,7 +22072,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/ProbeLightRagServerRequest"+ "$ref": "#/components/schemas/ListImaRequest"}}},@@ -21621,7 +22082,9 @@"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "$ref": "#/components/schemas/ListImaResponse"+ }}},"description": "Successful Response"@@ -21637,16 +22100,16 @@"description": "Validation Error"}},- "summary": "Probe Lightrag Server Route",+ "summary": "List Ima Route","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/probe-weknora": {+ "/api/knowledge-bases/probe-folder": {"post": {- "description": "Validate a WeKnora server and knowledge-base binding without registering.",- "operationId": "probe_weknora_route_api_knowledge_bases_probe_weknora_post",+ "description": "Inspect a local folder for a ready engine index before linking it.\n\nReturns the probe verdict (ready index? embedding compatible? warnings?) so\nthe UI can present and confirm before any registration happens. Does not\ncreate a knowledge base.",+ "operationId": "probe_linked_folder_route_api_knowledge_bases_probe_folder_post","parameters": [{"in": "header",@@ -21685,7 +22148,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/ProbeWeKnoraRequest"+ "$ref": "#/components/schemas/ProbeFolderRequest"}}},@@ -21711,16 +22174,16 @@"description": "Validation Error"}},- "summary": "Probe Weknora Route",+ "summary": "Probe Linked Folder Route","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/rag-pipelines/active-model": {- "put": {- "description": "Set the active model for an engine's required kind, applied immediately.\n\nThis is the same active selection the model catalog manages; switching it\nhere affects every engine that uses that kind (the active model is global).",- "operationId": "set_rag_active_model_api_knowledge_bases_rag_pipelines_active_model_put",+ "/api/knowledge-bases/probe-ima": {+ "post": {+ "description": "Test-connect to a Tencent IMA knowledge base before binding a KB to it.\n\nReturns the verdict (credentials accepted? does the library id resolve, and\nwhat is it called?) so the UI can confirm before any registration happens.\nCreates nothing.",+ "operationId": "probe_ima_route_api_knowledge_bases_probe_ima_post","parameters": [{"in": "header",@@ -21759,7 +22222,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/ActiveModelUpdate"+ "$ref": "#/components/schemas/ProbeImaRequest"}}},@@ -21785,16 +22248,16 @@"description": "Validation Error"}},- "summary": "Set Rag Active Model",+ "summary": "Probe Ima Route","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/rag-pipelines/graphrag/config": {- "get": {- "description": "Read GraphRAG's query knobs (response style, community granularity).",- "operationId": "get_graphrag_pipeline_config_api_knowledge_bases_rag_pipelines_graphrag_config_get",+ "/api/knowledge-bases/probe-kiwix": {+ "post": {+ "description": "Verify that one archive is readable without copying its ZIM file.",+ "operationId": "probe_kiwix_route_api_knowledge_bases_probe_kiwix_post","parameters": [{"in": "header",@@ -21829,11 +22292,25 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/KiwixConnectionRequest"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": true,+ "title": "Response Probe Kiwix Route Api Knowledge Bases Probe Kiwix Post",+ "type": "object"+ }}},"description": "Successful Response"@@ -21849,14 +22326,16 @@"description": "Validation Error"}},- "summary": "Get Graphrag Pipeline Config",+ "summary": "Probe Kiwix Route","tags": ["knowledge-bases"]- },- "put": {- "description": "Persist GraphRAG's query knobs. Takes effect on the next query.",- "operationId": "update_graphrag_pipeline_config_api_knowledge_bases_rag_pipelines_graphrag_config_put",+ }+ },+ "/api/knowledge-bases/probe-lightrag-server": {+ "post": {+ "description": "Test-connect to an external LightRAG server before binding a KB to it.\n\nReturns the verdict (reachable? is it a LightRAG server? API key accepted?)\nso the UI can confirm before any registration happens. Creates nothing.",+ "operationId": "probe_lightrag_server_route_api_knowledge_bases_probe_lightrag_server_post","parameters": [{"in": "header",@@ -21895,7 +22374,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/GraphRagConfigUpdate"+ "$ref": "#/components/schemas/ProbeLightRagServerRequest"}}},@@ -21921,16 +22400,16 @@"description": "Validation Error"}},- "summary": "Update Graphrag Pipeline Config",+ "summary": "Probe Lightrag Server Route","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/rag-pipelines/graphrag/model-compatibility": {+ "/api/knowledge-bases/probe-weknora": {"post": {- "description": "Test GraphRAG structured output without changing the active chat model.",- "operationId": "test_graphrag_model_compatibility_api_knowledge_bases_rag_pipelines_graphrag_model_compatibility_post",+ "description": "Validate a WeKnora server and knowledge-base binding without registering.",+ "operationId": "probe_weknora_route_api_knowledge_bases_probe_weknora_post","parameters": [{"in": "header",@@ -21969,7 +22448,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/GraphRagModelCompatibilityRequest"+ "$ref": "#/components/schemas/ProbeWeKnoraRequest"}}},@@ -21995,78 +22474,16 @@"description": "Validation Error"}},- "summary": "Test Graphrag Model Compatibility",+ "summary": "Probe Weknora Route","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/rag-pipelines/ima/config": {- "get": {- "description": "Read the account-level IMA credentials (key redacted to a boolean).",- "operationId": "get_ima_pipeline_config_api_knowledge_bases_rag_pipelines_ima_config_get",- "parameters": [- {- "in": "header",- "name": "Authorization",- "required": false,- "schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Authorization"- }- },- {- "in": "cookie",- "name": "dt_token",- "required": false,- "schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Dt Token"- }- }- ],- "responses": {- "200": {- "content": {- "application/json": {- "schema": {}- }- },- "description": "Successful Response"- },- "422": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- },- "description": "Validation Error"- }- },- "summary": "Get Ima Pipeline Config",- "tags": [- "knowledge-bases"- ]- },+ "/api/knowledge-bases/rag-pipelines/active-model": {"put": {- "description": "Persist the account-level IMA Client ID / API key.",- "operationId": "update_ima_pipeline_config_api_knowledge_bases_rag_pipelines_ima_config_put",+ "description": "Set the active model for an engine's required kind, applied immediately.\n\nThis is the same active selection the model catalog manages; switching it\nhere affects every engine that uses that kind (the active model is global).",+ "operationId": "set_rag_active_model_api_knowledge_bases_rag_pipelines_active_model_put","parameters": [{"in": "header",@@ -22105,7 +22522,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/ImaConfigUpdate"+ "$ref": "#/components/schemas/ActiveModelUpdate"}}},@@ -22131,16 +22548,16 @@"description": "Validation Error"}},- "summary": "Update Ima Pipeline Config",+ "summary": "Set Rag Active Model","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/rag-pipelines/lightrag-server/config": {+ "/api/knowledge-bases/rag-pipelines/graphrag/config": {"get": {- "description": "Read reusable server defaults with the API key redacted.",- "operationId": "get_lightrag_server_pipeline_config_api_knowledge_bases_rag_pipelines_lightrag_server_config_get",+ "description": "Read GraphRAG's query knobs (response style, community granularity).",+ "operationId": "get_graphrag_pipeline_config_api_knowledge_bases_rag_pipelines_graphrag_config_get","parameters": [{"in": "header",@@ -22195,14 +22612,14 @@"description": "Validation Error"}},- "summary": "Get Lightrag Server Pipeline Config",+ "summary": "Get Graphrag Pipeline Config","tags": ["knowledge-bases"]},"put": {- "description": "Persist reusable defaults without changing existing KB bindings.",- "operationId": "update_lightrag_server_pipeline_config_api_knowledge_bases_rag_pipelines_lightrag_server_config_put",+ "description": "Persist GraphRAG's query knobs. Takes effect on the next query.",+ "operationId": "update_graphrag_pipeline_config_api_knowledge_bases_rag_pipelines_graphrag_config_put","parameters": [{"in": "header",@@ -22241,7 +22658,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/LightRagServerConfigUpdate"+ "$ref": "#/components/schemas/GraphRagConfigUpdate"}}},@@ -22267,16 +22684,16 @@"description": "Validation Error"}},- "summary": "Update Lightrag Server Pipeline Config",+ "summary": "Update Graphrag Pipeline Config","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/rag-pipelines/lightrag/config": {- "get": {- "description": "Read LightRAG's query knobs plus its indexing concurrency/extraction knobs.",- "operationId": "get_lightrag_pipeline_config_api_knowledge_bases_rag_pipelines_lightrag_config_get",+ "/api/knowledge-bases/rag-pipelines/graphrag/model-compatibility": {+ "post": {+ "description": "Test GraphRAG structured output without changing the active chat model.",+ "operationId": "test_graphrag_model_compatibility_api_knowledge_bases_rag_pipelines_graphrag_model_compatibility_post","parameters": [{"in": "header",@@ -22311,6 +22728,16 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/GraphRagModelCompatibilityRequest"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -22331,14 +22758,16 @@"description": "Validation Error"}},- "summary": "Get Lightrag Pipeline Config",+ "summary": "Test Graphrag Model Compatibility","tags": ["knowledge-bases"]- },- "put": {- "description": "Persist LightRAG's knobs.\n\nQuery knobs (``top_k``, ``response_type``) take effect on the next query;\nthe indexing knobs shape how a KB is built, so they apply to the next\nbuild or rebuild.",- "operationId": "update_lightrag_pipeline_config_api_knowledge_bases_rag_pipelines_lightrag_config_put",+ }+ },+ "/api/knowledge-bases/rag-pipelines/ima/config": {+ "get": {+ "description": "Read the account-level IMA credentials (key redacted to a boolean).",+ "operationId": "get_ima_pipeline_config_api_knowledge_bases_rag_pipelines_ima_config_get","parameters": [{"in": "header",@@ -22373,16 +22802,6 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/LightRagConfigUpdate"- }- }- },- "required": true- },"responses": {"200": {"content": {@@ -22403,16 +22822,14 @@"description": "Validation Error"}},- "summary": "Update Lightrag Pipeline Config",+ "summary": "Get Ima Pipeline Config","tags": ["knowledge-bases"]- }- },- "/api/knowledge-bases/rag-pipelines/lightrag/model-options": {- "get": {- "description": "Return accessible catalog models with supported role capabilities.",- "operationId": "get_lightrag_model_options_api_knowledge_bases_rag_pipelines_lightrag_model_options_get",+ },+ "put": {+ "description": "Persist the account-level IMA Client ID / API key.",+ "operationId": "update_ima_pipeline_config_api_knowledge_bases_rag_pipelines_ima_config_put","parameters": [{"in": "header",@@ -22447,6 +22864,16 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/ImaConfigUpdate"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -22467,16 +22894,16 @@"description": "Validation Error"}},- "summary": "Get Lightrag Model Options",+ "summary": "Update Ima Pipeline Config","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/rag-pipelines/llamaindex/config": {+ "/api/knowledge-bases/rag-pipelines/lightrag-server/config": {"get": {- "description": "Read the LlamaIndex engine's retrieval + chunking knobs.",- "operationId": "get_llamaindex_pipeline_config_api_knowledge_bases_rag_pipelines_llamaindex_config_get",+ "description": "Read reusable server defaults with the API key redacted.",+ "operationId": "get_lightrag_server_pipeline_config_api_knowledge_bases_rag_pipelines_lightrag_server_config_get","parameters": [{"in": "header",@@ -22531,14 +22958,14 @@"description": "Validation Error"}},- "summary": "Get Llamaindex Pipeline Config",+ "summary": "Get Lightrag Server Pipeline Config","tags": ["knowledge-bases"]},"put": {- "description": "Persist the LlamaIndex engine knobs.\n\nRetrieval knobs take effect on the next query; indexing knobs only affect\ndocuments processed after the save.",- "operationId": "update_llamaindex_pipeline_config_api_knowledge_bases_rag_pipelines_llamaindex_config_put",+ "description": "Persist reusable defaults without changing existing KB bindings.",+ "operationId": "update_lightrag_server_pipeline_config_api_knowledge_bases_rag_pipelines_lightrag_server_config_put","parameters": [{"in": "header",@@ -22577,7 +23004,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/LlamaIndexConfigUpdate"+ "$ref": "#/components/schemas/LightRagServerConfigUpdate"}}},@@ -22603,90 +23030,16 @@"description": "Validation Error"}},- "summary": "Update Llamaindex Pipeline Config",- "tags": [- "knowledge-bases"- ]- }- },- "/api/knowledge-bases/rag-pipelines/model-options": {- "get": {- "description": "List configured models (secret-free) for the requested model kinds.",- "operationId": "get_rag_model_options_api_knowledge_bases_rag_pipelines_model_options_get",- "parameters": [- {- "in": "query",- "name": "kinds",- "required": false,- "schema": {- "default": "llm,embedding",- "title": "Kinds",- "type": "string"- }- },- {- "in": "header",- "name": "Authorization",- "required": false,- "schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Authorization"- }- },- {- "in": "cookie",- "name": "dt_token",- "required": false,- "schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Dt Token"- }- }- ],- "responses": {- "200": {- "content": {- "application/json": {- "schema": {}- }- },- "description": "Successful Response"- },- "422": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- },- "description": "Validation Error"- }- },- "summary": "Get Rag Model Options",+ "summary": "Update Lightrag Server Pipeline Config","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/rag-pipelines/pageindex/config": {+ "/api/knowledge-bases/rag-pipelines/lightrag/config": {"get": {- "description": "Read the PageIndex credential state (key redacted to a boolean).",- "operationId": "get_pageindex_pipeline_config_api_knowledge_bases_rag_pipelines_pageindex_config_get",+ "description": "Read LightRAG's query knobs plus its indexing concurrency/extraction knobs.",+ "operationId": "get_lightrag_pipeline_config_api_knowledge_bases_rag_pipelines_lightrag_config_get","parameters": [{"in": "header",@@ -22741,14 +23094,14 @@"description": "Validation Error"}},- "summary": "Get Pageindex Pipeline Config",+ "summary": "Get Lightrag Pipeline Config","tags": ["knowledge-bases"]},"put": {- "description": "Persist the deployment-level PageIndex Cloud credential.",- "operationId": "update_pageindex_pipeline_config_api_knowledge_bases_rag_pipelines_pageindex_config_put",+ "description": "Persist LightRAG's knobs.\n\nQuery knobs (``top_k``, ``response_type``) take effect on the next query;\nthe indexing knobs shape how a KB is built, so they apply to the next\nbuild or rebuild.",+ "operationId": "update_lightrag_pipeline_config_api_knowledge_bases_rag_pipelines_lightrag_config_put","parameters": [{"in": "header",@@ -22787,7 +23140,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/PageIndexConfigUpdate"+ "$ref": "#/components/schemas/LightRagConfigUpdate"}}},@@ -22813,26 +23166,17 @@"description": "Validation Error"}},- "summary": "Update Pageindex Pipeline Config",+ "summary": "Update Lightrag Pipeline Config","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/rag-pipelines/{provider}/preflight": {+ "/api/knowledge-bases/rag-pipelines/lightrag/model-options": {"get": {- "description": "Check whether ``provider`` can run in the current environment.\n\nReturns ``{ok, checks:[{key,label,ok,detail,optional}]}`` — package\ninstall, API key, and active model requirements per engine.",- "operationId": "get_rag_pipeline_preflight_api_knowledge_bases_rag_pipelines__provider__preflight_get",+ "description": "Return accessible catalog models with supported role capabilities.",+ "operationId": "get_lightrag_model_options_api_knowledge_bases_rag_pipelines_lightrag_model_options_get","parameters": [- {- "in": "path",- "name": "provider",- "required": true,- "schema": {- "title": "Provider",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -22886,16 +23230,16 @@"description": "Validation Error"}},- "summary": "Get Rag Pipeline Preflight",+ "summary": "Get Lightrag Model Options","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/rag-providers": {+ "/api/knowledge-bases/rag-pipelines/llamaindex/config": {"get": {- "description": "Get list of available RAG providers (with the active per-engine mode).",- "operationId": "get_rag_providers_api_knowledge_bases_rag_providers_get",+ "description": "Read the LlamaIndex engine's retrieval + chunking knobs.",+ "operationId": "get_llamaindex_pipeline_config_api_knowledge_bases_rag_pipelines_llamaindex_config_get","parameters": [{"in": "header",@@ -22950,26 +23294,15 @@"description": "Validation Error"}},- "summary": "Get Rag Providers",+ "summary": "Get Llamaindex Pipeline Config","tags": ["knowledge-bases"]- }- },- "/api/knowledge-bases/rag-providers/{provider}/mode": {+ },"put": {- "description": "Persist the default retrieval mode for a mode-aware engine.\n\nThe mode must be one the engine supports; a KB's own ``search_mode`` still\noverrides this per-KB default.",- "operationId": "set_rag_provider_mode_api_knowledge_bases_rag_providers__provider__mode_put",+ "description": "Persist the LlamaIndex engine knobs.\n\nRetrieval knobs take effect on the next query; indexing knobs only affect\ndocuments processed after the save.",+ "operationId": "update_llamaindex_pipeline_config_api_knowledge_bases_rag_pipelines_llamaindex_config_put","parameters": [- {- "in": "path",- "name": "provider",- "required": true,- "schema": {- "title": "Provider",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -23007,7 +23340,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/ProviderModeUpdate"+ "$ref": "#/components/schemas/LlamaIndexConfigUpdate"}}},@@ -23033,17 +23366,27 @@"description": "Validation Error"}},- "summary": "Set Rag Provider Mode",+ "summary": "Update Llamaindex Pipeline Config","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/supported-file-types": {+ "/api/knowledge-bases/rag-pipelines/model-options": {"get": {- "description": "Return the current upload policy so the web client stays in sync.",- "operationId": "get_supported_file_types_api_knowledge_bases_supported_file_types_get",+ "description": "List configured models (secret-free) for the requested model kinds.",+ "operationId": "get_rag_model_options_api_knowledge_bases_rag_pipelines_model_options_get","parameters": [+ {+ "in": "query",+ "name": "kinds",+ "required": false,+ "schema": {+ "default": "llm,embedding",+ "title": "Kinds",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -23081,9 +23424,7 @@"200": {"content": {"application/json": {- "schema": {- "$ref": "#/components/schemas/SupportedFileTypesInfo"- }+ "schema": {}}},"description": "Successful Response"@@ -23099,26 +23440,17 @@"description": "Validation Error"}},- "summary": "Get Supported File Types",+ "summary": "Get Rag Model Options","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/tasks/{task_id}/stream": {+ "/api/knowledge-bases/rag-pipelines/pageindex/config": {"get": {- "description": "Stream task-specific logs for knowledge-base operations.",- "operationId": "stream_task_logs_api_knowledge_bases_tasks__task_id__stream_get",+ "description": "Read the PageIndex credential state (key redacted to a boolean).",+ "operationId": "get_pageindex_pipeline_config_api_knowledge_bases_rag_pipelines_pageindex_config_get","parameters": [- {- "in": "path",- "name": "task_id",- "required": true,- "schema": {- "title": "Task Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -23172,26 +23504,15 @@"description": "Validation Error"}},- "summary": "Stream Task Logs",+ "summary": "Get Pageindex Pipeline Config","tags": ["knowledge-bases"]- }- },- "/api/knowledge-bases/{kb_name}": {- "delete": {- "description": "Delete a knowledge base.",- "operationId": "delete_knowledge_base_api_knowledge_bases__kb_name__delete",+ },+ "put": {+ "description": "Persist the deployment-level PageIndex Cloud credential.",+ "operationId": "update_pageindex_pipeline_config_api_knowledge_bases_rag_pipelines_pageindex_config_put","parameters": [- {- "in": "path",- "name": "kb_name",- "required": true,- "schema": {- "title": "Kb Name",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -23225,6 +23546,16 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/PageIndexConfigUpdate"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -23245,21 +23576,23 @@"description": "Validation Error"}},- "summary": "Delete Knowledge Base",+ "summary": "Update Pageindex Pipeline Config","tags": ["knowledge-bases"]- },+ }+ },+ "/api/knowledge-bases/rag-pipelines/{provider}/preflight": {"get": {- "description": "Get detailed info for a specific KB.",- "operationId": "get_knowledge_base_details_api_knowledge_bases__kb_name__get",+ "description": "Check whether ``provider`` can run in the current environment.\n\nReturns ``{ok, checks:[{key,label,ok,detail,optional}]}`` — package\ninstall, API key, and active model requirements per engine.",+ "operationId": "get_rag_pipeline_preflight_api_knowledge_bases_rag_pipelines__provider__preflight_get","parameters": [{"in": "path",- "name": "kb_name",+ "name": "provider","required": true,"schema": {- "title": "Kb Name",+ "title": "Provider","type": "string"}},@@ -23316,26 +23649,17 @@"description": "Validation Error"}},- "summary": "Get Knowledge Base Details",+ "summary": "Get Rag Pipeline Preflight","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/{kb_name}/config": {+ "/api/knowledge-bases/rag-providers": {"get": {- "description": "Get configuration for a specific knowledge base.",- "operationId": "get_kb_config_api_knowledge_bases__kb_name__config_get",+ "description": "Get list of available RAG providers (with the active per-engine mode).",+ "operationId": "get_rag_providers_api_knowledge_bases_rag_providers_get","parameters": [- {- "in": "path",- "name": "kb_name",- "required": true,- "schema": {- "title": "Kb Name",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -23389,21 +23713,23 @@"description": "Validation Error"}},- "summary": "Get Kb Config",+ "summary": "Get Rag Providers","tags": ["knowledge-bases"]- },+ }+ },+ "/api/knowledge-bases/rag-providers/{provider}/mode": {"put": {- "description": "Update configuration for a specific knowledge base.",- "operationId": "update_kb_config_api_knowledge_bases__kb_name__config_put",+ "description": "Persist the default retrieval mode for a mode-aware engine.\n\nThe mode must be one the engine supports; a KB's own ``search_mode`` still\noverrides this per-KB default.",+ "operationId": "set_rag_provider_mode_api_knowledge_bases_rag_providers__provider__mode_put","parameters": [{"in": "path",- "name": "kb_name",+ "name": "provider","required": true,"schema": {- "title": "Kb Name",+ "title": "Provider","type": "string"}},@@ -23444,9 +23770,7 @@"content": {"application/json": {"schema": {- "additionalProperties": true,- "title": "Config",- "type": "object"+ "$ref": "#/components/schemas/ProviderModeUpdate"}}},@@ -23472,32 +23796,89 @@"description": "Validation Error"}},- "summary": "Update Kb Config",+ "summary": "Set Rag Provider Mode","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/{kb_name}/file-preview-text/{filename}": {+ "/api/knowledge-bases/supported-file-types": {"get": {- "description": "Serve extracted plain text for a raw KB document preview.",- "operationId": "serve_kb_raw_file_text_preview_api_knowledge_bases__kb_name__file_preview_text__filename__get",+ "description": "Return the current upload policy so the web client stays in sync.",+ "operationId": "get_supported_file_types_api_knowledge_bases_supported_file_types_get","parameters": [{- "in": "path",- "name": "kb_name",- "required": true,+ "in": "header",+ "name": "Authorization",+ "required": false,"schema": {- "title": "Kb Name",- "type": "string"+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"+ }+ },+ {+ "in": "cookie",+ "name": "dt_token",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"}+ }+ ],+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/SupportedFileTypesInfo"+ }+ }+ },+ "description": "Successful Response"},+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "Get Supported File Types",+ "tags": [+ "knowledge-bases"+ ]+ }+ },+ "/api/knowledge-bases/tasks/{task_id}/stream": {+ "get": {+ "description": "Stream task-specific logs for knowledge-base operations.",+ "operationId": "stream_task_logs_api_knowledge_bases_tasks__task_id__stream_get",+ "parameters": [{"in": "path",- "name": "filename",+ "name": "task_id","required": true,"schema": {- "title": "Filename",+ "title": "Task Id","type": "string"}},@@ -23554,16 +23935,16 @@"description": "Validation Error"}},- "summary": "Serve Kb Raw File Text Preview",+ "summary": "Stream Task Logs","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/{kb_name}/files": {- "get": {- "description": "List raw documents under <kb>/raw/, recursing into folders.\n\n``name`` is the POSIX path relative to ``raw/`` so the web client can\nrebuild the folder tree. Folders (including empty ones) are returned as\n``type: \"folder\"`` entries so user-created/uploaded structure shows even\nbefore it holds any files. Folders are purely organizational and have no\neffect on indexing or retrieval.",- "operationId": "list_kb_raw_files_api_knowledge_bases__kb_name__files_get",+ "/api/knowledge-bases/{kb_name}": {+ "delete": {+ "description": "Delete a knowledge base.",+ "operationId": "delete_knowledge_base_api_knowledge_bases__kb_name__delete","parameters": [{"in": "path",@@ -23627,16 +24008,14 @@"description": "Validation Error"}},- "summary": "List Kb Raw Files",+ "summary": "Delete Knowledge Base","tags": ["knowledge-bases"]- }- },- "/api/knowledge-bases/{kb_name}/files/move": {- "post": {- "description": "Move a file/folder between organizational folders (display only).\n\nMoving never re-indexes: folders don't affect retrieval, so this is a pure\nfilesystem relocation under ``raw/``.",- "operationId": "move_kb_file_api_knowledge_bases__kb_name__files_move_post",+ },+ "get": {+ "description": "Get detailed info for a specific KB.",+ "operationId": "get_knowledge_base_details_api_knowledge_bases__kb_name__get","parameters": [{"in": "path",@@ -23680,16 +24059,6 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/MoveFilePayload"- }- }- },- "required": true- },"responses": {"200": {"content": {@@ -23710,16 +24079,16 @@"description": "Validation Error"}},- "summary": "Move Kb File",+ "summary": "Get Knowledge Base Details","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/{kb_name}/files/{filename}": {- "delete": {- "description": "Remove a single raw document from a knowledge base.\n\nUnlike deleting the whole KB, this works while the KB is in an *error*\nstate — that is the point: a file that failed to parse (e.g. one that\nexceeds the cloud parser's page limit) can be dropped without deleting and\nrebuilding everything. Connected (read-only) and legacy KBs are still\nrejected. Vectors are not pruned here; ``was_indexed`` tells the caller\nwhether a re-index is needed to purge the file from retrieval.",- "operationId": "delete_kb_file_api_knowledge_bases__kb_name__files__filename__delete",+ "/api/knowledge-bases/{kb_name}/config": {+ "get": {+ "description": "Get configuration for a specific knowledge base.",+ "operationId": "get_kb_config_api_knowledge_bases__kb_name__config_get","parameters": [{"in": "path",@@ -23730,12 +24099,74 @@"type": "string"}},+ {+ "in": "header",+ "name": "Authorization",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"+ }+ },+ {+ "in": "cookie",+ "name": "dt_token",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"+ }+ }+ ],+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {}+ }+ },+ "description": "Successful Response"+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "Get Kb Config",+ "tags": [+ "knowledge-bases"+ ]+ },+ "put": {+ "description": "Update configuration for a specific knowledge base.",+ "operationId": "update_kb_config_api_knowledge_bases__kb_name__config_put",+ "parameters": [{"in": "path",- "name": "filename",+ "name": "kb_name","required": true,"schema": {- "title": "Filename",+ "title": "Kb Name","type": "string"}},@@ -23772,6 +24203,18 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "additionalProperties": true,+ "title": "Config",+ "type": "object"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -23792,14 +24235,16 @@"description": "Validation Error"}},- "summary": "Delete Kb File",+ "summary": "Update Kb Config","tags": ["knowledge-bases"]- },+ }+ },+ "/api/knowledge-bases/{kb_name}/file-preview-text/{filename}": {"get": {- "description": "Serve a single raw document for inline preview / download.\n\nResolution is sandboxed to the KB's raw/ directory; any path that\nescapes via traversal yields 403.",- "operationId": "serve_kb_raw_file_api_knowledge_bases__kb_name__files__filename__get",+ "description": "Serve extracted plain text for a raw KB document preview.",+ "operationId": "serve_kb_raw_file_text_preview_api_knowledge_bases__kb_name__file_preview_text__filename__get","parameters": [{"in": "path",@@ -23872,16 +24317,16 @@"description": "Validation Error"}},- "summary": "Serve Kb Raw File",+ "summary": "Serve Kb Raw File Text Preview","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/{kb_name}/folders": {- "post": {- "description": "Create an (organizational) folder under <kb>/raw/. No retrieval effect.",- "operationId": "create_kb_folder_api_knowledge_bases__kb_name__folders_post",+ "/api/knowledge-bases/{kb_name}/files": {+ "get": {+ "description": "List raw documents under <kb>/raw/, recursing into folders.\n\n``name`` is the POSIX path relative to ``raw/`` so the web client can\nrebuild the folder tree. Folders (including empty ones) are returned as\n``type: \"folder\"`` entries so user-created/uploaded structure shows even\nbefore it holds any files. Folders are purely organizational and have no\neffect on indexing or retrieval.",+ "operationId": "list_kb_raw_files_api_knowledge_bases__kb_name__files_get","parameters": [{"in": "path",@@ -23925,16 +24370,6 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/CreateFolderPayload"- }- }- },- "required": true- },"responses": {"200": {"content": {@@ -23955,15 +24390,16 @@"description": "Validation Error"}},- "summary": "Create Kb Folder",+ "summary": "List Kb Raw Files","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/{kb_name}/github-source": {+ "/api/knowledge-bases/{kb_name}/files/move": {"post": {- "operationId": "add_github_source_api_knowledge_bases__kb_name__github_source_post",+ "description": "Move a file/folder between organizational folders (display only).\n\nMoving never re-indexes: folders don't affect retrieval, so this is a pure\nfilesystem relocation under ``raw/``.",+ "operationId": "move_kb_file_api_knowledge_bases__kb_name__files_move_post","parameters": [{"in": "path",@@ -24011,7 +24447,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/AddGitHubSourceRequest"+ "$ref": "#/components/schemas/MoveFilePayload"}}},@@ -24021,9 +24457,7 @@"200": {"content": {"application/json": {- "schema": {- "$ref": "#/components/schemas/GitHubSourceInfo"- }+ "schema": {}}},"description": "Successful Response"@@ -24039,15 +24473,16 @@"description": "Validation Error"}},- "summary": "Add Github Source",+ "summary": "Move Kb File","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/{kb_name}/github-source/{source_id}": {+ "/api/knowledge-bases/{kb_name}/files/{filename}": {"delete": {- "operationId": "remove_github_source_api_knowledge_bases__kb_name__github_source__source_id__delete",+ "description": "Remove a single raw document from a knowledge base.\n\nUnlike deleting the whole KB, this works while the KB is in an *error*\nstate — that is the point: a file that failed to parse (e.g. one that\nexceeds the cloud parser's page limit) can be dropped without deleting and\nrebuilding everything. Connected (read-only) and legacy KBs are still\nrejected. Vectors are not pruned here; ``was_indexed`` tells the caller\nwhether a re-index is needed to purge the file from retrieval.",+ "operationId": "delete_kb_file_api_knowledge_bases__kb_name__files__filename__delete","parameters": [{"in": "path",@@ -24060,10 +24495,10 @@},{"in": "path",- "name": "source_id",+ "name": "filename","required": true,"schema": {- "title": "Source Id",+ "title": "Filename","type": "string"}},@@ -24120,15 +24555,14 @@"description": "Validation Error"}},- "summary": "Remove Github Source",+ "summary": "Delete Kb File","tags": ["knowledge-bases"]- }- },- "/api/knowledge-bases/{kb_name}/github-sources": {+ },"get": {- "operationId": "get_github_sources_api_knowledge_bases__kb_name__github_sources_get",+ "description": "Serve a single raw document for inline preview / download.\n\nResolution is sandboxed to the KB's raw/ directory; any path that\nescapes via traversal yields 403.",+ "operationId": "serve_kb_raw_file_api_knowledge_bases__kb_name__files__filename__get","parameters": [{"in": "path",@@ -24139,6 +24573,15 @@"type": "string"}},+ {+ "in": "path",+ "name": "filename",+ "required": true,+ "schema": {+ "title": "Filename",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -24176,13 +24619,7 @@"200": {"content": {"application/json": {- "schema": {- "items": {- "$ref": "#/components/schemas/GitHubSourceInfo"- },- "title": "Response Get Github Sources Api Knowledge Bases Kb Name Github Sources Get",- "type": "array"- }+ "schema": {}}},"description": "Successful Response"@@ -24198,16 +24635,16 @@"description": "Validation Error"}},- "summary": "Get Github Sources",+ "summary": "Serve Kb Raw File","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/{kb_name}/indexing-policy": {- "put": {- "description": "Reject obsolete model edits instead of saving a policy that will not apply.",- "operationId": "update_pending_indexing_policy_api_knowledge_bases__kb_name__indexing_policy_put",+ "/api/knowledge-bases/{kb_name}/folders": {+ "post": {+ "description": "Create an (organizational) folder under <kb>/raw/. No retrieval effect.",+ "operationId": "create_kb_folder_api_knowledge_bases__kb_name__folders_post","parameters": [{"in": "path",@@ -24255,15 +24692,7 @@"content": {"application/json": {"schema": {- "anyOf": [- {- "$ref": "#/components/schemas/LightRagIndexingSelection"- },- {- "$ref": "#/components/schemas/IndexingLLMSelectionRequest"- }- ],- "title": "Payload"+ "$ref": "#/components/schemas/CreateFolderPayload"}}},@@ -24273,11 +24702,7 @@"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Update Pending Indexing Policy Api Knowledge Bases Kb Name Indexing Policy Put",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -24293,16 +24718,15 @@"description": "Validation Error"}},- "summary": "Update Pending Indexing Policy",+ "summary": "Create Kb Folder","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/{kb_name}/link-folder": {+ "/api/knowledge-bases/{kb_name}/github-source": {"post": {- "description": "Link a local folder to a knowledge base.\n\nThis allows syncing documents from a local folder (which can be\nsynced with SharePoint, Google Drive, OneLake, etc.) to the KB.\n\nThe folder path supports:\n- Absolute paths: /Users/name/Documents or C:\\Users\\name\\Documents\n- Home directory: ~/Documents\n- Relative paths (resolved from server working directory)",- "operationId": "link_folder_api_knowledge_bases__kb_name__link_folder_post",+ "operationId": "add_github_source_api_knowledge_bases__kb_name__github_source_post","parameters": [{"in": "path",@@ -24350,7 +24774,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/LinkFolderRequest"+ "$ref": "#/components/schemas/AddGitHubSourceRequest"}}},@@ -24361,7 +24785,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/LinkedFolderInfo"+ "$ref": "#/components/schemas/GitHubSourceInfo"}}},@@ -24378,16 +24802,15 @@"description": "Validation Error"}},- "summary": "Link Folder",+ "summary": "Add Github Source","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/{kb_name}/linked-folders": {- "get": {- "description": "Get list of linked folders for a knowledge base.",- "operationId": "get_linked_folders_api_knowledge_bases__kb_name__linked_folders_get",+ "/api/knowledge-bases/{kb_name}/github-source/{source_id}": {+ "delete": {+ "operationId": "remove_github_source_api_knowledge_bases__kb_name__github_source__source_id__delete","parameters": [{"in": "path",@@ -24398,6 +24821,15 @@"type": "string"}},+ {+ "in": "path",+ "name": "source_id",+ "required": true,+ "schema": {+ "title": "Source Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -24435,13 +24867,7 @@"200": {"content": {"application/json": {- "schema": {- "items": {- "$ref": "#/components/schemas/LinkedFolderInfo"- },- "title": "Response Get Linked Folders Api Knowledge Bases Kb Name Linked Folders Get",- "type": "array"- }+ "schema": {}}},"description": "Successful Response"@@ -24457,16 +24883,15 @@"description": "Validation Error"}},- "summary": "Get Linked Folders",+ "summary": "Remove Github Source","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/{kb_name}/linked-folders/{folder_id}": {- "delete": {- "description": "Unlink a folder from a knowledge base.",- "operationId": "unlink_folder_api_knowledge_bases__kb_name__linked_folders__folder_id__delete",+ "/api/knowledge-bases/{kb_name}/github-sources": {+ "get": {+ "operationId": "get_github_sources_api_knowledge_bases__kb_name__github_sources_get","parameters": [{"in": "path",@@ -24477,15 +24902,6 @@"type": "string"}},- {- "in": "path",- "name": "folder_id",- "required": true,- "schema": {- "title": "Folder Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -24523,7 +24939,13 @@"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "items": {+ "$ref": "#/components/schemas/GitHubSourceInfo"+ },+ "title": "Response Get Github Sources Api Knowledge Bases Kb Name Github Sources Get",+ "type": "array"+ }}},"description": "Successful Response"@@ -24539,16 +24961,16 @@"description": "Validation Error"}},- "summary": "Unlink Folder",+ "summary": "Get Github Sources","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/{kb_name}/progress": {- "get": {- "description": "Get initialization progress for a knowledge base",- "operationId": "get_progress_api_knowledge_bases__kb_name__progress_get",+ "/api/knowledge-bases/{kb_name}/indexing-policy": {+ "put": {+ "description": "Reject obsolete model edits instead of saving a policy that will not apply.",+ "operationId": "update_pending_indexing_policy_api_knowledge_bases__kb_name__indexing_policy_put","parameters": [{"in": "path",@@ -24592,11 +25014,33 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "anyOf": [+ {+ "$ref": "#/components/schemas/LightRagIndexingSelection"+ },+ {+ "$ref": "#/components/schemas/IndexingLLMSelectionRequest"+ }+ ],+ "title": "Payload"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": true,+ "title": "Response Update Pending Indexing Policy Api Knowledge Bases Kb Name Indexing Policy Put",+ "type": "object"+ }}},"description": "Successful Response"@@ -24612,16 +25056,16 @@"description": "Validation Error"}},- "summary": "Get Progress",+ "summary": "Update Pending Indexing Policy","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/{kb_name}/progress/clear": {+ "/api/knowledge-bases/{kb_name}/link-folder": {"post": {- "description": "Clear progress file for a knowledge base (useful for stuck states)",- "operationId": "clear_progress_api_knowledge_bases__kb_name__progress_clear_post",+ "description": "Link a local folder to a knowledge base.\n\nThis allows syncing documents from a local folder (which can be\nsynced with SharePoint, Google Drive, OneLake, etc.) to the KB.\n\nThe folder path supports:\n- Absolute paths: /Users/name/Documents or C:\\Users\\name\\Documents\n- Home directory: ~/Documents\n- Relative paths (resolved from server working directory)",+ "operationId": "link_folder_api_knowledge_bases__kb_name__link_folder_post","parameters": [{"in": "path",@@ -24665,11 +25109,23 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/LinkFolderRequest"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "$ref": "#/components/schemas/LinkedFolderInfo"+ }}},"description": "Successful Response"@@ -24685,16 +25141,16 @@"description": "Validation Error"}},- "summary": "Clear Progress",+ "summary": "Link Folder","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/{kb_name}/reindex": {- "post": {- "description": "Re-index ``kb_name`` through its bound RAG provider.\n\nLlamaIndex keys versions by the selected embedding model. The other\nproviders keep synthetic provider-keyed versions, so they should rebuild\nwithout requiring an embedding-signature precheck.",- "operationId": "reindex_knowledge_base_api_knowledge_bases__kb_name__reindex_post",+ "/api/knowledge-bases/{kb_name}/linked-folders": {+ "get": {+ "description": "Get list of linked folders for a knowledge base.",+ "operationId": "get_linked_folders_api_knowledge_bases__kb_name__linked_folders_get","parameters": [{"in": "path",@@ -24738,23 +25194,16 @@}}],- "requestBody": {- "content": {- "application/x-www-form-urlencoded": {- "schema": {- "$ref": "#/components/schemas/Body_reindex_knowledge_base_api_knowledge_bases__kb_name__reindex_post"- }- }- }- },"responses": {"200": {"content": {"application/json": {"schema": {- "additionalProperties": true,- "title": "Response Reindex Knowledge Base Api Knowledge Bases Kb Name Reindex Post",- "type": "object"+ "items": {+ "$ref": "#/components/schemas/LinkedFolderInfo"+ },+ "title": "Response Get Linked Folders Api Knowledge Bases Kb Name Linked Folders Get",+ "type": "array"}}},@@ -24771,16 +25220,16 @@"description": "Validation Error"}},- "summary": "Reindex Knowledge Base",+ "summary": "Get Linked Folders","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/{kb_name}/reindex-config": {- "get": {- "description": "Read selected embedding and current role defaults for rebuild confirmation.",- "operationId": "get_reindex_config_api_knowledge_bases__kb_name__reindex_config_get",+ "/api/knowledge-bases/{kb_name}/linked-folders/{folder_id}": {+ "delete": {+ "description": "Unlink a folder from a knowledge base.",+ "operationId": "unlink_folder_api_knowledge_bases__kb_name__linked_folders__folder_id__delete","parameters": [{"in": "path",@@ -24792,12 +25241,11 @@}},{- "in": "query",- "name": "embedding_model",- "required": false,+ "in": "path",+ "name": "folder_id",+ "required": true,"schema": {- "default": "",- "title": "Embedding Model",+ "title": "Folder Id","type": "string"}},@@ -24838,11 +25286,7 @@"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Get Reindex Config Api Knowledge Bases Kb Name Reindex Config Get",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -24858,16 +25302,16 @@"description": "Validation Error"}},- "summary": "Get Reindex Config",+ "summary": "Unlink Folder","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/{kb_name}/retry": {- "post": {- "description": "Retry a failed KB initialization/indexing run from its stored raw files.",- "operationId": "retry_knowledge_base_api_knowledge_bases__kb_name__retry_post",+ "/api/knowledge-bases/{kb_name}/progress": {+ "get": {+ "description": "Get initialization progress for a knowledge base",+ "operationId": "get_progress_api_knowledge_bases__kb_name__progress_get","parameters": [{"in": "path",@@ -24915,11 +25359,7 @@"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Retry Knowledge Base Api Knowledge Bases Kb Name Retry Post",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -24935,16 +25375,16 @@"description": "Validation Error"}},- "summary": "Retry Knowledge Base",+ "summary": "Get Progress","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/{kb_name}/sync-folder/{folder_id}": {+ "/api/knowledge-bases/{kb_name}/progress/clear": {"post": {- "description": "Sync files from a linked folder to the knowledge base.\n\nThis scans the linked folder for supported documents and processes\nany new files that haven't been added yet.",- "operationId": "sync_folder_api_knowledge_bases__kb_name__sync_folder__folder_id__post",+ "description": "Clear progress file for a knowledge base (useful for stuck states)",+ "operationId": "clear_progress_api_knowledge_bases__kb_name__progress_clear_post","parameters": [{"in": "path",@@ -24955,15 +25395,6 @@"type": "string"}},- {- "in": "path",- "name": "folder_id",- "required": true,- "schema": {- "title": "Folder Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -25001,9 +25432,7 @@"200": {"content": {"application/json": {- "schema": {- "$ref": "#/components/schemas/SyncFolderResponse"- }+ "schema": {}}},"description": "Successful Response"@@ -25019,15 +25448,16 @@"description": "Validation Error"}},- "summary": "Sync Folder",+ "summary": "Clear Progress","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/{kb_name}/sync-github": {+ "/api/knowledge-bases/{kb_name}/reindex": {"post": {- "operationId": "sync_github_sources_api_knowledge_bases__kb_name__sync_github_post",+ "description": "Re-index ``kb_name`` through its bound RAG provider.\n\nLlamaIndex keys versions by the selected embedding model. The other\nproviders keep synthetic provider-keyed versions, so they should rebuild\nwithout requiring an embedding-signature precheck.",+ "operationId": "reindex_knowledge_base_api_knowledge_bases__kb_name__reindex_post","parameters": [{"in": "path",@@ -25071,11 +25501,24 @@}}],+ "requestBody": {+ "content": {+ "application/x-www-form-urlencoded": {+ "schema": {+ "$ref": "#/components/schemas/Body_reindex_knowledge_base_api_knowledge_bases__kb_name__reindex_post"+ }+ }+ }+ },"responses": {"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": true,+ "title": "Response Reindex Knowledge Base Api Knowledge Bases Kb Name Reindex Post",+ "type": "object"+ }}},"description": "Successful Response"@@ -25091,16 +25534,16 @@"description": "Validation Error"}},- "summary": "Sync Github Sources",+ "summary": "Reindex Knowledge Base","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/{kb_name}/sync-web": {- "post": {- "description": "Run one bounded crawl-and-sync pass for every enabled web source.",- "operationId": "sync_web_sources_api_knowledge_bases__kb_name__sync_web_post",+ "/api/knowledge-bases/{kb_name}/reindex-config": {+ "get": {+ "description": "Read selected embedding and current role defaults for rebuild confirmation.",+ "operationId": "get_reindex_config_api_knowledge_bases__kb_name__reindex_config_get","parameters": [{"in": "path",@@ -25111,6 +25554,16 @@"type": "string"}},+ {+ "in": "query",+ "name": "embedding_model",+ "required": false,+ "schema": {+ "default": "",+ "title": "Embedding Model",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -25148,7 +25601,11 @@"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": true,+ "title": "Response Get Reindex Config Api Knowledge Bases Kb Name Reindex Config Get",+ "type": "object"+ }}},"description": "Successful Response"@@ -25164,16 +25621,16 @@"description": "Validation Error"}},- "summary": "Sync Web Sources",+ "summary": "Get Reindex Config","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/{kb_name}/upload": {+ "/api/knowledge-bases/{kb_name}/retry": {"post": {- "description": "Upload files to a knowledge base and process them in background.\n\n``dest_subdir`` places the whole batch under that folder inside the KB.\nA browser folder pick reports each file's path relative to the chosen\ndirectory, so the directory's own ancestors never reach the server; this\nis how a caller adding one subtree at a time re-attaches it where it\nbelongs instead of piling every batch at the root (#866).",- "operationId": "upload_files_api_knowledge_bases__kb_name__upload_post",+ "description": "Retry a failed KB initialization/indexing run from its stored raw files.",+ "operationId": "retry_knowledge_base_api_knowledge_bases__kb_name__retry_post","parameters": [{"in": "path",@@ -25217,21 +25674,15 @@}}],- "requestBody": {- "content": {- "multipart/form-data": {- "schema": {- "$ref": "#/components/schemas/Body_upload_files_api_knowledge_bases__kb_name__upload_post"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": true,+ "title": "Response Retry Knowledge Base Api Knowledge Bases Kb Name Retry Post",+ "type": "object"+ }}},"description": "Successful Response"@@ -25247,15 +25698,16 @@"description": "Validation Error"}},- "summary": "Upload Files",+ "summary": "Retry Knowledge Base","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/{kb_name}/web-source": {+ "/api/knowledge-bases/{kb_name}/sync-folder/{folder_id}": {"post": {- "operationId": "add_web_source_api_knowledge_bases__kb_name__web_source_post",+ "description": "Sync files from a linked folder to the knowledge base.\n\nThis scans the linked folder for supported documents and processes\nany new files that haven't been added yet.",+ "operationId": "sync_folder_api_knowledge_bases__kb_name__sync_folder__folder_id__post","parameters": [{"in": "path",@@ -25266,6 +25718,15 @@"type": "string"}},+ {+ "in": "path",+ "name": "folder_id",+ "required": true,+ "schema": {+ "title": "Folder Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -25299,22 +25760,12 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/AddWebSourceRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/WebSourceInfo"+ "$ref": "#/components/schemas/SyncFolderResponse"}}},@@ -25331,15 +25782,15 @@"description": "Validation Error"}},- "summary": "Add Web Source",+ "summary": "Sync Folder","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/{kb_name}/web-source-sync": {- "get": {- "operationId": "get_web_source_sync_jobs_api_knowledge_bases__kb_name__web_source_sync_get",+ "/api/knowledge-bases/{kb_name}/sync-github": {+ "post": {+ "operationId": "sync_github_sources_api_knowledge_bases__kb_name__sync_github_post","parameters": [{"in": "path",@@ -25387,13 +25838,7 @@"200": {"content": {"application/json": {- "schema": {- "items": {- "$ref": "#/components/schemas/WebSourceSyncJobInfo"- },- "title": "Response Get Web Source Sync Jobs Api Knowledge Bases Kb Name Web Source Sync Get",- "type": "array"- }+ "schema": {}}},"description": "Successful Response"@@ -25409,15 +25854,16 @@"description": "Validation Error"}},- "summary": "Get Web Source Sync Jobs",+ "summary": "Sync Github Sources","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/{kb_name}/web-source/{source_id}": {- "delete": {- "operationId": "remove_web_source_api_knowledge_bases__kb_name__web_source__source_id__delete",+ "/api/knowledge-bases/{kb_name}/sync-web": {+ "post": {+ "description": "Run one bounded crawl-and-sync pass for every enabled web source.",+ "operationId": "sync_web_sources_api_knowledge_bases__kb_name__sync_web_post","parameters": [{"in": "path",@@ -25428,15 +25874,6 @@"type": "string"}},- {- "in": "path",- "name": "source_id",- "required": true,- "schema": {- "title": "Source Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -25490,15 +25927,16 @@"description": "Validation Error"}},- "summary": "Remove Web Source",+ "summary": "Sync Web Sources","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/{kb_name}/web-source/{source_id}/cancel": {+ "/api/knowledge-bases/{kb_name}/upload": {"post": {- "operationId": "cancel_web_source_sync_api_knowledge_bases__kb_name__web_source__source_id__cancel_post",+ "description": "Upload files to a knowledge base and process them in background.\n\n``dest_subdir`` places the whole batch under that folder inside the KB.\nA browser folder pick reports each file's path relative to the chosen\ndirectory, so the directory's own ancestors never reach the server; this\nis how a caller adding one subtree at a time re-attaches it where it\nbelongs instead of piling every batch at the root (#866).",+ "operationId": "upload_files_api_knowledge_bases__kb_name__upload_post","parameters": [{"in": "path",@@ -25509,15 +25947,6 @@"type": "string"}},- {- "in": "path",- "name": "source_id",- "required": true,- "schema": {- "title": "Source Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -25551,6 +25980,16 @@}}],+ "requestBody": {+ "content": {+ "multipart/form-data": {+ "schema": {+ "$ref": "#/components/schemas/Body_upload_files_api_knowledge_bases__kb_name__upload_post"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -25571,15 +26010,16 @@"description": "Validation Error"}},- "summary": "Cancel Web Source Sync",+ "summary": "Upload Files","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/{kb_name}/web-source/{source_id}/retry": {- "post": {- "operationId": "retry_web_source_sync_api_knowledge_bases__kb_name__web_source__source_id__retry_post",+ "/api/knowledge-bases/{kb_name}/visual-assets/{asset_id}": {+ "get": {+ "description": "Serve a verified source image from an access checked local KB.",+ "operationId": "serve_kb_visual_asset_api_knowledge_bases__kb_name__visual_assets__asset_id__get","parameters": [{"in": "path",@@ -25592,10 +26032,10 @@},{"in": "path",- "name": "source_id",+ "name": "asset_id","required": true,"schema": {- "title": "Source Id",+ "title": "Asset Id","type": "string"}},@@ -25652,15 +26092,15 @@"description": "Validation Error"}},- "summary": "Retry Web Source Sync",+ "summary": "Serve Kb Visual Asset","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/{kb_name}/web-source/{source_id}/schedule": {- "put": {- "operationId": "update_web_source_schedule_api_knowledge_bases__kb_name__web_source__source_id__schedule_put",+ "/api/knowledge-bases/{kb_name}/web-source": {+ "post": {+ "operationId": "add_web_source_api_knowledge_bases__kb_name__web_source_post","parameters": [{"in": "path",@@ -25671,15 +26111,6 @@"type": "string"}},- {- "in": "path",- "name": "source_id",- "required": true,- "schema": {- "title": "Source Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -25717,7 +26148,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/WebSourceScheduleUpdate"+ "$ref": "#/components/schemas/AddWebSourceRequest"}}},@@ -25745,15 +26176,15 @@"description": "Validation Error"}},- "summary": "Update Web Source Schedule",+ "summary": "Add Web Source","tags": ["knowledge-bases"]}},- "/api/knowledge-bases/{kb_name}/web-sources": {+ "/api/knowledge-bases/{kb_name}/web-source-sync": {"get": {- "operationId": "get_web_sources_api_knowledge_bases__kb_name__web_sources_get",+ "operationId": "get_web_source_sync_jobs_api_knowledge_bases__kb_name__web_source_sync_get","parameters": [{"in": "path",@@ -25803,9 +26234,9 @@"application/json": {"schema": {"items": {- "$ref": "#/components/schemas/WebSourceInfo"+ "$ref": "#/components/schemas/WebSourceSyncJobInfo"},- "title": "Response Get Web Sources Api Knowledge Bases Kb Name Web Sources Get",+ "title": "Response Get Web Source Sync Jobs Api Knowledge Bases Kb Name Web Source Sync Get","type": "array"}}@@ -25823,17 +26254,34 @@"description": "Validation Error"}},- "summary": "Get Web Sources",+ "summary": "Get Web Source Sync Jobs","tags": ["knowledge-bases"]}},- "/api/marginnote4/devices": {- "get": {- "description": "List all paired devices.",- "operationId": "list_devices_api_marginnote4_devices_get",+ "/api/knowledge-bases/{kb_name}/web-source/{source_id}": {+ "delete": {+ "operationId": "remove_web_source_api_knowledge_bases__kb_name__web_source__source_id__delete","parameters": [+ {+ "in": "path",+ "name": "kb_name",+ "required": true,+ "schema": {+ "title": "Kb Name",+ "type": "string"+ }+ },+ {+ "in": "path",+ "name": "source_id",+ "required": true,+ "schema": {+ "title": "Source Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -25871,13 +26319,7 @@"200": {"content": {"application/json": {- "schema": {- "items": {- "$ref": "#/components/schemas/DeviceInfo"- },- "title": "Response List Devices Api Marginnote4 Devices Get",- "type": "array"- }+ "schema": {}}},"description": "Successful Response"@@ -25893,23 +26335,31 @@"description": "Validation Error"}},- "summary": "List Devices",+ "summary": "Remove Web Source","tags": [- "marginnote4"+ "knowledge-bases"]}},- "/api/marginnote4/devices/{device_id}": {- "delete": {- "description": "Revoke a paired device.",- "operationId": "revoke_device_api_marginnote4_devices__device_id__delete",+ "/api/knowledge-bases/{kb_name}/web-source/{source_id}/cancel": {+ "post": {+ "operationId": "cancel_web_source_sync_api_knowledge_bases__kb_name__web_source__source_id__cancel_post","parameters": [{"in": "path",- "name": "device_id",+ "name": "kb_name","required": true,"schema": {- "title": "Device Id",+ "title": "Kb Name",+ "type": "string"+ }+ },+ {+ "in": "path",+ "name": "source_id",+ "required": true,+ "schema": {+ "title": "Source Id","type": "string"}},@@ -25950,13 +26400,7 @@"200": {"content": {"application/json": {- "schema": {- "additionalProperties": {- "type": "string"- },- "title": "Response Revoke Device Api Marginnote4 Devices Device Id Delete",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -25972,69 +26416,34 @@"description": "Validation Error"}},- "summary": "Revoke Device",+ "summary": "Cancel Web Source Sync","tags": [- "marginnote4"+ "knowledge-bases"]}},- "/api/marginnote4/heartbeat": {- "post": {- "description": "Lightweight liveness check. Updates last_seen for the device.",- "operationId": "heartbeat_api_marginnote4_heartbeat_post",+ "/api/knowledge-bases/{kb_name}/web-source/{source_id}/pairings": {+ "get": {+ "operationId": "get_web_source_pairings_api_knowledge_bases__kb_name__web_source__source_id__pairings_get","parameters": [{- "in": "header",- "name": "authorization",- "required": false,+ "in": "path",+ "name": "kb_name",+ "required": true,"schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Authorization"+ "title": "Kb Name",+ "type": "string"+ }+ },+ {+ "in": "path",+ "name": "source_id",+ "required": true,+ "schema": {+ "title": "Source Id",+ "type": "string"}- }- ],- "responses": {- "200": {- "content": {- "application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Heartbeat Api Marginnote4 Heartbeat Post",- "type": "object"- }- }- },- "description": "Successful Response"},- "422": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- },- "description": "Validation Error"- }- },- "summary": "Heartbeat",- "tags": [- "marginnote4"- ]- }- },- "/api/marginnote4/pair": {- "post": {- "description": "Pair a new MN4 device. Requires a DeepTutor session.\n\nReturns a one-time token the Add-on stores and presents on every sync.",- "operationId": "pair_device_api_marginnote4_pair_post",- "parameters": [{"in": "header","name": "Authorization",@@ -26068,22 +26477,16 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/PairRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/PairResponse"+ "items": {+ "$ref": "#/components/schemas/BilingualPairingInfo"+ },+ "title": "Response Get Web Source Pairings Api Knowledge Bases Kb Name Web Source Source Id Pairings Get",+ "type": "array"}}},@@ -26100,17 +26503,34 @@"description": "Validation Error"}},- "summary": "Pair Device",+ "summary": "Get Web Source Pairings","tags": [- "marginnote4"+ "knowledge-bases"]}},- "/api/marginnote4/status": {- "get": {- "description": "Health check and summary stats.",- "operationId": "status_api_marginnote4_status_get",+ "/api/knowledge-bases/{kb_name}/web-source/{source_id}/retry": {+ "post": {+ "operationId": "retry_web_source_sync_api_knowledge_bases__kb_name__web_source__source_id__retry_post","parameters": [+ {+ "in": "path",+ "name": "kb_name",+ "required": true,+ "schema": {+ "title": "Kb Name",+ "type": "string"+ }+ },+ {+ "in": "path",+ "name": "source_id",+ "required": true,+ "schema": {+ "title": "Source Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -26148,11 +26568,7 @@"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Status Api Marginnote4 Status Get",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -26168,20 +26584,37 @@"description": "Validation Error"}},- "summary": "Status",+ "summary": "Retry Web Source Sync","tags": [- "marginnote4"+ "knowledge-bases"]}},- "/api/marginnote4/sync": {- "post": {- "description": "Receive an incremental sync batch from a paired MN4 device.",- "operationId": "sync_objects_api_marginnote4_sync_post",+ "/api/knowledge-bases/{kb_name}/web-source/{source_id}/schedule": {+ "put": {+ "operationId": "update_web_source_schedule_api_knowledge_bases__kb_name__web_source__source_id__schedule_put","parameters": [+ {+ "in": "path",+ "name": "kb_name",+ "required": true,+ "schema": {+ "title": "Kb Name",+ "type": "string"+ }+ },+ {+ "in": "path",+ "name": "source_id",+ "required": true,+ "schema": {+ "title": "Source Id",+ "type": "string"+ }+ },{"in": "header",- "name": "authorization",+ "name": "Authorization","required": false,"schema": {"anyOf": [@@ -26194,13 +26627,29 @@],"title": "Authorization"}+ },+ {+ "in": "cookie",+ "name": "dt_token",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"+ }}],"requestBody": {"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/SyncRequest"+ "$ref": "#/components/schemas/WebSourceScheduleUpdate"}}},@@ -26211,7 +26660,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/SyncResponse"+ "$ref": "#/components/schemas/WebSourceInfo"}}},@@ -26228,16 +26677,25 @@"description": "Validation Error"}},- "summary": "Sync Objects",+ "summary": "Update Web Source Schedule","tags": [- "marginnote4"+ "knowledge-bases"]}},- "/api/mastery-paths/progress": {+ "/api/knowledge-bases/{kb_name}/web-sources": {"get": {- "operationId": "list_all_progress_api_mastery_paths_progress_get",+ "operationId": "get_web_sources_api_knowledge_bases__kb_name__web_sources_get","parameters": [+ {+ "in": "path",+ "name": "kb_name",+ "required": true,+ "schema": {+ "title": "Kb Name",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -26275,7 +26733,13 @@"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "items": {+ "$ref": "#/components/schemas/WebSourceInfo"+ },+ "title": "Response Get Web Sources Api Knowledge Bases Kb Name Web Sources Get",+ "type": "array"+ }}},"description": "Successful Response"@@ -26291,25 +26755,17 @@"description": "Validation Error"}},- "summary": "List All Progress",+ "summary": "Get Web Sources","tags": [- "mastery-path"+ "knowledge-bases"]}},- "/api/mastery-paths/progress/{book_id}": {- "delete": {- "operationId": "delete_progress_api_mastery_paths_progress__book_id__delete",+ "/api/marginnote4/devices": {+ "get": {+ "description": "List all paired devices.",+ "operationId": "list_devices_api_marginnote4_devices_get","parameters": [- {- "in": "path",- "name": "book_id",- "required": true,- "schema": {- "title": "Book Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -26347,7 +26803,13 @@"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "items": {+ "$ref": "#/components/schemas/DeviceInfo"+ },+ "title": "Response List Devices Api Marginnote4 Devices Get",+ "type": "array"+ }}},"description": "Successful Response"@@ -26363,20 +26825,23 @@"description": "Validation Error"}},- "summary": "Delete Progress",+ "summary": "List Devices","tags": [- "mastery-path"+ "marginnote4"]- },- "get": {- "operationId": "get_progress_api_mastery_paths_progress__book_id__get",+ }+ },+ "/api/marginnote4/devices/{device_id}": {+ "delete": {+ "description": "Revoke a paired device.",+ "operationId": "revoke_device_api_marginnote4_devices__device_id__delete","parameters": [{"in": "path",- "name": "book_id",+ "name": "device_id","required": true,"schema": {- "title": "Book Id",+ "title": "Device Id","type": "string"}},@@ -26417,7 +26882,13 @@"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": {+ "type": "string"+ },+ "title": "Response Revoke Device Api Marginnote4 Devices Device Id Delete",+ "type": "object"+ }}},"description": "Successful Response"@@ -26433,27 +26904,20 @@"description": "Validation Error"}},- "summary": "Get Progress",+ "summary": "Revoke Device","tags": [- "mastery-path"+ "marginnote4"]- },- "patch": {- "description": "Rename a path — the only edit that is the learner's rather than the tutor's.\n\nGuarded like every other path mutation so a rename cannot interleave with a\ntutoring turn's own commit, and emitted as an event so the activity feed\nrecords who called it what.",- "operationId": "rename_progress_api_mastery_paths_progress__book_id__patch",+ }+ },+ "/api/marginnote4/heartbeat": {+ "post": {+ "description": "Lightweight liveness check. Updates last_seen for the device.",+ "operationId": "heartbeat_api_marginnote4_heartbeat_post","parameters": [- {- "in": "path",- "name": "book_id",- "required": true,- "schema": {- "title": "Book Id",- "type": "string"- }- },{"in": "header",- "name": "Authorization",+ "name": "authorization","required": false,"schema": {"anyOf": [@@ -26466,39 +26930,17 @@],"title": "Authorization"}- },- {- "in": "cookie",- "name": "dt_token",- "required": false,- "schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Dt Token"- }}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/RenamePathRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": true,+ "title": "Response Heartbeat Api Marginnote4 Heartbeat Post",+ "type": "object"+ }}},"description": "Successful Response"@@ -26514,26 +26956,17 @@"description": "Validation Error"}},- "summary": "Rename Progress",+ "summary": "Heartbeat","tags": [- "mastery-path"+ "marginnote4"]}},- "/api/mastery-paths/progress/{book_id}/board": {- "get": {- "description": "The visual learning board: every knowledge point as a card, enriched\nwith its next review time and a deterministic grid position derived from\nthe module order. A read-only projection of the same mastery data the\ntutor and the map view use.",- "operationId": "get_progress_board_api_mastery_paths_progress__book_id__board_get",+ "/api/marginnote4/pair": {+ "post": {+ "description": "Pair a new MN4 device. Requires a DeepTutor session.\n\nReturns a one-time token the Add-on stores and presents on every sync.",+ "operationId": "pair_device_api_marginnote4_pair_post","parameters": [- {- "in": "path",- "name": "book_id",- "required": true,- "schema": {- "title": "Book Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -26567,11 +27000,23 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/PairRequest"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "$ref": "#/components/schemas/PairResponse"+ }}},"description": "Successful Response"@@ -26587,36 +27032,17 @@"description": "Validation Error"}},- "summary": "Get Progress Board",+ "summary": "Pair Device","tags": [- "mastery-path"+ "marginnote4"]}},- "/api/mastery-paths/progress/{book_id}/events": {+ "/api/marginnote4/status": {"get": {- "description": "Ordered, redacted domain events for reconnect and incremental UI sync.",- "operationId": "get_progress_events_api_mastery_paths_progress__book_id__events_get",+ "description": "Health check and summary stats.",+ "operationId": "status_api_marginnote4_status_get","parameters": [- {- "in": "path",- "name": "book_id",- "required": true,- "schema": {- "title": "Book Id",- "type": "string"- }- },- {- "in": "query",- "name": "after_revision",- "required": false,- "schema": {- "default": 0,- "title": "After Revision",- "type": "integer"- }- },{"in": "header","name": "Authorization",@@ -26654,7 +27080,11 @@"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": true,+ "title": "Response Status Api Marginnote4 Status Get",+ "type": "object"+ }}},"description": "Successful Response"@@ -26670,28 +27100,20 @@"description": "Validation Error"}},- "summary": "Get Progress Events",+ "summary": "Status","tags": [- "mastery-path"+ "marginnote4"]}},- "/api/mastery-paths/progress/{book_id}/generate-from-notebook": {+ "/api/marginnote4/sync": {"post": {- "operationId": "generate_from_notebook_api_mastery_paths_progress__book_id__generate_from_notebook_post",+ "description": "Receive an incremental sync batch from a paired MN4 device.",+ "operationId": "sync_objects_api_marginnote4_sync_post","parameters": [- {- "in": "path",- "name": "book_id",- "required": true,- "schema": {- "title": "Book Id",- "type": "string"- }- },{"in": "header",- "name": "Authorization",+ "name": "authorization","required": false,"schema": {"anyOf": [@@ -26704,29 +27126,13 @@],"title": "Authorization"}- },- {- "in": "cookie",- "name": "dt_token",- "required": false,- "schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Dt Token"- }}],"requestBody": {"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/GenerateFromNotebookRequest"+ "$ref": "#/components/schemas/SyncRequest"}}},@@ -26736,7 +27142,9 @@"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "$ref": "#/components/schemas/SyncResponse"+ }}},"description": "Successful Response"@@ -26752,26 +27160,16 @@"description": "Validation Error"}},- "summary": "Generate From Notebook",+ "summary": "Sync Objects","tags": [- "mastery-path"+ "marginnote4"]}},- "/api/mastery-paths/progress/{book_id}/generate-from-reading": {- "post": {- "description": "Create a mastery curriculum from a private reading workspace.",- "operationId": "generate_from_reading_api_mastery_paths_progress__book_id__generate_from_reading_post",+ "/api/mastery-paths/progress": {+ "get": {+ "operationId": "list_all_progress_api_mastery_paths_progress_get","parameters": [- {- "in": "path",- "name": "book_id",- "required": true,- "schema": {- "title": "Book Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -26805,16 +27203,6 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/GenerateFromReadingRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {@@ -26835,15 +27223,15 @@"description": "Validation Error"}},- "summary": "Generate From Reading",+ "summary": "List All Progress","tags": ["mastery-path"]}},- "/api/mastery-paths/progress/{book_id}/import-from-book": {- "post": {- "operationId": "import_from_book_api_mastery_paths_progress__book_id__import_from_book_post",+ "/api/mastery-paths/progress/{book_id}": {+ "delete": {+ "operationId": "delete_progress_api_mastery_paths_progress__book_id__delete","parameters": [{"in": "path",@@ -26887,16 +27275,6 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/ImportFromBookRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {@@ -26917,15 +27295,13 @@"description": "Validation Error"}},- "summary": "Import From Book",+ "summary": "Delete Progress","tags": ["mastery-path"]- }- },- "/api/mastery-paths/progress/{book_id}/init-modules": {- "post": {- "operationId": "init_modules_api_mastery_paths_progress__book_id__init_modules_post",+ },+ "get": {+ "operationId": "get_progress_api_mastery_paths_progress__book_id__get","parameters": [{"in": "path",@@ -26969,16 +27345,6 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/InitModulesRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {@@ -26999,16 +27365,14 @@"description": "Validation Error"}},- "summary": "Init Modules",+ "summary": "Get Progress","tags": ["mastery-path"]- }- },- "/api/mastery-paths/progress/{book_id}/map": {- "get": {- "description": "The dashboard view of a path: the gate-decided next step plus a map of\nevery objective's status (new / learning / mastered). The per-type gate\nlives in ``learning.policy`` so the dashboard and the tutor agree.",- "operationId": "get_progress_map_api_mastery_paths_progress__book_id__map_get",+ },+ "patch": {+ "description": "Rename a path — the only edit that is the learner's rather than the tutor's.\n\nGuarded like every other path mutation so a rename cannot interleave with a\ntutoring turn's own commit, and emitted as an event so the activity feed\nrecords who called it what.",+ "operationId": "rename_progress_api_mastery_paths_progress__book_id__patch","parameters": [{"in": "path",@@ -27052,6 +27416,16 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/RenamePathRequest"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -27072,16 +27446,16 @@"description": "Validation Error"}},- "summary": "Get Progress Map",+ "summary": "Rename Progress","tags": ["mastery-path"]}},- "/api/mastery-paths/progress/{book_id}/objectives/{kp_id}": {+ "/api/mastery-paths/progress/{book_id}/board": {"get": {- "description": "The evidence behind one objective: attempts, schedule, errors, prompts.\n\n``policy.objective_report`` is pure over the aggregate, so the questions\nthemselves — which live in the durable interaction log, not the aggregate —\nare joined on here, redacted of their answer keys.",- "operationId": "get_objective_report_api_mastery_paths_progress__book_id__objectives__kp_id__get",+ "description": "The visual learning board: every knowledge point as a card, enriched\nwith its next review time and a deterministic grid position derived from\nthe module order. A read-only projection of the same mastery data the\ntutor and the map view use.",+ "operationId": "get_progress_board_api_mastery_paths_progress__book_id__board_get","parameters": [{"in": "path",@@ -27092,15 +27466,6 @@"type": "string"}},- {- "in": "path",- "name": "kp_id",- "required": true,- "schema": {- "title": "Kp Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -27154,15 +27519,16 @@"description": "Validation Error"}},- "summary": "Get Objective Report",+ "summary": "Get Progress Board","tags": ["mastery-path"]}},- "/api/mastery-paths/progress/{book_id}/redo": {- "post": {- "operationId": "redo_progress_api_mastery_paths_progress__book_id__redo_post",+ "/api/mastery-paths/progress/{book_id}/events": {+ "get": {+ "description": "Ordered, redacted domain events for reconnect and incremental UI sync.",+ "operationId": "get_progress_events_api_mastery_paths_progress__book_id__events_get","parameters": [{"in": "path",@@ -27173,6 +27539,16 @@"type": "string"}},+ {+ "in": "query",+ "name": "after_revision",+ "required": false,+ "schema": {+ "default": 0,+ "title": "After Revision",+ "type": "integer"+ }+ },{"in": "header","name": "Authorization",@@ -27226,16 +27602,15 @@"description": "Validation Error"}},- "summary": "Redo Progress",+ "summary": "Get Progress Events","tags": ["mastery-path"]}},- "/api/mastery-paths/progress/{book_id}/sessions": {- "get": {- "description": "Expose the explicit conversation associations for this path.",- "operationId": "get_progress_sessions_api_mastery_paths_progress__book_id__sessions_get",+ "/api/mastery-paths/progress/{book_id}/generate-from-notebook": {+ "post": {+ "operationId": "generate_from_notebook_api_mastery_paths_progress__book_id__generate_from_notebook_post","parameters": [{"in": "path",@@ -27279,6 +27654,16 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/GenerateFromNotebookRequest"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -27299,16 +27684,16 @@"description": "Validation Error"}},- "summary": "Get Progress Sessions",+ "summary": "Generate From Notebook","tags": ["mastery-path"]}},- "/api/mastery-paths/progress/{book_id}/skip-question": {+ "/api/mastery-paths/progress/{book_id}/generate-from-reading": {"post": {- "description": "Drop an outstanding question the learner can no longer answer.\n\nThe narrow escape hatch for a path stalled on ``answer_pending``; unlike\n``redo`` it keeps every mastery level and review the learner has earned.",- "operationId": "skip_pending_question_api_mastery_paths_progress__book_id__skip_question_post",+ "description": "Create a mastery curriculum from a private reading workspace.",+ "operationId": "generate_from_reading_api_mastery_paths_progress__book_id__generate_from_reading_post","parameters": [{"in": "path",@@ -27352,6 +27737,16 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/GenerateFromReadingRequest"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -27372,82 +27767,25 @@"description": "Validation Error"}},- "summary": "Skip Pending Question",+ "summary": "Generate From Reading","tags": ["mastery-path"]}},- "/api/mastery-paths/reading/records": {- "get": {- "description": "Reading progress and extension activity for the current account.",- "operationId": "list_reading_learning_records_api_mastery_paths_reading_records_get",+ "/api/mastery-paths/progress/{book_id}/import-from-book": {+ "post": {+ "operationId": "import_from_book_api_mastery_paths_progress__book_id__import_from_book_post","parameters": [{- "in": "header",- "name": "Authorization",- "required": false,- "schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Authorization"- }- },- {- "in": "cookie",- "name": "dt_token",- "required": false,+ "in": "path",+ "name": "book_id",+ "required": true,"schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Dt Token"+ "title": "Book Id",+ "type": "string"}- }- ],- "responses": {- "200": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/ReadingLearningRecords"- }- }- },- "description": "Successful Response"},- "422": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- },- "description": "Validation Error"- }- },- "summary": "List Reading Learning Records",- "tags": [- "mastery-path"- ]- }- },- "/api/mastery-paths/topics": {- "get": {- "operationId": "list_topics_api_mastery_paths_topics_get",- "parameters": [{"in": "header","name": "Authorization",@@ -27481,6 +27819,16 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/ImportFromBookRequest"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -27501,14 +27849,25 @@"description": "Validation Error"}},- "summary": "List Topics",+ "summary": "Import From Book","tags": ["mastery-path"]- },+ }+ },+ "/api/mastery-paths/progress/{book_id}/init-modules": {"post": {- "operationId": "create_topic_api_mastery_paths_topics_post",+ "operationId": "init_modules_api_mastery_paths_progress__book_id__init_modules_post","parameters": [+ {+ "in": "path",+ "name": "book_id",+ "required": true,+ "schema": {+ "title": "Book Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -27546,7 +27905,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/ConfirmTopicRequest"+ "$ref": "#/components/schemas/InitModulesRequest"}}},@@ -27572,16 +27931,26 @@"description": "Validation Error"}},- "summary": "Create Topic",+ "summary": "Init Modules","tags": ["mastery-path"]}},- "/api/mastery-paths/topics/draft": {- "post": {- "operationId": "generate_topic_route_api_mastery_paths_topics_draft_post",+ "/api/mastery-paths/progress/{book_id}/map": {+ "get": {+ "description": "The dashboard view of a path: the gate-decided next step plus a map of\nevery objective's status (new / learning / mastered). The per-type gate\nlives in ``learning.policy`` so the dashboard and the tutor agree.",+ "operationId": "get_progress_map_api_mastery_paths_progress__book_id__map_get","parameters": [+ {+ "in": "path",+ "name": "book_id",+ "required": true,+ "schema": {+ "title": "Book Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -27615,16 +27984,6 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/GenerateTopicDraftRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {@@ -27645,17 +28004,35 @@"description": "Validation Error"}},- "summary": "Generate Topic Route",+ "summary": "Get Progress Map","tags": ["mastery-path"]}},- "/api/mastery-paths/topics/index": {+ "/api/mastery-paths/progress/{book_id}/objectives/{kp_id}": {"get": {- "description": "Just enough to *name* a topic: id, title, emoji.\n\nThe sidebar groups study conversations under their topic, and it refreshes\non every stream end. ``/topics`` answers with each path's whole knowledge\nmap, review queue and source excerpts — kilobytes per topic, none of which\na group header renders. This is the same walk with the payload cut to what\na label needs.\n\nDeclared above ``/topics/{path_id}``: that route matches any single\nsegment, so a literal path below it would never be reached.",- "operationId": "list_topic_index_api_mastery_paths_topics_index_get",+ "description": "The evidence behind one objective: attempts, schedule, errors, prompts.\n\n``policy.objective_report`` is pure over the aggregate, so the questions\nthemselves — which live in the durable interaction log, not the aggregate —\nare joined on here, redacted of their answer keys.",+ "operationId": "get_objective_report_api_mastery_paths_progress__book_id__objectives__kp_id__get","parameters": [+ {+ "in": "path",+ "name": "book_id",+ "required": true,+ "schema": {+ "title": "Book Id",+ "type": "string"+ }+ },+ {+ "in": "path",+ "name": "kp_id",+ "required": true,+ "schema": {+ "title": "Kp Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -27709,22 +28086,22 @@"description": "Validation Error"}},- "summary": "List Topic Index",+ "summary": "Get Objective Report","tags": ["mastery-path"]}},- "/api/mastery-paths/topics/{path_id}": {- "get": {- "operationId": "get_topic_api_mastery_paths_topics__path_id__get",+ "/api/mastery-paths/progress/{book_id}/redo": {+ "post": {+ "operationId": "redo_progress_api_mastery_paths_progress__book_id__redo_post","parameters": [{"in": "path",- "name": "path_id",+ "name": "book_id","required": true,"schema": {- "title": "Path Id",+ "title": "Book Id","type": "string"}},@@ -27781,33 +28158,23 @@"description": "Validation Error"}},- "summary": "Get Topic",+ "summary": "Redo Progress","tags": ["mastery-path"]}},- "/api/mastery-paths/topics/{path_id}/ask-hint": {+ "/api/mastery-paths/progress/{book_id}/sessions": {"get": {- "description": "One question the learner could ask here, for the composer placeholder.\n\nWritten by the task model, never blocking: an empty ``hint`` means the\ncomposer keeps the static placeholder it has always had.",- "operationId": "get_topic_ask_hint_api_mastery_paths_topics__path_id__ask_hint_get",+ "description": "Expose the explicit conversation associations for this path.",+ "operationId": "get_progress_sessions_api_mastery_paths_progress__book_id__sessions_get","parameters": [{"in": "path",- "name": "path_id",+ "name": "book_id","required": true,"schema": {- "title": "Path Id",- "type": "string"- }- },- {- "in": "query",- "name": "session_id",- "required": false,- "schema": {- "default": "",- "title": "Session Id",+ "title": "Book Id","type": "string"}},@@ -27864,22 +28231,23 @@"description": "Validation Error"}},- "summary": "Get Topic Ask Hint",+ "summary": "Get Progress Sessions","tags": ["mastery-path"]}},- "/api/mastery-paths/topics/{path_id}/map": {- "put": {- "operationId": "edit_topic_map_api_mastery_paths_topics__path_id__map_put",+ "/api/mastery-paths/progress/{book_id}/skip-question": {+ "post": {+ "description": "Drop an outstanding question the learner can no longer answer.\n\nThe narrow escape hatch for a path stalled on ``answer_pending``; unlike\n``redo`` it keeps every mastery level and review the learner has earned.",+ "operationId": "skip_pending_question_api_mastery_paths_progress__book_id__skip_question_post","parameters": [{"in": "path",- "name": "path_id",+ "name": "book_id","required": true,"schema": {- "title": "Path Id",+ "title": "Book Id","type": "string"}},@@ -27916,16 +28284,6 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/EditTopicMapRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {@@ -27946,34 +28304,17 @@"description": "Validation Error"}},- "summary": "Edit Topic Map",+ "summary": "Skip Pending Question","tags": ["mastery-path"]}},- "/api/mastery-paths/topics/{path_id}/objectives/{kp_id}/override": {- "post": {- "operationId": "set_learner_override_api_mastery_paths_topics__path_id__objectives__kp_id__override_post",+ "/api/mastery-paths/reading/records": {+ "get": {+ "description": "Reading progress and extension activity for the current account.",+ "operationId": "list_reading_learning_records_api_mastery_paths_reading_records_get","parameters": [- {- "in": "path",- "name": "path_id",- "required": true,- "schema": {- "title": "Path Id",- "type": "string"- }- },- {- "in": "path",- "name": "kp_id",- "required": true,- "schema": {- "title": "Kp Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -28007,21 +28348,13 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/LearnerOverrideRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "$ref": "#/components/schemas/ReadingLearningRecords"+ }}},"description": "Successful Response"@@ -28037,25 +28370,16 @@"description": "Validation Error"}},- "summary": "Set Learner Override",+ "summary": "List Reading Learning Records","tags": ["mastery-path"]}},- "/api/mastery-paths/topics/{path_id}/review-settings": {+ "/api/mastery-paths/topics": {"get": {- "operationId": "get_review_settings_api_mastery_paths_topics__path_id__review_settings_get",+ "operationId": "list_topics_api_mastery_paths_topics_get","parameters": [- {- "in": "path",- "name": "path_id",- "required": true,- "schema": {- "title": "Path Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -28109,23 +28433,14 @@"description": "Validation Error"}},- "summary": "Get Review Settings",+ "summary": "List Topics","tags": ["mastery-path"]},- "put": {- "operationId": "update_review_settings_api_mastery_paths_topics__path_id__review_settings_put",+ "post": {+ "operationId": "create_topic_api_mastery_paths_topics_post","parameters": [- {- "in": "path",- "name": "path_id",- "required": true,- "schema": {- "title": "Path Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -28163,7 +28478,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/ReviewSettingsRequest"+ "$ref": "#/components/schemas/ConfirmTopicRequest"}}},@@ -28189,107 +28504,16 @@"description": "Validation Error"}},- "summary": "Update Review Settings",- "tags": [- "mastery-path"- ]- }- },- "/api/mastery-paths/topics/{path_id}/sessions": {- "get": {- "operationId": "list_topic_sessions_api_mastery_paths_topics__path_id__sessions_get",- "parameters": [- {- "in": "path",- "name": "path_id",- "required": true,- "schema": {- "title": "Path Id",- "type": "string"- }- },- {- "in": "header",- "name": "Authorization",- "required": false,- "schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Authorization"- }- },- {- "in": "cookie",- "name": "dt_token",- "required": false,- "schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Dt Token"- }- }- ],- "responses": {- "200": {- "content": {- "application/json": {- "schema": {}- }- },- "description": "Successful Response"- },- "422": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- },- "description": "Validation Error"- }- },- "summary": "List Topic Sessions",+ "summary": "Create Topic","tags": ["mastery-path"]}},- "/api/mastery-paths/topics/{path_id}/sessions/{session_id}/mode": {- "put": {- "description": "Change what a conversation is doing, from the learner's own buttons.\n\nThe same move the tutor makes with ``mastery_mode``, through the same\nadmission rule — so pressing \"Study\" on a goal with no outline is refused\nwith the sentence the tutor would have said, rather than silently putting\nthe conversation somewhere its tools will then refuse to work.",- "operationId": "set_session_mode_api_mastery_paths_topics__path_id__sessions__session_id__mode_put",+ "/api/mastery-paths/topics/draft": {+ "post": {+ "operationId": "generate_topic_route_api_mastery_paths_topics_draft_post","parameters": [- {- "in": "path",- "name": "path_id",- "required": true,- "schema": {- "title": "Path Id",- "type": "string"- }- },- {- "in": "path",- "name": "session_id",- "required": true,- "schema": {- "title": "Session Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -28327,7 +28551,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/SetSessionModeRequest"+ "$ref": "#/components/schemas/GenerateTopicDraftRequest"}}},@@ -28353,15 +28577,16 @@"description": "Validation Error"}},- "summary": "Set Session Mode",+ "summary": "Generate Topic Route","tags": ["mastery-path"]}},- "/api/memory/backup": {+ "/api/mastery-paths/topics/index": {"get": {- "operationId": "list_backups_api_memory_backup_get",+ "description": "Just enough to *name* a topic: id, title, emoji.\n\nThe sidebar groups study conversations under their topic, and it refreshes\non every stream end. ``/topics`` answers with each path's whole knowledge\nmap, review queue and source excerpts — kilobytes per topic, none of which\na group header renders. This is the same walk with the payload cut to what\na label needs.\n\nDeclared above ``/topics/{path_id}``: that route matches any single\nsegment, so a literal path below it would never be reached.",+ "operationId": "list_topic_index_api_mastery_paths_topics_index_get","parameters": [{"in": "header",@@ -28416,31 +28641,22 @@"description": "Validation Error"}},- "summary": "List Backups",+ "summary": "List Topic Index","tags": [- "memory"+ "mastery-path"]}},- "/api/memory/doc/{layer}/{key}": {+ "/api/mastery-paths/topics/{path_id}": {"get": {- "operationId": "get_doc_api_memory_doc__layer___key__get",+ "operationId": "get_topic_api_mastery_paths_topics__path_id__get","parameters": [{"in": "path",- "name": "layer",- "required": true,- "schema": {- "title": "Layer",- "type": "string"- }- },- {- "in": "path",- "name": "key",+ "name": "path_id","required": true,"schema": {- "title": "Key",+ "title": "Path Id","type": "string"}},@@ -28497,29 +28713,33 @@"description": "Validation Error"}},- "summary": "Get Doc",+ "summary": "Get Topic","tags": [- "memory"+ "mastery-path"]- },- "put": {- "operationId": "put_doc_api_memory_doc__layer___key__put",+ }+ },+ "/api/mastery-paths/topics/{path_id}/ask-hint": {+ "get": {+ "description": "One question the learner could ask here, for the composer placeholder.\n\nWritten by the task model, never blocking: an empty ``hint`` means the\ncomposer keeps the static placeholder it has always had.",+ "operationId": "get_topic_ask_hint_api_mastery_paths_topics__path_id__ask_hint_get","parameters": [{"in": "path",- "name": "layer",+ "name": "path_id","required": true,"schema": {- "title": "Layer",+ "title": "Path Id","type": "string"}},{- "in": "path",- "name": "key",- "required": true,+ "in": "query",+ "name": "session_id",+ "required": false,"schema": {- "title": "Key",+ "default": "",+ "title": "Session Id","type": "string"}},@@ -28556,16 +28776,6 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/DocWriteRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {@@ -28586,32 +28796,22 @@"description": "Validation Error"}},- "summary": "Put Doc",+ "summary": "Get Topic Ask Hint","tags": [- "memory"+ "mastery-path"]}},- "/api/memory/doc/{layer}/{key}/apply": {- "post": {- "description": "Commit a list of previously-previewed ops to a doc atomically.",- "operationId": "apply_doc_ops_api_memory_doc__layer___key__apply_post",+ "/api/mastery-paths/topics/{path_id}/map": {+ "put": {+ "operationId": "edit_topic_map_api_mastery_paths_topics__path_id__map_put","parameters": [{"in": "path",- "name": "layer",- "required": true,- "schema": {- "title": "Layer",- "type": "string"- }- },- {- "in": "path",- "name": "key",+ "name": "path_id","required": true,"schema": {- "title": "Key",+ "title": "Path Id","type": "string"}},@@ -28652,7 +28852,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/ApplyOpsRequest"+ "$ref": "#/components/schemas/EditTopicMapRequest"}}},@@ -28678,31 +28878,31 @@"description": "Validation Error"}},- "summary": "Apply Doc Ops",+ "summary": "Edit Topic Map","tags": [- "memory"+ "mastery-path"]}},- "/api/memory/doc/{layer}/{key}/audit": {+ "/api/mastery-paths/topics/{path_id}/objectives/{kp_id}/override": {"post": {- "operationId": "audit_doc_api_memory_doc__layer___key__audit_post",+ "operationId": "set_learner_override_api_mastery_paths_topics__path_id__objectives__kp_id__override_post","parameters": [{"in": "path",- "name": "layer",+ "name": "path_id","required": true,"schema": {- "title": "Layer",+ "title": "Path Id","type": "string"}},{"in": "path",- "name": "key",+ "name": "kp_id","required": true,"schema": {- "title": "Key",+ "title": "Kp Id","type": "string"}},@@ -28743,18 +28943,11 @@"content": {"application/json": {"schema": {- "anyOf": [- {- "$ref": "#/components/schemas/AuditRequest"- },- {- "type": "null"- }- ],- "title": "Payload"+ "$ref": "#/components/schemas/LearnerOverrideRequest"}}- }+ },+ "required": true},"responses": {"200": {@@ -28776,31 +28969,92 @@"description": "Validation Error"}},- "summary": "Audit Doc",+ "summary": "Set Learner Override","tags": [- "memory"+ "mastery-path"]}},- "/api/memory/doc/{layer}/{key}/dedup": {- "post": {- "operationId": "dedup_doc_api_memory_doc__layer___key__dedup_post",+ "/api/mastery-paths/topics/{path_id}/review-settings": {+ "get": {+ "operationId": "get_review_settings_api_mastery_paths_topics__path_id__review_settings_get","parameters": [{"in": "path",- "name": "layer",+ "name": "path_id","required": true,"schema": {- "title": "Layer",+ "title": "Path Id","type": "string"}},+ {+ "in": "header",+ "name": "Authorization",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"+ }+ },+ {+ "in": "cookie",+ "name": "dt_token",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"+ }+ }+ ],+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {}+ }+ },+ "description": "Successful Response"+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "Get Review Settings",+ "tags": [+ "mastery-path"+ ]+ },+ "put": {+ "operationId": "update_review_settings_api_mastery_paths_topics__path_id__review_settings_put",+ "parameters": [{"in": "path",- "name": "key",+ "name": "path_id","required": true,"schema": {- "title": "Key",+ "title": "Path Id","type": "string"}},@@ -28841,18 +29095,11 @@"content": {"application/json": {"schema": {- "anyOf": [- {- "$ref": "#/components/schemas/DedupRequest"- },- {- "type": "null"- }- ],- "title": "Payload"+ "$ref": "#/components/schemas/ReviewSettingsRequest"}}- }+ },+ "required": true},"responses": {"200": {@@ -28874,40 +29121,22 @@"description": "Validation Error"}},- "summary": "Dedup Doc",+ "summary": "Update Review Settings","tags": [- "memory"+ "mastery-path"]}},- "/api/memory/doc/{layer}/{key}/entry/{entry_id}": {- "delete": {- "operationId": "delete_entry_api_memory_doc__layer___key__entry__entry_id__delete",+ "/api/mastery-paths/topics/{path_id}/sessions": {+ "get": {+ "operationId": "list_topic_sessions_api_mastery_paths_topics__path_id__sessions_get","parameters": [{"in": "path",- "name": "layer",- "required": true,- "schema": {- "title": "Layer",- "type": "string"- }- },- {- "in": "path",- "name": "key",- "required": true,- "schema": {- "title": "Key",- "type": "string"- }- },- {- "in": "path",- "name": "entry_id",+ "name": "path_id","required": true,"schema": {- "title": "Entry Id",+ "title": "Path Id","type": "string"}},@@ -28964,32 +29193,32 @@"description": "Validation Error"}},- "summary": "Delete Entry",+ "summary": "List Topic Sessions","tags": [- "memory"+ "mastery-path"]}},- "/api/memory/doc/{layer}/{key}/lines": {- "get": {- "description": "Return the line-numbered, footnote-stripped view of a doc.\n\nUsed by the workbench's \"show line numbers\" toggle so the same line\nindices the audit/dedup LLMs see are visible to the user. Footnote\nblock is omitted because edit ops never reference it directly.",- "operationId": "get_doc_lines_api_memory_doc__layer___key__lines_get",+ "/api/mastery-paths/topics/{path_id}/sessions/{session_id}/mode": {+ "put": {+ "description": "Change what a conversation is doing, from the learner's own buttons.\n\nThe same move the tutor makes with ``mastery_mode``, through the same\nadmission rule — so pressing \"Study\" on a goal with no outline is refused\nwith the sentence the tutor would have said, rather than silently putting\nthe conversation somewhere its tools will then refuse to work.",+ "operationId": "set_session_mode_api_mastery_paths_topics__path_id__sessions__session_id__mode_put","parameters": [{"in": "path",- "name": "layer",+ "name": "path_id","required": true,"schema": {- "title": "Layer",+ "title": "Path Id","type": "string"}},{"in": "path",- "name": "key",+ "name": "session_id","required": true,"schema": {- "title": "Key",+ "title": "Session Id","type": "string"}},@@ -29026,6 +29255,16 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/SetSessionModeRequest"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -29046,35 +29285,16 @@"description": "Validation Error"}},- "summary": "Get Doc Lines",+ "summary": "Set Session Mode","tags": [- "memory"+ "mastery-path"]}},- "/api/memory/doc/{layer}/{key}/reset": {- "post": {- "description": "Wipe the doc + its meta sidecar so the next update starts fresh.\n\nDestructive — the caller has confirmed. After this returns the .md\nfile is gone *and* the ``seen_entity_refs`` set is cleared, so a\nsubsequent ``run_update`` re-ingests every L1 entity instead of\ntreating them as already-seen.\n\nRefuses while a consolidator run is active on this doc; the caller\ncan cancel first.",- "operationId": "reset_doc_api_memory_doc__layer___key__reset_post",+ "/api/memory/backup": {+ "get": {+ "operationId": "list_backups_api_memory_backup_get","parameters": [- {- "in": "path",- "name": "layer",- "required": true,- "schema": {- "title": "Layer",- "type": "string"- }- },- {- "in": "path",- "name": "key",- "required": true,- "schema": {- "title": "Key",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -29128,15 +29348,15 @@"description": "Validation Error"}},- "summary": "Reset Doc",+ "summary": "List Backups","tags": ["memory"]}},- "/api/memory/doc/{layer}/{key}/update": {- "post": {- "operationId": "update_doc_api_memory_doc__layer___key__update_post",+ "/api/memory/doc/{layer}/{key}": {+ "get": {+ "operationId": "get_doc_api_memory_doc__layer___key__get","parameters": [{"in": "path",@@ -29189,23 +29409,6 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "anyOf": [- {- "$ref": "#/components/schemas/UpdateRequest"- },- {- "type": "null"- }- ],- "title": "Payload"- }- }- }- },"responses": {"200": {"content": {@@ -29226,16 +29429,32 @@"description": "Validation Error"}},- "summary": "Update Doc",+ "summary": "Get Doc","tags": ["memory"]- }- },- "/api/memory/overview": {- "get": {- "operationId": "get_overview_api_memory_overview_get",+ },+ "put": {+ "operationId": "put_doc_api_memory_doc__layer___key__put","parameters": [+ {+ "in": "path",+ "name": "layer",+ "required": true,+ "schema": {+ "title": "Layer",+ "type": "string"+ }+ },+ {+ "in": "path",+ "name": "key",+ "required": true,+ "schema": {+ "title": "Key",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -29269,6 +29488,16 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/DocWriteRequest"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -29289,23 +29518,32 @@"description": "Validation Error"}},- "summary": "Get Overview",+ "summary": "Put Doc","tags": ["memory"]}},- "/api/memory/resolve_entry/{entry_id}": {- "get": {- "description": "Find which L2 doc owns this entry id.\n\nL3 docs cite L2 entries by their ``m_<ULID>`` entry id; the workbench\nUI uses this resolver to turn an L3 footnote click into a navigation\nto the right L2 surface + scroll-to anchor.\n\nScans the seven L2 mds in order; first hit wins. 404 if no L2 doc\ncontains the id (e.g. the entry was deleted or the id is stale).",- "operationId": "resolve_entry_api_memory_resolve_entry__entry_id__get",+ "/api/memory/doc/{layer}/{key}/apply": {+ "post": {+ "description": "Commit a list of previously-previewed ops to a doc atomically.",+ "operationId": "apply_doc_ops_api_memory_doc__layer___key__apply_post","parameters": [{"in": "path",- "name": "entry_id",+ "name": "layer","required": true,"schema": {- "title": "Entry Id",+ "title": "Layer",+ "type": "string"+ }+ },+ {+ "in": "path",+ "name": "key",+ "required": true,+ "schema": {+ "title": "Key","type": "string"}},@@ -29342,6 +29580,16 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/ApplyOpsRequest"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -29362,46 +29610,32 @@"description": "Validation Error"}},- "summary": "Resolve Entry",+ "summary": "Apply Doc Ops","tags": ["memory"]}},- "/api/memory/runs": {- "get": {- "operationId": "list_runs_api_memory_runs_get",+ "/api/memory/doc/{layer}/{key}/audit": {+ "post": {+ "operationId": "audit_doc_api_memory_doc__layer___key__audit_post","parameters": [{- "in": "query",+ "in": "path","name": "layer",- "required": false,+ "required": true,"schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Layer"+ "title": "Layer",+ "type": "string"}},{- "in": "query",+ "in": "path","name": "key",- "required": false,+ "required": true,"schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Key"+ "title": "Key",+ "type": "string"}},{@@ -29437,6 +29671,23 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "anyOf": [+ {+ "$ref": "#/components/schemas/AuditRequest"+ },+ {+ "type": "null"+ }+ ],+ "title": "Payload"+ }+ }+ }+ },"responses": {"200": {"content": {@@ -29457,17 +29708,34 @@"description": "Validation Error"}},- "summary": "List Runs",+ "summary": "Audit Doc","tags": ["memory"]}},- "/api/memory/runs/start": {+ "/api/memory/doc/{layer}/{key}/dedup": {"post": {- "description": "Start one consolidator mode and return a run handle.\n\nThe run survives client disconnects; reconnect via\n``GET /runs/{id}/events?since=N``.",- "operationId": "start_run_api_memory_runs_start_post",+ "operationId": "dedup_doc_api_memory_doc__layer___key__dedup_post","parameters": [+ {+ "in": "path",+ "name": "layer",+ "required": true,+ "schema": {+ "title": "Layer",+ "type": "string"+ }+ },+ {+ "in": "path",+ "name": "key",+ "required": true,+ "schema": {+ "title": "Key",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -29505,11 +29773,18 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/RunStartRequest"+ "anyOf": [+ {+ "$ref": "#/components/schemas/DedupRequest"+ },+ {+ "type": "null"+ }+ ],+ "title": "Payload"}}- },- "required": true+ }},"responses": {"200": {@@ -29531,22 +29806,40 @@"description": "Validation Error"}},- "summary": "Start Run",+ "summary": "Dedup Doc","tags": ["memory"]}},- "/api/memory/runs/{run_id}": {- "get": {- "operationId": "get_run_api_memory_runs__run_id__get",+ "/api/memory/doc/{layer}/{key}/entry/{entry_id}": {+ "delete": {+ "operationId": "delete_entry_api_memory_doc__layer___key__entry__entry_id__delete","parameters": [{"in": "path",- "name": "run_id",+ "name": "layer","required": true,"schema": {- "title": "Run Id",+ "title": "Layer",+ "type": "string"+ }+ },+ {+ "in": "path",+ "name": "key",+ "required": true,+ "schema": {+ "title": "Key",+ "type": "string"+ }+ },+ {+ "in": "path",+ "name": "entry_id",+ "required": true,+ "schema": {+ "title": "Entry Id","type": "string"}},@@ -29603,22 +29896,32 @@"description": "Validation Error"}},- "summary": "Get Run",+ "summary": "Delete Entry","tags": ["memory"]}},- "/api/memory/runs/{run_id}/cancel": {- "post": {- "operationId": "cancel_run_api_memory_runs__run_id__cancel_post",+ "/api/memory/doc/{layer}/{key}/lines": {+ "get": {+ "description": "Return the line-numbered, footnote-stripped view of a doc.\n\nUsed by the workbench's \"show line numbers\" toggle so the same line\nindices the audit/dedup LLMs see are visible to the user. Footnote\nblock is omitted because edit ops never reference it directly.",+ "operationId": "get_doc_lines_api_memory_doc__layer___key__lines_get","parameters": [{"in": "path",- "name": "run_id",+ "name": "layer","required": true,"schema": {- "title": "Run Id",+ "title": "Layer",+ "type": "string"+ }+ },+ {+ "in": "path",+ "name": "key",+ "required": true,+ "schema": {+ "title": "Key","type": "string"}},@@ -29675,34 +29978,33 @@"description": "Validation Error"}},- "summary": "Cancel Run",+ "summary": "Get Doc Lines","tags": ["memory"]}},- "/api/memory/runs/{run_id}/events": {- "get": {- "description": "SSE-replay events from the next sequence cursor until the run ends.\n\nReconnecting after a refresh: pass ``last_seen_seq + 1``. The manager\nreplays the buffered tail, then blocks on new events until the run reaches\na terminal state.",- "operationId": "stream_run_events_api_memory_runs__run_id__events_get",+ "/api/memory/doc/{layer}/{key}/reset": {+ "post": {+ "description": "Wipe the doc + its meta sidecar so the next update starts fresh.\n\nDestructive — the caller has confirmed. After this returns the .md\nfile is gone *and* the ``seen_entity_refs`` set is cleared, so a\nsubsequent ``run_update`` re-ingests every L1 entity instead of\ntreating them as already-seen.\n\nRefuses while a consolidator run is active on this doc; the caller\ncan cancel first.",+ "operationId": "reset_doc_api_memory_doc__layer___key__reset_post","parameters": [{"in": "path",- "name": "run_id",+ "name": "layer","required": true,"schema": {- "title": "Run Id",+ "title": "Layer","type": "string"}},{- "in": "query",- "name": "since",- "required": false,+ "in": "path",+ "name": "key",+ "required": true,"schema": {- "default": 0,- "title": "Since",- "type": "integer"+ "title": "Key",+ "type": "string"}},{@@ -29758,22 +30060,31 @@"description": "Validation Error"}},- "summary": "Stream Run Events",+ "summary": "Reset Doc","tags": ["memory"]}},- "/api/memory/runs/{run_id}/undo": {+ "/api/memory/doc/{layer}/{key}/update": {"post": {- "operationId": "undo_run_edit_api_memory_runs__run_id__undo_post",+ "operationId": "update_doc_api_memory_doc__layer___key__update_post","parameters": [{"in": "path",- "name": "run_id",+ "name": "layer","required": true,"schema": {- "title": "Run Id",+ "title": "Layer",+ "type": "string"+ }+ },+ {+ "in": "path",+ "name": "key",+ "required": true,+ "schema": {+ "title": "Key","type": "string"}},@@ -29810,6 +30121,23 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "anyOf": [+ {+ "$ref": "#/components/schemas/UpdateRequest"+ },+ {+ "type": "null"+ }+ ],+ "title": "Payload"+ }+ }+ }+ },"responses": {"200": {"content": {@@ -29830,16 +30158,15 @@"description": "Validation Error"}},- "summary": "Undo Run Edit",+ "summary": "Update Doc","tags": ["memory"]}},- "/api/memory/settings": {+ "/api/memory/overview": {"get": {- "description": "Return the current ``memory:`` subtree (defaults merged in).",- "operationId": "get_memory_settings_endpoint_api_memory_settings_get",+ "operationId": "get_overview_api_memory_overview_get","parameters": [{"in": "header",@@ -29894,15 +30221,26 @@"description": "Validation Error"}},- "summary": "Get Memory Settings Endpoint",+ "summary": "Get Overview","tags": ["memory"]- },- "put": {- "description": "Merge the payload into the ``memory:`` subtree and persist.",- "operationId": "put_memory_settings_api_memory_settings_put",+ }+ },+ "/api/memory/resolve_entry/{entry_id}": {+ "get": {+ "description": "Find which L2 doc owns this entry id.\n\nL3 docs cite L2 entries by their ``m_<ULID>`` entry id; the workbench\nUI uses this resolver to turn an L3 footnote click into a navigation\nto the right L2 surface + scroll-to anchor.\n\nScans the seven L2 mds in order; first hit wins. 404 if no L2 doc\ncontains the id (e.g. the entry was deleted or the id is stale).",+ "operationId": "resolve_entry_api_memory_resolve_entry__entry_id__get","parameters": [+ {+ "in": "path",+ "name": "entry_id",+ "required": true,+ "schema": {+ "title": "Entry Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -29936,18 +30274,6 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "additionalProperties": true,- "title": "Payload",- "type": "object"- }- }- },- "required": true- },"responses": {"200": {"content": {@@ -29968,24 +30294,46 @@"description": "Validation Error"}},- "summary": "Put Memory Settings",+ "summary": "Resolve Entry","tags": ["memory"]}},- "/api/memory/snapshot/{surface}": {+ "/api/memory/runs": {"get": {- "description": "Return the current entity list for ``surface`` from workspace.\n\nSnapshot is always derived live from workspace at call time. The response\nalso includes ``pending_changes`` — the diff vs the last persisted state.\nRefresh commits these pending changes into ``changes.jsonl``.",- "operationId": "get_snapshot_api_memory_snapshot__surface__get",+ "operationId": "list_runs_api_memory_runs_get","parameters": [{- "in": "path",- "name": "surface",- "required": true,+ "in": "query",+ "name": "layer",+ "required": false,"schema": {- "title": "Surface",- "type": "string"+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Layer"+ }+ },+ {+ "in": "query",+ "name": "key",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Key"}},{@@ -30041,25 +30389,17 @@"description": "Validation Error"}},- "summary": "Get Snapshot",+ "summary": "List Runs","tags": ["memory"]}},- "/api/memory/snapshot/{surface}/changes": {- "delete": {- "operationId": "clear_snapshot_changes_api_memory_snapshot__surface__changes_delete",+ "/api/memory/runs/start": {+ "post": {+ "description": "Start one consolidator mode and return a run handle.\n\nThe run survives client disconnects; reconnect via\n``GET /runs/{id}/events?since=N``.",+ "operationId": "start_run_api_memory_runs_start_post","parameters": [- {- "in": "path",- "name": "surface",- "required": true,- "schema": {- "title": "Surface",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -30093,6 +30433,16 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/RunStartRequest"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -30113,43 +30463,25 @@"description": "Validation Error"}},- "summary": "Clear Snapshot Changes",+ "summary": "Start Run","tags": ["memory"]- },+ }+ },+ "/api/memory/runs/{run_id}": {"get": {- "operationId": "get_changes_api_memory_snapshot__surface__changes_get",+ "operationId": "get_run_api_memory_runs__run_id__get","parameters": [{"in": "path",- "name": "surface",+ "name": "run_id","required": true,"schema": {- "title": "Surface",+ "title": "Run Id","type": "string"}},- {- "in": "query",- "name": "limit",- "required": false,- "schema": {- "default": 200,- "title": "Limit",- "type": "integer"- }- },- {- "in": "query",- "name": "offset",- "required": false,- "schema": {- "default": 0,- "title": "Offset",- "type": "integer"- }- },{"in": "header","name": "Authorization",@@ -30203,23 +30535,22 @@"description": "Validation Error"}},- "summary": "Get Changes",+ "summary": "Get Run","tags": ["memory"]}},- "/api/memory/snapshot/{surface}/refresh": {+ "/api/memory/runs/{run_id}/cancel": {"post": {- "description": "Reconcile persisted state with current workspace; record diffs.",- "operationId": "refresh_snapshot_api_memory_snapshot__surface__refresh_post",+ "operationId": "cancel_run_api_memory_runs__run_id__cancel_post","parameters": [{"in": "path",- "name": "surface",+ "name": "run_id","required": true,"schema": {- "title": "Surface",+ "title": "Run Id","type": "string"}},@@ -30276,25 +30607,36 @@"description": "Validation Error"}},- "summary": "Refresh Snapshot",+ "summary": "Cancel Run","tags": ["memory"]}},- "/api/memory/trace/{surface}": {- "delete": {- "operationId": "clear_trace_api_memory_trace__surface__delete",+ "/api/memory/runs/{run_id}/events": {+ "get": {+ "description": "SSE-replay events from the next sequence cursor until the run ends.\n\nReconnecting after a refresh: pass ``last_seen_seq + 1``. The manager\nreplays the buffered tail, then blocks on new events until the run reaches\na terminal state.",+ "operationId": "stream_run_events_api_memory_runs__run_id__events_get","parameters": [{"in": "path",- "name": "surface",+ "name": "run_id","required": true,"schema": {- "title": "Surface",+ "title": "Run Id","type": "string"}},+ {+ "in": "query",+ "name": "since",+ "required": false,+ "schema": {+ "default": 0,+ "title": "Since",+ "type": "integer"+ }+ },{"in": "header","name": "Authorization",@@ -30348,43 +30690,25 @@"description": "Validation Error"}},- "summary": "Clear Trace",+ "summary": "Stream Run Events","tags": ["memory"]- },- "get": {- "operationId": "get_trace_api_memory_trace__surface__get",+ }+ },+ "/api/memory/runs/{run_id}/undo": {+ "post": {+ "operationId": "undo_run_edit_api_memory_runs__run_id__undo_post","parameters": [{"in": "path",- "name": "surface",+ "name": "run_id","required": true,"schema": {- "title": "Surface",+ "title": "Run Id","type": "string"}},- {- "in": "query",- "name": "limit",- "required": false,- "schema": {- "default": 200,- "title": "Limit",- "type": "integer"- }- },- {- "in": "query",- "name": "offset",- "required": false,- "schema": {- "default": 0,- "title": "Offset",- "type": "integer"- }- },{"in": "header","name": "Authorization",@@ -30438,34 +30762,17 @@"description": "Validation Error"}},- "summary": "Get Trace",+ "summary": "Undo Run Edit","tags": ["memory"]}},- "/api/memory/trace/{surface}/day/{day}": {- "delete": {- "operationId": "clear_trace_day_api_memory_trace__surface__day__day__delete",+ "/api/memory/settings": {+ "get": {+ "description": "Return the current ``memory:`` subtree (defaults merged in).",+ "operationId": "get_memory_settings_endpoint_api_memory_settings_get","parameters": [- {- "in": "path",- "name": "surface",- "required": true,- "schema": {- "title": "Surface",- "type": "string"- }- },- {- "in": "path",- "name": "day",- "required": true,- "schema": {- "title": "Day",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -30519,15 +30826,14 @@"description": "Validation Error"}},- "summary": "Clear Trace Day",+ "summary": "Get Memory Settings Endpoint","tags": ["memory"]- }- },- "/api/multi-user/admin/books": {- "get": {- "operationId": "admin_books_api_multi_user_admin_books_get",+ },+ "put": {+ "description": "Merge the payload into the ``memory:`` subtree and persist.",+ "operationId": "put_memory_settings_api_memory_settings_put","parameters": [{"in": "header",@@ -30562,15 +30868,23 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "additionalProperties": true,+ "title": "Payload",+ "type": "object"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Admin Books Api Multi User Admin Books Get",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -30586,17 +30900,26 @@"description": "Validation Error"}},- "summary": "Admin Books",+ "summary": "Put Memory Settings","tags": [- "multi-user"+ "memory"]}},- "/api/multi-user/admin/resources": {+ "/api/memory/snapshot/{surface}": {"get": {- "description": "Everything an admin can assign to a user: models, KBs, skills, and\nthe tool surface (system tools + MCP tools, same pool partners use).",- "operationId": "admin_resources_api_multi_user_admin_resources_get",+ "description": "Return the current entity list for ``surface`` from workspace.\n\nSnapshot is always derived live from workspace at call time. The response\nalso includes ``pending_changes`` — the diff vs the last persisted state.\nRefresh commits these pending changes into ``changes.jsonl``.",+ "operationId": "get_snapshot_api_memory_snapshot__surface__get","parameters": [+ {+ "in": "path",+ "name": "surface",+ "required": true,+ "schema": {+ "title": "Surface",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -30634,11 +30957,7 @@"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Admin Resources Api Multi User Admin Resources Get",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -30654,17 +30973,25 @@"description": "Validation Error"}},- "summary": "Admin Resources",+ "summary": "Get Snapshot","tags": [- "multi-user"+ "memory"]}},- "/api/multi-user/admin/skills/install": {- "post": {- "description": "Install a hub skill into the admin catalog (``<hub>:<slug>[@version]``).\n\nThe skill lands in the admin workspace — the same pool ``/admin/resources``\nlists — so it stays invisible to non-admin users until a grant assigns it.\nThe install pipeline (verdict gate, safe extraction, ``always`` stripping)\nlives in :func:`deeptutor.services.skill.hub.install_from_hub`; this\nendpoint only chooses the target root and audits the action.",- "operationId": "admin_install_skill_api_multi_user_admin_skills_install_post",+ "/api/memory/snapshot/{surface}/changes": {+ "delete": {+ "operationId": "clear_snapshot_changes_api_memory_snapshot__surface__changes_delete","parameters": [+ {+ "in": "path",+ "name": "surface",+ "required": true,+ "schema": {+ "title": "Surface",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -30698,25 +31025,11 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/SkillInstallPayload"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Admin Install Skill Api Multi User Admin Skills Install Post",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -30732,24 +31045,41 @@"description": "Validation Error"}},- "summary": "Admin Install Skill",+ "summary": "Clear Snapshot Changes","tags": [- "multi-user"+ "memory"]- }- },- "/api/multi-user/guardians": {+ },"get": {- "operationId": "list_guardian_relationships_api_multi_user_guardians_get",+ "operationId": "get_changes_api_memory_snapshot__surface__changes_get","parameters": [+ {+ "in": "path",+ "name": "surface",+ "required": true,+ "schema": {+ "title": "Surface",+ "type": "string"+ }+ },{"in": "query",- "name": "include_revoked",+ "name": "limit","required": false,"schema": {- "default": false,- "title": "Include Revoked",- "type": "boolean"+ "default": 200,+ "title": "Limit",+ "type": "integer"+ }+ },+ {+ "in": "query",+ "name": "offset",+ "required": false,+ "schema": {+ "default": 0,+ "title": "Offset",+ "type": "integer"}},{@@ -30789,11 +31119,7 @@"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response List Guardian Relationships Api Multi User Guardians Get",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -30809,14 +31135,26 @@"description": "Validation Error"}},- "summary": "List Guardian Relationships",+ "summary": "Get Changes","tags": [- "multi-user"+ "memory"]- },+ }+ },+ "/api/memory/snapshot/{surface}/refresh": {"post": {- "operationId": "authorize_guardian_relationship_api_multi_user_guardians_post",+ "description": "Reconcile persisted state with current workspace; record diffs.",+ "operationId": "refresh_snapshot_api_memory_snapshot__surface__refresh_post","parameters": [+ {+ "in": "path",+ "name": "surface",+ "required": true,+ "schema": {+ "title": "Surface",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -30850,25 +31188,11 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/GuardianAuthorizationPayload"- }- }- },- "required": true- },"responses": {- "201": {+ "200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Authorize Guardian Relationship Api Multi User Guardians Post",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -30884,22 +31208,22 @@"description": "Validation Error"}},- "summary": "Authorize Guardian Relationship",+ "summary": "Refresh Snapshot","tags": [- "multi-user"+ "memory"]}},- "/api/multi-user/guardians/{relationship_id}": {+ "/api/memory/trace/{surface}": {"delete": {- "operationId": "revoke_guardian_relationship_api_multi_user_guardians__relationship_id__delete",+ "operationId": "clear_trace_api_memory_trace__surface__delete","parameters": [{"in": "path",- "name": "relationship_id",+ "name": "surface","required": true,"schema": {- "title": "Relationship Id",+ "title": "Surface","type": "string"}},@@ -30940,11 +31264,7 @@"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Revoke Guardian Relationship Api Multi User Guardians Relationship Id Delete",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -30960,25 +31280,43 @@"description": "Validation Error"}},- "summary": "Revoke Guardian Relationship",+ "summary": "Clear Trace","tags": [- "multi-user"+ "memory"]- }- },- "/api/multi-user/learners/{learner_user_id}/credentials/reset": {- "post": {- "operationId": "reset_learner_credentials_api_multi_user_learners__learner_user_id__credentials_reset_post",+ },+ "get": {+ "operationId": "get_trace_api_memory_trace__surface__get","parameters": [{"in": "path",- "name": "learner_user_id",+ "name": "surface","required": true,"schema": {- "title": "Learner User Id",+ "title": "Surface","type": "string"}},+ {+ "in": "query",+ "name": "limit",+ "required": false,+ "schema": {+ "default": 200,+ "title": "Limit",+ "type": "integer"+ }+ },+ {+ "in": "query",+ "name": "offset",+ "required": false,+ "schema": {+ "default": 0,+ "title": "Offset",+ "type": "integer"+ }+ },{"in": "header","name": "Authorization",@@ -31012,25 +31350,11 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/GuardianCredentialResetPayload"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Reset Learner Credentials Api Multi User Learners Learner User Id Credentials Reset Post",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -31046,98 +31370,31 @@"description": "Validation Error"}},- "summary": "Reset Learner Credentials",+ "summary": "Get Trace","tags": [- "multi-user"+ "memory"]}},- "/api/multi-user/learners/{learner_user_id}/guardian-report": {- "get": {- "operationId": "guardian_report_api_multi_user_learners__learner_user_id__guardian_report_get",+ "/api/memory/trace/{surface}/day/{day}": {+ "delete": {+ "operationId": "clear_trace_day_api_memory_trace__surface__day__day__delete","parameters": [{"in": "path",- "name": "learner_user_id",+ "name": "surface","required": true,"schema": {- "title": "Learner User Id",+ "title": "Surface","type": "string"}},- {- "in": "header",- "name": "Authorization",- "required": false,- "schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Authorization"- }- },- {- "in": "cookie",- "name": "dt_token",- "required": false,- "schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Dt Token"- }- }- ],- "responses": {- "200": {- "content": {- "application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Guardian Report Api Multi User Learners Learner User Id Guardian Report Get",- "type": "object"- }- }- },- "description": "Successful Response"- },- "422": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- },- "description": "Validation Error"- }- },- "summary": "Guardian Report",- "tags": [- "multi-user"- ]- }- },- "/api/multi-user/learners/{learner_user_id}/materials": {- "get": {- "operationId": "guardian_material_catalog_api_multi_user_learners__learner_user_id__materials_get",- "parameters": [{"in": "path",- "name": "learner_user_id",+ "name": "day","required": true,"schema": {- "title": "Learner User Id",+ "title": "Day","type": "string"}},@@ -31178,11 +31435,7 @@"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Guardian Material Catalog Api Multi User Learners Learner User Id Materials Get",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -31198,23 +31451,16 @@"description": "Validation Error"}},- "summary": "Guardian Material Catalog",+ "summary": "Clear Trace Day","tags": [- "multi-user"+ "memory"]- },- "put": {- "operationId": "assign_guardian_materials_api_multi_user_learners__learner_user_id__materials_put",+ }+ },+ "/api/multi-user/admin/books": {+ "get": {+ "operationId": "admin_books_api_multi_user_admin_books_get","parameters": [- {- "in": "path",- "name": "learner_user_id",- "required": true,- "schema": {- "title": "Learner User Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -31248,23 +31494,13 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/GuardianMaterialsPayload"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {"schema": {"additionalProperties": true,- "title": "Response Assign Guardian Materials Api Multi User Learners Learner User Id Materials Put",+ "title": "Response Admin Books Api Multi User Admin Books Get","type": "object"}}@@ -31282,25 +31518,17 @@"description": "Validation Error"}},- "summary": "Assign Guardian Materials",+ "summary": "Admin Books","tags": ["multi-user"]}},- "/api/multi-user/learners/{learner_user_id}/restrictions": {+ "/api/multi-user/admin/resources": {"get": {- "operationId": "get_guardian_restrictions_api_multi_user_learners__learner_user_id__restrictions_get",+ "description": "Everything an admin can assign to a user: models, KBs, skills, and\nthe tool surface (system tools + MCP tools, same pool partners use).",+ "operationId": "admin_resources_api_multi_user_admin_resources_get","parameters": [- {- "in": "path",- "name": "learner_user_id",- "required": true,- "schema": {- "title": "Learner User Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -31340,7 +31568,7 @@"application/json": {"schema": {"additionalProperties": true,- "title": "Response Get Guardian Restrictions Api Multi User Learners Learner User Id Restrictions Get",+ "title": "Response Admin Resources Api Multi User Admin Resources Get","type": "object"}}@@ -31358,23 +31586,17 @@"description": "Validation Error"}},- "summary": "Get Guardian Restrictions",+ "summary": "Admin Resources","tags": ["multi-user"]- },- "put": {- "operationId": "put_guardian_restrictions_api_multi_user_learners__learner_user_id__restrictions_put",+ }+ },+ "/api/multi-user/admin/skills/install": {+ "post": {+ "description": "Install a hub skill into the admin catalog (``<hub>:<slug>[@version]``).\n\nThe skill lands in the admin workspace — the same pool ``/admin/resources``\nlists — so it stays invisible to non-admin users until a grant assigns it.\nThe install pipeline (verdict gate, safe extraction, ``always`` stripping)\nlives in :func:`deeptutor.services.skill.hub.install_from_hub`; this\nendpoint only chooses the target root and audits the action.",+ "operationId": "admin_install_skill_api_multi_user_admin_skills_install_post","parameters": [- {- "in": "path",- "name": "learner_user_id",- "required": true,- "schema": {- "title": "Learner User Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -31412,7 +31634,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/GuardianRestrictionsPayload"+ "$ref": "#/components/schemas/SkillInstallPayload"}}},@@ -31424,7 +31646,7 @@"application/json": {"schema": {"additionalProperties": true,- "title": "Response Put Guardian Restrictions Api Multi User Learners Learner User Id Restrictions Put",+ "title": "Response Admin Install Skill Api Multi User Admin Skills Install Post","type": "object"}}@@ -31442,16 +31664,26 @@"description": "Validation Error"}},- "summary": "Put Guardian Restrictions",+ "summary": "Admin Install Skill","tags": ["multi-user"]}},- "/api/multi-user/me/guardianships": {+ "/api/multi-user/guardians": {"get": {- "operationId": "my_guardianships_api_multi_user_me_guardianships_get",+ "operationId": "list_guardian_relationships_api_multi_user_guardians_get","parameters": [+ {+ "in": "query",+ "name": "include_revoked",+ "required": false,+ "schema": {+ "default": false,+ "title": "Include Revoked",+ "type": "boolean"+ }+ },{"in": "header","name": "Authorization",@@ -31491,7 +31723,7 @@"application/json": {"schema": {"additionalProperties": true,- "title": "Response My Guardianships Api Multi User Me Guardianships Get",+ "title": "Response List Guardian Relationships Api Multi User Guardians Get","type": "object"}}@@ -31509,25 +31741,14 @@"description": "Validation Error"}},- "summary": "My Guardianships",+ "summary": "List Guardian Relationships","tags": ["multi-user"]- }- },- "/api/multi-user/me/guardianships/{relationship_id}": {- "delete": {- "operationId": "revoke_my_guardianship_api_multi_user_me_guardianships__relationship_id__delete",+ },+ "post": {+ "operationId": "authorize_guardian_relationship_api_multi_user_guardians_post","parameters": [- {- "in": "path",- "name": "relationship_id",- "required": true,- "schema": {- "title": "Relationship Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -31561,13 +31782,23 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/GuardianAuthorizationPayload"+ }+ }+ },+ "required": true+ },"responses": {- "200": {+ "201": {"content": {"application/json": {"schema": {"additionalProperties": true,- "title": "Response Revoke My Guardianship Api Multi User Me Guardianships Relationship Id Delete",+ "title": "Response Authorize Guardian Relationship Api Multi User Guardians Post","type": "object"}}@@ -31585,16 +31816,25 @@"description": "Validation Error"}},- "summary": "Revoke My Guardianship",+ "summary": "Authorize Guardian Relationship","tags": ["multi-user"]}},- "/api/multi-user/users": {- "get": {- "operationId": "multi_user_list_users_api_multi_user_users_get",+ "/api/multi-user/guardians/{relationship_id}": {+ "delete": {+ "operationId": "revoke_guardian_relationship_api_multi_user_guardians__relationship_id__delete","parameters": [+ {+ "in": "path",+ "name": "relationship_id",+ "required": true,+ "schema": {+ "title": "Relationship Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -31634,7 +31874,7 @@"application/json": {"schema": {"additionalProperties": true,- "title": "Response Multi User List Users Api Multi User Users Get",+ "title": "Response Revoke Guardian Relationship Api Multi User Guardians Relationship Id Delete","type": "object"}}@@ -31652,22 +31892,22 @@"description": "Validation Error"}},- "summary": "Multi User List Users",+ "summary": "Revoke Guardian Relationship","tags": ["multi-user"]}},- "/api/multi-user/users/{user_id}/book-permission": {- "get": {- "operationId": "get_user_book_permission_api_multi_user_users__user_id__book_permission_get",+ "/api/multi-user/learners/{learner_user_id}/credentials/reset": {+ "post": {+ "operationId": "reset_learner_credentials_api_multi_user_learners__learner_user_id__credentials_reset_post","parameters": [{"in": "path",- "name": "user_id",+ "name": "learner_user_id","required": true,"schema": {- "title": "User Id",+ "title": "Learner User Id","type": "string"}},@@ -31704,13 +31944,23 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/GuardianCredentialResetPayload"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {"application/json": {"schema": {"additionalProperties": true,- "title": "Response Get User Book Permission Api Multi User Users User Id Book Permission Get",+ "title": "Response Reset Learner Credentials Api Multi User Learners Learner User Id Credentials Reset Post","type": "object"}}@@ -31728,20 +31978,22 @@"description": "Validation Error"}},- "summary": "Get User Book Permission",+ "summary": "Reset Learner Credentials","tags": ["multi-user"]- },- "put": {- "operationId": "put_user_book_permission_api_multi_user_users__user_id__book_permission_put",+ }+ },+ "/api/multi-user/learners/{learner_user_id}/guardian-report": {+ "get": {+ "operationId": "guardian_report_api_multi_user_learners__learner_user_id__guardian_report_get","parameters": [{"in": "path",- "name": "user_id",+ "name": "learner_user_id","required": true,"schema": {- "title": "User Id",+ "title": "Learner User Id","type": "string"}},@@ -31778,23 +32030,13 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/BookPermissionPayload"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {"schema": {"additionalProperties": true,- "title": "Response Put User Book Permission Api Multi User Users User Id Book Permission Put",+ "title": "Response Guardian Report Api Multi User Learners Learner User Id Guardian Report Get","type": "object"}}@@ -31812,22 +32054,22 @@"description": "Validation Error"}},- "summary": "Put User Book Permission",+ "summary": "Guardian Report","tags": ["multi-user"]}},- "/api/multi-user/users/{user_id}/grants": {+ "/api/multi-user/learners/{learner_user_id}/materials": {"get": {- "operationId": "get_user_grants_api_multi_user_users__user_id__grants_get",+ "operationId": "guardian_material_catalog_api_multi_user_learners__learner_user_id__materials_get","parameters": [{"in": "path",- "name": "user_id",+ "name": "learner_user_id","required": true,"schema": {- "title": "User Id",+ "title": "Learner User Id","type": "string"}},@@ -31870,7 +32112,7 @@"application/json": {"schema": {"additionalProperties": true,- "title": "Response Get User Grants Api Multi User Users User Id Grants Get",+ "title": "Response Guardian Material Catalog Api Multi User Learners Learner User Id Materials Get","type": "object"}}@@ -31888,20 +32130,20 @@"description": "Validation Error"}},- "summary": "Get User Grants",+ "summary": "Guardian Material Catalog","tags": ["multi-user"]},"put": {- "operationId": "put_user_grants_api_multi_user_users__user_id__grants_put",+ "operationId": "assign_guardian_materials_api_multi_user_learners__learner_user_id__materials_put","parameters": [{"in": "path",- "name": "user_id",+ "name": "learner_user_id","required": true,"schema": {- "title": "User Id",+ "title": "Learner User Id","type": "string"}},@@ -31942,7 +32184,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/GrantPayload"+ "$ref": "#/components/schemas/GuardianMaterialsPayload"}}},@@ -31954,7 +32196,7 @@"application/json": {"schema": {"additionalProperties": true,- "title": "Response Put User Grants Api Multi User Users User Id Grants Put",+ "title": "Response Assign Guardian Materials Api Multi User Learners Learner User Id Materials Put","type": "object"}}@@ -31972,17 +32214,25 @@"description": "Validation Error"}},- "summary": "Put User Grants",+ "summary": "Assign Guardian Materials","tags": ["multi-user"]}},- "/api/notebooks": {+ "/api/multi-user/learners/{learner_user_id}/restrictions": {"get": {- "description": "Get all notebook list\n\nReturns:\n Notebook list (includes summary information)",- "operationId": "list_notebooks_api_notebooks_get",+ "operationId": "get_guardian_restrictions_api_multi_user_learners__learner_user_id__restrictions_get","parameters": [+ {+ "in": "path",+ "name": "learner_user_id",+ "required": true,+ "schema": {+ "title": "Learner User Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -32020,7 +32270,11 @@"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": true,+ "title": "Response Get Guardian Restrictions Api Multi User Learners Learner User Id Restrictions Get",+ "type": "object"+ }}},"description": "Successful Response"@@ -32036,89 +32290,23 @@"description": "Validation Error"}},- "summary": "List Notebooks",+ "summary": "Get Guardian Restrictions","tags": [- "notebooks"+ "multi-user"]},- "post": {- "description": "Create new notebook\n\nArgs:\n request: Create request\n\nReturns:\n Created notebook information",- "operationId": "create_notebook_api_notebooks_post",+ "put": {+ "operationId": "put_guardian_restrictions_api_multi_user_learners__learner_user_id__restrictions_put","parameters": [{- "in": "header",- "name": "Authorization",- "required": false,- "schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Authorization"- }- },- {- "in": "cookie",- "name": "dt_token",- "required": false,+ "in": "path",+ "name": "learner_user_id",+ "required": true,"schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Dt Token"- }- }- ],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/CreateNotebookRequest"- }+ "title": "Learner User Id",+ "type": "string"}},- "required": true- },- "responses": {- "200": {- "content": {- "application/json": {- "schema": {}- }- },- "description": "Successful Response"- },- "422": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- },- "description": "Validation Error"- }- },- "summary": "Create Notebook",- "tags": [- "notebooks"- ]- }- },- "/api/notebooks/actions/add-record": {- "post": {- "description": "Add record to notebook\n\nArgs:\n request: Add record request\n\nReturns:\n Addition result",- "operationId": "add_record_api_notebooks_actions_add_record_post",- "parameters": [{"in": "header","name": "Authorization",@@ -32156,7 +32344,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/AddRecordRequest"+ "$ref": "#/components/schemas/GuardianRestrictionsPayload"}}},@@ -32166,7 +32354,11 @@"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": true,+ "title": "Response Put Guardian Restrictions Api Multi User Learners Learner User Id Restrictions Put",+ "type": "object"+ }}},"description": "Successful Response"@@ -32182,16 +32374,15 @@"description": "Validation Error"}},- "summary": "Add Record",+ "summary": "Put Guardian Restrictions","tags": [- "notebooks"+ "multi-user"]}},- "/api/notebooks/actions/add-record-with-summary": {- "post": {- "description": "Add record to notebook and stream generated summary.",- "operationId": "add_record_with_summary_api_notebooks_actions_add_record_with_summary_post",+ "/api/multi-user/me/guardianships": {+ "get": {+ "operationId": "my_guardianships_api_multi_user_me_guardianships_get","parameters": [{"in": "header",@@ -32226,21 +32417,15 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/AddRecordRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": true,+ "title": "Response My Guardianships Api Multi User Me Guardianships Get",+ "type": "object"+ }}},"description": "Successful Response"@@ -32256,17 +32441,25 @@"description": "Validation Error"}},- "summary": "Add Record With Summary",+ "summary": "My Guardianships","tags": [- "notebooks"+ "multi-user"]}},- "/api/notebooks/health": {- "get": {- "description": "Health check",- "operationId": "health_check_api_notebooks_health_get",+ "/api/multi-user/me/guardianships/{relationship_id}": {+ "delete": {+ "operationId": "revoke_my_guardianship_api_multi_user_me_guardianships__relationship_id__delete","parameters": [+ {+ "in": "path",+ "name": "relationship_id",+ "required": true,+ "schema": {+ "title": "Relationship Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -32304,7 +32497,11 @@"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": true,+ "title": "Response Revoke My Guardianship Api Multi User Me Guardianships Relationship Id Delete",+ "type": "object"+ }}},"description": "Successful Response"@@ -32320,16 +32517,15 @@"description": "Validation Error"}},- "summary": "Health Check",+ "summary": "Revoke My Guardianship","tags": [- "notebooks"+ "multi-user"]}},- "/api/notebooks/statistics": {+ "/api/multi-user/users": {"get": {- "description": "Get notebook statistics\n\nReturns:\n Statistics information",- "operationId": "get_statistics_api_notebooks_statistics_get",+ "operationId": "multi_user_list_users_api_multi_user_users_get","parameters": [{"in": "header",@@ -32368,7 +32564,11 @@"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": true,+ "title": "Response Multi User List Users Api Multi User Users Get",+ "type": "object"+ }}},"description": "Successful Response"@@ -32384,23 +32584,22 @@"description": "Validation Error"}},- "summary": "Get Statistics",+ "summary": "Multi User List Users","tags": [- "notebooks"+ "multi-user"]}},- "/api/notebooks/{notebook_id}": {- "delete": {- "description": "Delete notebook\n\nArgs:\n notebook_id: Notebook ID\n\nReturns:\n Deletion result",- "operationId": "delete_notebook_api_notebooks__notebook_id__delete",+ "/api/multi-user/users/{user_id}/book-permission": {+ "get": {+ "operationId": "get_user_book_permission_api_multi_user_users__user_id__book_permission_get","parameters": [{"in": "path",- "name": "notebook_id",+ "name": "user_id","required": true,"schema": {- "title": "Notebook Id",+ "title": "User Id","type": "string"}},@@ -32441,7 +32640,11 @@"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": true,+ "title": "Response Get User Book Permission Api Multi User Users User Id Book Permission Get",+ "type": "object"+ }}},"description": "Successful Response"@@ -32457,21 +32660,20 @@"description": "Validation Error"}},- "summary": "Delete Notebook",+ "summary": "Get User Book Permission","tags": [- "notebooks"+ "multi-user"]},- "get": {- "description": "Get notebook details\n\nArgs:\n notebook_id: Notebook ID\n\nReturns:\n Notebook details (includes all records)",- "operationId": "get_notebook_api_notebooks__notebook_id__get",+ "put": {+ "operationId": "put_user_book_permission_api_multi_user_users__user_id__book_permission_put","parameters": [{"in": "path",- "name": "notebook_id",+ "name": "user_id","required": true,"schema": {- "title": "Notebook Id",+ "title": "User Id","type": "string"}},@@ -32508,11 +32710,25 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/BookPermissionPayload"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": true,+ "title": "Response Put User Book Permission Api Multi User Users User Id Book Permission Put",+ "type": "object"+ }}},"description": "Successful Response"@@ -32528,21 +32744,22 @@"description": "Validation Error"}},- "summary": "Get Notebook",+ "summary": "Put User Book Permission","tags": [- "notebooks"+ "multi-user"]- },- "put": {- "description": "Update notebook information\n\nArgs:\n notebook_id: Notebook ID\n request: Update request\n\nReturns:\n Updated notebook information",- "operationId": "update_notebook_api_notebooks__notebook_id__put",+ }+ },+ "/api/multi-user/users/{user_id}/grants": {+ "get": {+ "operationId": "get_user_grants_api_multi_user_users__user_id__grants_get","parameters": [{"in": "path",- "name": "notebook_id",+ "name": "user_id","required": true,"schema": {- "title": "Notebook Id",+ "title": "User Id","type": "string"}},@@ -32579,21 +32796,15 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/UpdateNotebookRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": true,+ "title": "Response Get User Grants Api Multi User Users User Id Grants Get",+ "type": "object"+ }}},"description": "Successful Response"@@ -32609,23 +32820,20 @@"description": "Validation Error"}},- "summary": "Update Notebook",+ "summary": "Get User Grants","tags": [- "notebooks"+ "multi-user"]- }- },- "/api/notebooks/{notebook_id}/export": {- "get": {- "description": "Render the whole notebook as a single Markdown document.",- "operationId": "export_notebook_api_notebooks__notebook_id__export_get",+ },+ "put": {+ "operationId": "put_user_grants_api_multi_user_users__user_id__grants_put","parameters": [{"in": "path",- "name": "notebook_id",+ "name": "user_id","required": true,"schema": {- "title": "Notebook Id",+ "title": "User Id","type": "string"}},@@ -32662,12 +32870,24 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/GrantPayload"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {- "text/plain": {+ "application/json": {"schema": {- "type": "string"+ "additionalProperties": true,+ "title": "Response Put User Grants Api Multi User Users User Id Grants Put",+ "type": "object"}}},@@ -32684,35 +32904,17 @@"description": "Validation Error"}},- "summary": "Export Notebook",+ "summary": "Put User Grants","tags": [- "notebooks"+ "multi-user"]}},- "/api/notebooks/{notebook_id}/records/{record_id}": {- "delete": {- "description": "Remove record from notebook\n\nArgs:\n notebook_id: Notebook ID\n record_id: Record ID\n\nReturns:\n Deletion result",- "operationId": "remove_record_api_notebooks__notebook_id__records__record_id__delete",+ "/api/notebooks": {+ "get": {+ "description": "Get all notebook list\n\nReturns:\n Notebook list (includes summary information)",+ "operationId": "list_notebooks_api_notebooks_get","parameters": [- {- "in": "path",- "name": "notebook_id",- "required": true,- "schema": {- "title": "Notebook Id",- "type": "string"- }- },- {- "in": "path",- "name": "record_id",- "required": true,- "schema": {- "title": "Record Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -32766,33 +32968,15 @@"description": "Validation Error"}},- "summary": "Remove Record",+ "summary": "List Notebooks","tags": ["notebooks"]},- "put": {- "description": "Update an existing notebook record in place.",- "operationId": "update_record_api_notebooks__notebook_id__records__record_id__put",+ "post": {+ "description": "Create new notebook\n\nArgs:\n request: Create request\n\nReturns:\n Created notebook information",+ "operationId": "create_notebook_api_notebooks_post","parameters": [- {- "in": "path",- "name": "notebook_id",- "required": true,- "schema": {- "title": "Notebook Id",- "type": "string"- }- },- {- "in": "path",- "name": "record_id",- "required": true,- "schema": {- "title": "Record Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -32830,7 +33014,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/UpdateRecordRequest"+ "$ref": "#/components/schemas/CreateNotebookRequest"}}},@@ -32856,35 +33040,17 @@"description": "Validation Error"}},- "summary": "Update Record",+ "summary": "Create Notebook","tags": ["notebooks"]}},- "/api/notebooks/{notebook_id}/records/{record_id}/actions/copy": {+ "/api/notebooks/actions/add-record": {"post": {- "description": "Duplicate a record into another notebook under a fresh id.",- "operationId": "copy_record_api_notebooks__notebook_id__records__record_id__actions_copy_post",+ "description": "Add record to notebook\n\nArgs:\n request: Add record request\n\nReturns:\n Addition result",+ "operationId": "add_record_api_notebooks_actions_add_record_post","parameters": [- {- "in": "path",- "name": "notebook_id",- "required": true,- "schema": {- "title": "Notebook Id",- "type": "string"- }- },- {- "in": "path",- "name": "record_id",- "required": true,- "schema": {- "title": "Record Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -32922,7 +33088,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/MoveRecordRequest"+ "$ref": "#/components/schemas/AddRecordRequest"}}},@@ -32948,35 +33114,17 @@"description": "Validation Error"}},- "summary": "Copy Record",+ "summary": "Add Record","tags": ["notebooks"]}},- "/api/notebooks/{notebook_id}/records/{record_id}/actions/move": {+ "/api/notebooks/actions/add-record-with-summary": {"post": {- "description": "Move a record from this notebook into another one.",- "operationId": "move_record_api_notebooks__notebook_id__records__record_id__actions_move_post",+ "description": "Add record to notebook and stream generated summary.",+ "operationId": "add_record_with_summary_api_notebooks_actions_add_record_with_summary_post","parameters": [- {- "in": "path",- "name": "notebook_id",- "required": true,- "schema": {- "title": "Notebook Id",- "type": "string"- }- },- {- "in": "path",- "name": "record_id",- "required": true,- "schema": {- "title": "Record Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -33014,7 +33162,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/MoveRecordRequest"+ "$ref": "#/components/schemas/AddRecordRequest"}}},@@ -33040,15 +33188,16 @@"description": "Validation Error"}},- "summary": "Move Record",+ "summary": "Add Record With Summary","tags": ["notebooks"]}},- "/api/partner-groups": {+ "/api/notebooks/health": {"get": {- "operationId": "list_partner_groups_api_partner_groups_get",+ "description": "Health check",+ "operationId": "health_check_api_notebooks_health_get","parameters": [{"in": "header",@@ -33103,13 +33252,16 @@"description": "Validation Error"}},- "summary": "List Partner Groups",+ "summary": "Health Check","tags": [- "partner-groups"+ "notebooks"]- },- "post": {- "operationId": "create_partner_group_api_partner_groups_post",+ }+ },+ "/api/notebooks/statistics": {+ "get": {+ "description": "Get notebook statistics\n\nReturns:\n Statistics information",+ "operationId": "get_statistics_api_notebooks_statistics_get","parameters": [{"in": "header",@@ -33144,16 +33296,6 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/CreatePartnerGroupRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {@@ -33174,16 +33316,26 @@"description": "Validation Error"}},- "summary": "Create Partner Group",+ "summary": "Get Statistics","tags": [- "partner-groups"+ "notebooks"]}},- "/api/partner-groups/discussion-modes": {- "get": {- "operationId": "list_discussion_modes_api_partner_groups_discussion_modes_get",+ "/api/notebooks/{notebook_id}": {+ "delete": {+ "description": "Delete notebook\n\nArgs:\n notebook_id: Notebook ID\n\nReturns:\n Deletion result",+ "operationId": "delete_notebook_api_notebooks__notebook_id__delete","parameters": [+ {+ "in": "path",+ "name": "notebook_id",+ "required": true,+ "schema": {+ "title": "Notebook Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -33237,85 +33389,21 @@"description": "Validation Error"}},- "summary": "List Discussion Modes",+ "summary": "Delete Notebook","tags": [- "partner-groups"+ "notebooks"]- }- },- "/api/partner-groups/shared-memory-types": {+ },"get": {- "operationId": "list_shared_memory_types_api_partner_groups_shared_memory_types_get",- "parameters": [- {- "in": "header",- "name": "Authorization",- "required": false,- "schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Authorization"- }- },- {- "in": "cookie",- "name": "dt_token",- "required": false,- "schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Dt Token"- }- }- ],- "responses": {- "200": {- "content": {- "application/json": {- "schema": {}- }- },- "description": "Successful Response"- },- "422": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- },- "description": "Validation Error"- }- },- "summary": "List Shared Memory Types",- "tags": [- "partner-groups"- ]- }- },- "/api/partner-groups/{group_id}": {- "delete": {- "operationId": "delete_partner_group_api_partner_groups__group_id__delete",+ "description": "Get notebook details\n\nArgs:\n notebook_id: Notebook ID\n\nReturns:\n Notebook details (includes all records)",+ "operationId": "get_notebook_api_notebooks__notebook_id__get","parameters": [{"in": "path",- "name": "group_id",+ "name": "notebook_id","required": true,"schema": {- "title": "Group Id",+ "title": "Notebook Id","type": "string"}},@@ -33372,20 +33460,21 @@"description": "Validation Error"}},- "summary": "Delete Partner Group",+ "summary": "Get Notebook","tags": [- "partner-groups"+ "notebooks"]},- "get": {- "operationId": "get_partner_group_api_partner_groups__group_id__get",+ "put": {+ "description": "Update notebook information\n\nArgs:\n notebook_id: Notebook ID\n request: Update request\n\nReturns:\n Updated notebook information",+ "operationId": "update_notebook_api_notebooks__notebook_id__put","parameters": [{"in": "path",- "name": "group_id",+ "name": "notebook_id","required": true,"schema": {- "title": "Group Id",+ "title": "Notebook Id","type": "string"}},@@ -33422,6 +33511,16 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/UpdateNotebookRequest"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -33442,20 +33541,23 @@"description": "Validation Error"}},- "summary": "Get Partner Group",+ "summary": "Update Notebook","tags": [- "partner-groups"+ "notebooks"]- },- "patch": {- "operationId": "update_partner_group_api_partner_groups__group_id__patch",+ }+ },+ "/api/notebooks/{notebook_id}/export": {+ "get": {+ "description": "Render the whole notebook as a single Markdown document.",+ "operationId": "export_notebook_api_notebooks__notebook_id__export_get","parameters": [{"in": "path",- "name": "group_id",+ "name": "notebook_id","required": true,"schema": {- "title": "Group Id",+ "title": "Notebook Id","type": "string"}},@@ -33492,21 +33594,13 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/UpdatePartnerGroupRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {- "application/json": {- "schema": {}+ "text/plain": {+ "schema": {+ "type": "string"+ }}},"description": "Successful Response"@@ -33522,49 +33616,35 @@"description": "Validation Error"}},- "summary": "Update Partner Group",+ "summary": "Export Notebook","tags": [- "partner-groups"+ "notebooks"]}},- "/api/partner-groups/{group_id}/history": {- "get": {- "operationId": "partner_group_history_api_partner_groups__group_id__history_get",+ "/api/notebooks/{notebook_id}/records/{record_id}": {+ "delete": {+ "description": "Remove record from notebook\n\nArgs:\n notebook_id: Notebook ID\n record_id: Record ID\n\nReturns:\n Deletion result",+ "operationId": "remove_record_api_notebooks__notebook_id__records__record_id__delete","parameters": [{"in": "path",- "name": "group_id",+ "name": "notebook_id","required": true,"schema": {- "title": "Group Id",+ "title": "Notebook Id","type": "string"}},{- "in": "query",- "name": "session_key",- "required": false,+ "in": "path",+ "name": "record_id",+ "required": true,"schema": {- "default": "default",- "maxLength": 120,- "minLength": 1,- "title": "Session Key",+ "title": "Record Id","type": "string"}},- {- "in": "query",- "name": "limit",- "required": false,- "schema": {- "default": 200,- "maximum": 500,- "minimum": 1,- "title": "Limit",- "type": "integer"- }- },{"in": "header","name": "Authorization",@@ -33618,49 +33698,33 @@"description": "Validation Error"}},- "summary": "Partner Group History",+ "summary": "Remove Record","tags": [- "partner-groups"+ "notebooks"]- }- },- "/api/partner-groups/{group_id}/invocations": {- "get": {- "operationId": "partner_group_invocations_api_partner_groups__group_id__invocations_get",+ },+ "put": {+ "description": "Update an existing notebook record in place.",+ "operationId": "update_record_api_notebooks__notebook_id__records__record_id__put","parameters": [{"in": "path",- "name": "group_id",+ "name": "notebook_id","required": true,"schema": {- "title": "Group Id",+ "title": "Notebook Id","type": "string"}},{- "in": "query",- "name": "session_key",- "required": false,+ "in": "path",+ "name": "record_id",+ "required": true,"schema": {- "default": "default",- "maxLength": 120,- "minLength": 1,- "title": "Session Key",+ "title": "Record Id","type": "string"}},- {- "in": "query",- "name": "limit",- "required": false,- "schema": {- "default": 200,- "maximum": 500,- "minimum": 1,- "title": "Limit",- "type": "integer"- }- },{"in": "header","name": "Authorization",@@ -33694,6 +33758,16 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/UpdateRecordRequest"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -33714,20 +33788,32 @@"description": "Validation Error"}},- "summary": "Partner Group Invocations",+ "summary": "Update Record","tags": [- "partner-groups"+ "notebooks"]- },+ }+ },+ "/api/notebooks/{notebook_id}/records/{record_id}/actions/copy": {"post": {- "operationId": "create_partner_invocation_api_partner_groups__group_id__invocations_post",+ "description": "Duplicate a record into another notebook under a fresh id.",+ "operationId": "copy_record_api_notebooks__notebook_id__records__record_id__actions_copy_post","parameters": [{"in": "path",- "name": "group_id",+ "name": "notebook_id","required": true,"schema": {- "title": "Group Id",+ "title": "Notebook Id",+ "type": "string"+ }+ },+ {+ "in": "path",+ "name": "record_id",+ "required": true,+ "schema": {+ "title": "Record Id","type": "string"}},@@ -33768,7 +33854,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/CreatePartnerInvocationRequest"+ "$ref": "#/components/schemas/MoveRecordRequest"}}},@@ -33794,31 +33880,32 @@"description": "Validation Error"}},- "summary": "Create Partner Invocation",+ "summary": "Copy Record","tags": [- "partner-groups"+ "notebooks"]}},- "/api/partner-groups/{group_id}/invocations/{invocation_id}/approve": {+ "/api/notebooks/{notebook_id}/records/{record_id}/actions/move": {"post": {- "operationId": "approve_partner_invocation_api_partner_groups__group_id__invocations__invocation_id__approve_post",+ "description": "Move a record from this notebook into another one.",+ "operationId": "move_record_api_notebooks__notebook_id__records__record_id__actions_move_post","parameters": [{"in": "path",- "name": "group_id",+ "name": "notebook_id","required": true,"schema": {- "title": "Group Id",+ "title": "Notebook Id","type": "string"}},{"in": "path",- "name": "invocation_id",+ "name": "record_id","required": true,"schema": {- "title": "Invocation Id",+ "title": "Record Id","type": "string"}},@@ -33859,7 +33946,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/PartnerInvocationActionRequest"+ "$ref": "#/components/schemas/MoveRecordRequest"}}},@@ -33885,34 +33972,77 @@"description": "Validation Error"}},- "summary": "Approve Partner Invocation",+ "summary": "Move Record","tags": [- "partner-groups"+ "notebooks"]}},- "/api/partner-groups/{group_id}/invocations/{invocation_id}/reject": {- "post": {- "operationId": "reject_partner_invocation_api_partner_groups__group_id__invocations__invocation_id__reject_post",+ "/api/partner-groups": {+ "get": {+ "operationId": "list_partner_groups_api_partner_groups_get","parameters": [{- "in": "path",- "name": "group_id",- "required": true,+ "in": "header",+ "name": "Authorization",+ "required": false,"schema": {- "title": "Group Id",- "type": "string"+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"}},{- "in": "path",- "name": "invocation_id",- "required": true,+ "in": "cookie",+ "name": "dt_token",+ "required": false,"schema": {- "title": "Invocation Id",- "type": "string"+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"}+ }+ ],+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {}+ }+ },+ "description": "Successful Response"},+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "List Partner Groups",+ "tags": [+ "partner-groups"+ ]+ },+ "post": {+ "operationId": "create_partner_group_api_partner_groups_post",+ "parameters": [{"in": "header","name": "Authorization",@@ -33950,7 +34080,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/PartnerInvocationActionRequest"+ "$ref": "#/components/schemas/CreatePartnerGroupRequest"}}},@@ -33976,25 +34106,16 @@"description": "Validation Error"}},- "summary": "Reject Partner Invocation",+ "summary": "Create Partner Group","tags": ["partner-groups"]}},- "/api/partner-groups/{group_id}/messages": {- "post": {- "operationId": "send_partner_group_message_api_partner_groups__group_id__messages_post",+ "/api/partner-groups/discussion-modes": {+ "get": {+ "operationId": "list_discussion_modes_api_partner_groups_discussion_modes_get","parameters": [- {- "in": "path",- "name": "group_id",- "required": true,- "schema": {- "title": "Group Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -34028,16 +34149,6 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/PartnerGroupMessageRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {@@ -34058,34 +34169,16 @@"description": "Validation Error"}},- "summary": "Send Partner Group Message",+ "summary": "List Discussion Modes","tags": ["partner-groups"]}},- "/api/partner-groups/{group_id}/rounds/{turn_id}/summary": {- "post": {- "operationId": "summarize_partner_group_round_api_partner_groups__group_id__rounds__turn_id__summary_post",+ "/api/partner-groups/shared-memory-types": {+ "get": {+ "operationId": "list_shared_memory_types_api_partner_groups_shared_memory_types_get","parameters": [- {- "in": "path",- "name": "group_id",- "required": true,- "schema": {- "title": "Group Id",- "type": "string"- }- },- {- "in": "path",- "name": "turn_id",- "required": true,- "schema": {- "title": "Turn Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -34119,16 +34212,6 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/RoundSummaryRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {@@ -34149,15 +34232,15 @@"description": "Validation Error"}},- "summary": "Summarize Partner Group Round",+ "summary": "List Shared Memory Types","tags": ["partner-groups"]}},- "/api/partner-groups/{group_id}/sessions": {- "get": {- "operationId": "list_partner_group_sessions_api_partner_groups__group_id__sessions_get",+ "/api/partner-groups/{group_id}": {+ "delete": {+ "operationId": "delete_partner_group_api_partner_groups__group_id__delete","parameters": [{"in": "path",@@ -34221,13 +34304,13 @@"description": "Validation Error"}},- "summary": "List Partner Group Sessions",+ "summary": "Delete Partner Group","tags": ["partner-groups"]},- "post": {- "operationId": "create_partner_group_session_api_partner_groups__group_id__sessions_post",+ "get": {+ "operationId": "get_partner_group_api_partner_groups__group_id__get","parameters": [{"in": "path",@@ -34272,7 +34355,7 @@}],"responses": {- "201": {+ "200": {"content": {"application/json": {"schema": {}@@ -34291,15 +34374,13 @@"description": "Validation Error"}},- "summary": "Create Partner Group Session",+ "summary": "Get Partner Group","tags": ["partner-groups"]- }- },- "/api/partner-groups/{group_id}/sessions/{session_key}": {- "delete": {- "operationId": "delete_partner_group_session_api_partner_groups__group_id__sessions__session_key__delete",+ },+ "patch": {+ "operationId": "update_partner_group_api_partner_groups__group_id__patch","parameters": [{"in": "path",@@ -34310,15 +34391,6 @@"type": "string"}},- {- "in": "path",- "name": "session_key",- "required": true,- "schema": {- "title": "Session Key",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -34352,6 +34424,16 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/UpdatePartnerGroupRequest"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -34372,15 +34454,15 @@"description": "Validation Error"}},- "summary": "Delete Partner Group Session",+ "summary": "Update Partner Group","tags": ["partner-groups"]}},- "/api/partner-groups/{group_id}/turns/{turn_id}/partners/{partner_id}/retry": {- "post": {- "operationId": "retry_partner_group_seat_api_partner_groups__group_id__turns__turn_id__partners__partner_id__retry_post",+ "/api/partner-groups/{group_id}/history": {+ "get": {+ "operationId": "partner_group_history_api_partner_groups__group_id__history_get","parameters": [{"in": "path",@@ -34392,21 +34474,27 @@}},{- "in": "path",- "name": "turn_id",- "required": true,+ "in": "query",+ "name": "session_key",+ "required": false,"schema": {- "title": "Turn Id",+ "default": "default",+ "maxLength": 120,+ "minLength": 1,+ "title": "Session Key","type": "string"}},{- "in": "path",- "name": "partner_id",- "required": true,+ "in": "query",+ "name": "limit",+ "required": false,"schema": {- "title": "Partner Id",- "type": "string"+ "default": 200,+ "maximum": 500,+ "minimum": 1,+ "title": "Limit",+ "type": "integer"}},{@@ -34442,16 +34530,6 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/PartnerSeatRetryRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {@@ -34472,15 +34550,15 @@"description": "Validation Error"}},- "summary": "Retry Partner Group Seat",+ "summary": "Partner Group History","tags": ["partner-groups"]}},- "/api/partner-groups/{group_id}/whiteboard": {+ "/api/partner-groups/{group_id}/invocations": {"get": {- "operationId": "partner_group_whiteboard_api_partner_groups__group_id__whiteboard_get",+ "operationId": "partner_group_invocations_api_partner_groups__group_id__invocations_get","parameters": [{"in": "path",@@ -34491,6 +34569,18 @@"type": "string"}},+ {+ "in": "query",+ "name": "session_key",+ "required": false,+ "schema": {+ "default": "default",+ "maxLength": 120,+ "minLength": 1,+ "title": "Session Key",+ "type": "string"+ }+ },{"in": "query","name": "limit",@@ -34556,15 +34646,13 @@"description": "Validation Error"}},- "summary": "Partner Group Whiteboard",+ "summary": "Partner Group Invocations","tags": ["partner-groups"]- }- },- "/api/partner-groups/{group_id}/whiteboard/pins": {+ },"post": {- "operationId": "pin_partner_group_whiteboard_api_partner_groups__group_id__whiteboard_pins_post",+ "operationId": "create_partner_invocation_api_partner_groups__group_id__invocations_post","parameters": [{"in": "path",@@ -34612,7 +34700,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/WhiteboardPinRequest"+ "$ref": "#/components/schemas/CreatePartnerInvocationRequest"}}},@@ -34638,15 +34726,15 @@"description": "Validation Error"}},- "summary": "Pin Partner Group Whiteboard",+ "summary": "Create Partner Invocation","tags": ["partner-groups"]}},- "/api/partner-groups/{group_id}/whiteboard/pins/{event_id}": {- "delete": {- "operationId": "unpin_partner_group_whiteboard_api_partner_groups__group_id__whiteboard_pins__event_id__delete",+ "/api/partner-groups/{group_id}/invocations/{invocation_id}/approve": {+ "post": {+ "operationId": "approve_partner_invocation_api_partner_groups__group_id__invocations__invocation_id__approve_post","parameters": [{"in": "path",@@ -34659,10 +34747,10 @@},{"in": "path",- "name": "event_id",+ "name": "invocation_id","required": true,"schema": {- "title": "Event Id",+ "title": "Invocation Id","type": "string"}},@@ -34699,6 +34787,16 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/PartnerInvocationActionRequest"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -34719,79 +34817,34 @@"description": "Validation Error"}},- "summary": "Unpin Partner Group Whiteboard",+ "summary": "Approve Partner Invocation","tags": ["partner-groups"]}},- "/api/partners": {- "get": {- "description": "Partners the caller may talk to — theirs in full, assigned ones as cards.",- "operationId": "list_partners_api_partners_get",+ "/api/partner-groups/{group_id}/invocations/{invocation_id}/reject": {+ "post": {+ "operationId": "reject_partner_invocation_api_partner_groups__group_id__invocations__invocation_id__reject_post","parameters": [{- "in": "header",- "name": "Authorization",- "required": false,+ "in": "path",+ "name": "group_id",+ "required": true,"schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Authorization"+ "title": "Group Id",+ "type": "string"}},{- "in": "cookie",- "name": "dt_token",- "required": false,+ "in": "path",+ "name": "invocation_id",+ "required": true,"schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Dt Token"+ "title": "Invocation Id",+ "type": "string"}- }- ],- "responses": {- "200": {- "content": {- "application/json": {- "schema": {}- }- },- "description": "Successful Response"},- "422": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- },- "description": "Validation Error"- }- },- "summary": "List Partners",- "tags": [- "partners"- ]- },- "post": {- "description": "Create a partner owned by the caller.\n\nAnyone may build their own companion; the assets it is provisioned with are\nresolved against the creator's own permissions (see ``provision_assets``),\nso this hands nobody access they did not already have.",- "operationId": "create_partner_api_partners_post",- "parameters": [{"in": "header","name": "Authorization",@@ -34829,7 +34882,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/CreatePartnerRequest"+ "$ref": "#/components/schemas/PartnerInvocationActionRequest"}}},@@ -34855,17 +34908,25 @@"description": "Validation Error"}},- "summary": "Create Partner",+ "summary": "Reject Partner Invocation","tags": [- "partners"+ "partner-groups"]}},- "/api/partners/channels/schema": {- "get": {- "description": "JSON-Schema metadata for every available channel (schema-driven UI).",- "operationId": "list_channel_schemas_api_partners_channels_schema_get",+ "/api/partner-groups/{group_id}/messages": {+ "post": {+ "operationId": "send_partner_group_message_api_partner_groups__group_id__messages_post","parameters": [+ {+ "in": "path",+ "name": "group_id",+ "required": true,+ "schema": {+ "title": "Group Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -34899,6 +34960,16 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/PartnerGroupMessageRequest"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -34919,16 +34990,34 @@"description": "Validation Error"}},- "summary": "List Channel Schemas",+ "summary": "Send Partner Group Message","tags": [- "partners"+ "partner-groups"]}},- "/api/partners/commands/palette": {- "get": {- "operationId": "partner_command_palette_api_partners_commands_palette_get",+ "/api/partner-groups/{group_id}/rounds/{turn_id}/summary": {+ "post": {+ "operationId": "summarize_partner_group_round_api_partner_groups__group_id__rounds__turn_id__summary_post","parameters": [+ {+ "in": "path",+ "name": "group_id",+ "required": true,+ "schema": {+ "title": "Group Id",+ "type": "string"+ }+ },+ {+ "in": "path",+ "name": "turn_id",+ "required": true,+ "schema": {+ "title": "Turn Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -34962,6 +35051,16 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/RoundSummaryRequest"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -34982,32 +35081,22 @@"description": "Validation Error"}},- "summary": "Partner Command Palette",+ "summary": "Summarize Partner Group Round","tags": [- "partners"+ "partner-groups"]}},- "/api/partners/consultation-session": {+ "/api/partner-groups/{group_id}/sessions": {"get": {- "description": "Recover native identity for older consultation traces in this user's registry.",- "operationId": "get_partner_consultation_session_api_partners_consultation_session_get",+ "operationId": "list_partner_group_sessions_api_partner_groups__group_id__sessions_get","parameters": [{- "in": "query",- "name": "chat_session_id",- "required": true,- "schema": {- "title": "Chat Session Id",- "type": "string"- }- },- {- "in": "query",- "name": "partner_name",+ "in": "path",+ "name": "group_id","required": true,"schema": {- "title": "Partner Name",+ "title": "Group Id","type": "string"}},@@ -35064,23 +35153,20 @@"description": "Validation Error"}},- "summary": "Get Partner Consultation Session",+ "summary": "List Partner Group Sessions","tags": [- "partners"+ "partner-groups"]- }- },- "/api/partners/drafts/{draft_id}": {- "get": {- "description": "Reload one pending/created draft for the authenticated user.",- "operationId": "get_partner_draft_api_partners_drafts__draft_id__get",+ },+ "post": {+ "operationId": "create_partner_group_session_api_partner_groups__group_id__sessions_post","parameters": [{"in": "path",- "name": "draft_id",+ "name": "group_id","required": true,"schema": {- "title": "Draft Id",+ "title": "Group Id","type": "string"}},@@ -35118,7 +35204,7 @@}],"responses": {- "200": {+ "201": {"content": {"application/json": {"schema": {}@@ -35137,23 +35223,31 @@"description": "Validation Error"}},- "summary": "Get Partner Draft",+ "summary": "Create Partner Group Session","tags": [- "partners"+ "partner-groups"]}},- "/api/partners/drafts/{draft_id}/confirm": {- "post": {- "description": "Promote a reviewable Chat draft into a real Partner exactly once.",- "operationId": "confirm_partner_draft_api_partners_drafts__draft_id__confirm_post",+ "/api/partner-groups/{group_id}/sessions/{session_key}": {+ "delete": {+ "operationId": "delete_partner_group_session_api_partner_groups__group_id__sessions__session_key__delete","parameters": [{"in": "path",- "name": "draft_id",+ "name": "group_id","required": true,"schema": {- "title": "Draft Id",+ "title": "Group Id",+ "type": "string"+ }+ },+ {+ "in": "path",+ "name": "session_key",+ "required": true,+ "schema": {+ "title": "Session Key","type": "string"}},@@ -35190,16 +35284,6 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/ConfirmPartnerDraftRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {@@ -35220,24 +35304,41 @@"description": "Validation Error"}},- "summary": "Confirm Partner Draft",+ "summary": "Delete Partner Group Session","tags": [- "partners"+ "partner-groups"]}},- "/api/partners/recent": {- "get": {- "operationId": "recent_partners_api_partners_recent_get",+ "/api/partner-groups/{group_id}/turns/{turn_id}/partners/{partner_id}/retry": {+ "post": {+ "operationId": "retry_partner_group_seat_api_partner_groups__group_id__turns__turn_id__partners__partner_id__retry_post","parameters": [{- "in": "query",- "name": "limit",- "required": false,+ "in": "path",+ "name": "group_id",+ "required": true,"schema": {- "default": 3,- "title": "Limit",- "type": "integer"+ "title": "Group Id",+ "type": "string"+ }+ },+ {+ "in": "path",+ "name": "turn_id",+ "required": true,+ "schema": {+ "title": "Turn Id",+ "type": "string"+ }+ },+ {+ "in": "path",+ "name": "partner_id",+ "required": true,+ "schema": {+ "title": "Partner Id",+ "type": "string"}},{@@ -35273,6 +35374,16 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/PartnerSeatRetryRequest"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -35293,17 +35404,37 @@"description": "Validation Error"}},- "summary": "Recent Partners",+ "summary": "Retry Partner Group Seat","tags": [- "partners"+ "partner-groups"]}},- "/api/partners/soul-sources": {+ "/api/partner-groups/{group_id}/whiteboard": {"get": {- "description": "Everything the create-wizard's soul step can start from.",- "operationId": "soul_sources_api_partners_soul_sources_get",+ "operationId": "partner_group_whiteboard_api_partner_groups__group_id__whiteboard_get","parameters": [+ {+ "in": "path",+ "name": "group_id",+ "required": true,+ "schema": {+ "title": "Group Id",+ "type": "string"+ }+ },+ {+ "in": "query",+ "name": "limit",+ "required": false,+ "schema": {+ "default": 200,+ "maximum": 500,+ "minimum": 1,+ "title": "Limit",+ "type": "integer"+ }+ },{"in": "header","name": "Authorization",@@ -35357,16 +35488,25 @@"description": "Validation Error"}},- "summary": "Soul Sources",+ "summary": "Partner Group Whiteboard","tags": [- "partners"+ "partner-groups"]}},- "/api/partners/souls": {- "get": {- "operationId": "list_souls_api_partners_souls_get",+ "/api/partner-groups/{group_id}/whiteboard/pins": {+ "post": {+ "operationId": "pin_partner_group_whiteboard_api_partner_groups__group_id__whiteboard_pins_post","parameters": [+ {+ "in": "path",+ "name": "group_id",+ "required": true,+ "schema": {+ "title": "Group Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -35400,6 +35540,16 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/WhiteboardPinRequest"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -35420,14 +35570,34 @@"description": "Validation Error"}},- "summary": "List Souls",+ "summary": "Pin Partner Group Whiteboard","tags": [- "partners"+ "partner-groups"]- },- "post": {- "operationId": "create_soul_api_partners_souls_post",+ }+ },+ "/api/partner-groups/{group_id}/whiteboard/pins/{event_id}": {+ "delete": {+ "operationId": "unpin_partner_group_whiteboard_api_partner_groups__group_id__whiteboard_pins__event_id__delete","parameters": [+ {+ "in": "path",+ "name": "group_id",+ "required": true,+ "schema": {+ "title": "Group Id",+ "type": "string"+ }+ },+ {+ "in": "path",+ "name": "event_id",+ "required": true,+ "schema": {+ "title": "Event Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -35461,16 +35631,6 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/SoulCreateRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {@@ -35491,25 +35651,17 @@"description": "Validation Error"}},- "summary": "Create Soul",+ "summary": "Unpin Partner Group Whiteboard","tags": [- "partners"+ "partner-groups"]}},- "/api/partners/souls/{soul_id}": {- "delete": {- "operationId": "delete_soul_api_partners_souls__soul_id__delete",+ "/api/partners": {+ "get": {+ "description": "Partners the caller may talk to — theirs in full, assigned ones as cards.",+ "operationId": "list_partners_api_partners_get","parameters": [- {- "in": "path",- "name": "soul_id",- "required": true,- "schema": {- "title": "Soul Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -35563,23 +35715,15 @@"description": "Validation Error"}},- "summary": "Delete Soul",+ "summary": "List Partners","tags": ["partners"]},- "get": {- "operationId": "get_soul_api_partners_souls__soul_id__get",+ "post": {+ "description": "Create a partner owned by the caller.\n\nAnyone may build their own companion; the assets it is provisioned with are\nresolved against the creator's own permissions (see ``provision_assets``),\nso this hands nobody access they did not already have.",+ "operationId": "create_partner_api_partners_post","parameters": [- {- "in": "path",- "name": "soul_id",- "required": true,- "schema": {- "title": "Soul Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -35613,6 +35757,16 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/CreatePartnerRequest"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -35633,23 +35787,17 @@"description": "Validation Error"}},- "summary": "Get Soul",+ "summary": "Create Partner","tags": ["partners"]- },- "put": {- "operationId": "update_soul_api_partners_souls__soul_id__put",+ }+ },+ "/api/partners/channels/schema": {+ "get": {+ "description": "JSON-Schema metadata for every available channel (schema-driven UI).",+ "operationId": "list_channel_schemas_api_partners_channels_schema_get","parameters": [- {- "in": "path",- "name": "soul_id",- "required": true,- "schema": {- "title": "Soul Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -35683,16 +35831,6 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/SoulTemplateUpdateRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {@@ -35713,16 +35851,15 @@"description": "Validation Error"}},- "summary": "Update Soul",+ "summary": "List Channel Schemas","tags": ["partners"]}},- "/api/partners/tool-options": {+ "/api/partners/commands/palette": {"get": {- "description": "The configurable tool surface for a partner.\n\n``tools`` mirrors the user-toggleable system tools (the same pool the\nchat composer / settings expose); ``builtin_tools`` lists the auto-mounted\nbuilt-in tools (rag / web_fetch / …) the owner can allow or deny;\n``mcp_tools`` lists every configured MCP tool the partner could be allowed\nto load. ``read_memory`` / ``write_memory`` are excluded: partners use the\nmandatory ``partner_read`` / ``partner_memorize`` / ``partner_search`` tools\ninstead, which are always on and not owner-configurable.",- "operationId": "tool_options_api_partners_tool_options_get",+ "operationId": "partner_command_palette_api_partners_commands_palette_get","parameters": [{"in": "header",@@ -35777,22 +35914,32 @@"description": "Validation Error"}},- "summary": "Tool Options",+ "summary": "Partner Command Palette","tags": ["partners"]}},- "/api/partners/{partner_id}": {- "delete": {- "operationId": "destroy_partner_api_partners__partner_id__delete",+ "/api/partners/consultation-session": {+ "get": {+ "description": "Recover native identity for older consultation traces in this user's registry.",+ "operationId": "get_partner_consultation_session_api_partners_consultation_session_get","parameters": [{- "in": "path",- "name": "partner_id",+ "in": "query",+ "name": "chat_session_id","required": true,"schema": {- "title": "Partner Id",+ "title": "Chat Session Id",+ "type": "string"+ }+ },+ {+ "in": "query",+ "name": "partner_name",+ "required": true,+ "schema": {+ "title": "Partner Name","type": "string"}},@@ -35849,36 +35996,26 @@"description": "Validation Error"}},- "summary": "Destroy Partner",+ "summary": "Get Partner Consultation Session","tags": ["partners"]- },+ }+ },+ "/api/partners/drafts/{draft_id}": {"get": {- "description": "One partner, projected by what the caller may do with it.\n\nSomeone who merely *uses* the partner gets its identity card — enough to\nrender a conversation header — while its owner gets the configuration.",- "operationId": "get_partner_api_partners__partner_id__get",+ "description": "Reload one pending/created draft for the authenticated user.",+ "operationId": "get_partner_draft_api_partners_drafts__draft_id__get","parameters": [{"in": "path",- "name": "partner_id",+ "name": "draft_id","required": true,"schema": {- "title": "Partner Id",+ "title": "Draft Id","type": "string"}},- {- "description": "Return raw channel secrets (tokens, passwords). Required by the edit form; default response masks all secret-looking fields.",- "in": "query",- "name": "include_secrets",- "required": false,- "schema": {- "default": false,- "description": "Return raw channel secrets (tokens, passwords). Required by the edit form; default response masks all secret-looking fields.",- "title": "Include Secrets",- "type": "boolean"- }- },{"in": "header","name": "Authorization",@@ -35932,20 +36069,23 @@"description": "Validation Error"}},- "summary": "Get Partner",+ "summary": "Get Partner Draft","tags": ["partners"]- },- "patch": {- "operationId": "update_partner_api_partners__partner_id__patch",+ }+ },+ "/api/partners/drafts/{draft_id}/confirm": {+ "post": {+ "description": "Promote a reviewable Chat draft into a real Partner exactly once.",+ "operationId": "confirm_partner_draft_api_partners_drafts__draft_id__confirm_post","parameters": [{"in": "path",- "name": "partner_id",+ "name": "draft_id","required": true,"schema": {- "title": "Partner Id",+ "title": "Draft Id","type": "string"}},@@ -35986,7 +36126,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/UpdatePartnerRequest"+ "$ref": "#/components/schemas/ConfirmPartnerDraftRequest"}}},@@ -36012,23 +36152,24 @@"description": "Validation Error"}},- "summary": "Update Partner",+ "summary": "Confirm Partner Draft","tags": ["partners"]}},- "/api/partners/{partner_id}/assets": {+ "/api/partners/recent": {"get": {- "operationId": "get_partner_assets_api_partners__partner_id__assets_get",+ "operationId": "recent_partners_api_partners_recent_get","parameters": [{- "in": "path",- "name": "partner_id",- "required": true,+ "in": "query",+ "name": "limit",+ "required": false,"schema": {- "title": "Partner Id",- "type": "string"+ "default": 3,+ "title": "Limit",+ "type": "integer"}},{@@ -36084,23 +36225,17 @@"description": "Validation Error"}},- "summary": "Get Partner Assets",+ "summary": "Recent Partners","tags": ["partners"]- },- "post": {- "operationId": "add_partner_assets_api_partners__partner_id__assets_post",+ }+ },+ "/api/partners/soul-sources": {+ "get": {+ "description": "Everything the create-wizard's soul step can start from.",+ "operationId": "soul_sources_api_partners_soul_sources_get","parameters": [- {- "in": "path",- "name": "partner_id",- "required": true,- "schema": {- "title": "Partner Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -36134,16 +36269,6 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/AssetAddRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {@@ -36164,43 +36289,16 @@"description": "Validation Error"}},- "summary": "Add Partner Assets",+ "summary": "Soul Sources","tags": ["partners"]}},- "/api/partners/{partner_id}/assets/{asset_type}/{name}": {- "delete": {- "operationId": "delete_partner_asset_api_partners__partner_id__assets__asset_type___name__delete",+ "/api/partners/souls": {+ "get": {+ "operationId": "list_souls_api_partners_souls_get","parameters": [- {- "in": "path",- "name": "partner_id",- "required": true,- "schema": {- "title": "Partner Id",- "type": "string"- }- },- {- "in": "path",- "name": "asset_type",- "required": true,- "schema": {- "title": "Asset Type",- "type": "string"- }- },- {- "in": "path",- "name": "name",- "required": true,- "schema": {- "title": "Name",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -36254,25 +36352,14 @@"description": "Validation Error"}},- "summary": "Delete Partner Asset",+ "summary": "List Souls","tags": ["partners"]- }- },- "/api/partners/{partner_id}/channel-onboarding/start": {+ },"post": {- "operationId": "start_partner_channel_onboarding_api_partners__partner_id__channel_onboarding_start_post",+ "operationId": "create_soul_api_partners_souls_post","parameters": [- {- "in": "path",- "name": "partner_id",- "required": true,- "schema": {- "title": "Partner Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -36310,7 +36397,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/ChannelOnboardingStartRequest"+ "$ref": "#/components/schemas/SoulCreateRequest"}}},@@ -36336,31 +36423,22 @@"description": "Validation Error"}},- "summary": "Start Partner Channel Onboarding",+ "summary": "Create Soul","tags": ["partners"]}},- "/api/partners/{partner_id}/channel-onboarding/{session_id}": {+ "/api/partners/souls/{soul_id}": {"delete": {- "operationId": "cancel_partner_channel_onboarding_api_partners__partner_id__channel_onboarding__session_id__delete",+ "operationId": "delete_soul_api_partners_souls__soul_id__delete","parameters": [{"in": "path",- "name": "partner_id",- "required": true,- "schema": {- "title": "Partner Id",- "type": "string"- }- },- {- "in": "path",- "name": "session_id",+ "name": "soul_id","required": true,"schema": {- "title": "Session Id",+ "title": "Soul Id","type": "string"}},@@ -36417,29 +36495,20 @@"description": "Validation Error"}},- "summary": "Cancel Partner Channel Onboarding",+ "summary": "Delete Soul","tags": ["partners"]},"get": {- "operationId": "get_partner_channel_onboarding_api_partners__partner_id__channel_onboarding__session_id__get",+ "operationId": "get_soul_api_partners_souls__soul_id__get","parameters": [{"in": "path",- "name": "partner_id",- "required": true,- "schema": {- "title": "Partner Id",- "type": "string"- }- },- {- "in": "path",- "name": "session_id",+ "name": "soul_id","required": true,"schema": {- "title": "Session Id",+ "title": "Soul Id","type": "string"}},@@ -36496,34 +36565,97 @@"description": "Validation Error"}},- "summary": "Get Partner Channel Onboarding",+ "summary": "Get Soul","tags": ["partners"]- }- },- "/api/partners/{partner_id}/channel-onboarding/{session_id}/apply": {- "post": {- "operationId": "apply_partner_channel_onboarding_api_partners__partner_id__channel_onboarding__session_id__apply_post",+ },+ "put": {+ "operationId": "update_soul_api_partners_souls__soul_id__put","parameters": [{"in": "path",- "name": "partner_id",+ "name": "soul_id","required": true,"schema": {- "title": "Partner Id",+ "title": "Soul Id","type": "string"}},{- "in": "path",- "name": "session_id",- "required": true,+ "in": "header",+ "name": "Authorization",+ "required": false,"schema": {- "title": "Session Id",- "type": "string"+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"}},+ {+ "in": "cookie",+ "name": "dt_token",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"+ }+ }+ ],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/SoulTemplateUpdateRequest"+ }+ }+ },+ "required": true+ },+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {}+ }+ },+ "description": "Successful Response"+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "Update Soul",+ "tags": [+ "partners"+ ]+ }+ },+ "/api/partners/tool-options": {+ "get": {+ "description": "The configurable tool surface for a partner.\n\n``tools`` mirrors the user-toggleable system tools (the same pool the\nchat composer / settings expose); ``builtin_tools`` lists the auto-mounted\nbuilt-in tools (rag / web_fetch / …) the owner can allow or deny;\n``mcp_tools`` lists every configured MCP tool the partner could be allowed\nto load. ``read_memory`` / ``write_memory`` are excluded: partners use the\nmandatory ``partner_read`` / ``partner_memorize`` / ``partner_search`` tools\ninstead, which are always on and not owner-configurable.",+ "operationId": "tool_options_api_partners_tool_options_get",+ "parameters": [{"in": "header","name": "Authorization",@@ -36577,15 +36709,15 @@"description": "Validation Error"}},- "summary": "Apply Partner Channel Onboarding",+ "summary": "Tool Options","tags": ["partners"]}},- "/api/partners/{partner_id}/channels/reload": {- "post": {- "operationId": "reload_partner_channels_api_partners__partner_id__channels_reload_post",+ "/api/partners/{partner_id}": {+ "delete": {+ "operationId": "destroy_partner_api_partners__partner_id__delete","parameters": [{"in": "path",@@ -36649,16 +36781,14 @@"description": "Validation Error"}},- "summary": "Reload Partner Channels",+ "summary": "Destroy Partner","tags": ["partners"]- }- },- "/api/partners/{partner_id}/channels/status": {+ },"get": {- "description": "User-facing listener/setup state, including QR output when available.",- "operationId": "get_partner_channel_status_api_partners__partner_id__channels_status_get",+ "description": "One partner, projected by what the caller may do with it.\n\nSomeone who merely *uses* the partner gets its identity card — enough to\nrender a conversation header — while its owner gets the configuration.",+ "operationId": "get_partner_api_partners__partner_id__get","parameters": [{"in": "path",@@ -36669,6 +36799,18 @@"type": "string"}},+ {+ "description": "Return raw channel secrets (tokens, passwords). Required by the edit form; default response masks all secret-looking fields.",+ "in": "query",+ "name": "include_secrets",+ "required": false,+ "schema": {+ "default": false,+ "description": "Return raw channel secrets (tokens, passwords). Required by the edit form; default response masks all secret-looking fields.",+ "title": "Include Secrets",+ "type": "boolean"+ }+ },{"in": "header","name": "Authorization",@@ -36722,16 +36864,13 @@"description": "Validation Error"}},- "summary": "Get Partner Channel Status",+ "summary": "Get Partner","tags": ["partners"]- }- },- "/api/partners/{partner_id}/channels/weixin/qr": {- "post": {- "description": "Issue a QR code for this partner and return what to render.",- "operationId": "start_weixin_qr_api_partners__partner_id__channels_weixin_qr_post",+ },+ "patch": {+ "operationId": "update_partner_api_partners__partner_id__patch","parameters": [{"in": "path",@@ -36775,6 +36914,16 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/UpdatePartnerRequest"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -36795,16 +36944,15 @@"description": "Validation Error"}},- "summary": "Start Weixin Qr",+ "summary": "Update Partner","tags": ["partners"]}},- "/api/partners/{partner_id}/channels/weixin/qr/{session_id}": {+ "/api/partners/{partner_id}/assets": {"get": {- "description": "Advance the scan and report its state (never the token).",- "operationId": "poll_weixin_qr_api_partners__partner_id__channels_weixin_qr__session_id__get",+ "operationId": "get_partner_assets_api_partners__partner_id__assets_get","parameters": [{"in": "path",@@ -36815,15 +36963,6 @@"type": "string"}},- {- "in": "path",- "name": "session_id",- "required": true,- "schema": {- "title": "Session Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -36877,16 +37016,13 @@"description": "Validation Error"}},- "summary": "Poll Weixin Qr",+ "summary": "Get Partner Assets","tags": ["partners"]- }- },- "/api/partners/{partner_id}/chat": {+ },"post": {- "description": "Send one HTTP message to a partner with persistent session context.",- "operationId": "partner_chat_http_api_partners__partner_id__chat_post",+ "operationId": "add_partner_assets_api_partners__partner_id__assets_post","parameters": [{"in": "path",@@ -36934,7 +37070,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/ChatMessageRequest"+ "$ref": "#/components/schemas/AssetAddRequest"}}},@@ -36944,11 +37080,7 @@"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Partner Chat Http Api Partners Partner Id Chat Post",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -36964,16 +37096,15 @@"description": "Validation Error"}},- "summary": "Partner Chat Http",+ "summary": "Add Partner Assets","tags": ["partners"]}},- "/api/partners/{partner_id}/chat/execute-stream": {- "post": {- "description": "Stream one HTTP message to a partner as server-sent events.",- "operationId": "partner_chat_http_stream_api_partners__partner_id__chat_execute_stream_post",+ "/api/partners/{partner_id}/assets/{asset_type}/{name}": {+ "delete": {+ "operationId": "delete_partner_asset_api_partners__partner_id__assets__asset_type___name__delete","parameters": [{"in": "path",@@ -36984,6 +37115,24 @@"type": "string"}},+ {+ "in": "path",+ "name": "asset_type",+ "required": true,+ "schema": {+ "title": "Asset Type",+ "type": "string"+ }+ },+ {+ "in": "path",+ "name": "name",+ "required": true,+ "schema": {+ "title": "Name",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -37017,16 +37166,6 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/ChatMessageRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {@@ -37047,16 +37186,15 @@"description": "Validation Error"}},- "summary": "Partner Chat Http Stream",+ "summary": "Delete Partner Asset","tags": ["partners"]}},- "/api/partners/{partner_id}/history": {- "get": {- "description": "Conversation history. Pass ``session_key`` for an exact key, or\n``session_id`` for a web session (mapped through ``web_session_key``);\nwith neither, all non-archived sessions are merged.",- "operationId": "get_partner_history_api_partners__partner_id__history_get",+ "/api/partners/{partner_id}/channel-onboarding/start": {+ "post": {+ "operationId": "start_partner_channel_onboarding_api_partners__partner_id__channel_onboarding_start_post","parameters": [{"in": "path",@@ -37068,8 +37206,8 @@}},{- "in": "query",- "name": "session_key",+ "in": "header",+ "name": "Authorization","required": false,"schema": {"anyOf": [@@ -37080,12 +37218,12 @@"type": "null"}],- "title": "Session Key"+ "title": "Authorization"}},{- "in": "query",- "name": "session_id",+ "in": "cookie",+ "name": "dt_token","required": false,"schema": {"anyOf": [@@ -37096,17 +37234,66 @@"type": "null"}],- "title": "Session Id"+ "title": "Dt Token"+ }+ }+ ],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/ChannelOnboardingStartRequest"+ }}},+ "required": true+ },+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {}+ }+ },+ "description": "Successful Response"+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "Start Partner Channel Onboarding",+ "tags": [+ "partners"+ ]+ }+ },+ "/api/partners/{partner_id}/channel-onboarding/{session_id}": {+ "delete": {+ "operationId": "cancel_partner_channel_onboarding_api_partners__partner_id__channel_onboarding__session_id__delete",+ "parameters": [{- "in": "query",- "name": "limit",- "required": false,+ "in": "path",+ "name": "partner_id",+ "required": true,"schema": {- "default": 100,- "title": "Limit",- "type": "integer"+ "title": "Partner Id",+ "type": "string"+ }+ },+ {+ "in": "path",+ "name": "session_id",+ "required": true,+ "schema": {+ "title": "Session Id",+ "type": "string"}},{@@ -37162,16 +37349,13 @@"description": "Validation Error"}},- "summary": "Get Partner History",+ "summary": "Cancel Partner Channel Onboarding","tags": ["partners"]- }- },- "/api/partners/{partner_id}/history/page": {+ },"get": {- "description": "Read older turns of one actor-scoped conversation in bounded pages.",- "operationId": "get_partner_history_page_api_partners__partner_id__history_page_get",+ "operationId": "get_partner_channel_onboarding_api_partners__partner_id__channel_onboarding__session_id__get","parameters": [{"in": "path",@@ -37183,43 +37367,14 @@}},{- "in": "query",- "name": "session_key",+ "in": "path",+ "name": "session_id","required": true,"schema": {- "title": "Session Key",+ "title": "Session Id","type": "string"}},- {- "in": "query",- "name": "before",- "required": false,- "schema": {- "anyOf": [- {- "minimum": 0,- "type": "integer"- },- {- "type": "null"- }- ],- "title": "Before"- }- },- {- "in": "query",- "name": "limit",- "required": false,- "schema": {- "default": 60,- "maximum": 200,- "minimum": 1,- "title": "Limit",- "type": "integer"- }- },{"in": "header","name": "Authorization",@@ -37273,16 +37428,15 @@"description": "Validation Error"}},- "summary": "Get Partner History Page",+ "summary": "Get Partner Channel Onboarding","tags": ["partners"]}},- "/api/partners/{partner_id}/links": {- "get": {- "description": "Your own linked chat accounts for this partner — never anyone else's.",- "operationId": "list_partner_links_api_partners__partner_id__links_get",+ "/api/partners/{partner_id}/channel-onboarding/{session_id}/apply": {+ "post": {+ "operationId": "apply_partner_channel_onboarding_api_partners__partner_id__channel_onboarding__session_id__apply_post","parameters": [{"in": "path",@@ -37293,6 +37447,15 @@"type": "string"}},+ {+ "in": "path",+ "name": "session_id",+ "required": true,+ "schema": {+ "title": "Session Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -37346,16 +37509,15 @@"description": "Validation Error"}},- "summary": "List Partner Links",+ "summary": "Apply Partner Channel Onboarding","tags": ["partners"]}},- "/api/partners/{partner_id}/links/code": {+ "/api/partners/{partner_id}/channels/reload": {"post": {- "description": "Mint a code for connecting one of your chat accounts to this partner.\n\nSend ``/link <code>`` to the partner as a direct message from the chat\naccount you want connected; that account then speaks as you.",- "operationId": "create_partner_link_code_api_partners__partner_id__links_code_post",+ "operationId": "reload_partner_channels_api_partners__partner_id__channels_reload_post","parameters": [{"in": "path",@@ -37419,16 +37581,16 @@"description": "Validation Error"}},- "summary": "Create Partner Link Code",+ "summary": "Reload Partner Channels","tags": ["partners"]}},- "/api/partners/{partner_id}/links/{key}": {- "delete": {- "description": "Disconnect one of your chat accounts; its past messages stay yours.",- "operationId": "delete_partner_link_api_partners__partner_id__links__key__delete",+ "/api/partners/{partner_id}/channels/status": {+ "get": {+ "description": "User-facing listener/setup state, including QR output when available.",+ "operationId": "get_partner_channel_status_api_partners__partner_id__channels_status_get","parameters": [{"in": "path",@@ -37439,15 +37601,6 @@"type": "string"}},- {- "in": "path",- "name": "key",- "required": true,- "schema": {- "title": "Key",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -37501,15 +37654,16 @@"description": "Validation Error"}},- "summary": "Delete Partner Link",+ "summary": "Get Partner Channel Status","tags": ["partners"]}},- "/api/partners/{partner_id}/sessions": {- "get": {- "operationId": "get_partner_sessions_api_partners__partner_id__sessions_get",+ "/api/partners/{partner_id}/channels/weixin/qr": {+ "post": {+ "description": "Issue a QR code for this partner and return what to render.",+ "operationId": "start_weixin_qr_api_partners__partner_id__channels_weixin_qr_post","parameters": [{"in": "path",@@ -37573,16 +37727,16 @@"description": "Validation Error"}},- "summary": "Get Partner Sessions",+ "summary": "Start Weixin Qr","tags": ["partners"]}},- "/api/partners/{partner_id}/sessions/archive": {- "post": {- "description": "Soft-archive a session (web /new) — it stays resumable, file untouched.",- "operationId": "archive_partner_session_api_partners__partner_id__sessions_archive_post",+ "/api/partners/{partner_id}/channels/weixin/qr/{session_id}": {+ "get": {+ "description": "Advance the scan and report its state (never the token).",+ "operationId": "poll_weixin_qr_api_partners__partner_id__channels_weixin_qr__session_id__get","parameters": [{"in": "path",@@ -37593,6 +37747,15 @@"type": "string"}},+ {+ "in": "path",+ "name": "session_id",+ "required": true,+ "schema": {+ "title": "Session Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -37626,16 +37789,6 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/SessionKeyBody"- }- }- },- "required": true- },"responses": {"200": {"content": {@@ -37656,16 +37809,16 @@"description": "Validation Error"}},- "summary": "Archive Partner Session",+ "summary": "Poll Weixin Qr","tags": ["partners"]}},- "/api/partners/{partner_id}/sessions/branch": {+ "/api/partners/{partner_id}/chat": {"post": {- "description": "Copy a session's full history into a new key and archive the source.",- "operationId": "branch_partner_session_api_partners__partner_id__sessions_branch_post",+ "description": "Send one HTTP message to a partner with persistent session context.",+ "operationId": "partner_chat_http_api_partners__partner_id__chat_post","parameters": [{"in": "path",@@ -37713,7 +37866,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/SessionBranchBody"+ "$ref": "#/components/schemas/ChatMessageRequest"}}},@@ -37723,7 +37876,11 @@"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": true,+ "title": "Response Partner Chat Http Api Partners Partner Id Chat Post",+ "type": "object"+ }}},"description": "Successful Response"@@ -37739,15 +37896,16 @@"description": "Validation Error"}},- "summary": "Branch Partner Session",+ "summary": "Partner Chat Http","tags": ["partners"]}},- "/api/partners/{partner_id}/sessions/delete": {+ "/api/partners/{partner_id}/chat/execute-stream": {"post": {- "operationId": "delete_partner_session_api_partners__partner_id__sessions_delete_post",+ "description": "Stream one HTTP message to a partner as server-sent events.",+ "operationId": "partner_chat_http_stream_api_partners__partner_id__chat_execute_stream_post","parameters": [{"in": "path",@@ -37795,7 +37953,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/SessionKeyBody"+ "$ref": "#/components/schemas/ChatMessageRequest"}}},@@ -37821,16 +37979,16 @@"description": "Validation Error"}},- "summary": "Delete Partner Session",+ "summary": "Partner Chat Http Stream","tags": ["partners"]}},- "/api/partners/{partner_id}/sessions/resume": {- "post": {- "description": "Clear a session's archived flag so the web app can continue it.",- "operationId": "resume_partner_session_api_partners__partner_id__sessions_resume_post",+ "/api/partners/{partner_id}/history": {+ "get": {+ "description": "Conversation history. Pass ``session_key`` for an exact key, or\n``session_id`` for a web session (mapped through ``web_session_key``);\nwith neither, all non-archived sessions are merged.",+ "operationId": "get_partner_history_api_partners__partner_id__history_get","parameters": [{"in": "path",@@ -37842,8 +38000,8 @@}},{- "in": "header",- "name": "Authorization",+ "in": "query",+ "name": "session_key","required": false,"schema": {"anyOf": [@@ -37854,12 +38012,12 @@"type": "null"}],- "title": "Authorization"+ "title": "Session Key"}},{- "in": "cookie",- "name": "dt_token",+ "in": "query",+ "name": "session_id","required": false,"schema": {"anyOf": [@@ -37870,57 +38028,17 @@"type": "null"}],- "title": "Dt Token"- }- }- ],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/SessionKeyBody"- }+ "title": "Session Id"}},- "required": true- },- "responses": {- "200": {- "content": {- "application/json": {- "schema": {}- }- },- "description": "Successful Response"- },- "422": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- },- "description": "Validation Error"- }- },- "summary": "Resume Partner Session",- "tags": [- "partners"- ]- }- },- "/api/partners/{partner_id}/soul": {- "get": {- "operationId": "get_partner_soul_api_partners__partner_id__soul_get",- "parameters": [{- "in": "path",- "name": "partner_id",- "required": true,+ "in": "query",+ "name": "limit",+ "required": false,"schema": {- "title": "Partner Id",- "type": "string"+ "default": 100,+ "title": "Limit",+ "type": "integer"}},{@@ -37976,13 +38094,16 @@"description": "Validation Error"}},- "summary": "Get Partner Soul",+ "summary": "Get Partner History","tags": ["partners"]- },- "put": {- "operationId": "put_partner_soul_api_partners__partner_id__soul_put",+ }+ },+ "/api/partners/{partner_id}/history/page": {+ "get": {+ "description": "Read older turns of one actor-scoped conversation in bounded pages.",+ "operationId": "get_partner_history_page_api_partners__partner_id__history_page_get","parameters": [{"in": "path",@@ -37993,6 +38114,44 @@"type": "string"}},+ {+ "in": "query",+ "name": "session_key",+ "required": true,+ "schema": {+ "title": "Session Key",+ "type": "string"+ }+ },+ {+ "in": "query",+ "name": "before",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "minimum": 0,+ "type": "integer"+ },+ {+ "type": "null"+ }+ ],+ "title": "Before"+ }+ },+ {+ "in": "query",+ "name": "limit",+ "required": false,+ "schema": {+ "default": 60,+ "maximum": 200,+ "minimum": 1,+ "title": "Limit",+ "type": "integer"+ }+ },{"in": "header","name": "Authorization",@@ -38026,16 +38185,6 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/SoulUpdateBody"- }- }- },- "required": true- },"responses": {"200": {"content": {@@ -38056,15 +38205,16 @@"description": "Validation Error"}},- "summary": "Put Partner Soul",+ "summary": "Get Partner History Page","tags": ["partners"]}},- "/api/partners/{partner_id}/start": {- "post": {- "operationId": "start_partner_api_partners__partner_id__start_post",+ "/api/partners/{partner_id}/links": {+ "get": {+ "description": "Your own linked chat accounts for this partner — never anyone else's.",+ "operationId": "list_partner_links_api_partners__partner_id__links_get","parameters": [{"in": "path",@@ -38128,15 +38278,16 @@"description": "Validation Error"}},- "summary": "Start Partner",+ "summary": "List Partner Links","tags": ["partners"]}},- "/api/partners/{partner_id}/stop": {+ "/api/partners/{partner_id}/links/code": {"post": {- "operationId": "stop_partner_api_partners__partner_id__stop_post",+ "description": "Mint a code for connecting one of your chat accounts to this partner.\n\nSend ``/link <code>`` to the partner as a direct message from the chat\naccount you want connected; that account then speaks as you.",+ "operationId": "create_partner_link_code_api_partners__partner_id__links_code_post","parameters": [{"in": "path",@@ -38200,15 +38351,16 @@"description": "Validation Error"}},- "summary": "Stop Partner",+ "summary": "Create Partner Link Code","tags": ["partners"]}},- "/api/partners/{partner_id}/web-continuity": {- "get": {- "operationId": "get_partner_web_continuity_api_partners__partner_id__web_continuity_get",+ "/api/partners/{partner_id}/links/{key}": {+ "delete": {+ "description": "Disconnect one of your chat accounts; its past messages stay yours.",+ "operationId": "delete_partner_link_api_partners__partner_id__links__key__delete","parameters": [{"in": "path",@@ -38219,6 +38371,15 @@"type": "string"}},+ {+ "in": "path",+ "name": "key",+ "required": true,+ "schema": {+ "title": "Key",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -38272,13 +38433,15 @@"description": "Validation Error"}},- "summary": "Get Partner Web Continuity",+ "summary": "Delete Partner Link","tags": ["partners"]- },- "put": {- "operationId": "put_partner_web_continuity_api_partners__partner_id__web_continuity_put",+ }+ },+ "/api/partners/{partner_id}/sessions": {+ "get": {+ "operationId": "get_partner_sessions_api_partners__partner_id__sessions_get","parameters": [{"in": "path",@@ -38322,16 +38485,6 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/WebContinuityBody"- }- }- },- "required": true- },"responses": {"200": {"content": {@@ -38352,16 +38505,16 @@"description": "Validation Error"}},- "summary": "Put Partner Web Continuity",+ "summary": "Get Partner Sessions","tags": ["partners"]}},- "/api/partners/{partner_id}/workspaces": {- "get": {- "description": "Configuration choices belong to the Partner owner, including admin edits.",- "operationId": "get_partner_workspaces_api_partners__partner_id__workspaces_get",+ "/api/partners/{partner_id}/sessions/archive": {+ "post": {+ "description": "Soft-archive a session (web /new) — it stays resumable, file untouched.",+ "operationId": "archive_partner_session_api_partners__partner_id__sessions_archive_post","parameters": [{"in": "path",@@ -38405,6 +38558,16 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/SessionKeyBody"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -38425,16 +38588,26 @@"description": "Validation Error"}},- "summary": "Get Partner Workspaces",+ "summary": "Archive Partner Session","tags": ["partners"]}},- "/api/personas": {- "get": {- "operationId": "list_personas_api_personas_get",+ "/api/partners/{partner_id}/sessions/branch": {+ "post": {+ "description": "Copy a session's full history into a new key and archive the source.",+ "operationId": "branch_partner_session_api_partners__partner_id__sessions_branch_post","parameters": [+ {+ "in": "path",+ "name": "partner_id",+ "required": true,+ "schema": {+ "title": "Partner Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -38468,21 +38641,21 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/SessionBranchBody"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {"application/json": {- "schema": {- "additionalProperties": {- "items": {- "additionalProperties": true,- "type": "object"- },- "type": "array"- },- "title": "Response List Personas Api Personas Get",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -38498,14 +38671,25 @@"description": "Validation Error"}},- "summary": "List Personas",+ "summary": "Branch Partner Session","tags": [- "personas"+ "partners"]- },+ }+ },+ "/api/partners/{partner_id}/sessions/delete": {"post": {- "operationId": "create_persona_api_personas_post",+ "operationId": "delete_partner_session_api_partners__partner_id__sessions_delete_post","parameters": [+ {+ "in": "path",+ "name": "partner_id",+ "required": true,+ "schema": {+ "title": "Partner Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -38543,7 +38727,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/CreatePersonaRequest"+ "$ref": "#/components/schemas/SessionKeyBody"}}},@@ -38553,11 +38737,7 @@"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Create Persona Api Personas Post",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -38573,22 +38753,23 @@"description": "Validation Error"}},- "summary": "Create Persona",+ "summary": "Delete Partner Session","tags": [- "personas"+ "partners"]}},- "/api/personas/{name}": {- "delete": {- "operationId": "delete_persona_api_personas__name__delete",+ "/api/partners/{partner_id}/sessions/resume": {+ "post": {+ "description": "Clear a session's archived flag so the web app can continue it.",+ "operationId": "resume_partner_session_api_partners__partner_id__sessions_resume_post","parameters": [{"in": "path",- "name": "name",+ "name": "partner_id","required": true,"schema": {- "title": "Name",+ "title": "Partner Id","type": "string"}},@@ -38625,17 +38806,21 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/SessionKeyBody"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {"application/json": {- "schema": {- "additionalProperties": {- "type": "string"- },- "title": "Response Delete Persona Api Personas Name Delete",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -38651,20 +38836,22 @@"description": "Validation Error"}},- "summary": "Delete Persona",+ "summary": "Resume Partner Session","tags": [- "personas"+ "partners"]- },+ }+ },+ "/api/partners/{partner_id}/soul": {"get": {- "operationId": "get_persona_api_personas__name__get",+ "operationId": "get_partner_soul_api_partners__partner_id__soul_get","parameters": [{"in": "path",- "name": "name",+ "name": "partner_id","required": true,"schema": {- "title": "Name",+ "title": "Partner Id","type": "string"}},@@ -38705,11 +38892,7 @@"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Get Persona Api Personas Name Get",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -38725,20 +38908,20 @@"description": "Validation Error"}},- "summary": "Get Persona",+ "summary": "Get Partner Soul","tags": [- "personas"+ "partners"]},"put": {- "operationId": "update_persona_api_personas__name__put",+ "operationId": "put_partner_soul_api_partners__partner_id__soul_put","parameters": [{"in": "path",- "name": "name",+ "name": "partner_id","required": true,"schema": {- "title": "Name",+ "title": "Partner Id","type": "string"}},@@ -38779,7 +38962,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/UpdatePersonaRequest"+ "$ref": "#/components/schemas/SoulUpdateBody"}}},@@ -38789,11 +38972,7 @@"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Update Persona Api Personas Name Put",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -38809,24 +38988,22 @@"description": "Validation Error"}},- "summary": "Update Persona",+ "summary": "Put Partner Soul","tags": [- "personas"+ "partners"]}},- "/api/question-notebook/categories": {- "get": {- "description": "Categories, with their counts scoped the same way the listing is.\n\nWithout the scope the rail would offer \"Address translation 3\" inside a\ncourse holding none of those three.",- "operationId": "list_categories_api_question_notebook_categories_get",+ "/api/partners/{partner_id}/start": {+ "post": {+ "operationId": "start_partner_api_partners__partner_id__start_post","parameters": [{- "in": "query",- "name": "course_id",- "required": false,+ "in": "path",+ "name": "partner_id",+ "required": true,"schema": {- "default": "",- "title": "Course Id",+ "title": "Partner Id","type": "string"}},@@ -38867,86 +39044,7 @@"200": {"content": {"application/json": {- "schema": {- "items": {- "$ref": "#/components/schemas/CategoryItem"- },- "title": "Response List Categories Api Question Notebook Categories Get",- "type": "array"- }- }- },- "description": "Successful Response"- },- "422": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- },- "description": "Validation Error"- }- },- "summary": "List Categories",- "tags": [- "question-notebook"- ]- },- "post": {- "operationId": "create_category_api_question_notebook_categories_post",- "parameters": [- {- "in": "header",- "name": "Authorization",- "required": false,- "schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Authorization"- }- },- {- "in": "cookie",- "name": "dt_token",- "required": false,- "schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Dt Token"- }- }- ],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/CategoryCreateRequest"- }- }- },- "required": true- },- "responses": {- "201": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/CategoryItem"- }+ "schema": {}}},"description": "Successful Response"@@ -38962,23 +39060,857 @@"description": "Validation Error"}},- "summary": "Create Category",+ "summary": "Start Partner","tags": [- "question-notebook"+ "partners"]}},- "/api/question-notebook/categories/{category_id}": {- "delete": {- "operationId": "delete_category_api_question_notebook_categories__category_id__delete",+ "/api/partners/{partner_id}/stop": {+ "post": {+ "operationId": "stop_partner_api_partners__partner_id__stop_post","parameters": [{"in": "path",- "name": "category_id",+ "name": "partner_id","required": true,"schema": {- "title": "Category Id",- "type": "integer"+ "title": "Partner Id",+ "type": "string"+ }+ },+ {+ "in": "header",+ "name": "Authorization",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"+ }+ },+ {+ "in": "cookie",+ "name": "dt_token",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"+ }+ }+ ],+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {}+ }+ },+ "description": "Successful Response"+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "Stop Partner",+ "tags": [+ "partners"+ ]+ }+ },+ "/api/partners/{partner_id}/web-continuity": {+ "get": {+ "operationId": "get_partner_web_continuity_api_partners__partner_id__web_continuity_get",+ "parameters": [+ {+ "in": "path",+ "name": "partner_id",+ "required": true,+ "schema": {+ "title": "Partner Id",+ "type": "string"+ }+ },+ {+ "in": "header",+ "name": "Authorization",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"+ }+ },+ {+ "in": "cookie",+ "name": "dt_token",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"+ }+ }+ ],+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {}+ }+ },+ "description": "Successful Response"+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "Get Partner Web Continuity",+ "tags": [+ "partners"+ ]+ },+ "put": {+ "operationId": "put_partner_web_continuity_api_partners__partner_id__web_continuity_put",+ "parameters": [+ {+ "in": "path",+ "name": "partner_id",+ "required": true,+ "schema": {+ "title": "Partner Id",+ "type": "string"+ }+ },+ {+ "in": "header",+ "name": "Authorization",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"+ }+ },+ {+ "in": "cookie",+ "name": "dt_token",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"+ }+ }+ ],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/WebContinuityBody"+ }+ }+ },+ "required": true+ },+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {}+ }+ },+ "description": "Successful Response"+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "Put Partner Web Continuity",+ "tags": [+ "partners"+ ]+ }+ },+ "/api/partners/{partner_id}/workspaces": {+ "get": {+ "description": "Configuration choices belong to the Partner owner, including admin edits.",+ "operationId": "get_partner_workspaces_api_partners__partner_id__workspaces_get",+ "parameters": [+ {+ "in": "path",+ "name": "partner_id",+ "required": true,+ "schema": {+ "title": "Partner Id",+ "type": "string"+ }+ },+ {+ "in": "header",+ "name": "Authorization",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"+ }+ },+ {+ "in": "cookie",+ "name": "dt_token",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"+ }+ }+ ],+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {}+ }+ },+ "description": "Successful Response"+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "Get Partner Workspaces",+ "tags": [+ "partners"+ ]+ }+ },+ "/api/personas": {+ "get": {+ "operationId": "list_personas_api_personas_get",+ "parameters": [+ {+ "in": "header",+ "name": "Authorization",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"+ }+ },+ {+ "in": "cookie",+ "name": "dt_token",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"+ }+ }+ ],+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {+ "additionalProperties": {+ "items": {+ "additionalProperties": true,+ "type": "object"+ },+ "type": "array"+ },+ "title": "Response List Personas Api Personas Get",+ "type": "object"+ }+ }+ },+ "description": "Successful Response"+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "List Personas",+ "tags": [+ "personas"+ ]+ },+ "post": {+ "operationId": "create_persona_api_personas_post",+ "parameters": [+ {+ "in": "header",+ "name": "Authorization",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"+ }+ },+ {+ "in": "cookie",+ "name": "dt_token",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"+ }+ }+ ],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/CreatePersonaRequest"+ }+ }+ },+ "required": true+ },+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {+ "additionalProperties": true,+ "title": "Response Create Persona Api Personas Post",+ "type": "object"+ }+ }+ },+ "description": "Successful Response"+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "Create Persona",+ "tags": [+ "personas"+ ]+ }+ },+ "/api/personas/{name}": {+ "delete": {+ "operationId": "delete_persona_api_personas__name__delete",+ "parameters": [+ {+ "in": "path",+ "name": "name",+ "required": true,+ "schema": {+ "title": "Name",+ "type": "string"+ }+ },+ {+ "in": "header",+ "name": "Authorization",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"+ }+ },+ {+ "in": "cookie",+ "name": "dt_token",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"+ }+ }+ ],+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {+ "additionalProperties": {+ "type": "string"+ },+ "title": "Response Delete Persona Api Personas Name Delete",+ "type": "object"+ }+ }+ },+ "description": "Successful Response"+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "Delete Persona",+ "tags": [+ "personas"+ ]+ },+ "get": {+ "operationId": "get_persona_api_personas__name__get",+ "parameters": [+ {+ "in": "path",+ "name": "name",+ "required": true,+ "schema": {+ "title": "Name",+ "type": "string"+ }+ },+ {+ "in": "header",+ "name": "Authorization",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"+ }+ },+ {+ "in": "cookie",+ "name": "dt_token",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"+ }+ }+ ],+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {+ "additionalProperties": true,+ "title": "Response Get Persona Api Personas Name Get",+ "type": "object"+ }+ }+ },+ "description": "Successful Response"+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "Get Persona",+ "tags": [+ "personas"+ ]+ },+ "put": {+ "operationId": "update_persona_api_personas__name__put",+ "parameters": [+ {+ "in": "path",+ "name": "name",+ "required": true,+ "schema": {+ "title": "Name",+ "type": "string"+ }+ },+ {+ "in": "header",+ "name": "Authorization",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"+ }+ },+ {+ "in": "cookie",+ "name": "dt_token",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"+ }+ }+ ],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/UpdatePersonaRequest"+ }+ }+ },+ "required": true+ },+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {+ "additionalProperties": true,+ "title": "Response Update Persona Api Personas Name Put",+ "type": "object"+ }+ }+ },+ "description": "Successful Response"+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "Update Persona",+ "tags": [+ "personas"+ ]+ }+ },+ "/api/question-notebook/categories": {+ "get": {+ "description": "Categories, with their counts scoped the same way the listing is.\n\nWithout the scope the rail would offer \"Address translation 3\" inside a\ncourse holding none of those three.",+ "operationId": "list_categories_api_question_notebook_categories_get",+ "parameters": [+ {+ "in": "query",+ "name": "course_id",+ "required": false,+ "schema": {+ "default": "",+ "title": "Course Id",+ "type": "string"+ }+ },+ {+ "in": "header",+ "name": "Authorization",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"+ }+ },+ {+ "in": "cookie",+ "name": "dt_token",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"+ }+ }+ ],+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {+ "items": {+ "$ref": "#/components/schemas/CategoryItem"+ },+ "title": "Response List Categories Api Question Notebook Categories Get",+ "type": "array"+ }+ }+ },+ "description": "Successful Response"+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "List Categories",+ "tags": [+ "question-notebook"+ ]+ },+ "post": {+ "operationId": "create_category_api_question_notebook_categories_post",+ "parameters": [+ {+ "in": "header",+ "name": "Authorization",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"+ }+ },+ {+ "in": "cookie",+ "name": "dt_token",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"+ }+ }+ ],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/CategoryCreateRequest"+ }+ }+ },+ "required": true+ },+ "responses": {+ "201": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/CategoryItem"+ }+ }+ },+ "description": "Successful Response"+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "Create Category",+ "tags": [+ "question-notebook"+ ]+ }+ },+ "/api/question-notebook/categories/{category_id}": {+ "delete": {+ "operationId": "delete_category_api_question_notebook_categories__category_id__delete",+ "parameters": [+ {+ "in": "path",+ "name": "category_id",+ "required": true,+ "schema": {+ "title": "Category Id",+ "type": "integer"}},{@@ -39039,15 +39971,757 @@"question-notebook"]},- "patch": {- "operationId": "rename_category_api_question_notebook_categories__category_id__patch",+ "patch": {+ "operationId": "rename_category_api_question_notebook_categories__category_id__patch",+ "parameters": [+ {+ "in": "path",+ "name": "category_id",+ "required": true,+ "schema": {+ "title": "Category Id",+ "type": "integer"+ }+ },+ {+ "in": "header",+ "name": "Authorization",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"+ }+ },+ {+ "in": "cookie",+ "name": "dt_token",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"+ }+ }+ ],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/CategoryRenameRequest"+ }+ }+ },+ "required": true+ },+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {}+ }+ },+ "description": "Successful Response"+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "Rename Category",+ "tags": [+ "question-notebook"+ ]+ }+ },+ "/api/question-notebook/entries": {+ "get": {+ "operationId": "list_entries_api_question_notebook_entries_get",+ "parameters": [+ {+ "in": "query",+ "name": "category_id",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "integer"+ },+ {+ "type": "null"+ }+ ],+ "title": "Category Id"+ }+ },+ {+ "in": "query",+ "name": "mistakes_only",+ "required": false,+ "schema": {+ "default": false,+ "title": "Mistakes Only",+ "type": "boolean"+ }+ },+ {+ "description": "Only entries filed under no category — the triage inbox. Ignored when category_id is set.",+ "in": "query",+ "name": "uncategorized",+ "required": false,+ "schema": {+ "default": false,+ "description": "Only entries filed under no category — the triage inbox. Ignored when category_id is set.",+ "title": "Uncategorized",+ "type": "boolean"+ }+ },+ {+ "in": "query",+ "name": "bookmarked",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "boolean"+ },+ {+ "type": "null"+ }+ ],+ "title": "Bookmarked"+ }+ },+ {+ "in": "query",+ "name": "is_correct",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "boolean"+ },+ {+ "type": "null"+ }+ ],+ "title": "Is Correct"+ }+ },+ {+ "in": "query",+ "name": "course_id",+ "required": false,+ "schema": {+ "default": "",+ "title": "Course Id",+ "type": "string"+ }+ },+ {+ "in": "query",+ "name": "source",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "enum": [+ "deep_question",+ "mastery_path",+ "immersive_reading",+ "book",+ "partner_chat",+ "import"+ ],+ "type": "string"+ },+ {+ "const": "",+ "type": "string"+ }+ ],+ "default": "",+ "title": "Source"+ }+ },+ {+ "in": "query",+ "name": "material_id",+ "required": false,+ "schema": {+ "default": "",+ "maxLength": 500,+ "title": "Material Id",+ "type": "string"+ }+ },+ {+ "in": "query",+ "name": "section_id",+ "required": false,+ "schema": {+ "default": "",+ "maxLength": 500,+ "title": "Section Id",+ "type": "string"+ }+ },+ {+ "in": "query",+ "name": "assessment_type",+ "required": false,+ "schema": {+ "default": "",+ "pattern": "^(quiz|focus_check|qualitative|review)?$",+ "title": "Assessment Type",+ "type": "string"+ }+ },+ {+ "in": "query",+ "name": "result",+ "required": false,+ "schema": {+ "default": "",+ "pattern": "^(correct|incorrect|partial|ungraded)?$",+ "title": "Result",+ "type": "string"+ }+ },+ {+ "in": "query",+ "name": "mastery_path_id",+ "required": false,+ "schema": {+ "default": "",+ "maxLength": 500,+ "title": "Mastery Path Id",+ "type": "string"+ }+ },+ {+ "in": "query",+ "name": "knowledge_point_id",+ "required": false,+ "schema": {+ "default": "",+ "maxLength": 500,+ "title": "Knowledge Point Id",+ "type": "string"+ }+ },+ {+ "in": "query",+ "name": "resolved",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "boolean"+ },+ {+ "type": "null"+ }+ ],+ "title": "Resolved"+ }+ },+ {+ "in": "query",+ "name": "score_trend",+ "required": false,+ "schema": {+ "default": "",+ "pattern": "^(new|improved|declined|unchanged)?$",+ "title": "Score Trend",+ "type": "string"+ }+ },+ {+ "in": "query",+ "name": "search",+ "required": false,+ "schema": {+ "default": "",+ "maxLength": 200,+ "title": "Search",+ "type": "string"+ }+ },+ {+ "in": "query",+ "name": "sort",+ "required": false,+ "schema": {+ "default": "recent",+ "pattern": "^(recent|oldest)$",+ "title": "Sort",+ "type": "string"+ }+ },+ {+ "in": "query",+ "name": "limit",+ "required": false,+ "schema": {+ "default": 50,+ "maximum": 200,+ "minimum": 1,+ "title": "Limit",+ "type": "integer"+ }+ },+ {+ "in": "query",+ "name": "offset",+ "required": false,+ "schema": {+ "default": 0,+ "minimum": 0,+ "title": "Offset",+ "type": "integer"+ }+ },+ {+ "in": "header",+ "name": "Authorization",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"+ }+ },+ {+ "in": "cookie",+ "name": "dt_token",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"+ }+ }+ ],+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/NotebookEntryListResponse"+ }+ }+ },+ "description": "Successful Response"+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "List Entries",+ "tags": [+ "question-notebook"+ ]+ }+ },+ "/api/question-notebook/entries/categories/bulk": {+ "post": {+ "operationId": "bulk_link_entries_api_question_notebook_entries_categories_bulk_post",+ "parameters": [+ {+ "in": "header",+ "name": "Authorization",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"+ }+ },+ {+ "in": "cookie",+ "name": "dt_token",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"+ }+ }+ ],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/BulkCategoryRequest"+ }+ }+ },+ "required": true+ },+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {}+ }+ },+ "description": "Successful Response"+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "Bulk Link Entries",+ "tags": [+ "question-notebook"+ ]+ }+ },+ "/api/question-notebook/entries/lookup/by-question": {+ "get": {+ "operationId": "lookup_entry_api_question_notebook_entries_lookup_by_question_get",+ "parameters": [+ {+ "in": "query",+ "name": "session_id",+ "required": false,+ "schema": {+ "default": "",+ "title": "Session Id",+ "type": "string"+ }+ },+ {+ "in": "query",+ "name": "origin_type",+ "required": false,+ "schema": {+ "default": "conversation",+ "enum": [+ "conversation",+ "external_import",+ "document_analysis"+ ],+ "title": "Origin Type",+ "type": "string"+ }+ },+ {+ "in": "query",+ "name": "origin_ref",+ "required": false,+ "schema": {+ "default": "",+ "title": "Origin Ref",+ "type": "string"+ }+ },+ {+ "in": "query",+ "name": "question_id",+ "required": true,+ "schema": {+ "title": "Question Id",+ "type": "string"+ }+ },+ {+ "in": "query",+ "name": "turn_id",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Turn Id"+ }+ },+ {+ "description": "Return 204 No Content instead of 404 when the entry is absent — used by the quiz viewer to probe not-yet-saved questions without logging noisy 404s.",+ "in": "query",+ "name": "missing_ok",+ "required": false,+ "schema": {+ "default": false,+ "description": "Return 204 No Content instead of 404 when the entry is absent — used by the quiz viewer to probe not-yet-saved questions without logging noisy 404s.",+ "title": "Missing Ok",+ "type": "boolean"+ }+ },+ {+ "in": "header",+ "name": "Authorization",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"+ }+ },+ {+ "in": "cookie",+ "name": "dt_token",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"+ }+ }+ ],+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {}+ }+ },+ "description": "Successful Response"+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "Lookup Entry",+ "tags": [+ "question-notebook"+ ]+ }+ },+ "/api/question-notebook/entries/upsert": {+ "post": {+ "operationId": "upsert_single_entry_api_question_notebook_entries_upsert_post",+ "parameters": [+ {+ "in": "header",+ "name": "Authorization",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"+ }+ },+ {+ "in": "cookie",+ "name": "dt_token",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"+ }+ }+ ],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/UpsertEntryRequest"+ }+ }+ },+ "required": true+ },+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {}+ }+ },+ "description": "Successful Response"+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "Upsert Single Entry",+ "tags": [+ "question-notebook"+ ]+ }+ },+ "/api/question-notebook/entries/{entry_id}": {+ "delete": {+ "operationId": "delete_entry_api_question_notebook_entries__entry_id__delete",+ "parameters": [+ {+ "in": "path",+ "name": "entry_id",+ "required": true,+ "schema": {+ "title": "Entry Id",+ "type": "integer"+ }+ },+ {+ "in": "header",+ "name": "Authorization",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"+ }+ },+ {+ "in": "cookie",+ "name": "dt_token",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"+ }+ }+ ],+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {}+ }+ },+ "description": "Successful Response"+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "Delete Entry",+ "tags": [+ "question-notebook"+ ]+ },+ "get": {+ "operationId": "get_entry_api_question_notebook_entries__entry_id__get","parameters": [{"in": "path",- "name": "category_id",+ "name": "entry_id","required": true,"schema": {- "title": "Category Id",+ "title": "Entry Id","type": "integer"}},@@ -39084,21 +40758,13 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/CategoryRenameRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "$ref": "#/components/schemas/NotebookEntryItem"+ }}},"description": "Successful Response"@@ -39114,257 +40780,193 @@"description": "Validation Error"}},- "summary": "Rename Category",+ "summary": "Get Entry","tags": ["question-notebook"]- }- },- "/api/question-notebook/entries": {- "get": {- "operationId": "list_entries_api_question_notebook_entries_get",+ },+ "patch": {+ "operationId": "update_entry_api_question_notebook_entries__entry_id__patch","parameters": [{- "in": "query",- "name": "category_id",- "required": false,- "schema": {- "anyOf": [- {- "type": "integer"- },- {- "type": "null"- }- ],- "title": "Category Id"- }- },- {- "in": "query",- "name": "mistakes_only",- "required": false,- "schema": {- "default": false,- "title": "Mistakes Only",- "type": "boolean"- }- },- {- "description": "Only entries filed under no category — the triage inbox. Ignored when category_id is set.",- "in": "query",- "name": "uncategorized",- "required": false,+ "in": "path",+ "name": "entry_id",+ "required": true,"schema": {- "default": false,- "description": "Only entries filed under no category — the triage inbox. Ignored when category_id is set.",- "title": "Uncategorized",- "type": "boolean"+ "title": "Entry Id",+ "type": "integer"}},{- "in": "query",- "name": "bookmarked",+ "in": "header",+ "name": "Authorization","required": false,"schema": {"anyOf": [{- "type": "boolean"+ "type": "string"},{"type": "null"}],- "title": "Bookmarked"+ "title": "Authorization"}},{- "in": "query",- "name": "is_correct",+ "in": "cookie",+ "name": "dt_token","required": false,"schema": {"anyOf": [{- "type": "boolean"+ "type": "string"},{"type": "null"}],- "title": "Is Correct"+ "title": "Dt Token"+ }+ }+ ],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/EntryUpdateRequest"+ }}},+ "required": true+ },+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {}+ }+ },+ "description": "Successful Response"+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "Update Entry",+ "tags": [+ "question-notebook"+ ]+ }+ },+ "/api/question-notebook/entries/{entry_id}/categories": {+ "post": {+ "operationId": "add_entry_to_category_api_question_notebook_entries__entry_id__categories_post",+ "parameters": [{- "in": "query",- "name": "course_id",- "required": false,+ "in": "path",+ "name": "entry_id",+ "required": true,"schema": {- "default": "",- "title": "Course Id",- "type": "string"+ "title": "Entry Id",+ "type": "integer"}},{- "in": "query",- "name": "source",+ "in": "header",+ "name": "Authorization","required": false,"schema": {"anyOf": [{- "enum": [- "deep_question",- "mastery_path",- "immersive_reading",- "book",- "partner_chat",- "import"- ],"type": "string"},{- "const": "",- "type": "string"+ "type": "null"}],- "default": "",- "title": "Source"- }- },- {- "in": "query",- "name": "material_id",- "required": false,- "schema": {- "default": "",- "maxLength": 500,- "title": "Material Id",- "type": "string"- }- },- {- "in": "query",- "name": "section_id",- "required": false,- "schema": {- "default": "",- "maxLength": 500,- "title": "Section Id",- "type": "string"- }- },- {- "in": "query",- "name": "assessment_type",- "required": false,- "schema": {- "default": "",- "pattern": "^(quiz|focus_check|qualitative|review)?$",- "title": "Assessment Type",- "type": "string"- }- },- {- "in": "query",- "name": "result",- "required": false,- "schema": {- "default": "",- "pattern": "^(correct|incorrect|partial|ungraded)?$",- "title": "Result",- "type": "string"- }- },- {- "in": "query",- "name": "mastery_path_id",- "required": false,- "schema": {- "default": "",- "maxLength": 500,- "title": "Mastery Path Id",- "type": "string"- }- },- {- "in": "query",- "name": "knowledge_point_id",- "required": false,- "schema": {- "default": "",- "maxLength": 500,- "title": "Knowledge Point Id",- "type": "string"+ "title": "Authorization"}},{- "in": "query",- "name": "resolved",+ "in": "cookie",+ "name": "dt_token","required": false,"schema": {"anyOf": [{- "type": "boolean"+ "type": "string"},{"type": "null"}],- "title": "Resolved"- }- },- {- "in": "query",- "name": "score_trend",- "required": false,- "schema": {- "default": "",- "pattern": "^(new|improved|declined|unchanged)?$",- "title": "Score Trend",- "type": "string"+ "title": "Dt Token"}- },- {- "in": "query",- "name": "search",- "required": false,- "schema": {- "default": "",- "maxLength": 200,- "title": "Search",- "type": "string"+ }+ ],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/CategoryAddRequest"+ }}},- {- "in": "query",- "name": "sort",- "required": false,- "schema": {- "default": "recent",- "pattern": "^(recent|oldest)$",- "title": "Sort",- "type": "string"- }+ "required": true+ },+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {}+ }+ },+ "description": "Successful Response"},+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "Add Entry To Category",+ "tags": [+ "question-notebook"+ ]+ }+ },+ "/api/question-notebook/entries/{entry_id}/categories/{category_id}": {+ "delete": {+ "operationId": "remove_entry_from_category_api_question_notebook_entries__entry_id__categories__category_id__delete",+ "parameters": [{- "in": "query",- "name": "limit",- "required": false,+ "in": "path",+ "name": "entry_id",+ "required": true,"schema": {- "default": 50,- "maximum": 200,- "minimum": 1,- "title": "Limit",+ "title": "Entry Id","type": "integer"}},{- "in": "query",- "name": "offset",- "required": false,+ "in": "path",+ "name": "category_id",+ "required": true,"schema": {- "default": 0,- "minimum": 0,- "title": "Offset",+ "title": "Category Id","type": "integer"}},@@ -39405,9 +41007,7 @@"200": {"content": {"application/json": {- "schema": {- "$ref": "#/components/schemas/NotebookEntryListResponse"- }+ "schema": {}}},"description": "Successful Response"@@ -39423,16 +41023,27 @@"description": "Validation Error"}},- "summary": "List Entries",+ "summary": "Remove Entry From Category","tags": ["question-notebook"]}},- "/api/question-notebook/entries/categories/bulk": {- "post": {- "operationId": "bulk_link_entries_api_question_notebook_entries_categories_bulk_post",+ "/api/question-notebook/materials": {+ "get": {+ "description": "Materials represented in the unified review history.",+ "operationId": "list_question_bank_materials_api_question_notebook_materials_get","parameters": [+ {+ "in": "query",+ "name": "course_id",+ "required": false,+ "schema": {+ "default": "",+ "title": "Course Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -39466,21 +41077,17 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/BulkCategoryRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "items": {+ "$ref": "#/components/schemas/QuestionBankMaterial"+ },+ "title": "Response List Question Bank Materials Api Question Notebook Materials Get",+ "type": "array"+ }}},"description": "Successful Response"@@ -39496,63 +41103,59 @@"description": "Validation Error"}},- "summary": "Bulk Link Entries",+ "summary": "List Question Bank Materials","tags": ["question-notebook"]}},- "/api/question-notebook/entries/lookup/by-question": {+ "/api/question-notebook/practice/analytics": {"get": {- "operationId": "lookup_entry_api_question_notebook_entries_lookup_by_question_get",+ "operationId": "practice_analytics_api_question_notebook_practice_analytics_get","parameters": [{"in": "query",- "name": "session_id",+ "name": "timezone","required": false,"schema": {- "default": "",- "title": "Session Id",+ "default": "UTC",+ "title": "Timezone","type": "string"}},{"in": "query",- "name": "origin_type",+ "name": "days","required": false,"schema": {- "default": "conversation",- "enum": [- "conversation",- "external_import",- "document_analysis"- ],- "title": "Origin Type",- "type": "string"+ "default": 30,+ "title": "Days",+ "type": "integer"}},{"in": "query",- "name": "origin_ref",+ "name": "course_id","required": false,"schema": {"default": "",- "title": "Origin Ref",+ "title": "Course Id","type": "string"}},{"in": "query",- "name": "question_id",- "required": true,+ "name": "all_workspaces",+ "required": false,"schema": {- "title": "Question Id",- "type": "string"+ "default": false,+ "title": "All Workspaces",+ "type": "boolean"}},{- "in": "query",- "name": "turn_id",+ "in": "header",+ "name": "Authorization","required": false,"schema": {"anyOf": [@@ -39563,21 +41166,58 @@"type": "null"}],- "title": "Turn Id"+ "title": "Authorization"}},{- "description": "Return 204 No Content instead of 404 when the entry is absent — used by the quiz viewer to probe not-yet-saved questions without logging noisy 404s.",- "in": "query",- "name": "missing_ok",+ "in": "cookie",+ "name": "dt_token","required": false,"schema": {- "default": false,- "description": "Return 204 No Content instead of 404 when the entry is absent — used by the quiz viewer to probe not-yet-saved questions without logging noisy 404s.",- "title": "Missing Ok",- "type": "boolean"+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"}+ }+ ],+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/PracticeAnalytics"+ }+ }+ },+ "description": "Successful Response"},+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "Practice Analytics",+ "tags": [+ "practice"+ ]+ }+ },+ "/api/question-notebook/practice/import/commit": {+ "post": {+ "operationId": "import_commit_api_question_notebook_practice_import_commit_post",+ "parameters": [{"in": "header","name": "Authorization",@@ -39611,6 +41251,16 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/CommitRequest"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -39631,15 +41281,15 @@"description": "Validation Error"}},- "summary": "Lookup Entry",+ "summary": "Import Commit","tags": [- "question-notebook"+ "practice"]}},- "/api/question-notebook/entries/upsert": {+ "/api/question-notebook/practice/import/preview": {"post": {- "operationId": "upsert_single_entry_api_question_notebook_entries_upsert_post",+ "operationId": "import_preview_api_question_notebook_practice_import_preview_post","parameters": [{"in": "header",@@ -39676,9 +41326,9 @@],"requestBody": {"content": {- "application/json": {+ "multipart/form-data": {"schema": {- "$ref": "#/components/schemas/UpsertEntryRequest"+ "$ref": "#/components/schemas/Body_import_preview_api_question_notebook_practice_import_preview_post"}}},@@ -39704,23 +41354,28 @@"description": "Validation Error"}},- "summary": "Upsert Single Entry",+ "summary": "Import Preview","tags": [- "question-notebook"+ "practice"]}},- "/api/question-notebook/entries/{entry_id}": {- "delete": {- "operationId": "delete_entry_api_question_notebook_entries__entry_id__delete",+ "/api/question-notebook/practice/import/template": {+ "get": {+ "operationId": "import_template_api_question_notebook_practice_import_template_get","parameters": [{- "in": "path",- "name": "entry_id",- "required": true,+ "in": "query",+ "name": "format",+ "required": false,"schema": {- "title": "Entry Id",- "type": "integer"+ "default": "csv",+ "enum": [+ "csv",+ "xlsx"+ ],+ "title": "Format",+ "type": "string"}},{@@ -39776,13 +41431,15 @@"description": "Validation Error"}},- "summary": "Delete Entry",+ "summary": "Import Template","tags": [- "question-notebook"+ "practice"]- },+ }+ },+ "/api/question-notebook/practice/questions/{entry_id}": {"get": {- "operationId": "get_entry_api_question_notebook_entries__entry_id__get",+ "operationId": "practice_question_api_question_notebook_practice_questions__entry_id__get","parameters": [{"in": "path",@@ -39831,7 +41488,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/NotebookEntryItem"+ "$ref": "#/components/schemas/PracticeQuestion"}}},@@ -39848,13 +41505,15 @@"description": "Validation Error"}},- "summary": "Get Entry",+ "summary": "Practice Question","tags": [- "question-notebook"+ "practice"]- },- "patch": {- "operationId": "update_entry_api_question_notebook_entries__entry_id__patch",+ }+ },+ "/api/question-notebook/practice/questions/{entry_id}/check": {+ "post": {+ "operationId": "check_api_question_notebook_practice_questions__entry_id__check_post","parameters": [{"in": "path",@@ -39902,7 +41561,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/EntryUpdateRequest"+ "$ref": "#/components/schemas/AnswerRequest"}}},@@ -39928,15 +41587,15 @@"description": "Validation Error"}},- "summary": "Update Entry",+ "summary": "Check","tags": [- "question-notebook"+ "practice"]}},- "/api/question-notebook/entries/{entry_id}/categories": {+ "/api/question-notebook/practice/questions/{entry_id}/review": {"post": {- "operationId": "add_entry_to_category_api_question_notebook_entries__entry_id__categories_post",+ "operationId": "review_api_question_notebook_practice_questions__entry_id__review_post","parameters": [{"in": "path",@@ -39984,7 +41643,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/CategoryAddRequest"+ "$ref": "#/components/schemas/ReviewRequest"}}},@@ -40010,106 +41669,72 @@"description": "Validation Error"}},- "summary": "Add Entry To Category",+ "summary": "Review","tags": [- "question-notebook"+ "practice"]}},- "/api/question-notebook/entries/{entry_id}/categories/{category_id}": {- "delete": {- "operationId": "remove_entry_from_category_api_question_notebook_entries__entry_id__categories__category_id__delete",+ "/api/question-notebook/practice/queue": {+ "get": {+ "operationId": "queue_api_question_notebook_practice_queue_get","parameters": [{- "in": "path",- "name": "entry_id",- "required": true,+ "in": "query",+ "name": "timezone",+ "required": false,"schema": {- "title": "Entry Id",- "type": "integer"+ "default": "UTC",+ "title": "Timezone",+ "type": "string"}},{- "in": "path",- "name": "category_id",- "required": true,+ "in": "query",+ "name": "course_id",+ "required": false,"schema": {- "title": "Category Id",- "type": "integer"+ "default": "",+ "title": "Course Id",+ "type": "string"}},{- "in": "header",- "name": "Authorization",+ "in": "query",+ "name": "category_id","required": false,"schema": {"anyOf": [{- "type": "string"+ "type": "integer"},{"type": "null"}],- "title": "Authorization"+ "title": "Category Id"}},{- "in": "cookie",- "name": "dt_token",+ "in": "query",+ "name": "limit","required": false,"schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Dt Token"+ "default": 20,+ "maximum": 100,+ "minimum": 1,+ "title": "Limit",+ "type": "integer"}- }- ],- "responses": {- "200": {- "content": {- "application/json": {- "schema": {}- }- },- "description": "Successful Response"},- "422": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- },- "description": "Validation Error"- }- },- "summary": "Remove Entry From Category",- "tags": [- "question-notebook"- ]- }- },- "/api/question-notebook/materials": {- "get": {- "description": "Materials represented in the unified review history.",- "operationId": "list_question_bank_materials_api_question_notebook_materials_get",- "parameters": [{"in": "query",- "name": "course_id",+ "name": "all_workspaces","required": false,"schema": {- "default": "",- "title": "Course Id",- "type": "string"+ "default": false,+ "title": "All Workspaces",+ "type": "boolean"}},{@@ -40151,9 +41776,9 @@"application/json": {"schema": {"items": {- "$ref": "#/components/schemas/QuestionBankMaterial"+ "$ref": "#/components/schemas/PracticeQuestion"},- "title": "Response List Question Bank Materials Api Question Notebook Materials Get",+ "title": "Response Queue Api Question Notebook Practice Queue Get","type": "array"}}@@ -40171,15 +41796,15 @@"description": "Validation Error"}},- "summary": "List Question Bank Materials",+ "summary": "Queue","tags": [- "question-notebook"+ "practice"]}},- "/api/question-notebook/practice/analytics": {+ "/api/question-notebook/practice/summary": {"get": {- "operationId": "practice_analytics_api_question_notebook_practice_analytics_get",+ "operationId": "summary_api_question_notebook_practice_summary_get","parameters": [{"in": "query",@@ -40191,16 +41816,6 @@"type": "string"}},- {- "in": "query",- "name": "days",- "required": false,- "schema": {- "default": 30,- "title": "Days",- "type": "integer"- }- },{"in": "query","name": "course_id",@@ -40259,7 +41874,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/PracticeAnalytics"+ "$ref": "#/components/schemas/PracticeSummary"}}},@@ -40276,16 +41891,27 @@"description": "Validation Error"}},- "summary": "Practice Analytics",+ "summary": "Summary","tags": ["practice"]}},- "/api/question-notebook/practice/import/commit": {- "post": {- "operationId": "import_commit_api_question_notebook_practice_import_commit_post",+ "/api/question-notebook/stats": {+ "get": {+ "description": "Counts behind the filter chips; also the agent's one-call overview.\n\nTakes the same course scope as the listing: showing one course's questions\nnext to whole-library counts would make the rail lie about how much is there.",+ "operationId": "question_bank_stats_api_question_notebook_stats_get","parameters": [+ {+ "in": "query",+ "name": "course_id",+ "required": false,+ "schema": {+ "default": "",+ "title": "Course Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -40319,21 +41945,13 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/CommitRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "$ref": "#/components/schemas/QuestionBankStats"+ }}},"description": "Successful Response"@@ -40349,15 +41967,15 @@"description": "Validation Error"}},- "summary": "Import Commit",+ "summary": "Question Bank Stats","tags": [- "practice"+ "question-notebook"]}},- "/api/question-notebook/practice/import/preview": {- "post": {- "operationId": "import_preview_api_question_notebook_practice_import_preview_post",+ "/api/reading/epub-pairings": {+ "get": {+ "operationId": "epub_pairings_api_reading_epub_pairings_get","parameters": [{"in": "header",@@ -40392,21 +42010,18 @@}}],- "requestBody": {- "content": {- "multipart/form-data": {- "schema": {- "$ref": "#/components/schemas/Body_import_preview_api_question_notebook_practice_import_preview_post"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "items": {+ "additionalProperties": true,+ "type": "object"+ },+ "title": "Response Epub Pairings Api Reading Epub Pairings Get",+ "type": "array"+ }}},"description": "Successful Response"@@ -40422,30 +42037,14 @@"description": "Validation Error"}},- "summary": "Import Preview",+ "summary": "Epub Pairings","tags": [- "practice"+ "reading"]- }- },- "/api/question-notebook/practice/import/template": {- "get": {- "operationId": "import_template_api_question_notebook_practice_import_template_get",+ },+ "post": {+ "operationId": "create_epub_pairing_api_reading_epub_pairings_post","parameters": [- {- "in": "query",- "name": "format",- "required": false,- "schema": {- "default": "csv",- "enum": [- "csv",- "xlsx"- ],- "title": "Format",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -40479,11 +42078,25 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/EpubPairingRequest"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": true,+ "title": "Response Create Epub Pairing Api Reading Epub Pairings Post",+ "type": "object"+ }}},"description": "Successful Response"@@ -40499,23 +42112,23 @@"description": "Validation Error"}},- "summary": "Import Template",+ "summary": "Create Epub Pairing","tags": [- "practice"+ "reading"]}},- "/api/question-notebook/practice/questions/{entry_id}": {- "get": {- "operationId": "practice_question_api_question_notebook_practice_questions__entry_id__get",+ "/api/reading/epub-pairings/{pairing_id}": {+ "delete": {+ "operationId": "remove_epub_pairing_api_reading_epub_pairings__pairing_id__delete","parameters": [{"in": "path",- "name": "entry_id",+ "name": "pairing_id","required": true,"schema": {- "title": "Entry Id",- "type": "integer"+ "title": "Pairing Id",+ "type": "string"}},{@@ -40556,7 +42169,9 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/PracticeQuestion"+ "additionalProperties": true,+ "title": "Response Remove Epub Pairing Api Reading Epub Pairings Pairing Id Delete",+ "type": "object"}}},@@ -40573,25 +42188,16 @@"description": "Validation Error"}},- "summary": "Practice Question",+ "summary": "Remove Epub Pairing","tags": [- "practice"+ "reading"]}},- "/api/question-notebook/practice/questions/{entry_id}/check": {- "post": {- "operationId": "check_api_question_notebook_practice_questions__entry_id__check_post",+ "/api/reading/extensions": {+ "get": {+ "operationId": "list_extensions_api_reading_extensions_get","parameters": [- {- "in": "path",- "name": "entry_id",- "required": true,- "schema": {- "title": "Entry Id",- "type": "integer"- }- },{"in": "header","name": "Authorization",@@ -40625,21 +42231,18 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/AnswerRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "items": {+ "additionalProperties": true,+ "type": "object"+ },+ "title": "Response List Extensions Api Reading Extensions Get",+ "type": "array"+ }}},"description": "Successful Response"@@ -40655,25 +42258,17 @@"description": "Validation Error"}},- "summary": "Check",+ "summary": "List Extensions","tags": [- "practice"+ "reading-extensions"]}},- "/api/question-notebook/practice/questions/{entry_id}/review": {+ "/api/reading/library/duplicate-check": {"post": {- "operationId": "review_api_question_notebook_practice_questions__entry_id__review_post",+ "description": "Say what the library already holds, before anything is uploaded.\n\nIdentical bytes are answered from the content id the browser computed;\na same-name-different-content upload is the genuinely ambiguous case and\nis reported separately so the client can ask instead of guessing.",+ "operationId": "duplicate_check_api_reading_library_duplicate_check_post","parameters": [- {- "in": "path",- "name": "entry_id",- "required": true,- "schema": {- "title": "Entry Id",- "type": "integer"- }- },{"in": "header","name": "Authorization",@@ -40711,7 +42306,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/ReviewRequest"+ "$ref": "#/components/schemas/DuplicateCheckRequest"}}},@@ -40721,7 +42316,11 @@"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": true,+ "title": "Response Duplicate Check Api Reading Library Duplicate Check Post",+ "type": "object"+ }}},"description": "Successful Response"@@ -40737,74 +42336,17 @@"description": "Validation Error"}},- "summary": "Review",+ "summary": "Duplicate Check","tags": [- "practice"+ "reading"]}},- "/api/question-notebook/practice/queue": {- "get": {- "operationId": "queue_api_question_notebook_practice_queue_get",+ "/api/reading/library/import-urls": {+ "post": {+ "description": "Queue safe webpage, YouTube, or Bilibili imports into a workspace.",+ "operationId": "import_urls_api_reading_library_import_urls_post","parameters": [- {- "in": "query",- "name": "timezone",- "required": false,- "schema": {- "default": "UTC",- "title": "Timezone",- "type": "string"- }- },- {- "in": "query",- "name": "course_id",- "required": false,- "schema": {- "default": "",- "title": "Course Id",- "type": "string"- }- },- {- "in": "query",- "name": "category_id",- "required": false,- "schema": {- "anyOf": [- {- "type": "integer"- },- {- "type": "null"- }- ],- "title": "Category Id"- }- },- {- "in": "query",- "name": "limit",- "required": false,- "schema": {- "default": 20,- "maximum": 100,- "minimum": 1,- "title": "Limit",- "type": "integer"- }- },- {- "in": "query",- "name": "all_workspaces",- "required": false,- "schema": {- "default": false,- "title": "All Workspaces",- "type": "boolean"- }- },{"in": "header","name": "Authorization",@@ -40838,16 +42380,24 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/UrlImportRequest"+ }+ }+ },+ "required": true+ },"responses": {- "200": {+ "202": {"content": {"application/json": {"schema": {- "items": {- "$ref": "#/components/schemas/PracticeQuestion"- },- "title": "Response Queue Api Question Notebook Practice Queue Get",- "type": "array"+ "additionalProperties": true,+ "title": "Response Import Urls Api Reading Library Import Urls Post",+ "type": "object"}}},@@ -40864,46 +42414,17 @@"description": "Validation Error"}},- "summary": "Queue",+ "summary": "Import Urls","tags": [- "practice"+ "reading"]}},- "/api/question-notebook/practice/summary": {- "get": {- "operationId": "summary_api_question_notebook_practice_summary_get",+ "/api/reading/library/import-zim-article": {+ "post": {+ "description": "Open one selected Kiwix article in Immersive Reading.\n\nOnly its bounded text snapshot enters the reading store. The ZIM archive\nstays on the existing kiwix-serve instance, without bulk extraction.",+ "operationId": "import_zim_article_api_reading_library_import_zim_article_post","parameters": [- {- "in": "query",- "name": "timezone",- "required": false,- "schema": {- "default": "UTC",- "title": "Timezone",- "type": "string"- }- },- {- "in": "query",- "name": "course_id",- "required": false,- "schema": {- "default": "",- "title": "Course Id",- "type": "string"- }- },- {- "in": "query",- "name": "all_workspaces",- "required": false,- "schema": {- "default": false,- "title": "All Workspaces",- "type": "boolean"- }- },{"in": "header","name": "Authorization",@@ -40937,12 +42458,24 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/ZimArticleImportRequest"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/PracticeSummary"+ "additionalProperties": true,+ "title": "Response Import Zim Article Api Reading Library Import Zim Article Post",+ "type": "object"}}},@@ -40959,24 +42492,63 @@"description": "Validation Error"}},- "summary": "Summary",+ "summary": "Import Zim Article","tags": [- "practice"+ "reading"]}},- "/api/question-notebook/stats": {+ "/api/reading/library/materials": {"get": {- "description": "Counts behind the filter chips; also the agent's one-call overview.\n\nTakes the same course scope as the listing: showing one course's questions\nnext to whole-library counts would make the rail lie about how much is there.",- "operationId": "question_bank_stats_api_question_notebook_stats_get",+ "description": "Every material the owner has, with the collections holding each one.\n\nMembership travels with the row because the library view exists to answer\n\"where is this used, and what did I upload that is used nowhere\" — a\nquestion the client cannot ask one material at a time.",+ "operationId": "list_library_materials_api_reading_library_materials_get","parameters": [{"in": "query",- "name": "course_id",+ "name": "search","required": false,"schema": {"default": "",- "title": "Course Id",+ "maxLength": 200,+ "title": "Search",+ "type": "string"+ }+ },+ {+ "in": "query",+ "name": "status",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "enum": [+ "queued",+ "processing",+ "ready",+ "failed"+ ],+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Status"+ }+ },+ {+ "in": "query",+ "name": "filter",+ "required": false,+ "schema": {+ "default": "all",+ "enum": [+ "all",+ "unassigned",+ "processing",+ "failed"+ ],+ "title": "Filter","type": "string"}},@@ -41018,7 +42590,9 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/QuestionBankStats"+ "additionalProperties": true,+ "title": "Response List Library Materials Api Reading Library Materials Get",+ "type": "object"}}},@@ -41035,15 +42609,15 @@"description": "Validation Error"}},- "summary": "Question Bank Stats",+ "summary": "List Library Materials","tags": [- "question-notebook"+ "reading"]}},- "/api/reading/epub-pairings": {+ "/api/reading/materials": {"get": {- "operationId": "epub_pairings_api_reading_epub_pairings_get",+ "operationId": "list_materials_api_reading_materials_get","parameters": [{"in": "header",@@ -41084,10 +42658,9 @@"application/json": {"schema": {"items": {- "additionalProperties": true,- "type": "object"+ "$ref": "#/components/schemas/MaterialInfo"},- "title": "Response Epub Pairings Api Reading Epub Pairings Get",+ "title": "Response List Materials Api Reading Materials Get","type": "array"}}@@ -41105,14 +42678,25 @@"description": "Validation Error"}},- "summary": "Epub Pairings",+ "summary": "List Materials","tags": ["reading"]},"post": {- "operationId": "create_epub_pairing_api_reading_epub_pairings_post",+ "description": "Ingest an uploaded document and return it ready to read.\n\nThe upload is streamed to a temp file with a running size check, so an\noversized file is rejected before it is fully buffered rather than after.\n\nAudio and video answer as soon as the file is stored and transcription is\nqueued, the same shape as a URL import. Holding the request open for the\nlength of a lecture meant no progress could reach the client, the browser\nor a proxy could time the upload out after the transcription had already\nbeen paid for, and nothing was left on disk to retry from.",+ "operationId": "upload_material_api_reading_materials_post","parameters": [+ {+ "in": "query",+ "name": "reuse",+ "required": false,+ "schema": {+ "default": true,+ "title": "Reuse",+ "type": "boolean"+ }+ },{"in": "header","name": "Authorization",@@ -41148,9 +42732,9 @@],"requestBody": {"content": {- "application/json": {+ "multipart/form-data": {"schema": {- "$ref": "#/components/schemas/EpubPairingRequest"+ "$ref": "#/components/schemas/Body_upload_material_api_reading_materials_post"}}},@@ -41161,9 +42745,7 @@"content": {"application/json": {"schema": {- "additionalProperties": true,- "title": "Response Create Epub Pairing Api Reading Epub Pairings Post",- "type": "object"+ "$ref": "#/components/schemas/MaterialDetail"}}},@@ -41180,22 +42762,22 @@"description": "Validation Error"}},- "summary": "Create Epub Pairing",+ "summary": "Upload Material","tags": ["reading"]}},- "/api/reading/epub-pairings/{pairing_id}": {+ "/api/reading/materials/{material_id}": {"delete": {- "operationId": "remove_epub_pairing_api_reading_epub_pairings__pairing_id__delete",+ "operationId": "delete_material_api_reading_materials__material_id__delete","parameters": [{"in": "path",- "name": "pairing_id",+ "name": "material_id","required": true,"schema": {- "title": "Pairing Id",+ "title": "Material Id","type": "string"}},@@ -41238,7 +42820,7 @@"application/json": {"schema": {"additionalProperties": true,- "title": "Response Remove Epub Pairing Api Reading Epub Pairings Pairing Id Delete",+ "title": "Response Delete Material Api Reading Materials Material Id Delete","type": "object"}}@@ -41256,87 +42838,23 @@"description": "Validation Error"}},- "summary": "Remove Epub Pairing",+ "summary": "Delete Material","tags": ["reading"]- }- },- "/api/reading/extensions": {+ },"get": {- "operationId": "list_extensions_api_reading_extensions_get",+ "operationId": "get_material_api_reading_materials__material_id__get","parameters": [{- "in": "header",- "name": "Authorization",- "required": false,- "schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Authorization"- }- },- {- "in": "cookie",- "name": "dt_token",- "required": false,+ "in": "path",+ "name": "material_id",+ "required": true,"schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Dt Token"+ "title": "Material Id",+ "type": "string"}- }- ],- "responses": {- "200": {- "content": {- "application/json": {- "schema": {- "items": {- "additionalProperties": true,- "type": "object"- },- "title": "Response List Extensions Api Reading Extensions Get",- "type": "array"- }- }- },- "description": "Successful Response"},- "422": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- },- "description": "Validation Error"- }- },- "summary": "List Extensions",- "tags": [- "reading-extensions"- ]- }- },- "/api/reading/library/duplicate-check": {- "post": {- "description": "Say what the library already holds, before anything is uploaded.\n\nIdentical bytes are answered from the content id the browser computed;\na same-name-different-content upload is the genuinely ambiguous case and\nis reported separately so the client can ask instead of guessing.",- "operationId": "duplicate_check_api_reading_library_duplicate_check_post",- "parameters": [{"in": "header","name": "Authorization",@@ -41370,24 +42888,12 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/DuplicateCheckRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {"schema": {- "additionalProperties": true,- "title": "Response Duplicate Check Api Reading Library Duplicate Check Post",- "type": "object"+ "$ref": "#/components/schemas/MaterialDetail"}}},@@ -41404,17 +42910,25 @@"description": "Validation Error"}},- "summary": "Duplicate Check",+ "summary": "Get Material","tags": ["reading"]}},- "/api/reading/library/import-urls": {- "post": {- "description": "Queue safe webpage, YouTube, or Bilibili imports into a workspace.",- "operationId": "import_urls_api_reading_library_import_urls_post",+ "/api/reading/materials/{material_id}/annotations": {+ "get": {+ "operationId": "list_annotations_api_reading_materials__material_id__annotations_get","parameters": [+ {+ "in": "path",+ "name": "material_id",+ "required": true,+ "schema": {+ "title": "Material Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -41448,24 +42962,16 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/UrlImportRequest"- }- }- },- "required": true- },"responses": {- "202": {+ "200": {"content": {"application/json": {"schema": {- "additionalProperties": true,- "title": "Response Import Urls Api Reading Library Import Urls Post",- "type": "object"+ "items": {+ "$ref": "#/components/schemas/AnnotationInfo"+ },+ "title": "Response List Annotations Api Reading Materials Material Id Annotations Get",+ "type": "array"}}},@@ -41482,63 +42988,21 @@"description": "Validation Error"}},- "summary": "Import Urls",+ "summary": "List Annotations","tags": ["reading"]- }- },- "/api/reading/library/materials": {- "get": {- "description": "Every material the owner has, with the collections holding each one.\n\nMembership travels with the row because the library view exists to answer\n\"where is this used, and what did I upload that is used nowhere\" — a\nquestion the client cannot ask one material at a time.",- "operationId": "list_library_materials_api_reading_library_materials_get",+ },+ "put": {+ "description": "Create or update one annotation (id absent = create).",+ "operationId": "save_annotation_api_reading_materials__material_id__annotations_put","parameters": [{- "in": "query",- "name": "search",- "required": false,- "schema": {- "default": "",- "maxLength": 200,- "title": "Search",- "type": "string"- }- },- {- "in": "query",- "name": "status",- "required": false,- "schema": {- "anyOf": [- {- "enum": [- "queued",- "processing",- "ready",- "failed"- ],- "type": "string"- },- {- "type": "null"- }- ],- "title": "Status"- }- },- {- "in": "query",- "name": "filter",- "required": false,+ "in": "path",+ "name": "material_id",+ "required": true,"schema": {- "default": "all",- "enum": [- "all",- "unassigned",- "processing",- "failed"- ],- "title": "Filter",+ "title": "Material Id","type": "string"}},@@ -41575,14 +43039,22 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/AnnotationPayload"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {"application/json": {"schema": {- "additionalProperties": true,- "title": "Response List Library Materials Api Reading Library Materials Get",- "type": "object"+ "$ref": "#/components/schemas/AnnotationInfo"}}},@@ -41599,92 +43071,32 @@"description": "Validation Error"}},- "summary": "List Library Materials",+ "summary": "Save Annotation","tags": ["reading"]}},- "/api/reading/materials": {- "get": {- "operationId": "list_materials_api_reading_materials_get",+ "/api/reading/materials/{material_id}/annotations/{annotation_id}": {+ "delete": {+ "operationId": "delete_annotation_api_reading_materials__material_id__annotations__annotation_id__delete","parameters": [{- "in": "header",- "name": "Authorization",- "required": false,- "schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Authorization"- }- },- {- "in": "cookie",- "name": "dt_token",- "required": false,+ "in": "path",+ "name": "material_id",+ "required": true,"schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Dt Token"+ "title": "Material Id",+ "type": "string"}- }- ],- "responses": {- "200": {- "content": {- "application/json": {- "schema": {- "items": {- "$ref": "#/components/schemas/MaterialInfo"- },- "title": "Response List Materials Api Reading Materials Get",- "type": "array"- }- }- },- "description": "Successful Response"},- "422": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- },- "description": "Validation Error"- }- },- "summary": "List Materials",- "tags": [- "reading"- ]- },- "post": {- "description": "Ingest an uploaded document and return it ready to read.\n\nThe upload is streamed to a temp file with a running size check, so an\noversized file is rejected before it is fully buffered rather than after.\n\nAudio and video answer as soon as the file is stored and transcription is\nqueued, the same shape as a URL import. Holding the request open for the\nlength of a lecture meant no progress could reach the client, the browser\nor a proxy could time the upload out after the transcription had already\nbeen paid for, and nothing was left on disk to retry from.",- "operationId": "upload_material_api_reading_materials_post",- "parameters": [{- "in": "query",- "name": "reuse",- "required": false,+ "in": "path",+ "name": "annotation_id",+ "required": true,"schema": {- "default": true,- "title": "Reuse",- "type": "boolean"+ "title": "Annotation Id",+ "type": "string"}},{@@ -41720,22 +43132,14 @@}}],- "requestBody": {- "content": {- "multipart/form-data": {- "schema": {- "$ref": "#/components/schemas/Body_upload_material_api_reading_materials_post"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/MaterialDetail"+ "additionalProperties": true,+ "title": "Response Delete Annotation Api Reading Materials Material Id Annotations Annotation Id Delete",+ "type": "object"}}},@@ -41752,15 +43156,16 @@"description": "Validation Error"}},- "summary": "Upload Material",+ "summary": "Delete Annotation","tags": ["reading"]}},- "/api/reading/materials/{material_id}": {- "delete": {- "operationId": "delete_material_api_reading_materials__material_id__delete",+ "/api/reading/materials/{material_id}/assets/{asset_name}": {+ "get": {+ "description": "Serve one authenticated, MIME-sniffed image captured with a web page.",+ "operationId": "get_snapshot_asset_api_reading_materials__material_id__assets__asset_name__get","parameters": [{"in": "path",@@ -41771,6 +43176,15 @@"type": "string"}},+ {+ "in": "path",+ "name": "asset_name",+ "required": true,+ "schema": {+ "title": "Asset Name",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -41808,11 +43222,7 @@"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Delete Material Api Reading Materials Material Id Delete",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -41828,13 +43238,16 @@"description": "Validation Error"}},- "summary": "Delete Material",+ "summary": "Get Snapshot Asset","tags": ["reading"]- },+ }+ },+ "/api/reading/materials/{material_id}/bookmarks": {"get": {- "operationId": "get_material_api_reading_materials__material_id__get",+ "description": "Every place the reader has kept in this material, in reading order.",+ "operationId": "list_bookmarks_api_reading_materials__material_id__bookmarks_get","parameters": [{"in": "path",@@ -41883,7 +43296,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/MaterialDetail"+ "$ref": "#/components/schemas/BookmarkList"}}},@@ -41900,15 +43313,14 @@"description": "Validation Error"}},- "summary": "Get Material",+ "summary": "List Bookmarks","tags": ["reading"]- }- },- "/api/reading/materials/{material_id}/annotations": {- "get": {- "operationId": "list_annotations_api_reading_materials__material_id__annotations_get",+ },+ "post": {+ "description": "Keep one place. Bookmarking an already-kept locator returns that one.",+ "operationId": "add_bookmark_api_reading_materials__material_id__bookmarks_post","parameters": [{"in": "path",@@ -41952,16 +43364,22 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/BookmarkPayload"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {"application/json": {"schema": {- "items": {- "$ref": "#/components/schemas/AnnotationInfo"- },- "title": "Response List Annotations Api Reading Materials Material Id Annotations Get",- "type": "array"+ "$ref": "#/components/schemas/BookmarkInfo"}}},@@ -41978,14 +43396,15 @@"description": "Validation Error"}},- "summary": "List Annotations",+ "summary": "Add Bookmark","tags": ["reading"]- },- "put": {- "description": "Create or update one annotation (id absent = create).",- "operationId": "save_annotation_api_reading_materials__material_id__annotations_put",+ }+ },+ "/api/reading/materials/{material_id}/bookmarks/{bookmark_id}": {+ "delete": {+ "operationId": "delete_bookmark_api_reading_materials__material_id__bookmarks__bookmark_id__delete","parameters": [{"in": "path",@@ -41996,6 +43415,15 @@"type": "string"}},+ {+ "in": "path",+ "name": "bookmark_id",+ "required": true,+ "schema": {+ "title": "Bookmark Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -42029,22 +43457,16 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/AnnotationPayload"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/AnnotationInfo"+ "additionalProperties": {+ "type": "boolean"+ },+ "title": "Response Delete Bookmark Api Reading Materials Material Id Bookmarks Bookmark Id Delete",+ "type": "object"}}},@@ -42061,15 +43483,15 @@"description": "Validation Error"}},- "summary": "Save Annotation",+ "summary": "Delete Bookmark","tags": ["reading"]}},- "/api/reading/materials/{material_id}/annotations/{annotation_id}": {- "delete": {- "operationId": "delete_annotation_api_reading_materials__material_id__annotations__annotation_id__delete",+ "/api/reading/materials/{material_id}/epub-pairing-candidates": {+ "get": {+ "operationId": "epub_pairing_candidates_api_reading_materials__material_id__epub_pairing_candidates_get","parameters": [{"in": "path",@@ -42080,15 +43502,6 @@"type": "string"}},- {- "in": "path",- "name": "annotation_id",- "required": true,- "schema": {- "title": "Annotation Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -42127,9 +43540,12 @@"content": {"application/json": {"schema": {- "additionalProperties": true,- "title": "Response Delete Annotation Api Reading Materials Material Id Annotations Annotation Id Delete",- "type": "object"+ "items": {+ "additionalProperties": true,+ "type": "object"+ },+ "title": "Response Epub Pairing Candidates Api Reading Materials Material Id Epub Pairing Candidates Get",+ "type": "array"}}},@@ -42146,16 +43562,16 @@"description": "Validation Error"}},- "summary": "Delete Annotation",+ "summary": "Epub Pairing Candidates","tags": ["reading"]}},- "/api/reading/materials/{material_id}/assets/{asset_name}": {+ "/api/reading/materials/{material_id}/export": {"get": {- "description": "Serve one authenticated, MIME-sniffed image captured with a web page.",- "operationId": "get_snapshot_asset_api_reading_materials__material_id__assets__asset_name__get",+ "description": "Download the material with its annotations applied.\n\n``pdf`` writes real PDF annotations into a copy of the original, so the\nexport keeps working outside DeepTutor; ``markdown`` returns the marks as\ntext, which is what every non-PDF format gets.",+ "operationId": "export_api_reading_materials__material_id__export_get","parameters": [{"in": "path",@@ -42167,11 +43583,17 @@}},{- "in": "path",- "name": "asset_name",- "required": true,+ "in": "query",+ "name": "fmt",+ "required": false,"schema": {- "title": "Asset Name",+ "default": "auto",+ "enum": [+ "auto",+ "pdf",+ "markdown"+ ],+ "title": "Fmt","type": "string"}},@@ -42228,16 +43650,15 @@"description": "Validation Error"}},- "summary": "Get Snapshot Asset",+ "summary": "Export","tags": ["reading"]}},- "/api/reading/materials/{material_id}/bookmarks": {- "get": {- "description": "Every place the reader has kept in this material, in reading order.",- "operationId": "list_bookmarks_api_reading_materials__material_id__bookmarks_get",+ "/api/reading/materials/{material_id}/extensions/quiz/answers": {+ "post": {+ "operationId": "submit_quiz_answers_api_reading_materials__material_id__extensions_quiz_answers_post","parameters": [{"in": "path",@@ -42281,12 +43702,24 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/QuizAnswersPayload"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/BookmarkList"+ "additionalProperties": true,+ "title": "Response Submit Quiz Answers Api Reading Materials Material Id Extensions Quiz Answers Post",+ "type": "object"}}},@@ -42303,14 +43736,15 @@"description": "Validation Error"}},- "summary": "List Bookmarks",+ "summary": "Submit Quiz Answers","tags": [- "reading"+ "reading-extensions"]- },+ }+ },+ "/api/reading/materials/{material_id}/extensions/{extension_id}/actions/{action}": {"post": {- "description": "Keep one place. Bookmarking an already-kept locator returns that one.",- "operationId": "add_bookmark_api_reading_materials__material_id__bookmarks_post",+ "operationId": "run_extension_action_api_reading_materials__material_id__extensions__extension_id__actions__action__post","parameters": [{"in": "path",@@ -42321,6 +43755,24 @@"type": "string"}},+ {+ "in": "path",+ "name": "extension_id",+ "required": true,+ "schema": {+ "title": "Extension Id",+ "type": "string"+ }+ },+ {+ "in": "path",+ "name": "action",+ "required": true,+ "schema": {+ "title": "Action",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -42358,7 +43810,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/BookmarkPayload"+ "$ref": "#/components/schemas/ActionPayload"}}},@@ -42369,7 +43821,9 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/BookmarkInfo"+ "additionalProperties": true,+ "title": "Response Run Extension Action Api Reading Materials Material Id Extensions Extension Id Actions Action Post",+ "type": "object"}}},@@ -42386,15 +43840,16 @@"description": "Validation Error"}},- "summary": "Add Bookmark",+ "summary": "Run Extension Action","tags": [- "reading"+ "reading-extensions"]}},- "/api/reading/materials/{material_id}/bookmarks/{bookmark_id}": {- "delete": {- "operationId": "delete_bookmark_api_reading_materials__material_id__bookmarks__bookmark_id__delete",+ "/api/reading/materials/{material_id}/media": {+ "get": {+ "description": "The embedded-image index (name / locator / mime / size), empty if none.",+ "operationId": "list_material_media_api_reading_materials__material_id__media_get","parameters": [{"in": "path",@@ -42405,15 +43860,6 @@"type": "string"}},- {- "in": "path",- "name": "bookmark_id",- "required": true,- "schema": {- "title": "Bookmark Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -42452,11 +43898,12 @@"content": {"application/json": {"schema": {- "additionalProperties": {- "type": "boolean"+ "items": {+ "additionalProperties": true,+ "type": "object"},- "title": "Response Delete Bookmark Api Reading Materials Material Id Bookmarks Bookmark Id Delete",- "type": "object"+ "title": "Response List Material Media Api Reading Materials Material Id Media Get",+ "type": "array"}}},@@ -42473,15 +43920,16 @@"description": "Validation Error"}},- "summary": "Delete Bookmark",+ "summary": "List Material Media","tags": ["reading"]}},- "/api/reading/materials/{material_id}/epub-pairing-candidates": {+ "/api/reading/materials/{material_id}/media/{name}": {"get": {- "operationId": "epub_pairing_candidates_api_reading_materials__material_id__epub_pairing_candidates_get",+ "description": "One embedded image's bytes, for the reader pane's media strip.",+ "operationId": "get_material_media_api_reading_materials__material_id__media__name__get","parameters": [{"in": "path",@@ -42492,6 +43940,15 @@"type": "string"}},+ {+ "in": "path",+ "name": "name",+ "required": true,+ "schema": {+ "title": "Name",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -42529,14 +43986,7 @@"200": {"content": {"application/json": {- "schema": {- "items": {- "additionalProperties": true,- "type": "object"- },- "title": "Response Epub Pairing Candidates Api Reading Materials Material Id Epub Pairing Candidates Get",- "type": "array"- }+ "schema": {}}},"description": "Successful Response"@@ -42552,16 +44002,16 @@"description": "Validation Error"}},- "summary": "Epub Pairing Candidates",+ "summary": "Get Material Media","tags": ["reading"]}},- "/api/reading/materials/{material_id}/export": {+ "/api/reading/materials/{material_id}/position": {"get": {- "description": "Download the material with its annotations applied.\n\n``pdf`` writes real PDF annotations into a copy of the original, so the\nexport keeps working outside DeepTutor; ``markdown`` returns the marks as\ntext, which is what every non-PDF format gets.",- "operationId": "export_api_reading_materials__material_id__export_get",+ "description": "Return the user's last durable viewport for this material.",+ "operationId": "get_position_api_reading_materials__material_id__position_get","parameters": [{"in": "path",@@ -42572,21 +44022,6 @@"type": "string"}},- {- "in": "query",- "name": "fmt",- "required": false,- "schema": {- "default": "auto",- "enum": [- "auto",- "pdf",- "markdown"- ],- "title": "Fmt",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -42624,7 +44059,9 @@"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "$ref": "#/components/schemas/PositionInfo"+ }}},"description": "Successful Response"@@ -42640,15 +44077,14 @@"description": "Validation Error"}},- "summary": "Export",+ "summary": "Get Position","tags": ["reading"]- }- },- "/api/reading/materials/{material_id}/extensions/quiz/answers": {- "post": {- "operationId": "submit_quiz_answers_api_reading_materials__material_id__extensions_quiz_answers_post",+ },+ "put": {+ "description": "Persist a validated numeric locator plus an optional renderer anchor.",+ "operationId": "save_position_api_reading_materials__material_id__position_put","parameters": [{"in": "path",@@ -42696,7 +44132,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/QuizAnswersPayload"+ "$ref": "#/components/schemas/PositionPayload"}}},@@ -42707,9 +44143,7 @@"content": {"application/json": {"schema": {- "additionalProperties": true,- "title": "Response Submit Quiz Answers Api Reading Materials Material Id Extensions Quiz Answers Post",- "type": "object"+ "$ref": "#/components/schemas/PositionInfo"}}},@@ -42726,15 +44160,15 @@"description": "Validation Error"}},- "summary": "Submit Quiz Answers",+ "summary": "Save Position","tags": [- "reading-extensions"+ "reading"]}},- "/api/reading/materials/{material_id}/extensions/{extension_id}/actions/{action}": {- "post": {- "operationId": "run_extension_action_api_reading_materials__material_id__extensions__extension_id__actions__action__post",+ "/api/reading/materials/{material_id}/quiz/rewards": {+ "get": {+ "operationId": "list_quiz_rewards_api_reading_materials__material_id__quiz_rewards_get","parameters": [{"in": "path",@@ -42745,24 +44179,6 @@"type": "string"}},- {- "in": "path",- "name": "extension_id",- "required": true,- "schema": {- "title": "Extension Id",- "type": "string"- }- },- {- "in": "path",- "name": "action",- "required": true,- "schema": {- "title": "Action",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -42796,23 +44212,13 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/ActionPayload"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {"schema": {"additionalProperties": true,- "title": "Response Run Extension Action Api Reading Materials Material Id Extensions Extension Id Actions Action Post",+ "title": "Response List Quiz Rewards Api Reading Materials Material Id Quiz Rewards Get","type": "object"}}@@ -42830,16 +44236,16 @@"description": "Validation Error"}},- "summary": "Run Extension Action",+ "summary": "List Quiz Rewards","tags": ["reading-extensions"]}},- "/api/reading/materials/{material_id}/media": {+ "/api/reading/materials/{material_id}/raw": {"get": {- "description": "The embedded-image index (name / locator / mime / size), empty if none.",- "operationId": "list_material_media_api_reading_materials__material_id__media_get",+ "description": "The original bytes, for the faithful viewer. Serves Range requests.",+ "operationId": "get_raw_api_reading_materials__material_id__raw_get","parameters": [{"in": "path",@@ -42887,14 +44293,7 @@"200": {"content": {"application/json": {- "schema": {- "items": {- "additionalProperties": true,- "type": "object"- },- "title": "Response List Material Media Api Reading Materials Material Id Media Get",- "type": "array"- }+ "schema": {}}},"description": "Successful Response"@@ -42910,16 +44309,16 @@"description": "Validation Error"}},- "summary": "List Material Media",+ "summary": "Get Raw","tags": ["reading"]}},- "/api/reading/materials/{material_id}/media/{name}": {- "get": {- "description": "One embedded image's bytes, for the reader pane's media strip.",- "operationId": "get_material_media_api_reading_materials__material_id__media__name__get",+ "/api/reading/materials/{material_id}/read-aloud": {+ "post": {+ "description": "Synthesize one assigned material unit with the active server voice.",+ "operationId": "read_material_aloud_api_reading_materials__material_id__read_aloud_post","parameters": [{"in": "path",@@ -42930,15 +44329,6 @@"type": "string"}},- {- "in": "path",- "name": "name",- "required": true,- "schema": {- "title": "Name",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -42972,6 +44362,16 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/ReadAloudAudioPayload"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -42992,16 +44392,16 @@"description": "Validation Error"}},- "summary": "Get Material Media",+ "summary": "Read Material Aloud","tags": [- "reading"+ "reading-extensions"]}},- "/api/reading/materials/{material_id}/position": {+ "/api/reading/materials/{material_id}/render": {"get": {- "description": "Return the user's last durable viewport for this material.",- "operationId": "get_position_api_reading_materials__material_id__position_get",+ "description": "Serve a browser-ready EPUB archive, or the original for other formats.",+ "operationId": "get_render_api_reading_materials__material_id__render_get","parameters": [{"in": "path",@@ -43049,9 +44449,7 @@"200": {"content": {"application/json": {- "schema": {- "$ref": "#/components/schemas/PositionInfo"- }+ "schema": {}}},"description": "Successful Response"@@ -43067,14 +44465,15 @@"description": "Validation Error"}},- "summary": "Get Position",+ "summary": "Get Render","tags": ["reading"]- },- "put": {- "description": "Persist a validated numeric locator plus an optional renderer anchor.",- "operationId": "save_position_api_reading_materials__material_id__position_put",+ }+ },+ "/api/reading/materials/{material_id}/retry": {+ "post": {+ "operationId": "retry_import_api_reading_materials__material_id__retry_post","parameters": [{"in": "path",@@ -43118,22 +44517,14 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/PositionPayload"- }- }- },- "required": true- },"responses": {- "200": {+ "202": {"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/PositionInfo"+ "additionalProperties": true,+ "title": "Response Retry Import Api Reading Materials Material Id Retry Post",+ "type": "object"}}},@@ -43150,16 +44541,16 @@"description": "Validation Error"}},- "summary": "Save Position",+ "summary": "Retry Import","tags": ["reading"]}},- "/api/reading/materials/{material_id}/raw": {+ "/api/reading/materials/{material_id}/revisions": {"get": {- "description": "The original bytes, for the faithful viewer. Serves Range requests.",- "operationId": "get_raw_api_reading_materials__material_id__raw_get",+ "description": "Prior immutable snapshots retained when a URL is cleaned/refetched.",+ "operationId": "list_material_revisions_api_reading_materials__material_id__revisions_get","parameters": [{"in": "path",@@ -43207,7 +44598,14 @@"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "items": {+ "additionalProperties": true,+ "type": "object"+ },+ "title": "Response List Material Revisions Api Reading Materials Material Id Revisions Get",+ "type": "array"+ }}},"description": "Successful Response"@@ -43223,16 +44621,15 @@"description": "Validation Error"}},- "summary": "Get Raw",+ "summary": "List Material Revisions","tags": ["reading"]}},- "/api/reading/materials/{material_id}/render": {+ "/api/reading/materials/{material_id}/revisions/{revision}/units/{locator}": {"get": {- "description": "Serve a browser-ready EPUB archive, or the original for other formats.",- "operationId": "get_render_api_reading_materials__material_id__render_get",+ "operationId": "get_revision_unit_api_reading_materials__material_id__revisions__revision__units__locator__get","parameters": [{"in": "path",@@ -43243,6 +44640,24 @@"type": "string"}},+ {+ "in": "path",+ "name": "revision",+ "required": true,+ "schema": {+ "title": "Revision",+ "type": "integer"+ }+ },+ {+ "in": "path",+ "name": "locator",+ "required": true,+ "schema": {+ "title": "Locator",+ "type": "integer"+ }+ },{"in": "header","name": "Authorization",@@ -43280,7 +44695,9 @@"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "$ref": "#/components/schemas/UnitText"+ }}},"description": "Successful Response"@@ -43296,15 +44713,16 @@"description": "Validation Error"}},- "summary": "Get Render",+ "summary": "Get Revision Unit","tags": ["reading"]}},- "/api/reading/materials/{material_id}/retry": {- "post": {- "operationId": "retry_import_api_reading_materials__material_id__retry_post",+ "/api/reading/materials/{material_id}/transcript": {+ "get": {+ "description": "Every transcript segment of a timed material, in one response.\n\nThe reader's transcript panel needs all of them at once. Fetching them one\nlocator at a time meant a request per segment — fine when a segment was ten\nminutes long, wasteful now that they follow the speaker's own sentences.",+ "operationId": "get_transcript_api_reading_materials__material_id__transcript_get","parameters": [{"in": "path",@@ -43349,12 +44767,12 @@}],"responses": {- "202": {+ "200": {"content": {"application/json": {"schema": {"additionalProperties": true,- "title": "Response Retry Import Api Reading Materials Material Id Retry Post",+ "title": "Response Get Transcript Api Reading Materials Material Id Transcript Get","type": "object"}}@@ -43372,16 +44790,16 @@"description": "Validation Error"}},- "summary": "Retry Import",+ "summary": "Get Transcript","tags": ["reading"]}},- "/api/reading/materials/{material_id}/revisions": {+ "/api/reading/materials/{material_id}/units/{locator}": {"get": {- "description": "Prior immutable snapshots retained when a URL is cleaned/refetched.",- "operationId": "list_material_revisions_api_reading_materials__material_id__revisions_get",+ "description": "One unit's text — the reader's text view, and the only view for non-PDFs.",+ "operationId": "get_unit_api_reading_materials__material_id__units__locator__get","parameters": [{"in": "path",@@ -43392,6 +44810,15 @@"type": "string"}},+ {+ "in": "path",+ "name": "locator",+ "required": true,+ "schema": {+ "title": "Locator",+ "type": "integer"+ }+ },{"in": "header","name": "Authorization",@@ -43430,12 +44857,7 @@"content": {"application/json": {"schema": {- "items": {- "additionalProperties": true,- "type": "object"- },- "title": "Response List Material Revisions Api Reading Materials Material Id Revisions Get",- "type": "array"+ "$ref": "#/components/schemas/UnitText"}}},@@ -43452,43 +44874,17 @@"description": "Validation Error"}},- "summary": "List Material Revisions",+ "summary": "Get Unit","tags": ["reading"]}},- "/api/reading/materials/{material_id}/revisions/{revision}/units/{locator}": {+ "/api/reading/supported-formats": {"get": {- "operationId": "get_revision_unit_api_reading_materials__material_id__revisions__revision__units__locator__get",+ "description": "What the reader accepts — the single source of truth for the file picker.",+ "operationId": "supported_formats_api_reading_supported_formats_get","parameters": [- {- "in": "path",- "name": "material_id",- "required": true,- "schema": {- "title": "Material Id",- "type": "string"- }- },- {- "in": "path",- "name": "revision",- "required": true,- "schema": {- "title": "Revision",- "type": "integer"- }- },- {- "in": "path",- "name": "locator",- "required": true,- "schema": {- "title": "Locator",- "type": "integer"- }- },{"in": "header","name": "Authorization",@@ -43527,7 +44923,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/UnitText"+ "$ref": "#/components/schemas/SupportedFormats"}}},@@ -43544,23 +44940,24 @@"description": "Validation Error"}},- "summary": "Get Revision Unit",+ "summary": "Supported Formats","tags": ["reading"]}},- "/api/reading/materials/{material_id}/transcript": {+ "/api/reading/workspaces": {"get": {- "description": "Every transcript segment of a timed material, in one response.\n\nThe reader's transcript panel needs all of them at once. Fetching them one\nlocator at a time meant a request per segment — fine when a segment was ten\nminutes long, wasteful now that they follow the speaker's own sentences.",- "operationId": "get_transcript_api_reading_materials__material_id__transcript_get",+ "operationId": "list_workspaces_api_reading_workspaces_get","parameters": [{- "in": "path",- "name": "material_id",- "required": true,+ "in": "query",+ "name": "search",+ "required": false,"schema": {- "title": "Material Id",+ "default": "",+ "maxLength": 200,+ "title": "Search","type": "string"}},@@ -43603,7 +45000,7 @@"application/json": {"schema": {"additionalProperties": true,- "title": "Response Get Transcript Api Reading Materials Material Id Transcript Get",+ "title": "Response List Workspaces Api Reading Workspaces Get","type": "object"}}@@ -43621,35 +45018,92 @@"description": "Validation Error"}},- "summary": "Get Transcript",+ "summary": "List Workspaces","tags": ["reading"]- }- },- "/api/reading/materials/{material_id}/units/{locator}": {- "get": {- "description": "One unit's text — the reader's text view, and the only view for non-PDFs.",- "operationId": "get_unit_api_reading_materials__material_id__units__locator__get",+ },+ "post": {+ "operationId": "create_workspace_api_reading_workspaces_post","parameters": [{- "in": "path",- "name": "material_id",- "required": true,+ "in": "header",+ "name": "Authorization",+ "required": false,"schema": {- "title": "Material Id",- "type": "string"+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"}},{- "in": "path",- "name": "locator",- "required": true,+ "in": "cookie",+ "name": "dt_token",+ "required": false,"schema": {- "title": "Locator",- "type": "integer"+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"}+ }+ ],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/WorkspaceCreateRequest"+ }+ }+ },+ "required": true+ },+ "responses": {+ "201": {+ "content": {+ "application/json": {+ "schema": {+ "additionalProperties": true,+ "title": "Response Create Workspace Api Reading Workspaces Post",+ "type": "object"+ }+ }+ },+ "description": "Successful Response"},+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "Create Workspace",+ "tags": [+ "reading"+ ]+ }+ },+ "/api/reading/workspaces/index": {+ "get": {+ "description": "Just enough to *name* a collection: id and title.\n\nThe sidebar groups reading conversations under their collection and\nrefreshes on every stream end. ``/workspaces`` answers with each\ncollection's whole tab list — every material, its cover, its unit\ncount — none of which a group heading renders.\n\nDeclared above ``/workspaces/{workspace_id}``: that route matches any\nsingle segment, so a literal path below it would never be reached.",+ "operationId": "list_workspace_index_api_reading_workspaces_index_get",+ "parameters": [{"in": "header","name": "Authorization",@@ -43688,7 +45142,9 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/UnitText"+ "additionalProperties": true,+ "title": "Response List Workspace Index Api Reading Workspaces Index Get",+ "type": "object"}}},@@ -43705,17 +45161,25 @@"description": "Validation Error"}},- "summary": "Get Unit",+ "summary": "List Workspace Index","tags": ["reading"]}},- "/api/reading/supported-formats": {- "get": {- "description": "What the reader accepts — the single source of truth for the file picker.",- "operationId": "supported_formats_api_reading_supported_formats_get",+ "/api/reading/workspaces/{workspace_id}": {+ "delete": {+ "operationId": "delete_workspace_api_reading_workspaces__workspace_id__delete","parameters": [+ {+ "in": "path",+ "name": "workspace_id",+ "required": true,+ "schema": {+ "title": "Workspace Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -43754,7 +45218,9 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/SupportedFormats"+ "additionalProperties": true,+ "title": "Response Delete Workspace Api Reading Workspaces Workspace Id Delete",+ "type": "object"}}},@@ -43771,24 +45237,20 @@"description": "Validation Error"}},- "summary": "Supported Formats",+ "summary": "Delete Workspace","tags": ["reading"]- }- },- "/api/reading/workspaces": {+ },"get": {- "operationId": "list_workspaces_api_reading_workspaces_get",+ "operationId": "get_workspace_api_reading_workspaces__workspace_id__get","parameters": [{- "in": "query",- "name": "search",- "required": false,+ "in": "path",+ "name": "workspace_id",+ "required": true,"schema": {- "default": "",- "maxLength": 200,- "title": "Search",+ "title": "Workspace Id","type": "string"}},@@ -43831,7 +45293,7 @@"application/json": {"schema": {"additionalProperties": true,- "title": "Response List Workspaces Api Reading Workspaces Get",+ "title": "Response Get Workspace Api Reading Workspaces Workspace Id Get","type": "object"}}@@ -43849,14 +45311,23 @@"description": "Validation Error"}},- "summary": "List Workspaces",+ "summary": "Get Workspace","tags": ["reading"]},- "post": {- "operationId": "create_workspace_api_reading_workspaces_post",+ "patch": {+ "operationId": "update_workspace_api_reading_workspaces__workspace_id__patch","parameters": [+ {+ "in": "path",+ "name": "workspace_id",+ "required": true,+ "schema": {+ "title": "Workspace Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -43894,19 +45365,19 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/WorkspaceCreateRequest"+ "$ref": "#/components/schemas/WorkspaceUpdateRequest"}}},"required": true},"responses": {- "201": {+ "200": {"content": {"application/json": {"schema": {"additionalProperties": true,- "title": "Response Create Workspace Api Reading Workspaces Post",+ "title": "Response Update Workspace Api Reading Workspaces Workspace Id Patch","type": "object"}}@@ -43924,17 +45395,62 @@"description": "Validation Error"}},- "summary": "Create Workspace",+ "summary": "Update Workspace","tags": ["reading"]}},- "/api/reading/workspaces/index": {+ "/api/reading/workspaces/{workspace_id}/ask-hint": {"get": {- "description": "Just enough to *name* a collection: id and title.\n\nThe sidebar groups reading conversations under their collection and\nrefreshes on every stream end. ``/workspaces`` answers with each\ncollection's whole tab list — every material, its cover, its unit\ncount — none of which a group heading renders.\n\nDeclared above ``/workspaces/{workspace_id}``: that route matches any\nsingle segment, so a literal path below it would never be reached.",- "operationId": "list_workspace_index_api_reading_workspaces_index_get",+ "description": "One question the learner could ask about their current reading context.",+ "operationId": "get_workspace_ask_hint_api_reading_workspaces__workspace_id__ask_hint_get","parameters": [+ {+ "in": "path",+ "name": "workspace_id",+ "required": true,+ "schema": {+ "title": "Workspace Id",+ "type": "string"+ }+ },+ {+ "in": "query",+ "name": "session_id",+ "required": false,+ "schema": {+ "default": "",+ "title": "Session Id",+ "type": "string"+ }+ },+ {+ "in": "query",+ "name": "locator",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "integer"+ },+ {+ "type": "null"+ }+ ],+ "title": "Locator"+ }+ },+ {+ "in": "query",+ "name": "selection",+ "required": false,+ "schema": {+ "default": "",+ "title": "Selection",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -43974,7 +45490,7 @@"application/json": {"schema": {"additionalProperties": true,- "title": "Response List Workspace Index Api Reading Workspaces Index Get",+ "title": "Response Get Workspace Ask Hint Api Reading Workspaces Workspace Id Ask Hint Get","type": "object"}}@@ -43992,15 +45508,15 @@"description": "Validation Error"}},- "summary": "List Workspace Index",+ "summary": "Get Workspace Ask Hint","tags": ["reading"]}},- "/api/reading/workspaces/{workspace_id}": {- "delete": {- "operationId": "delete_workspace_api_reading_workspaces__workspace_id__delete",+ "/api/reading/workspaces/{workspace_id}/materials": {+ "post": {+ "operationId": "add_workspace_material_api_reading_workspaces__workspace_id__materials_post","parameters": [{"in": "path",@@ -44044,13 +45560,23 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/WorkspaceMaterialRequest"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {"application/json": {"schema": {"additionalProperties": true,- "title": "Response Delete Workspace Api Reading Workspaces Workspace Id Delete",+ "title": "Response Add Workspace Material Api Reading Workspaces Workspace Id Materials Post","type": "object"}}@@ -44068,13 +45594,15 @@"description": "Validation Error"}},- "summary": "Delete Workspace",+ "summary": "Add Workspace Material","tags": ["reading"]- },- "get": {- "operationId": "get_workspace_api_reading_workspaces__workspace_id__get",+ }+ },+ "/api/reading/workspaces/{workspace_id}/materials/order": {+ "put": {+ "operationId": "reorder_workspace_materials_api_reading_workspaces__workspace_id__materials_order_put","parameters": [{"in": "path",@@ -44118,13 +45646,23 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/WorkspaceReorderRequest"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {"application/json": {"schema": {"additionalProperties": true,- "title": "Response Get Workspace Api Reading Workspaces Workspace Id Get",+ "title": "Response Reorder Workspace Materials Api Reading Workspaces Workspace Id Materials Order Put","type": "object"}}@@ -44142,13 +45680,15 @@"description": "Validation Error"}},- "summary": "Get Workspace",+ "summary": "Reorder Workspace Materials","tags": ["reading"]- },- "patch": {- "operationId": "update_workspace_api_reading_workspaces__workspace_id__patch",+ }+ },+ "/api/reading/workspaces/{workspace_id}/materials/{material_id}": {+ "delete": {+ "operationId": "remove_workspace_material_api_reading_workspaces__workspace_id__materials__material_id__delete","parameters": [{"in": "path",@@ -44159,6 +45699,15 @@"type": "string"}},+ {+ "in": "path",+ "name": "material_id",+ "required": true,+ "schema": {+ "title": "Material Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -44192,23 +45741,13 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/WorkspaceUpdateRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {"schema": {"additionalProperties": true,- "title": "Response Update Workspace Api Reading Workspaces Workspace Id Patch",+ "title": "Response Remove Workspace Material Api Reading Workspaces Workspace Id Materials Material Id Delete","type": "object"}}@@ -44226,16 +45765,15 @@"description": "Validation Error"}},- "summary": "Update Workspace",+ "summary": "Remove Workspace Material","tags": ["reading"]}},- "/api/reading/workspaces/{workspace_id}/ask-hint": {- "get": {- "description": "One question the learner could ask about their current reading context.",- "operationId": "get_workspace_ask_hint_api_reading_workspaces__workspace_id__ask_hint_get",+ "/api/reading/workspaces/{workspace_id}/materials/{material_id}/active": {+ "put": {+ "operationId": "activate_workspace_material_api_reading_workspaces__workspace_id__materials__material_id__active_put","parameters": [{"in": "path",@@ -44247,38 +45785,11 @@}},{- "in": "query",- "name": "session_id",- "required": false,- "schema": {- "default": "",- "title": "Session Id",- "type": "string"- }- },- {- "in": "query",- "name": "locator",- "required": false,- "schema": {- "anyOf": [- {- "type": "integer"- },- {- "type": "null"- }- ],- "title": "Locator"- }- },- {- "in": "query",- "name": "selection",- "required": false,+ "in": "path",+ "name": "material_id",+ "required": true,"schema": {- "default": "",- "title": "Selection",+ "title": "Material Id","type": "string"}},@@ -44321,7 +45832,7 @@"application/json": {"schema": {"additionalProperties": true,- "title": "Response Get Workspace Ask Hint Api Reading Workspaces Workspace Id Ask Hint Get",+ "title": "Response Activate Workspace Material Api Reading Workspaces Workspace Id Materials Material Id Active Put","type": "object"}}@@ -44339,15 +45850,15 @@"description": "Validation Error"}},- "summary": "Get Workspace Ask Hint",+ "summary": "Activate Workspace Material","tags": ["reading"]}},- "/api/reading/workspaces/{workspace_id}/materials": {+ "/api/reading/workspaces/{workspace_id}/notebook": {"post": {- "operationId": "add_workspace_material_api_reading_workspaces__workspace_id__materials_post",+ "operationId": "capture_reading_to_notebook_api_reading_workspaces__workspace_id__notebook_post","parameters": [{"in": "path",@@ -44395,7 +45906,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/WorkspaceMaterialRequest"+ "$ref": "#/components/schemas/NotebookCaptureRequest"}}},@@ -44407,7 +45918,7 @@"application/json": {"schema": {"additionalProperties": true,- "title": "Response Add Workspace Material Api Reading Workspaces Workspace Id Materials Post",+ "title": "Response Capture Reading To Notebook Api Reading Workspaces Workspace Id Notebook Post","type": "object"}}@@ -44425,15 +45936,15 @@"description": "Validation Error"}},- "summary": "Add Workspace Material",+ "summary": "Capture Reading To Notebook","tags": ["reading"]}},- "/api/reading/workspaces/{workspace_id}/materials/order": {- "put": {- "operationId": "reorder_workspace_materials_api_reading_workspaces__workspace_id__materials_order_put",+ "/api/reading/workspaces/{workspace_id}/notes/organize": {+ "post": {+ "operationId": "organize_reading_notes_api_reading_workspaces__workspace_id__notes_organize_post","parameters": [{"in": "path",@@ -44481,7 +45992,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/WorkspaceReorderRequest"+ "$ref": "#/components/schemas/OrganizeNotesRequest"}}},@@ -44493,7 +46004,7 @@"application/json": {"schema": {"additionalProperties": true,- "title": "Response Reorder Workspace Materials Api Reading Workspaces Workspace Id Materials Order Put",+ "title": "Response Organize Reading Notes Api Reading Workspaces Workspace Id Notes Organize Post","type": "object"}}@@ -44511,15 +46022,15 @@"description": "Validation Error"}},- "summary": "Reorder Workspace Materials",+ "summary": "Organize Reading Notes","tags": ["reading"]}},- "/api/reading/workspaces/{workspace_id}/materials/{material_id}": {- "delete": {- "operationId": "remove_workspace_material_api_reading_workspaces__workspace_id__materials__material_id__delete",+ "/api/reading/workspaces/{workspace_id}/sessions": {+ "get": {+ "operationId": "list_reading_sessions_api_reading_workspaces__workspace_id__sessions_get","parameters": [{"in": "path",@@ -44530,15 +46041,6 @@"type": "string"}},- {- "in": "path",- "name": "material_id",- "required": true,- "schema": {- "title": "Material Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -44578,7 +46080,7 @@"application/json": {"schema": {"additionalProperties": true,- "title": "Response Remove Workspace Material Api Reading Workspaces Workspace Id Materials Material Id Delete",+ "title": "Response List Reading Sessions Api Reading Workspaces Workspace Id Sessions Get","type": "object"}}@@ -44596,15 +46098,13 @@"description": "Validation Error"}},- "summary": "Remove Workspace Material",+ "summary": "List Reading Sessions","tags": ["reading"]- }- },- "/api/reading/workspaces/{workspace_id}/materials/{material_id}/active": {- "put": {- "operationId": "activate_workspace_material_api_reading_workspaces__workspace_id__materials__material_id__active_put",+ },+ "post": {+ "operationId": "create_reading_session_api_reading_workspaces__workspace_id__sessions_post","parameters": [{"in": "path",@@ -44615,15 +46115,6 @@"type": "string"}},- {- "in": "path",- "name": "material_id",- "required": true,- "schema": {- "title": "Material Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -44657,13 +46148,23 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/ReadingSessionCreateRequest"+ }+ }+ },+ "required": true+ },"responses": {- "200": {+ "201": {"content": {"application/json": {"schema": {"additionalProperties": true,- "title": "Response Activate Workspace Material Api Reading Workspaces Workspace Id Materials Material Id Active Put",+ "title": "Response Create Reading Session Api Reading Workspaces Workspace Id Sessions Post","type": "object"}}@@ -44681,15 +46182,15 @@"description": "Validation Error"}},- "summary": "Activate Workspace Material",+ "summary": "Create Reading Session","tags": ["reading"]}},- "/api/reading/workspaces/{workspace_id}/notebook": {- "post": {- "operationId": "capture_reading_to_notebook_api_reading_workspaces__workspace_id__notebook_post",+ "/api/reading/workspaces/{workspace_id}/sessions/{session_id}": {+ "delete": {+ "operationId": "delete_reading_session_api_reading_workspaces__workspace_id__sessions__session_id__delete","parameters": [{"in": "path",@@ -44700,6 +46201,15 @@"type": "string"}},+ {+ "in": "path",+ "name": "session_id",+ "required": true,+ "schema": {+ "title": "Session Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -44733,23 +46243,13 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/NotebookCaptureRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {"schema": {"additionalProperties": true,- "title": "Response Capture Reading To Notebook Api Reading Workspaces Workspace Id Notebook Post",+ "title": "Response Delete Reading Session Api Reading Workspaces Workspace Id Sessions Session Id Delete","type": "object"}}@@ -44767,15 +46267,13 @@"description": "Validation Error"}},- "summary": "Capture Reading To Notebook",+ "summary": "Delete Reading Session","tags": ["reading"]- }- },- "/api/reading/workspaces/{workspace_id}/notes/organize": {- "post": {- "operationId": "organize_reading_notes_api_reading_workspaces__workspace_id__notes_organize_post",+ },+ "patch": {+ "operationId": "rename_reading_session_api_reading_workspaces__workspace_id__sessions__session_id__patch","parameters": [{"in": "path",@@ -44786,6 +46284,15 @@"type": "string"}},+ {+ "in": "path",+ "name": "session_id",+ "required": true,+ "schema": {+ "title": "Session Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -44823,7 +46330,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/OrganizeNotesRequest"+ "$ref": "#/components/schemas/ReadingSessionRenameRequest"}}},@@ -44835,7 +46342,7 @@"application/json": {"schema": {"additionalProperties": true,- "title": "Response Organize Reading Notes Api Reading Workspaces Workspace Id Notes Organize Post",+ "title": "Response Rename Reading Session Api Reading Workspaces Workspace Id Sessions Session Id Patch","type": "object"}}@@ -44853,15 +46360,15 @@"description": "Validation Error"}},- "summary": "Organize Reading Notes",+ "summary": "Rename Reading Session","tags": ["reading"]}},- "/api/reading/workspaces/{workspace_id}/sessions": {- "get": {- "operationId": "list_reading_sessions_api_reading_workspaces__workspace_id__sessions_get",+ "/api/reading/workspaces/{workspace_id}/sessions/{session_id}/links": {+ "post": {+ "operationId": "link_reading_session_api_reading_workspaces__workspace_id__sessions__session_id__links_post","parameters": [{"in": "path",@@ -44872,6 +46379,15 @@"type": "string"}},+ {+ "in": "path",+ "name": "session_id",+ "required": true,+ "schema": {+ "title": "Session Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -44905,13 +46421,23 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/ReadingSessionLinkRequest"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {"application/json": {"schema": {"additionalProperties": true,- "title": "Response List Reading Sessions Api Reading Workspaces Workspace Id Sessions Get",+ "title": "Response Link Reading Session Api Reading Workspaces Workspace Id Sessions Session Id Links Post","type": "object"}}@@ -44929,13 +46455,15 @@"description": "Validation Error"}},- "summary": "List Reading Sessions",+ "summary": "Link Reading Session","tags": ["reading"]- },- "post": {- "operationId": "create_reading_session_api_reading_workspaces__workspace_id__sessions_post",+ }+ },+ "/api/reading/workspaces/{workspace_id}/sessions/{session_id}/links/{target_session_id}": {+ "delete": {+ "operationId": "unlink_reading_session_api_reading_workspaces__workspace_id__sessions__session_id__links__target_session_id__delete","parameters": [{"in": "path",@@ -44946,6 +46474,24 @@"type": "string"}},+ {+ "in": "path",+ "name": "session_id",+ "required": true,+ "schema": {+ "title": "Session Id",+ "type": "string"+ }+ },+ {+ "in": "path",+ "name": "target_session_id",+ "required": true,+ "schema": {+ "title": "Target Session Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -44979,23 +46525,13 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/ReadingSessionCreateRequest"- }- }- },- "required": true- },"responses": {- "201": {+ "200": {"content": {"application/json": {"schema": {"additionalProperties": true,- "title": "Response Create Reading Session Api Reading Workspaces Workspace Id Sessions Post",+ "title": "Response Unlink Reading Session Api Reading Workspaces Workspace Id Sessions Session Id Links Target Session Id Delete","type": "object"}}@@ -45013,32 +46549,63 @@"description": "Validation Error"}},- "summary": "Create Reading Session",+ "summary": "Unlink Reading Session","tags": ["reading"]}},- "/api/reading/workspaces/{workspace_id}/sessions/{session_id}": {- "delete": {- "operationId": "delete_reading_session_api_reading_workspaces__workspace_id__sessions__session_id__delete",+ "/api/sessions": {+ "get": {+ "operationId": "list_sessions_api_sessions_get","parameters": [{- "in": "path",+ "in": "query",+ "name": "limit",+ "required": false,+ "schema": {+ "default": 50,+ "maximum": 200,+ "minimum": 1,+ "title": "Limit",+ "type": "integer"+ }+ },+ {+ "in": "query",+ "name": "offset",+ "required": false,+ "schema": {+ "default": 0,+ "minimum": 0,+ "title": "Offset",+ "type": "integer"+ }+ },+ {+ "in": "query","name": "workspace_id",- "required": true,+ "required": false,"schema": {- "title": "Workspace Id",- "type": "string"+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Workspace Id"}},{- "in": "path",- "name": "session_id",- "required": true,+ "in": "query",+ "name": "all_workspaces",+ "required": false,"schema": {- "title": "Session Id",- "type": "string"+ "default": false,+ "title": "All Workspaces",+ "type": "boolean"}},{@@ -45078,11 +46645,7 @@"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Delete Reading Session Api Reading Workspaces Workspace Id Sessions Session Id Delete",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -45098,30 +46661,37 @@"description": "Validation Error"}},- "summary": "Delete Reading Session",+ "summary": "List Sessions","tags": [- "reading"+ "sessions"]- },- "patch": {- "operationId": "rename_reading_session_api_reading_workspaces__workspace_id__sessions__session_id__patch",+ }+ },+ "/api/sessions/recycle-bin": {+ "get": {+ "operationId": "list_recycle_bin_api_sessions_recycle_bin_get","parameters": [{- "in": "path",- "name": "workspace_id",- "required": true,+ "in": "query",+ "name": "limit",+ "required": false,"schema": {- "title": "Workspace Id",- "type": "string"+ "default": 50,+ "maximum": 200,+ "minimum": 1,+ "title": "Limit",+ "type": "integer"}},{- "in": "path",- "name": "session_id",- "required": true,+ "in": "query",+ "name": "offset",+ "required": false,"schema": {- "title": "Session Id",- "type": "string"+ "default": 0,+ "minimum": 0,+ "title": "Offset",+ "type": "integer"}},{@@ -45157,25 +46727,11 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/ReadingSessionRenameRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Rename Reading Session Api Reading Workspaces Workspace Id Sessions Session Id Patch",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -45191,32 +46747,59 @@"description": "Validation Error"}},- "summary": "Rename Reading Session",+ "summary": "List Recycle Bin","tags": [- "reading"+ "sessions"]}},- "/api/reading/workspaces/{workspace_id}/sessions/{session_id}/links": {- "post": {- "operationId": "link_reading_session_api_reading_workspaces__workspace_id__sessions__session_id__links_post",+ "/api/sessions/search": {+ "get": {+ "description": "Search titles and persisted user/assistant messages for a literal term.",+ "operationId": "search_sessions_api_sessions_search_get","parameters": [{- "in": "path",- "name": "workspace_id",+ "in": "query",+ "name": "q","required": true,"schema": {- "title": "Workspace Id",+ "maxLength": 200,+ "minLength": 1,+ "title": "Q","type": "string"}},{- "in": "path",- "name": "session_id",- "required": true,+ "in": "query",+ "name": "limit",+ "required": false,"schema": {- "title": "Session Id",- "type": "string"+ "default": 50,+ "maximum": 100,+ "minimum": 1,+ "title": "Limit",+ "type": "integer"+ }+ },+ {+ "in": "query",+ "name": "offset",+ "required": false,+ "schema": {+ "default": 0,+ "minimum": 0,+ "title": "Offset",+ "type": "integer"+ }+ },+ {+ "in": "query",+ "name": "all_workspaces",+ "required": false,+ "schema": {+ "default": false,+ "title": "All Workspaces",+ "type": "boolean"}},{@@ -45252,25 +46835,11 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/ReadingSessionLinkRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Link Reading Session Api Reading Workspaces Workspace Id Sessions Session Id Links Post",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -45286,25 +46855,16 @@"description": "Validation Error"}},- "summary": "Link Reading Session",+ "summary": "Search Sessions","tags": [- "reading"+ "sessions"]}},- "/api/reading/workspaces/{workspace_id}/sessions/{session_id}/links/{target_session_id}": {+ "/api/sessions/{session_id}": {"delete": {- "operationId": "unlink_reading_session_api_reading_workspaces__workspace_id__sessions__session_id__links__target_session_id__delete",+ "operationId": "delete_session_api_sessions__session_id__delete","parameters": [- {- "in": "path",- "name": "workspace_id",- "required": true,- "schema": {- "title": "Workspace Id",- "type": "string"- }- },{"in": "path","name": "session_id",@@ -45314,15 +46874,6 @@"type": "string"}},- {- "in": "path",- "name": "target_session_id",- "required": true,- "schema": {- "title": "Target Session Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -45360,11 +46911,7 @@"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Unlink Reading Session Api Reading Workspaces Workspace Id Sessions Session Id Links Target Session Id Delete",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -45380,42 +46927,42 @@"description": "Validation Error"}},- "summary": "Unlink Reading Session",+ "summary": "Delete Session","tags": [- "reading"+ "sessions"]- }- },- "/api/sessions": {+ },"get": {- "operationId": "list_sessions_api_sessions_get",+ "operationId": "get_session_api_sessions__session_id__get","parameters": [{- "in": "query",- "name": "limit",- "required": false,+ "in": "path",+ "name": "session_id",+ "required": true,"schema": {- "default": 50,- "maximum": 200,- "minimum": 1,- "title": "Limit",- "type": "integer"+ "title": "Session Id",+ "type": "string"}},{- "in": "query",- "name": "offset",+ "in": "header",+ "name": "Authorization","required": false,"schema": {- "default": 0,- "minimum": 0,- "title": "Offset",- "type": "integer"+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"}},{- "in": "query",- "name": "workspace_id",+ "in": "cookie",+ "name": "dt_token","required": false,"schema": {"anyOf": [@@ -45426,17 +46973,45 @@"type": "null"}],- "title": "Workspace Id"+ "title": "Dt Token"}+ }+ ],+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {}+ }+ },+ "description": "Successful Response"},+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "Get Session",+ "tags": [+ "sessions"+ ]+ },+ "patch": {+ "operationId": "rename_session_api_sessions__session_id__patch",+ "parameters": [{- "in": "query",- "name": "all_workspaces",- "required": false,+ "in": "path",+ "name": "session_id",+ "required": true,"schema": {- "default": false,- "title": "All Workspaces",- "type": "boolean"+ "title": "Session Id",+ "type": "string"}},{@@ -45472,6 +47047,16 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/SessionRenameRequest"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -45492,37 +47077,24 @@"description": "Validation Error"}},- "summary": "List Sessions",+ "summary": "Rename Session","tags": ["sessions"]}},- "/api/sessions/recycle-bin": {+ "/api/sessions/{session_id}/ask-hint": {"get": {- "operationId": "list_recycle_bin_api_sessions_recycle_bin_get",+ "description": "One line the user is likely to type next, for the home composer placeholder.",+ "operationId": "get_session_ask_hint_api_sessions__session_id__ask_hint_get","parameters": [{- "in": "query",- "name": "limit",- "required": false,- "schema": {- "default": 50,- "maximum": 200,- "minimum": 1,- "title": "Limit",- "type": "integer"- }- },- {- "in": "query",- "name": "offset",- "required": false,+ "in": "path",+ "name": "session_id",+ "required": true,"schema": {- "default": 0,- "minimum": 0,- "title": "Offset",- "type": "integer"+ "title": "Session Id",+ "type": "string"}},{@@ -45562,7 +47134,11 @@"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": true,+ "title": "Response Get Session Ask Hint Api Sessions Session Id Ask Hint Get",+ "type": "object"+ }}},"description": "Successful Response"@@ -45578,61 +47154,25 @@"description": "Validation Error"}},- "summary": "List Recycle Bin",+ "summary": "Get Session Ask Hint","tags": ["sessions"]}},- "/api/sessions/search": {- "get": {- "description": "Search titles and persisted user/assistant messages for a literal term.",- "operationId": "search_sessions_api_sessions_search_get",+ "/api/sessions/{session_id}/branch-selection": {+ "put": {+ "operationId": "update_branch_selection_api_sessions__session_id__branch_selection_put","parameters": [{- "in": "query",- "name": "q",+ "in": "path",+ "name": "session_id","required": true,"schema": {- "maxLength": 200,- "minLength": 1,- "title": "Q",+ "title": "Session Id","type": "string"}},- {- "in": "query",- "name": "limit",- "required": false,- "schema": {- "default": 50,- "maximum": 100,- "minimum": 1,- "title": "Limit",- "type": "integer"- }- },- {- "in": "query",- "name": "offset",- "required": false,- "schema": {- "default": 0,- "minimum": 0,- "title": "Offset",- "type": "integer"- }- },- {- "in": "query",- "name": "all_workspaces",- "required": false,- "schema": {- "default": false,- "title": "All Workspaces",- "type": "boolean"- }- },{"in": "header","name": "Authorization",@@ -45666,6 +47206,16 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/BranchSelectionRequest"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -45686,15 +47236,15 @@"description": "Validation Error"}},- "summary": "Search Sessions",+ "summary": "Update Branch Selection","tags": ["sessions"]}},- "/api/sessions/{session_id}": {+ "/api/sessions/{session_id}/messages/{message_id}": {"delete": {- "operationId": "delete_session_api_sessions__session_id__delete",+ "operationId": "delete_turn_by_message_api_sessions__session_id__messages__message_id__delete","parameters": [{"in": "path",@@ -45705,6 +47255,15 @@"type": "string"}},+ {+ "in": "path",+ "name": "message_id",+ "required": true,+ "schema": {+ "title": "Message Id",+ "type": "integer"+ }+ },{"in": "header","name": "Authorization",@@ -45758,13 +47317,15 @@"description": "Validation Error"}},- "summary": "Delete Session",+ "summary": "Delete Turn By Message","tags": ["sessions"]- },+ }+ },+ "/api/sessions/{session_id}/messages/{message_id}/events": {"get": {- "operationId": "get_session_api_sessions__session_id__get",+ "operationId": "get_message_events_api_sessions__session_id__messages__message_id__events_get","parameters": [{"in": "path",@@ -45775,6 +47336,38 @@"type": "string"}},+ {+ "in": "path",+ "name": "message_id",+ "required": true,+ "schema": {+ "title": "Message Id",+ "type": "string"+ }+ },+ {+ "in": "query",+ "name": "after_seq",+ "required": false,+ "schema": {+ "default": 0,+ "minimum": 0,+ "title": "After Seq",+ "type": "integer"+ }+ },+ {+ "in": "query",+ "name": "limit",+ "required": false,+ "schema": {+ "default": 500,+ "maximum": 1000,+ "minimum": 1,+ "title": "Limit",+ "type": "integer"+ }+ },{"in": "header","name": "Authorization",@@ -45828,13 +47421,15 @@"description": "Validation Error"}},- "summary": "Get Session",+ "summary": "Get Message Events","tags": ["sessions"]- },+ }+ },+ "/api/sessions/{session_id}/organization": {"patch": {- "operationId": "rename_session_api_sessions__session_id__patch",+ "operationId": "update_session_organization_api_sessions__session_id__organization_patch","parameters": [{"in": "path",@@ -45882,7 +47477,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/SessionRenameRequest"+ "$ref": "#/components/schemas/SessionOrganizationRequest"}}},@@ -45908,16 +47503,15 @@"description": "Validation Error"}},- "summary": "Rename Session",+ "summary": "Update Session Organization","tags": ["sessions"]}},- "/api/sessions/{session_id}/ask-hint": {- "get": {- "description": "One line the user is likely to type next, for the home composer placeholder.",- "operationId": "get_session_ask_hint_api_sessions__session_id__ask_hint_get",+ "/api/sessions/{session_id}/purge": {+ "delete": {+ "operationId": "purge_session_api_sessions__session_id__purge_delete","parameters": [{"in": "path",@@ -45965,11 +47559,7 @@"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Get Session Ask Hint Api Sessions Session Id Ask Hint Get",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -45985,15 +47575,15 @@"description": "Validation Error"}},- "summary": "Get Session Ask Hint",+ "summary": "Purge Session","tags": ["sessions"]}},- "/api/sessions/{session_id}/branch-selection": {- "put": {- "operationId": "update_branch_selection_api_sessions__session_id__branch_selection_put",+ "/api/sessions/{session_id}/quiz-results": {+ "post": {+ "operationId": "record_quiz_results_api_sessions__session_id__quiz_results_post","parameters": [{"in": "path",@@ -46041,7 +47631,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/BranchSelectionRequest"+ "$ref": "#/components/schemas/QuizResultsRequest"}}},@@ -46067,15 +47657,16 @@"description": "Validation Error"}},- "summary": "Update Branch Selection",+ "summary": "Record Quiz Results","tags": ["sessions"]}},- "/api/sessions/{session_id}/messages/{message_id}": {- "delete": {- "operationId": "delete_turn_by_message_api_sessions__session_id__messages__message_id__delete",+ "/api/sessions/{session_id}/reply-language": {+ "patch": {+ "description": "Fix this conversation's reply language, or return to the account default.",+ "operationId": "update_session_reply_language_api_sessions__session_id__reply_language_patch","parameters": [{"in": "path",@@ -46086,15 +47677,6 @@"type": "string"}},- {- "in": "path",- "name": "message_id",- "required": true,- "schema": {- "title": "Message Id",- "type": "integer"- }- },{"in": "header","name": "Authorization",@@ -46128,6 +47710,16 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/SessionReplyLanguageRequest"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -46148,15 +47740,15 @@"description": "Validation Error"}},- "summary": "Delete Turn By Message",+ "summary": "Update Session Reply Language","tags": ["sessions"]}},- "/api/sessions/{session_id}/messages/{message_id}/events": {- "get": {- "operationId": "get_message_events_api_sessions__session_id__messages__message_id__events_get",+ "/api/sessions/{session_id}/restore": {+ "post": {+ "operationId": "restore_session_api_sessions__session_id__restore_post","parameters": [{"in": "path",@@ -46168,37 +47760,68 @@}},{- "in": "path",- "name": "message_id",- "required": true,- "schema": {- "title": "Message Id",- "type": "string"- }- },- {- "in": "query",- "name": "after_seq",+ "in": "header",+ "name": "Authorization","required": false,"schema": {- "default": 0,- "minimum": 0,- "title": "After Seq",- "type": "integer"+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"}},{- "in": "query",- "name": "limit",+ "in": "cookie",+ "name": "dt_token","required": false,"schema": {- "default": 500,- "maximum": 1000,- "minimum": 1,- "title": "Limit",- "type": "integer"+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"}+ }+ ],+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {}+ }+ },+ "description": "Successful Response"},+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "Restore Session",+ "tags": [+ "sessions"+ ]+ }+ },+ "/api/settings": {+ "get": {+ "operationId": "get_settings_api_settings_get",+ "parameters": [{"in": "header","name": "Authorization",@@ -46252,25 +47875,17 @@"description": "Validation Error"}},- "summary": "Get Message Events",+ "summary": "Get Settings","tags": [- "sessions"+ "settings"]}},- "/api/sessions/{session_id}/organization": {- "patch": {- "operationId": "update_session_organization_api_sessions__session_id__organization_patch",+ "/api/settings/apply": {+ "post": {+ "description": "Move settings into the files the runtime reads, and clear the draft.\n\nWith no body this promotes the stored draft's catalog, which is how the\nsettings UI applies: credentials that only ever existed in a draft would\notherwise have to round-trip through the browser as placeholders and come\nback resolving to the previous key.",+ "operationId": "apply_catalog_api_settings_apply_post","parameters": [- {- "in": "path",- "name": "session_id",- "required": true,- "schema": {- "title": "Session Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -46308,11 +47923,18 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/SessionOrganizationRequest"+ "anyOf": [+ {+ "$ref": "#/components/schemas/CatalogPayload"+ },+ {+ "type": "null"+ }+ ],+ "title": "Payload"}}- },- "required": true+ }},"responses": {"200": {@@ -46334,25 +47956,17 @@"description": "Validation Error"}},- "summary": "Update Session Organization",+ "summary": "Apply Catalog","tags": [- "sessions"+ "settings"]}},- "/api/sessions/{session_id}/purge": {- "delete": {- "operationId": "purge_session_api_sessions__session_id__purge_delete",+ "/api/settings/apply/provider": {+ "post": {+ "description": "Save the provider on screen, preserving every unrelated live/draft entry.",+ "operationId": "apply_provider_edit_api_settings_apply_provider_post","parameters": [- {- "in": "path",- "name": "session_id",- "required": true,- "schema": {- "title": "Session Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -46386,6 +48000,16 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/ProviderEditPayload"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -46406,25 +48030,17 @@"description": "Validation Error"}},- "summary": "Purge Session",+ "summary": "Apply Provider Edit","tags": [- "sessions"+ "settings"]}},- "/api/sessions/{session_id}/quiz-results": {+ "/api/settings/apply/registry": {"post": {- "operationId": "record_quiz_results_api_sessions__session_id__quiz_results_post",+ "description": "Promote one provider, model, or default without replacing other drafts.",+ "operationId": "apply_registry_edit_api_settings_apply_registry_post","parameters": [- {- "in": "path",- "name": "session_id",- "required": true,- "schema": {- "title": "Session Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -46462,7 +48078,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/QuizResultsRequest"+ "$ref": "#/components/schemas/RegistryEditPayload"}}},@@ -46488,26 +48104,17 @@"description": "Validation Error"}},- "summary": "Record Quiz Results",+ "summary": "Apply Registry Edit","tags": [- "sessions"+ "settings"]}},- "/api/sessions/{session_id}/reply-language": {- "patch": {- "description": "Fix this conversation's reply language, or return to the account default.",- "operationId": "update_session_reply_language_api_sessions__session_id__reply_language_patch",+ "/api/settings/apply/service": {+ "post": {+ "description": "Apply one model service while leaving every other draft untouched.\n\nProvider dialogs use this narrower commit path for their Done action. A\nuser may still have unrelated edits elsewhere in Settings, and closing an\nSTT dialog must not silently promote those edits too.",+ "operationId": "apply_catalog_service_api_settings_apply_service_post","parameters": [- {- "in": "path",- "name": "session_id",- "required": true,- "schema": {- "title": "Session Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -46545,7 +48152,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/SessionReplyLanguageRequest"+ "$ref": "#/components/schemas/CatalogServicePayload"}}},@@ -46571,25 +48178,16 @@"description": "Validation Error"}},- "summary": "Update Session Reply Language",+ "summary": "Apply Catalog Service","tags": [- "sessions"+ "settings"]}},- "/api/sessions/{session_id}/restore": {- "post": {- "operationId": "restore_session_api_sessions__session_id__restore_post",+ "/api/settings/catalog": {+ "get": {+ "operationId": "get_catalog_api_settings_catalog_get","parameters": [- {- "in": "path",- "name": "session_id",- "required": true,- "schema": {- "title": "Session Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -46643,15 +48241,13 @@"description": "Validation Error"}},- "summary": "Restore Session",+ "summary": "Get Catalog","tags": [- "sessions"+ "settings"]- }- },- "/api/settings": {- "get": {- "operationId": "get_settings_api_settings_get",+ },+ "put": {+ "operationId": "update_catalog_api_settings_catalog_put","parameters": [{"in": "header",@@ -46686,6 +48282,16 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/CatalogPayload"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -46706,16 +48312,16 @@"description": "Validation Error"}},- "summary": "Get Settings",+ "summary": "Update Catalog","tags": ["settings"]}},- "/api/settings/apply": {- "post": {- "description": "Move settings into the files the runtime reads, and clear the draft.\n\nWith no body this promotes the stored draft's catalog, which is how the\nsettings UI applies: credentials that only ever existed in a draft would\notherwise have to round-trip through the browser as placeholders and come\nback resolving to the previous key.",- "operationId": "apply_catalog_api_settings_apply_post",+ "/api/settings/chat-attachments": {+ "get": {+ "description": "Chat attachment policy. Readable by any user — the composer needs the\ncaps to gate file picks client-side; only the PUT is admin-gated.",+ "operationId": "get_chat_attachment_settings_api_settings_chat_attachments_get","parameters": [{"in": "header",@@ -46750,23 +48356,6 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "anyOf": [- {- "$ref": "#/components/schemas/CatalogPayload"- },- {- "type": "null"- }- ],- "title": "Payload"- }- }- }- },"responses": {"200": {"content": {@@ -46787,16 +48376,13 @@"description": "Validation Error"}},- "summary": "Apply Catalog",+ "summary": "Get Chat Attachment Settings","tags": ["settings"]- }- },- "/api/settings/apply/provider": {- "post": {- "description": "Save the provider on screen, preserving every unrelated live/draft entry.",- "operationId": "apply_provider_edit_api_settings_apply_provider_post",+ },+ "put": {+ "operationId": "update_chat_attachment_settings_api_settings_chat_attachments_put","parameters": [{"in": "header",@@ -46835,7 +48421,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/ProviderEditPayload"+ "$ref": "#/components/schemas/ChatAttachmentSettingsUpdate"}}},@@ -46861,16 +48447,16 @@"description": "Validation Error"}},- "summary": "Apply Provider Edit",+ "summary": "Update Chat Attachment Settings","tags": ["settings"]}},- "/api/settings/apply/registry": {- "post": {- "description": "Promote one provider, model, or default without replacing other drafts.",- "operationId": "apply_registry_edit_api_settings_apply_registry_post",+ "/api/settings/chat-response-timeout": {+ "put": {+ "description": "Persist how long the chat UI waits for a turn event before timing out.\n\nA personal UI preference (any authenticated user). Slow tools like image /\nvideo generation can take longer than the old 60s default, so this is\nuser-adjustable; the chat surface reads it client-side.",+ "operationId": "update_chat_response_timeout_api_settings_chat_response_timeout_put","parameters": [{"in": "header",@@ -46909,7 +48495,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/RegistryEditPayload"+ "$ref": "#/components/schemas/ChatResponseTimeoutUpdate"}}},@@ -46935,16 +48521,16 @@"description": "Validation Error"}},- "summary": "Apply Registry Edit",+ "summary": "Update Chat Response Timeout","tags": ["settings"]}},- "/api/settings/apply/service": {- "post": {- "description": "Apply one model service while leaving every other draft untouched.\n\nProvider dialogs use this narrower commit path for their Done action. A\nuser may still have unrelated edits elsewhere in Settings, and closing an\nSTT dialog must not silently promote those edits too.",- "operationId": "apply_catalog_service_api_settings_apply_service_post",+ "/api/settings/chat-starters": {+ "get": {+ "description": "How many recent activities shape the home screen's starting points.\n\nPer user and not admin-gated, unlike the attachment caps next door: this\nchanges the size of one prompt built from the caller's own memory, not any\nresource other people share.",+ "operationId": "get_chat_starter_settings_api_settings_chat_starters_get","parameters": [{"in": "header",@@ -46979,16 +48565,6 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/CatalogServicePayload"- }- }- },- "required": true- },"responses": {"200": {"content": {@@ -47009,15 +48585,13 @@"description": "Validation Error"}},- "summary": "Apply Catalog Service",+ "summary": "Get Chat Starter Settings","tags": ["settings"]- }- },- "/api/settings/catalog": {- "get": {- "operationId": "get_catalog_api_settings_catalog_get",+ },+ "put": {+ "operationId": "update_chat_starter_settings_api_settings_chat_starters_put","parameters": [{"in": "header",@@ -47052,6 +48626,16 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/ChatStarterSettingsUpdate"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -47072,13 +48656,15 @@"description": "Validation Error"}},- "summary": "Get Catalog",+ "summary": "Update Chat Starter Settings","tags": ["settings"]- },- "put": {- "operationId": "update_catalog_api_settings_catalog_put",+ }+ },+ "/api/settings/document-parsing": {+ "get": {+ "operationId": "get_document_parsing_settings_api_settings_document_parsing_get","parameters": [{"in": "header",@@ -47113,16 +48699,6 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/CatalogPayload"- }- }- },- "required": true- },"responses": {"200": {"content": {@@ -47143,16 +48719,13 @@"description": "Validation Error"}},- "summary": "Update Catalog",+ "summary": "Get Document Parsing Settings","tags": ["settings"]- }- },- "/api/settings/chat-attachments": {- "get": {- "description": "Chat attachment policy. Readable by any user — the composer needs the\ncaps to gate file picks client-side; only the PUT is admin-gated.",- "operationId": "get_chat_attachment_settings_api_settings_chat_attachments_get",+ },+ "put": {+ "operationId": "update_document_parsing_settings_api_settings_document_parsing_put","parameters": [{"in": "header",@@ -47187,6 +48760,16 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/DocumentParsingUpdate"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -47207,13 +48790,16 @@"description": "Validation Error"}},- "summary": "Get Chat Attachment Settings",+ "summary": "Update Document Parsing Settings","tags": ["settings"]- },- "put": {- "operationId": "update_chat_attachment_settings_api_settings_chat_attachments_put",+ }+ },+ "/api/settings/document-parsing/docling/test": {+ "post": {+ "description": "Live connectivity check for the Docling remote-server draft values.\nPings the server health + version endpoints and returns ``ok`` + a\nhuman-readable detail. Tests draft form values so the user can verify the\nURL/key before saving; falls back to the stored key when the secret field\nis untouched.",+ "operationId": "test_docling_remote_connection_api_settings_document_parsing_docling_test_post","parameters": [{"in": "header",@@ -47252,7 +48838,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/ChatAttachmentSettingsUpdate"+ "$ref": "#/components/schemas/DoclingRemoteTest"}}},@@ -47278,16 +48864,16 @@"description": "Validation Error"}},- "summary": "Update Chat Attachment Settings",+ "summary": "Test Docling Remote Connection","tags": ["settings"]}},- "/api/settings/chat-response-timeout": {- "put": {- "description": "Persist how long the chat UI waits for a turn event before timing out.\n\nA personal UI preference (any authenticated user). Slow tools like image /\nvideo generation can take longer than the old 60s default, so this is\nuser-adjustable; the chat surface reads it client-side.",- "operationId": "update_chat_response_timeout_api_settings_chat_response_timeout_put",+ "/api/settings/document-parsing/install": {+ "post": {+ "description": "Kick off a one-click ``pip install`` of an optional engine's package(s).\n\nReturns ``{ok, message}`` immediately; progress is polled via the shared job\nstatus endpoint. Only one job runs at a time (process-wide singleton). The\nengine must be in the install allow-list (``ENGINE_PIP_SPECS``).",+ "operationId": "start_document_parsing_install_api_settings_document_parsing_install_post","parameters": [{"in": "header",@@ -47326,7 +48912,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/ChatResponseTimeoutUpdate"+ "$ref": "#/components/schemas/DocumentParsingInstall"}}},@@ -47352,16 +48938,15 @@"description": "Validation Error"}},- "summary": "Update Chat Response Timeout",+ "summary": "Start Document Parsing Install","tags": ["settings"]}},- "/api/settings/chat-starters": {- "get": {- "description": "How many recent activities shape the home screen's starting points.\n\nPer user and not admin-gated, unlike the attachment caps next door: this\nchanges the size of one prompt built from the caller's own memory, not any\nresource other people share.",- "operationId": "get_chat_starter_settings_api_settings_chat_starters_get",+ "/api/settings/document-parsing/job/cancel": {+ "post": {+ "operationId": "cancel_document_parsing_job_api_settings_document_parsing_job_cancel_post","parameters": [{"in": "header",@@ -47416,14 +49001,26 @@"description": "Validation Error"}},- "summary": "Get Chat Starter Settings",+ "summary": "Cancel Document Parsing Job","tags": ["settings"]- },- "put": {- "operationId": "update_chat_starter_settings_api_settings_chat_starters_put",+ }+ },+ "/api/settings/document-parsing/job/status": {+ "get": {+ "operationId": "document_parsing_job_status_api_settings_document_parsing_job_status_get","parameters": [+ {+ "in": "query",+ "name": "cursor",+ "required": false,+ "schema": {+ "default": 0,+ "title": "Cursor",+ "type": "integer"+ }+ },{"in": "header","name": "Authorization",@@ -47457,16 +49054,6 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/ChatStarterSettingsUpdate"- }- }- },- "required": true- },"responses": {"200": {"content": {@@ -47487,15 +49074,16 @@"description": "Validation Error"}},- "summary": "Update Chat Starter Settings",+ "summary": "Document Parsing Job Status","tags": ["settings"]}},- "/api/settings/document-parsing": {- "get": {- "operationId": "get_document_parsing_settings_api_settings_document_parsing_get",+ "/api/settings/document-parsing/models/download": {+ "post": {+ "description": "Kick off a one-click model-weight download for an engine (e.g. Docling).\n\nRuns the engine's downloader console script (``docling-tools models\ndownload``) as a background subprocess; progress is polled via the shared job\nstatus endpoint. The engine must be in ``ENGINE_MODEL_DOWNLOADERS`` and its\nscript reachable next to the server's python or on PATH.",+ "operationId": "start_document_parsing_model_download_api_settings_document_parsing_models_download_post","parameters": [{"in": "header",@@ -47530,6 +49118,16 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/DocumentParsingInstall"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -47550,13 +49148,16 @@"description": "Validation Error"}},- "summary": "Get Document Parsing Settings",+ "summary": "Start Document Parsing Model Download","tags": ["settings"]- },- "put": {- "operationId": "update_document_parsing_settings_api_settings_document_parsing_put",+ }+ },+ "/api/settings/document-parsing/test": {+ "post": {+ "description": "Readiness test for an engine. For MinerU's deeper checks (live cloud\ntoken / CLI ``--version``) the UI uses ``/mineru/test``; this generic test\ncovers engine availability + model readiness for all engines.",+ "operationId": "test_document_parsing_api_settings_document_parsing_test_post","parameters": [{"in": "header",@@ -47595,7 +49196,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/DocumentParsingUpdate"+ "$ref": "#/components/schemas/DocumentParsingTest"}}},@@ -47621,16 +49222,16 @@"description": "Validation Error"}},- "summary": "Update Document Parsing Settings",+ "summary": "Test Document Parsing","tags": ["settings"]}},- "/api/settings/document-parsing/docling/test": {+ "/api/settings/document-parsing/tika/test": {"post": {- "description": "Live connectivity check for the Docling remote-server draft values.\nPings the server health + version endpoints and returns ``ok`` + a\nhuman-readable detail. Tests draft form values so the user can verify the\nURL/key before saving; falls back to the stored key when the secret field\nis untouched.",- "operationId": "test_docling_remote_connection_api_settings_document_parsing_docling_test_post",+ "description": "Live connectivity check for the Tika server draft URL. Pings ``/version``\nso the user can verify the URL before saving.",+ "operationId": "test_tika_remote_connection_api_settings_document_parsing_tika_test_post","parameters": [{"in": "header",@@ -47669,7 +49270,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/DoclingRemoteTest"+ "$ref": "#/components/schemas/TikaRemoteTest"}}},@@ -47695,16 +49296,15 @@"description": "Validation Error"}},- "summary": "Test Docling Remote Connection",+ "summary": "Test Tika Remote Connection","tags": ["settings"]}},- "/api/settings/document-parsing/install": {- "post": {- "description": "Kick off a one-click ``pip install`` of an optional engine's package(s).\n\nReturns ``{ok, message}`` immediately; progress is polled via the shared job\nstatus endpoint. Only one job runs at a time (process-wide singleton). The\nengine must be in the install allow-list (``ENGINE_PIP_SPECS``).",- "operationId": "start_document_parsing_install_api_settings_document_parsing_install_post",+ "/api/settings/draft": {+ "delete": {+ "operationId": "discard_settings_draft_api_settings_draft_delete","parameters": [{"in": "header",@@ -47739,16 +49339,6 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/DocumentParsingInstall"- }- }- },- "required": true- },"responses": {"200": {"content": {@@ -47769,15 +49359,14 @@"description": "Validation Error"}},- "summary": "Start Document Parsing Install",+ "summary": "Discard Settings Draft","tags": ["settings"]- }- },- "/api/settings/document-parsing/job/cancel": {- "post": {- "operationId": "cancel_document_parsing_job_api_settings_document_parsing_job_cancel_post",+ },+ "get": {+ "description": "Return the unapplied draft, or nothing when there is none.\n\nThe draft is deliberately invisible to every other read path: nothing that\nresolves runtime configuration looks here, which is the whole difference\nbetween saving a draft and applying it.",+ "operationId": "get_settings_draft_api_settings_draft_get","parameters": [{"in": "header",@@ -47832,26 +49421,14 @@"description": "Validation Error"}},- "summary": "Cancel Document Parsing Job",+ "summary": "Get Settings Draft","tags": ["settings"]- }- },- "/api/settings/document-parsing/job/status": {- "get": {- "operationId": "document_parsing_job_status_api_settings_document_parsing_job_status_get",+ },+ "put": {+ "operationId": "update_settings_draft_api_settings_draft_put","parameters": [- {- "in": "query",- "name": "cursor",- "required": false,- "schema": {- "default": 0,- "title": "Cursor",- "type": "integer"- }- },{"in": "header","name": "Authorization",@@ -47885,6 +49462,16 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/SettingsDraftPayload"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -47905,16 +49492,15 @@"description": "Validation Error"}},- "summary": "Document Parsing Job Status",+ "summary": "Update Settings Draft","tags": ["settings"]}},- "/api/settings/document-parsing/models/download": {- "post": {- "description": "Kick off a one-click model-weight download for an engine (e.g. Docling).\n\nRuns the engine's downloader console script (``docling-tools models\ndownload``) as a background subprocess; progress is polled via the shared job\nstatus endpoint. The engine must be in ``ENGINE_MODEL_DOWNLOADERS`` and its\nscript reachable next to the server's python or on PATH.",- "operationId": "start_document_parsing_model_download_api_settings_document_parsing_models_download_post",+ "/api/settings/enabled-tools": {+ "put": {+ "operationId": "update_enabled_tools_api_settings_enabled_tools_put","parameters": [{"in": "header",@@ -47953,7 +49539,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/DocumentParsingInstall"+ "$ref": "#/components/schemas/EnabledToolsUpdate"}}},@@ -47979,16 +49565,16 @@"description": "Validation Error"}},- "summary": "Start Document Parsing Model Download",+ "summary": "Update Enabled Tools","tags": ["settings"]}},- "/api/settings/document-parsing/test": {+ "/api/settings/fetch-models": {"post": {- "description": "Readiness test for an engine. For MinerU's deeper checks (live cloud\ntoken / CLI ``--version``) the UI uses ``/mineru/test``; this generic test\ncovers engine availability + model readiness for all engines.",- "operationId": "test_document_parsing_api_settings_document_parsing_test_post",+ "description": "List the model IDs an OpenAI-compatible provider exposes.\n\nThin HTTP surface over ``factory.fetch_models`` so the settings UI can\npopulate a model picker from ``base_url`` + ``api_key`` instead of making\nthe user type model IDs by hand.",+ "operationId": "fetch_models_from_provider_api_settings_fetch_models_post","parameters": [{"in": "header",@@ -48027,7 +49613,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/DocumentParsingTest"+ "$ref": "#/components/schemas/FetchModelsPayload"}}},@@ -48053,16 +49639,15 @@"description": "Validation Error"}},- "summary": "Test Document Parsing",+ "summary": "Fetch Models From Provider","tags": ["settings"]}},- "/api/settings/document-parsing/tika/test": {- "post": {- "description": "Live connectivity check for the Tika server draft URL. Pings ``/version``\nso the user can verify the URL before saving.",- "operationId": "test_tika_remote_connection_api_settings_document_parsing_tika_test_post",+ "/api/settings/language": {+ "put": {+ "operationId": "update_language_api_settings_language_put","parameters": [{"in": "header",@@ -48101,7 +49686,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/TikaRemoteTest"+ "$ref": "#/components/schemas/LanguageUpdate"}}},@@ -48127,15 +49712,15 @@"description": "Validation Error"}},- "summary": "Test Tika Remote Connection",+ "summary": "Update Language","tags": ["settings"]}},- "/api/settings/draft": {- "delete": {- "operationId": "discard_settings_draft_api_settings_draft_delete",+ "/api/settings/llm-options": {+ "get": {+ "operationId": "get_llm_options_api_settings_llm_options_get","parameters": [{"in": "header",@@ -48190,14 +49775,15 @@"description": "Validation Error"}},- "summary": "Discard Settings Draft",+ "summary": "Get Llm Options","tags": ["settings"]- },+ }+ },+ "/api/settings/mcp": {"get": {- "description": "Return the unapplied draft, or nothing when there is none.\n\nThe draft is deliberately invisible to every other read path: nothing that\nresolves runtime configuration looks here, which is the whole difference\nbetween saving a draft and applying it.",- "operationId": "get_settings_draft_api_settings_draft_get",+ "operationId": "get_mcp_settings_api_settings_mcp_get","parameters": [{"in": "header",@@ -48236,7 +49822,11 @@"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": true,+ "title": "Response Get Mcp Settings Api Settings Mcp Get",+ "type": "object"+ }}},"description": "Successful Response"@@ -48252,13 +49842,13 @@"description": "Validation Error"}},- "summary": "Get Settings Draft",+ "summary": "Get Mcp Settings","tags": [- "settings"+ "mcp-settings"]},"put": {- "operationId": "update_settings_draft_api_settings_draft_put",+ "operationId": "update_mcp_settings_api_settings_mcp_put","parameters": [{"in": "header",@@ -48297,7 +49887,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/SettingsDraftPayload"+ "$ref": "#/components/schemas/MCPSettingsPayload"}}},@@ -48307,7 +49897,11 @@"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": true,+ "title": "Response Update Mcp Settings Api Settings Mcp Put",+ "type": "object"+ }}},"description": "Successful Response"@@ -48323,90 +49917,25 @@"description": "Validation Error"}},- "summary": "Update Settings Draft",+ "summary": "Update Mcp Settings","tags": [- "settings"+ "mcp-settings"]}},- "/api/settings/enabled-tools": {- "put": {- "operationId": "update_enabled_tools_api_settings_enabled_tools_put",+ "/api/settings/mcp/servers/{name}": {+ "delete": {+ "operationId": "delete_mcp_server_api_settings_mcp_servers__name__delete","parameters": [{- "in": "header",- "name": "Authorization",- "required": false,+ "in": "path",+ "name": "name",+ "required": true,"schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Authorization"+ "title": "Name",+ "type": "string"}},- {- "in": "cookie",- "name": "dt_token",- "required": false,- "schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Dt Token"- }- }- ],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/EnabledToolsUpdate"- }- }- },- "required": true- },- "responses": {- "200": {- "content": {- "application/json": {- "schema": {}- }- },- "description": "Successful Response"- },- "422": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- },- "description": "Validation Error"- }- },- "summary": "Update Enabled Tools",- "tags": [- "settings"- ]- }- },- "/api/settings/fetch-models": {- "post": {- "description": "List the model IDs an OpenAI-compatible provider exposes.\n\nThin HTTP surface over ``factory.fetch_models`` so the settings UI can\npopulate a model picker from ``base_url`` + ``api_key`` instead of making\nthe user type model IDs by hand.",- "operationId": "fetch_models_from_provider_api_settings_fetch_models_post",- "parameters": [{"in": "header","name": "Authorization",@@ -48440,21 +49969,15 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/FetchModelsPayload"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": true,+ "title": "Response Delete Mcp Server Api Settings Mcp Servers Name Delete",+ "type": "object"+ }}},"description": "Successful Response"@@ -48470,16 +49993,24 @@"description": "Validation Error"}},- "summary": "Fetch Models From Provider",+ "summary": "Delete Mcp Server","tags": [- "settings"+ "mcp-settings"]- }- },- "/api/settings/language": {+ },"put": {- "operationId": "update_language_api_settings_language_put",+ "description": "Upsert one server, leaving every other entry byte-identical.\n\nThe whole-map ``PUT`` above cannot express \"change this one\": a client has to\nsend back everything it read, so it silently drops any field it does not\nmodel (a hand-written ``disabled_tools`` blocklist) and overwrites whatever\na second administrator saved in between.",+ "operationId": "upsert_mcp_server_api_settings_mcp_servers__name__put","parameters": [+ {+ "in": "path",+ "name": "name",+ "required": true,+ "schema": {+ "title": "Name",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -48517,7 +50048,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/LanguageUpdate"+ "$ref": "#/components/schemas/MCPServerConfig"}}},@@ -48527,7 +50058,11 @@"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": true,+ "title": "Response Upsert Mcp Server Api Settings Mcp Servers Name Put",+ "type": "object"+ }}},"description": "Successful Response"@@ -48543,15 +50078,15 @@"description": "Validation Error"}},- "summary": "Update Language",+ "summary": "Upsert Mcp Server","tags": [- "settings"+ "mcp-settings"]}},- "/api/settings/llm-options": {- "get": {- "operationId": "get_llm_options_api_settings_llm_options_get",+ "/api/settings/mcp/test": {+ "post": {+ "operationId": "test_mcp_server_api_settings_mcp_test_post","parameters": [{"in": "header",@@ -48586,11 +50121,25 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/MCPServerConfig"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": true,+ "title": "Response Test Mcp Server Api Settings Mcp Test Post",+ "type": "object"+ }}},"description": "Successful Response"@@ -48606,15 +50155,15 @@"description": "Validation Error"}},- "summary": "Get Llm Options",+ "summary": "Test Mcp Server","tags": [- "settings"+ "mcp-settings"]}},- "/api/settings/mcp": {+ "/api/settings/mineru": {"get": {- "operationId": "get_mcp_settings_api_settings_mcp_get",+ "operationId": "get_mineru_settings_api_settings_mineru_get","parameters": [{"in": "header",@@ -48653,11 +50202,7 @@"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Get Mcp Settings Api Settings Mcp Get",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -48673,13 +50218,13 @@"description": "Validation Error"}},- "summary": "Get Mcp Settings",+ "summary": "Get Mineru Settings","tags": [- "mcp-settings"+ "settings"]},"put": {- "operationId": "update_mcp_settings_api_settings_mcp_put",+ "operationId": "update_mineru_settings_api_settings_mineru_put","parameters": [{"in": "header",@@ -48718,7 +50263,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/MCPSettingsPayload"+ "$ref": "#/components/schemas/MinerUSettingsUpdate"}}},@@ -48728,11 +50273,7 @@"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Update Mcp Settings Api Settings Mcp Put",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -48748,25 +50289,90 @@"description": "Validation Error"}},- "summary": "Update Mcp Settings",+ "summary": "Update Mineru Settings","tags": [- "mcp-settings"+ "settings"]}},- "/api/settings/mcp/servers/{name}": {- "delete": {- "operationId": "delete_mcp_server_api_settings_mcp_servers__name__delete",+ "/api/settings/mineru/models/download": {+ "post": {+ "description": "Kick off a one-click model download via ``mineru-models-download``.\n\nReturns ``{ok, message}`` immediately; progress is polled via the status\nendpoint. Only one download runs at a time (process-wide singleton).",+ "operationId": "start_mineru_models_download_api_settings_mineru_models_download_post","parameters": [{- "in": "path",- "name": "name",- "required": true,+ "in": "header",+ "name": "Authorization",+ "required": false,"schema": {- "title": "Name",- "type": "string"+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"}},+ {+ "in": "cookie",+ "name": "dt_token",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"+ }+ }+ ],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/MinerUModelDownloadPayload"+ }+ }+ },+ "required": true+ },+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {}+ }+ },+ "description": "Successful Response"+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "Start Mineru Models Download",+ "tags": [+ "settings"+ ]+ }+ },+ "/api/settings/mineru/models/download/cancel": {+ "post": {+ "operationId": "cancel_mineru_models_download_api_settings_mineru_models_download_cancel_post",+ "parameters": [{"in": "header","name": "Authorization",@@ -48804,11 +50410,7 @@"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Delete Mcp Server Api Settings Mcp Servers Name Delete",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -48824,22 +50426,24 @@"description": "Validation Error"}},- "summary": "Delete Mcp Server",+ "summary": "Cancel Mineru Models Download","tags": [- "mcp-settings"+ "settings"]- },- "put": {- "description": "Upsert one server, leaving every other entry byte-identical.\n\nThe whole-map ``PUT`` above cannot express \"change this one\": a client has to\nsend back everything it read, so it silently drops any field it does not\nmodel (a hand-written ``disabled_tools`` blocklist) and overwrites whatever\na second administrator saved in between.",- "operationId": "upsert_mcp_server_api_settings_mcp_servers__name__put",+ }+ },+ "/api/settings/mineru/models/download/status": {+ "get": {+ "operationId": "mineru_models_download_status_api_settings_mineru_models_download_status_get","parameters": [{- "in": "path",- "name": "name",- "required": true,+ "in": "query",+ "name": "cursor",+ "required": false,"schema": {- "title": "Name",- "type": "string"+ "default": 0,+ "title": "Cursor",+ "type": "integer"}},{@@ -48875,11 +50479,75 @@}}],+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {}+ }+ },+ "description": "Successful Response"+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "Mineru Models Download Status",+ "tags": [+ "settings"+ ]+ }+ },+ "/api/settings/mineru/test": {+ "post": {+ "description": "Validate the active backend. ``mode == \"local\"`` checks the CLI install\n(PATH probe + ``--version``); cloud mode validates the token against the\nlive MinerU API (no parse quota consumed). Tests the draft form values so\nthe user can verify before saving; falls back to the stored token when the\nsecret field is untouched.",+ "operationId": "test_mineru_connection_api_settings_mineru_test_post",+ "parameters": [+ {+ "in": "header",+ "name": "Authorization",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"+ }+ },+ {+ "in": "cookie",+ "name": "dt_token",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"+ }+ }+ ],"requestBody": {"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/MCPServerConfig"+ "$ref": "#/components/schemas/MinerUSettingsUpdate"}}},@@ -48889,11 +50557,7 @@"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Upsert Mcp Server Api Settings Mcp Servers Name Put",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -48909,15 +50573,16 @@"description": "Validation Error"}},- "summary": "Upsert Mcp Server",+ "summary": "Test Mineru Connection","tags": [- "mcp-settings"+ "settings"]}},- "/api/settings/mcp/test": {+ "/api/settings/model-capabilities": {"post": {- "operationId": "test_mcp_server_api_settings_mcp_test_post",+ "description": "What the built-in capability tables assume for one provider/model pair.\n\nThe settings UI shows these as the value \"Auto\" resolves to next to each\nper-model override, so a user can see what they are overriding.",+ "operationId": "resolve_model_capabilities_api_settings_model_capabilities_post","parameters": [{"in": "header",@@ -48956,7 +50621,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/MCPServerConfig"+ "$ref": "#/components/schemas/ModelCapabilitiesQuery"}}},@@ -48966,11 +50631,7 @@"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Test Mcp Server Api Settings Mcp Test Post",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -48986,15 +50647,15 @@"description": "Validation Error"}},- "summary": "Test Mcp Server",+ "summary": "Resolve Model Capabilities","tags": [- "mcp-settings"+ "settings"]}},- "/api/settings/mineru": {+ "/api/settings/network": {"get": {- "operationId": "get_mineru_settings_api_settings_mineru_get",+ "operationId": "get_network_settings_api_settings_network_get","parameters": [{"in": "header",@@ -49049,13 +50710,13 @@"description": "Validation Error"}},- "summary": "Get Mineru Settings",+ "summary": "Get Network Settings","tags": ["settings"]},"put": {- "operationId": "update_mineru_settings_api_settings_mineru_put",+ "operationId": "update_network_settings_api_settings_network_put","parameters": [{"in": "header",@@ -49094,7 +50755,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/MinerUSettingsUpdate"+ "$ref": "#/components/schemas/NetworkSettingsUpdate"}}},@@ -49120,16 +50781,16 @@"description": "Validation Error"}},- "summary": "Update Mineru Settings",+ "summary": "Update Network Settings","tags": ["settings"]}},- "/api/settings/mineru/models/download": {- "post": {- "description": "Kick off a one-click model download via ``mineru-models-download``.\n\nReturns ``{ok, message}`` immediately; progress is polled via the status\nendpoint. Only one download runs at a time (process-wide singleton).",- "operationId": "start_mineru_models_download_api_settings_mineru_models_download_post",+ "/api/settings/presets": {+ "get": {+ "description": "List value-free starting points for a reviewable draft.",+ "operationId": "get_settings_presets_api_settings_presets_get","parameters": [{"in": "header",@@ -49164,16 +50825,6 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/MinerUModelDownloadPayload"- }- }- },- "required": true- },"responses": {"200": {"content": {@@ -49194,16 +50845,26 @@"description": "Validation Error"}},- "summary": "Start Mineru Models Download",+ "summary": "Get Settings Presets","tags": ["settings"]}},- "/api/settings/mineru/models/download/cancel": {+ "/api/settings/presets/{preset_id}/draft": {"post": {- "operationId": "cancel_mineru_models_download_api_settings_mineru_models_download_cancel_post",+ "description": "Load a named preset into the existing draft for review.",+ "operationId": "stage_settings_preset_api_settings_presets__preset_id__draft_post","parameters": [+ {+ "in": "path",+ "name": "preset_id",+ "required": true,+ "schema": {+ "title": "Preset Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -49237,11 +50898,25 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/SettingsPresetDraftRequest"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": true,+ "title": "Response Stage Settings Preset Api Settings Presets Preset Id Draft Post",+ "type": "object"+ }}},"description": "Successful Response"@@ -49257,26 +50932,17 @@"description": "Validation Error"}},- "summary": "Cancel Mineru Models Download",+ "summary": "Stage Settings Preset","tags": ["settings"]}},- "/api/settings/mineru/models/download/status": {+ "/api/settings/profile": {"get": {- "operationId": "mineru_models_download_status_api_settings_mineru_models_download_status_get",+ "description": "Export effective settings with credentials and deployment values removed.",+ "operationId": "get_settings_profile_api_settings_profile_get","parameters": [- {- "in": "query",- "name": "cursor",- "required": false,- "schema": {- "default": 0,- "title": "Cursor",- "type": "integer"- }- },{"in": "header","name": "Authorization",@@ -49330,16 +50996,16 @@"description": "Validation Error"}},- "summary": "Mineru Models Download Status",+ "summary": "Get Settings Profile","tags": ["settings"]}},- "/api/settings/mineru/test": {+ "/api/settings/profile/diff": {"post": {- "description": "Validate the active backend. ``mode == \"local\"`` checks the CLI install\n(PATH probe + ``--version``); cloud mode validates the token against the\nlive MinerU API (no parse quota consumed). Tests the draft form values so\nthe user can verify before saving; falls back to the stored token when the\nsecret field is untouched.",- "operationId": "test_mineru_connection_api_settings_mineru_test_post",+ "description": "Review an imported profile without changing effective settings.",+ "operationId": "diff_settings_profile_api_settings_profile_diff_post","parameters": [{"in": "header",@@ -49378,7 +51044,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/MinerUSettingsUpdate"+ "$ref": "#/components/schemas/SettingsProfileImportPayload"}}},@@ -49404,16 +51070,15 @@"description": "Validation Error"}},- "summary": "Test Mineru Connection",+ "summary": "Diff Settings Profile","tags": ["settings"]}},- "/api/settings/model-capabilities": {+ "/api/settings/providers/codebuddy/auth/cancel": {"post": {- "description": "What the built-in capability tables assume for one provider/model pair.\n\nThe settings UI shows these as the value \"Auto\" resolves to next to each\nper-model override, so a user can see what they are overriding.",- "operationId": "resolve_model_capabilities_api_settings_model_capabilities_post",+ "operationId": "cancel_codebuddy_auth_api_settings_providers_codebuddy_auth_cancel_post","parameters": [{"in": "header",@@ -49448,21 +51113,15 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/ModelCapabilitiesQuery"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": true,+ "title": "Response Cancel Codebuddy Auth Api Settings Providers Codebuddy Auth Cancel Post",+ "type": "object"+ }}},"description": "Successful Response"@@ -49478,15 +51137,15 @@"description": "Validation Error"}},- "summary": "Resolve Model Capabilities",+ "summary": "Cancel Codebuddy Auth","tags": ["settings"]}},- "/api/settings/network": {- "get": {- "operationId": "get_network_settings_api_settings_network_get",+ "/api/settings/providers/codebuddy/auth/logout": {+ "post": {+ "operationId": "logout_codebuddy_auth_api_settings_providers_codebuddy_auth_logout_post","parameters": [{"in": "header",@@ -49525,7 +51184,11 @@"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": true,+ "title": "Response Logout Codebuddy Auth Api Settings Providers Codebuddy Auth Logout Post",+ "type": "object"+ }}},"description": "Successful Response"@@ -49541,13 +51204,15 @@"description": "Validation Error"}},- "summary": "Get Network Settings",+ "summary": "Logout Codebuddy Auth","tags": ["settings"]- },- "put": {- "operationId": "update_network_settings_api_settings_network_put",+ }+ },+ "/api/settings/providers/codebuddy/auth/start": {+ "post": {+ "operationId": "start_codebuddy_auth_api_settings_providers_codebuddy_auth_start_post","parameters": [{"in": "header",@@ -49582,21 +51247,15 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/NetworkSettingsUpdate"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": true,+ "title": "Response Start Codebuddy Auth Api Settings Providers Codebuddy Auth Start Post",+ "type": "object"+ }}},"description": "Successful Response"@@ -49612,16 +51271,15 @@"description": "Validation Error"}},- "summary": "Update Network Settings",+ "summary": "Start Codebuddy Auth","tags": ["settings"]}},- "/api/settings/presets": {+ "/api/settings/providers/codebuddy/auth/status": {"get": {- "description": "List value-free starting points for a reviewable draft.",- "operationId": "get_settings_presets_api_settings_presets_get",+ "operationId": "get_codebuddy_auth_status_api_settings_providers_codebuddy_auth_status_get","parameters": [{"in": "header",@@ -49660,7 +51318,11 @@"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": true,+ "title": "Response Get Codebuddy Auth Status Api Settings Providers Codebuddy Auth Status Get",+ "type": "object"+ }}},"description": "Successful Response"@@ -49676,26 +51338,16 @@"description": "Validation Error"}},- "summary": "Get Settings Presets",+ "summary": "Get Codebuddy Auth Status","tags": ["settings"]}},- "/api/settings/presets/{preset_id}/draft": {+ "/api/settings/providers/openai-codex/models/reasoning-effort": {"post": {- "description": "Load a named preset into the existing draft for review.",- "operationId": "stage_settings_preset_api_settings_presets__preset_id__draft_post",+ "operationId": "update_openai_codex_reasoning_effort_api_settings_providers_openai_codex_models_reasoning_effort_post","parameters": [- {- "in": "path",- "name": "preset_id",- "required": true,- "schema": {- "title": "Preset Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -49733,7 +51385,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/SettingsPresetDraftRequest"+ "$ref": "#/components/schemas/CodexReasoningEffortUpdate"}}},@@ -49745,7 +51397,7 @@"application/json": {"schema": {"additionalProperties": true,- "title": "Response Stage Settings Preset Api Settings Presets Preset Id Draft Post",+ "title": "Response Update Openai Codex Reasoning Effort Api Settings Providers Openai Codex Models Reasoning Effort Post","type": "object"}}@@ -49763,16 +51415,15 @@"description": "Validation Error"}},- "summary": "Stage Settings Preset",+ "summary": "Update Openai Codex Reasoning Effort","tags": ["settings"]}},- "/api/settings/profile": {- "get": {- "description": "Export effective settings with credentials and deployment values removed.",- "operationId": "get_settings_profile_api_settings_profile_get",+ "/api/settings/providers/openai-codex/models/refresh": {+ "post": {+ "operationId": "refresh_openai_codex_models_api_settings_providers_openai_codex_models_refresh_post","parameters": [{"in": "header",@@ -49811,7 +51462,11 @@"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": true,+ "title": "Response Refresh Openai Codex Models Api Settings Providers Openai Codex Models Refresh Post",+ "type": "object"+ }}},"description": "Successful Response"@@ -49827,16 +51482,83 @@"description": "Validation Error"}},- "summary": "Get Settings Profile",+ "summary": "Refresh Openai Codex Models","tags": ["settings"]}},- "/api/settings/profile/diff": {+ "/api/settings/providers/openai-codex/oauth/cancel": {"post": {- "description": "Review an imported profile without changing effective settings.",- "operationId": "diff_settings_profile_api_settings_profile_diff_post",+ "operationId": "cancel_openai_codex_oauth_api_settings_providers_openai_codex_oauth_cancel_post",+ "parameters": [+ {+ "in": "header",+ "name": "Authorization",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"+ }+ },+ {+ "in": "cookie",+ "name": "dt_token",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"+ }+ }+ ],+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {+ "additionalProperties": true,+ "title": "Response Cancel Openai Codex Oauth Api Settings Providers Openai Codex Oauth Cancel Post",+ "type": "object"+ }+ }+ },+ "description": "Successful Response"+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "Cancel Openai Codex Oauth",+ "tags": [+ "settings"+ ]+ }+ },+ "/api/settings/providers/openai-codex/oauth/complete": {+ "post": {+ "description": "Finish a waiting Codex login from a callback address the user pasted.\n\nThe provider redirects the browser to a loopback listener. In Docker that\nlistener lives in the container and the published ports do not include it,\nso the browser shows a failed page while the sign-in waits forever\n(#1252). This is the way back in without a tunnel: the address is parsed\nfor its OAuth result and discarded, and the exchange is the same one the\nlistener would have driven.",+ "operationId": "complete_openai_codex_oauth_api_settings_providers_openai_codex_oauth_complete_post","parameters": [{"in": "header",@@ -49875,7 +51597,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/SettingsProfileImportPayload"+ "$ref": "#/components/schemas/CodexOAuthCallbackPayload"}}},@@ -49885,7 +51607,11 @@"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": true,+ "title": "Response Complete Openai Codex Oauth Api Settings Providers Openai Codex Oauth Complete Post",+ "type": "object"+ }}},"description": "Successful Response"@@ -49901,15 +51627,15 @@"description": "Validation Error"}},- "summary": "Diff Settings Profile",+ "summary": "Complete Openai Codex Oauth","tags": ["settings"]}},- "/api/settings/providers/codebuddy/auth/cancel": {+ "/api/settings/providers/openai-codex/oauth/logout": {"post": {- "operationId": "cancel_codebuddy_auth_api_settings_providers_codebuddy_auth_cancel_post",+ "operationId": "logout_openai_codex_oauth_api_settings_providers_openai_codex_oauth_logout_post","parameters": [{"in": "header",@@ -49950,7 +51676,7 @@"application/json": {"schema": {"additionalProperties": true,- "title": "Response Cancel Codebuddy Auth Api Settings Providers Codebuddy Auth Cancel Post",+ "title": "Response Logout Openai Codex Oauth Api Settings Providers Openai Codex Oauth Logout Post","type": "object"}}@@ -49968,15 +51694,15 @@"description": "Validation Error"}},- "summary": "Cancel Codebuddy Auth",+ "summary": "Logout Openai Codex Oauth","tags": ["settings"]}},- "/api/settings/providers/codebuddy/auth/logout": {+ "/api/settings/providers/openai-codex/oauth/start": {"post": {- "operationId": "logout_codebuddy_auth_api_settings_providers_codebuddy_auth_logout_post",+ "operationId": "start_openai_codex_oauth_api_settings_providers_openai_codex_oauth_start_post","parameters": [{"in": "header",@@ -50017,7 +51743,7 @@"application/json": {"schema": {"additionalProperties": true,- "title": "Response Logout Codebuddy Auth Api Settings Providers Codebuddy Auth Logout Post",+ "title": "Response Start Openai Codex Oauth Api Settings Providers Openai Codex Oauth Start Post","type": "object"}}@@ -50035,15 +51761,15 @@"description": "Validation Error"}},- "summary": "Logout Codebuddy Auth",+ "summary": "Start Openai Codex Oauth","tags": ["settings"]}},- "/api/settings/providers/codebuddy/auth/start": {- "post": {- "operationId": "start_codebuddy_auth_api_settings_providers_codebuddy_auth_start_post",+ "/api/settings/providers/openai-codex/oauth/status": {+ "get": {+ "operationId": "get_openai_codex_oauth_status_api_settings_providers_openai_codex_oauth_status_get","parameters": [{"in": "header",@@ -50084,7 +51810,7 @@"application/json": {"schema": {"additionalProperties": true,- "title": "Response Start Codebuddy Auth Api Settings Providers Codebuddy Auth Start Post",+ "title": "Response Get Openai Codex Oauth Status Api Settings Providers Openai Codex Oauth Status Get","type": "object"}}@@ -50102,15 +51828,16 @@"description": "Validation Error"}},- "summary": "Start Codebuddy Auth",+ "summary": "Get Openai Codex Oauth Status","tags": ["settings"]}},- "/api/settings/providers/codebuddy/auth/status": {+ "/api/settings/readiness": {"get": {- "operationId": "get_codebuddy_auth_status_api_settings_providers_codebuddy_auth_status_get",+ "description": "Return the value-free cross-setting capability readiness matrix.",+ "operationId": "get_settings_readiness_api_settings_readiness_get","parameters": [{"in": "header",@@ -50149,11 +51876,7 @@"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Get Codebuddy Auth Status Api Settings Providers Codebuddy Auth Status Get",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -50169,15 +51892,15 @@"description": "Validation Error"}},- "summary": "Get Codebuddy Auth Status",+ "summary": "Get Settings Readiness","tags": ["settings"]}},- "/api/settings/providers/openai-codex/models/reasoning-effort": {+ "/api/settings/reset": {"post": {- "operationId": "update_openai_codex_reasoning_effort_api_settings_providers_openai_codex_models_reasoning_effort_post",+ "operationId": "reset_settings_api_settings_reset_post","parameters": [{"in": "header",@@ -50212,25 +51935,11 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/CodexReasoningEffortUpdate"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Update Openai Codex Reasoning Effort Api Settings Providers Openai Codex Models Reasoning Effort Post",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -50246,15 +51955,15 @@"description": "Validation Error"}},- "summary": "Update Openai Codex Reasoning Effort",+ "summary": "Reset Settings","tags": ["settings"]}},- "/api/settings/providers/openai-codex/models/refresh": {- "post": {- "operationId": "refresh_openai_codex_models_api_settings_providers_openai_codex_models_refresh_post",+ "/api/settings/sidebar": {+ "get": {+ "operationId": "get_sidebar_settings_api_settings_sidebar_get","parameters": [{"in": "header",@@ -50293,11 +52002,7 @@"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Refresh Openai Codex Models Api Settings Providers Openai Codex Models Refresh Post",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -50313,15 +52018,15 @@"description": "Validation Error"}},- "summary": "Refresh Openai Codex Models",+ "summary": "Get Sidebar Settings","tags": ["settings"]}},- "/api/settings/providers/openai-codex/oauth/cancel": {- "post": {- "operationId": "cancel_openai_codex_oauth_api_settings_providers_openai_codex_oauth_cancel_post",+ "/api/settings/sidebar/description": {+ "put": {+ "operationId": "update_sidebar_description_api_settings_sidebar_description_put","parameters": [{"in": "header",@@ -50356,15 +52061,21 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/SidebarDescriptionUpdate"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Cancel Openai Codex Oauth Api Settings Providers Openai Codex Oauth Cancel Post",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -50380,16 +52091,15 @@"description": "Validation Error"}},- "summary": "Cancel Openai Codex Oauth",+ "summary": "Update Sidebar Description","tags": ["settings"]}},- "/api/settings/providers/openai-codex/oauth/complete": {- "post": {- "description": "Finish a waiting Codex login from a callback address the user pasted.\n\nThe provider redirects the browser to a loopback listener. In Docker that\nlistener lives in the container and the published ports do not include it,\nso the browser shows a failed page while the sign-in waits forever\n(#1252). This is the way back in without a tunnel: the address is parsed\nfor its OAuth result and discarded, and the exchange is the same one the\nlistener would have driven.",- "operationId": "complete_openai_codex_oauth_api_settings_providers_openai_codex_oauth_complete_post",+ "/api/settings/sidebar/nav-order": {+ "put": {+ "operationId": "update_sidebar_nav_order_api_settings_sidebar_nav_order_put","parameters": [{"in": "header",@@ -50428,7 +52138,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/CodexOAuthCallbackPayload"+ "$ref": "#/components/schemas/SidebarNavOrderUpdate"}}},@@ -50438,11 +52148,7 @@"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Complete Openai Codex Oauth Api Settings Providers Openai Codex Oauth Complete Post",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -50458,15 +52164,16 @@"description": "Validation Error"}},- "summary": "Complete Openai Codex Oauth",+ "summary": "Update Sidebar Nav Order","tags": ["settings"]}},- "/api/settings/providers/openai-codex/oauth/logout": {+ "/api/settings/test-provider": {"post": {- "operationId": "logout_openai_codex_oauth_api_settings_providers_openai_codex_oauth_logout_post",+ "description": "Test current form credentials, resolving masks from draft/live settings by ID.",+ "operationId": "test_provider_connection_api_settings_test_provider_post","parameters": [{"in": "header",@@ -50501,15 +52208,21 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/ProviderProbePayload"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Logout Openai Codex Oauth Api Settings Providers Openai Codex Oauth Logout Post",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -50525,16 +52238,25 @@"description": "Validation Error"}},- "summary": "Logout Openai Codex Oauth",+ "summary": "Test Provider Connection","tags": ["settings"]}},- "/api/settings/providers/openai-codex/oauth/start": {+ "/api/settings/tests/{service}/start": {"post": {- "operationId": "start_openai_codex_oauth_api_settings_providers_openai_codex_oauth_start_post",+ "operationId": "start_service_test_api_settings_tests__service__start_post","parameters": [+ {+ "in": "path",+ "name": "service",+ "required": true,+ "schema": {+ "title": "Service",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -50568,15 +52290,28 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "anyOf": [+ {+ "$ref": "#/components/schemas/CatalogPayload"+ },+ {+ "type": "null"+ }+ ],+ "title": "Payload"+ }+ }+ }+ },"responses": {"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Start Openai Codex Oauth Api Settings Providers Openai Codex Oauth Start Post",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -50592,16 +52327,34 @@"description": "Validation Error"}},- "summary": "Start Openai Codex Oauth",+ "summary": "Start Service Test","tags": ["settings"]}},- "/api/settings/providers/openai-codex/oauth/status": {- "get": {- "operationId": "get_openai_codex_oauth_status_api_settings_providers_openai_codex_oauth_status_get",+ "/api/settings/tests/{service}/{run_id}/cancel": {+ "post": {+ "operationId": "cancel_service_test_api_settings_tests__service___run_id__cancel_post","parameters": [+ {+ "in": "path",+ "name": "service",+ "required": true,+ "schema": {+ "title": "Service",+ "type": "string"+ }+ },+ {+ "in": "path",+ "name": "run_id",+ "required": true,+ "schema": {+ "title": "Run Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -50639,11 +52392,7 @@"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Get Openai Codex Oauth Status Api Settings Providers Openai Codex Oauth Status Get",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -50659,17 +52408,34 @@"description": "Validation Error"}},- "summary": "Get Openai Codex Oauth Status",+ "summary": "Cancel Service Test","tags": ["settings"]}},- "/api/settings/readiness": {+ "/api/settings/tests/{service}/{run_id}/events": {"get": {- "description": "Return the value-free cross-setting capability readiness matrix.",- "operationId": "get_settings_readiness_api_settings_readiness_get",+ "operationId": "stream_service_test_events_api_settings_tests__service___run_id__events_get","parameters": [+ {+ "in": "path",+ "name": "service",+ "required": true,+ "schema": {+ "title": "Service",+ "type": "string"+ }+ },+ {+ "in": "path",+ "name": "run_id",+ "required": true,+ "schema": {+ "title": "Run Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -50723,15 +52489,15 @@"description": "Validation Error"}},- "summary": "Get Settings Readiness",+ "summary": "Stream Service Test Events","tags": ["settings"]}},- "/api/settings/reset": {- "post": {- "operationId": "reset_settings_api_settings_reset_post",+ "/api/settings/theme": {+ "put": {+ "operationId": "update_theme_api_settings_theme_put","parameters": [{"in": "header",@@ -50766,6 +52532,16 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/ThemeUpdate"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -50786,15 +52562,15 @@"description": "Validation Error"}},- "summary": "Reset Settings",+ "summary": "Update Theme","tags": ["settings"]}},- "/api/settings/sidebar": {+ "/api/settings/themes": {"get": {- "operationId": "get_sidebar_settings_api_settings_sidebar_get",+ "operationId": "get_themes_api_settings_themes_get","parameters": [{"in": "header",@@ -50849,15 +52625,15 @@"description": "Validation Error"}},- "summary": "Get Sidebar Settings",+ "summary": "Get Themes","tags": ["settings"]}},- "/api/settings/sidebar/description": {- "put": {- "operationId": "update_sidebar_description_api_settings_sidebar_description_put",+ "/api/settings/tour/complete": {+ "post": {+ "operationId": "complete_tour_api_settings_tour_complete_post","parameters": [{"in": "header",@@ -50896,11 +52672,18 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/SidebarDescriptionUpdate"+ "anyOf": [+ {+ "$ref": "#/components/schemas/TourCompletePayload"+ },+ {+ "type": "null"+ }+ ],+ "title": "Payload"}}- },- "required": true+ }},"responses": {"200": {@@ -50922,15 +52705,15 @@"description": "Validation Error"}},- "summary": "Update Sidebar Description",+ "summary": "Complete Tour","tags": ["settings"]}},- "/api/settings/sidebar/nav-order": {- "put": {- "operationId": "update_sidebar_nav_order_api_settings_sidebar_nav_order_put",+ "/api/settings/tour/reopen": {+ "post": {+ "operationId": "reopen_tour_api_settings_tour_reopen_post","parameters": [{"in": "header",@@ -50965,16 +52748,6 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/SidebarNavOrderUpdate"- }- }- },- "required": true- },"responses": {"200": {"content": {@@ -50995,16 +52768,15 @@"description": "Validation Error"}},- "summary": "Update Sidebar Nav Order",+ "summary": "Reopen Tour","tags": ["settings"]}},- "/api/settings/test-provider": {- "post": {- "description": "Test current form credentials, resolving masks from draft/live settings by ID.",- "operationId": "test_provider_connection_api_settings_test_provider_post",+ "/api/settings/tour/status": {+ "get": {+ "operationId": "tour_status_api_settings_tour_status_get","parameters": [{"in": "header",@@ -51039,16 +52811,6 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/ProviderProbePayload"- }- }- },- "required": true- },"responses": {"200": {"content": {@@ -51069,25 +52831,35 @@"description": "Validation Error"}},- "summary": "Test Provider Connection",+ "summary": "Tour Status","tags": ["settings"]}},- "/api/settings/tests/{service}/start": {- "post": {- "operationId": "start_service_test_api_settings_tests__service__start_post",+ "/api/settings/ui": {+ "get": {+ "description": "Return the pre-session UI preferences: theme and the two languages.\n\nPublic by design, which is why it is a narrow projection rather than the\nsaved ``ui`` blob. The app shell — and the statically prerendered auth\npages, which have no session at all — adopt the persisted languages here\nduring bootstrap. Theme rides along so those pages can paint in the right\none instead of flashing.\n\nEverything else under ``ui`` (sidebar_nav_order, enabled_optional_tools,\nchat_response_timeout, …) describes what the deployment has turned on, so\nit stays behind auth: read it from the ``ui`` key of GET /settings.",+ "operationId": "get_ui_settings_api_settings_ui_get",+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {}+ }+ },+ "description": "Successful Response"+ }+ },+ "summary": "Get Ui Settings",+ "tags": [+ "settings"+ ]+ },+ "put": {+ "description": "Merge frontend partial update into current UI settings.\n\nUses exclude_unset=True semantics so that only fields explicitly provided\nby the frontend override saved values. Fields not in the frontend payload\n(even if they equal the model defaults) are omitted from the merge.",+ "operationId": "update_ui_settings_api_settings_ui_put","parameters": [- {- "in": "path",- "name": "service",- "required": true,- "schema": {- "title": "Service",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -51125,18 +52897,11 @@"content": {"application/json": {"schema": {- "anyOf": [- {- "$ref": "#/components/schemas/CatalogPayload"- },- {- "type": "null"- }- ],- "title": "Payload"+ "$ref": "#/components/schemas/UISettingsUpdate"}}- }+ },+ "required": true},"responses": {"200": {@@ -51158,31 +52923,35 @@"description": "Validation Error"}},- "summary": "Start Service Test",+ "summary": "Update Ui Settings","tags": ["settings"]}},- "/api/settings/tests/{service}/{run_id}/cancel": {- "post": {- "operationId": "cancel_service_test_api_settings_tests__service___run_id__cancel_post",+ "/api/settings/usage": {+ "get": {+ "operationId": "get_usage_statistics_api_settings_usage_get","parameters": [{- "in": "path",- "name": "service",+ "in": "query",+ "name": "year","required": true,"schema": {- "title": "Service",- "type": "string"+ "maximum": 9998,+ "minimum": 1970,+ "title": "Year",+ "type": "integer"}},{- "in": "path",- "name": "run_id",- "required": true,+ "in": "query",+ "name": "timezone",+ "required": false,"schema": {- "title": "Run Id",+ "default": "UTC",+ "maxLength": 100,+ "title": "Timezone","type": "string"}},@@ -51223,7 +52992,9 @@"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "$ref": "#/components/schemas/UsageStatistics"+ }}},"description": "Successful Response"@@ -51239,34 +53010,16 @@"description": "Validation Error"}},- "summary": "Cancel Service Test",+ "summary": "Get Usage Statistics","tags": ["settings"]}},- "/api/settings/tests/{service}/{run_id}/events": {+ "/api/settings/video-learning": {"get": {- "operationId": "stream_service_test_events_api_settings_tests__service___run_id__events_get",+ "operationId": "get_video_learning_settings_api_settings_video_learning_get","parameters": [- {- "in": "path",- "name": "service",- "required": true,- "schema": {- "title": "Service",- "type": "string"- }- },- {- "in": "path",- "name": "run_id",- "required": true,- "schema": {- "title": "Run Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -51304,7 +53057,11 @@"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": true,+ "title": "Response Get Video Learning Settings Api Settings Video Learning Get",+ "type": "object"+ }}},"description": "Successful Response"@@ -51320,15 +53077,13 @@"description": "Validation Error"}},- "summary": "Stream Service Test Events",+ "summary": "Get Video Learning Settings","tags": [- "settings"+ "video-learning-settings"]- }- },- "/api/settings/theme": {+ },"put": {- "operationId": "update_theme_api_settings_theme_put",+ "operationId": "update_video_learning_settings_api_settings_video_learning_put","parameters": [{"in": "header",@@ -51367,7 +53122,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/ThemeUpdate"+ "$ref": "#/components/schemas/VideoLearningSettingsRequest"}}},@@ -51375,72 +53130,13 @@},"responses": {"200": {- "content": {- "application/json": {- "schema": {}- }- },- "description": "Successful Response"- },- "422": {"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- },- "description": "Validation Error"- }- },- "summary": "Update Theme",- "tags": [- "settings"- ]- }- },- "/api/settings/themes": {- "get": {- "operationId": "get_themes_api_settings_themes_get",- "parameters": [- {- "in": "header",- "name": "Authorization",- "required": false,- "schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Authorization"- }- },- {- "in": "cookie",- "name": "dt_token",- "required": false,- "schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"+ "additionalProperties": true,+ "title": "Response Update Video Learning Settings Api Settings Video Learning Put",+ "type": "object"}- ],- "title": "Dt Token"- }- }- ],- "responses": {- "200": {- "content": {- "application/json": {- "schema": {}}},"description": "Successful Response"@@ -51456,15 +53152,15 @@"description": "Validation Error"}},- "summary": "Get Themes",+ "summary": "Update Video Learning Settings","tags": [- "settings"+ "video-learning-settings"]}},- "/api/settings/tour/complete": {+ "/api/settings/video-learning/test-invidious": {"post": {- "operationId": "complete_tour_api_settings_tour_complete_post",+ "operationId": "test_invidious_api_settings_video_learning_test_invidious_post","parameters": [{"in": "header",@@ -51503,24 +53199,21 @@"content": {"application/json": {"schema": {- "anyOf": [- {- "$ref": "#/components/schemas/TourCompletePayload"- },- {- "type": "null"- }- ],- "title": "Payload"+ "$ref": "#/components/schemas/VideoLearningSettingsRequest"}}- }+ },+ "required": true},"responses": {"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": true,+ "title": "Response Test Invidious Api Settings Video Learning Test Invidious Post",+ "type": "object"+ }}},"description": "Successful Response"@@ -51536,15 +53229,16 @@"description": "Validation Error"}},- "summary": "Complete Tour",+ "summary": "Test Invidious","tags": [- "settings"+ "video-learning-settings"]}},- "/api/settings/tour/reopen": {- "post": {- "operationId": "reopen_tour_api_settings_tour_reopen_post",+ "/api/settings/voice-autoplay": {+ "put": {+ "description": "Persist the global default for auto-playing chat replies via TTS.\n\nA personal UI preference (any authenticated user); the chat surface layers\na per-session override on top of this value.",+ "operationId": "update_voice_autoplay_api_settings_voice_autoplay_put","parameters": [{"in": "header",@@ -51579,6 +53273,16 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/VoiceAutoplayUpdate"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -51599,15 +53303,16 @@"description": "Validation Error"}},- "summary": "Reopen Tour",+ "summary": "Update Voice Autoplay","tags": ["settings"]}},- "/api/settings/tour/status": {- "get": {- "operationId": "tour_status_api_settings_tour_status_get",+ "/api/settings/voice-math-speak": {+ "put": {+ "description": "Persist whether TTS verbalizes LaTeX as spoken math.\n\nA personal UI preference (any authenticated user). The voice router reads\nthis on each synthesis call; chat does not send a per-request override.\nDollar-sign delimiters are stripped even when this is off.",+ "operationId": "update_voice_math_speak_api_settings_voice_math_speak_put","parameters": [{"in": "header",@@ -51642,6 +53347,16 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/VoiceMathSpeakUpdate"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -51662,34 +53377,16 @@"description": "Validation Error"}},- "summary": "Tour Status",+ "summary": "Update Voice Math Speak","tags": ["settings"]}},- "/api/settings/ui": {- "get": {- "description": "Return the pre-session UI preferences: theme and the two languages.\n\nPublic by design, which is why it is a narrow projection rather than the\nsaved ``ui`` blob. The app shell — and the statically prerendered auth\npages, which have no session at all — adopt the persisted languages here\nduring bootstrap. Theme rides along so those pages can paint in the right\none instead of flashing.\n\nEverything else under ``ui`` (sidebar_nav_order, enabled_optional_tools,\nchat_response_timeout, …) describes what the deployment has turned on, so\nit stays behind auth: read it from the ``ui`` key of GET /settings.",- "operationId": "get_ui_settings_api_settings_ui_get",- "responses": {- "200": {- "content": {- "application/json": {- "schema": {}- }- },- "description": "Successful Response"- }- },- "summary": "Get Ui Settings",- "tags": [- "settings"- ]- },- "put": {- "description": "Merge frontend partial update into current UI settings.\n\nUses exclude_unset=True semantics so that only fields explicitly provided\nby the frontend override saved values. Fields not in the frontend payload\n(even if they equal the model defaults) are omitted from the merge.",- "operationId": "update_ui_settings_api_settings_ui_put",+ "/api/settings/voice/preview": {+ "post": {+ "description": "Audition the model being edited without saving or activating its catalog.",+ "operationId": "preview_voice_api_settings_voice_preview_post","parameters": [{"in": "header",@@ -51728,7 +53425,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/UISettingsUpdate"+ "$ref": "#/components/schemas/VoicePreviewPayload"}}},@@ -51737,9 +53434,8 @@"responses": {"200": {"content": {- "application/json": {- "schema": {}- }+ "audio/mpeg": {},+ "audio/wav": {}},"description": "Successful Response"},@@ -51754,38 +53450,81 @@"description": "Validation Error"}},- "summary": "Update Ui Settings",+ "summary": "Preview Voice","tags": ["settings"]}},- "/api/settings/usage": {+ "/api/settings/workspace": {"get": {- "operationId": "get_usage_statistics_api_settings_usage_get",+ "operationId": "get_workspace_settings_api_settings_workspace_get","parameters": [{- "in": "query",- "name": "year",- "required": true,+ "in": "header",+ "name": "Authorization",+ "required": false,"schema": {- "maximum": 9998,- "minimum": 1970,- "title": "Year",- "type": "integer"+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"}},{- "in": "query",- "name": "timezone",+ "in": "cookie",+ "name": "dt_token","required": false,"schema": {- "default": "UTC",- "maxLength": 100,- "title": "Timezone",- "type": "string"+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"}+ }+ ],+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {+ "additionalProperties": true,+ "title": "Response Get Workspace Settings Api Settings Workspace Get",+ "type": "object"+ }+ }+ },+ "description": "Successful Response"},+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "Get Workspace Settings",+ "tags": [+ "workspace-settings"+ ]+ },+ "put": {+ "operationId": "update_workspace_api_settings_workspace_put",+ "parameters": [{"in": "header","name": "Authorization",@@ -51819,12 +53558,24 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/WorkspacePathPayload"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/UsageStatistics"+ "additionalProperties": true,+ "title": "Response Update Workspace Api Settings Workspace Put",+ "type": "object"}}},@@ -51841,16 +53592,26 @@"description": "Validation Error"}},- "summary": "Get Usage Statistics",+ "summary": "Update Workspace","tags": [- "settings"+ "workspace-settings"]}},- "/api/settings/video-learning": {+ "/api/settings/workspace/data/discover": {"get": {- "operationId": "get_video_learning_settings_api_settings_video_learning_get",+ "operationId": "discover_workspace_data_api_settings_workspace_data_discover_get","parameters": [+ {+ "in": "query",+ "name": "source_workspace_id",+ "required": false,+ "schema": {+ "default": "",+ "title": "Source Workspace Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -51890,7 +53651,7 @@"application/json": {"schema": {"additionalProperties": true,- "title": "Response Get Video Learning Settings Api Settings Video Learning Get",+ "title": "Response Discover Workspace Data Api Settings Workspace Data Discover Get","type": "object"}}@@ -51908,13 +53669,15 @@"description": "Validation Error"}},- "summary": "Get Video Learning Settings",+ "summary": "Discover Workspace Data","tags": [- "video-learning-settings"+ "workspace-settings"]- },- "put": {- "operationId": "update_video_learning_settings_api_settings_video_learning_put",+ }+ },+ "/api/settings/workspace/data/export": {+ "post": {+ "operationId": "export_workspace_data_api_settings_workspace_data_export_post","parameters": [{"in": "header",@@ -51953,7 +53716,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/VideoLearningSettingsRequest"+ "$ref": "#/components/schemas/DataMigrationPayload"}}},@@ -51965,7 +53728,7 @@"application/json": {"schema": {"additionalProperties": true,- "title": "Response Update Video Learning Settings Api Settings Video Learning Put",+ "title": "Response Export Workspace Data Api Settings Workspace Data Export Post","type": "object"}}@@ -51983,16 +53746,25 @@"description": "Validation Error"}},- "summary": "Update Video Learning Settings",+ "summary": "Export Workspace Data","tags": [- "video-learning-settings"+ "workspace-settings"]}},- "/api/settings/video-learning/test-invidious": {- "post": {- "operationId": "test_invidious_api_settings_video_learning_test_invidious_post",+ "/api/settings/workspace/data/exports/{operation_id}": {+ "get": {+ "operationId": "download_workspace_export_api_settings_workspace_data_exports__operation_id__get","parameters": [+ {+ "in": "path",+ "name": "operation_id",+ "required": true,+ "schema": {+ "title": "Operation Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -52026,25 +53798,11 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/VideoLearningSettingsRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Test Invidious Api Settings Video Learning Test Invidious Post",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -52060,16 +53818,15 @@"description": "Validation Error"}},- "summary": "Test Invidious",+ "summary": "Download Workspace Export","tags": [- "video-learning-settings"+ "workspace-settings"]}},- "/api/settings/voice-autoplay": {- "put": {- "description": "Persist the global default for auto-playing chat replies via TTS.\n\nA personal UI preference (any authenticated user); the chat surface layers\na per-session override on top of this value.",- "operationId": "update_voice_autoplay_api_settings_voice_autoplay_put",+ "/api/settings/workspace/data/migrate": {+ "post": {+ "operationId": "migrate_workspace_data_api_settings_workspace_data_migrate_post","parameters": [{"in": "header",@@ -52108,7 +53865,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/VoiceAutoplayUpdate"+ "$ref": "#/components/schemas/DataMigrationPayload"}}},@@ -52118,7 +53875,11 @@"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": true,+ "title": "Response Migrate Workspace Data Api Settings Workspace Data Migrate Post",+ "type": "object"+ }}},"description": "Successful Response"@@ -52134,16 +53895,15 @@"description": "Validation Error"}},- "summary": "Update Voice Autoplay",+ "summary": "Migrate Workspace Data","tags": [- "settings"+ "workspace-settings"]}},- "/api/settings/voice-math-speak": {- "put": {- "description": "Persist whether TTS verbalizes LaTeX as spoken math.\n\nA personal UI preference (any authenticated user). The voice router reads\nthis on each synthesis call; chat does not send a per-request override.\nDollar-sign delimiters are stripped even when this is off.",- "operationId": "update_voice_math_speak_api_settings_voice_math_speak_put",+ "/api/settings/workspace/data/operations": {+ "get": {+ "operationId": "workspace_data_operations_api_settings_workspace_data_operations_get","parameters": [{"in": "header",@@ -52178,21 +53938,91 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/VoiceMathSpeakUpdate"+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {+ "additionalProperties": true,+ "title": "Response Workspace Data Operations Api Settings Workspace Data Operations Get",+ "type": "object"+ }}- }+ },+ "description": "Successful Response"},- "required": true+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }},+ "summary": "Workspace Data Operations",+ "tags": [+ "workspace-settings"+ ]+ }+ },+ "/api/settings/workspace/data/operations/{operation_id}/recover": {+ "post": {+ "operationId": "recover_workspace_migration_api_settings_workspace_data_operations__operation_id__recover_post",+ "parameters": [+ {+ "in": "path",+ "name": "operation_id",+ "required": true,+ "schema": {+ "title": "Operation Id",+ "type": "string"+ }+ },+ {+ "in": "header",+ "name": "Authorization",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"+ }+ },+ {+ "in": "cookie",+ "name": "dt_token",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"+ }+ }+ ],"responses": {"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": true,+ "title": "Response Recover Workspace Migration Api Settings Workspace Data Operations Operation Id Recover Post",+ "type": "object"+ }}},"description": "Successful Response"@@ -52208,16 +54038,15 @@"description": "Validation Error"}},- "summary": "Update Voice Math Speak",+ "summary": "Recover Workspace Migration","tags": [- "settings"+ "workspace-settings"]}},- "/api/settings/voice/preview": {+ "/api/settings/workspace/data/preview": {"post": {- "description": "Audition the model being edited without saving or activating its catalog.",- "operationId": "preview_voice_api_settings_voice_preview_post",+ "operationId": "preview_workspace_data_api_settings_workspace_data_preview_post","parameters": [{"in": "header",@@ -52256,7 +54085,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/VoicePreviewPayload"+ "$ref": "#/components/schemas/DataMigrationPayload"}}},@@ -52265,8 +54094,13 @@"responses": {"200": {"content": {- "audio/mpeg": {},- "audio/wav": {}+ "application/json": {+ "schema": {+ "additionalProperties": true,+ "title": "Response Preview Workspace Data Api Settings Workspace Data Preview Post",+ "type": "object"+ }+ }},"description": "Successful Response"},@@ -52281,15 +54115,15 @@"description": "Validation Error"}},- "summary": "Preview Voice",+ "summary": "Preview Workspace Data","tags": [- "settings"+ "workspace-settings"]}},- "/api/settings/workspace": {- "get": {- "operationId": "get_workspace_settings_api_settings_workspace_get",+ "/api/settings/workspace/knowledge-bases/move": {+ "post": {+ "operationId": "move_knowledge_base_api_settings_workspace_knowledge_bases_move_post","parameters": [{"in": "header",@@ -52324,13 +54158,23 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/KnowledgeMovePayload"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {"application/json": {"schema": {"additionalProperties": true,- "title": "Response Get Workspace Settings Api Settings Workspace Get",+ "title": "Response Move Knowledge Base Api Settings Workspace Knowledge Bases Move Post","type": "object"}}@@ -52348,13 +54192,15 @@"description": "Validation Error"}},- "summary": "Get Workspace Settings",+ "summary": "Move Knowledge Base","tags": ["workspace-settings"]- },- "put": {- "operationId": "update_workspace_api_settings_workspace_put",+ }+ },+ "/api/settings/workspace/knowledge-bases/preview-move": {+ "post": {+ "operationId": "preview_knowledge_move_api_settings_workspace_knowledge_bases_preview_move_post","parameters": [{"in": "header",@@ -52393,7 +54239,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/WorkspacePathPayload"+ "$ref": "#/components/schemas/KnowledgeMovePayload"}}},@@ -52405,7 +54251,7 @@"application/json": {"schema": {"additionalProperties": true,- "title": "Response Update Workspace Api Settings Workspace Put",+ "title": "Response Preview Knowledge Move Api Settings Workspace Knowledge Bases Preview Move Post","type": "object"}}@@ -52423,26 +54269,81 @@"description": "Validation Error"}},- "summary": "Update Workspace",+ "summary": "Preview Knowledge Move","tags": ["workspace-settings"]}},- "/api/settings/workspace/data/discover": {+ "/api/settings/workspace/registrations": {"get": {- "operationId": "discover_workspace_data_api_settings_workspace_data_discover_get",+ "operationId": "list_workspaces_api_settings_workspace_registrations_get","parameters": [{- "in": "query",- "name": "source_workspace_id",+ "in": "header",+ "name": "Authorization","required": false,"schema": {- "default": "",- "title": "Source Workspace Id",- "type": "string"+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"}},+ {+ "in": "cookie",+ "name": "dt_token",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"+ }+ }+ ],+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {+ "additionalProperties": true,+ "title": "Response List Workspaces Api Settings Workspace Registrations Get",+ "type": "object"+ }+ }+ },+ "description": "Successful Response"+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "List Workspaces",+ "tags": [+ "workspace-settings"+ ]+ },+ "post": {+ "operationId": "create_workspace_api_settings_workspace_registrations_post",+ "parameters": [{"in": "header","name": "Authorization",@@ -52476,13 +54377,23 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/CreateWorkspacePayload"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {"application/json": {"schema": {"additionalProperties": true,- "title": "Response Discover Workspace Data Api Settings Workspace Data Discover Get",+ "title": "Response Create Workspace Api Settings Workspace Registrations Post","type": "object"}}@@ -52500,15 +54411,15 @@"description": "Validation Error"}},- "summary": "Discover Workspace Data",+ "summary": "Create Workspace","tags": ["workspace-settings"]}},- "/api/settings/workspace/data/export": {+ "/api/settings/workspace/registrations/migrate-root": {"post": {- "operationId": "export_workspace_data_api_settings_workspace_data_export_post",+ "operationId": "migrate_workspace_root_api_settings_workspace_registrations_migrate_root_post","parameters": [{"in": "header",@@ -52547,7 +54458,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/DataMigrationPayload"+ "$ref": "#/components/schemas/WorkspaceMigrationPayload"}}},@@ -52559,7 +54470,7 @@"application/json": {"schema": {"additionalProperties": true,- "title": "Response Export Workspace Data Api Settings Workspace Data Export Post",+ "title": "Response Migrate Workspace Root Api Settings Workspace Registrations Migrate Root Post","type": "object"}}@@ -52577,25 +54488,16 @@"description": "Validation Error"}},- "summary": "Export Workspace Data",+ "summary": "Migrate Workspace Root","tags": ["workspace-settings"]}},- "/api/settings/workspace/data/exports/{operation_id}": {+ "/api/settings/workspace/registrations/system-snapshot": {"get": {- "operationId": "download_workspace_export_api_settings_workspace_data_exports__operation_id__get",+ "operationId": "system_workspace_snapshot_api_settings_workspace_registrations_system_snapshot_get","parameters": [- {- "in": "path",- "name": "operation_id",- "required": true,- "schema": {- "title": "Operation Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -52633,7 +54535,11 @@"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": true,+ "title": "Response System Workspace Snapshot Api Settings Workspace Registrations System Snapshot Get",+ "type": "object"+ }}},"description": "Successful Response"@@ -52649,15 +54555,13 @@"description": "Validation Error"}},- "summary": "Download Workspace Export",+ "summary": "System Workspace Snapshot","tags": ["workspace-settings"]- }- },- "/api/settings/workspace/data/migrate": {+ },"post": {- "operationId": "migrate_workspace_data_api_settings_workspace_data_migrate_post",+ "operationId": "system_workspace_snapshot_api_settings_workspace_registrations_system_snapshot_post","parameters": [{"in": "header",@@ -52692,23 +54596,13 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/DataMigrationPayload"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {"schema": {"additionalProperties": true,- "title": "Response Migrate Workspace Data Api Settings Workspace Data Migrate Post",+ "title": "Response System Workspace Snapshot Api Settings Workspace Registrations System Snapshot Post","type": "object"}}@@ -52726,16 +54620,25 @@"description": "Validation Error"}},- "summary": "Migrate Workspace Data",+ "summary": "System Workspace Snapshot","tags": ["workspace-settings"]}},- "/api/settings/workspace/data/operations": {- "get": {- "operationId": "workspace_data_operations_api_settings_workspace_data_operations_get",+ "/api/settings/workspace/registrations/{workspace_id}": {+ "patch": {+ "operationId": "update_registered_workspace_api_settings_workspace_registrations__workspace_id__patch","parameters": [+ {+ "in": "path",+ "name": "workspace_id",+ "required": true,+ "schema": {+ "title": "Workspace Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -52769,13 +54672,23 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/UpdateWorkspacePayload"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {"application/json": {"schema": {"additionalProperties": true,- "title": "Response Workspace Data Operations Api Settings Workspace Data Operations Get",+ "title": "Response Update Registered Workspace Api Settings Workspace Registrations Workspace Id Patch","type": "object"}}@@ -52793,22 +54706,22 @@"description": "Validation Error"}},- "summary": "Workspace Data Operations",+ "summary": "Update Registered Workspace","tags": ["workspace-settings"]}},- "/api/settings/workspace/data/operations/{operation_id}/recover": {+ "/api/settings/workspace/registrations/{workspace_id}/migrate": {"post": {- "operationId": "recover_workspace_migration_api_settings_workspace_data_operations__operation_id__recover_post",+ "operationId": "migrate_registered_workspace_api_settings_workspace_registrations__workspace_id__migrate_post","parameters": [{"in": "path",- "name": "operation_id",+ "name": "workspace_id","required": true,"schema": {- "title": "Operation Id",+ "title": "Workspace Id","type": "string"}},@@ -52845,13 +54758,23 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/WorkspaceMigrationPayload"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {"application/json": {"schema": {"additionalProperties": true,- "title": "Response Recover Workspace Migration Api Settings Workspace Data Operations Operation Id Recover Post",+ "title": "Response Migrate Registered Workspace Api Settings Workspace Registrations Workspace Id Migrate Post","type": "object"}}@@ -52869,16 +54792,44 @@"description": "Validation Error"}},- "summary": "Recover Workspace Migration",+ "summary": "Migrate Registered Workspace","tags": ["workspace-settings"]}},- "/api/settings/workspace/data/preview": {- "post": {- "operationId": "preview_workspace_data_api_settings_workspace_data_preview_post",+ "/api/settings/workspace/resource-usage": {+ "get": {+ "operationId": "workspace_resource_usage_api_settings_workspace_resource_usage_get","parameters": [+ {+ "in": "query",+ "name": "kind",+ "required": true,+ "schema": {+ "title": "Kind",+ "type": "string"+ }+ },+ {+ "in": "query",+ "name": "resource_id",+ "required": true,+ "schema": {+ "title": "Resource Id",+ "type": "string"+ }+ },+ {+ "in": "query",+ "name": "skill_workspace",+ "required": false,+ "schema": {+ "default": "",+ "title": "Skill Workspace",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -52912,23 +54863,13 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/DataMigrationPayload"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {"schema": {"additionalProperties": true,- "title": "Response Preview Workspace Data Api Settings Workspace Data Preview Post",+ "title": "Response Workspace Resource Usage Api Settings Workspace Resource Usage Get","type": "object"}}@@ -52946,16 +54887,26 @@"description": "Validation Error"}},- "summary": "Preview Workspace Data",+ "summary": "Workspace Resource Usage","tags": ["workspace-settings"]}},- "/api/settings/workspace/registrations": {+ "/api/settings/workspace/resources": {"get": {- "operationId": "list_workspaces_api_settings_workspace_registrations_get",+ "operationId": "workspace_resource_catalog_api_settings_workspace_resources_get","parameters": [+ {+ "in": "query",+ "name": "workspace_id",+ "required": false,+ "schema": {+ "default": "",+ "title": "Workspace Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -52995,7 +54946,7 @@"application/json": {"schema": {"additionalProperties": true,- "title": "Response List Workspaces Api Settings Workspace Registrations Get",+ "title": "Response Workspace Resource Catalog Api Settings Workspace Resources Get","type": "object"}}@@ -53013,13 +54964,15 @@"description": "Validation Error"}},- "summary": "List Workspaces",+ "summary": "Workspace Resource Catalog","tags": ["workspace-settings"]- },+ }+ },+ "/api/settings/workspace/validate": {"post": {- "operationId": "create_workspace_api_settings_workspace_registrations_post",+ "operationId": "validate_workspace_api_settings_workspace_validate_post","parameters": [{"in": "header",@@ -53058,7 +55011,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/CreateWorkspacePayload"+ "$ref": "#/components/schemas/WorkspacePathPayload"}}},@@ -53070,7 +55023,7 @@"application/json": {"schema": {"additionalProperties": true,- "title": "Response Create Workspace Api Settings Workspace Registrations Post",+ "title": "Response Validate Workspace Api Settings Workspace Validate Post","type": "object"}}@@ -53088,15 +55041,15 @@"description": "Validation Error"}},- "summary": "Create Workspace",+ "summary": "Validate Workspace","tags": ["workspace-settings"]}},- "/api/settings/workspace/registrations/migrate-root": {+ "/api/skills/create": {"post": {- "operationId": "migrate_workspace_root_api_settings_workspace_registrations_migrate_root_post",+ "operationId": "create_skill_api_skills_create_post","parameters": [{"in": "header",@@ -53135,7 +55088,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/WorkspaceMigrationPayload"+ "$ref": "#/components/schemas/CreateSkillRequest"}}},@@ -53147,7 +55100,7 @@"application/json": {"schema": {"additionalProperties": true,- "title": "Response Migrate Workspace Root Api Settings Workspace Registrations Migrate Root Post",+ "title": "Response Create Skill Api Skills Create Post","type": "object"}}@@ -53165,16 +55118,47 @@"description": "Validation Error"}},- "summary": "Migrate Workspace Root",+ "summary": "Create Skill","tags": [- "workspace-settings"+ "skills"]}},- "/api/settings/workspace/registrations/system-snapshot": {+ "/api/skills/hub/catalog": {"get": {- "operationId": "system_workspace_snapshot_api_settings_workspace_registrations_system_snapshot_get",+ "description": "Proxy a skill hub's public catalog for the in-app browser.\n\nThe web \"Import from EduHub\" panel renders these rows in DeepTutor's own\nUI — no embedded iframe, no login — so users can browse, search, and\none-click download skills. Returns ``web_url`` (the hub's site origin) so\nthe panel can offer a \"view on EduHub\" link out.",+ "operationId": "hub_catalog_api_skills_hub_catalog_get","parameters": [+ {+ "in": "query",+ "name": "hub",+ "required": false,+ "schema": {+ "default": "eduhub",+ "title": "Hub",+ "type": "string"+ }+ },+ {+ "in": "query",+ "name": "q",+ "required": false,+ "schema": {+ "default": "",+ "title": "Q",+ "type": "string"+ }+ },+ {+ "in": "query",+ "name": "limit",+ "required": false,+ "schema": {+ "default": 50,+ "title": "Limit",+ "type": "integer"+ }+ },{"in": "header","name": "Authorization",@@ -53214,7 +55198,7 @@"application/json": {"schema": {"additionalProperties": true,- "title": "Response System Workspace Snapshot Api Settings Workspace Registrations System Snapshot Get",+ "title": "Response Hub Catalog Api Skills Hub Catalog Get","type": "object"}}@@ -53232,14 +55216,36 @@"description": "Validation Error"}},- "summary": "System Workspace Snapshot",+ "summary": "Hub Catalog","tags": [- "workspace-settings"+ "skills"]- },- "post": {- "operationId": "system_workspace_snapshot_api_settings_workspace_registrations_system_snapshot_post",+ }+ },+ "/api/skills/hub/detail": {+ "get": {+ "description": "Full metadata + SKILL.md body for one hub skill (browser detail view).",+ "operationId": "hub_detail_api_skills_hub_detail_get","parameters": [+ {+ "in": "query",+ "name": "slug",+ "required": true,+ "schema": {+ "title": "Slug",+ "type": "string"+ }+ },+ {+ "in": "query",+ "name": "hub",+ "required": false,+ "schema": {+ "default": "eduhub",+ "title": "Hub",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -53279,7 +55285,7 @@"application/json": {"schema": {"additionalProperties": true,- "title": "Response System Workspace Snapshot Api Settings Workspace Registrations System Snapshot Post",+ "title": "Response Hub Detail Api Skills Hub Detail Get","type": "object"}}@@ -53297,25 +55303,17 @@"description": "Validation Error"}},- "summary": "System Workspace Snapshot",+ "summary": "Hub Detail","tags": [- "workspace-settings"+ "skills"]}},- "/api/settings/workspace/registrations/{workspace_id}": {- "patch": {- "operationId": "update_registered_workspace_api_settings_workspace_registrations__workspace_id__patch",+ "/api/skills/install": {+ "post": {+ "description": "Import a hub skill (e.g. from EduHub) into the caller's own skill layer.\n\nLands the package in the same per-user dir that ``/create`` writes to, so\nthe imported skill shows up in this user's Skills list. The install gate\n(``suspicious`` verdict abort, safe extraction, ``always`` stripping)\nlives in :func:`deeptutor.services.skill.hub.install_from_hub`.",+ "operationId": "install_skill_api_skills_install_post","parameters": [- {- "in": "path",- "name": "workspace_id",- "required": true,- "schema": {- "title": "Workspace Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -53353,7 +55351,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/UpdateWorkspacePayload"+ "$ref": "#/components/schemas/InstallSkillRequest"}}},@@ -53365,7 +55363,7 @@"application/json": {"schema": {"additionalProperties": true,- "title": "Response Update Registered Workspace Api Settings Workspace Registrations Workspace Id Patch",+ "title": "Response Install Skill Api Skills Install Post","type": "object"}}@@ -53383,25 +55381,16 @@"description": "Validation Error"}},- "summary": "Update Registered Workspace",+ "summary": "Install Skill","tags": [- "workspace-settings"+ "skills"]}},- "/api/settings/workspace/registrations/{workspace_id}/migrate": {- "post": {- "operationId": "migrate_registered_workspace_api_settings_workspace_registrations__workspace_id__migrate_post",+ "/api/skills/list": {+ "get": {+ "operationId": "list_skills_api_skills_list_get","parameters": [- {- "in": "path",- "name": "workspace_id",- "required": true,- "schema": {- "title": "Workspace Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -53435,23 +55424,19 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/WorkspaceMigrationPayload"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {"schema": {- "additionalProperties": true,- "title": "Response Migrate Registered Workspace Api Settings Workspace Registrations Workspace Id Migrate Post",+ "additionalProperties": {+ "items": {+ "additionalProperties": true,+ "type": "object"+ },+ "type": "array"+ },+ "title": "Response List Skills Api Skills List Get","type": "object"}}@@ -53469,44 +55454,16 @@"description": "Validation Error"}},- "summary": "Migrate Registered Workspace",+ "summary": "List Skills","tags": [- "workspace-settings"+ "skills"]}},- "/api/settings/workspace/resource-usage": {- "get": {- "operationId": "workspace_resource_usage_api_settings_workspace_resource_usage_get",+ "/api/skills/tags/create": {+ "post": {+ "operationId": "create_tag_api_skills_tags_create_post","parameters": [- {- "in": "query",- "name": "kind",- "required": true,- "schema": {- "title": "Kind",- "type": "string"- }- },- {- "in": "query",- "name": "resource_id",- "required": true,- "schema": {- "title": "Resource Id",- "type": "string"- }- },- {- "in": "query",- "name": "skill_workspace",- "required": false,- "schema": {- "default": "",- "title": "Skill Workspace",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -53540,13 +55497,25 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/CreateTagRequest"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {"application/json": {"schema": {- "additionalProperties": true,- "title": "Response Workspace Resource Usage Api Settings Workspace Resource Usage Get",+ "additionalProperties": {+ "type": "string"+ },+ "title": "Response Create Tag Api Skills Tags Create Post","type": "object"}}@@ -53564,26 +55533,16 @@"description": "Validation Error"}},- "summary": "Workspace Resource Usage",+ "summary": "Create Tag","tags": [- "workspace-settings"+ "skills"]}},- "/api/settings/workspace/resources": {+ "/api/skills/tags/list": {"get": {- "operationId": "workspace_resource_catalog_api_settings_workspace_resources_get",+ "operationId": "list_tags_api_skills_tags_list_get","parameters": [- {- "in": "query",- "name": "workspace_id",- "required": false,- "schema": {- "default": "",- "title": "Workspace Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -53622,8 +55581,13 @@"content": {"application/json": {"schema": {- "additionalProperties": true,- "title": "Response Workspace Resource Catalog Api Settings Workspace Resources Get",+ "additionalProperties": {+ "items": {+ "type": "string"+ },+ "type": "array"+ },+ "title": "Response List Tags Api Skills Tags List Get","type": "object"}}@@ -53641,16 +55605,25 @@"description": "Validation Error"}},- "summary": "Workspace Resource Catalog",+ "summary": "List Tags","tags": [- "workspace-settings"+ "skills"]}},- "/api/settings/workspace/validate": {- "post": {- "operationId": "validate_workspace_api_settings_workspace_validate_post",+ "/api/skills/tags/{tag}": {+ "delete": {+ "operationId": "delete_tag_api_skills_tags__tag__delete","parameters": [+ {+ "in": "path",+ "name": "tag",+ "required": true,+ "schema": {+ "title": "Tag",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -53684,23 +55657,15 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/WorkspacePathPayload"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {"schema": {- "additionalProperties": true,- "title": "Response Validate Workspace Api Settings Workspace Validate Post",+ "additionalProperties": {+ "type": "string"+ },+ "title": "Response Delete Tag Api Skills Tags Tag Delete","type": "object"}}@@ -53718,16 +55683,23 @@"description": "Validation Error"}},- "summary": "Validate Workspace",+ "summary": "Delete Tag","tags": [- "workspace-settings"+ "skills"]- }- },- "/api/skills/create": {- "post": {- "operationId": "create_skill_api_skills_create_post",+ },+ "put": {+ "operationId": "rename_tag_api_skills_tags__tag__put","parameters": [+ {+ "in": "path",+ "name": "tag",+ "required": true,+ "schema": {+ "title": "Tag",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -53765,7 +55737,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/CreateSkillRequest"+ "$ref": "#/components/schemas/RenameTagRequest"}}},@@ -53776,8 +55748,10 @@"content": {"application/json": {"schema": {- "additionalProperties": true,- "title": "Response Create Skill Api Skills Create Post",+ "additionalProperties": {+ "type": "string"+ },+ "title": "Response Rename Tag Api Skills Tags Tag Put","type": "object"}}@@ -53795,47 +55769,25 @@"description": "Validation Error"}},- "summary": "Create Skill",+ "summary": "Rename Tag","tags": ["skills"]}},- "/api/skills/hub/catalog": {- "get": {- "description": "Proxy a skill hub's public catalog for the in-app browser.\n\nThe web \"Import from EduHub\" panel renders these rows in DeepTutor's own\nUI — no embedded iframe, no login — so users can browse, search, and\none-click download skills. Returns ``web_url`` (the hub's site origin) so\nthe panel can offer a \"view on EduHub\" link out.",- "operationId": "hub_catalog_api_skills_hub_catalog_get",+ "/api/skills/{name}": {+ "delete": {+ "operationId": "delete_skill_api_skills__name__delete","parameters": [{- "in": "query",- "name": "hub",- "required": false,- "schema": {- "default": "eduhub",- "title": "Hub",- "type": "string"- }- },- {- "in": "query",- "name": "q",- "required": false,+ "in": "path",+ "name": "name",+ "required": true,"schema": {- "default": "",- "title": "Q",+ "title": "Name","type": "string"}},- {- "in": "query",- "name": "limit",- "required": false,- "schema": {- "default": 50,- "title": "Limit",- "type": "integer"- }- },{"in": "header","name": "Authorization",@@ -53874,8 +55826,10 @@"content": {"application/json": {"schema": {- "additionalProperties": true,- "title": "Response Hub Catalog Api Skills Hub Catalog Get",+ "additionalProperties": {+ "type": "string"+ },+ "title": "Response Delete Skill Api Skills Name Delete","type": "object"}}@@ -53893,33 +55847,20 @@"description": "Validation Error"}},- "summary": "Hub Catalog",+ "summary": "Delete Skill","tags": ["skills"]- }- },- "/api/skills/hub/detail": {+ },"get": {- "description": "Full metadata + SKILL.md body for one hub skill (browser detail view).",- "operationId": "hub_detail_api_skills_hub_detail_get",+ "operationId": "get_skill_api_skills__name__get","parameters": [{- "in": "query",- "name": "slug",+ "in": "path",+ "name": "name","required": true,"schema": {- "title": "Slug",- "type": "string"- }- },- {- "in": "query",- "name": "hub",- "required": false,- "schema": {- "default": "eduhub",- "title": "Hub",+ "title": "Name","type": "string"}},@@ -53962,7 +55903,7 @@"application/json": {"schema": {"additionalProperties": true,- "title": "Response Hub Detail Api Skills Hub Detail Get",+ "title": "Response Get Skill Api Skills Name Get","type": "object"}}@@ -53980,17 +55921,23 @@"description": "Validation Error"}},- "summary": "Hub Detail",+ "summary": "Get Skill","tags": ["skills"]- }- },- "/api/skills/install": {- "post": {- "description": "Import a hub skill (e.g. from EduHub) into the caller's own skill layer.\n\nLands the package in the same per-user dir that ``/create`` writes to, so\nthe imported skill shows up in this user's Skills list. The install gate\n(``suspicious`` verdict abort, safe extraction, ``always`` stripping)\nlives in :func:`deeptutor.services.skill.hub.install_from_hub`.",- "operationId": "install_skill_api_skills_install_post",+ },+ "put": {+ "operationId": "update_skill_api_skills__name__put","parameters": [+ {+ "in": "path",+ "name": "name",+ "required": true,+ "schema": {+ "title": "Name",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -54028,7 +55975,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/InstallSkillRequest"+ "$ref": "#/components/schemas/UpdateSkillRequest"}}},@@ -54040,7 +55987,7 @@"application/json": {"schema": {"additionalProperties": true,- "title": "Response Install Skill Api Skills Install Post",+ "title": "Response Update Skill Api Skills Name Put","type": "object"}}@@ -54058,15 +56005,16 @@"description": "Validation Error"}},- "summary": "Install Skill",+ "summary": "Update Skill","tags": ["skills"]}},- "/api/skills/list": {+ "/api/space/cli-apps/apps": {"get": {- "operationId": "list_skills_api_skills_list_get",+ "description": "Installed apps as *this* caller sees them.",+ "operationId": "list_apps_api_space_cli_apps_apps_get","parameters": [{"in": "header",@@ -54106,14 +56054,8 @@"content": {"application/json": {"schema": {- "additionalProperties": {- "items": {- "additionalProperties": true,- "type": "object"- },- "type": "array"- },- "title": "Response List Skills Api Skills List Get",+ "additionalProperties": true,+ "title": "Response List Apps Api Space Cli Apps Apps Get","type": "object"}}@@ -54131,16 +56073,26 @@"description": "Validation Error"}},- "summary": "List Skills",+ "summary": "List Apps","tags": [- "skills"+ "space-cli-apps"]}},- "/api/skills/tags/create": {- "post": {- "operationId": "create_tag_api_skills_tags_create_post",+ "/api/space/cli-apps/apps/{app_id}": {+ "delete": {+ "description": "Remove one app from the deployment. Administrator only.",+ "operationId": "uninstall_api_space_cli_apps_apps__app_id__delete","parameters": [+ {+ "in": "path",+ "name": "app_id",+ "required": true,+ "schema": {+ "title": "App Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -54174,25 +56126,13 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/CreateTagRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {"schema": {- "additionalProperties": {- "type": "string"- },- "title": "Response Create Tag Api Skills Tags Create Post",+ "additionalProperties": true,+ "title": "Response Uninstall Api Space Cli Apps Apps App Id Delete","type": "object"}}@@ -54210,16 +56150,26 @@"description": "Validation Error"}},- "summary": "Create Tag",+ "summary": "Uninstall","tags": [- "skills"+ "space-cli-apps"]}},- "/api/skills/tags/list": {- "get": {- "operationId": "list_tags_api_skills_tags_list_get",+ "/api/space/cli-apps/apps/{app_id}/enabled": {+ "put": {+ "description": "Switch one app on or off for the calling account.\n\nRefused for an app the caller has not been granted: the preference file must\nnot become a way to record interest in something the grant denies, because a\nlater grant would then silently switch it on.",+ "operationId": "set_enabled_api_space_cli_apps_apps__app_id__enabled_put","parameters": [+ {+ "in": "path",+ "name": "app_id",+ "required": true,+ "schema": {+ "title": "App Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -54253,18 +56203,23 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/EnabledPayload"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {"application/json": {"schema": {- "additionalProperties": {- "items": {- "type": "string"- },- "type": "array"- },- "title": "Response List Tags Api Skills Tags List Get",+ "additionalProperties": true,+ "title": "Response Set Enabled Api Space Cli Apps Apps App Id Enabled Put","type": "object"}}@@ -54282,25 +56237,67 @@"description": "Validation Error"}},- "summary": "List Tags",+ "summary": "Set Enabled","tags": [- "skills"+ "space-cli-apps"]}},- "/api/skills/tags/{tag}": {- "delete": {- "operationId": "delete_tag_api_skills_tags__tag__delete",+ "/api/space/cli-apps/catalog": {+ "get": {+ "description": "The store. Readable by anyone; installing is admin-only.",+ "operationId": "get_catalog_api_space_cli_apps_catalog_get","parameters": [{- "in": "path",- "name": "tag",- "required": true,+ "in": "query",+ "name": "q",+ "required": false,"schema": {- "title": "Tag",+ "default": "",+ "title": "Q",+ "type": "string"+ }+ },+ {+ "in": "query",+ "name": "category",+ "required": false,+ "schema": {+ "default": "",+ "title": "Category",+ "type": "string"+ }+ },+ {+ "in": "query",+ "name": "installable_only",+ "required": false,+ "schema": {+ "default": true,+ "title": "Installable Only",+ "type": "boolean"+ }+ },+ {+ "in": "query",+ "name": "cursor",+ "required": false,+ "schema": {+ "default": "",+ "title": "Cursor","type": "string"}},+ {+ "in": "query",+ "name": "limit",+ "required": false,+ "schema": {+ "default": 24,+ "title": "Limit",+ "type": "integer"+ }+ },{"in": "header","name": "Authorization",@@ -54339,10 +56336,8 @@"content": {"application/json": {"schema": {- "additionalProperties": {- "type": "string"- },- "title": "Response Delete Tag Api Skills Tags Tag Delete",+ "additionalProperties": true,+ "title": "Response Get Catalog Api Space Cli Apps Catalog Get","type": "object"}}@@ -54360,20 +56355,23 @@"description": "Validation Error"}},- "summary": "Delete Tag",+ "summary": "Get Catalog","tags": [- "skills"+ "space-cli-apps"]- },- "put": {- "operationId": "rename_tag_api_skills_tags__tag__put",+ }+ },+ "/api/space/cli-apps/catalog/{app_id}/install": {+ "post": {+ "description": "Install one app for the deployment. Administrator only.",+ "operationId": "install_api_space_cli_apps_catalog__app_id__install_post","parameters": [{"in": "path",- "name": "tag",+ "name": "app_id","required": true,"schema": {- "title": "Tag",+ "title": "App Id","type": "string"}},@@ -54410,25 +56408,13 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/RenameTagRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {"schema": {- "additionalProperties": {- "type": "string"- },- "title": "Response Rename Tag Api Skills Tags Tag Put",+ "additionalProperties": true,+ "title": "Response Install Api Space Cli Apps Catalog App Id Install Post","type": "object"}}@@ -54446,25 +56432,66 @@"description": "Validation Error"}},- "summary": "Rename Tag",+ "summary": "Install","tags": [- "skills"+ "space-cli-apps"]}},- "/api/skills/{name}": {- "delete": {- "operationId": "delete_skill_api_skills__name__delete",+ "/api/space/mcp/catalog": {+ "get": {+ "operationId": "get_catalog_api_space_mcp_catalog_get","parameters": [{- "in": "path",- "name": "name",- "required": true,+ "in": "query",+ "name": "q",+ "required": false,"schema": {- "title": "Name",+ "default": "",+ "title": "Q",+ "type": "string"+ }+ },+ {+ "in": "query",+ "name": "category",+ "required": false,+ "schema": {+ "default": "",+ "title": "Category",+ "type": "string"+ }+ },+ {+ "in": "query",+ "name": "tier",+ "required": false,+ "schema": {+ "default": "",+ "title": "Tier",+ "type": "string"+ }+ },+ {+ "in": "query",+ "name": "cursor",+ "required": false,+ "schema": {+ "default": "",+ "title": "Cursor","type": "string"}},+ {+ "in": "query",+ "name": "limit",+ "required": false,+ "schema": {+ "default": 30,+ "title": "Limit",+ "type": "integer"+ }+ },{"in": "header","name": "Authorization",@@ -54503,10 +56530,8 @@"content": {"application/json": {"schema": {- "additionalProperties": {- "type": "string"- },- "title": "Response Delete Skill Api Skills Name Delete",+ "additionalProperties": true,+ "title": "Response Get Catalog Api Space Mcp Catalog Get","type": "object"}}@@ -54524,20 +56549,22 @@"description": "Validation Error"}},- "summary": "Delete Skill",+ "summary": "Get Catalog","tags": [- "skills"+ "space-mcp"]- },- "get": {- "operationId": "get_skill_api_skills__name__get",+ }+ },+ "/api/space/mcp/catalog/{entry_id}/install": {+ "post": {+ "operationId": "install_catalog_entry_api_space_mcp_catalog__entry_id__install_post","parameters": [{"in": "path",- "name": "name",+ "name": "entry_id","required": true,"schema": {- "title": "Name",+ "title": "Entry Id","type": "string"}},@@ -54574,13 +56601,23 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/InstallPayload"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {"application/json": {"schema": {"additionalProperties": true,- "title": "Response Get Skill Api Skills Name Get",+ "title": "Response Install Catalog Entry Api Space Mcp Catalog Entry Id Install Post","type": "object"}}@@ -54598,20 +56635,54 @@"description": "Validation Error"}},- "summary": "Get Skill",+ "summary": "Install Catalog Entry","tags": [- "skills"+ "space-mcp"]- },- "put": {- "operationId": "update_skill_api_skills__name__put",+ }+ },+ "/api/space/mcp/oauth/callback": {+ "get": {+ "description": "Where the authorization server sends the browser back.\n\nDeliberately **not** returning JSON: a person is looking at this, having just\nclicked Approve on somebody else's site. It answers with a small page that\nsays what happened and closes itself.\n\nAn unknown ``state`` completes nothing — see ``complete_authorization``.",+ "operationId": "oauth_callback_api_space_mcp_oauth_callback_get","parameters": [{- "in": "path",- "name": "name",- "required": true,+ "in": "query",+ "name": "code",+ "required": false,"schema": {- "title": "Name",+ "default": "",+ "title": "Code",+ "type": "string"+ }+ },+ {+ "in": "query",+ "name": "state",+ "required": false,+ "schema": {+ "default": "",+ "title": "State",+ "type": "string"+ }+ },+ {+ "in": "query",+ "name": "error",+ "required": false,+ "schema": {+ "default": "",+ "title": "Error",+ "type": "string"+ }+ },+ {+ "in": "query",+ "name": "error_description",+ "required": false,+ "schema": {+ "default": "",+ "title": "Error Description","type": "string"}},@@ -54648,25 +56719,11 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/UpdateSkillRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Update Skill Api Skills Name Put",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -54682,16 +56739,16 @@"description": "Validation Error"}},- "summary": "Update Skill",+ "summary": "Oauth Callback","tags": [- "skills"+ "space-mcp"]}},- "/api/space/cli-apps/apps": {+ "/api/space/mcp/servers": {"get": {- "description": "Installed apps as *this* caller sees them.",- "operationId": "list_apps_api_space_cli_apps_apps_get",+ "description": "This surface's servers, in the same shape the admin registry returns.\n\n``servers`` + ``status`` deliberately mirror ``/settings/mcp`` so the two\nsurfaces share one set of frontend components instead of forking over a\nresponse shape. Everything specific to this surface is additive.",+ "operationId": "list_servers_api_space_mcp_servers_get","parameters": [{"in": "header",@@ -54732,7 +56789,7 @@"application/json": {"schema": {"additionalProperties": true,- "title": "Response List Apps Api Space Cli Apps Apps Get",+ "title": "Response List Servers Api Space Mcp Servers Get","type": "object"}}@@ -54750,23 +56807,22 @@"description": "Validation Error"}},- "summary": "List Apps",+ "summary": "List Servers","tags": [- "space-cli-apps"+ "space-mcp"]}},- "/api/space/cli-apps/apps/{app_id}": {+ "/api/space/mcp/servers/{name}": {"delete": {- "description": "Remove one app from the deployment. Administrator only.",- "operationId": "uninstall_api_space_cli_apps_apps__app_id__delete",+ "operationId": "remove_server_api_space_mcp_servers__name__delete","parameters": [{"in": "path",- "name": "app_id",+ "name": "name","required": true,"schema": {- "title": "App Id",+ "title": "Name","type": "string"}},@@ -54809,7 +56865,7 @@"application/json": {"schema": {"additionalProperties": true,- "title": "Response Uninstall Api Space Cli Apps Apps App Id Delete",+ "title": "Response Remove Server Api Space Mcp Servers Name Delete","type": "object"}}@@ -54827,23 +56883,20 @@"description": "Validation Error"}},- "summary": "Uninstall",+ "summary": "Remove Server","tags": [- "space-cli-apps"+ "space-mcp"]- }- },- "/api/space/cli-apps/apps/{app_id}/enabled": {+ },"put": {- "description": "Switch one app on or off for the calling account.\n\nRefused for an app the caller has not been granted: the preference file must\nnot become a way to record interest in something the grant denies, because a\nlater grant would then silently switch it on.",- "operationId": "set_enabled_api_space_cli_apps_apps__app_id__enabled_put",+ "operationId": "upsert_server_api_space_mcp_servers__name__put","parameters": [{"in": "path",- "name": "app_id",+ "name": "name","required": true,"schema": {- "title": "App Id",+ "title": "Name","type": "string"}},@@ -54884,7 +56937,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/EnabledPayload"+ "$ref": "#/components/schemas/ServerPayload"}}},@@ -54896,7 +56949,7 @@"application/json": {"schema": {"additionalProperties": true,- "title": "Response Set Enabled Api Space Cli Apps Apps App Id Enabled Put",+ "title": "Response Upsert Server Api Space Mcp Servers Name Put","type": "object"}}@@ -54914,67 +56967,26 @@"description": "Validation Error"}},- "summary": "Set Enabled",+ "summary": "Upsert Server","tags": [- "space-cli-apps"+ "space-mcp"]}},- "/api/space/cli-apps/catalog": {- "get": {- "description": "The store. Readable by anyone; installing is admin-only.",- "operationId": "get_catalog_api_space_cli_apps_catalog_get",+ "/api/space/mcp/servers/{name}/authorize": {+ "post": {+ "description": "Begin an OAuth consent for one of the caller's servers.\n\nReturns the URL to send the person to. This is the **only** place a flow may\nstart: a background reconnect has nobody in front of it, so it reports\n``needs_auth`` and waits for someone to click.",+ "operationId": "authorize_server_api_space_mcp_servers__name__authorize_post","parameters": [{- "in": "query",- "name": "q",- "required": false,- "schema": {- "default": "",- "title": "Q",- "type": "string"- }- },- {- "in": "query",- "name": "category",- "required": false,- "schema": {- "default": "",- "title": "Category",- "type": "string"- }- },- {- "in": "query",- "name": "installable_only",- "required": false,- "schema": {- "default": true,- "title": "Installable Only",- "type": "boolean"- }- },- {- "in": "query",- "name": "cursor",- "required": false,+ "in": "path",+ "name": "name",+ "required": true,"schema": {- "default": "",- "title": "Cursor",+ "title": "Name","type": "string"}},- {- "in": "query",- "name": "limit",- "required": false,- "schema": {- "default": 24,- "title": "Limit",- "type": "integer"- }- },{"in": "header","name": "Authorization",@@ -55014,7 +57026,7 @@"application/json": {"schema": {"additionalProperties": true,- "title": "Response Get Catalog Api Space Cli Apps Catalog Get",+ "title": "Response Authorize Server Api Space Mcp Servers Name Authorize Post","type": "object"}}@@ -55032,23 +57044,23 @@"description": "Validation Error"}},- "summary": "Get Catalog",+ "summary": "Authorize Server","tags": [- "space-cli-apps"+ "space-mcp"]}},- "/api/space/cli-apps/catalog/{app_id}/install": {+ "/api/space/mcp/servers/{name}/test": {"post": {- "description": "Install one app for the deployment. Administrator only.",- "operationId": "install_api_space_cli_apps_catalog__app_id__install_post",+ "description": "Probe a definition before saving it.\n\nRuns under the caller's own owner id so the probe obeys the same address\npolicy and redirect rule the real connection will — a Test more permissive\nthan the connection it previews is worse than no Test at all.\n\nDeliberately side-effect free: nothing is written, so the incoming config is\nprobed as given (any literal credential in it is used in memory only). That\nalso means a caller may probe under a scratch name the store would refuse,\nwhich is how the UI tests a draft before it has one.",+ "operationId": "test_server_api_space_mcp_servers__name__test_post","parameters": [{"in": "path",- "name": "app_id",+ "name": "name","required": true,"schema": {- "title": "App Id",+ "title": "Name","type": "string"}},@@ -55085,13 +57097,23 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/ServerPayload"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {"application/json": {"schema": {"additionalProperties": true,- "title": "Response Install Api Space Cli Apps Catalog App Id Install Post",+ "title": "Response Test Server Api Space Mcp Servers Name Test Post","type": "object"}}@@ -55109,66 +57131,17 @@"description": "Validation Error"}},- "summary": "Install",+ "summary": "Test Server","tags": [- "space-cli-apps"+ "space-mcp"]}},- "/api/space/mcp/catalog": {+ "/api/subagents/backends/options": {"get": {- "operationId": "get_catalog_api_space_mcp_catalog_get",+ "description": "Synced model + reasoning-effort options per backend (settings page sync).",+ "operationId": "backend_options_api_subagents_backends_options_get","parameters": [- {- "in": "query",- "name": "q",- "required": false,- "schema": {- "default": "",- "title": "Q",- "type": "string"- }- },- {- "in": "query",- "name": "category",- "required": false,- "schema": {- "default": "",- "title": "Category",- "type": "string"- }- },- {- "in": "query",- "name": "tier",- "required": false,- "schema": {- "default": "",- "title": "Tier",- "type": "string"- }- },- {- "in": "query",- "name": "cursor",- "required": false,- "schema": {- "default": "",- "title": "Cursor",- "type": "string"- }- },- {- "in": "query",- "name": "limit",- "required": false,- "schema": {- "default": 30,- "title": "Limit",- "type": "integer"- }- },{"in": "header","name": "Authorization",@@ -55206,11 +57179,7 @@"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Get Catalog Api Space Mcp Catalog Get",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -55226,22 +57195,23 @@"description": "Validation Error"}},- "summary": "Get Catalog",+ "summary": "Backend Options","tags": [- "space-mcp"+ "subagents"]}},- "/api/space/mcp/catalog/{entry_id}/install": {+ "/api/subagents/backends/{kind}/sync": {"post": {- "operationId": "install_catalog_entry_api_space_mcp_catalog__entry_id__install_post",+ "description": "Re-pull one backend's model catalog (the settings \"sync\" button).\n\nFor Claude Code this scrapes its ``/model`` TUI live and caches the result;\nfor Codex it re-reads the CLI-maintained cache.",+ "operationId": "sync_backend_api_subagents_backends__kind__sync_post","parameters": [{"in": "path",- "name": "entry_id",+ "name": "kind","required": true,"schema": {- "title": "Entry Id",+ "title": "Kind","type": "string"}},@@ -55278,25 +57248,11 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/InstallPayload"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Install Catalog Entry Api Space Mcp Catalog Entry Id Install Post",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -55312,57 +57268,17 @@"description": "Validation Error"}},- "summary": "Install Catalog Entry",+ "summary": "Sync Backend","tags": [- "space-mcp"+ "subagents"]}},- "/api/space/mcp/oauth/callback": {+ "/api/subagents/connections": {"get": {- "description": "Where the authorization server sends the browser back.\n\nDeliberately **not** returning JSON: a person is looking at this, having just\nclicked Approve on somebody else's site. It answers with a small page that\nsays what happened and closes itself.\n\nAn unknown ``state`` completes nothing — see ``complete_authorization``.",- "operationId": "oauth_callback_api_space_mcp_oauth_callback_get",+ "description": "List the current user's connected subagents.",+ "operationId": "list_connections_api_subagents_connections_get","parameters": [- {- "in": "query",- "name": "code",- "required": false,- "schema": {- "default": "",- "title": "Code",- "type": "string"- }- },- {- "in": "query",- "name": "state",- "required": false,- "schema": {- "default": "",- "title": "State",- "type": "string"- }- },- {- "in": "query",- "name": "error",- "required": false,- "schema": {- "default": "",- "title": "Error",- "type": "string"- }- },- {- "in": "query",- "name": "error_description",- "required": false,- "schema": {- "default": "",- "title": "Error Description",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -55416,16 +57332,14 @@"description": "Validation Error"}},- "summary": "Oauth Callback",+ "summary": "List Connections","tags": [- "space-mcp"+ "subagents"]- }- },- "/api/space/mcp/servers": {- "get": {- "description": "This surface's servers, in the same shape the admin registry returns.\n\n``servers`` + ``status`` deliberately mirror ``/settings/mcp`` so the two\nsurfaces share one set of frontend components instead of forking over a\nresponse shape. Everything specific to this surface is additive.",- "operationId": "list_servers_api_space_mcp_servers_get",+ },+ "post": {+ "description": "Connect a local or remote subagent as a selectable KB.",+ "operationId": "create_connection_api_subagents_connections_post","parameters": [{"in": "header",@@ -55460,15 +57374,21 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/ConnectSubagentRequest"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response List Servers Api Space Mcp Servers Get",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -55484,15 +57404,16 @@"description": "Validation Error"}},- "summary": "List Servers",+ "summary": "Create Connection","tags": [- "space-mcp"+ "subagents"]}},- "/api/space/mcp/servers/{name}": {+ "/api/subagents/connections/{name}": {"delete": {- "operationId": "remove_server_api_space_mcp_servers__name__delete",+ "description": "Disconnect a subagent (removes the pointer KB; touches no files).",+ "operationId": "delete_connection_api_subagents_connections__name__delete","parameters": [{"in": "path",@@ -55540,11 +57461,7 @@"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Remove Server Api Space Mcp Servers Name Delete",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -55560,13 +57477,16 @@"description": "Validation Error"}},- "summary": "Remove Server",+ "summary": "Delete Connection","tags": [- "space-mcp"+ "subagents"]- },- "put": {- "operationId": "upsert_server_api_space_mcp_servers__name__put",+ }+ },+ "/api/subagents/connections/{name}/message": {+ "post": {+ "description": "Send a message straight to a connected subagent and stream its run.\n\nThis is the sidebar's \"talk to the agent directly\" path: it resumes the same\nlive session DeepTutor consults (shared via the cross-turn registry, keyed by\nchat session + connection), so the agent keeps full context. Streams the\nnative run as newline-delimited JSON, in the same channel shape the chat WS\nuses, so the sidebar transcript renders it identically.",+ "operationId": "message_connection_api_subagents_connections__name__message_post","parameters": [{"in": "path",@@ -55614,7 +57534,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/ServerPayload"+ "$ref": "#/components/schemas/SubagentMessageRequest"}}},@@ -55624,11 +57544,7 @@"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Upsert Server Api Space Mcp Servers Name Put",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -55644,26 +57560,17 @@"description": "Validation Error"}},- "summary": "Upsert Server",+ "summary": "Message Connection","tags": [- "space-mcp"+ "subagents"]}},- "/api/space/mcp/servers/{name}/authorize": {- "post": {- "description": "Begin an OAuth consent for one of the caller's servers.\n\nReturns the URL to send the person to. This is the **only** place a flow may\nstart: a background reconnect has nobody in front of it, so it reports\n``needs_auth`` and waits for someone to click.",- "operationId": "authorize_server_api_space_mcp_servers__name__authorize_post",+ "/api/subagents/detect": {+ "get": {+ "description": "Report which local and remote agent backends are usable.",+ "operationId": "detect_subagents_api_subagents_detect_get","parameters": [- {- "in": "path",- "name": "name",- "required": true,- "schema": {- "title": "Name",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -55701,11 +57608,7 @@"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Authorize Server Api Space Mcp Servers Name Authorize Post",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -55721,26 +57624,17 @@"description": "Validation Error"}},- "summary": "Authorize Server",+ "summary": "Detect Subagents","tags": [- "space-mcp"+ "subagents"]}},- "/api/space/mcp/servers/{name}/test": {- "post": {- "description": "Probe a definition before saving it.\n\nRuns under the caller's own owner id so the probe obeys the same address\npolicy and redirect rule the real connection will — a Test more permissive\nthan the connection it previews is worse than no Test at all.\n\nDeliberately side-effect free: nothing is written, so the incoming config is\nprobed as given (any literal credential in it is used in memory only). That\nalso means a caller may probe under a scratch name the store would refuse,\nwhich is how the UI tests a draft before it has one.",- "operationId": "test_server_api_space_mcp_servers__name__test_post",+ "/api/subagents/settings": {+ "get": {+ "description": "Read the consult budget and per-backend run config.",+ "operationId": "get_settings_api_subagents_settings_get","parameters": [- {- "in": "path",- "name": "name",- "required": true,- "schema": {- "title": "Name",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -55774,25 +57668,11 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/ServerPayload"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Test Server Api Space Mcp Servers Name Test Post",- "type": "object"- }+ "schema": {}}},"description": "Successful Response"@@ -55808,16 +57688,14 @@"description": "Validation Error"}},- "summary": "Test Server",+ "summary": "Get Settings","tags": [- "space-mcp"+ "subagents"]- }- },- "/api/subagents/backends/options": {- "get": {- "description": "Synced model + reasoning-effort options per backend (settings page sync).",- "operationId": "backend_options_api_subagents_backends_options_get",+ },+ "put": {+ "description": "Update the subagent settings (admin-gated; deployment-wide).",+ "operationId": "update_settings_api_subagents_settings_put","parameters": [{"in": "header",@@ -55852,6 +57730,16 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/SubagentSettingsPayload"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {@@ -55872,26 +57760,17 @@"description": "Validation Error"}},- "summary": "Backend Options",+ "summary": "Update Settings","tags": ["subagents"]}},- "/api/subagents/backends/{kind}/sync": {- "post": {- "description": "Re-pull one backend's model catalog (the settings \"sync\" button).\n\nFor Claude Code this scrapes its ``/model`` TUI live and caches the result;\nfor Codex it re-reads the CLI-maintained cache.",- "operationId": "sync_backend_api_subagents_backends__kind__sync_post",+ "/api/system/memory": {+ "get": {+ "description": "Resident memory of the running DeepTutor process tree.\n\nDeliberately separate from ``/status``: that snapshot resolves the LLM,\nembedding and search configs and is fetched once per settings mount, while\nthis one is cheap enough for the status strip to poll.\n\nAdmin-only, for the same reason ``/status`` strips model names from\nnon-admins — process composition and host memory are operational detail a\ntenant has no need for.",+ "operationId": "get_memory_usage_api_system_memory_get","parameters": [- {- "in": "path",- "name": "kind",- "required": true,- "schema": {- "title": "Kind",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -55945,16 +57824,16 @@"description": "Validation Error"}},- "summary": "Sync Backend",+ "summary": "Get Memory Usage","tags": [- "subagents"+ "system"]}},- "/api/subagents/connections": {+ "/api/system/runtime": {"get": {- "description": "List the current user's connected subagents.",- "operationId": "list_connections_api_subagents_connections_get",+ "description": "Return credential-free coordination and worker diagnostics.",+ "operationId": "get_runtime_status_api_system_runtime_get","parameters": [{"in": "header",@@ -55993,7 +57872,9 @@"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "$ref": "#/components/schemas/RuntimeStatus"+ }}},"description": "Successful Response"@@ -56009,14 +57890,16 @@"description": "Validation Error"}},- "summary": "List Connections",+ "summary": "Get Runtime Status","tags": [- "subagents"+ "system"]- },- "post": {- "description": "Connect a local or remote subagent as a selectable KB.",- "operationId": "create_connection_api_subagents_connections_post",+ }+ },+ "/api/system/status": {+ "get": {+ "description": "Get overall system status including backend and model configurations\n\nReturns:\n Dictionary containing status of backend, LLM, embeddings, and search",+ "operationId": "get_system_status_api_system_status_get","parameters": [{"in": "header",@@ -56051,16 +57934,6 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/ConnectSubagentRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {@@ -56081,26 +57954,17 @@"description": "Validation Error"}},- "summary": "Create Connection",+ "summary": "Get System Status","tags": [- "subagents"+ "system"]}},- "/api/subagents/connections/{name}": {- "delete": {- "description": "Disconnect a subagent (removes the pointer KB; touches no files).",- "operationId": "delete_connection_api_subagents_connections__name__delete",+ "/api/system/test/embeddings": {+ "post": {+ "description": "Test Embeddings model connection by sending a simple embedding request\n\nReturns:\n Test result with success status and response time",+ "operationId": "test_embeddings_connection_api_system_test_embeddings_post","parameters": [- {- "in": "path",- "name": "name",- "required": true,- "schema": {- "title": "Name",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -56138,7 +58002,9 @@"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "$ref": "#/components/schemas/TestResponse"+ }}},"description": "Successful Response"@@ -56154,26 +58020,17 @@"description": "Validation Error"}},- "summary": "Delete Connection",+ "summary": "Test Embeddings Connection","tags": [- "subagents"+ "system"]}},- "/api/subagents/connections/{name}/message": {+ "/api/system/test/llm": {"post": {- "description": "Send a message straight to a connected subagent and stream its run.\n\nThis is the sidebar's \"talk to the agent directly\" path: it resumes the same\nlive session DeepTutor consults (shared via the cross-turn registry, keyed by\nchat session + connection), so the agent keeps full context. Streams the\nnative run as newline-delimited JSON, in the same channel shape the chat WS\nuses, so the sidebar transcript renders it identically.",- "operationId": "message_connection_api_subagents_connections__name__message_post",+ "description": "Test LLM model connection by sending a simple completion request\n\nReturns:\n Test result with success status and response time",+ "operationId": "test_llm_connection_api_system_test_llm_post","parameters": [- {- "in": "path",- "name": "name",- "required": true,- "schema": {- "title": "Name",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -56207,21 +58064,13 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/SubagentMessageRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "$ref": "#/components/schemas/TestResponse"+ }}},"description": "Successful Response"@@ -56237,16 +58086,15 @@"description": "Validation Error"}},- "summary": "Message Connection",+ "summary": "Test Llm Connection","tags": [- "subagents"+ "system"]}},- "/api/subagents/detect": {- "get": {- "description": "Report which local and remote agent backends are usable.",- "operationId": "detect_subagents_api_subagents_detect_get",+ "/api/system/test/search": {+ "post": {+ "operationId": "test_search_connection_api_system_test_search_post","parameters": [{"in": "header",@@ -56285,7 +58133,9 @@"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "$ref": "#/components/schemas/TestResponse"+ }}},"description": "Successful Response"@@ -56301,16 +58151,16 @@"description": "Validation Error"}},- "summary": "Detect Subagents",+ "summary": "Test Search Connection","tags": [- "subagents"+ "system"]}},- "/api/subagents/settings": {+ "/api/system/update": {"get": {- "description": "Read the consult budget and per-backend run config.",- "operationId": "get_settings_api_subagents_settings_get",+ "description": "Return About-page version state, checking at most once per 24 hours.",+ "operationId": "get_update_status_api_system_update_get","parameters": [{"in": "header",@@ -56349,7 +58199,11 @@"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": true,+ "title": "Response Get Update Status Api System Update Get",+ "type": "object"+ }}},"description": "Successful Response"@@ -56365,14 +58219,14 @@"description": "Validation Error"}},- "summary": "Get Settings",+ "summary": "Get Update Status","tags": [- "subagents"+ "system"]},- "put": {- "description": "Update the subagent settings (admin-gated; deployment-wide).",- "operationId": "update_settings_api_subagents_settings_put",+ "post": {+ "description": "Reserve one safe update for the supervising launcher to apply.",+ "operationId": "request_managed_update_api_system_update_post","parameters": [{"in": "header",@@ -56411,81 +58265,21 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/SubagentSettingsPayload"+ "$ref": "#/components/schemas/ManagedUpdateRequest"}}},"required": true},"responses": {- "200": {- "content": {- "application/json": {- "schema": {}- }- },- "description": "Successful Response"- },- "422": {+ "202": {"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- },- "description": "Validation Error"- }- },- "summary": "Update Settings",- "tags": [- "subagents"- ]- }- },- "/api/system/memory": {- "get": {- "description": "Resident memory of the running DeepTutor process tree.\n\nDeliberately separate from ``/status``: that snapshot resolves the LLM,\nembedding and search configs and is fetched once per settings mount, while\nthis one is cheap enough for the status strip to poll.\n\nAdmin-only, for the same reason ``/status`` strips model names from\nnon-admins — process composition and host memory are operational detail a\ntenant has no need for.",- "operationId": "get_memory_usage_api_system_memory_get",- "parameters": [- {- "in": "header",- "name": "Authorization",- "required": false,- "schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Authorization"- }- },- {- "in": "cookie",- "name": "dt_token",- "required": false,- "schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"+ "additionalProperties": true,+ "title": "Response Request Managed Update Api System Update Post",+ "type": "object"}- ],- "title": "Dt Token"- }- }- ],- "responses": {- "200": {- "content": {- "application/json": {- "schema": {}}},"description": "Successful Response"@@ -56501,16 +58295,16 @@"description": "Validation Error"}},- "summary": "Get Memory Usage",+ "summary": "Request Managed Update","tags": ["system"]}},- "/api/system/runtime": {- "get": {- "description": "Return credential-free coordination and worker diagnostics.",- "operationId": "get_runtime_status_api_system_runtime_get",+ "/api/system/update/check": {+ "post": {+ "description": "Perform an explicit administrator-requested release check.",+ "operationId": "check_for_update_api_system_update_check_post","parameters": [{"in": "header",@@ -56550,7 +58344,9 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/RuntimeStatus"+ "additionalProperties": true,+ "title": "Response Check For Update Api System Update Check Post",+ "type": "object"}}},@@ -56567,16 +58363,15 @@"description": "Validation Error"}},- "summary": "Get Runtime Status",+ "summary": "Check For Update","tags": ["system"]}},- "/api/system/status": {+ "/api/system/update/job": {"get": {- "description": "Get overall system status including backend and model configurations\n\nReturns:\n Dictionary containing status of backend, LLM, embeddings, and search",- "operationId": "get_system_status_api_system_status_get",+ "operationId": "get_update_job_api_system_update_job_get","parameters": [{"in": "header",@@ -56615,7 +58410,18 @@"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "anyOf": [+ {+ "additionalProperties": true,+ "type": "object"+ },+ {+ "type": "null"+ }+ ],+ "title": "Response Get Update Job Api System Update Job Get"+ }}},"description": "Successful Response"@@ -56631,16 +58437,15 @@"description": "Validation Error"}},- "summary": "Get System Status",+ "summary": "Get Update Job","tags": ["system"]}},- "/api/system/test/embeddings": {- "post": {- "description": "Test Embeddings model connection by sending a simple embedding request\n\nReturns:\n Test result with success status and response time",- "operationId": "test_embeddings_connection_api_system_test_embeddings_post",+ "/api/system/update/settings": {+ "put": {+ "operationId": "update_check_settings_api_system_update_settings_put","parameters": [{"in": "header",@@ -56675,12 +58480,24 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/UpdateSettingsRequest"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/TestResponse"+ "additionalProperties": true,+ "title": "Response Update Check Settings Api System Update Settings Put",+ "type": "object"}}},@@ -56697,16 +58514,16 @@"description": "Validation Error"}},- "summary": "Test Embeddings Connection",+ "summary": "Update Check Settings","tags": ["system"]}},- "/api/system/test/llm": {- "post": {- "description": "Test LLM model connection by sending a simple completion request\n\nReturns:\n Test result with success status and response time",- "operationId": "test_llm_connection_api_system_test_llm_post",+ "/api/task-board": {+ "get": {+ "description": "Return active and archived cards in the current workspace.",+ "operationId": "get_board_api_task_board_get","parameters": [{"in": "header",@@ -56746,7 +58563,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/TestResponse"+ "$ref": "#/components/schemas/TaskBoard"}}},@@ -56763,15 +58580,16 @@"description": "Validation Error"}},- "summary": "Test Llm Connection",+ "summary": "Get Board","tags": [- "system"+ "task-board"]}},- "/api/system/test/search": {+ "/api/task-board/cards": {"post": {- "operationId": "test_search_connection_api_system_test_search_post",+ "description": "Create a task in the To do column.",+ "operationId": "create_card_api_task_board_cards_post","parameters": [{"in": "header",@@ -56806,12 +58624,22 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/CreateCard"+ }+ }+ },+ "required": true+ },"responses": {- "200": {+ "201": {"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/TestResponse"+ "$ref": "#/components/schemas/TaskBoard"}}},@@ -56828,17 +58656,26 @@"description": "Validation Error"}},- "summary": "Test Search Connection",+ "summary": "Create Card","tags": [- "system"+ "task-board"]}},- "/api/system/update": {- "get": {- "description": "Return About-page version state, checking at most once per 24 hours.",- "operationId": "get_update_status_api_system_update_get",+ "/api/task-board/cards/{card_id}": {+ "patch": {+ "description": "Edit, move, archive or restore an existing task.",+ "operationId": "update_card_api_task_board_cards__card_id__patch","parameters": [+ {+ "in": "path",+ "name": "card_id",+ "required": true,+ "schema": {+ "title": "Card Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -56872,14 +58709,22 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/UpdateCard"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {"application/json": {"schema": {- "additionalProperties": true,- "title": "Response Get Update Status Api System Update Get",- "type": "object"+ "$ref": "#/components/schemas/TaskBoard"}}},@@ -56896,14 +58741,16 @@"description": "Validation Error"}},- "summary": "Get Update Status",+ "summary": "Update Card","tags": [- "system"+ "task-board"]- },- "post": {- "description": "Reserve one safe update for the supervising launcher to apply.",- "operationId": "request_managed_update_api_system_update_post",+ }+ },+ "/api/tools": {+ "get": {+ "description": "Return all built-in tools the chat agent can invoke, plus any\ncoming-soon placeholders for the settings page.",+ "operationId": "list_builtin_tools_api_tools_get","parameters": [{"in": "header",@@ -56938,24 +58785,12 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/ManagedUpdateRequest"- }- }- },- "required": true- },"responses": {- "202": {+ "200": {"content": {"application/json": {"schema": {- "additionalProperties": true,- "title": "Response Request Managed Update Api System Update Post",- "type": "object"+ "$ref": "#/components/schemas/ToolsListResponse"}}},@@ -56972,16 +58807,15 @@"description": "Validation Error"}},- "summary": "Request Managed Update",+ "summary": "List Builtin Tools","tags": [- "system"+ "tools"]}},- "/api/system/update/check": {+ "/api/video-learning/invidious/account/authorize": {"post": {- "description": "Perform an explicit administrator-requested release check.",- "operationId": "check_for_update_api_system_update_check_post",+ "operationId": "authorize_invidious_account_api_video_learning_invidious_account_authorize_post","parameters": [{"in": "header",@@ -57021,8 +58855,10 @@"content": {"application/json": {"schema": {- "additionalProperties": true,- "title": "Response Check For Update Api System Update Check Post",+ "additionalProperties": {+ "type": "string"+ },+ "title": "Response Authorize Invidious Account Api Video Learning Invidious Account Authorize Post","type": "object"}}@@ -57040,16 +58876,36 @@"description": "Validation Error"}},- "summary": "Check For Update",+ "summary": "Authorize Invidious Account","tags": [- "system"+ "video-learning"]}},- "/api/system/update/job": {+ "/api/video-learning/invidious/account/callback": {"get": {- "operationId": "get_update_job_api_system_update_job_get",+ "operationId": "invidious_account_callback_api_video_learning_invidious_account_callback_get","parameters": [+ {+ "in": "query",+ "name": "token",+ "required": false,+ "schema": {+ "default": "",+ "title": "Token",+ "type": "string"+ }+ },+ {+ "in": "query",+ "name": "state",+ "required": false,+ "schema": {+ "default": "",+ "title": "State",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -57087,18 +58943,7 @@"200": {"content": {"application/json": {- "schema": {- "anyOf": [- {- "additionalProperties": true,- "type": "object"- },- {- "type": "null"- }- ],- "title": "Response Get Update Job Api System Update Job Get"- }+ "schema": {}}},"description": "Successful Response"@@ -57114,15 +58959,15 @@"description": "Validation Error"}},- "summary": "Get Update Job",+ "summary": "Invidious Account Callback","tags": [- "system"+ "video-learning"]}},- "/api/system/update/settings": {- "put": {- "operationId": "update_check_settings_api_system_update_settings_put",+ "/api/video-learning/invidious/account/disconnect": {+ "post": {+ "operationId": "disconnect_invidious_account_api_video_learning_invidious_account_disconnect_post","parameters": [{"in": "header",@@ -57157,23 +59002,13 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/UpdateSettingsRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {"schema": {"additionalProperties": true,- "title": "Response Update Check Settings Api System Update Settings Put",+ "title": "Response Disconnect Invidious Account Api Video Learning Invidious Account Disconnect Post","type": "object"}}@@ -57191,16 +59026,15 @@"description": "Validation Error"}},- "summary": "Update Check Settings",+ "summary": "Disconnect Invidious Account","tags": [- "system"+ "video-learning"]}},- "/api/task-board": {+ "/api/video-learning/invidious/account/status": {"get": {- "description": "Return active and archived cards in the current workspace.",- "operationId": "get_board_api_task_board_get",+ "operationId": "get_invidious_account_status_api_video_learning_invidious_account_status_get","parameters": [{"in": "header",@@ -57240,7 +59074,9 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/TaskBoard"+ "additionalProperties": true,+ "title": "Response Get Invidious Account Status Api Video Learning Invidious Account Status Get",+ "type": "object"}}},@@ -57257,17 +59093,59 @@"description": "Validation Error"}},- "summary": "Get Board",+ "summary": "Get Invidious Account Status","tags": [- "task-board"+ "video-learning"]}},- "/api/task-board/cards": {- "post": {- "description": "Create a task in the To do column.",- "operationId": "create_card_api_task_board_cards_post",+ "/api/video-learning/invidious/browse/{kind}": {+ "get": {+ "operationId": "browse_invidious_api_video_learning_invidious_browse__kind__get","parameters": [+ {+ "in": "path",+ "name": "kind",+ "required": true,+ "schema": {+ "title": "Kind",+ "type": "string"+ }+ },+ {+ "in": "query",+ "name": "q",+ "required": false,+ "schema": {+ "default": "",+ "maxLength": 500,+ "title": "Q",+ "type": "string"+ }+ },+ {+ "in": "query",+ "name": "page",+ "required": false,+ "schema": {+ "default": 1,+ "maximum": 1000,+ "minimum": 1,+ "title": "Page",+ "type": "integer"+ }+ },+ {+ "in": "query",+ "name": "playlist_id",+ "required": false,+ "schema": {+ "default": "",+ "maxLength": 100,+ "title": "Playlist Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -57301,23 +59179,11 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/CreateCard"- }- }- },- "required": true- },"responses": {- "201": {+ "200": {"content": {"application/json": {- "schema": {- "$ref": "#/components/schemas/TaskBoard"- }+ "schema": {}}},"description": "Successful Response"@@ -57333,26 +59199,16 @@"description": "Validation Error"}},- "summary": "Create Card",+ "summary": "Browse Invidious","tags": [- "task-board"+ "video-learning"]}},- "/api/task-board/cards/{card_id}": {- "patch": {- "description": "Edit, move, archive or restore an existing task.",- "operationId": "update_card_api_task_board_cards__card_id__patch",+ "/api/video-learning/materials/resolve": {+ "post": {+ "operationId": "resolve_video_api_video_learning_materials_resolve_post","parameters": [- {- "in": "path",- "name": "card_id",- "required": true,- "schema": {- "title": "Card Id",- "type": "string"- }- },{"in": "header","name": "Authorization",@@ -57390,7 +59246,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/UpdateCard"+ "$ref": "#/components/schemas/ResolveRequest"}}},@@ -57401,7 +59257,9 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/TaskBoard"+ "additionalProperties": true,+ "title": "Response Resolve Video Api Video Learning Materials Resolve Post",+ "type": "object"}}},@@ -57418,17 +59276,25 @@"description": "Validation Error"}},- "summary": "Update Card",+ "summary": "Resolve Video","tags": [- "task-board"+ "video-learning"]}},- "/api/tools": {+ "/api/video-learning/materials/{material_id}": {"get": {- "description": "Return all built-in tools the chat agent can invoke, plus any\ncoming-soon placeholders for the settings page.",- "operationId": "list_builtin_tools_api_tools_get",+ "operationId": "get_video_material_api_video_learning_materials__material_id__get","parameters": [+ {+ "in": "path",+ "name": "material_id",+ "required": true,+ "schema": {+ "title": "Material Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -57467,7 +59333,9 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/ToolsListResponse"+ "additionalProperties": true,+ "title": "Response Get Video Material Api Video Learning Materials Material Id Get",+ "type": "object"}}},@@ -57484,16 +59352,25 @@"description": "Validation Error"}},- "summary": "List Builtin Tools",+ "summary": "Get Video Material","tags": [- "tools"+ "video-learning"]}},- "/api/video-learning/invidious/account/authorize": {+ "/api/video-learning/materials/{material_id}/mark-suggestions": {"post": {- "operationId": "authorize_invidious_account_api_video_learning_invidious_account_authorize_post",+ "operationId": "suggest_video_marks_api_video_learning_materials__material_id__mark_suggestions_post","parameters": [+ {+ "in": "path",+ "name": "material_id",+ "required": true,+ "schema": {+ "title": "Material Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -57527,15 +59404,23 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/MarkSuggestionRequest"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {"application/json": {"schema": {- "additionalProperties": {- "type": "string"- },- "title": "Response Authorize Invidious Account Api Video Learning Invidious Account Authorize Post",+ "additionalProperties": true,+ "title": "Response Suggest Video Marks Api Video Learning Materials Material Id Mark Suggestions Post","type": "object"}}@@ -57553,33 +59438,22 @@"description": "Validation Error"}},- "summary": "Authorize Invidious Account",+ "summary": "Suggest Video Marks","tags": ["video-learning"]}},- "/api/video-learning/invidious/account/callback": {+ "/api/video-learning/materials/{material_id}/marks": {"get": {- "operationId": "invidious_account_callback_api_video_learning_invidious_account_callback_get",+ "operationId": "list_video_marks_api_video_learning_materials__material_id__marks_get","parameters": [{- "in": "query",- "name": "token",- "required": false,- "schema": {- "default": "",- "title": "Token",- "type": "string"- }- },- {- "in": "query",- "name": "state",- "required": false,+ "in": "path",+ "name": "material_id",+ "required": true,"schema": {- "default": "",- "title": "State",+ "title": "Material Id","type": "string"}},@@ -57620,7 +59494,14 @@"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "items": {+ "additionalProperties": true,+ "type": "object"+ },+ "title": "Response List Video Marks Api Video Learning Materials Material Id Marks Get",+ "type": "array"+ }}},"description": "Successful Response"@@ -57636,83 +59517,23 @@"description": "Validation Error"}},- "summary": "Invidious Account Callback",+ "summary": "List Video Marks","tags": ["video-learning"]- }- },- "/api/video-learning/invidious/account/disconnect": {+ },"post": {- "operationId": "disconnect_invidious_account_api_video_learning_invidious_account_disconnect_post",+ "operationId": "create_video_mark_api_video_learning_materials__material_id__marks_post","parameters": [{- "in": "header",- "name": "Authorization",- "required": false,+ "in": "path",+ "name": "material_id",+ "required": true,"schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Authorization"+ "title": "Material Id",+ "type": "string"}},- {- "in": "cookie",- "name": "dt_token",- "required": false,- "schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Dt Token"- }- }- ],- "responses": {- "200": {- "content": {- "application/json": {- "schema": {- "additionalProperties": true,- "title": "Response Disconnect Invidious Account Api Video Learning Invidious Account Disconnect Post",- "type": "object"- }- }- },- "description": "Successful Response"- },- "422": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- },- "description": "Validation Error"- }- },- "summary": "Disconnect Invidious Account",- "tags": [- "video-learning"- ]- }- },- "/api/video-learning/invidious/account/status": {- "get": {- "operationId": "get_invidious_account_status_api_video_learning_invidious_account_status_get",- "parameters": [{"in": "header","name": "Authorization",@@ -57746,13 +59567,23 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/MarkCreateRequest"+ }+ }+ },+ "required": true+ },"responses": {- "200": {+ "201": {"content": {"application/json": {"schema": {"additionalProperties": true,- "title": "Response Get Invidious Account Status Api Video Learning Invidious Account Status Get",+ "title": "Response Create Video Mark Api Video Learning Materials Material Id Marks Post","type": "object"}}@@ -57770,56 +59601,31 @@"description": "Validation Error"}},- "summary": "Get Invidious Account Status",+ "summary": "Create Video Mark","tags": ["video-learning"]}},- "/api/video-learning/invidious/browse/{kind}": {- "get": {- "operationId": "browse_invidious_api_video_learning_invidious_browse__kind__get",+ "/api/video-learning/materials/{material_id}/marks/{mark_id}": {+ "delete": {+ "operationId": "delete_video_mark_api_video_learning_materials__material_id__marks__mark_id__delete","parameters": [{"in": "path",- "name": "kind",+ "name": "material_id","required": true,"schema": {- "title": "Kind",- "type": "string"- }- },- {- "in": "query",- "name": "q",- "required": false,- "schema": {- "default": "",- "maxLength": 500,- "title": "Q",+ "title": "Material Id","type": "string"}},{- "in": "query",- "name": "page",- "required": false,- "schema": {- "default": 1,- "maximum": 1000,- "minimum": 1,- "title": "Page",- "type": "integer"- }- },- {- "in": "query",- "name": "playlist_id",- "required": false,+ "in": "path",+ "name": "mark_id",+ "required": true,"schema": {- "default": "",- "maxLength": 100,- "title": "Playlist Id",+ "title": "Mark Id","type": "string"}},@@ -57860,7 +59666,13 @@"200": {"content": {"application/json": {- "schema": {}+ "schema": {+ "additionalProperties": {+ "type": "boolean"+ },+ "title": "Response Delete Video Mark Api Video Learning Materials Material Id Marks Mark Id Delete",+ "type": "object"+ }}},"description": "Successful Response"@@ -57876,16 +59688,32 @@"description": "Validation Error"}},- "summary": "Browse Invidious",+ "summary": "Delete Video Mark","tags": ["video-learning"]- }- },- "/api/video-learning/materials/resolve": {- "post": {- "operationId": "resolve_video_api_video_learning_materials_resolve_post",+ },+ "get": {+ "operationId": "get_video_mark_api_video_learning_materials__material_id__marks__mark_id__get","parameters": [+ {+ "in": "path",+ "name": "material_id",+ "required": true,+ "schema": {+ "title": "Material Id",+ "type": "string"+ }+ },+ {+ "in": "path",+ "name": "mark_id",+ "required": true,+ "schema": {+ "title": "Mark Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -57919,23 +59747,13 @@}}],- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/ResolveRequest"- }- }- },- "required": true- },"responses": {"200": {"content": {"application/json": {"schema": {"additionalProperties": true,- "title": "Response Resolve Video Api Video Learning Materials Resolve Post",+ "title": "Response Get Video Mark Api Video Learning Materials Material Id Marks Mark Id Get","type": "object"}}@@ -57953,15 +59771,13 @@"description": "Validation Error"}},- "summary": "Resolve Video",+ "summary": "Get Video Mark","tags": ["video-learning"]- }- },- "/api/video-learning/materials/{material_id}": {- "get": {- "operationId": "get_video_material_api_video_learning_materials__material_id__get",+ },+ "patch": {+ "operationId": "update_video_mark_api_video_learning_materials__material_id__marks__mark_id__patch","parameters": [{"in": "path",@@ -57972,6 +59788,15 @@"type": "string"}},+ {+ "in": "path",+ "name": "mark_id",+ "required": true,+ "schema": {+ "title": "Mark Id",+ "type": "string"+ }+ },{"in": "header","name": "Authorization",@@ -58005,13 +59830,23 @@}}],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/MarkPatchRequest"+ }+ }+ },+ "required": true+ },"responses": {"200": {"content": {"application/json": {"schema": {"additionalProperties": true,- "title": "Response Get Video Material Api Video Learning Materials Material Id Get",+ "title": "Response Update Video Mark Api Video Learning Materials Material Id Marks Mark Id Patch","type": "object"}}@@ -58029,7 +59864,7 @@"description": "Validation Error"}},- "summary": "Get Video Material",+ "summary": "Update Video Mark","tags": ["video-learning"]