{ "openapi": "3.1.0", "info": { "title": "Eternego", "version": "0.1.0" }, "paths": { "/api/config/providers": { "get": { "summary": "Get Provider Config", "operationId": "get_provider_config_api_config_providers_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/personas": { "get": { "summary": "List Personas", "operationId": "list_personas_api_personas_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/persona/create": { "post": { "summary": "Create Persona", "operationId": "create_persona_api_persona_create_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PersonaCreateRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/persona/migrate": { "post": { "summary": "Migrate Persona", "operationId": "migrate_persona_api_persona_migrate_post", "requestBody": { "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/Body_migrate_persona_api_persona_migrate_post" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/persona/{persona_id}/diagnose": { "get": { "summary": "Diagnose Persona", "operationId": "diagnose_persona_api_persona__persona_id__diagnose_get", "parameters": [ { "name": "persona_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Persona Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/persona/{persona_id}/update": { "post": { "summary": "Update Persona", "operationId": "update_persona_api_persona__persona_id__update_post", "parameters": [ { "name": "persona_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Persona Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Request" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/persona/{persona_id}/conversation": { "get": { "summary": "Get Conversation", "operationId": "get_conversation_api_persona__persona_id__conversation_get", "parameters": [ { "name": "persona_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Persona Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/persona/{persona_id}/knowledge": { "get": { "summary": "Get Knowledge", "operationId": "get_knowledge_api_persona__persona_id__knowledge_get", "parameters": [ { "name": "persona_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Persona Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/persona/{persona_id}/calendar": { "get": { "summary": "Get Calendar", "operationId": "get_calendar_api_persona__persona_id__calendar_get", "parameters": [ { "name": "persona_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Persona Id" } }, { "name": "start", "in": "query", "required": true, "schema": { "type": "string", "title": "Start" } }, { "name": "end", "in": "query", "required": true, "schema": { "type": "string", "title": "End" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/persona/{persona_id}/media/{filename}": { "get": { "summary": "Persona Media", "operationId": "persona_media_api_persona__persona_id__media__filename__get", "parameters": [ { "name": "persona_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Persona Id" } }, { "name": "filename", "in": "path", "required": true, "schema": { "type": "string", "title": "Filename" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/persona/{persona_id}/sleep": { "post": { "summary": "Sleep Persona", "operationId": "sleep_persona_api_persona__persona_id__sleep_post", "parameters": [ { "name": "persona_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Persona Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/persona/{persona_id}/read": { "post": { "summary": "Read Persona", "operationId": "read_persona_api_persona__persona_id__read_post", "parameters": [ { "name": "persona_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Persona Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReadRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/persona/{persona_id}/attach": { "post": { "summary": "Attach To Persona", "description": "Single ingress for any attached file. Routes by extension to the\nbusiness spec that claims it (`see` for images, `hear` for audio). New\nfile types land here too \u2014 Phase 2 adds a `research` spec for documents.\n\n`/hear` stays separate for live mic recordings \u2014 same business function\non the backend, but the HTTP-layer distinction preserves the difference\nbetween \"she heard me speak just now\" and \"she received an audio file\".", "operationId": "attach_to_persona_api_persona__persona_id__attach_post", "parameters": [ { "name": "persona_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Persona Id" } } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/Body_attach_to_persona_api_persona__persona_id__attach_post" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/persona/{persona_id}/hear": { "post": { "summary": "Hear Persona", "operationId": "hear_persona_api_persona__persona_id__hear_post", "parameters": [ { "name": "persona_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Persona Id" } } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/Body_hear_persona_api_persona__persona_id__hear_post" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/persona/{persona_id}/feed": { "post": { "summary": "Feed Persona", "operationId": "feed_persona_api_persona__persona_id__feed_post", "parameters": [ { "name": "persona_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Persona Id" } } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/Body_feed_persona_api_persona__persona_id__feed_post" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/persona/{persona_id}/pair": { "post": { "summary": "Pair Persona", "operationId": "pair_persona_api_persona__persona_id__pair_post", "parameters": [ { "name": "persona_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Persona Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PairRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/persona/{persona_id}/channels": { "post": { "summary": "Add Channel", "description": "Add a new channel (telegram/discord) to a running persona.\nBody: {kind: 'telegram'|'discord', credentials: {token: '...'}}.\nValidates the token, appends the channel to persona.channels, saves,\nand restarts the daemon to pick up the new gateway.", "operationId": "add_channel_api_persona__persona_id__channels_post", "parameters": [ { "name": "persona_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Persona Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Request" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/persona/{persona_id}/channels/{channel_name}": { "delete": { "summary": "Remove Channel", "operationId": "remove_channel_api_persona__persona_id__channels__channel_name__delete", "parameters": [ { "name": "persona_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Persona Id" } }, { "name": "channel_name", "in": "path", "required": true, "schema": { "type": "string", "title": "Channel Name" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/persona/{persona_id}/start": { "post": { "summary": "Start Persona", "operationId": "start_persona_api_persona__persona_id__start_post", "parameters": [ { "name": "persona_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Persona Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/persona/{persona_id}/stop": { "post": { "summary": "Stop Persona", "operationId": "stop_persona_api_persona__persona_id__stop_post", "parameters": [ { "name": "persona_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Persona Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/persona/{persona_id}/restart": { "post": { "summary": "Restart Persona", "operationId": "restart_persona_api_persona__persona_id__restart_post", "parameters": [ { "name": "persona_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Persona Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/persona/{persona_id}/export": { "get": { "summary": "Export Persona", "operationId": "export_persona_api_persona__persona_id__export_get", "parameters": [ { "name": "persona_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Persona Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/persona/{persona_id}/delete": { "post": { "summary": "Delete Persona", "operationId": "delete_persona_api_persona__persona_id__delete_post", "parameters": [ { "name": "persona_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Persona Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/": { "get": { "summary": "Root", "operationId": "root__get", "responses": { "200": { "description": "Successful Response", "content": { "text/html": { "schema": { "type": "string" } } } } } } }, "/{full_path}": { "get": { "summary": "Spa", "description": "Catch-all for SPA paths (/persona/{id}, /setup, /persona/{id}/inner, \u2026).\n\nAPI and static paths are matched by their own routers/mounts before this\none runs, so reaching here means the URL is meant for the SPA.", "operationId": "spa__full_path__get", "parameters": [ { "name": "full_path", "in": "path", "required": true, "schema": { "type": "string", "title": "Full Path" } } ], "responses": { "200": { "description": "Successful Response", "content": { "text/html": { "schema": { "type": "string" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } } }, "components": { "schemas": { "Body_attach_to_persona_api_persona__persona_id__attach_post": { "properties": { "file": { "type": "string", "contentMediaType": "application/octet-stream", "title": "File" }, "caption": { "type": "string", "title": "Caption", "default": "" } }, "type": "object", "required": [ "file" ], "title": "Body_attach_to_persona_api_persona__persona_id__attach_post" }, "Body_feed_persona_api_persona__persona_id__feed_post": { "properties": { "history": { "type": "string", "contentMediaType": "application/octet-stream", "title": "History" }, "source": { "type": "string", "title": "Source" } }, "type": "object", "required": [ "history", "source" ], "title": "Body_feed_persona_api_persona__persona_id__feed_post" }, "Body_hear_persona_api_persona__persona_id__hear_post": { "properties": { "audio": { "type": "string", "contentMediaType": "application/octet-stream", "title": "Audio" }, "caption": { "type": "string", "title": "Caption", "default": "" } }, "type": "object", "required": [ "audio" ], "title": "Body_hear_persona_api_persona__persona_id__hear_post" }, "Body_migrate_persona_api_persona_migrate_post": { "properties": { "diary": { "type": "string", "contentMediaType": "application/octet-stream", "title": "Diary" }, "phrase": { "type": "string", "title": "Phrase" }, "model": { "type": "string", "title": "Model" }, "provider": { "type": "string", "title": "Provider" }, "api_key": { "type": "string", "title": "Api Key" }, "url": { "type": "string", "title": "Url" }, "imagination_model": { "type": "string", "title": "Imagination Model" }, "imagination_provider": { "type": "string", "title": "Imagination Provider" }, "imagination_api_key": { "type": "string", "title": "Imagination Api Key" }, "imagination_url": { "type": "string", "title": "Imagination Url" }, "mouth_model": { "type": "string", "title": "Mouth Model" }, "mouth_provider": { "type": "string", "title": "Mouth Provider" }, "mouth_api_key": { "type": "string", "title": "Mouth Api Key" }, "mouth_url": { "type": "string", "title": "Mouth Url" }, "eye_model": { "type": "string", "title": "Eye Model" }, "eye_provider": { "type": "string", "title": "Eye Provider" }, "eye_api_key": { "type": "string", "title": "Eye Api Key" }, "eye_url": { "type": "string", "title": "Eye Url" }, "ear_model": { "type": "string", "title": "Ear Model" }, "ear_provider": { "type": "string", "title": "Ear Provider" }, "ear_api_key": { "type": "string", "title": "Ear Api Key" }, "ear_url": { "type": "string", "title": "Ear Url" }, "teacher_model": { "type": "string", "title": "Teacher Model" }, "teacher_provider": { "type": "string", "title": "Teacher Provider" }, "teacher_api_key": { "type": "string", "title": "Teacher Api Key" }, "teacher_url": { "type": "string", "title": "Teacher Url" }, "researcher_model": { "type": "string", "title": "Researcher Model" }, "researcher_provider": { "type": "string", "title": "Researcher Provider" }, "researcher_api_key": { "type": "string", "title": "Researcher Api Key" }, "researcher_url": { "type": "string", "title": "Researcher Url" }, "telegram_token": { "type": "string", "title": "Telegram Token" }, "discord_token": { "type": "string", "title": "Discord Token" } }, "type": "object", "required": [ "diary", "phrase", "model" ], "title": "Body_migrate_persona_api_persona_migrate_post" }, "HTTPValidationError": { "properties": { "detail": { "items": { "$ref": "#/components/schemas/ValidationError" }, "type": "array", "title": "Detail" } }, "type": "object", "title": "HTTPValidationError" }, "PairRequest": { "properties": { "code": { "type": "string", "title": "Code" } }, "type": "object", "required": [ "code" ], "title": "PairRequest" }, "PersonaCreateRequest": { "properties": { "name": { "type": "string", "title": "Name" }, "thinking_model": { "type": "string", "title": "Thinking Model" }, "thinking_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Thinking Url" }, "thinking_provider": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Thinking Provider" }, "thinking_api_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Thinking Api Key" }, "imagination_model": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Imagination Model" }, "imagination_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Imagination Url" }, "imagination_provider": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Imagination Provider" }, "imagination_api_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Imagination Api Key" }, "mouth_model": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Mouth Model" }, "mouth_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Mouth Url" }, "mouth_provider": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Mouth Provider" }, "mouth_api_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Mouth Api Key" }, "eye_model": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Eye Model" }, "eye_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Eye Url" }, "eye_provider": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Eye Provider" }, "eye_api_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Eye Api Key" }, "ear_model": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Ear Model" }, "ear_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Ear Url" }, "ear_provider": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Ear Provider" }, "ear_api_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Ear Api Key" }, "teacher_model": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Teacher Model" }, "teacher_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Teacher Url" }, "teacher_provider": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Teacher Provider" }, "teacher_api_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Teacher Api Key" }, "researcher_model": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Researcher Model" }, "researcher_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Researcher Url" }, "researcher_provider": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Researcher Provider" }, "researcher_api_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Researcher Api Key" }, "telegram_token": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Telegram Token" }, "discord_token": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Discord Token" } }, "type": "object", "required": [ "name", "thinking_model" ], "title": "PersonaCreateRequest" }, "ReadRequest": { "properties": { "message": { "type": "string", "title": "Message" } }, "type": "object", "required": [ "message" ], "title": "ReadRequest" }, "ValidationError": { "properties": { "loc": { "items": { "anyOf": [ { "type": "string" }, { "type": "integer" } ] }, "type": "array", "title": "Location" }, "msg": { "type": "string", "title": "Message" }, "type": { "type": "string", "title": "Error Type" }, "input": { "title": "Input" }, "ctx": { "type": "object", "title": "Context" } }, "type": "object", "required": [ "loc", "msg", "type" ], "title": "ValidationError" } } } }