* refactor(config): make [embedding] and [rerank] soft dependencies
Make [embedding] and [rerank] soft runtime dependencies so a
freshly-onboarded user can run EverOS end-to-end with only [llm]
configured. Previously the server refused to start without embedding,
locking out anyone who just wanted keyword-only search.
## Capability tiers
- Tier 1 ([llm] only) KEYWORD search, add/flush, md
writes, cascade sync
- Tier 2 ([llm] + [embedding]) + VECTOR / HYBRID search,
reflection, skill extraction,
backfill
- Tier 3 ([llm] + [embedding] + rerank) + AGENTIC search, knowledge
Tier upgrades require a server restart (capability accessors cache
for the process lifetime). Tier downgrades are read-safe: a Tier-3
user who drops [rerank] can still read/rename/delete existing
knowledge documents; only write/search endpoints return 422.
## What changed
- Component accessors — component/{embedding,rerank,llm}/accessor.py
are the single process-wide provider singletons. service/* never
maintains parallel singletons; it consumes get_embedding_capability()
/ get_rerank_capability() / get_llm_client() directly. Build-time
ValueError from the factory is logged as capability_build_failed
(was silently swallowed).
- Error mapping — ProviderNotConfiguredError -> 422 with everos.toml
section hints (never EVEROS_* env-var strings).
LanceDBMigrationError fails loud with escalating recovery guidance
(restart -> wipe index). LLMNotConfiguredError in search maps to
None for KEYWORD degradation.
- Nullable-vector LanceDB migration — schema v2 makes the vector
column nullable so Tier-1 rows can land without embeddings.
Migration is guarded by a cross-process memory_root_lock
(fcntl.flock + anyio.to_thread) and runs optimize() per table
after Phase-1 backfill to reclaim manifest bloat.
- Cascade — knowledge handlers register unconditionally (Tier-3 ->
Tier-2/1 downgrade no longer strands DELETE); embed-requiring
strategies use body-guards that check capability.available at
execution time. _TABLE_SPECS has an import-time drift assertion
against BUSINESS_SCHEMAS_WITH_VECTOR.
- `everos cascade backfill` CLI — Phase-1 (embed missing vectors) /
Phase-2 (emit synthetic events for cascaded processing) / Phase-3
(sync new skill files). Exit codes: 0 / 1 / 2 / 3 (server running
preflight) / 4 (COMPLETED_WITH_FAILURES — per-row failures rolled
up) / 130 (SIGINT). OMEConfig.crash_recovery_enabled=False in
backfill engines prevents stale-RUNNING rows re-enqueuing into a
smaller strategy registry.
- /health — reports capabilities + disabled_features per tier so ops
can distinguish "boots but degraded" from "boots and full".
- Presentation split — memory / service / infra never import typer /
click. TyperPresenter Protocol + run_backfill() live in
entrypoints/cli/commands/_backfill_cmd.py. Enforced by
import-linter.
- Startup hint — unconditional count_rows(filter="vector IS NULL")
sweep emits unbackfilled_memory_rows (event name + hint text
pinned) when Tier-1 rows exist. ParserLifespanProvider warms the
everalgo.parser import at boot so /health doesn't block on first
call.
- Knowledge upload UTF-8 short-circuit — _looks_like_utf8_text()
routes text/* mime and known plaintext extensions (md/txt/rst)
straight to UTF-8 decode instead of the parser. Prevents 503
Multimodal-not-configured when Tier 3 sans [multimodal] uploads a
markdown doc.
## Sync history with main (2 merges collapsed into this squash)
Merged origin/main at 6dcd3eb (v1.1.4 -> v1.2.0 adds OTel tracing,
/api/v2 alias, TracingLifespanProvider, per-cascade-embedding span
fix, memory-op instrumentation) and later at 42629df (PR #366
backfills v1.1.4 CWE-22 knowledge path traversal fix + cascade
retry-budget rework + errors.py -> core.errors.ExternalServiceError).
Key merge decisions:
- service/search.py adopts single wrap site — component.llm accessor
already applies UsageRecordingClient when observability is on;
service layer never keeps a parallel LLM singleton (Round-1 CR
rule: "service layer never maintains parallel singletons").
- Knowledge router prefix moved to /knowledge; create_app() mounts
it under both /api/v1 and /api/v2.
- Cascade retry classification uses ExternalServiceError from
core.errors (cascade/errors.py deleted). _MAX_TOTAL_RETRIES=12
cross-cycle budget preserved.
- Fixed backport typo: MemoryRoot.default() -> MemoryRoot.resolve()
(no .default() classmethod exists — main PR #366 shipped a broken
call).
## Verified layering
$ git grep -l "^import typer\|^from typer" src/everos/{memory,service,infra}
# empty
$ git grep -l "^import click\|^from click" src/everos/{memory,service,infra}
# empty
Memory / service / infra layers clean of CLI presentation libraries.
## Review history
Three rounds of Fable 5 (opus) code review across the pre-squash
commit history closed 38 findings total:
- Round 1: 10 findings (fail-loud migration, backfill hardening,
knowledge router gate scoping, SearchManager guards, profile
throttle lift)
- Round 2: 13 findings (hermetic test env, hot-reload doc drift,
knowledge handler registration, Phase 3 sync guarantee, Phase 2
idempotency, profile event-first path, OMEConfig crash-recovery
gate, cross-process migration lock, batch embed per-row fallback,
LanceDB optimize, typer/click layer split)
- Round 3: 15 Minor cleanups (accessor unification, marker revert,
episode query hygiene, --verbose subcommand, parser lifespan warm,
task-number scrub, temporal-overlap test, real-SIGINT slow mark,
4 design-note back-references)
Full per-round context lives in the PR description on GitHub.
## Test plan
- make lint (ruff + import-linter 3 contracts + assets +
deprecated-names + github-docs + datetime + OpenAPI drift)
- Hermetic env full pytest — 2027 passed / 7 deselected (7 = slow +
live_llm markers)
- Manual e2e across Tier 1/2/3 (21/21 assertions across v1/v2
double-mount and Tier 3 -> Tier 2 downgrade)
- /health reports correct capabilities + disabled_features per tier
## Known follow-ups
- .superpowers/sdd/followup-http-bridge.md (gitignored) — Path A for
spec §10's "backfill 期间 EverOS 完全可用" promise
- _TABLE_SCHEMA_VERSION docstring — v3+ migrations need a version
dispatch table
- extract_user_profile.py throttle-counter block — replace LanceDB
count_by_owner with a sqlite memcell count
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
* fix(review): close 3 blockers surfaced by round-4 review
N1. cluster_repo.find_cluster_id_for_member was cross-owner-unsafe.
Its reverse index (member_type, member_id) alone cannot disambiguate
two owners whose entry_id happens to collide — entry_id is
deliberately only per-owner unique (see entries.py:47:
'Cross-user uniqueness is handled at the database layer via a
composite <user_id>_<entry_id> field; it is not encoded into the
EntryId string itself'). Phase 2's _scan_all_rows crosses all
owners, so on any multi-owner root, same-day seq=1 episodes under
different owners would either false-hit each other's cluster or
be silently skipped from clustering. Add required (app_id,
project_id, owner_id) keyword args + JOIN Cluster (which already
carries scope) to filter by parent scope. Prior signature had zero
production callers except two the same PR just added, so the
API break is contained. Regression test: two owners persist a
cluster each around the same entry_id, each lookup resolves to
its own owner's cluster, a third owner's lookup returns None.
N2. Ctrl-C / EOF at the y/N prompt was landing on the generic
except Exception branch (exit 2 with rich traceback) instead of
the exit-130 interrupt path. Root cause: typer 0.15+ vendored
click under typer._click, so typer.Abort and the standalone
click.exceptions.Abort are distinct classes. The interrupt-branch
catch only listed the standalone one; every existing 'abort'
test was manually raising click.exceptions.Abort so the miss
was a false-positive guard rail. Widen the catch to
(typer.Abort, click.exceptions.Abort) and declare click as a
first-class dependency (it was only pulled in via uvicorn).
Regression test: raise real typer.Abort() at the confirm step
and assert exit 130 + INTERRUPTED banner.
N3. _looks_like_utf8_text used mime.startswith('text/'), which
caught text/html as well. HTML uploads then bypassed everalgo's
_aparse_html — losing clean_html_for_llm (strips <script>/<style>
/<nav>/<iframe> + HTML comments) and the 1 MiB output cap. A
40 MiB .html with <script> bodies and <!-- prompt injection -->
comments would flow straight into the extraction LLM. Replace
with explicit allowlist {text/plain, text/markdown, text/x-rst,
text/x-markdown}; text/html and any future text/* mime now
default to the parser path. Test matrix asserts text/html →
False (was regressed as True by the earlier commit).
Hermetic env full pytest: 2033 passed / 7 deselected (+6 tests
from these regressions).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
* fix(review): close round-4 major + minor + PR body errata
Round-4 review-driven cleanup. Blocker fixes (N1/N2/N3) landed in
561b5fe. This commit closes the remaining CONFIRMED items:
Major:
- J3 MemoryRoot.default() -> resolve() was a breaking public API
rename this branch introduced (main still has default()). Adds
default() as a backward-compat alias forwarding to resolve()
with DeprecationWarning; CHANGELOG entry under Unreleased.
- J4 episode_repo.list_by_owner_after_ts(limit=N) truncates in
fragment order (== insertion order), NOT newest-first. Docstring
now spells out the trap so a future caller passing limit for a
'newest N' window doesn't silently get the oldest N.
- J5.2 TyperPresenter.nothing_to_backfill picked colour via
'could not be read' in message — a domain wording change
would silently flip yellow -> green. Signature gains explicit
scan_failed: bool kwarg; CLI colour-picks off the flag.
- J5.5 phase_header was Protocol-declared but never dispatched
(run_backfill calls _print_phase_header directly). Removed the
dead Protocol method + both no-op implementations.
- J6.3 3 inline from everos.core.errors import ... inside
Phase 1/2/3 preflights promoted to a single top-level import.
- J7 subject-side embed failure was silently exit-0 because
rows_processed advanced whenever any side wrote. Now: a row with
a needed side still NULL counts as rows_failed (exit 4 =
COMPLETED_WITH_FAILURES). Gated on spec.subject_of + row.needs_*
+ row.subject_text so non-Episode tables and subject-empty rows
don't false-positive.
- J9 test_migration_cross_process.py did NOT actually test cross-
process (all 5 tests mock memory_root_lock). Renamed to
test_migration_lock_wiring.py; docstring now scopes it to
'lock-invocation wiring' and points at test_core/…/test_locking.py
for real flock coverage.
- J10 Phase 1 lacked the server-running preflight Phase 2/3 have.
--phase all against a live server would burn Phase 1 embed API
calls (real cost) before Phase 2 halted with exit 3. Phase 1 now
probes _probe_ome_lock_available first; regression test in
test_backfill_preflight.py; upgrade_path integration patches the
probe so its in-process 'server + backfill' scenario stays valid.
Minor:
- M1 knowledge upload with NUL byte or filename > 255 bytes UTF-8
used to raise ValueError/OSError at write_bytes → 500 with a
half-written md left on disk. _safe_original_filename now
rejects both up front with InvalidInputError (→ 400).
- M2 backfill optimize() now passes cleanup_older_than=timedelta(0)
so older manifest versions are physically pruned (previous call
compacted fragments but left the manifest chain on disk).
- M3 verify_business_schemas remediation text used to jump straight
to 'rm -rf ~/.everos/.index/lancedb'; now walks restart → wipe.
- M5 multimodal/accessor.py capability_build_failed warning added
so all four provider accessors log symmetrically (was silent).
- M7 test_knowledge_api parser-absence tests call
parser_available.cache_clear() around the sys.modules patch so
the lru_cache doesn't strand a stale True/False.
- M8 cascade_handler_embed_skipped (6 handlers) demoted INFO → DEBUG:
Tier 1 imports were generating N × 6 handler-info lines per md.
- M10.1 test_drift_scenario_would_raise was a tautology (compared
two hardcoded string sets, never touched the guard). Now
monkey-patches BUSINESS_SCHEMAS_WITH_VECTOR to a superset and
reloads _backfill, proving the import-time RuntimeError fires.
- M11 test_cascade_verbose_position subprocess.run calls gain
env= — scrubs EVEROS_* from the developer environment so the
same footgun as round-2 B1 doesn't re-appear inside subprocesses.
- M14 health() -> dict degraded the OpenAPI schema to
additionalProperties: true. Introduce HealthResponse +
HealthCapabilities Pydantic models so clients get real field
shape; docs/openapi.json regenerated.
- M16 routes/knowledge.py:_require_knowledge_capabilities docstring
claimed cascade.registry.build_handlers still gates
knowledge_topic/knowledge_document, contradicting
registry.py:177-194 (gate removed there, moved to HTTP layer).
Rewritten to describe the current design accurately.
Hermetic env full pytest: 2037 passed / 7 deselected.
Explicitly deferred to followup:
- J1 lazy multimodal client (needs everalgo signature change)
- J2 tier definition (knowledge = Tier 3 whole)
- J5.1/3/4 broader presentation-split refactor
- J6.1/2 backfill dispatch and _backfill_table refactor
- J8 Phase 1 keyset pagination for bulk migration OOM
- M4 flock timeout/waiting log/re-entry (core/persistence refactor)
- M6 UTF-8 codec strategy (BOM/UTF-16/GBK)
- M9 count_by_owner monotonicity (latent, INTERVAL=1 short-circuits)
- M13 --phase all multi-phase combined-outcome test coverage
- M15 PR-marker rationale comments (16 occurrences, all inert)
M12 was refuted (both event names exist).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
4099 lines
107 KiB
JSON
4099 lines
107 KiB
JSON
{
|
|
"openapi": "3.1.0",
|
|
"info": {
|
|
"title": "everos",
|
|
"description": "md-first memory extraction framework",
|
|
"version": "1.2.0"
|
|
},
|
|
"paths": {
|
|
"/health": {
|
|
"get": {
|
|
"tags": [
|
|
"health"
|
|
],
|
|
"summary": "Health",
|
|
"description": "Liveness probe with capabilities and disabled features.",
|
|
"operationId": "health_health_get",
|
|
"responses": {
|
|
"200": {
|
|
"description": "Successful Response",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/HealthResponse"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/metrics": {
|
|
"get": {
|
|
"tags": [
|
|
"metrics"
|
|
],
|
|
"summary": "Metrics",
|
|
"description": "Render the current Prometheus registry in exposition format.",
|
|
"operationId": "metrics_metrics_get",
|
|
"responses": {
|
|
"200": {
|
|
"description": "Successful Response",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/api/v1/memory/add": {
|
|
"post": {
|
|
"tags": [
|
|
"memory"
|
|
],
|
|
"summary": "Add Memory",
|
|
"description": "Add messages into the user-memory + agent-memory pipelines.",
|
|
"operationId": "add_memory_api_v1_memory_add_post",
|
|
"requestBody": {
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/MemorizeAddRequest"
|
|
}
|
|
}
|
|
},
|
|
"required": true
|
|
},
|
|
"responses": {
|
|
"200": {
|
|
"description": "Successful Response",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/SuccessEnvelope_AddResponseData_"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"422": {
|
|
"description": "Validation Error",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/HTTPValidationError"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/api/v1/memory/flush": {
|
|
"post": {
|
|
"tags": [
|
|
"memory"
|
|
],
|
|
"summary": "Flush Memory",
|
|
"description": "Force boundary detection over the current ``session_id`` buffer.\n\n[OSS-only] — cloud edition decides boundary timing server-side and\ndoes not expose this endpoint.",
|
|
"operationId": "flush_memory_api_v1_memory_flush_post",
|
|
"requestBody": {
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/MemorizeFlushRequest"
|
|
}
|
|
}
|
|
},
|
|
"required": true
|
|
},
|
|
"responses": {
|
|
"200": {
|
|
"description": "Successful Response",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/SuccessEnvelope_FlushResponseData_"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"422": {
|
|
"description": "Validation Error",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/HTTPValidationError"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/api/v1/memory/search": {
|
|
"post": {
|
|
"tags": [
|
|
"memory"
|
|
],
|
|
"summary": "Post Search",
|
|
"description": "Hybrid retrieval across the configured memory backends.",
|
|
"operationId": "post_search_api_v1_memory_search_post",
|
|
"requestBody": {
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/SearchRequest"
|
|
}
|
|
}
|
|
},
|
|
"required": true
|
|
},
|
|
"responses": {
|
|
"200": {
|
|
"description": "Successful Response",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/SearchResponse"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"422": {
|
|
"description": "Validation Error",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/HTTPValidationError"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/api/v1/memory/get": {
|
|
"post": {
|
|
"tags": [
|
|
"memory"
|
|
],
|
|
"summary": "Post Get",
|
|
"description": "Paginated listing over the requested ``memory_type``.",
|
|
"operationId": "post_get_api_v1_memory_get_post",
|
|
"requestBody": {
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/GetRequest"
|
|
}
|
|
}
|
|
},
|
|
"required": true
|
|
},
|
|
"responses": {
|
|
"200": {
|
|
"description": "Successful Response",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/GetResponse"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"422": {
|
|
"description": "Validation Error",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/HTTPValidationError"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/api/v1/ome/trigger": {
|
|
"post": {
|
|
"tags": [
|
|
"ome"
|
|
],
|
|
"summary": "Trigger",
|
|
"description": "Manually trigger a registered OME strategy and wait for completion.",
|
|
"operationId": "trigger_api_v1_ome_trigger_post",
|
|
"requestBody": {
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/TriggerRequest"
|
|
}
|
|
}
|
|
},
|
|
"required": true
|
|
},
|
|
"responses": {
|
|
"200": {
|
|
"description": "Successful Response",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/TriggerResponse"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"422": {
|
|
"description": "Validation Error",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/HTTPValidationError"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/api/v1/knowledge/documents": {
|
|
"post": {
|
|
"tags": [
|
|
"knowledge"
|
|
],
|
|
"summary": "Create Document Route",
|
|
"description": "Upload a new knowledge document.",
|
|
"operationId": "create_document_route_api_v1_knowledge_documents_post",
|
|
"requestBody": {
|
|
"required": true,
|
|
"content": {
|
|
"multipart/form-data": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/Body_create_document_route_api_v1_knowledge_documents_post"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"responses": {
|
|
"201": {
|
|
"description": "Successful Response",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/SuccessEnvelope_DocumentCreateResponse_"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"422": {
|
|
"description": "Validation Error",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/HTTPValidationError"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"get": {
|
|
"tags": [
|
|
"knowledge"
|
|
],
|
|
"summary": "List Documents Route",
|
|
"description": "Paginated document listing.",
|
|
"operationId": "list_documents_route_api_v1_knowledge_documents_get",
|
|
"parameters": [
|
|
{
|
|
"name": "app_id",
|
|
"in": "query",
|
|
"required": false,
|
|
"schema": {
|
|
"type": "string",
|
|
"default": "default",
|
|
"title": "App Id"
|
|
}
|
|
},
|
|
{
|
|
"name": "project_id",
|
|
"in": "query",
|
|
"required": false,
|
|
"schema": {
|
|
"type": "string",
|
|
"default": "default",
|
|
"title": "Project Id"
|
|
}
|
|
},
|
|
{
|
|
"name": "category_id",
|
|
"in": "query",
|
|
"required": false,
|
|
"schema": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Category Id"
|
|
}
|
|
},
|
|
{
|
|
"name": "page",
|
|
"in": "query",
|
|
"required": false,
|
|
"schema": {
|
|
"type": "integer",
|
|
"minimum": 1,
|
|
"default": 1,
|
|
"title": "Page"
|
|
}
|
|
},
|
|
{
|
|
"name": "page_size",
|
|
"in": "query",
|
|
"required": false,
|
|
"schema": {
|
|
"type": "integer",
|
|
"maximum": 100,
|
|
"minimum": 1,
|
|
"default": 20,
|
|
"title": "Page Size"
|
|
}
|
|
},
|
|
{
|
|
"name": "sort_by",
|
|
"in": "query",
|
|
"required": false,
|
|
"schema": {
|
|
"enum": [
|
|
"created_at",
|
|
"updated_at",
|
|
"title"
|
|
],
|
|
"type": "string",
|
|
"default": "created_at",
|
|
"title": "Sort By"
|
|
}
|
|
},
|
|
{
|
|
"name": "sort_order",
|
|
"in": "query",
|
|
"required": false,
|
|
"schema": {
|
|
"enum": [
|
|
"asc",
|
|
"desc"
|
|
],
|
|
"type": "string",
|
|
"default": "desc",
|
|
"title": "Sort Order"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "Successful Response",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/SuccessEnvelope_DocumentListResponse_"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"422": {
|
|
"description": "Validation Error",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/HTTPValidationError"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/api/v1/knowledge/documents/{doc_id}": {
|
|
"put": {
|
|
"tags": [
|
|
"knowledge"
|
|
],
|
|
"summary": "Replace Document Route",
|
|
"description": "Replace an existing knowledge document (atomic backup/restore on failure).",
|
|
"operationId": "replace_document_route_api_v1_knowledge_documents__doc_id__put",
|
|
"parameters": [
|
|
{
|
|
"name": "doc_id",
|
|
"in": "path",
|
|
"required": true,
|
|
"schema": {
|
|
"type": "string",
|
|
"pattern": "^d_[a-f0-9]{12,32}$",
|
|
"title": "Doc Id"
|
|
}
|
|
}
|
|
],
|
|
"requestBody": {
|
|
"required": true,
|
|
"content": {
|
|
"multipart/form-data": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/Body_replace_document_route_api_v1_knowledge_documents__doc_id__put"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"responses": {
|
|
"200": {
|
|
"description": "Successful Response",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/SuccessEnvelope_DocumentCreateResponse_"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"422": {
|
|
"description": "Validation Error",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/HTTPValidationError"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"delete": {
|
|
"tags": [
|
|
"knowledge"
|
|
],
|
|
"summary": "Delete Document Route",
|
|
"description": "Remove a knowledge document.",
|
|
"operationId": "delete_document_route_api_v1_knowledge_documents__doc_id__delete",
|
|
"parameters": [
|
|
{
|
|
"name": "doc_id",
|
|
"in": "path",
|
|
"required": true,
|
|
"schema": {
|
|
"type": "string",
|
|
"pattern": "^d_[a-f0-9]{12,32}$",
|
|
"title": "Doc Id"
|
|
}
|
|
},
|
|
{
|
|
"name": "app_id",
|
|
"in": "query",
|
|
"required": false,
|
|
"schema": {
|
|
"type": "string",
|
|
"default": "default",
|
|
"title": "App Id"
|
|
}
|
|
},
|
|
{
|
|
"name": "project_id",
|
|
"in": "query",
|
|
"required": false,
|
|
"schema": {
|
|
"type": "string",
|
|
"default": "default",
|
|
"title": "Project Id"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "Successful Response",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {}
|
|
}
|
|
}
|
|
},
|
|
"422": {
|
|
"description": "Validation Error",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/HTTPValidationError"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"get": {
|
|
"tags": [
|
|
"knowledge"
|
|
],
|
|
"summary": "Get Document Route",
|
|
"description": "Fetch a single document with its topic list.",
|
|
"operationId": "get_document_route_api_v1_knowledge_documents__doc_id__get",
|
|
"parameters": [
|
|
{
|
|
"name": "doc_id",
|
|
"in": "path",
|
|
"required": true,
|
|
"schema": {
|
|
"type": "string",
|
|
"pattern": "^d_[a-f0-9]{12,32}$",
|
|
"title": "Doc Id"
|
|
}
|
|
},
|
|
{
|
|
"name": "app_id",
|
|
"in": "query",
|
|
"required": false,
|
|
"schema": {
|
|
"type": "string",
|
|
"default": "default",
|
|
"title": "App Id"
|
|
}
|
|
},
|
|
{
|
|
"name": "project_id",
|
|
"in": "query",
|
|
"required": false,
|
|
"schema": {
|
|
"type": "string",
|
|
"default": "default",
|
|
"title": "Project Id"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "Successful Response",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/SuccessEnvelope_DocumentDetailResponse_"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"422": {
|
|
"description": "Validation Error",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/HTTPValidationError"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"patch": {
|
|
"tags": [
|
|
"knowledge"
|
|
],
|
|
"summary": "Patch Document Route",
|
|
"description": "Update mutable document metadata fields.",
|
|
"operationId": "patch_document_route_api_v1_knowledge_documents__doc_id__patch",
|
|
"parameters": [
|
|
{
|
|
"name": "doc_id",
|
|
"in": "path",
|
|
"required": true,
|
|
"schema": {
|
|
"type": "string",
|
|
"pattern": "^d_[a-f0-9]{12,32}$",
|
|
"title": "Doc Id"
|
|
}
|
|
}
|
|
],
|
|
"requestBody": {
|
|
"required": true,
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/DocumentPatchRequest"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"responses": {
|
|
"200": {
|
|
"description": "Successful Response",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/SuccessEnvelope_DocumentPatchResponse_"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"422": {
|
|
"description": "Validation Error",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/HTTPValidationError"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/api/v1/knowledge/topics/{topic_id}": {
|
|
"get": {
|
|
"tags": [
|
|
"knowledge"
|
|
],
|
|
"summary": "Get Topic Route",
|
|
"description": "Fetch a single topic with full content.",
|
|
"operationId": "get_topic_route_api_v1_knowledge_topics__topic_id__get",
|
|
"parameters": [
|
|
{
|
|
"name": "topic_id",
|
|
"in": "path",
|
|
"required": true,
|
|
"schema": {
|
|
"type": "string",
|
|
"pattern": "^d_[a-f0-9]{12,32}_\\d+$",
|
|
"title": "Topic Id"
|
|
}
|
|
},
|
|
{
|
|
"name": "app_id",
|
|
"in": "query",
|
|
"required": false,
|
|
"schema": {
|
|
"type": "string",
|
|
"default": "default",
|
|
"title": "App Id"
|
|
}
|
|
},
|
|
{
|
|
"name": "project_id",
|
|
"in": "query",
|
|
"required": false,
|
|
"schema": {
|
|
"type": "string",
|
|
"default": "default",
|
|
"title": "Project Id"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "Successful Response",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/SuccessEnvelope_TopicDetailResponse_"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"422": {
|
|
"description": "Validation Error",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/HTTPValidationError"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/api/v1/knowledge/search": {
|
|
"post": {
|
|
"tags": [
|
|
"knowledge"
|
|
],
|
|
"summary": "Search Knowledge Route",
|
|
"description": "Knowledge retrieval (keyword / vector / hybrid).",
|
|
"operationId": "search_knowledge_route_api_v1_knowledge_search_post",
|
|
"requestBody": {
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/KnowledgeSearchRequest"
|
|
}
|
|
}
|
|
},
|
|
"required": true
|
|
},
|
|
"responses": {
|
|
"200": {
|
|
"description": "Successful Response",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/SuccessEnvelope_KnowledgeSearchResponse_"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"422": {
|
|
"description": "Validation Error",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/HTTPValidationError"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/api/v1/knowledge/categories": {
|
|
"get": {
|
|
"tags": [
|
|
"knowledge"
|
|
],
|
|
"summary": "List Categories Route",
|
|
"description": "List taxonomy categories from ``.taxonomy.md``.",
|
|
"operationId": "list_categories_route_api_v1_knowledge_categories_get",
|
|
"parameters": [
|
|
{
|
|
"name": "app_id",
|
|
"in": "query",
|
|
"required": false,
|
|
"schema": {
|
|
"type": "string",
|
|
"default": "default",
|
|
"title": "App Id"
|
|
}
|
|
},
|
|
{
|
|
"name": "project_id",
|
|
"in": "query",
|
|
"required": false,
|
|
"schema": {
|
|
"type": "string",
|
|
"default": "default",
|
|
"title": "Project Id"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "Successful Response",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/SuccessEnvelope_CategoryListResponse_"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"422": {
|
|
"description": "Validation Error",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/HTTPValidationError"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/api/v2/memory/add": {
|
|
"post": {
|
|
"tags": [
|
|
"memory"
|
|
],
|
|
"summary": "Add Memory",
|
|
"description": "Add messages into the user-memory + agent-memory pipelines.",
|
|
"operationId": "add_memory_api_v2_memory_add_post",
|
|
"requestBody": {
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/MemorizeAddRequest"
|
|
}
|
|
}
|
|
},
|
|
"required": true
|
|
},
|
|
"responses": {
|
|
"200": {
|
|
"description": "Successful Response",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/SuccessEnvelope_AddResponseData_"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"422": {
|
|
"description": "Validation Error",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/HTTPValidationError"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/api/v2/memory/flush": {
|
|
"post": {
|
|
"tags": [
|
|
"memory"
|
|
],
|
|
"summary": "Flush Memory",
|
|
"description": "Force boundary detection over the current ``session_id`` buffer.\n\n[OSS-only] — cloud edition decides boundary timing server-side and\ndoes not expose this endpoint.",
|
|
"operationId": "flush_memory_api_v2_memory_flush_post",
|
|
"requestBody": {
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/MemorizeFlushRequest"
|
|
}
|
|
}
|
|
},
|
|
"required": true
|
|
},
|
|
"responses": {
|
|
"200": {
|
|
"description": "Successful Response",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/SuccessEnvelope_FlushResponseData_"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"422": {
|
|
"description": "Validation Error",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/HTTPValidationError"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/api/v2/memory/search": {
|
|
"post": {
|
|
"tags": [
|
|
"memory"
|
|
],
|
|
"summary": "Post Search",
|
|
"description": "Hybrid retrieval across the configured memory backends.",
|
|
"operationId": "post_search_api_v2_memory_search_post",
|
|
"requestBody": {
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/SearchRequest"
|
|
}
|
|
}
|
|
},
|
|
"required": true
|
|
},
|
|
"responses": {
|
|
"200": {
|
|
"description": "Successful Response",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/SearchResponse"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"422": {
|
|
"description": "Validation Error",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/HTTPValidationError"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/api/v2/memory/get": {
|
|
"post": {
|
|
"tags": [
|
|
"memory"
|
|
],
|
|
"summary": "Post Get",
|
|
"description": "Paginated listing over the requested ``memory_type``.",
|
|
"operationId": "post_get_api_v2_memory_get_post",
|
|
"requestBody": {
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/GetRequest"
|
|
}
|
|
}
|
|
},
|
|
"required": true
|
|
},
|
|
"responses": {
|
|
"200": {
|
|
"description": "Successful Response",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/GetResponse"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"422": {
|
|
"description": "Validation Error",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/HTTPValidationError"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/api/v2/ome/trigger": {
|
|
"post": {
|
|
"tags": [
|
|
"ome"
|
|
],
|
|
"summary": "Trigger",
|
|
"description": "Manually trigger a registered OME strategy and wait for completion.",
|
|
"operationId": "trigger_api_v2_ome_trigger_post",
|
|
"requestBody": {
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/TriggerRequest"
|
|
}
|
|
}
|
|
},
|
|
"required": true
|
|
},
|
|
"responses": {
|
|
"200": {
|
|
"description": "Successful Response",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/TriggerResponse"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"422": {
|
|
"description": "Validation Error",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/HTTPValidationError"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/api/v2/knowledge/documents": {
|
|
"post": {
|
|
"tags": [
|
|
"knowledge"
|
|
],
|
|
"summary": "Create Document Route",
|
|
"description": "Upload a new knowledge document.",
|
|
"operationId": "create_document_route_api_v2_knowledge_documents_post",
|
|
"requestBody": {
|
|
"required": true,
|
|
"content": {
|
|
"multipart/form-data": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/Body_create_document_route_api_v2_knowledge_documents_post"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"responses": {
|
|
"201": {
|
|
"description": "Successful Response",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/SuccessEnvelope_DocumentCreateResponse_"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"422": {
|
|
"description": "Validation Error",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/HTTPValidationError"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"get": {
|
|
"tags": [
|
|
"knowledge"
|
|
],
|
|
"summary": "List Documents Route",
|
|
"description": "Paginated document listing.",
|
|
"operationId": "list_documents_route_api_v2_knowledge_documents_get",
|
|
"parameters": [
|
|
{
|
|
"name": "app_id",
|
|
"in": "query",
|
|
"required": false,
|
|
"schema": {
|
|
"type": "string",
|
|
"default": "default",
|
|
"title": "App Id"
|
|
}
|
|
},
|
|
{
|
|
"name": "project_id",
|
|
"in": "query",
|
|
"required": false,
|
|
"schema": {
|
|
"type": "string",
|
|
"default": "default",
|
|
"title": "Project Id"
|
|
}
|
|
},
|
|
{
|
|
"name": "category_id",
|
|
"in": "query",
|
|
"required": false,
|
|
"schema": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Category Id"
|
|
}
|
|
},
|
|
{
|
|
"name": "page",
|
|
"in": "query",
|
|
"required": false,
|
|
"schema": {
|
|
"type": "integer",
|
|
"minimum": 1,
|
|
"default": 1,
|
|
"title": "Page"
|
|
}
|
|
},
|
|
{
|
|
"name": "page_size",
|
|
"in": "query",
|
|
"required": false,
|
|
"schema": {
|
|
"type": "integer",
|
|
"maximum": 100,
|
|
"minimum": 1,
|
|
"default": 20,
|
|
"title": "Page Size"
|
|
}
|
|
},
|
|
{
|
|
"name": "sort_by",
|
|
"in": "query",
|
|
"required": false,
|
|
"schema": {
|
|
"enum": [
|
|
"created_at",
|
|
"updated_at",
|
|
"title"
|
|
],
|
|
"type": "string",
|
|
"default": "created_at",
|
|
"title": "Sort By"
|
|
}
|
|
},
|
|
{
|
|
"name": "sort_order",
|
|
"in": "query",
|
|
"required": false,
|
|
"schema": {
|
|
"enum": [
|
|
"asc",
|
|
"desc"
|
|
],
|
|
"type": "string",
|
|
"default": "desc",
|
|
"title": "Sort Order"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "Successful Response",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/SuccessEnvelope_DocumentListResponse_"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"422": {
|
|
"description": "Validation Error",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/HTTPValidationError"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/api/v2/knowledge/documents/{doc_id}": {
|
|
"put": {
|
|
"tags": [
|
|
"knowledge"
|
|
],
|
|
"summary": "Replace Document Route",
|
|
"description": "Replace an existing knowledge document (atomic backup/restore on failure).",
|
|
"operationId": "replace_document_route_api_v2_knowledge_documents__doc_id__put",
|
|
"parameters": [
|
|
{
|
|
"name": "doc_id",
|
|
"in": "path",
|
|
"required": true,
|
|
"schema": {
|
|
"type": "string",
|
|
"pattern": "^d_[a-f0-9]{12,32}$",
|
|
"title": "Doc Id"
|
|
}
|
|
}
|
|
],
|
|
"requestBody": {
|
|
"required": true,
|
|
"content": {
|
|
"multipart/form-data": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/Body_replace_document_route_api_v2_knowledge_documents__doc_id__put"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"responses": {
|
|
"200": {
|
|
"description": "Successful Response",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/SuccessEnvelope_DocumentCreateResponse_"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"422": {
|
|
"description": "Validation Error",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/HTTPValidationError"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"delete": {
|
|
"tags": [
|
|
"knowledge"
|
|
],
|
|
"summary": "Delete Document Route",
|
|
"description": "Remove a knowledge document.",
|
|
"operationId": "delete_document_route_api_v2_knowledge_documents__doc_id__delete",
|
|
"parameters": [
|
|
{
|
|
"name": "doc_id",
|
|
"in": "path",
|
|
"required": true,
|
|
"schema": {
|
|
"type": "string",
|
|
"pattern": "^d_[a-f0-9]{12,32}$",
|
|
"title": "Doc Id"
|
|
}
|
|
},
|
|
{
|
|
"name": "app_id",
|
|
"in": "query",
|
|
"required": false,
|
|
"schema": {
|
|
"type": "string",
|
|
"default": "default",
|
|
"title": "App Id"
|
|
}
|
|
},
|
|
{
|
|
"name": "project_id",
|
|
"in": "query",
|
|
"required": false,
|
|
"schema": {
|
|
"type": "string",
|
|
"default": "default",
|
|
"title": "Project Id"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "Successful Response",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {}
|
|
}
|
|
}
|
|
},
|
|
"422": {
|
|
"description": "Validation Error",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/HTTPValidationError"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"get": {
|
|
"tags": [
|
|
"knowledge"
|
|
],
|
|
"summary": "Get Document Route",
|
|
"description": "Fetch a single document with its topic list.",
|
|
"operationId": "get_document_route_api_v2_knowledge_documents__doc_id__get",
|
|
"parameters": [
|
|
{
|
|
"name": "doc_id",
|
|
"in": "path",
|
|
"required": true,
|
|
"schema": {
|
|
"type": "string",
|
|
"pattern": "^d_[a-f0-9]{12,32}$",
|
|
"title": "Doc Id"
|
|
}
|
|
},
|
|
{
|
|
"name": "app_id",
|
|
"in": "query",
|
|
"required": false,
|
|
"schema": {
|
|
"type": "string",
|
|
"default": "default",
|
|
"title": "App Id"
|
|
}
|
|
},
|
|
{
|
|
"name": "project_id",
|
|
"in": "query",
|
|
"required": false,
|
|
"schema": {
|
|
"type": "string",
|
|
"default": "default",
|
|
"title": "Project Id"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "Successful Response",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/SuccessEnvelope_DocumentDetailResponse_"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"422": {
|
|
"description": "Validation Error",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/HTTPValidationError"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"patch": {
|
|
"tags": [
|
|
"knowledge"
|
|
],
|
|
"summary": "Patch Document Route",
|
|
"description": "Update mutable document metadata fields.",
|
|
"operationId": "patch_document_route_api_v2_knowledge_documents__doc_id__patch",
|
|
"parameters": [
|
|
{
|
|
"name": "doc_id",
|
|
"in": "path",
|
|
"required": true,
|
|
"schema": {
|
|
"type": "string",
|
|
"pattern": "^d_[a-f0-9]{12,32}$",
|
|
"title": "Doc Id"
|
|
}
|
|
}
|
|
],
|
|
"requestBody": {
|
|
"required": true,
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/DocumentPatchRequest"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"responses": {
|
|
"200": {
|
|
"description": "Successful Response",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/SuccessEnvelope_DocumentPatchResponse_"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"422": {
|
|
"description": "Validation Error",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/HTTPValidationError"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/api/v2/knowledge/topics/{topic_id}": {
|
|
"get": {
|
|
"tags": [
|
|
"knowledge"
|
|
],
|
|
"summary": "Get Topic Route",
|
|
"description": "Fetch a single topic with full content.",
|
|
"operationId": "get_topic_route_api_v2_knowledge_topics__topic_id__get",
|
|
"parameters": [
|
|
{
|
|
"name": "topic_id",
|
|
"in": "path",
|
|
"required": true,
|
|
"schema": {
|
|
"type": "string",
|
|
"pattern": "^d_[a-f0-9]{12,32}_\\d+$",
|
|
"title": "Topic Id"
|
|
}
|
|
},
|
|
{
|
|
"name": "app_id",
|
|
"in": "query",
|
|
"required": false,
|
|
"schema": {
|
|
"type": "string",
|
|
"default": "default",
|
|
"title": "App Id"
|
|
}
|
|
},
|
|
{
|
|
"name": "project_id",
|
|
"in": "query",
|
|
"required": false,
|
|
"schema": {
|
|
"type": "string",
|
|
"default": "default",
|
|
"title": "Project Id"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "Successful Response",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/SuccessEnvelope_TopicDetailResponse_"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"422": {
|
|
"description": "Validation Error",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/HTTPValidationError"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/api/v2/knowledge/search": {
|
|
"post": {
|
|
"tags": [
|
|
"knowledge"
|
|
],
|
|
"summary": "Search Knowledge Route",
|
|
"description": "Knowledge retrieval (keyword / vector / hybrid).",
|
|
"operationId": "search_knowledge_route_api_v2_knowledge_search_post",
|
|
"requestBody": {
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/KnowledgeSearchRequest"
|
|
}
|
|
}
|
|
},
|
|
"required": true
|
|
},
|
|
"responses": {
|
|
"200": {
|
|
"description": "Successful Response",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/SuccessEnvelope_KnowledgeSearchResponse_"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"422": {
|
|
"description": "Validation Error",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/HTTPValidationError"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/api/v2/knowledge/categories": {
|
|
"get": {
|
|
"tags": [
|
|
"knowledge"
|
|
],
|
|
"summary": "List Categories Route",
|
|
"description": "List taxonomy categories from ``.taxonomy.md``.",
|
|
"operationId": "list_categories_route_api_v2_knowledge_categories_get",
|
|
"parameters": [
|
|
{
|
|
"name": "app_id",
|
|
"in": "query",
|
|
"required": false,
|
|
"schema": {
|
|
"type": "string",
|
|
"default": "default",
|
|
"title": "App Id"
|
|
}
|
|
},
|
|
{
|
|
"name": "project_id",
|
|
"in": "query",
|
|
"required": false,
|
|
"schema": {
|
|
"type": "string",
|
|
"default": "default",
|
|
"title": "Project Id"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "Successful Response",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/SuccessEnvelope_CategoryListResponse_"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"422": {
|
|
"description": "Validation Error",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/HTTPValidationError"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"components": {
|
|
"schemas": {
|
|
"AddResponseData": {
|
|
"properties": {
|
|
"message_count": {
|
|
"type": "integer",
|
|
"title": "Message Count"
|
|
},
|
|
"status": {
|
|
"type": "string",
|
|
"enum": [
|
|
"accumulated",
|
|
"extracted"
|
|
],
|
|
"title": "Status"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"required": [
|
|
"message_count",
|
|
"status"
|
|
],
|
|
"title": "AddResponseData"
|
|
},
|
|
"Body_create_document_route_api_v1_knowledge_documents_post": {
|
|
"properties": {
|
|
"file": {
|
|
"type": "string",
|
|
"contentMediaType": "application/octet-stream",
|
|
"title": "File"
|
|
},
|
|
"title": {
|
|
"type": "string",
|
|
"minLength": 1,
|
|
"pattern": "\\w",
|
|
"title": "Title"
|
|
},
|
|
"source_type": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Source Type"
|
|
},
|
|
"category_id": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Category Id"
|
|
},
|
|
"app_id": {
|
|
"type": "string",
|
|
"title": "App Id",
|
|
"default": "default"
|
|
},
|
|
"project_id": {
|
|
"type": "string",
|
|
"title": "Project Id",
|
|
"default": "default"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"required": [
|
|
"file",
|
|
"title"
|
|
],
|
|
"title": "Body_create_document_route_api_v1_knowledge_documents_post"
|
|
},
|
|
"Body_create_document_route_api_v2_knowledge_documents_post": {
|
|
"properties": {
|
|
"file": {
|
|
"type": "string",
|
|
"contentMediaType": "application/octet-stream",
|
|
"title": "File"
|
|
},
|
|
"title": {
|
|
"type": "string",
|
|
"minLength": 1,
|
|
"pattern": "\\w",
|
|
"title": "Title"
|
|
},
|
|
"source_type": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Source Type"
|
|
},
|
|
"category_id": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Category Id"
|
|
},
|
|
"app_id": {
|
|
"type": "string",
|
|
"title": "App Id",
|
|
"default": "default"
|
|
},
|
|
"project_id": {
|
|
"type": "string",
|
|
"title": "Project Id",
|
|
"default": "default"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"required": [
|
|
"file",
|
|
"title"
|
|
],
|
|
"title": "Body_create_document_route_api_v2_knowledge_documents_post"
|
|
},
|
|
"Body_replace_document_route_api_v1_knowledge_documents__doc_id__put": {
|
|
"properties": {
|
|
"file": {
|
|
"type": "string",
|
|
"contentMediaType": "application/octet-stream",
|
|
"title": "File"
|
|
},
|
|
"title": {
|
|
"type": "string",
|
|
"minLength": 1,
|
|
"pattern": "\\w",
|
|
"title": "Title"
|
|
},
|
|
"source_type": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Source Type"
|
|
},
|
|
"category_id": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Category Id"
|
|
},
|
|
"app_id": {
|
|
"type": "string",
|
|
"title": "App Id",
|
|
"default": "default"
|
|
},
|
|
"project_id": {
|
|
"type": "string",
|
|
"title": "Project Id",
|
|
"default": "default"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"required": [
|
|
"file",
|
|
"title"
|
|
],
|
|
"title": "Body_replace_document_route_api_v1_knowledge_documents__doc_id__put"
|
|
},
|
|
"Body_replace_document_route_api_v2_knowledge_documents__doc_id__put": {
|
|
"properties": {
|
|
"file": {
|
|
"type": "string",
|
|
"contentMediaType": "application/octet-stream",
|
|
"title": "File"
|
|
},
|
|
"title": {
|
|
"type": "string",
|
|
"minLength": 1,
|
|
"pattern": "\\w",
|
|
"title": "Title"
|
|
},
|
|
"source_type": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Source Type"
|
|
},
|
|
"category_id": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Category Id"
|
|
},
|
|
"app_id": {
|
|
"type": "string",
|
|
"title": "App Id",
|
|
"default": "default"
|
|
},
|
|
"project_id": {
|
|
"type": "string",
|
|
"title": "Project Id",
|
|
"default": "default"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"required": [
|
|
"file",
|
|
"title"
|
|
],
|
|
"title": "Body_replace_document_route_api_v2_knowledge_documents__doc_id__put"
|
|
},
|
|
"CategoryDTO": {
|
|
"properties": {
|
|
"category_id": {
|
|
"type": "string",
|
|
"title": "Category Id"
|
|
},
|
|
"description": {
|
|
"type": "string",
|
|
"title": "Description"
|
|
},
|
|
"document_count": {
|
|
"type": "integer",
|
|
"title": "Document Count"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"required": [
|
|
"category_id",
|
|
"description",
|
|
"document_count"
|
|
],
|
|
"title": "CategoryDTO",
|
|
"description": "One taxonomy category."
|
|
},
|
|
"CategoryListResponse": {
|
|
"properties": {
|
|
"categories": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/CategoryDTO"
|
|
},
|
|
"type": "array",
|
|
"title": "Categories"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"required": [
|
|
"categories"
|
|
],
|
|
"title": "CategoryListResponse",
|
|
"description": "Response for GET /categories."
|
|
},
|
|
"ContentItemDTO": {
|
|
"properties": {
|
|
"type": {
|
|
"type": "string",
|
|
"enum": [
|
|
"text",
|
|
"image",
|
|
"audio",
|
|
"doc",
|
|
"pdf",
|
|
"html",
|
|
"email"
|
|
],
|
|
"title": "Type"
|
|
},
|
|
"text": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Text"
|
|
},
|
|
"uri": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Uri"
|
|
},
|
|
"base64": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Base64"
|
|
},
|
|
"ext": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Ext"
|
|
},
|
|
"name": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Name"
|
|
},
|
|
"extras": {
|
|
"anyOf": [
|
|
{
|
|
"additionalProperties": true,
|
|
"type": "object"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Extras"
|
|
}
|
|
},
|
|
"additionalProperties": false,
|
|
"type": "object",
|
|
"required": [
|
|
"type"
|
|
],
|
|
"title": "ContentItemDTO",
|
|
"description": "Content piece (v1 API brief appendix A)."
|
|
},
|
|
"DocumentContextDTO": {
|
|
"properties": {
|
|
"doc_id": {
|
|
"type": "string",
|
|
"title": "Doc Id"
|
|
},
|
|
"title": {
|
|
"type": "string",
|
|
"title": "Title"
|
|
},
|
|
"summary": {
|
|
"type": "string",
|
|
"title": "Summary"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"required": [
|
|
"doc_id",
|
|
"title",
|
|
"summary"
|
|
],
|
|
"title": "DocumentContextDTO",
|
|
"description": "L1 document metadata attached to every search hit."
|
|
},
|
|
"DocumentCreateResponse": {
|
|
"properties": {
|
|
"doc_id": {
|
|
"type": "string",
|
|
"title": "Doc Id"
|
|
},
|
|
"category_id": {
|
|
"type": "string",
|
|
"title": "Category Id"
|
|
},
|
|
"topic_count": {
|
|
"type": "integer",
|
|
"title": "Topic Count"
|
|
},
|
|
"source_name": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Source Name"
|
|
},
|
|
"md_path": {
|
|
"type": "string",
|
|
"title": "Md Path"
|
|
},
|
|
"original_file_path": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Original File Path"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"required": [
|
|
"doc_id",
|
|
"category_id",
|
|
"topic_count",
|
|
"source_name",
|
|
"md_path",
|
|
"original_file_path"
|
|
],
|
|
"title": "DocumentCreateResponse",
|
|
"description": "Response for POST/PUT /documents."
|
|
},
|
|
"DocumentDetailResponse": {
|
|
"properties": {
|
|
"doc_id": {
|
|
"type": "string",
|
|
"title": "Doc Id"
|
|
},
|
|
"category_id": {
|
|
"type": "string",
|
|
"title": "Category Id"
|
|
},
|
|
"title": {
|
|
"type": "string",
|
|
"title": "Title"
|
|
},
|
|
"summary": {
|
|
"type": "string",
|
|
"title": "Summary"
|
|
},
|
|
"source_name": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Source Name"
|
|
},
|
|
"source_type": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Source Type"
|
|
},
|
|
"original_file_path": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Original File Path"
|
|
},
|
|
"topics": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/TopicOverviewDTO"
|
|
},
|
|
"type": "array",
|
|
"title": "Topics"
|
|
},
|
|
"created_at": {
|
|
"type": "string",
|
|
"format": "date-time",
|
|
"title": "Created At"
|
|
},
|
|
"updated_at": {
|
|
"type": "string",
|
|
"format": "date-time",
|
|
"title": "Updated At"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"required": [
|
|
"doc_id",
|
|
"category_id",
|
|
"title",
|
|
"summary",
|
|
"source_name",
|
|
"source_type",
|
|
"original_file_path",
|
|
"topics",
|
|
"created_at",
|
|
"updated_at"
|
|
],
|
|
"title": "DocumentDetailResponse",
|
|
"description": "Response for GET /documents/{doc_id}."
|
|
},
|
|
"DocumentListResponse": {
|
|
"properties": {
|
|
"documents": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/DocumentOverviewItemDTO"
|
|
},
|
|
"type": "array",
|
|
"title": "Documents"
|
|
},
|
|
"total": {
|
|
"type": "integer",
|
|
"title": "Total"
|
|
},
|
|
"page": {
|
|
"type": "integer",
|
|
"title": "Page"
|
|
},
|
|
"page_size": {
|
|
"type": "integer",
|
|
"title": "Page Size"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"required": [
|
|
"documents",
|
|
"total",
|
|
"page",
|
|
"page_size"
|
|
],
|
|
"title": "DocumentListResponse",
|
|
"description": "Response for GET /documents."
|
|
},
|
|
"DocumentOverviewItemDTO": {
|
|
"properties": {
|
|
"doc_id": {
|
|
"type": "string",
|
|
"title": "Doc Id"
|
|
},
|
|
"category_id": {
|
|
"type": "string",
|
|
"title": "Category Id"
|
|
},
|
|
"title": {
|
|
"type": "string",
|
|
"title": "Title"
|
|
},
|
|
"topic_count": {
|
|
"type": "integer",
|
|
"title": "Topic Count"
|
|
},
|
|
"created_at": {
|
|
"type": "string",
|
|
"format": "date-time",
|
|
"title": "Created At"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"required": [
|
|
"doc_id",
|
|
"category_id",
|
|
"title",
|
|
"topic_count",
|
|
"created_at"
|
|
],
|
|
"title": "DocumentOverviewItemDTO",
|
|
"description": "One row in the paginated document list."
|
|
},
|
|
"DocumentPatchRequest": {
|
|
"properties": {
|
|
"title": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string",
|
|
"minLength": 1,
|
|
"pattern": "\\w"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Title"
|
|
},
|
|
"category_id": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string",
|
|
"minLength": 1
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Category Id"
|
|
},
|
|
"app_id": {
|
|
"type": "string",
|
|
"title": "App Id",
|
|
"default": "default"
|
|
},
|
|
"project_id": {
|
|
"type": "string",
|
|
"title": "Project Id",
|
|
"default": "default"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"title": "DocumentPatchRequest",
|
|
"description": "Request body for PATCH /documents/{doc_id}."
|
|
},
|
|
"DocumentPatchResponse": {
|
|
"properties": {
|
|
"doc_id": {
|
|
"type": "string",
|
|
"title": "Doc Id"
|
|
},
|
|
"updated_fields": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array",
|
|
"title": "Updated Fields"
|
|
},
|
|
"updated_at": {
|
|
"type": "string",
|
|
"format": "date-time",
|
|
"title": "Updated At"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"required": [
|
|
"doc_id",
|
|
"updated_fields",
|
|
"updated_at"
|
|
],
|
|
"title": "DocumentPatchResponse",
|
|
"description": "Response for PATCH /documents/{doc_id}."
|
|
},
|
|
"FilterNode": {
|
|
"properties": {
|
|
"AND": {
|
|
"anyOf": [
|
|
{
|
|
"items": {
|
|
"$ref": "#/components/schemas/FilterNode"
|
|
},
|
|
"type": "array"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "And"
|
|
},
|
|
"OR": {
|
|
"anyOf": [
|
|
{
|
|
"items": {
|
|
"$ref": "#/components/schemas/FilterNode"
|
|
},
|
|
"type": "array"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Or"
|
|
}
|
|
},
|
|
"additionalProperties": true,
|
|
"type": "object",
|
|
"title": "FilterNode",
|
|
"description": "One Filters DSL node.\n\nRecursive ``AND`` / ``OR`` arrays mix with arbitrary scalar fields at\nthe same level. Pydantic only checks the combinators; field-level\nsafety is enforced when compiling the node to a LanceDB ``where``\nstring in :mod:`everos.memory.search.filters`."
|
|
},
|
|
"FlushResponseData": {
|
|
"properties": {
|
|
"status": {
|
|
"type": "string",
|
|
"enum": [
|
|
"extracted",
|
|
"no_extraction"
|
|
],
|
|
"title": "Status"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"required": [
|
|
"status"
|
|
],
|
|
"title": "FlushResponseData"
|
|
},
|
|
"GetAgentCaseItem": {
|
|
"properties": {
|
|
"id": {
|
|
"type": "string",
|
|
"title": "Id"
|
|
},
|
|
"agent_id": {
|
|
"type": "string",
|
|
"title": "Agent Id"
|
|
},
|
|
"app_id": {
|
|
"type": "string",
|
|
"title": "App Id",
|
|
"default": "default"
|
|
},
|
|
"project_id": {
|
|
"type": "string",
|
|
"title": "Project Id",
|
|
"default": "default"
|
|
},
|
|
"session_id": {
|
|
"type": "string",
|
|
"title": "Session Id"
|
|
},
|
|
"task_intent": {
|
|
"type": "string",
|
|
"title": "Task Intent"
|
|
},
|
|
"approach": {
|
|
"type": "string",
|
|
"title": "Approach"
|
|
},
|
|
"quality_score": {
|
|
"type": "number",
|
|
"title": "Quality Score"
|
|
},
|
|
"key_insight": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Key Insight"
|
|
},
|
|
"timestamp": {
|
|
"type": "string",
|
|
"format": "date-time",
|
|
"title": "Timestamp"
|
|
}
|
|
},
|
|
"additionalProperties": false,
|
|
"type": "object",
|
|
"required": [
|
|
"id",
|
|
"agent_id",
|
|
"session_id",
|
|
"task_intent",
|
|
"approach",
|
|
"quality_score",
|
|
"timestamp"
|
|
],
|
|
"title": "GetAgentCaseItem",
|
|
"description": "Agent case listing item — always agent-scoped."
|
|
},
|
|
"GetAgentSkillItem": {
|
|
"properties": {
|
|
"id": {
|
|
"type": "string",
|
|
"title": "Id"
|
|
},
|
|
"agent_id": {
|
|
"type": "string",
|
|
"title": "Agent Id"
|
|
},
|
|
"app_id": {
|
|
"type": "string",
|
|
"title": "App Id",
|
|
"default": "default"
|
|
},
|
|
"project_id": {
|
|
"type": "string",
|
|
"title": "Project Id",
|
|
"default": "default"
|
|
},
|
|
"name": {
|
|
"type": "string",
|
|
"title": "Name"
|
|
},
|
|
"description": {
|
|
"type": "string",
|
|
"title": "Description"
|
|
},
|
|
"content": {
|
|
"type": "string",
|
|
"title": "Content"
|
|
},
|
|
"confidence": {
|
|
"type": "number",
|
|
"title": "Confidence"
|
|
},
|
|
"maturity_score": {
|
|
"type": "number",
|
|
"title": "Maturity Score"
|
|
},
|
|
"source_case_ids": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array",
|
|
"title": "Source Case Ids"
|
|
}
|
|
},
|
|
"additionalProperties": false,
|
|
"type": "object",
|
|
"required": [
|
|
"id",
|
|
"agent_id",
|
|
"name",
|
|
"description",
|
|
"content",
|
|
"confidence",
|
|
"maturity_score"
|
|
],
|
|
"title": "GetAgentSkillItem",
|
|
"description": "Agent skill listing item — always agent-scoped."
|
|
},
|
|
"GetData": {
|
|
"properties": {
|
|
"episodes": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/GetEpisodeItem"
|
|
},
|
|
"type": "array",
|
|
"title": "Episodes"
|
|
},
|
|
"profiles": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/GetProfileItem"
|
|
},
|
|
"type": "array",
|
|
"title": "Profiles"
|
|
},
|
|
"agent_cases": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/GetAgentCaseItem"
|
|
},
|
|
"type": "array",
|
|
"title": "Agent Cases"
|
|
},
|
|
"agent_skills": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/GetAgentSkillItem"
|
|
},
|
|
"type": "array",
|
|
"title": "Agent Skills"
|
|
},
|
|
"total_count": {
|
|
"type": "integer",
|
|
"title": "Total Count",
|
|
"default": 0
|
|
},
|
|
"count": {
|
|
"type": "integer",
|
|
"title": "Count",
|
|
"default": 0
|
|
}
|
|
},
|
|
"additionalProperties": false,
|
|
"type": "object",
|
|
"title": "GetData",
|
|
"description": "Body of ``response.data``.\n\nAll four arrays are always present so client code can iterate\nwithout branching on ``memory_type``; the route populates exactly\none."
|
|
},
|
|
"GetEpisodeItem": {
|
|
"properties": {
|
|
"id": {
|
|
"type": "string",
|
|
"title": "Id"
|
|
},
|
|
"user_id": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "User Id"
|
|
},
|
|
"app_id": {
|
|
"type": "string",
|
|
"title": "App Id",
|
|
"default": "default"
|
|
},
|
|
"project_id": {
|
|
"type": "string",
|
|
"title": "Project Id",
|
|
"default": "default"
|
|
},
|
|
"session_id": {
|
|
"type": "string",
|
|
"title": "Session Id"
|
|
},
|
|
"timestamp": {
|
|
"type": "string",
|
|
"format": "date-time",
|
|
"title": "Timestamp"
|
|
},
|
|
"sender_ids": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array",
|
|
"title": "Sender Ids"
|
|
},
|
|
"summary": {
|
|
"type": "string",
|
|
"title": "Summary"
|
|
},
|
|
"subject": {
|
|
"type": "string",
|
|
"title": "Subject"
|
|
},
|
|
"episode": {
|
|
"type": "string",
|
|
"title": "Episode"
|
|
},
|
|
"type": {
|
|
"type": "string",
|
|
"const": "Conversation",
|
|
"title": "Type"
|
|
}
|
|
},
|
|
"additionalProperties": false,
|
|
"type": "object",
|
|
"required": [
|
|
"id",
|
|
"user_id",
|
|
"session_id",
|
|
"timestamp",
|
|
"summary",
|
|
"subject",
|
|
"episode",
|
|
"type"
|
|
],
|
|
"title": "GetEpisodeItem",
|
|
"description": "Episode listing item — always user-scoped."
|
|
},
|
|
"GetMemoryType": {
|
|
"type": "string",
|
|
"enum": [
|
|
"episode",
|
|
"profile",
|
|
"agent_case",
|
|
"agent_skill"
|
|
],
|
|
"title": "GetMemoryType",
|
|
"description": "The four kinds enumerated by ``/get``.\n\n``episode`` and ``profile`` are user-owned; ``agent_case`` and\n``agent_skill`` are agent-owned. Cross-pairs are rejected by\n:meth:`GetRequest._validate_owner_memory_type_pair`.\n\nNaming note: all four values use the bare kind name (no\n``_memory`` suffix) and match the LanceDB table name + everalgo\ntype name for that kind."
|
|
},
|
|
"GetProfileItem": {
|
|
"properties": {
|
|
"id": {
|
|
"type": "string",
|
|
"title": "Id"
|
|
},
|
|
"user_id": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "User Id"
|
|
},
|
|
"app_id": {
|
|
"type": "string",
|
|
"title": "App Id",
|
|
"default": "default"
|
|
},
|
|
"project_id": {
|
|
"type": "string",
|
|
"title": "Project Id",
|
|
"default": "default"
|
|
},
|
|
"profile_data": {
|
|
"additionalProperties": true,
|
|
"type": "object",
|
|
"title": "Profile Data"
|
|
}
|
|
},
|
|
"additionalProperties": false,
|
|
"type": "object",
|
|
"required": [
|
|
"id",
|
|
"user_id",
|
|
"profile_data"
|
|
],
|
|
"title": "GetProfileItem",
|
|
"description": "Owner profile — at most one per response, only for user owners."
|
|
},
|
|
"GetRequest": {
|
|
"properties": {
|
|
"user_id": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string",
|
|
"minLength": 1
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "User Id"
|
|
},
|
|
"agent_id": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string",
|
|
"minLength": 1
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Agent Id"
|
|
},
|
|
"app_id": {
|
|
"type": "string",
|
|
"title": "App Id",
|
|
"default": "default"
|
|
},
|
|
"project_id": {
|
|
"type": "string",
|
|
"title": "Project Id",
|
|
"default": "default"
|
|
},
|
|
"memory_type": {
|
|
"$ref": "#/components/schemas/GetMemoryType"
|
|
},
|
|
"page": {
|
|
"type": "integer",
|
|
"minimum": 1.0,
|
|
"title": "Page",
|
|
"default": 1
|
|
},
|
|
"page_size": {
|
|
"type": "integer",
|
|
"maximum": 100.0,
|
|
"minimum": 1.0,
|
|
"title": "Page Size",
|
|
"default": 20
|
|
},
|
|
"sort_by": {
|
|
"type": "string",
|
|
"enum": [
|
|
"timestamp",
|
|
"updated_at"
|
|
],
|
|
"title": "Sort By",
|
|
"default": "timestamp"
|
|
},
|
|
"sort_order": {
|
|
"type": "string",
|
|
"enum": [
|
|
"asc",
|
|
"desc"
|
|
],
|
|
"title": "Sort Order",
|
|
"default": "desc"
|
|
},
|
|
"filters": {
|
|
"anyOf": [
|
|
{
|
|
"$ref": "#/components/schemas/FilterNode"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
}
|
|
},
|
|
"additionalProperties": false,
|
|
"type": "object",
|
|
"required": [
|
|
"memory_type"
|
|
],
|
|
"title": "GetRequest",
|
|
"description": "Request body for ``POST /api/v2/memory/get``.\n\nCallers identify the memory owner via ``user_id`` XOR ``agent_id`` —\nexactly one must be set. Internally the manager keeps using\n``owner_id`` / ``owner_type`` (the storage tables' columns); those\nare exposed as derived properties so the rename only affects the\nwire contract."
|
|
},
|
|
"GetResponse": {
|
|
"properties": {
|
|
"request_id": {
|
|
"type": "string",
|
|
"title": "Request Id"
|
|
},
|
|
"data": {
|
|
"$ref": "#/components/schemas/GetData"
|
|
}
|
|
},
|
|
"additionalProperties": false,
|
|
"type": "object",
|
|
"required": [
|
|
"request_id",
|
|
"data"
|
|
],
|
|
"title": "GetResponse",
|
|
"description": "Top-level response envelope."
|
|
},
|
|
"HTTPValidationError": {
|
|
"properties": {
|
|
"detail": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/ValidationError"
|
|
},
|
|
"type": "array",
|
|
"title": "Detail"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"title": "HTTPValidationError"
|
|
},
|
|
"HealthCapabilities": {
|
|
"properties": {
|
|
"llm": {
|
|
"type": "boolean",
|
|
"title": "Llm"
|
|
},
|
|
"embed": {
|
|
"type": "boolean",
|
|
"title": "Embed"
|
|
},
|
|
"rerank": {
|
|
"type": "boolean",
|
|
"title": "Rerank"
|
|
},
|
|
"multimodal_llm": {
|
|
"type": "boolean",
|
|
"title": "Multimodal Llm"
|
|
},
|
|
"parser": {
|
|
"type": "boolean",
|
|
"title": "Parser"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"required": [
|
|
"llm",
|
|
"embed",
|
|
"rerank",
|
|
"multimodal_llm",
|
|
"parser"
|
|
],
|
|
"title": "HealthCapabilities",
|
|
"description": "Availability flags for the five capability probes.\n\nField order matches the health-endpoint payload contract; clients\nkey off these names to decide whether to expose optional features."
|
|
},
|
|
"HealthResponse": {
|
|
"properties": {
|
|
"status": {
|
|
"type": "string",
|
|
"title": "Status"
|
|
},
|
|
"version": {
|
|
"type": "string",
|
|
"title": "Version"
|
|
},
|
|
"capabilities": {
|
|
"$ref": "#/components/schemas/HealthCapabilities"
|
|
},
|
|
"disabled_features": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array",
|
|
"title": "Disabled Features"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"required": [
|
|
"status",
|
|
"version",
|
|
"capabilities",
|
|
"disabled_features"
|
|
],
|
|
"title": "HealthResponse",
|
|
"description": "Response schema for ``GET /health``.\n\nDeclared as a Pydantic model (not ``dict``) so the generated\nOpenAPI schema carries the full field shape — ``capabilities`` and\n``disabled_features`` are typed. A bare ``-> dict`` return type\ndegrades the OpenAPI response to ``additionalProperties: true``,\nwhich robs clients (and codegen) of any structure to lean on."
|
|
},
|
|
"KnowledgeSearchRequest": {
|
|
"properties": {
|
|
"query": {
|
|
"type": "string",
|
|
"maxLength": 2000,
|
|
"minLength": 1,
|
|
"title": "Query"
|
|
},
|
|
"method": {
|
|
"type": "string",
|
|
"enum": [
|
|
"keyword",
|
|
"vector",
|
|
"hybrid"
|
|
],
|
|
"title": "Method",
|
|
"default": "hybrid"
|
|
},
|
|
"top_k": {
|
|
"type": "integer",
|
|
"maximum": 100.0,
|
|
"minimum": 1.0,
|
|
"title": "Top K",
|
|
"default": 10
|
|
},
|
|
"score_threshold": {
|
|
"anyOf": [
|
|
{
|
|
"type": "number"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Score Threshold"
|
|
},
|
|
"include_content": {
|
|
"type": "boolean",
|
|
"title": "Include Content",
|
|
"default": false
|
|
},
|
|
"app_id": {
|
|
"type": "string",
|
|
"title": "App Id",
|
|
"default": "default"
|
|
},
|
|
"project_id": {
|
|
"type": "string",
|
|
"title": "Project Id",
|
|
"default": "default"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"required": [
|
|
"query"
|
|
],
|
|
"title": "KnowledgeSearchRequest",
|
|
"description": "Request body for POST /search."
|
|
},
|
|
"KnowledgeSearchResponse": {
|
|
"properties": {
|
|
"hits": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/SearchHitDTO"
|
|
},
|
|
"type": "array",
|
|
"title": "Hits"
|
|
},
|
|
"total": {
|
|
"type": "integer",
|
|
"title": "Total"
|
|
},
|
|
"took_ms": {
|
|
"type": "number",
|
|
"title": "Took Ms"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"required": [
|
|
"hits",
|
|
"total",
|
|
"took_ms"
|
|
],
|
|
"title": "KnowledgeSearchResponse",
|
|
"description": "Response for POST /search."
|
|
},
|
|
"MemorizeAddRequest": {
|
|
"properties": {
|
|
"session_id": {
|
|
"type": "string",
|
|
"maxLength": 128,
|
|
"minLength": 1,
|
|
"title": "Session Id"
|
|
},
|
|
"app_id": {
|
|
"type": "string",
|
|
"maxLength": 128,
|
|
"minLength": 1,
|
|
"pattern": "^[a-zA-Z0-9_.@+-]+$",
|
|
"title": "App Id",
|
|
"default": "default"
|
|
},
|
|
"project_id": {
|
|
"type": "string",
|
|
"maxLength": 128,
|
|
"minLength": 1,
|
|
"pattern": "^[a-zA-Z0-9_.@+-]+$",
|
|
"title": "Project Id",
|
|
"default": "default"
|
|
},
|
|
"messages": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/MessageItemDTO"
|
|
},
|
|
"type": "array",
|
|
"maxItems": 500,
|
|
"minItems": 1,
|
|
"title": "Messages"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"required": [
|
|
"session_id",
|
|
"messages"
|
|
],
|
|
"title": "MemorizeAddRequest"
|
|
},
|
|
"MemorizeFlushRequest": {
|
|
"properties": {
|
|
"session_id": {
|
|
"type": "string",
|
|
"maxLength": 128,
|
|
"minLength": 1,
|
|
"title": "Session Id"
|
|
},
|
|
"app_id": {
|
|
"type": "string",
|
|
"maxLength": 128,
|
|
"minLength": 1,
|
|
"pattern": "^[a-zA-Z0-9_.@+-]+$",
|
|
"title": "App Id",
|
|
"default": "default"
|
|
},
|
|
"project_id": {
|
|
"type": "string",
|
|
"maxLength": 128,
|
|
"minLength": 1,
|
|
"pattern": "^[a-zA-Z0-9_.@+-]+$",
|
|
"title": "Project Id",
|
|
"default": "default"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"required": [
|
|
"session_id"
|
|
],
|
|
"title": "MemorizeFlushRequest"
|
|
},
|
|
"MessageItemDTO": {
|
|
"properties": {
|
|
"sender_id": {
|
|
"type": "string",
|
|
"maxLength": 128,
|
|
"minLength": 1,
|
|
"pattern": "^[a-zA-Z0-9_.@+-]+$",
|
|
"title": "Sender Id"
|
|
},
|
|
"sender_name": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Sender Name"
|
|
},
|
|
"role": {
|
|
"type": "string",
|
|
"enum": [
|
|
"user",
|
|
"assistant",
|
|
"tool"
|
|
],
|
|
"title": "Role"
|
|
},
|
|
"timestamp": {
|
|
"type": "integer",
|
|
"exclusiveMinimum": 0.0,
|
|
"title": "Timestamp",
|
|
"description": "Message event time as Unix epoch in **milliseconds** (v1 API contract; the algo layer auto-detects sec vs ms for backward compat but the contract is ms)."
|
|
},
|
|
"content": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"items": {
|
|
"$ref": "#/components/schemas/ContentItemDTO"
|
|
},
|
|
"type": "array"
|
|
}
|
|
],
|
|
"title": "Content"
|
|
},
|
|
"tool_calls": {
|
|
"anyOf": [
|
|
{
|
|
"items": {
|
|
"$ref": "#/components/schemas/ToolCallDTO"
|
|
},
|
|
"type": "array"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Tool Calls"
|
|
},
|
|
"tool_call_id": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Tool Call Id"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"required": [
|
|
"sender_id",
|
|
"role",
|
|
"timestamp",
|
|
"content"
|
|
],
|
|
"title": "MessageItemDTO"
|
|
},
|
|
"SearchAgentCaseItem": {
|
|
"properties": {
|
|
"id": {
|
|
"type": "string",
|
|
"title": "Id"
|
|
},
|
|
"agent_id": {
|
|
"type": "string",
|
|
"title": "Agent Id"
|
|
},
|
|
"app_id": {
|
|
"type": "string",
|
|
"title": "App Id",
|
|
"default": "default"
|
|
},
|
|
"project_id": {
|
|
"type": "string",
|
|
"title": "Project Id",
|
|
"default": "default"
|
|
},
|
|
"session_id": {
|
|
"type": "string",
|
|
"title": "Session Id"
|
|
},
|
|
"task_intent": {
|
|
"type": "string",
|
|
"title": "Task Intent"
|
|
},
|
|
"approach": {
|
|
"type": "string",
|
|
"title": "Approach"
|
|
},
|
|
"quality_score": {
|
|
"type": "number",
|
|
"title": "Quality Score"
|
|
},
|
|
"key_insight": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Key Insight"
|
|
},
|
|
"timestamp": {
|
|
"type": "string",
|
|
"format": "date-time",
|
|
"title": "Timestamp"
|
|
},
|
|
"score": {
|
|
"type": "number",
|
|
"title": "Score"
|
|
}
|
|
},
|
|
"additionalProperties": false,
|
|
"type": "object",
|
|
"required": [
|
|
"id",
|
|
"agent_id",
|
|
"session_id",
|
|
"task_intent",
|
|
"approach",
|
|
"quality_score",
|
|
"timestamp",
|
|
"score"
|
|
],
|
|
"title": "SearchAgentCaseItem",
|
|
"description": "Agent case hit — always agent-scoped."
|
|
},
|
|
"SearchAgentSkillItem": {
|
|
"properties": {
|
|
"id": {
|
|
"type": "string",
|
|
"title": "Id"
|
|
},
|
|
"agent_id": {
|
|
"type": "string",
|
|
"title": "Agent Id"
|
|
},
|
|
"app_id": {
|
|
"type": "string",
|
|
"title": "App Id",
|
|
"default": "default"
|
|
},
|
|
"project_id": {
|
|
"type": "string",
|
|
"title": "Project Id",
|
|
"default": "default"
|
|
},
|
|
"name": {
|
|
"type": "string",
|
|
"title": "Name"
|
|
},
|
|
"description": {
|
|
"type": "string",
|
|
"title": "Description"
|
|
},
|
|
"content": {
|
|
"type": "string",
|
|
"title": "Content"
|
|
},
|
|
"confidence": {
|
|
"type": "number",
|
|
"title": "Confidence"
|
|
},
|
|
"maturity_score": {
|
|
"type": "number",
|
|
"title": "Maturity Score"
|
|
},
|
|
"source_case_ids": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array",
|
|
"title": "Source Case Ids"
|
|
},
|
|
"score": {
|
|
"type": "number",
|
|
"title": "Score"
|
|
}
|
|
},
|
|
"additionalProperties": false,
|
|
"type": "object",
|
|
"required": [
|
|
"id",
|
|
"agent_id",
|
|
"name",
|
|
"description",
|
|
"content",
|
|
"confidence",
|
|
"maturity_score",
|
|
"score"
|
|
],
|
|
"title": "SearchAgentSkillItem",
|
|
"description": "Agent skill hit — always agent-scoped."
|
|
},
|
|
"SearchAtomicFactItem": {
|
|
"properties": {
|
|
"id": {
|
|
"type": "string",
|
|
"title": "Id"
|
|
},
|
|
"content": {
|
|
"type": "string",
|
|
"title": "Content"
|
|
},
|
|
"score": {
|
|
"type": "number",
|
|
"title": "Score"
|
|
}
|
|
},
|
|
"additionalProperties": false,
|
|
"type": "object",
|
|
"required": [
|
|
"id",
|
|
"content",
|
|
"score"
|
|
],
|
|
"title": "SearchAtomicFactItem",
|
|
"description": "A single atomic fact nested inside its parent episode."
|
|
},
|
|
"SearchData": {
|
|
"properties": {
|
|
"episodes": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/SearchEpisodeItem"
|
|
},
|
|
"type": "array",
|
|
"title": "Episodes"
|
|
},
|
|
"profiles": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/SearchProfileItem"
|
|
},
|
|
"type": "array",
|
|
"title": "Profiles"
|
|
},
|
|
"agent_cases": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/SearchAgentCaseItem"
|
|
},
|
|
"type": "array",
|
|
"title": "Agent Cases"
|
|
},
|
|
"agent_skills": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/SearchAgentSkillItem"
|
|
},
|
|
"type": "array",
|
|
"title": "Agent Skills"
|
|
},
|
|
"unprocessed_messages": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/UnprocessedMessageDTO"
|
|
},
|
|
"type": "array",
|
|
"title": "Unprocessed Messages"
|
|
}
|
|
},
|
|
"additionalProperties": false,
|
|
"type": "object",
|
|
"title": "SearchData",
|
|
"description": "Body of ``response.data``.\n\nAll five arrays are always present so client code can iterate without\nbranching on ``owner_type``. Routes not applicable to the request's\nowner type stay as ``[]``. ``unprocessed_messages`` is filled only\nwhen ``filters.session_id`` is present as a top-level eq scalar —\nin-flight buffer rows are scope-tagged but unattributed (no\n``user_id``), so session is the only meaningful query dimension."
|
|
},
|
|
"SearchEpisodeItem": {
|
|
"properties": {
|
|
"id": {
|
|
"type": "string",
|
|
"title": "Id"
|
|
},
|
|
"user_id": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "User Id"
|
|
},
|
|
"app_id": {
|
|
"type": "string",
|
|
"title": "App Id",
|
|
"default": "default"
|
|
},
|
|
"project_id": {
|
|
"type": "string",
|
|
"title": "Project Id",
|
|
"default": "default"
|
|
},
|
|
"session_id": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Session Id"
|
|
},
|
|
"timestamp": {
|
|
"type": "string",
|
|
"format": "date-time",
|
|
"title": "Timestamp"
|
|
},
|
|
"sender_ids": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array",
|
|
"title": "Sender Ids"
|
|
},
|
|
"summary": {
|
|
"type": "string",
|
|
"title": "Summary"
|
|
},
|
|
"subject": {
|
|
"type": "string",
|
|
"title": "Subject"
|
|
},
|
|
"episode": {
|
|
"type": "string",
|
|
"title": "Episode"
|
|
},
|
|
"type": {
|
|
"type": "string",
|
|
"const": "Conversation",
|
|
"title": "Type"
|
|
},
|
|
"score": {
|
|
"type": "number",
|
|
"title": "Score"
|
|
},
|
|
"atomic_facts": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/SearchAtomicFactItem"
|
|
},
|
|
"type": "array",
|
|
"title": "Atomic Facts"
|
|
}
|
|
},
|
|
"additionalProperties": false,
|
|
"type": "object",
|
|
"required": [
|
|
"id",
|
|
"user_id",
|
|
"timestamp",
|
|
"summary",
|
|
"subject",
|
|
"episode",
|
|
"type",
|
|
"score"
|
|
],
|
|
"title": "SearchEpisodeItem",
|
|
"description": "Episode hit — always user-scoped in the current emission contract.\n\n``type`` is narrowed to ``\"Conversation\"`` because the only emitted\nepisode shape today is conversation-derived; widen when other\nsources ship. Item kind is encoded by class name (no ``owner_type``\nfield on the wire), so episode results never carry ambiguity."
|
|
},
|
|
"SearchHitDTO": {
|
|
"properties": {
|
|
"topic_id": {
|
|
"type": "string",
|
|
"title": "Topic Id"
|
|
},
|
|
"category_id": {
|
|
"type": "string",
|
|
"title": "Category Id"
|
|
},
|
|
"topic_name": {
|
|
"type": "string",
|
|
"title": "Topic Name"
|
|
},
|
|
"topic_path": {
|
|
"type": "string",
|
|
"title": "Topic Path"
|
|
},
|
|
"depth": {
|
|
"type": "integer",
|
|
"title": "Depth"
|
|
},
|
|
"summary": {
|
|
"type": "string",
|
|
"title": "Summary"
|
|
},
|
|
"content": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Content"
|
|
},
|
|
"score": {
|
|
"type": "number",
|
|
"title": "Score"
|
|
},
|
|
"retrieval_method": {
|
|
"type": "string",
|
|
"title": "Retrieval Method"
|
|
},
|
|
"source": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Source"
|
|
},
|
|
"document": {
|
|
"$ref": "#/components/schemas/DocumentContextDTO"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"required": [
|
|
"topic_id",
|
|
"category_id",
|
|
"topic_name",
|
|
"topic_path",
|
|
"depth",
|
|
"summary",
|
|
"content",
|
|
"score",
|
|
"retrieval_method",
|
|
"source",
|
|
"document"
|
|
],
|
|
"title": "SearchHitDTO",
|
|
"description": "One ranked result from knowledge search."
|
|
},
|
|
"SearchMethod": {
|
|
"type": "string",
|
|
"enum": [
|
|
"keyword",
|
|
"vector",
|
|
"hybrid",
|
|
"agentic"
|
|
],
|
|
"title": "SearchMethod",
|
|
"description": "Public method enum. RRF / LR / vector_anchored are hidden under HYBRID."
|
|
},
|
|
"SearchProfileItem": {
|
|
"properties": {
|
|
"id": {
|
|
"type": "string",
|
|
"title": "Id"
|
|
},
|
|
"user_id": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "User Id"
|
|
},
|
|
"app_id": {
|
|
"type": "string",
|
|
"title": "App Id",
|
|
"default": "default"
|
|
},
|
|
"project_id": {
|
|
"type": "string",
|
|
"title": "Project Id",
|
|
"default": "default"
|
|
},
|
|
"profile_data": {
|
|
"additionalProperties": true,
|
|
"type": "object",
|
|
"title": "Profile Data"
|
|
},
|
|
"score": {
|
|
"anyOf": [
|
|
{
|
|
"type": "number"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Score"
|
|
}
|
|
},
|
|
"additionalProperties": false,
|
|
"type": "object",
|
|
"required": [
|
|
"id",
|
|
"user_id",
|
|
"profile_data"
|
|
],
|
|
"title": "SearchProfileItem",
|
|
"description": "Owner profile — at most one per response, only for user owners.\n\n``score`` is ``None`` for direct fetches (``include_profile=true``\non its own does no ranking); a future query-aware lookup may fill\nit in."
|
|
},
|
|
"SearchRequest": {
|
|
"properties": {
|
|
"user_id": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string",
|
|
"minLength": 1
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "User Id"
|
|
},
|
|
"agent_id": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string",
|
|
"minLength": 1
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Agent Id"
|
|
},
|
|
"app_id": {
|
|
"type": "string",
|
|
"title": "App Id",
|
|
"default": "default"
|
|
},
|
|
"project_id": {
|
|
"type": "string",
|
|
"title": "Project Id",
|
|
"default": "default"
|
|
},
|
|
"query": {
|
|
"type": "string",
|
|
"minLength": 1,
|
|
"title": "Query"
|
|
},
|
|
"method": {
|
|
"$ref": "#/components/schemas/SearchMethod",
|
|
"default": "hybrid"
|
|
},
|
|
"top_k": {
|
|
"type": "integer",
|
|
"title": "Top K",
|
|
"default": -1
|
|
},
|
|
"radius": {
|
|
"anyOf": [
|
|
{
|
|
"type": "number",
|
|
"maximum": 1.0,
|
|
"minimum": 0.0
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Radius"
|
|
},
|
|
"min_score": {
|
|
"anyOf": [
|
|
{
|
|
"type": "number",
|
|
"maximum": 1.0,
|
|
"minimum": 0.0
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Min Score"
|
|
},
|
|
"include_profile": {
|
|
"type": "boolean",
|
|
"title": "Include Profile",
|
|
"default": false
|
|
},
|
|
"enable_llm_rerank": {
|
|
"type": "boolean",
|
|
"title": "Enable Llm Rerank",
|
|
"description": "Opt-in LLM rerank pass for HYBRID. Applies to agent_case and agent_skill fusion only; the episode hybrid path has built-in fact eviction and ignores this flag. Ignored by keyword / vector / agentic.",
|
|
"default": false
|
|
},
|
|
"filters": {
|
|
"anyOf": [
|
|
{
|
|
"$ref": "#/components/schemas/FilterNode"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
}
|
|
},
|
|
"additionalProperties": false,
|
|
"type": "object",
|
|
"required": [
|
|
"query"
|
|
],
|
|
"title": "SearchRequest",
|
|
"description": "Request body for ``POST /api/v2/memory/search``.\n\nCallers identify the memory owner via ``user_id`` XOR ``agent_id`` —\nexactly one must be set. Internally the manager + compile_filters keep\nusing ``owner_id`` / ``owner_type`` (the storage tables' columns);\nthose are exposed as derived properties so the rename only affects\nthe wire contract, not the internal recall plumbing."
|
|
},
|
|
"SearchResponse": {
|
|
"properties": {
|
|
"request_id": {
|
|
"type": "string",
|
|
"title": "Request Id"
|
|
},
|
|
"data": {
|
|
"$ref": "#/components/schemas/SearchData"
|
|
}
|
|
},
|
|
"additionalProperties": false,
|
|
"type": "object",
|
|
"required": [
|
|
"request_id",
|
|
"data"
|
|
],
|
|
"title": "SearchResponse",
|
|
"description": "Top-level response envelope."
|
|
},
|
|
"SuccessEnvelope_AddResponseData_": {
|
|
"properties": {
|
|
"request_id": {
|
|
"type": "string",
|
|
"title": "Request Id"
|
|
},
|
|
"data": {
|
|
"$ref": "#/components/schemas/AddResponseData"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"required": [
|
|
"request_id",
|
|
"data"
|
|
],
|
|
"title": "SuccessEnvelope[AddResponseData]"
|
|
},
|
|
"SuccessEnvelope_CategoryListResponse_": {
|
|
"properties": {
|
|
"request_id": {
|
|
"type": "string",
|
|
"title": "Request Id"
|
|
},
|
|
"data": {
|
|
"$ref": "#/components/schemas/CategoryListResponse"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"required": [
|
|
"request_id",
|
|
"data"
|
|
],
|
|
"title": "SuccessEnvelope[CategoryListResponse]"
|
|
},
|
|
"SuccessEnvelope_DocumentCreateResponse_": {
|
|
"properties": {
|
|
"request_id": {
|
|
"type": "string",
|
|
"title": "Request Id"
|
|
},
|
|
"data": {
|
|
"$ref": "#/components/schemas/DocumentCreateResponse"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"required": [
|
|
"request_id",
|
|
"data"
|
|
],
|
|
"title": "SuccessEnvelope[DocumentCreateResponse]"
|
|
},
|
|
"SuccessEnvelope_DocumentDetailResponse_": {
|
|
"properties": {
|
|
"request_id": {
|
|
"type": "string",
|
|
"title": "Request Id"
|
|
},
|
|
"data": {
|
|
"$ref": "#/components/schemas/DocumentDetailResponse"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"required": [
|
|
"request_id",
|
|
"data"
|
|
],
|
|
"title": "SuccessEnvelope[DocumentDetailResponse]"
|
|
},
|
|
"SuccessEnvelope_DocumentListResponse_": {
|
|
"properties": {
|
|
"request_id": {
|
|
"type": "string",
|
|
"title": "Request Id"
|
|
},
|
|
"data": {
|
|
"$ref": "#/components/schemas/DocumentListResponse"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"required": [
|
|
"request_id",
|
|
"data"
|
|
],
|
|
"title": "SuccessEnvelope[DocumentListResponse]"
|
|
},
|
|
"SuccessEnvelope_DocumentPatchResponse_": {
|
|
"properties": {
|
|
"request_id": {
|
|
"type": "string",
|
|
"title": "Request Id"
|
|
},
|
|
"data": {
|
|
"$ref": "#/components/schemas/DocumentPatchResponse"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"required": [
|
|
"request_id",
|
|
"data"
|
|
],
|
|
"title": "SuccessEnvelope[DocumentPatchResponse]"
|
|
},
|
|
"SuccessEnvelope_FlushResponseData_": {
|
|
"properties": {
|
|
"request_id": {
|
|
"type": "string",
|
|
"title": "Request Id"
|
|
},
|
|
"data": {
|
|
"$ref": "#/components/schemas/FlushResponseData"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"required": [
|
|
"request_id",
|
|
"data"
|
|
],
|
|
"title": "SuccessEnvelope[FlushResponseData]"
|
|
},
|
|
"SuccessEnvelope_KnowledgeSearchResponse_": {
|
|
"properties": {
|
|
"request_id": {
|
|
"type": "string",
|
|
"title": "Request Id"
|
|
},
|
|
"data": {
|
|
"$ref": "#/components/schemas/KnowledgeSearchResponse"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"required": [
|
|
"request_id",
|
|
"data"
|
|
],
|
|
"title": "SuccessEnvelope[KnowledgeSearchResponse]"
|
|
},
|
|
"SuccessEnvelope_TopicDetailResponse_": {
|
|
"properties": {
|
|
"request_id": {
|
|
"type": "string",
|
|
"title": "Request Id"
|
|
},
|
|
"data": {
|
|
"$ref": "#/components/schemas/TopicDetailResponse"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"required": [
|
|
"request_id",
|
|
"data"
|
|
],
|
|
"title": "SuccessEnvelope[TopicDetailResponse]"
|
|
},
|
|
"ToolCallDTO": {
|
|
"properties": {
|
|
"id": {
|
|
"type": "string",
|
|
"title": "Id"
|
|
},
|
|
"type": {
|
|
"type": "string",
|
|
"title": "Type",
|
|
"default": "function"
|
|
},
|
|
"function": {
|
|
"$ref": "#/components/schemas/ToolFunctionDTO"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"required": [
|
|
"id",
|
|
"function"
|
|
],
|
|
"title": "ToolCallDTO"
|
|
},
|
|
"ToolFunctionDTO": {
|
|
"properties": {
|
|
"name": {
|
|
"type": "string",
|
|
"title": "Name"
|
|
},
|
|
"arguments": {
|
|
"type": "string",
|
|
"title": "Arguments"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"required": [
|
|
"name",
|
|
"arguments"
|
|
],
|
|
"title": "ToolFunctionDTO"
|
|
},
|
|
"TopicDetailResponse": {
|
|
"properties": {
|
|
"topic_id": {
|
|
"type": "string",
|
|
"title": "Topic Id"
|
|
},
|
|
"doc_id": {
|
|
"type": "string",
|
|
"title": "Doc Id"
|
|
},
|
|
"category_id": {
|
|
"type": "string",
|
|
"title": "Category Id"
|
|
},
|
|
"topic_name": {
|
|
"type": "string",
|
|
"title": "Topic Name"
|
|
},
|
|
"topic_path": {
|
|
"type": "string",
|
|
"title": "Topic Path"
|
|
},
|
|
"depth": {
|
|
"type": "integer",
|
|
"title": "Depth"
|
|
},
|
|
"summary": {
|
|
"type": "string",
|
|
"title": "Summary"
|
|
},
|
|
"content": {
|
|
"type": "string",
|
|
"title": "Content"
|
|
},
|
|
"content_labels": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array",
|
|
"title": "Content Labels"
|
|
},
|
|
"parent_topic_id": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Parent Topic Id"
|
|
},
|
|
"children_topic_ids": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array",
|
|
"title": "Children Topic Ids"
|
|
},
|
|
"created_at": {
|
|
"type": "string",
|
|
"format": "date-time",
|
|
"title": "Created At"
|
|
},
|
|
"updated_at": {
|
|
"type": "string",
|
|
"format": "date-time",
|
|
"title": "Updated At"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"required": [
|
|
"topic_id",
|
|
"doc_id",
|
|
"category_id",
|
|
"topic_name",
|
|
"topic_path",
|
|
"depth",
|
|
"summary",
|
|
"content",
|
|
"content_labels",
|
|
"parent_topic_id",
|
|
"children_topic_ids",
|
|
"created_at",
|
|
"updated_at"
|
|
],
|
|
"title": "TopicDetailResponse",
|
|
"description": "Response for GET /topics/{topic_id}."
|
|
},
|
|
"TopicOverviewDTO": {
|
|
"properties": {
|
|
"topic_id": {
|
|
"type": "string",
|
|
"title": "Topic Id"
|
|
},
|
|
"topic_name": {
|
|
"type": "string",
|
|
"title": "Topic Name"
|
|
},
|
|
"topic_path": {
|
|
"type": "string",
|
|
"title": "Topic Path"
|
|
},
|
|
"depth": {
|
|
"type": "integer",
|
|
"title": "Depth"
|
|
},
|
|
"summary": {
|
|
"type": "string",
|
|
"title": "Summary"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"required": [
|
|
"topic_id",
|
|
"topic_name",
|
|
"topic_path",
|
|
"depth",
|
|
"summary"
|
|
],
|
|
"title": "TopicOverviewDTO",
|
|
"description": "Minimal topic summary inside a document detail."
|
|
},
|
|
"TriggerRequest": {
|
|
"properties": {
|
|
"name": {
|
|
"type": "string",
|
|
"title": "Name"
|
|
},
|
|
"timeout": {
|
|
"type": "number",
|
|
"title": "Timeout",
|
|
"default": 120.0
|
|
},
|
|
"force": {
|
|
"type": "boolean",
|
|
"title": "Force",
|
|
"default": false
|
|
}
|
|
},
|
|
"type": "object",
|
|
"required": [
|
|
"name"
|
|
],
|
|
"title": "TriggerRequest",
|
|
"description": "Request body for ``POST /api/v2/ome/trigger``."
|
|
},
|
|
"TriggerResponse": {
|
|
"properties": {
|
|
"status": {
|
|
"type": "string",
|
|
"title": "Status"
|
|
},
|
|
"name": {
|
|
"type": "string",
|
|
"title": "Name"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"required": [
|
|
"status",
|
|
"name"
|
|
],
|
|
"title": "TriggerResponse",
|
|
"description": "Response body for ``POST /api/v2/ome/trigger``."
|
|
},
|
|
"UnprocessedMessageDTO": {
|
|
"properties": {
|
|
"id": {
|
|
"type": "string",
|
|
"title": "Id"
|
|
},
|
|
"app_id": {
|
|
"type": "string",
|
|
"title": "App Id",
|
|
"default": "default"
|
|
},
|
|
"project_id": {
|
|
"type": "string",
|
|
"title": "Project Id",
|
|
"default": "default"
|
|
},
|
|
"session_id": {
|
|
"type": "string",
|
|
"title": "Session Id"
|
|
},
|
|
"sender_id": {
|
|
"type": "string",
|
|
"title": "Sender Id"
|
|
},
|
|
"sender_name": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Sender Name"
|
|
},
|
|
"role": {
|
|
"type": "string",
|
|
"enum": [
|
|
"user",
|
|
"assistant",
|
|
"tool"
|
|
],
|
|
"title": "Role"
|
|
},
|
|
"content": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"items": {
|
|
"additionalProperties": true,
|
|
"type": "object"
|
|
},
|
|
"type": "array"
|
|
}
|
|
],
|
|
"title": "Content"
|
|
},
|
|
"timestamp": {
|
|
"type": "string",
|
|
"format": "date-time",
|
|
"title": "Timestamp"
|
|
},
|
|
"tool_calls": {
|
|
"anyOf": [
|
|
{
|
|
"items": {
|
|
"additionalProperties": true,
|
|
"type": "object"
|
|
},
|
|
"type": "array"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Tool Calls"
|
|
},
|
|
"tool_call_id": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"title": "Tool Call Id"
|
|
}
|
|
},
|
|
"additionalProperties": false,
|
|
"type": "object",
|
|
"required": [
|
|
"id",
|
|
"session_id",
|
|
"sender_id",
|
|
"role",
|
|
"content",
|
|
"timestamp"
|
|
],
|
|
"title": "UnprocessedMessageDTO",
|
|
"description": "A raw message still in the boundary-detection buffer.\n\nNo extracted memcell yet, no owner inference yet (attribution\nhappens at boundary detection). Returned by ``/search`` **only when**\n``filters.session_id`` is present as a top-level eq predicate —\nunprocessed messages have no ``user_id`` / ``agent_id`` to filter\non, so session is the only meaningful query dimension."
|
|
},
|
|
"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"
|
|
}
|
|
}
|
|
}
|
|
}
|