{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://github.com/daniloaguiarbr/sqlite-graphrag/schemas/link.schema.json",
"title": "LinkResponse",
"description": "Response emitted by `sqlite-graphrag link` on stdout as JSON. CLI accepts `--from-id`/`--to-id` (v1.1.05) for ID-based endpoints, but the output envelope still reports entity names in `from`/`to` after resolution.",
"type": "object",
"required": ["action", "from", "to", "relation", "weight", "namespace", "elapsed_ms"],
"additionalProperties": false,
"properties": {
"action": { "type": "string", "enum": ["created", "already_exists"] },
"from": { "type": "string", "description": "Source entity name (resolved; never a raw numeric ID even when linked via `--from-id`)." },
"to": { "type": "string", "description": "Target entity name (resolved; never a raw numeric ID even when linked via `--to-id`)." },
"relation": { "type": "string" },
"weight": { "type": "number", "minimum": 0.0, "maximum": 1.0 },
"namespace": { "type": "string" },
"elapsed_ms": { "type": "integer", "minimum": 0 },
"created_entities": {
"type": "array",
"items": { "type": "string" },
"description": "Entity names auto-created by --create-missing. Omitted when empty."
},
"warnings": {
"type": "array",
"items": { "type": "string" },
"description": "Non-canonical relation warnings (empty array when relation is canonical)"
}
}
}