473 lines
12 KiB
JSON
473 lines
12 KiB
JSON
{
|
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
"$id": "https://kompanion.local/schemas/kompanion-tools.schema.json",
|
|
"title": "Kompanion MCP Tool Manifest",
|
|
"description": "Defines the tools exported by the Kompanion memory daemon.",
|
|
"type": "object",
|
|
"properties": {
|
|
"namespace": {
|
|
"type": "string",
|
|
"description": "Default namespace applied to relative tool names."
|
|
},
|
|
"tools": {
|
|
"type": "object",
|
|
"additionalProperties": {
|
|
"type": "object",
|
|
"properties": {
|
|
"description": {
|
|
"type": "string"
|
|
},
|
|
"input": {
|
|
"$ref": "#/$defs/jsonSchema"
|
|
},
|
|
"output": {
|
|
"$ref": "#/$defs/jsonSchema"
|
|
}
|
|
},
|
|
"required": [
|
|
"description",
|
|
"input",
|
|
"output"
|
|
],
|
|
"additionalProperties": false
|
|
}
|
|
}
|
|
},
|
|
"required": [
|
|
"namespace",
|
|
"tools"
|
|
],
|
|
"additionalProperties": false,
|
|
"$defs": {
|
|
"stringList": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"jsonSchema": {
|
|
"type": "object",
|
|
"description": "A JSON Schema fragment describing tool input or output."
|
|
}
|
|
},
|
|
"examples": [
|
|
{
|
|
"namespace": "kom.memory.v1",
|
|
"tools": {
|
|
"save_context": {
|
|
"description": "Persist context payload in the namespace-backed memory store.",
|
|
"input": {
|
|
"type": "object",
|
|
"properties": {
|
|
"namespace": {
|
|
"type": "string"
|
|
},
|
|
"key": {
|
|
"type": "string"
|
|
},
|
|
"content": {},
|
|
"tags": {
|
|
"$ref": "#/$defs/stringList"
|
|
},
|
|
"ttl_seconds": {
|
|
"type": "integer"
|
|
}
|
|
},
|
|
"required": [
|
|
"namespace",
|
|
"content"
|
|
],
|
|
"additionalProperties": false
|
|
},
|
|
"output": {
|
|
"type": "object",
|
|
"properties": {
|
|
"id": {
|
|
"type": "string"
|
|
},
|
|
"created_at": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"id",
|
|
"created_at"
|
|
],
|
|
"additionalProperties": false
|
|
}
|
|
},
|
|
"recall_context": {
|
|
"description": "Recall stored context entries filtered by key, tags, and time window.",
|
|
"input": {
|
|
"type": "object",
|
|
"properties": {
|
|
"namespace": {
|
|
"type": "string"
|
|
},
|
|
"key": {
|
|
"type": "string"
|
|
},
|
|
"tags": {
|
|
"$ref": "#/$defs/stringList"
|
|
},
|
|
"limit": {
|
|
"type": "integer"
|
|
},
|
|
"since": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"namespace"
|
|
],
|
|
"additionalProperties": false
|
|
},
|
|
"output": {
|
|
"type": "object",
|
|
"properties": {
|
|
"items": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "object",
|
|
"properties": {
|
|
"id": {
|
|
"type": "string"
|
|
},
|
|
"key": {
|
|
"type": "string"
|
|
},
|
|
"content": {},
|
|
"tags": {
|
|
"$ref": "#/$defs/stringList"
|
|
},
|
|
"created_at": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"id",
|
|
"content",
|
|
"created_at"
|
|
],
|
|
"additionalProperties": false
|
|
}
|
|
}
|
|
},
|
|
"required": [
|
|
"items"
|
|
],
|
|
"additionalProperties": false
|
|
}
|
|
},
|
|
"embed_text": {
|
|
"description": "Return embedding vectors for provided text inputs.",
|
|
"input": {
|
|
"type": "object",
|
|
"properties": {
|
|
"model": {
|
|
"type": "string"
|
|
},
|
|
"texts": {
|
|
"$ref": "#/$defs/stringList"
|
|
}
|
|
},
|
|
"required": [
|
|
"texts"
|
|
],
|
|
"additionalProperties": false
|
|
},
|
|
"output": {
|
|
"type": "object",
|
|
"properties": {
|
|
"model": {
|
|
"type": "string"
|
|
},
|
|
"vectors": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "number"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"required": [
|
|
"model",
|
|
"vectors"
|
|
],
|
|
"additionalProperties": false
|
|
}
|
|
},
|
|
"upsert_memory": {
|
|
"description": "Upsert semantic memory items with optional precomputed embeddings.",
|
|
"input": {
|
|
"type": "object",
|
|
"properties": {
|
|
"namespace": {
|
|
"type": "string"
|
|
},
|
|
"items": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "object",
|
|
"properties": {
|
|
"id": {
|
|
"type": "string"
|
|
},
|
|
"text": {
|
|
"type": "string"
|
|
},
|
|
"metadata": {
|
|
"type": "object"
|
|
},
|
|
"embedding": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "number"
|
|
}
|
|
}
|
|
},
|
|
"required": [
|
|
"text"
|
|
],
|
|
"additionalProperties": false
|
|
}
|
|
}
|
|
},
|
|
"required": [
|
|
"namespace",
|
|
"items"
|
|
],
|
|
"additionalProperties": false
|
|
},
|
|
"output": {
|
|
"type": "object",
|
|
"properties": {
|
|
"upserted": {
|
|
"type": "integer"
|
|
}
|
|
},
|
|
"required": [
|
|
"upserted"
|
|
],
|
|
"additionalProperties": false
|
|
}
|
|
},
|
|
"search_memory": {
|
|
"description": "Hybrid semantic search across stored memory chunks.",
|
|
"input": {
|
|
"type": "object",
|
|
"properties": {
|
|
"namespace": {
|
|
"type": "string"
|
|
},
|
|
"query": {
|
|
"type": "object",
|
|
"properties": {
|
|
"text": {
|
|
"type": "string"
|
|
},
|
|
"embedding": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "number"
|
|
}
|
|
},
|
|
"k": {
|
|
"type": "integer"
|
|
},
|
|
"filter": {
|
|
"type": "object"
|
|
}
|
|
},
|
|
"required": [
|
|
"text"
|
|
],
|
|
"additionalProperties": false
|
|
}
|
|
},
|
|
"required": [
|
|
"namespace",
|
|
"query"
|
|
],
|
|
"additionalProperties": false
|
|
},
|
|
"output": {
|
|
"type": "object",
|
|
"properties": {
|
|
"matches": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "object",
|
|
"properties": {
|
|
"id": {
|
|
"type": "string"
|
|
},
|
|
"score": {
|
|
"type": "number"
|
|
},
|
|
"text": {
|
|
"type": "string"
|
|
},
|
|
"metadata": {
|
|
"type": "object"
|
|
}
|
|
},
|
|
"required": [
|
|
"id",
|
|
"score"
|
|
],
|
|
"additionalProperties": false
|
|
}
|
|
}
|
|
},
|
|
"required": [
|
|
"matches"
|
|
],
|
|
"additionalProperties": false
|
|
}
|
|
},
|
|
"warm_cache": {
|
|
"description": "Queue embedding warm-up jobs for recent namespace items.",
|
|
"input": {
|
|
"type": "object",
|
|
"properties": {
|
|
"namespace": {
|
|
"type": "string"
|
|
},
|
|
"since": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"namespace"
|
|
],
|
|
"additionalProperties": false
|
|
},
|
|
"output": {
|
|
"type": "object",
|
|
"properties": {
|
|
"queued": {
|
|
"type": "integer"
|
|
}
|
|
},
|
|
"required": [
|
|
"queued"
|
|
],
|
|
"additionalProperties": false
|
|
}
|
|
},
|
|
"kom.local.v1.backup.export_encrypted": {
|
|
"description": "Queue an encrypted backup export for the requested namespaces.",
|
|
"input": {
|
|
"type": "object",
|
|
"properties": {
|
|
"namespaces": {
|
|
"$ref": "#/$defs/stringList"
|
|
},
|
|
"destination": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"namespaces",
|
|
"destination"
|
|
],
|
|
"additionalProperties": false
|
|
},
|
|
"output": {
|
|
"type": "object",
|
|
"properties": {
|
|
"status": {
|
|
"type": "string"
|
|
},
|
|
"artifact": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"status",
|
|
"artifact"
|
|
],
|
|
"additionalProperties": false
|
|
}
|
|
},
|
|
"kom.local.v1.backup.import_encrypted": {
|
|
"description": "Import an encrypted backup artifact back into the local store.",
|
|
"input": {
|
|
"type": "object",
|
|
"properties": {
|
|
"source": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"source"
|
|
],
|
|
"additionalProperties": false
|
|
},
|
|
"output": {
|
|
"type": "object",
|
|
"properties": {
|
|
"status": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"status"
|
|
],
|
|
"additionalProperties": false
|
|
}
|
|
},
|
|
"kom.meta.v1.project_snapshot": {
|
|
"description": "Produce a high-level project status snapshot for downstream MCP clients.",
|
|
"input": {
|
|
"type": "object",
|
|
"properties": {
|
|
"includeGitStatus": {
|
|
"type": "boolean"
|
|
}
|
|
},
|
|
"additionalProperties": false
|
|
},
|
|
"output": {
|
|
"type": "object",
|
|
"properties": {
|
|
"sections": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "object",
|
|
"properties": {
|
|
"title": {
|
|
"type": "string"
|
|
},
|
|
"body": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"title",
|
|
"body"
|
|
],
|
|
"additionalProperties": false
|
|
}
|
|
},
|
|
"pg_dsn": {
|
|
"type": "string"
|
|
},
|
|
"notes": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"sections"
|
|
],
|
|
"additionalProperties": false
|
|
}
|
|
}
|
|
}
|
|
}
|
|
]
|
|
}
|